湿美 MS-9380B PUBLIC 接入
选择 SM-MS9380B-21316-PUBLIC 模板，通过 KC25 / OM422 接入设备。公共基础版提供实时数据、参数读写及操作反馈，未预置客户自动控制、通知组或现场位置。
接线与准备
使用常供电 Class C，RS-485 9600、8N1，默认查询站号 1。A/B 接线与设备铭牌、厂家协议保持一致。安装匹配 21316 / v1 的 EdgeBus 程序，核对实际射频区域。选择模板不会自动安装固件，也不会修改除湿机面板地址。查询地址范围为 1–247。
日常使用
先看最新温湿度、开关、故障与数据时间，再执行开关机或湿度设定（10–90）。定时开关只开放原始值 0–36，厂家未确认单位，不按小时或分钟解释；保留两路化霜探头原始值和七项故障。开关状态不等同于压缩机已经机械运行。
写入与反馈
开关写入仅一次，队列在 15 秒后安排只读查询，总观察窗口 60 秒。写应答仅表示应答，实际效果以有效读取或新上行为准。无反馈、过期或通信失败应显示未知/未确认；不自动重复写。同一设备透传操作应串行，协议没有请求号，迟到同值报文仍可能难以归属。
采集参数与位置
默认采集 300 秒、业务上报 300 秒、DTU 心跳 900 秒，三者独立。设置时完整填写上电延时、心跳、原生多设备数（固定 0）、上报、采集和站号；SET 后 15 秒安排一次重新运行 EB 事件。缩短采集增加串口负载，缩短上报增加无线流量；参数实际值以读回为准。
保存 3D 位置时填写 location 对象：scene_id、model_id、coordinate_system、unit 和 position 的 x/y/z。随后回读 _location_3d；此操作不改变正式位置归属。
验收范围
PUBLIC 资源已发布并读回；真实设备动作、自然采集周期、业务 MQTT、持久日志和应用等待状态仍需现场验收。原接入完整验收门仍有未通过或缺环境项目，不能把公共目录可用当作全流程验收。告警和自控策略需在部署时独立设计。
模型清单
| 模型类型 | 名称 | id_name | 平台模型 ID |
|---|---|---|---|
| Template | SM-MS9380B-21316-PUBLIC | 162620014623354880 | |
| Thing Model | MS9380B公共采集参数 | ms9380b_public_para_21316 | 162620014623354882 |
| Thing Model | MS9380B公共故障 | ms9380b_public_fault_21316 | 162620014623354883 |
| Thing Model | MS9380B公共实时数据 | ms9380b_public_21316 | 162620014623354881 |
| RPC | [MS9380B公共] 开关机 | ms9380b_public_power_21316 | 162620014623354886 |
| RPC | [MS9380B公共] 设置采集参数 | ms9380b_public_set_21316 | 162620014623354884 |
| RPC | [MS9380B公共] 设置定时关原始值 | ms9380b_public_timer_off_21316 | 162620014623354889 |
| RPC | [MS9380B公共] 读取采集参数 | ms9380b_public_get_21316 | 162620014623354885 |
| RPC | [MS9380B公共] 设置定时开原始值 | ms9380b_public_timer_on_21316 | 162620014623354888 |
| RPC | [MS9380B公共] 保存3D模型位置 | ms9380b_public_location_21316 | 162620014623354890 |
| RPC | [MS9380B公共] 设置湿度 | ms9380b_public_humidity_21316 | 162620014623354887 |
数据字段
ms9380b_public_para_21316
| 字段 | 含义 | 类型 | 单位 |
|---|---|---|---|
| period_up | 业务上报周期 | number | s |
| command_id | 指令标识 | string | |
| addr_modbus | Modbus站号 | number | |
| command_rpc | 关联指令 | string | |
| period_read | 采集周期 | number | s |
| pwron_delay | 上电延时 | number | ms |
| period_heart | 心跳周期 | number | s |
| command_status | 指令反馈状态 | string | |
| sub_device_counts | 原生多设备数量（固定0） | number | |
| command_observed_at | 指令反馈时间 | string | |
| parameter_observed_at | 参数反馈时间 | string |
ms9380b_public_fault_21316
| 字段 | 含义 | 类型 | 单位 |
|---|---|---|---|
| fault_observed_at | 故障反馈时间 | string | |
| fault_communication_ok | 故障数据通信正常 | boolean | |
| fault_defrost_sensor_1 | 化霜传感器1故障 | number | |
| fault_defrost_sensor_2 | 化霜传感器2故障 | number | |
| fault_indoor_sensor | 室内温湿度传感器故障 | number | |
| fault_pressure | 压保故障 | number | |
| fault_water_full | 水满 | number | |
| fault_phase_missing | 缺相故障 | number | |
| fault_phase_sequence | 相序故障 | number | |
| fault_text | 故障详情 | string | |
| collect_timeout | 采集超时 | number |
ms9380b_public_21316
| 字段 | 含义 | 类型 | 单位 |
|---|---|---|---|
| status | 采集状态字节 | number | |
| command_id | 指令标识 | string | |
| command_rpc | 关联指令 | string | |
| timer_on_raw | 定时开原始值 | number | |
| command_status | 指令反馈状态 | string | |
| communication_ok | 控制数据通信正常 | boolean | |
| power_expires_at | 开关状态有效期限 | string | |
| report_received_at | 报文接收时间 | string | |
| command_observed_at | 指令反馈时间 | string | |
| control_observed_at | 控制状态反馈时间 | string | |
| measurement_observed_at | 测量反馈时间 | string | |
| measurement_communication_ok | 测量数据通信正常 | boolean | |
| timer_off_raw | 定时关原始值 | number | |
| power_switch | 开关状态 | number | |
| humidity_set | 设置湿度 | number | %RH |
| indoor_temp | 室内温度 | number | ℃ |
| indoor_humidity | 室内湿度 | number | %RH |
| defrost_temp_1_raw | 化霜探头1原始值 | number | |
| defrost_temp_2_raw | 化霜探头2原始值 | number | |
| has_fault | 故障总标志 | number | |
| collect_timeout | 采集超时 | number |
模型名称与 ID 已于 2026-10-13 从 ThinkLink PUBLIC 目录核对。模型可用性不代表现场设备已经完成接线、固件安装或控制验收。