Husqvarna Automower Integration

Purpose

The purpose of this QA is to enable Husqvarna Automower Connect integration with Homecenter 3 as a quick app. The idea of the QA is not to provide a complete interface for the Automower Connect API (with schedule editing, configuring stay out zones etc etc), rather to provide basic functionality such as error codes, status and also provide basic commands (pause, resume, pause until next scheduled start etc).

Disclaimer

• The QA should support multiple Automowers, albeit I only have one and as such this QA is only tested with one Mower. If you have multiple Mowers and try it out, please feel free to let me know the result.

Limitations

• No icons are included, as such if you want to icons you need to identify and add them to HC3. Since QA implements the com.fibaro.husqvarnaMower the icon is pre-defined and I have found no way to change that icon (to reflect the state of the mower).
• Due to close to impossible to get a UI on Quick App childs I have an UI on the top node which reflects/controls only the first Mower on your account. This might change in the future if I learn how to do it properly. I.e. any mower 2, 3 etc can only be monitored/controlled through a scene (Block or LUA).
• I have not tested having the mower as trigger, so there might be limitations or simply bugs.
• The QA is not managing changes on number of Mowers in any good way (actual Mowers on your Husqvarna account or if you have deleted one the devices on the HC3). If you change anything close to this, just delete the top node and install the quick app again.
• The caption (="log" attribute of the device) is reflecting the "Activity" of the Connect API and the errorCode of the API is stored in the appropriate property of the device. For details on Husqvarna's definitions: https://developer.husqvarnagroup.cloud/apis/automower-connect-api?tab=status%20description%20and%20error%20codes
• If you are interfacing with other scenes (block/LUA) on your HC3, possibly with multiple mowers, do not stress the QA too much. The QA is communicating through cloud which in turn communicate with mower, allow for many seconds to update. (Current update frequency is 5 minutes, which is generating about the maximum number of requests that Husqvarna allows over a month, however any command will trigger an update within approximately 30 sec.) Also, if you have multiple Mowers and iterate through them, please provide ample of time (>45sec) between commands/requests to the various mowers.

Installation

1. Start with configuring (you need to complete all three steps) your Autmower Connect account: https://developer.husqvarnagroup.cloud/docs/get-started
2. The Application Key and Application Secret will be needed to enter into HC3 QA variables.
3. Add the Husqvarna Automower Connect QA and add the Application Key and Application Secret on the Variables tab of the QA and hit save
4. Wait about 30 seconds and your mower(s) shall be added
5. In addition to the functions defined by the type the, QA also support "StartOverride" with one argument which correspond to the amount of minutes that the mower shall override schedule i.e. in LUA hub.call(xx, "StartOverride", 60), where xx is deviceID and the override will be for 1 hour. For parking the equivalent is valid for "parkTime" with one argument as well for the number of minutes.
6. sendPushWithErrorCode is not supported but should be possible to implement by yourself by using errorCode as trigger and then create a push of your choice.
7. The following properties are updated/maintained by the QA (in addition to battery level). For definitions see link above in limitations paragraph.

• "log": "PARKED_IN_CS",
• "manufacturer": "Husqvarna",
• "model": "HUSQVARNA AUTOMOWER® 310",
• "mowerActivity": "PARKED_IN_CS",
• "mowerErrorCode": 0,
• "mowerId": "123456789-1234-1234-123456789012",
• "mowerMode": "MAIN_AREA",
• "mowerState": "RESTRICTED",

Version log

0.5, 11 May 25: Initial version with read-only

1.0, 26 May 25, First official version.