Skip to content

entities.md

Latest commit

 

History

History
153 lines (122 loc) · 4.95 KB

entities.md

File metadata and controls

153 lines (122 loc) · 4.95 KB
Raw

Entities

Entity IDs are generated by Home Assistant from the mower name. The examples below use a generic mower name.

Control

  • lawn_mower.<mower>_kosiarka / mower control
  • worx_vision_cloud.start_one_time_mowing / service for one-time mowing with runtime, edge cutting and optional RTK zones
  • number.<mower>_czas_koszenia_jednorazowego / one-time mowing runtime
  • select.<mower>_strefy_koszenia_jednorazowego / one-time mowing zone or zone group
  • switch.<mower>_krawedzie_koszenia_jednorazowego / start one-time mowing with edge cutting
  • button.<mower>_uruchom_koszenie_jednorazowe / start one-time mowing using the selected runtime and zones
  • button.<mower>_odswiez / request refresh
  • button.<mower>_reset_czasu_pracy_nozy / reset blade runtime
  • button.<mower>_reset_cykli_baterii / reset battery cycle counter
  • button.<mower>_uruchom_przycinanie_krawedzi / start edge-only cutting
  • update.<mower>_firmware / firmware version, release notes and OTA install when supported

Schedule

  • sensor.<mower>_harmonogram
  • sensor.<mower>_nastepne_zaplanowane_koszenie / next enabled native weekly schedule start
  • calendar.<mower>_harmonogram_koszenia
  • switch.<mower>_harmonogram_kosiarki / enable or disable the mower's native schedule
  • number.<mower>_wydluzenie_czasu / schedule time extension
  • number.<mower>_powierzchnia_trawnika / lawn area
  • number.<mower>_obwod_trawnika / lawn perimeter
  • number.<mower>_dystans_krawedzi / Vision border-cut distance, when supported

RTK Map

  • camera.<mower>_mapa_rtk
  • device_tracker.<mower>_pozycja_rtk
  • sensor.<mower>_mapa_rtk
  • sensor.<mower>_punkty_sladu_rtk / disabled by default, recent RTK trail points
  • sensor.<mower>_adres_rtk / disabled by default, reverse-geocoded with OpenStreetMap Nominatim when enabled

Useful Sensors

  • battery percentage
  • status
  • error
  • mowing readiness / reason why mowing should or should not start
  • cloud connection status
  • API capabilities / disabled by default
  • push notification state / disabled by default
  • current zone / legacy zone value or RTK map zone containing the live mower position
  • RSSI
  • rain delay
  • rain remaining
  • configurable rain delay number
  • battery voltage
  • battery temperature
  • battery cycle count
  • battery cycles since reset
  • battery cycle reset time
  • blade runtime
  • blade runtime reset time
  • mower runtime
  • mower time at home, charging and in error
  • lawn area
  • mowing efficiency
  • maintenance status
  • pitch, roll and yaw
  • last update
  • last update age
  • total covered area / cumulative Worx cloud counter
  • area mowed today (cloud) / daily delta from a persisted midnight baseline
  • daily progress (cloud)
  • remaining progress (cloud)
  • estimated area mowed today / local blade-active time multiplied by long-term efficiency
  • estimated daily progress
  • cloud statistics updated / timestamp of the last successful product-statistics fetch

Cloud statistics can lag behind the mower because the private Worx endpoint may return an old cumulative value. Estimated statistics update from locally observed mower states and are explicitly approximate. Covered area includes overlapping passes and is not the same as unique physical lawn area.

Binary Sensors

  • online
  • IoT registered
  • MQTT registered
  • locked
  • rain precipitation sensor
  • robot lifted alarm
  • party mode active
  • pause mode active
  • PIN setting capability
  • Vision disable capability
  • random mowing pattern capability
  • map training capability
  • diagnostic upload capability

Switches

  • Smart edge cutting
  • Save the hedgehogs
  • One-time mowing edge cut
  • Firmware auto update
  • Mower lock
  • Native schedule

Numbers

  • Rain delay
  • Time extension
  • Lawn area
  • Lawn perimeter
  • Vision border distance
  • One-time mowing runtime

Selects

  • One-time mowing zones

Updates

  • Firmware

Services

worx_vision_cloud.start_one_time_mowing

Starts one one-time mowing run.

  • entity_id - mower entity.
  • runtime - mowing time in minutes, from 0 to 120. Use 0 with edge_cut: true for an edge-only run; on Vision Cloud this is sent as the dedicated edge-cut command.
  • edge_cut - edge cutting flag. Use runtime: 0 with edge_cut: true for a dedicated edge-only run on Vision Cloud. The smart mowing blueprint starts edge cutting first, waits for a confirmed dock return, and then starts normal one-time mowing.
  • zones - optional RTK zone ID list, for example [1, 2]. Leave empty for default/all-zone mowing.

Example:

action: worx_vision_cloud.start_one_time_mowing
data:
  entity_id: lawn_mower.halina_kosiarka
  runtime: 60
  edge_cut: false
  zones:
    - 1

Raw Entities

Raw payload entities are disabled by default. They are useful while reverse-engineering API fields, but they can be noisy and may expose private data.

Automations

Blueprints and automations are maintained separately from the integration code:

SmartServicePL/worx_vision_cloud_plus_automation