农业 IoT 开放平台

中文

English

中文

English

外观

address 控制地址全量表 ​

本页列出平台支持控制的 address，以及每个地址下发时应该使用的 value。

使用步骤

  1. 在下方控制地址总表找到要控制的功能项
  2. 按下发的目标场景，在控制值示例里找到对应的 value
  3. 调用控制设备接口，把 deviceCode + address + value 发出去
  4. 调用读取地址值接口回读，确认已生效

一、控制地址总表 ​

功能项address位宽位定义
左向天窗32175 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
右向天窗34175 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
侧通风窗36175 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
4#通风窗63855 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
内遮阳幕29765 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
内保温幕30085 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
1#侧保温帘65855 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
2#侧保温帘68145 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
3#侧保温帘68555 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
4#侧保温帘68965 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
南侧遮阳幕53805 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
西侧遮阳幕50795 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
2#外遮阳幕55405 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
1#外遮阳幕53008 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关；第 6~8 位按平台扩展定义
风机湿帘（开关）31114 位第 1 位=有效性；第 2 位=自动；第 3 位=手动开；第 4 位=手动关
风机湿帘（手动输出）31125 位第 1 位=一级风机；第 2 位=二级风机；第 3 位=三级风机；第 4 位=湿帘；第 5 位=固定为 0
湿帘外翻窗31185 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
上层一级风机47565 位第 1 位=有效性；第 2 位=自动；第 3 位=手动开；第 4 位=手动关；第 5 位=是否使用平均温度
上层二级风机47685 位第 1 位=有效性；第 2 位=自动；第 3 位=手动开；第 4 位=手动关；第 5 位=是否使用平均温度
上层三级风机47805 位第 1 位=有效性；第 2 位=自动；第 3 位=手动开；第 4 位=手动关；第 5 位=是否使用平均温度
上层四级风机47925 位第 1 位=有效性；第 2 位=自动；第 3 位=手动开；第 4 位=手动关；第 5 位=是否使用平均温度
上层湿帘控制48045 位第 1 位=有效性；第 2 位=自动；第 3 位=手动开；第 4 位=手动关；第 5 位=是否使用平均温度
上层湿帘外翻窗66265 位第 1 位=有效性；第 2 位=自动；第 3 位=手动指定位置；第 4 位=手动持续开；第 5 位=手动持续关
环流风扇20294 位第 1 位=有效性；第 2 位=自动；第 3 位=手动开；第 4 位=手动关
补光灯21144 位第 1 位=有效性；第 2 位=自动；第 3 位=手动开；第 4 位=手动关
水暖加温2184—先下发 10100 切到手动指定位置，再下发 0~100 的加温档位

二、控制值示例 ​

value 是按位拼出来的字符串，第 1 位对应位定义里的「第 1 位」，依次向右。

5 位：开窗 / 遮阳幕 / 保温帘 / 外翻窗 ​

控制目标value逐位说明
自动控制110001=有效性 ｜ 1=自动 ｜ 0 ｜ 0 ｜ 0
手动开到指定位置101001=有效性 ｜ 0 ｜ 1=手动指定位置 ｜ 0 ｜ 0
手动持续开100101=有效性 ｜ 0 ｜ 0 ｜ 1=手动持续开 ｜ 0
手动持续关100011=有效性 ｜ 0 ｜ 0 ｜ 0 ｜ 1=手动持续关
关闭有效性（停止平台自动控制）00000全部置 0

示例：把 4#通风窗设为自动模式

json
POST /api/set-value
{
  "deviceCode": "2025010112000001",
  "address": "6385",
  "value": "11000"
}

示例：把 4#通风窗手动开到 50%

json
POST /api/set-value
{
  "deviceCode": "2025010112000001",
  "address": "6385",
  "value": "10100"
}
json
POST /api/set-value
{
  "deviceCode": "2025010112000001",
  "address": "6385",
  "value": "50"
}

4 位：风机湿帘 / 环流风扇 / 补光灯 ​

控制目标value逐位说明
自动控制11001=有效性 ｜ 1=自动 ｜ 0 ｜ 0
手动开10101=有效性 ｜ 0 ｜ 1=手动开 ｜ 0
手动关10011=有效性 ｜ 0 ｜ 0 ｜ 1=手动关

示例：手动开启补光灯

json
POST /api/set-value
{
  "deviceCode": "2025010112000001",
  "address": "2114",
  "value": "1010"
}

5 位：3112 风机湿帘手动输出 ​

第 5 位固定为 0，前 4 位依次是一级风机、二级风机、三级风机、湿帘。

控制目标value一级风机二级风机三级风机湿帘
四路全开11110开开开开
开二、三级风机和湿帘01110关开开开
只开一级风机10000开关关关
全部关闭00000关关关关

示例：开启二级、三级风机和湿帘

json
POST /api/set-value
{
  "deviceCode": "2025010112000001",
  "address": "3112",
  "value": "01110"
}

5 位：4756 / 4768 / 4780 / 4792 / 4804 上层风机 ​

第 5 位表示是否使用平均温度（1=使用平均温度，0=使用 7# 温度）。

控制目标value逐位说明
自动控制，用 7# 温度110001=有效性 ｜ 1=自动 ｜ 0 ｜ 0 ｜ 0
自动控制，用平均温度110011=有效性 ｜ 1=自动 ｜ 0 ｜ 0 ｜ 1=平均温度
手动开，用 7# 温度101001=有效性 ｜ 0 ｜ 1=手动开 ｜ 0 ｜ 0
手动关，用 7# 温度100101=有效性 ｜ 0 ｜ 0 ｜ 1=手动关 ｜ 0

示例：上层二级风机自动控制，使用平均温度

json
POST /api/set-value
{
  "deviceCode": "2025010112000001",
  "address": "4768",
  "value": "11001"
}

三、指定位置：必须分两步 ​

带「手动指定位置」的功能项（开窗、遮阳幕、保温帘、外翻窗），要连发两次：

步骤内容说明
第 1 步下发 10100把设备切到「手动指定位置」模式
第 2 步下发 0~100目标开度，0=全关，100=全开

只发第 1 步设备不会动作

10100 只是切换模式，机构不会移动。必须紧接着下发开度值。

示例：把左向天窗开到 30%

json
POST /api/set-value
{
  "deviceCode": "2025010112000001",
  "address": "3217",
  "value": "10100"
}
json
POST /api/set-value
{
  "deviceCode": "2025010112000001",
  "address": "3217",
  "value": "30"
}

四、电机停止（address 568 / 569） ​

用于紧急停止电机。value 是 8 位字符串，某一位为 1 表示停止对应电机。

address 568 ​

停止对象value
左向天窗10000000
右向天窗01000000
侧通风窗00100000
4#通风窗00010000
1#外遮阳00001000
2#外遮阳00000100
东侧遮阳幕00000010
南侧遮阳幕00000001
2#保温被（卷帘）00000010

示例：紧急停止左向天窗电机

json
POST /api/set-value
{
  "deviceCode": "2025010112000001",
  "address": "568",
  "value": "10000000"
}

address 569 ​

停止对象value
侧保温帘00001000
2#侧保温帘00000100
3#侧保温帘00000010
4#侧保温帘00000001
内保温幕00010000
内遮阳幕00100000
北侧遮阳幕01000000
保温被（卷帘）01000000
西侧遮阳幕10000000

同一位置值对应两个对象时

568 的 00000010 同时对应「东侧遮阳幕」与「2#保温被（卷帘）」， 569 的 01000000 同时对应「北侧遮阳幕」与「保温被（卷帘）」。

下发前请确认现场实际安装的是哪一个，避免误停。

五、风机湿帘组合档位 ​

address 为 3112 时，也可以用以下组合值整体控制：

控制目标value含义
全开11110一、二、三级风机 + 湿帘全部开启
开三级风机11100一、二、三级风机开启，湿帘关闭
开二级风机11000一、二级风机开启，三级风机与湿帘关闭
只开一级风机10000仅一级风机开启
全关00000风机与湿帘全部关闭

六、灌溉计划（1# ~ 12#） ​

控制目标value
手动开1010
手动关1001
自动1100
采用轮灌方式11111111

多个灌溉计划如何区分

读取控制参数时，多套灌溉计划会以同名条目出现，需要通过返回的 order 字段区分 （如「灌溉计划灌水」的 order 为 0、1、2）。 请用「名称 + order」作为唯一标识。

示例：1# 灌溉计划手动开启

json
POST /api/set-value
{
  "deviceCode": "2025010112000001",
  "address": "1136",
  "value": "1010"
}

七、其他功能项 ​

功能项address控制值
紫外消毒见下方说明1010 手动开 ｜ 1001 手动关 ｜ 1100 自动
微雾加湿见下方说明1010 手动开 ｜ 1001 手动关 ｜ 1100 自动
水暖加温见下方说明1010 手动开 ｜ 1001 手动关 ｜ 1100 自动
CO2 补气见下方说明1010 手动开 ｜ 1001 手动关 ｜ 1100 自动
加湿除湿见下方说明1010 手动开 ｜ 1001 手动关 ｜ 1100 自动
热风机见下方说明1010 手动开 ｜ 1001 手动关 ｜ 1100 自动
加热热风机见下方说明1010 手动开 ｜ 1001 手动关 ｜ 1100 自动
微雾降温见下方说明1010 手动开 ｜ 1001 手动关 ｜ 1100 自动
室外喷淋见下方说明1010 手动开 ｜ 1001 手动关 ｜ 1100 自动
土壤加湿见下方说明1010 手动开 ｜ 1001 手动关 ｜ 1100 自动
补光灯位置见下方说明10000000 只控第 1 组 ｜ 11000000 同控第 1、2 组 ｜ 11111111 同控 8 组
下风口见下方说明00100000 停止电机
2#下风口见下方说明00001000 停止电机
上风口见下方说明01000000 停止电机
2#上风口见下方说明00010000 停止电机
北侧遮阳幕见下方说明01000000 停止电机
西侧遮阳幕见下方说明10000000 停止电机

补光灯使用前需先开启总开关

控制补光灯前，先向补光灯总控下发一次 1010（手动开），再控制具体的补光灯组。

这批功能项的 address 请按下节方法获取。

八、如何获取本页未列的 address ​

平台共有 5000 多个地址定义，本页覆盖常用的控制地址。若需其他功能的地址：

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

使用前提

通过这种方式得到的地址，请先在测试设备上验证通过，再用于生产环境。 如需长期稳定使用，建议联系运营方确认。

下一步 ​

基于 VitePress 构建 · 文档版本 v3.0

Copyright © 农业 IoT 开放平台