Features & Entities

Features & Home Assistant Entities Reference 📊🎮

This page describes all entities, controls, and advanced features exposed by the Bosch Indego integration. After setup, entities appear as unused entities – you can add them to your dashboard or automations as needed.

---

🏠 Native Home Assistant Entities (Optional)

Enable these in Settings → Devices & Services → Bosch Indego → Configure:

Lawn Mower Entity (lawn_mower.indego_<SERIAL>)

• Commands: Start mowing, Pause, Dock
• States: DOCKED, MOWING, PAUSED, RETURNING, ERROR
• Mapping: 60+ firmware states → standard Home Assistant activities

Vacuum Entity (vacuum.indego_<SERIAL>) – Legacy

• Commands: vacuum.start, vacuum.pause, vacuum.return_to_base
• States: cleaning, paused, returning, docked, error

Camera Entity (camera.indego_<SERIAL>_lawn_map)

• Dynamic streaming: Shows as streaming when mower is moving/mowing
• Display: SVG lawn map with real‑time mower position overlay
• File: www/indego_map_<SERIAL>.svg (automatically refreshed)

---

📡 Sensor Entities

All sensors are read‑only and update automatically.

Mowing Status

Entity	Description
sensor.indego_<SERIAL>_mower_state	Current state (e.g., Mowing, Charging)
sensor.indego_<SERIAL>_mower_state_detail	Detailed state + numeric code
sensor.indego_<SERIAL>_mowing_mode	Mowing mode (Normal, SmartMowing, etc.)
sensor.indego_<SERIAL>_lawn_mowed	Percentage mowed (%)
sensor.indego_<SERIAL>_lawn_mowed_size	Absolute mowed area (m²)
sensor.indego_<SERIAL>_garden_size	Total lawn area (m²)

Battery & Power

Entity	Description	Category
sensor.indego_<SERIAL>_battery_percentage	Current charge (%)	Standard
sensor.indego_<SERIAL>_battery_voltage	Battery voltage (V)	Diagnostic
sensor.indego_<SERIAL>_battery_temperature	Cell temperature (°C)	Diagnostic
sensor.indego_<SERIAL>_ambient_temperature	Ambient temperature (°C)	Diagnostic
sensor.indego_<SERIAL>_battery_cycles	Charge cycles count	Diagnostic
sensor.indego_<SERIAL>_battery_discharge	Discharged capacity (Ah)	Diagnostic
binary_sensor.indego_<SERIAL>_battery_charging	Charging status (On/Off)	Diagnostic

Runtime & Sessions

Entity	Description
sensor.indego_<SERIAL>_session_count	Number of completed mowing sessions
sensor.indego_<SERIAL>_runtime_total	Total cumulative mowing time (hours)
sensor.indego_<SERIAL>_last_completed_mow	Timestamp of last full lawn mow
sensor.indego_<SERIAL>_next_mow_time	Scheduled next mowing time

Position (Diagnostic)

Entity	Description
sensor.indego_<SERIAL>_mower_svg_x	X coordinate on SVG map (pixels)
sensor.indego_<SERIAL>_mower_svg_y	Y coordinate on SVG map (pixels)

Alerts & Maintenance

Entity	Description
binary_sensor.indego_<SERIAL>_alert	Active alerts indicator + detailed attributes
sensor.indego_<SERIAL>_maintenance_hours	Maintenance counter with status (good/service_due_soon/service_required)
sensor.indego_<SERIAL>_firmware_version	Current firmware version (Diagnostic)

---

🔔 Binary Sensors

Entity	Description
binary_sensor.indego_<SERIAL>_online	Mower connectivity (3‑layer offline detection)
binary_sensor.indego_<SERIAL>_alert	Any unread alert present
binary_sensor.indego_<SERIAL>_mower_stuck	Stuck detection (no movement >60s while mowing)
binary_sensor.indego_<SERIAL>_service_status	Bosch Cloud API availability (Up/Down)
binary_sensor.indego_<SERIAL>_update_available	Firmware update ready

---

🎛️ Switches & Buttons

Switch

Entity	Description
switch.indego_<SERIAL>_smartmowing	Enable/disable SmartMowing (weather‑adaptive schedule)

Buttons (Alert Management)

Entity	Description
button.indego_<SERIAL>_delete_last_alert	Delete the most recent alert
button.indego_<SERIAL>_delete_all_alerts	Delete all alerts
button.indego_<SERIAL>_read_last_alert	Mark most recent alert as read
button.indego_<SERIAL>_read_all_alerts	Mark all alerts as read

---

🛠 Advanced Features

Intelligent Offline Detection (3‑Layer)

1. Error codes – Immediate offline on 802, 803, 804
2. Timeout – After 300 seconds without successful response
3. Last successful update – Tracks stale data

Stuck Detection

• Trigger: No movement >5 pixels for 60+ seconds while mowing
• Attributes: stuck_since, stuck_x, stuck_y

SmartMowing (Predictive)

• Automatically adjusts schedule based on local weather (rain, temperature, grass growth)
• Toggle via switch or service indego.smartmowing

Multi‑Mower Support

• Add integration multiple times for multiple mowers
• Services accept optional mower_serial parameter to target specific mower

---

💡 Example Automations

Notify when mower gets stuck

alias: "Indego: Mower Stuck"
trigger:
  platform: state
  entity_id: binary_sensor.indego_12345678_mower_stuck
  to: "on"
action:
  service: notify.mobile_app_your_phone
  data:
    message: "Mower is stuck at position ({{ state_attr('binary_sensor.indego_12345678_mower_stuck', 'stuck_x') }}, {{ state_attr('binary_sensor.indego_12345678_mower_stuck', 'stuck_y') }})"