address 控制地址全量表

本页是 接口文档中占据近一半篇幅的 address 映射表的完整整理。

怎么用这张表

1. 找到你设备对应的功能项（如「右向天窗」）
2. 拿到它的 address 与「控制值」
3. 用 控制设备 下发 address + value
4. 用 读取地址值 回读确认

「控制值」列列出该地址支持的位串（照录）。位串含义速查见下表。

控制值速查

控制值	含义	文档表述
1010	手动开	「1010手动开」
1001	手动关	「1001手动关」
1100	自动	「1100自动」
10010	手动开	「10010手动开」
10001	手动关	「10001 手动关」
11000	自动	「11000自动」
10100	指定位置模式	「10100指定位置」
0-100	开度值	「0-100（<地址>需要先设置为10100）」
11111111	轮灌方式	「11111111采用轮灌方式」

指定位置类设备必须两步操作

凡「控制值」里写了 10100指定位置 的项，都需要：

1. 先向该地址下发 10100（切到指定位置模式）
2. 再向该地址下发 0~100 的开度值

文档在「0-100」后面特别标注了需要先设置的那个地址（如「0-100（3217需要先设置为10100）」）， 该地址就是本行的 address。

---

一、电机停止类（address 568 / 569 / 其他）

这类地址的控制值是位串，用来停止指定的电机转动。

address 568

address	描述	控制
568	左向天窗停止电机转动	10000000
568	右向天窗停止电机转动	01000000
568	侧通风窗停止电机转动	00100000
568	4#通风窗停止电机转动	00010000
568	1#外遮阳停止电机转动	00001000
568	2#外遮阳停止电机转动	00000100
568	东侧遮阳幕停止电机转动	00000010
568	南侧遮阳幕停止电机转动	00000001
568	2#保温被(卷帘)停止电机转动	00000010

文档表中同一位串出现两次

00000010 同时对应「东侧遮阳幕停止电机转动」与「2#保温被(卷帘)停止电机转动」， 568 与 569 的位序也存在交叉。这是文档表本身的情形，本文档照录。 使用时请以现场设备实际响应为准。

address 569

address	描述	控制
569	侧保温帘停止电机转动	00001000
569	2#侧保温帘停止电机转动	00000100
569	3#侧保温帘停止电机转动	00000010
569	4#侧保温帘停止电机转动	00000001
569	内保温幕停止电机转动	00010000
569	内遮阳幕停止电机转动	00100000
569	北侧遮阳幕停止电机转动	01000000
569	保温被(卷帘)停止电机转动	01000000
569	西侧遮阳幕停止电机转动	10000000

---

二、功能设备控制地址

文档表格未标注每个功能项的 address 数值

这批表格（「描述 / 控制」两列）没有给出对应的 address 数值列。

因此下表只列出「描述 + 控制值」对照；具体 address 数值请通过 平台 Web 界面（开发者工具 F12 观察实际请求）获取，或向运营方索取完整地址清单。 已知的地址示例：3112（一级~三级风机 + 湿帘）、3217（右向天窗指定位置）、 3417（右向天窗）、3617、4989、5079、5300、5380、5460、5540、6585、 2976、3118 等（均从平台返回与文档说明中整理）。

描述	控制值（照录）
环流风扇	1010 手动开　1001 手动关　1100 自动
紫外消毒	1010 手动开　1001 手动关　1100 自动
微雾加湿	1010 手动开　1001 手动关　1100 自动
补光灯	1010 手动开，控制补光灯前，先执行该指令
补光灯位置	10000000 只控制 1 号　11000000 同时控制 1、2 号　11111111 同时控制 8 组补光
水暖加温	1010 手动开　1001 手动关　1100 自动
水暖加温指定位置	0-100（地址 2184 需要先设置为 10100）
co2 补气	1010 手动开　1001 手动关　1100 自动
加湿除湿	1010 手动开　1001 手动关　1100 自动
热风机	1010 手动开　1001 手动关　1100 自动
加热热风机	1010 手动开　1001 手动关　1100 自动
微雾降温	1010 手动开　1001 手动关　1100 自动
内遮阳幕	10010 手动开　10001 手动关　11000 自动　10100 指定位置
内遮阳幕指定位置	0-100（地址 2976 需要先设置为 10100）
内保温幕	10010 手动开　10001 手动关　11000 自动　10100 指定位置
左向天窗	10010 手动开　10001 手动关　11000 自动　10100 指定位置
左向天窗指定位置	0-100（地址 3118 需要先设置为 10100）
右向天窗	10010 手动开　10001 手动关　11000 自动　10100 指定位置
右向天窗指定位置	0-100（地址 3217 需要先设置为 10100）
侧通风窗	10010 手动开　10001 手动关　11000 自动　10100 指定位置
侧通风窗指定位置	0-100（地址 3417 需要先设置为 10100）
湿帘外翻窗	10010 手动开　10001 手动关　11000 自动　10100 指定位置
湿帘外翻窗指定位置	0-100（地址 3617 需要先设置为 10100）
东侧遮阳幕	10010 手动开　10001 手动关　11000 自动　10100 指定位置
东侧遮阳幕指定位置	0-100（地址 4989 需要先设置为 10100）
西侧外遮阳	10010 手动开　10001 手动关　11000 自动　10100 指定位置
西侧外遮阳指定位置	0-100（地址 5079 需要先设置为 10100）
1#外遮阳幕	10010 手动开　10001 手动关　11000 自动　10100 指定位置
1#外遮阳幕指定位置	0-100（地址 5300 需要先设置为 10100）
南侧外遮阳	10010 手动开　10001 手动关　11000 自动　10100 指定位置
南侧外遮阳指定位置	0-100（地址 5380 需要先设置为 10100）
北侧外遮阳	10010 手动开　10001 手动关　11000 自动　10100 指定位置
北侧外遮阳指定位置	0-100（地址 5460 需要先设置为 10100）
2#外遮阳幕	10010 手动开　10001 手动关　11000 自动　10100 指定位置
2#外遮阳幕指定位置	0-100（地址 5540 需要先设置为 10100）
侧保温帘	10010 手动开　10001 手动关　11000 自动　10100 指定位置
侧保温帘指定位置	0-100（地址 6585 需要先设置为 10100）
室外喷淋	1010 手动开　1001 手动关　1100 自动
上层一级风机	1010 手动开　1001 手动关　1100 自动
上层二级风机	1010 手动开　1001 手动关　1100 自动
上层湿帘	1010 手动开　1001 手动关　1100 自动
土壤加湿	1010 手动开　1001 手动关　1100 自动

风机湿帘（组合控制）

控制值	含义（照录）
11110	全开
11100	1、2、3 级风扇开，湿帘关
11000	1、2 级风扇开，3 级风扇关，湿帘关
10000	1 级风扇开，2、3 级风扇关，湿帘关
00000	全关

灌溉计划类（1# ~ 12#）

控制值	含义（照录）
1010	手动开
1001	手动关
1100	自动
11111111	采用轮灌方式

灌溉计划在 device_status 里用 order 区分

读取控制参数时，多个灌溉计划会以同名条目 + 不同 order 出现 （如 灌溉计划灌水 的 order = 0/1/2）。请用「名称 + order」作为唯一键。

其他功能项

描述	控制值（照录）
下风口	00100000 停止电机转动
2#下风口	00001000 停止电机转动
上风口	01000000 停止电机转动
2#上风口	00010000 停止电机转动
北侧遮阳幕	01000000 停止电机转动
西侧遮阳幕	10000000 停止电机转动

---

三、位串解析约定

风机 / 湿帘位串（以地址 3112 为例）

文档说明：

例如：地址 3112 对应的数值是 00001（从左向右，第 0 位代表一级风机，第 1 位代表二级风机， 第 2 位代表三级风机，第 3 位代表湿帘，如果第 0 位是 1，代表一级风机开，其他位同理）

文档这句描述内部互相矛盾

「从左向右第 0 位」与「00001 中第 0 位是 1」不可能同时成立 （00001 最左位是 0、最右位才是 1）。

不要按文字猜，请用现场操作核对：

1. 在平台页面把一级风机切到「开」
2. 调 读取地址值 读 address=3112
3. 看哪一位从 0 变 1 ⇒ 那就是一级风机对应的位，同时确定了位序方向
4. 把结论写成单元测试固化

控制参数状态位（device_status 的 status）

「开关停」/「开关型」设备的位语义与自动手动判定，见 读取控制参数 · status 位语义。

---

四、平台暂未收录的地址

接口文档在文档末尾说明：

更多参数设置可通过访问 web 界面，通过开发者模式（F12），实际操作获得对应的地址以及……

即平台存在本文档未收录的控制地址。获取方式：

1. 在浏览器中打开平台 Web 界面并登录
2. 按 F12 打开开发者工具 → Network 面板
3. 在页面上操作目标设备
4. 观察发出的 POST /api/set-value 请求，记录 address 与 value

未文档化的地址不可直接用于生产

通过这种方式得到的地址不在对外文档的范围内，平台不保证其稳定性。 如需在生产系统里使用，请先与运营方确认。

下一步

• → 控制设备：用 address + value 下发指令
• → 读取地址值：回读地址当前值
• → 设备类型映射表：设备类型与地址的对照