krambox/kobold2mqtt

VR200 to mqtt

概述

kobold2mqtt是Kobold VR200吸尘器与MQTT之间的网关，遵循https://github.com/mqtt-smarthome/mqtt-smarthome%E9%A1%B9%E7%9B%AE%E7%9A%84%E4%B8%BB%E9%A2%98%E5%92%8C%E8%B4%9F%E8%BD%BD%E6%A0%BC%E5%BC%8F%EF%BC%8C%E5%AE%9E%E7%8E%B0%E5%90%B8%E5%B0%98%E5%99%A8%E7%8A%B6%E6%80%81%E4%BF%A1%E6%81%AF%E7%9A%84%E9%87%87%E9%9B%86%E4%B8%8E%E6%8E%A7%E5%88%B6%E5%91%BD%E4%BB%A4%E7%9A%84%E8%BD%AC%E5%8F%91%E3%80%82

核心功能和特性

• 作为Kobold VR200吸尘器与MQTT协议的桥梁
• 支持设备状态监控（充电状态、电量、运行状态等）
• 支持通过MQTT发送控制命令（启动、停止、暂停、继续、回充）
• 遵循mqtt-smarthome主题和负载格式规范

安装方法

Docker Hub安装（推荐）

bash
docker run --env-file ./vk200.env -it krambox/kobold2mqtt

直接调用

bash
./kobold200mqtt.js -u mqtt://192.168.1.13 -k 192.168.1.162 -e <邮箱> -p <密码>

配置说明

环境变量配置

创建环境变量文件（如vk200.env），包含以下参数：

VR200_url=mqtt://192.168.1.13  # MQTT服务器地址
KM200_password=<Vorwerk密码>   # Vorwerk账户密码
KM200_email=<Vorwerk用户名>    # Vorwerk账户邮箱

启动配置

设置koboldconfig环境变量指向配置文件：

bash
export koboldconfig=config.yml

然后启动应用：

bash
node kobold2mqtt.js

Docker构建与运行

构建镜像

bash
docker build -t kobold2mqtt .

运行容器

bash
docker run --env-file ./vk200.env -it kobold2mqtt

MQTT主题说明

状态主题

设备状态信息通过以下主题发布：

vr200/status/<Kobold名称>

示例 payload：

json
{
  "ts": 1575615863,
  "isCharging": false,
  "isDocked": true,
  "isScheduleEnabled": true,
  "charge": 93,
  "state": "stopped",
  "action": 0
}

控制主题

通过以下主题发送控制命令：

vr200/set/<Kobold名称>

支持的命令值：

• start - 启动清洁
• stop - 停止清洁
• pause - 暂停清洁
• resume - 恢复清洁
• doc - 返回充电座