Tests: 
ioBroker adapter for Segway Navimow robotic mowers. Uses the official Navimow SDK REST API and MQTT for real-time updates.
- OAuth2 login via Navimow account
- Real-time status updates via MQTT (WebSocket Secure)
- HTTP polling as fallback
- Remote control: Start, Stop, Pause, Resume, Dock
- Automatic token refresh with MQTT reconnect
- Open the adapter settings in ioBroker Admin
- Click "Navimow Login öffnen" to open the Navimow login page
- Login with your Navimow account
- After login the browser shows "Seite nicht erreichbar" - this is expected
- Copy the complete URL from the browser address bar (contains
?code=XXXXX) - Paste the URL into the Authorization Code field and save
- The adapter exchanges the code for a token and starts automatically
The token is refreshed automatically. A re-login is only needed if the refresh token expires.
For each mower device the following channels are created:
| Channel | Description |
|---|---|
{deviceId}.general |
Device info (name, model, serial number, firmware) |
{deviceId}.status |
Current status (vehicleState, battery, position, signal) |
{deviceId}.status.json |
Raw JSON of the last status update |
{deviceId}.events |
MQTT events |
{deviceId}.attributes |
MQTT device attributes |
{deviceId}.remote |
Remote control buttons |
The status.vehicleState state contains the current mower state.
To check if the mower is currently mowing, check for isRunning:
on({ id: 'navimow.0.DEVICE_ID.status.vehicleState', change: 'any' }, (obj) => {
if (obj.state.val === 'isRunning') {
log('Mower is mowing!');
}
});| Value | Description |
|---|---|
isRunning |
Mowing |
isDocked |
Docked |
isIdle |
Idle |
isPaused |
Paused |
isDocking |
Returning to Dock |
isMapping |
Mapping |
isLifted |
Lifted (Error) |
Error |
Error |
inSoftwareUpdate |
Software Update |
Self-Checking |
Self-Checking |
Offline |
Offline |
| State | Description |
|---|---|
remote.Refresh |
Trigger a manual status refresh |
remote.start |
Start mowing |
remote.stop |
Stop mowing |
remote.pause |
Pause mowing |
remote.resume |
Resume mowing |
remote.dock |
Return to dock |
Remote states reflect the current device state with ack:true. For example, when the mower is mowing, remote.start is true.
Based on the Navimow SDK and Navimow HA Integration.
| Endpoint | Purpose |
|---|---|
POST /openapi/oauth/getAccessToken |
OAuth2 token exchange and refresh |
GET /openapi/smarthome/authList |
Discover devices |
POST /openapi/smarthome/getVehicleStatus |
Get device status |
POST /openapi/smarthome/sendCommands |
Send commands (Google Smart Home protocol) |
GET /openapi/mqtt/userInfo/get/v2 |
Get MQTT connection credentials |
- (TA2k) initial release
MIT License
Copyright (c) 2026 TA2k tombox2020@gmail.com
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.