virtualzone/landroid-bridge

Landroid Bridge

注意：本仓库目前未维护。由于不再使用Landroid割草机，无法更新和测试任何更改，请自行承担使用风险。

Landroid Bridge是Worx Landroid割草机的桥接工具，支持通过HTTP（REST、JSON）和MQTT发布设备数据、修改设置，并提供基于天气的智能调度功能及集成Web界面。

核心功能

• 实时发布割草机状态数据（如电池、位置、错误信息等）至HTTP/JSON接口或MQTT主题
• 支持通过HTTP/MQTT远程控制割草机（启动、停止、暂停、设置雨延迟等）
• 智能调度：结合小时天气预报、历史数据和设备/花园配置，自动安排割草时间
• 集成Web界面展示实时数据和调度结果

使用场景

• 家庭用户远程监控和控制Worx Landroid割草机
• 智能家居系统（如OpenHAB）集成割草机数据，实现自动化场景
• 通过MQTT/HTTP API与其他智能设备联动

配置说明

前提条件

• 使用MQTT功能需安装MQTT Broker（如Eclipse Mosquitto）
• 从源码构建需安装Node.js（建议v11版本）
• 使用Docker镜像需安装Docker

Docker部署

1. 创建config.json文件（参考源码模板配置设备、MQTT、调度器等参数）
2. 运行镜像：

bash
docker run \
    -p 3000:3000 \
    --name landroid_bridge \
    --link mqtt:mqtt \
    -v /tmp/config.json:/usr/src/app/config.json \
    virtualzone/landroid-bridge

说明：镜像支持amd64、arm32v6、arm32v7、arm64v8多架构，将自动匹配运行环境。

安全注意事项

• 工具无内置认证/授权机制，使用MQTT时需配置强密码；使用HTTP时建议通过nginx/HAProxy代理处理认证。

Web界面访问

启动后可通过http://localhost:3000访问集成Web界面，查看实时数据和调度结果。

MQTT配置示例

无认证MQTT连接：

json
"mqtt": {
    "enable": true,
    "url": "mqtt://localhost",
    "topic": "landroid"
}

带用户名密码的MQTT连接：

json
"mqtt": {
    "enable": true,
    "url": "mqtt://username:password@localhost",
    "topic": "landroid"
}

SSL/TLS连接：

json
"mqtt": {
    "enable": true,
    "url": "mqtts://localhost",
    "topic": "landroid",
    "caFile": "./ca.crt",
    "keyFile": "./client.key",
    "certFile": "./client.crt",
    "allowSelfSigned": true
}

智能调度器配置

启用调度器需修改config.json：

json
"scheduler": {
    "enable": true,
    "cron": true,
    "weather": {
        "provider": "wunderground",
        "apiKey": "你的API密钥",
        "latitude": 50.0982,
        "longitude": 8.2214
    },
    "earliestStart": 11,
    "latestStop": 21,
    "offDays": 2,
    "squareMeters": 300
}

参数说明：

• enable：是否启用调度器
• cron：是否每小时自动调度
• weather：天气数据提供商（支持wunderground/darksky）
• earliestStart/latestStop：割草机可工作的时间范围
• offDays：每周休息天数
• squareMeters：草坪面积

OpenHAB集成

1. 安装MQTT绑定插件
2. 配置services/mqtt.cfg：

mqtt.url=tcp://mqtt:1883
mqtt.user=用户名
mqtt.pwd=密码

3. 添加设备项（如items/mower.items）：

Number Landroid_ErrorCode "错误代码 [%d]" <lawnmower> {mqtt="<[mqtt:landroid/status/errorCode:state:default]"}
String Landroid_Status "状态 [%s]" <lawnmower> {mqtt="<[mqtt:landroid/status/statusDescription:state:default]"}

HTTP REST接口示例

• 获取状态：curl -X GET http://localhost:3000/landroid-s/status
• 启动割草机：curl -X POST http://localhost:3000/landroid-s/start
• 设置雨延迟：curl -X PUT http://localhost:3000/landroid-s/set/rainDelay/120

MQTT主题示例

• 发布状态：landroid/status/batteryLevel（电池电量）
• 控制指令：mosquitto_pub -t landroid/set/start（启动割草机）
• 设置雨延迟：mosquitto_pub -t landroid/set/rainDelay -m 120