Skip to content

entities.md

Latest commit

 

History

History
136 lines (106 loc) · 3.92 KB

entities.md

File metadata and controls

136 lines (106 loc) · 3.92 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
  • 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

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
  • 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
  • daily progress
  • remaining progress
  • mowed area today

Binary Sensors

  • online
  • IoT registered
  • MQTT registered
  • locked
  • rain precipitation sensor
  • robot lifted alarm
  • party mode active
  • pause mode active

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
  • 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. For the most reliable "normal mowing plus edges" flow, start normal mowing first and then call this service again with runtime: 0 and edge_cut: true. The smart mowing blueprint uses that two-step flow.
  • 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