bonan/tradfri-mqtt

Trådfri-MQTT

该项目将Trådfri网关的大部分端点镜像到MQTT，并可用于通过MQTT向Trådfri网关发送命令。

更多信息请参见hemtjan.st/tradfri-mqtt。

运行

bash
# 192.168.0.99 = 你的Trådfri网关IP
# abcdefgh = 网关底部印刷的预共享密钥
# tcp://127.0.0.1:1883 = MQTT broker地址

docker volume create tradfri-mqtt-data
docker run -d \
  --name tradfri-mqtt \
  --volume tradfri-mqtt-data:/data \
  --env TRADFRI_GATEWAY=192.168.0.99 \
  --env TRADFRI_PSK=abcdefgh \
  --env MQTT_ADDRESS=tcp://127.0.0.1:1883 \
  bonan/tradfri-mqtt

对于armv7架构（如树莓派3+），请使用镜像bonan/tradfri-mqtt:arm7。

参数

获取更新

tradfri-mqtt会尝试监听网关发布的所有内容，并将消息镜像到前缀为tradfri-raw/的MQTT主题。

例如，如果Trådfri网关推送灯泡65554的更新，原始JSON消息将发布到MQTT主题tradfri-raw/15001/65554。

订阅tradfri-raw/#可获取所有消息，tradfri-raw/15001/#获取所有设备更新，tradfri-raw/15004/#获取所有组更新。

发送命令

可通过向MQTT主题tradfri-cmd发布消息来向Trådfri网关发送命令。负载应为JSON编码的字符串，符合以下定义：

typescript
export declare type TfCommand = {
    // CoAP方法
    method: "get" | "post" | "put" | "delete" | "reset",
    // 不带任何前缀的URL，例如"15001/65540"
    url: string,
    // 可选的请求ID，将包含在回复中
    id?: string,
    // 回复将发送到该MQTT主题
    replyTopic?: string,
    // 请求的负载（用于POST或PUT）
    payload?: object|string,
}

如果设置了replyTopic，回复将发送到该主题。回复定义如下：

typescript
export declare type TfReply = {
    // TfCommand中设置的请求ID
    id?: string,
    // 响应代码，例如"2.04"
    code: string,
    // 响应格式，50=json
    format: number,
    // 负载，如果格式为json则负载解码为对象，否则为原始字符串
    payload: string|object,
}

示例请求

Put请求

发送到tradfri-cmd主题：

json
{
  "method": "put",
  "url": "15004/162515",
  "id": "group-set-on",
  "replyTopic": "tradfri-reply/xyz",
  "payload": {
    "5850": 1
  }
}

从tradfri-reply/xyz主题接收：

json
{
  "id": "group-set-on",
  "code": "2.04",
  "format": null,
  "payload": ""
}

Get请求

发送到tradfri-cmd主题：

json
{
  "method": "get",
  "url": "15004/162515",
  "id": "group-get",
  "replyTopic": "tradfri-reply/xyz"
}

从tradfri-reply/xyz主题接收：

json
{
  "id": "group-get",
  "code": "2.05",
  "format": 50,
  "payload": {
    "5850": 1,
    "5851": 0,
    "9001": "组名称",
    "9002": ***,
    "9003": ***,
    "9018": {
      "***": {
        "9003": [65546,65547,65548]
      }
    },
    "9039": 220248
  }
}