KS32 LoRaWAN干接点采集器技术手册V1.0
1. 产品介绍
2. 产品描述
KS32 是一款基于 LoRaWAN ®通信的干接点采集器，产品提供6路的干接点接口，当干接点状态发生变化时触发内部电平翻转，KS32触发中断实现对干接点变化状态的实时采集并将干接点的状态及计数值通过LoRaWAN 网关上传到LoRaWAN的NS服务器。
KS32基于 LoRa®无线技术，支持标准 LoRaWAN ®组网通信，具有通信距离远，功耗低等特点。产品内置 4 节 2700 毫安时大容量锂亚电池，续航可达6 年。
此外，产品支持与门思科技/第三方 LoRaWAN ®网关及ThinkLink/Chirp stack/TTN 第三方物联网平台结合，实现干接点类型开关的监控和管理。KS32拥有 IP65 高防护等级，适应户外恶劣环境，可广泛应用智慧工业、智慧楼宇等场景的管理需求。
3. 主要特点
- IP65防护等级
- 支持6路干接点
- 电池供电，10800mA时高性能锂亚电池，电池寿命可达6年
- 支持ThinkLink/ChirpStack/TTN 平台对接
- 支持US902,AU915,AS923,EU868,EU433,CN470 LoRaWAN标准
4. 性能参数
| 参数 | 值 |
|---|---|
| § 接口 | |
| 接头类型 | PG7 |
| 干接点接口数量 | 6 |
| 接地线数量 | 2 |
| 显示 | 无 |
| § 无线参数 | |
| 通信协议 | 标准LoRaWAN ®协议 |
| 地区标准 | CN470/EU433/EU868/AS923/AU915/Us902 |
| 发射功率 | 最大支持22dBm（可改参数） |
| 接收灵敏度 | -142dBm（SF=12，BW=125kHz） |
| 入网/工作模式 | OTAA/ABP Class A |
| § 协议/配置 | |
| 测试/触发方式 | 磁铁，2秒触发心跳数据，>6秒触发入网 |
| 参数配置 | 通过NS下发指令 |
| § 物理特性 | |
| 供电方式 | 4 节 2700 毫安时 ER14505 锂亚电池 |
| 休眠电流 | < 5uA (25℃室温条件下) |
| 发射电流 | < 110mA (22dBm 发射功率) |
| 电池寿命 | 6 年 （15 分钟上报周期，25℃室温条件下） |
| 工作温度 | -40°C ~85°C |
| 相对湿度 | ≤95%（无凝结） |
| 防护等级 | IP65 |
| 材质&颜色 | ABS+PC，白色 |
| 尺寸 | 120mm72mm28mm |
| 安装方式 | 壁挂 |
5. 尺寸与接口
| 序号 | 接口说明 | 具体细节 |
|---|---|---|
| 1 | LoRa天线接口 | 内孔外螺，按照不同的LoRaWAN标准匹配 |
| 2 | 接线口 | PG7防水接头2个GND，6个DI输入接口，共8根引线 |
6. 型号列表
6.1 型号示例
KS328-A1-AS923-N
6.2 型号组成部分解析
KS328：产品系列与射频频段。KS32表示第 2 代 IP65 防护等级干接点采集器。8表示 800 MHz 及以上射频版本，适用于 EU868、AS923、AU915 和 US902。- 其他频段选项：
4表示 400 MHz 射频版本，适用于 EU433 和 CN470。
-A1：采集接口与电源配置。A表示 6 路数字量输入（6DI）接口。1表示设备内置 10800 mAh 电池。
-AS923：LoRaWAN 区域标准。AS923表示设备支持 LoRaWAN AS923 区域参数。- 其他区域代码：
CN470、EU433、EU868、AU915、US902；其中US902对应 LoRaWAN US915（902–928 MHz）区域参数。
-N：默认版本。N表示默认版本。- 其他值用于用户定制版或特殊版本。
6.3 整体型号含义
型号 KS328-A1-AS923-N 完整描述为：
这是一款第 2 代 IP65 防护等级干接点采集器，采用 800 MHz 及以上射频版本，配备 6 路数字量输入接口，内置 10800 mAh 电池，符合 LoRaWAN AS923 区域标准，末位为默认版本 N。
7. 网络拓扑
K32 是标准LoRaWAN设备，K32正常工作需要有LoRaWAN网络支持。可以使用门思科技的LoRaWAN网关或者第三方的LoRaWAN网关，并需要有LoRaWAN NS的支持，KS32支持接入ThinkLink、Chirp stack ，TTN等标准LoRaWAN网络。可使用ThinkLink配置物模型实现业务功能、卡片视图展示及其他业务逻辑。
LoRaWAN 网络拓扑如下：
8. 工作模式
8.1 周期性上传和触发上传
- [x] KS32 有6个DI接口，KS32对接入的DI信号进行实时监测，当任意一个DI接口状态发生变化时都会记录翻转次数，并将DI接口状态上行一包数据
- [x] KS32 在没有触发事件发生时，会周期性上报6个DI接口的状态及计数值
- [x] KS32 的上传周期，按照心跳周期地址进行设定。注意：KS32只能对接干接点
8.2 通信测试
使用磁铁在KS32贴二维码处长触发2s-4s ，即可触发一包上行测量数据
8.3 入网
使用磁铁在KS32贴二维码处长触发6s-8s ，即可触发一包入网数据。
9. 安装固定
- [x] 使用电钻钻将背板固定于墙面（保持背板箭头向上）
- [x] 将产品挂扣于背板（传感器背部凹槽和背板凸起部分对准后，向下滑动）
10. 依据标准
参考文档：PTL-D01 门思科技物联网终端应用层通用协议 V1.5
11. 数据项和标识符
- [x] LoRaWAN 端口号=15
KS32 只支持1种数据格式，示例：
82 24 1A FF00AE 0D000000 D1000000 52000000 52000000 1C000000 28000000
| 序号 | 数据项 | 示例 | 起始地址 | 长度 | 描述 |
|---|---|---|---|---|---|
| 1 | 版本号 | 0x82 | 0 | 1 字节 | 固定为 0x82 |
| 2 | 控制字 | 0x24 | 1 | 1 字节 | 固定为 0x24 |
| 3 | 标识符 | 0x1A | 2 | 1 字节 | 固定为 0x1A |
| 4 | DI 状态 | 0xFF | 3 | 1 字节 | bit0–bit5 的对应关系和取值见下表 |
| 5 | 故障状态 | 0x00 | 4 | 1 字节 | 0x00：正常；0x01：铁电故障 |
| 6 | 电池电压 | 0xAE | 5 | 1 字节 | 实际值 = 采样值 × 1.6 / 254 + 2 V |
| 7 | 端口 1 计数值 | 0x0000000D | 6 | 4 字节 | 无符号 32 位小端整数 |
| 8 | 端口 2 计数值 | 0x000000D1 | 10 | 4 字节 | 无符号 32 位小端整数 |
| 9 | 端口 3 计数值 | 0x00000052 | 14 | 4 字节 | 无符号 32 位小端整数 |
| 10 | 端口 4 计数值 | 0x00000052 | 18 | 4 字节 | 无符号 32 位小端整数 |
| 11 | 端口 5 计数值 | 0x0000001C | 22 | 4 字节 | 无符号 32 位小端整数 |
| 12 | 端口 6 计数值 | 0x00000028 | 26 | 4 字节 | 无符号 32 位小端整数 |
11.1 DI 状态位解析
| 位 | 对应 DI 端口 | 0 | 1 |
|---|---|---|---|
| bit0 | DI1 | 闭合 | 开断 |
| bit1 | DI2 | 闭合 | 开断 |
| bit2 | DI3 | 闭合 | 开断 |
| bit3 | DI4 | 闭合 | 开断 |
| bit4 | DI5 | 闭合 | 开断 |
| bit5 | DI6 | 闭合 | 开断 |
当前 KS32 物模型仅使用 bit0–bit5 和 6 个计数值。当前模型不会把 bit6、bit7 或索引 30 之后的尾随字节映射为 DI7/DI8，也不解析这些字段。
12. ThinkLink 参考物模型
登录 ThinkLink。
- 在模型菜单搜索
KS32。 - 使用模板
MT-KS32添加设备。
12.1 遥测物模型
遥测物模型标识为 mt_ks32，LoRaWAN 端口号为 15。
| 字段 | 类型/单位 | 说明 |
|---|---|---|
chan1–chan6 | 数值 | 6 路干接点状态：0=闭合，1=开断 |
status | 数值 | 设备故障状态 |
battery | V | 换算后的电池电压 |
counter1–counter6 | 无符号 32 位整数 | 6 路设备累计计数值 |
rssi、snr | dBm、dB | LoRaWAN 链路质量字段 |
counter1–counter6 是设备已经计算完成的最终计数值，其中已经包含对应的起始计数值。应用侧不得再次减去 base1–base6。
12.2 参数物模型
参数回读由 mt_ks32_para 物模型处理，包含 period_up、triggerEnable、pulseThreshold、throttleWindow 和 base1–base6。其中，现有物模型字段 pulseThreshold 对应地址 92–93 的“触发死区窗口”，throttleWindow 对应地址 94–95 的“节流保护窗口”，两者单位均为秒。设备回读的 triggerEnable 会归一化为布尔值，供参数表单回填和下发结果校验。
13. 参数修改与 RPC
参数修改参考《PTL-D01 门思科技物联网终端应用层通用协议 V1.5》第 5 章。
13.1 配置参数地址表
| 序号 | 数据项 | 默认值 | 起始地址 | 长度 | 描述 |
|---|---|---|---|---|---|
| 1 | 上传周期（period_up） | 900 | 40 | 4 字节 | 小端格式，单位秒 |
| 2 | 触发上传使能（triggerEnable） | true（1） | 90 | 1 字节 | 取值及触发行为见 13.4 |
| 3 | 固件版本（FwVer） | — | 91 | 1 字节 | KS32 固件版本号；只读参数 |
| 4 | 触发死区窗口（现有物模型字段 pulseThreshold） | 0 | 92 | 2 字节 | 小端格式，单位秒。定义触发一次后，本事件段内不再响应后续 DI 电平变化的持续时间 |
| 5 | 节流保护窗口（throttleWindow） | 5 | 94 | 2 字节 | 小端格式，单位秒。在该时间窗口内仅通过 LoRaWAN 发送一次数据 |
| 6 | 最大脉冲宽度 | 0 | 96 | 2 字节 | 小端格式，单位 ms。用于脉冲测量和计数；脉冲宽度超过该值时不计量。启用脉冲计量时，必须将触发死区窗口设为 0 |
| 7 | 最小脉冲宽度 | 200 | 98 | 2 字节 | 小端格式，单位 ms。用于脉冲测量和计数；脉冲宽度低于该值时不计量。启用脉冲计量时，必须将触发死区窗口设为 0 |
| 8 | 起始值修改校验（modifyKey） | 只写 | 100 | 2 字节 | 修改 base1–base6 时由 RPC 自动写入 0xFAFA |
| 9 | 通道 1 起始计数值 | 0 | 102 | 4 字节 | base1；写入后 counter1 从该值继续累计 |
| 10 | 通道 2 起始计数值 | 0 | 106 | 4 字节 | base2；写入后 counter2 从该值继续累计 |
| 11 | 通道 3 起始计数值 | 0 | 110 | 4 字节 | base3；写入后 counter3 从该值继续累计 |
| 12 | 通道 4 起始计数值 | 0 | 114 | 4 字节 | base4；写入后 counter4 从该值继续累计 |
| 13 | 通道 5 起始计数值 | 0 | 118 | 4 字节 | base5；写入后 counter5 从该值继续累计 |
| 14 | 通道 6 起始计数值 | 0 | 122 | 4 字节 | base6；写入后 counter6 从该值继续累计 |
触发死区窗口用于限制一次触发后设备对后续电平变化的响应；节流保护窗口用于限制 LoRaWAN 数据发送频率，两者含义不同。进行脉冲测量和计数时，只有脉冲宽度位于最小值与最大值之间才计量，并且必须先将触发死区窗口配置为 0。
13.2 ThinkLink RPC
| RPC 名称 | 类型 | 参数 | 说明 |
|---|---|---|---|
mt_ks32_set | SET | period_up、triggerEnable、pulseThreshold、throttleWindow、base1–base6 | 设置参数；pulseThreshold 表示触发死区窗口（秒），throttleWindow 表示节流保护窗口（秒）；表单从当前共享属性回填，并自动附带 modifyKey=0xFAFA |
mt_ks32_get | GET | 无 | 读取当前参数，并更新参数物模型和共享属性 |
mt_ks32_clear_counter | ACT | 无 | 将 base1–base6 全部写为 0，从而清零六路设备计数器；不依赖最新遥测值 |
13.3 起始计数值与清零
协议字段名继续使用 base1–base6，但这些字段不是平台侧偏移量。写入 baseN=X 后，对应的 counterN 会从 X 继续累计；端口 15 上报的 counterN 已经是最终值，应用侧不得执行 counterN - baseN。
需要清零时，优先调用 mt_ks32_clear_counter。该 RPC 会自动携带 modifyKey=0xFAFA，并将六个起始计数值全部写为 0。
13.4 触发上传使能取值
| 取值 | DI 端口电平变化时的行为 |
|---|---|
0x00 | 只累计计数，不触发上行数据 |
0x01 | 任意 DI 端口发生电平变化时，立即触发一包上行数据 |
13.5 当前 RPC 未暴露的协议项
以下设备协议地址仍保留在 PTL-D01 定义中，但当前 MT-KS32 模板的 SET/GET RPC 不提供这些字段：
| 数据项 | 地址 | 当前状态 |
|---|---|---|
| 复位 | 9 | 当前 RPC 未实现 |
固件版本（FwVer） | 91 | 当前 RPC 未读取 |
| 最大脉冲宽度 | 96–97 | 当前 RPC 未实现 |
| 最小脉冲宽度 | 98–99 | 当前 RPC 未实现 |
14. 联系我们
电话：+86-15810684257