Skip to content

andyb2000/HACS-husqvarna_automower_ble

Repository files navigation

hacs_badge GitHub all releases GitHub issues by-label GitHub contributors

HACS-husqvarna_automower_ble - Custom integration for Husqvarna Bluetooth automowers

This is the home-assistant integration based on @alistair23 BLE implementation of Husqvarna bluetooth mowers https://github.com/alistair23/AutoMower-BLE

** THIS IS DEVELOPMENTAL/DEBUG HACS integration so expect errors! **

NOTE - It is recommended to use the python library direct from the source tree, rather than pypi/pip libraries. This is due to the library being behind on pypi for legacy applications. I have included in this HACS repo manifest for Home Assistant/Python/PIP to install from the main repo above, so this should happen. If not, you need to manually update the library on your home assistant installation, in the location: /usr/local/lib/python3.12/site-packages/automower_ble/ (The newer version should NOT have request.py as a file so you can check if you are using the correct version)

Installation

Just add this repo to the custom repos in HACS (https://hacs.xyz/docs/faq/custom_repositories/).

You can do this by going to your HACS menu on the left of Home Assistant, go into INTEGRATIONS. At the top right you should have the 3 dots, click and choose CUSTOM REPOSITORIES.

In the "Repository" input box, paste this git folder: https://github.com/andyb2000/HACS-husqvarna_automower_ble Choose "Integration" from category and click ADD. It should add and you can close the Repository input box.

You should now see the integration in HACS where you can download the latest version, or search for "Husqvarna Automower BLE". Restart home assistant to load the new integration

PIN codes with Flymo or similar

These devices (Easilife Go and other brands that use Husqvarna internal boards) don't have an option to disable PIN. They accept the pin by pressing the sequence of buttons on the mower and on the app when setting up the pairing. The PIN sequence is translated to digits like this:

On/OFF Power button = 1

Go/Schedule button = 2

Go button = 3

Park button = 4

See below image from operators manual. Which indicates the default pin would be 1234

image

Usage

BEFORE you add the new integration, you need to have your bluetooth proxy setup. In ESPHome setup an ESP32 BLE proxy, the config in ESPHome should look like:

esphome:
  name: mower-ble

esp32:
  board: esp32dev
  framework:
    type: esp-idf

# Enable logging
logger:

# Enable Home Assistant API
api:

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

esp32_ble_tracker:
  scan_parameters:
    active: false
    continuous: false
    duration: 50sec

bluetooth_proxy:
  active: true
  cache_services: true

time:
  - platform: homeassistant
    on_time:
      - seconds: 0
        minutes: '*'
        then:
          esp32_ble_tracker.start_scan:
# create a button to reboot the esp32
button:
  - platform: restart
    name: "Mower ESP Restart"

Once you have done this, deploy it to an ESP32 that is within range of your automower.

Bluetooth discovery may now discover your mower, if so you can go to SETTINGS > INTEGRATIONS and CONFIGURE. It will ask for the MAC and PIN. If autodiscovered the MAC will be filled in for you, otherwise you need to enter it manually. If the MAC is not discovered, you need to find this from your existing app.

If you need to manually add it, do it by going into: SETTINGS > INTEGRATIONS Add Integration Search for "Husqvarna Automower BLE"

BEFORE you enter the MAC address, power off your mower. Then power it back on and enter the physical PIN (if required). The mower goes into bluetooth pairing mode for up to 2 minutes which you need for this initial connection. During the configuration stage for the integration it will show a blank box with SUBMIT, click this when your mower is powered on and in bluetooth pairing mode.

You may need to repeat this several times as the bluetooth pairing does not always work correctly.

Sensors and dashboard

An automower entity is created that allows for the main control of the mower, start mowing, return to dock, etc.

image

In addition to that, extra sensors are created that allow you to monitor battery status, next mowing time and overall cutting details:

image