This component allows you to integrate your AL-KO Robolinho mower in Home Assistant.

• ▶️ Start
• ⏸️ Pause
• 🏠 Dock

• 🔋 Battery level
• 🔄 Operation state (IDLE, WORKING, HOMING)
• ⚠️ Operation errors (with detailed error codes)
• 🔪 Remaining blade life
• 🌧️ Rain detection status
• ❄️ Frost detection status
• 🔌 Charger contact status
• ⏰ Next operation time and details
• 📶 RSSI signal strength
• 🔍 Operation substate
• ℹ️ Operation situation
• ⏱️ Blade operation time
• 👤 User interaction

• 🌱 Toggle Eco Mode
• 🌧️ Toggle Rain Sensor
• ❄️ Toggle Frost Sensor
• 🌧️ Rain sensitivity (1-10)
• ⏳ Rain delay
• ❄️ Frost threshold temperature
• ⏳ Frost delay
• 🔄 Reset blade life
• ⏸️ Pause for today

• 📅 Shows mowing events throughout a week.

• 💾 Firmware version
• 🔧 Hardware version
• 🔑 Serial number
• 📋 Model information

service: alko.update_mowing_window
target:
  entity:
    domain: lawn_mower
data:
  day: monday  # Day of the week (monday-sunday)
  window_number: 1  # Window number (1 or 2)
  start_hour: 9  # Start hour (0-23)
  start_minute: 0  # Start minute (0-59)
  duration: 120  # Duration in minutes (1-360)
  type: mow  # Type of mowing operation (mow, first_mow_border_then_area, narrow_passage, deactivated)

service: alko.start_manual_mowing
target:
  entity:
    domain: lawn_mower
data:
  start_hour: 9  # Start hour (0-23)
  start_minute: 0  # Start minute (0-59)
  duration: 120  # Duration in minutes (1-360)
  type: mow  # Type of mowing operation (mow, first_mow_border_then_area, narrow_passage)
  entry_point: 1  # Entry point number for the mowing operation

service: alko.stop_manual_mowing
target:
  entity:
    domain: lawn_mower

Before installing you should know that you will have to to request access to the API. Fill out this form. If all went well you will receive your credentials.

If you're using HACS you can add this repo as a custom repository and install, otherwise download or clone and copy the folder custom_components/alko into your custom_components/. Be sure to restart.

1. Go to Settings > Devices & Services
2. Click the "+ ADD INTEGRATION" button
3. Search for "AL-KO" and select it
4. If you haven't added application credentials yet, you'll be prompted to add them first
   • Enter the client ID and client secret you received from AL-KO
5. Once the application credentials are set, enter your AL-KO username and password
6. The integration will now set up your devices automatically

If you're experiencing issues with the integration, you can use the device state notification service to get detailed information about your mower's current state. This will help with debugging and providing more information when reporting issues.

To get the device state:

1. Go to Developer Tools > Actions
2. Search for "alko.show_device_state"
3. Select your lawn mower entity
4. Click "Call Service"

This will send a notification to your Home Assistant instance with detailed information about your mower's current state.

If you own a smart product from AL-KO and would like to contribute, please don't hesitate getting in touch.

⭐️ this repository if you found it useful ❤️