ioBroker.anthbot-genie

Unofficial ioBroker adapter for Anthbot Genie robotic lawn mowers, focused on detailed Genie telemetry, diagnostics, and mower control across Genie 600/1000/3000/5000 and the newer M5/M9 models.

The adapter connects to the Anthbot cloud account, discovers bound mowers, reads cloud and IoT shadow data, and exposes a broad state tree for status, settings, mower commands, zone data, consumables, location, diagnostics, and raw troubleshooting payloads in ioBroker.

It is intended for users who want more than a basic online/battery/status view: RTK and base station state, firmware and OTA details, network and SIM information, GPS and pose data, map lifecycle timestamps, mower error details, consumable lifetimes, rain settings, zone metadata, and writable mowing controls are exposed as ioBroker states.

This adapter is currently in testing. Please report feedback and test results in the ioBroker forum test thread.

An example ioBroker Blockly with conditions for mower automation is available in the Blockly automation example.

Features

• Anthbot cloud login with encrypted password storage in ioBroker native config
• Automatic discovery of mowers bound to the configured Anthbot account
• Region and IoT endpoint lookup per mower
• Automatic refresh of temporary IoT credentials after AWS IoT 403 responses
• Polling of property and service shadows
• Detailed status states for connection, online state, battery, mower status, charging state, mowing time, mowing area, total mowing time/area, map status, mapping task state, errors, active mowing mode, point mowing, and zone counts
• Diagnostic states for RTK fix, RTK base station, moved antenna warnings, firmware versions, OTA progress, WiFi, cellular, SIM, Bluetooth, camera/map flags, obstacle avoidance, security flags, system timestamps, and cloud-backed mower error data
• Location states for anti-loss GPS coordinates and local mower pose
• Consumable lifetime states and reset buttons for charging port, cameras, and blades
• Writable control states for full-map mowing, zone mowing, cutting height, voice volume, custom mowing direction, obstacle avoidance, rain settings, and mowing near the charging pile
• Command states for full mowing, stop, return to dock, pause return to dock, grass dump, disk maintenance mode, edge mowing, mowing near the charging pile, point mowing, refresh, manual zone mowing, and automatic zone mowing
• Manual and automatic zone metadata as JSON states, including active manual zone IDs
• Raw property shadow, service shadow, Anthbot event-code translations, and area definition payloads for troubleshooting and automation debugging

Requirements

• ioBroker with js-controller >= 6.0.11
• ioBroker admin >= 7.6.20
• Node.js >= 22
• Anthbot account with at least one bound Genie mower
• Internet access from the ioBroker host to the Anthbot cloud and AWS IoT endpoint

Supported devices

• Genie 600
• Genie 1000
• Genie 3000
• Genie 5000
• M5
• M9

Other Anthbot models may still work when they expose the same cloud and shadow payload structure, but they are not explicitly mapped or documented here yet.

Development

• npm install installs runtime and development dependencies.
• npm run lint checks code style using ESLint.
• npm run lint:fix applies automatically fixable ESLint changes.
• npm run check runs TypeScript and Node.js syntax checks for the adapter entrypoint, split library modules, and test files.
• npm run test:js runs unit tests.
• npm run test:package runs package validation tests.
• npm run test:integration runs integration tests.
• npm run test runs check, unit tests, and package validation.
• npm run check:repo runs the ioBroker repository checker.
• npm run translate runs the ioBroker adapter-dev translation workflow.
• npm run release creates a new ioBroker package release.

Translations

• Admin/JSON Config translations live in admin/i18n/<lang>.json.
• Backend/runtime object-name translations live in i18n/<lang>.json.
• After adding or removing translatable strings, update the English source files and run npm run translate so future Weblate and adapter-dev syncs stay aligned.

Configuration

Open the adapter instance configuration in ioBroker Admin and set:

| Setting | Description | Default | | --- | --- | --- | | Anthbot account username | Username or email address of the Anthbot account | empty | | Anthbot account password | Anthbot account password, stored encrypted by ioBroker | empty | | Area code | Phone or account area code, for example 49 for Germany | 49 | | API host | Anthbot cloud API host | api.anthbot.com | | Poll interval in seconds | Polling interval for mower data. The adapter enforces at least 10 seconds. | 60 | | Error description language | Language used for Anthbot cloud error descriptions | English |

After saving the configuration, start or restart the adapter instance.

States

The adapter creates one device tree per mower serial number:

anthbot-genie.<instance>.<serial>.*

Info

| State | Type | Description | | --- | --- | --- | | info.connection | boolean | Global adapter cloud connection state | | <serial>.info.alias | string | Mower alias from Anthbot | | <serial>.info.model | string | Mower model/category | | <serial>.info.region | string | Anthbot/AWS IoT region | | <serial>.info.endpoint | string | IoT endpoint used for shadow access | | <serial>.info.online | boolean | Online state reported by the mower | | <serial>.info.charging | boolean | Whether the mower is currently charging | | <serial>.info.lastServiceCommand | string | Last reported service command | | <serial>.info.lastPoll | string | ISO timestamp of the last successful poll |

Metrics

| State | Type | Unit | Description | | --- | --- | --- | --- | | <serial>.metrics.batteryLevel | number | % | Battery level | | <serial>.metrics.status.mower | string | | Normalized mower status | | <serial>.metrics.status.robotRaw | string | | Raw robot status | | <serial>.metrics.status.modeRaw | string | | Raw mode.value status reported by M5/M9 models | | <serial>.metrics.mowing.time | number | s | Reported mowing time | | <serial>.metrics.mowing.area | number | m2 | Reported mowing area | | <serial>.metrics.mowing.totalTime | number | s | Total mowing time reported by M5/M9 models | | <serial>.metrics.mowing.totalArea | number | m2 | Total mowing area reported by M5/M9 models | | <serial>.metrics.mowing.borderActive | boolean | | Border mowing active | | <serial>.metrics.mowing.nearChargerActive | boolean | | Near-charger mowing active | | <serial>.metrics.mowing.fullYardActive | boolean | | Full-yard mowing active | | <serial>.metrics.pointMowing.active | boolean | | Point mowing active | | <serial>.metrics.pointMowing.x | number | | Last point mowing X coordinate | | <serial>.metrics.pointMowing.y | number | | Last point mowing Y coordinate | | <serial>.metrics.zones.manualCount | number | | Number of manual zones | | <serial>.metrics.zones.autoCount | number | | Number of automatic zones | | <serial>.metrics.map.totalArea | number | m2 | Total mapped area | | <serial>.metrics.map.status | string | | Raw map status | | <serial>.metrics.map.mappingTaskState | string | | Mapping task state reported by M5/M9 models | | <serial>.metrics.error.code | number | | Last mower error code | | <serial>.metrics.error.description | string | | Human-readable error description from the cached Anthbot event-code list when known | | <serial>.metrics.error.active | boolean | | Whether a non-zero mower error is active |

The adapter keeps the same state tree for all supported mower models. On models that do not expose the M5/M9-specific payload fields, the states metrics.status.modeRaw, metrics.mowing.totalTime, metrics.mowing.totalArea, and metrics.map.mappingTaskState are still created but remain empty or null.

Location

| State | Type | Description | | --- | --- | --- | | <serial>.location.gps.latitude | number | GPS latitude from anti-loss position data | | <serial>.location.gps.longitude | number | GPS longitude from anti-loss position data | | <serial>.location.pose.x | number | Local mower pose X | | <serial>.location.pose.y | number | Local mower pose Y | | <serial>.location.pose.yaw | number | Local mower pose yaw | | <serial>.location.pose.type | string | Reported pose type |

Diagnostics

The diagnostics channel exposes read-only troubleshooting data derived from the mower shadow, including RTK state, RTK base state, camera/map/network flags, obstacle avoidance, firmware versions, OTA progress, WiFi/SIM details, timestamps, and the next appointment. On M5/M9 models, the adapter also maps net_config.*, mode.value, error.value, map.map_area, mapping_task.state, mowing_time.value, and mowing_area.value into the existing ioBroker state tree where the meanings match.

Consumables

| State | Type | Unit | Description | | --- | --- | --- | --- | | <serial>.consumable.chargingPort.life | number | % | Charging port lifetime | | <serial>.consumable.chargingPort.reset | boolean | | Reset charging port lifetime | | <serial>.consumable.cameras.life | number | % | Cameras lifetime | | <serial>.consumable.cameras.reset | boolean | | Reset cameras lifetime | | <serial>.consumable.blades.life | number | % | Blades lifetime | | <serial>.consumable.blades.reset | boolean | | Reset blades lifetime |

The mower accepts consumable reset commands only when the related lifetime value is at or below 5%.

Controls

Writable control states update mower settings through the Anthbot IoT service shadow. The adapter handles the model-specific shadow payload encoding internally, so the same ioBroker control states can be used across supported mower models.

| State | Type | Range | Description | | --- | --- | --- | --- | | <serial>.controls.fullMapMowing.mowHeight | number | 30..70 mm, 5 mm steps | Set full-map cutting height | | <serial>.controls.fullMapMowing.includeEdgeTrimming | boolean | true/false | Include edge trimming in full-map mowing | | <serial>.controls.fullMapMowing.customMowingDirection | number | 0..180 deg | Set full-map custom mowing direction | | <serial>.controls.fullMapMowing.customMowingDirectionEnabled | boolean | true/false | Enable or disable full-map custom mowing direction | | <serial>.controls.zoneMowing.mowHeight | number | 30..70 mm, 5 mm steps | Set zone mowing cutting height | | <serial>.controls.zoneMowing.mowCount | number | 1..3 | Set zone mowing passes | | <serial>.controls.zoneMowing.customMowingDirection | number | 0..180 deg | Set zone mowing direction | | <serial>.controls.zoneMowing.customMowingDirectionEnabled | boolean | true/false | Enable or disable zone mowing direction | | <serial>.controls.zoneMowing.obstacleAvoidanceEnabled | boolean | true/false | Enable or disable zone obstacle avoidance | | <serial>.controls.zoneMowing.obstacleAvoidanceLevel | number | 0..2 | Set zone obstacle avoidance level | | <serial>.controls.voiceVolume | number | 0..100 % | Set voice volume | | <serial>.controls.rain.perceptionEnabled | boolean | true/false | Enable or disable rain perception | | <serial>.controls.rain.continueTimeHours | number | 0..8 h | Set rain continue time in hours | | <serial>.controls.nearChargerMowing.enabled | boolean | true/false | Enable or disable mowing near the charging pile | | <serial>.controls.nearChargerMowing.mowHeight | number | 30..70 mm, 5 mm steps | Set cutting height for mowing near the charging pile | | <serial>.controls.nearChargerMowing.mowCount | number | 1..3 | Set mowing passes near the charging pile | | <serial>.controls.nearChargerMowing.obstacleAvoidanceEnabled | boolean | true/false | Enable or disable obstacle avoidance near the charging pile | | <serial>.controls.nearChargerMowing.obstacleAvoidanceLevel | number | 0..2 | Set obstacle avoidance level near the charging pile |

Commands

Command states are writable. Button states are reset to false after execution. Zone command states are reset to an empty string after execution. Consumable reset buttons are exposed under consumable.

| State | Type | Description | | --- | --- | --- | | <serial>.commands.device.find | boolean | Find the robot | | <serial>.commands.device.refresh | boolean | Request all mower properties and refresh states | | <serial>.commands.device.cancelRtkAntennaMoved | boolean | Cancel the RTK antenna moved warning | | <serial>.commands.docking.startReturn | boolean | Return to the charging dock | | <serial>.commands.docking.pauseReturn | boolean | Pause return to the charging dock | | <serial>.commands.maintenance.startGrassDump | boolean | Start grass dump | | <serial>.commands.maintenance.startDiskMaintenance | boolean | Start disk maintenance mode | | <serial>.commands.mowing.startFullMap | boolean | Start full-map mowing | | <serial>.commands.mowing.startZone | string | Start mowing one or more manual zones | | <serial>.commands.mowing.startAutoZone | string | Start mowing one or more automatic zones | | <serial>.commands.mowing.startPoint | string | Start point mowing with x,y or {"x":123,"y":456} | | <serial>.commands.mowing.startEdge | boolean | Start edge mowing | | <serial>.commands.mowing.startNearCharger | boolean | Start mowing near the charging pile | | <serial>.commands.mowing.pause | boolean | Pause mowing | | <serial>.commands.mowing.resume | boolean | Resume mowing | | <serial>.commands.mowing.stop | boolean | Stop all mower tasks | | <serial>.commands.mowing.end | boolean | End mowing | | <serial>.commands.mowing.stopPoint | boolean | Stop point mowing |

Availability of commands.maintenance.startDiskMaintenance, commands.maintenance.startGrassDump, commands.mowing.startEdge, commands.mowing.startNearCharger, and commands.mowing.startPoint may depend on mower model, firmware, current mower mode, and map/edge data.

Zones

| State | Type | Description | | --- | --- | --- | | <serial>.zones.manual.list | JSON string | Known manual/custom zones | | <serial>.zones.manual.activeIds | JSON string | Currently active manual zone IDs | | <serial>.zones.autoList | JSON string | Known automatic/region zones |

Raw data

| State | Type | Description | | --- | --- | --- | | <serial>.raw.shadow.property | JSON string | Raw property shadow payload | | <serial>.raw.shadow.service | JSON string | Raw service shadow payload | | <serial>.raw.shadow.event-code | JSON string | Cached Anthbot event-code translation payload used for error descriptions | | <serial>.raw.areaDefinition | JSON string | Raw area definition payload |

Zone Mowing

The adapter exposes the mower's manual/custom zones in:

<instance>.<serial>.zones.manual.list

This state contains a JSON array with known zones. Use the id or the exact name from that list to start mowing.

Write the selection to:

<instance>.<serial>.commands.mowing.startZone

Accepted values:

• one zone by ID: 3
• one zone by name: Front yard
• multiple zones as comma-separated IDs or names: 3,5,Back yard
• multiple zones as a JSON array: [3,5,"Back yard"]

After a valid write, the adapter sends custom_area_mow_start with the matched manual zone IDs and clears commands.mowing.startZone again.

Automatic zones work similarly through:

<instance>.<serial>.zones.autoList
<instance>.<serial>.commands.mowing.startAutoZone

For automatic zones, the adapter resolves the selected zone IDs or names to the zone coordinates and sends region_mow_start.

Troubleshooting

Adapter does not connect

• Check username, password, and area code.
• Confirm that the mower is visible in the Anthbot app with the same account.
• Increase the adapter log level to debug and restart the instance.
• Check anthbot-genie.<instance>.info.connection.

No mower objects are created

• The Anthbot account must have at least one bound mower.
• Check the adapter log for No Anthbot devices found for this account.
• Verify that the ioBroker host has internet access.

Commands do not work

• Check whether status polling works first.
• Verify that the target state is under the correct mower serial number.
• For zone commands, compare the written value with the IDs and names in zones.manual.list or zones.autoList.
• The adapter automatically refreshes temporary IoT credentials once after an AWS IoT 403; if commands still fail after that retry, check the adapter log for model-specific payload or mower-state errors.
• Check raw.shadow.service and the adapter log for command errors.

Changelog

0.1.13 (2026-06-08)

• Add M5/M9 payload parity for status, battery, error, network, RTK, map, and total mowing metrics while keeping the existing ioBroker state tree stable.
• Refresh temporary IoT credentials once on AWS IoT 403 responses and retry the failed shadow read or command publish automatically.
• Refactor the large adapter sources into focused CommonJS modules for Anthbot cloud/shadow clients, payload helpers, adapter object definitions, state derivation, and command handling without changing state IDs or command payload behavior.
• Expand npm run check so syntax validation covers the split lib/anthbot, lib/adapter, and unit test files through the dedicated syntax-check helper.

0.1.12 (2026-06-06)

• (reloxx13) FIXED: Create the global info channel and correct the mower status role so the adapter object structure passes ioBroker review checks.

0.1.11 (2026-06-06)

• Refresh existing mower device/channel/state objects with extendObjectAsync so updated runtime i18n names are applied to already-created objects, not only new ones.

0.1.10 (2026-06-06)

• Align ioBroker object metadata with the repository object-structure checker by creating the global info channel, correcting the mower status role, and emitting full recommended i18n keys for object names.
• Keep admin translations in the repository-checker-friendly admin/i18n/<lang>.json layout and load backend/runtime object-name translations from root i18n/<lang>.json files via adapter-core I18n.

0.1.9 (2026-06-06)

• Drop the temporary --legacy-peer-deps GitHub Actions install override now that the lockfile supports plain npm ci again.
• Re-enable ESLint in the GitHub Actions quick-check job and align the local lint config with the checked JavaScript codebase.
• Clean up repository metadata so local repochecker no longer reports actionable findings.

Credits

Special credit to the community Anthbot Genie projects, which made the Anthbot cloud flow and command mapping much easier to understand:

• vincentjanv
• AdrianTIonut

Special thanks to @Riza-Aslan for the M5/M9 support research and payload-mapping work that informed this adapter update.

This ioBroker adapter is an independent project, but it builds on public API research and implementation ideas from that community work.

Legal Notice

This project is unofficial and is not affiliated with, endorsed by, sponsored by, or approved by Anthbot.

Anthbot and Genie names, marks, and logos belong to their respective owners. See NOTICE.md for details.

Older changelog entries are archived in CHANGELOG_OLD.md.

License

MIT License

Copyright (c) 2026 reloxx13

See LICENSE for details.