Features & Entities

Features & Home Assistant Entities Reference 📊🎮

This page describes all the entities, controls, and advanced features exposed by the Bosch Indego Integration inside Home Assistant. Once configuration is complete, these entities allow you to build automations, design dashboards, and monitor your robotic mower.

---

🎮 Core Mower Control (Vacuum Entity)

The integration registers the mower as a standard vacuum entity (e.g., vacuum.indego_mower). This allows out-of-the-box compatibility with Home Assistant's default vacuum cards and voice assistants.

Supported Services

• vacuum.start — Sends the command to start or resume mowing (PUT /state $\rightarrow$ MOW).
• vacuum.pause — Pauses the mower in the middle of the lawn (PUT /state $\rightarrow$ PAUSE).
• vacuum.return_to_base — Aborts the current job and orders the mower back to the dock (PUT /state $\rightarrow$ RETURNTODOCK).

---

📊 Sensor Entities (Monitoring)

These read-only sensors continuously pull state and telemetry data from the Bosch Cloud API.

🔋 Battery & Power

• Battery Level (sensor.indego_battery) — Displays the current charge state in percentage (%).
• Battery Cycles (sensor.indego_battery_cycles) — Tracks total lifetime charge cycles, useful for monitoring battery degradation.
• Battery Temperature (sensor.indego_battery_temperature) — Real-time cell temperature monitoring. Commands will automatically block if temperatures drop out of safe operational thresholds.

⏱️ Operating Metrics (Runtime)

• Mower Runtime (sensor.indego_mower_runtime) — Total hours the mower has been actively operating.
• Cutting Time (sensor.indego_cutting_time) — Shows pure cutting duration excluding docking, transit, and charging times.
• Operational Status (sensor.indego_mower_status) — Translates numeric firmware state codes into clean, readable text strings (e.g., Mowing, Charging, Relocalising).

---

⚙️ Configuration Switches & Automations

Switches allow you to toggle dynamic scheduling behavior and hardware features directly from the frontend.

• SmartMowing / Predictive Calendar Switch (switch.indego_smartmowing) — Turning this ON enables Bosch's predictive cutting calendar. The cloud will automatically optimize cutting slots based on live local weather parameters. Turning it OFF reverts the mower to basic manual scheduling patterns.
• Border Cut Toggle (switch.indego_border_cut) — Defines whether the mower executes an edge-trimming lap before starting a full lawn area session.

---

🗺️ Live Lawn Mapping & SVG Visuals

One of the most advanced capabilities of this integration is the real-time extraction and compilation of your lawn geometry layout.

• SVG Structural Map Rendering: The integration connects directly to the /api/v1/alms/{alm}/map endpoint to fetch raw structural data.
• Dynamic Coordinate Stream: During active operation, live coordinates are fetched from the mower's state updates and overlaid directly on top of the SVG base map. This allows you to view the live positional path track of the mower directly on your Lovelace dashboard without needing a third-party camera feed.

---

⚠️ Diagnostic & Alert Entities

To prevent silent failures in your backyard, the integration exposes a robust error-tracking subsystem.

• Alert Sensor (sensor.indego_alerts) — Tracks active hardware errors or system alert codes (e.g., Wire Cut, Mower Stuck, No Wi-Fi Connection).
• Alert Management Engine: When the Bosch cloud backend triggers an alert array, the integration extracts full textual descriptions along with severity context (WARNING, ERROR, CRITICAL).
• Actionable Clear Services: Users can acknowledge and flush out passive cloud buffer logs directly via Home Assistant custom service calls, resetting the alert entity status without needing to open the official smartphone app.

---

💡 Example Automation: Dock Mower on Heavy Rain

You can combine the vacuum entity control with your local weather integration to protect your lawn and equipment:

alias: "Mower: Safety Dock on Heavy Rain"
description: "Automatically dock the mower if local weather report indicates heavy rain"
trigger:
  - platform: numeric_state
    entity_id: sensor.local_rain_gauge
    above: 5.0
condition:
  - condition: state
    entity_id: vacuum.indego_mower
    state: "cleaning"
action:
  - service: vacuum.return_to_base
    target:
      entity_id: vacuum.indego_mower
mode: single