DeviceChain 的 The Things Stack 集成
如果你的 LoRaWAN 设备向 The Things Stack 上报,应用上的自定义 webhook 可以把每条上行数据转发到 DeviceChain。DeviceChain 把你的载荷格式化器或设备配置文件中的载荷解码器产生的内容存储为普通测量值,因此读数和其他任何读数一样,会进入历史、实时状态、仪表盘和规则。设备从不连接 DeviceChain。
- 读取 无
- 写入 无
- 订阅 部分
如何接线
你在控制台中创建一个发送方类型为 The Things Stack v3 的集成,选择按 DevEUI 还是按设备 id 匹配设备,把它限定到设备类型,并复制它的 bearer 令牌。令牌由服务器生成,只显示一次,仅以带密钥的摘要形式存储。
在 The Things Stack 中,你添加一个 JSON 格式的自定义 webhook,把它的基础 URL 设为该集成的 URL,在 Authorization 请求头中发送令牌,并启用路径为 /uplink-message 的上行消息事件。平台也会读取路径 /up、/uplink 和 /uplinks。
平台读取什么
设备配置文件没有载荷解码器时,平台存储格式化器的输出。请在应用或设备上配置格式化器;LoRaWAN Device Repository 为许多传感器提供格式化器。两者都没有时,上行数据被计为未解码而不被存储。配置文件有载荷解码器时,DeviceChain 自行解码原始帧。
使用确认下行时,还会读取 downlink_ack、downlink_nack、downlink_sent 和 downlink_failed;请在 webhook 中启用这些事件,路径以 downlink 开头。其他路径以 204 应答并被忽略。必须提供上行数据的 received_at,且不得早于 366 天前。
匹配设备
你在 DeviceChain 中添加每台设备,并把它的 DevEUI 作为 lorawan.deveui 别名;如果你选择按设备 id 匹配,则把它的设备 id 作为 tts.device-id 别名。设备不在该集成的范围内,或根本没有对应设备,意味着消息不会被存储。
命令
运维人员启用 LoRaWAN 下行后,已发布的 lorawan_downlink 连接器将集成连接到 The Things Stack。向具有 tts.device-id 别名的设备发送的命令在那里排队为下行。参数可以是原始端口和载荷,也可以是由命令定义中的编码器转换为字节的类型化值。
未确认下行在网络服务器入队时即视为成功,这不是设备确认。确认下行等待设备应答;超过期限未应答时,结果未知。不确定的失败也会使结果未知。
信任
bearer 令牌代表其范围内设备类型中、带有对应别名的每一台设备发言,且没有载荷签名,因此请使用 TLS,严格限定集成的范围,并在令牌可能已暴露时轮换它。
它不做什么。
- LoRaWAN 下行默认关闭,需由运维人员启用。在此之前,向最近通过集成上报的设备发送命令会以 COMMAND_TRANSPORT_UNSUPPORTED 失败,而不是等待过期。
- 入网、状态和位置消息会被确认并忽略。
- 只有数字和布尔值会成为读数;解码对象中的字符串和空值会被跳过。租户超出其接入额度时到达的消息,会以 202 应答且不被存储,这正是矩阵把订阅标为部分支持的原因。