Custom Home Assistant integration to control the iRobot Braava 240 mopping robot via Bluetooth Low Energy (BLE).

• Auto-discovery – The Braava 240 is automatically detected when powered on and within BLE range
• Start/stop cleaning – Via the vacuum entity in Home Assistant
• Cleaning mode – Normal (full room) or Spot cleaning
• Battery level – Calculated from actual charge current (more reliable than the internal raw value)
• Robot status – Ready, Cleaning, Error
• Pad detection – Shows the currently attached pad type (wet, damp, dry, reusable, etc.)
• Wetness control – Per-pad-type wetness levels (Low / Medium / High)
• Volume control – Adjustable speaker volume (0–100)
• Robot name – Read and change the robot's Bluetooth name
• Room confinement – Enable/disable room confinement mode
• Lifetime statistics – Total missions, successful/failed missions, cleaning time, average duration
• Find robot – Beep button to locate the robot
• Device information – Serial number, firmware version, hardware revision via GATT Device Information Service
• Power off – Power-off button to fully shut down the robot (disabled by default)
• Multilingual – English and German

This integration is available in the default HACS store — just click the button below, or search HACS for "Braava".

Then restart Home Assistant.

1. Turn on the Braava 240 and place it within BLE range
2. Home Assistant will automatically discover the robot via the Bluetooth integration
3. Click Configure in the notification and confirm

If the robot is not discovered automatically: Settings → Devices & Services → Add Integration → "iRobot Braava 240 BLE"

• Home Assistant 2024.11.0 or newer
• Bluetooth adapter on the Home Assistant host (built-in or USB dongle)
• iRobot Braava 240 (codename "Altadena")

This integration works with the Vacuum Card by Denys Dovhan for a visual dashboard experience.

The vacuum entity exposes start, stop and locate (beep) actions, and additional attributes (pad_type, cleaning_mode, robot_name, runtime_minutes, mission_status, battery_voltage_v) that can be used as stats. For translated values, reference the sensor entity directly via entity_id instead of using attribute.

type: custom:vacuum-card
entity: vacuum.braava_240
battery_entity: sensor.braava_240_battery
image: https://raw.githubusercontent.com/mtheli/braava_240_ble/master/images/braava-jet-240.svg
stats:
  default:
    - attribute: robot_name
      subtitle: Name
    - entity_id: sensor.braava_240_cleaning_pad
      subtitle: Pad
    - attribute: cleaning_mode
      subtitle: Mode
  cleaning:
    - attribute: runtime_minutes
      subtitle: Runtime
      unit: min
    - entity_id: sensor.braava_240_cleaning_pad
      subtitle: Pad
shortcuts:
  - name: Spot
    icon: mdi:target
    service: select.select_option
    service_data:
      entity_id: select.braava_240_cleaning_mode
      option: spot
  - name: Normal
    icon: mdi:map-marker-path
    service: select.select_option
    service_data:
      entity_id: select.braava_240_cleaning_mode
      option: normal

This integration communicates directly with the Braava 240 via BLE — no cloud service and no iRobot account required. All communication is fully local.

The robot uses a two-layer GATT protocol:

• Transport layer – Manages data transfer via two BLE characteristics (command + status)
• Robot command layer – The actual commands (query status, start cleaning, etc.) are transferred as packets via a data characteristic

For a detailed technical description of the BLE protocol, see PROTOCOL.md.

The Braava 240 firmware exposes 26 robot commands. This integration currently uses 19 of them:

MIT