product manual

MODBUS-RTU全彩RGB灯带控制器使用说明书

freeFree Technical Resource

This content is free to read, suitable for basic learning and search traffic.

modbus Technical TeamBrilliant Member 约 37 min read
MODBUS-RTU全彩RGB灯带控制器使用说明书缩略图
🌐 This page is not yet available in English. Showing the Chinese version. Back to Chinese page.
Source: Modbus Chinese Network（modbus.cn） —— China leadingModbuscommunication protocol technical community
本文：MODBUS-RTU全彩RGB灯带控制器使用说明书 · Author：modbus Technical Team · 发布于 2025-10-11
摘要：一、技术参数。​​工作温度​​：-20 - 60℃ ​​。
本文目录
  1. 1. 一、技术参数
  2. 2. 二、功能特点
  3. 3. 三、无缝多协议
  4. 4. 四、可靠的安全性能
  5. 5. 五、接线端说明
  6. 6. 六、控制器选项表
  7. 7. 七、通信协议说明
  8. 8. 1. 概述
  9. 9. 出厂默认参数
  10. 10. 2. 指令格式说明
  11. 11. 基本指令格式
  12. 12. 各字段说明
  13. 13. 3. 具体指令说明
  14. 14. 3.1 设置RGB(RGBW)值
  15. 15. 3.2 查询RGB(RGBW)值
  16. 16. 3.3 控制器场景功能设置
  17. 17. 3.3.1 呼吸灯场景内容表
  18. 18. 3.3.2 暴闪场景内容表
  19. 19. 3.3.3 调光场景内容表
  20. 20. 3.3.4 单步调光场景内容表
  21. 21. 3.3.5 开关场景内容表
  22. 22. 4. Precautions
  23. 23. 1. 概述
  24. 24. 1.1 寄存器地址表
  25. 25. 2. 指令列表
  26. 26. 2.1 控制器参数设置
  27. 27. 2.2 控制器参数查询
  28. 28. 2.3 控制器输出值设置
  29. 29. 2.4 控制器输出值查询
  30. 30. 2.5 控制器场景功能设置
  31. 31. 3. 通信参数默认值
  32. 32. 4. Precautions
  33. 33. 调试助手下载

一、技术参数

​​工作温度​​：-20 – 60℃ ​​

工作电压​​：DC12V – DC24V ​​

输出电流​​：16A（每个回路） ​​

额定功率​​：12V：<500W 24V：<1000W ​​

输出回路​​：红（R）、绿（G）、蓝（B）三个通道 ​​

输出颜色​​：16777216(256 * 256 * 256）种 ​​

输出连接​​：共阳 ​​

静态功耗​​：<0.3W ​​

外形尺寸​​：88mm * 54mm * 59mm（长宽高） ​​

通信方式​​：RS485 ​​

Baud rate​​：4800 9600 19200 38400 57600 115200 ​​

通信协议​​：自有协议、MODBUS-RTUProtocol、Custom Protocol

二、功能特点

​​多种场景​​：

  • 颜色控制、无极自动调光
  • 定时开关、全彩爆闪、7色呼吸

​​灵活的指令​​：

  • 自定义指令关联控制
  • 自带IO控制、remoteIO控制
  • 双色筒灯调色温专用指令
  • 单回路、多回路定时开关控制
  • RGB灯色彩控制（多达1600万色）
  • 可配置波特率、上电记忆功能、回复使能

​​丰富的输入输出功能​​：

  • 2个可编程输入IO
  • 6个可编程自动场景
  • 延时控制、延时输入技术（方便对接人体感应）

​​多种负载对接能力​​：

  • 标准共阳RGB灯带/灯具
  • 独立的单色灯带、双色温筒灯

三、无缝多协议

  • 本司自定协议(推荐采用)
  • 工业级标准MODBUS协议系统
  • 多达6条用户可自定义协议(需要配合本司自定协议使用)

四、可靠的安全性能

  • RS485通信控制
  • 55A原装进口MOS
  • 防电源反接功能，宽电压7-28V供电
  • 强干扰环境的应用，可选择高速隔离通信版
  • 全部使用大厂原装器件，高性价比。工业级进口MCU抗干扰能力强

五、接线端说明

V+：模块供电正极（宽电压7-26V供电） V-：模块供电负极 A：RS485的A端 B：RS485的B端 V+：共阳RGB灯正极（与供电的V+相通） R：LED红色（负极） G：LED绿色（负极） B：LED蓝色（负极）

MODBUS-RTU全彩RGB灯带控制器使用说明书插图

六、控制器选项表

型号Communication Interface通信隔离负载能力单回路负载能力供电电源
WE102RS485无15A5A–
WE102ARS485无20A5A–
WE102BRS485有15A5A–
WE102CRS485有20A5A–
WE102DRS485无6A2A–
WE102ERS485无8A2A–
WE102FRS485无6A2A–

​​说明​​：

  1. 控制器是低压直流控制器，默认的供电电压是DC:7-28V。建议12V或24V。当应用在供电电压大于28V时，需要提前联系客服人员进行定制。
  2. 控制器的输出端口是大功率MOS管，严禁负载(输出与V+)短路。为了防止负载短路，请选择与负载功率合适的保险管进行保护。
  3. 控制器的负载电压与供电电压要一致。

七、通信协议说明

自有协议

本协议用于配置设备的 RS485 Communication parameters。所有命令均以 0xA5开头，以 0x5A结尾。​​checksum​​是从 ​​长度字节​​ 开始，to ​​校验和字节之前​​ 的所有字节的累加和（通常取低8位）。

1. 设置通信地址 (0xB0)

  • ​​Function：​​ 更改设备的通信地址。
  • ​​重要提示：​​

o如果设备上有 ​​地址拨码开关​​，此命令​​Invalid​​，会返回失败 (0xB3)。必须使用拨码开关设置地址。

o​​拨码开关操作：​​

  • 出厂默认：所有开关在非数字侧 (1)，地址为 0xFF。
  • 设置地址：将开关拨到数字侧表示该位为 0，否则为 1。
  • ​​必须断电操作！​​ 带电操作可能损坏控制器。
  • 拨码开关设置后，​​重新通电​​生效。

o使用此命令设置地址：​​无需断电，立即生效​​，新地址会保存。

  • ​​send command (主机 -> device)：​​
字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x04此命令数据部分长度 (旧地址 + 命令字 + 新地址 = 3字节)
3旧地址0xXX​​current​​与设备通信使用的地址 (0x00-0xFF)
4命令字0xB0地址设置命令
5新地址0xXX要设置的​​新地址​​ (0x00-0xFF)
6checksum0xXX从 ​​Length (0x04)​​ to ​​新地址​​ 的累加和 (SUM(0x04, 旧地址, 0xB0, 新地址))
7结束码0x5A固定结束符

·

  • ​​接收响应 (device -> 主机)：​​
字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x03此响应数据部分长度 (新地址 + 命令字 = 2字节)
3新地址0xXX设备当前使用的地址 (即设置后的地址)
4命令字0xB2 / 0xB3​​0xB2 = 设置成功​​
​​0xB3 = 设置失败​​ (通常因拨码开关存在导致)
5checksum0xXX从 ​​Length (0x03)​​ to ​​命令字​​ 的累加和 (SUM(0x03, 新地址, 命令字))
6结束码0x5A固定结束符

·

2. 查询通信地址 (0xB1)

·​​Function：​​ 查询设备当前的通信地址。

·​​send command (主机 -> device)：​​

字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x03此命令数据部分长度 (address + 命令字 = 2字节)
3address0xXX / 0xFF​​本机地址​​ (单台查询) 或 ​​0xFF​​ (广播查询，所有设备都会响应地址)
4命令字0xB1地址查询命令
5checksum0xXX从 ​​Length (0x03)​​ to ​​命令字 (0xB1)​​ 的累加和 (SUM(0x03, address, 0xB1))
6结束码0x5A固定结束符

·

·​​接收响应 (device -> 主机)：​​

字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x03此响应数据部分长度 (address + 命令字 = 2字节)
3address0xXXdevice​​current​​的通信地址
4命令字0xB2地址查询回复命令 (固定为成功回复)
5checksum0xXX从 ​​Length (0x03)​​ to ​​命令字 (0xB2)​​ 的累加和 (SUM(0x03, address, 0xB2))
6结束码0x5A固定结束符

·

3. 设置通信波特率 (0xB4)

  • ​​Function：​​ 更改设备的 RS485 通信波特率。
  • ​​send command (主机 -> device)：​​
字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x04此命令数据部分长度 (address + 命令字 + Baud rate = 3字节)
3address0xXX​​current​​与设备通信使用的地址 (0x00-0xFF)
4命令字0xB4波特率设置命令
5Baud rate0x01-0x05​​1=4800, 2=19200, 3=38400, 4=57600, 5=115200, 其他=9600​​
6checksum0xXX从 ​​Length (0x04)​​ to ​​Baud rate​​ 的累加和 (SUM(0x04, address, 0xB4, Baud rate))
7结束码0x5A固定结束符

·

  • ​​接收响应 (device -> 主机)：​​
字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x04此响应数据部分长度 (address + 命令字 + Baud rate = 3字节)
3address0xXXDevice address
4命令字0xB6 / 0xB7​​0xB6 = 设置成功​​
​​0xB7 = 设置失败​​
5Baud rate0x01-0x05​​设备当前使用的波特率​​ (1=4800, 2=19200, 3=38400, 4=57600, 5=115200, 其他=9600)
6checksum0xXX从 ​​Length (0x04)​​ to ​​Baud rate​​ 的累加和 (SUM(0x04, address, 命令字, Baud rate))
7结束码0x5A固定结束符

·

4. 查询通信波特率 (0xB5)

·​​Function：​​ 查询设备当前的 RS485 通信波特率。

·​​send command (主机 -> device)：​​

字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x03此命令数据部分长度 (address + 命令字 = 2字节)
3address0xXX / 0xFF​​本机地址​​ (单台查询) 或 ​​0xFF​​ (广播查询)
4命令字0xB5波特率查询命令
5checksum0xXX从 ​​Length (0x03)​​ to ​​命令字 (0xB5)​​ 的累加和 (SUM(0x03, address, 0xB5))
6结束码0x5A固定结束符

·

·​​接收响应 (device -> 主机)：​​

字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x04此响应数据部分长度 (address + 命令字 + Baud rate = 3字节)
3address0xXXDevice address
4命令字0xB6 / 0xB7​​0xB6 = 查询成功​​
​​0xB7 = 查询失败​​ (不常见)
5Baud rate0x01-0x03​​设备当前使用的波特率​​ (​​1=19200, 2=57600, 3=115200, 其他=9600​​)
6checksum0xXX从 ​​Length (0x04)​​ to ​​Baud rate​​ 的累加和 (SUM(0x04, address, 命令字, Baud rate))
7结束码0x5A固定结束符

·

o​​注意：​​ 查询响应中的波特率数值定义 (1=19200, 2=57600, 3=115200) 与设置命令 (1=4800, 2=19200, 3=38400…) ​​不同​​，且范围更小。其他=9600是相同的。

5. 设置是否回复 ACK (0xB8)

·​​Function：​​ 设置设备在收到命令后是否回复确认 (ACK)。

o0x00(默认): ​​Reply​​ ACK。

o0x01: ​​不回复​​ ACK。

·​​send command (主机 -> device)：​​

字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x04此命令数据部分长度 (address + 命令字 + 回复关闭 = 3字节)
3address0xXX​​current​​与设备通信使用的地址 (0x00-0xFF)
4命令字0xB8ACK 回复设置命令
5回复关闭0x00 / 0x01​​0 = ReplyACK (默认)​​
​​1 = 不回复ACK​​
6checksum0xXX从 ​​Length (0x04)​​ to ​​回复关闭​​ 的累加和 (SUM(0x04, address, 0xB8, 回复关闭))
7结束码0x5A固定结束符

·

·​​接收响应 (device -> 主机)：​​

字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x04此响应数据部分长度 (address + 命令字 + 回复关闭 = 3字节)
3address0xXXDevice address
4命令字0xBA / 0xBB​​0xBA = 设置成功​​
​​0xBB = 设置失败​​
5回复关闭0x00 / 0x01​​设备当前的ACK回复状态​​ (0=Reply, 1=不回复)
6checksum0xXX从 ​​Length (0x04)​​ to ​​回复关闭​​ 的累加和 (SUM(0x04, address, 命令字, 回复关闭))
7结束码0x5A固定结束符

·

6. 查询是否回复 ACK (0xB9)

  • ​​Function：​​ 查询设备当前是否回复 ACK。
  • ​​重要提示：​​ 如果设备已设置为不回复 ACK (0x01)，发送此查询命令后，device​​不会回复​​任何数据（通信灯可能会闪，但串口无输出）。
  • ​​send command (主机 -> device)：​​
字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x03此命令数据部分长度 (address + 命令字 = 2字节)
3address0xXX / 0xFF​​本机地址​​ (单台查询) 或 ​​0xFF​​ (广播查询)
4命令字0xB9ACK 回复查询命令
5checksum0xXX从 ​​Length (0x03)​​ to ​​命令字 (0xB9)​​ 的累加和 (SUM(0x03, address, 0xB9))
6结束码0x5A固定结束符

·

  • ​​接收响应 (device -> 主机)：​​ (仅当设备设置为回复 ACK 时才会收到) 
字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x04此响应数据部分长度 (address + 命令字 + 回复关闭 = 3字节)
3address0xXXDevice address
4命令字0xBA / 0xBB​​0xBA = 查询成功​​
​​0xBB = 查询失败​​ (不常见)
5回复关闭0x00 / 0x01​​设备当前的ACK回复状态​​ (0=Reply, 1=不回复)
6checksum0xXX从 ​​Length (0x04)​​ to ​​回复关闭​​ 的累加和 (SUM(0x04, address, 命令字, 回复关闭))
7结束码0x5A固定结束符

·

7. 设置断电输出状态记忆功能 (0xBC)

  • ​​Function：​​ 控制设备断电后是否记忆并恢复断电前的输出状态。

o0x00(默认): ​​不记忆​​。下次上电输出为默认状态。

o0x01: ​​记忆​​。下次上电恢复断电前的输出状态。

  • ​​说明：​​ 开启记忆功能 (0x01) 后，设备会在​​下一次收到有效的输出控制命令并执行后​​，将​​当时的输出状态​​保存下来。断电后，下次上电即恢复该状态。
  • ​​send command (主机 -> device)：​​
字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x04此命令数据部分长度 (address + 命令字 + 记忆功能 = 3字节)
3address0xXX​​current​​与设备通信使用的地址 (0x00-0xFF)
4命令字0xBC记忆功能设置命令
5记忆功能0x00 / 0x01​​0 = 不记忆 (默认)​​
​​1 = 记忆​​
6checksum0xXX从 ​​Length (0x04)​​ to ​​记忆功能​​ 的累加和 (SUM(0x04, address, 0xBC, 记忆功能))
7结束码0x5A固定结束符

·

  • ​​接收响应 (device -> 主机)：​​
字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x04此响应数据部分长度 (address + 命令字 + 记忆功能 = 3字节)
3address0xXXDevice address
4命令字0xBE / 0xBF​​0xBE = 设置成功​​
​​0xBF = 设置失败​​
5记忆功能0x00 / 0x01​​设备当前的记忆功能状态​​ (0=不记忆, 1=记忆)
6checksum0xXX从 ​​Length (0x04)​​ to ​​记忆功能​​ 的累加和 (SUM(0x04, address, 命令字, 记忆功能))
7结束码0x5A固定结束符

·

8. 查询断电输出状态记忆功能 (0xBD)

  • ​​Function：​​ 查询设备当前的断电输出状态记忆功能状态。
  • ​​send command (主机 -> device)：​​
字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x03此命令数据部分长度 (address + 命令字 = 2字节)
3address0xXX / 0xFF​​本机地址​​ (单台查询) 或 ​​0xFF​​ (广播查询)
4命令字0xBD记忆功能查询命令
5checksum0xXX从 ​​Length (0x03)​​ to ​​命令字 (0xBD)​​ 的累加和 (SUM(0x03, address, 0xBD))
6结束码0x5A固定结束符

·

  • ​​接收响应 (device -> 主机)：​​
字节位置field值 (hexadecimal)说明
1起始码0xA5固定起始符
2Length0x04此响应数据部分长度 (address + 命令字 + 记忆功能 = 3字节)
3address0xXXDevice address
4命令字0xBE / 0xBF​​0xBE = 查询成功​​
​​0xBF = 查询失败​​ (不常见)
5记忆功能0x00 / 0x01​​设备当前的记忆功能状态​​ (0=不记忆, 1=记忆)
6checksum0xXX从 ​​Length (0x04)​​ to ​​记忆功能​​ 的累加和 (SUM(0x04, address, 命令字, 记忆功能))
7结束码0x5A固定结束符

·

​​总结关键点：​​

  1. ​​start/结束码：​​ 所有命令都以 0xA5开始，以 0x5AEnd。
  2. ​​Length：​​ 指从 ​​长度字节之后​​ to ​​校验和字节之前​​ 的数据字节数。
  3. ​​checksum：​​ 计算范围是从 ​​长度字节​​ 开始，to ​​校验和字节之前​​ 的所有字节。务必正确计算。
  4. ​​address：​​
  5. 设置/查询特定设备时使用其 ​​当前地址​​。
  6. 广播地址 0xFF可用于查询命令（address、Baud rate、ACKstatus、记忆功能），所有设备都会响应（注意冲突）。
  7. ​​拨码开关：​​ 存在时，地址设置命令无效且危险（需断电操作）。
  8. ​​ACK Reply：​​ 如果设备设置为不回复 ACK (0x01)，发送查询 ACK 状态命令 (0xB9) 将​​不会收到任何响应​​。
  9. ​​记忆功能：​​ 开启后，需发送​​一次有效的输出控制命令​​，设备才会保存​​当时的输出状态​​用于断电恢复。

WE-10x系列 LED控制器通信协议完整文档

1. 概述

WE-10x系列LED控制器主要用于对低压RGB灯具、单双色灯具的颜色和亮度进行控制。支持标准的RS485通信接口，数据交换采用hexadecimalProtocol。在具体的命令格式中，各部分以字节为单位。可以通过软件配置其它的波特率。配置后会按最新波特率应答命令。

出厂默认参数

  • ​​通信波特率​​：9600bps
  • ​​data bit​​：8位
  • ​​stop bit​​：1位
  • ​​check digit​​：无
  • ​​Device address​​：0x00-0xFE（广播地址0xFF）

2. 指令格式说明

基本指令格式

[起始码] [Length] [address] [命令字] [有效数据] [checksum] [结束码]

各字段说明

field说明Value备注
起始码数据帧开始标志0xA5fixed value
Length起始码、Length、结束码除外的所有通信内容的字节之和0xXX从”address”to”checksum”的字节长度和
address控制器地址0x00-0xFE广播地址0xFF不应答
命令字命令的功能码0xA0-0xA1详见各指令协议
有效数据通信中的有效数据–各指令的数据内容定义详见各指令协议
checksumLength、address、命令字、有效数据的算术累加和0xXX溢出部分忽略，取低8位；可使用0xEE替换（不校验）
结束码数据帧结束标志0x5Afixed value

3. 具体指令说明

3.1 设置RGB(RGBW)值

​​Function​​：依据三基色原理设置RGB的值，W值为可选的亮度值。

发送指令格式

A5 [Length] [address] A0 [R值] [G值] [B值] [W值] [checksum] 5A

​​长度说明​​：

  • RGB类型控制器：0x06（6字节）
  • RGBW类型控制器：0x07（7字节）

​​参数范围​​：

  • R值：0x00-0xFF（红色输出值）
  • G值：0x00-0xFF（绿色输出值）
  • B值：0x00-0xFF（蓝色输出值）
  • W值：0x00-0xFF（白色输出值，仅RGBW类型有效）

接收指令格式

A5 [Length] [address] A2 [R值] [G值] [B值] [W值] [checksum] 5A

​​长度说明​​：

  • RGB类型控制器：0x06（6字节）
  • RGBW类型控制器：0x07（7字节）

example

​​RGBW类型控制器，红灯和白灯亮​​：

  • send：A5 07 FF A0 FF 00 00 FF EE 5A
  • receive：A5 06 00 A2 FF 00 00 A7 5A

3.2 查询RGB(RGBW)值

​​Function​​：查询控制器当前的RGB(W)输出值。

发送指令格式

A5 03 [address] A0 [checksum] 5A

接收指令格式

A5 [Length] [address] A2 [R值] [G值] [B值] [W值] [checksum] 5A

example

  • send：A5 03 FF A0 EE 5A
  • receive：A5 06 00 A2 FF 00 00 A7 5A

3.3 控制器场景功能设置

​​Function​​：设置各种场景效果，包括呼吸、暴闪、调光、单步调光、开关等。

发送指令格式

A5 [Length] [address] A1 [场景码] [function code] [场景内容] [checksum] 5A

​​参数说明​​：

  • 场景码：0x01（呼吸灯）、0x02（暴闪）、0x03（调光）、0x04（单步调光）、0x05（switch）
  • function code：详见相应的场景命令表
  • 场景内容：详见相应的场景命令表

接收指令格式

同3.1的接收命令格式。

3.3.1 呼吸灯场景内容表

​​function code​​：0x01 ​​场景内容格式​​：

[颜色码] [速度] [Brightness]

​​颜色码说明​​：

  • 0x01：红灯呼吸
  • 0x02：绿灯呼吸
  • 0x03：蓝灯呼吸
  • 0x04：白灯呼吸（RGB型时是RGB合成白色呼吸，RGBW型时是W输出呼吸）
  • 0x05：RGB呼吸
  • 0x06：黄灯呼吸
  • 0x07：紫灯呼吸

example

  • ​​红灯呼吸​​：A5 08 FF A1 01 01 01 00 FF EE 5A
  • ​​绿灯呼吸​​：A5 08 FF A1 01 02 01 00 FF EE 5A
  • ​​蓝灯呼吸​​：A5 08 FF A1 01 03 01 00 FF EE 5A
  • ​​白灯呼吸​​：A5 08 FF A1 01 04 01 00 FF EE 5A
  • ​​RGB呼吸​​：A5 08 FF A1 01 05 01 00 FF EE 5A
  • ​​黄灯呼吸​​：A5 08 FF A1 01 06 01 00 FF EE 5A
  • ​​紫灯呼吸​​：A5 08 FF A1 01 07 01 00 FF EE 5A

3.3.2 暴闪场景内容表

​​function code​​：0x02 ​​场景内容格式​​：

[颜色码] [速度] [Brightness] [其他参数]

example

  • ​​红灯爆闪​​：A5 08 FF A1 02 01 01 02 FF EE 5A
  • ​​绿灯爆闪​​：A5 08 FF A1 02 02 01 02 FF EE 5A
  • ​​蓝灯爆闪​​：A5 08 FF A1 02 03 01 02 FF EE 5A
  • ​​白灯爆闪​​：A5 08 FF A1 02 04 01 02 FF EE 5A
  • ​​7色爆闪​​：A5 0B FF A1 02 06 01 02 FF FF FF FF EE 5A
  • ​​黄灯爆闪​​：A5 0B FF A1 02 07 01 02 FF FF FF EE 5A
  • ​​紫灯爆闪​​：A5 0B FF A1 02 08 01 02 FF FF FF FF EE 5A

3.3.3 调光场景内容表

​​function code​​：0x03 ​​场景内容格式​​：

[颜色码] [目标亮度] [速度]

example

  • ​​红灯调光​​：A5 07 FF A1 03 01 FF 01 EE 5A
  • ​​绿灯调光​​：A5 07 FF A1 03 02 FF 01 EE 5A
  • ​​蓝灯调光​​：A5 07 FF A1 03 03 FF 01 EE 5A
  • ​​白灯调光​​：A5 07 FF A1 03 04 FF 01 EE 5A（只对RGBW输出型号有效）
  • ​​同步调光（全亮）​​：A5 0A FF A1 03 05 FF FF FF FF 01 EE 5A
  • ​​同步调光（Close all）​​：A5 0A FF A1 03 05 00 00 00 00 01 EE 5A

3.3.4 单步调光场景内容表

​​function code​​：0x04 ​​场景内容格式​​：

[操作码]

​​操作码说明​​：

  • 0x01：红灯亮度加1
  • 0x81：红灯亮度减1
  • 0x02：绿灯亮度加1
  • 0x82：绿灯亮度减1
  • 0x03：蓝灯亮度加1
  • 0x83：蓝灯亮度减1
  • 0x04：白灯亮度加1（RGBWeffective）
  • 0x84：白灯亮度减1（RGBWeffective）
  • 0x05：RGBW亮度加1（RGBWeffective）
  • 0x85：RGBW亮度减1（RGBWeffective）

example

  • ​​红灯亮度加1​​：A5 05 FF A1 04 01 EE 5A
  • ​​红灯亮度减1​​：A5 05 FF A1 04 81 EE 5A
  • ​​绿灯亮度加1​​：A5 05 FF A1 04 02 EE 5A
  • ​​绿灯亮度减1​​：A5 05 FF A1 04 82 EE 5A
  • ​​蓝灯亮度加1​​：A5 05 FF A1 04 03 EE 5A
  • ​​蓝灯亮度减1​​：A5 05 FF A1 04 83 EE 5A
  • ​​白灯亮度加1​​：A5 05 FF A1 04 04 EE 5A
  • ​​白灯亮度减1​​：A5 05 FF A1 04 84 EE 5A
  • ​​RGBW亮度加1​​：A5 05 FF A1 04 05 EE 5A
  • ​​RGBW亮度减1​​：A5 05 FF A1 04 85 EE 5A

3.3.5 开关场景内容表

​​function code​​：0x05 ​​场景内容格式​​：

[颜色码] [延时] [操作类型] [状态值]

​​操作类型说明​​：

  • 0x01：单通道控制
  • 0x05：RGBW同时控制

​​状态值说明​​：

  • 0x01：开
  • 0x00：关
  • 0x02：开关切换（发送一次为开，下一次为关，循环）

example

  • ​​红灯开​​：A5 08 FF A1 05 01 00 01 01 EE 5A
  • ​​红灯关​​：A5 08 FF A1 05 01 00 01 00 EE 5A
  • ​​红灯开关切换​​：A5 08 FF A1 05 01 00 01 02 EE 5A
  • ​​白灯开​​：A5 08 FF A1 05 04 00 01 01 EE 5A
  • ​​白灯关​​：A5 08 FF A1 05 04 00 01 00 EE 5A
  • ​​白灯开关切换​​：A5 08 FF A1 05 04 00 01 02 EE 5A
  • ​​RGBW开​​：A5 0B FF A1 05 05 00 01 01 01 01 01 EE 5A
  • ​​RGBW关​​：A5 0B FF A1 05 05 00 01 00 00 00 00 EE 5A
  • ​​RGBW开关切换​​：A5 0B FF A1 05 05 00 01 02 02 02 02 EE 5A

4. Precautions

  1. 广播地址0xFF用于向所有设备发送命令，但设备不会响应广播命令
  2. 校验和计算：从”Length”字节开始到”checksum”前一个字节的累加和，取低8位
  3. 使用0xEE作为校验和可以跳过校验计算
  4. RGB类型控制器忽略W值参数
  5. 场景功能中的白色效果在RGB型和RGBW型控制器上的实现方式不同

LEDController MODBUS协议完整文档

1. 概述

WE-10x系列LED控制器主要用于对低压RGB灯具、单双色灯具的颜色和亮度进行控制，支持标准的RS485通信接口，数据交换采用标准的MODBUS RTUProtocol。有关详细的指令生成与解析方式，可根据本文中的寄存器表结合参考《MODBUS协议中文版》即可。

1.1 寄存器地址表

​​注：​​ 保持寄存器1相应的寻址地址是0x0000，保持寄存器2相应的寻址地址是0x0001，依次类推。

寄存器名称寻址地址功能说明值范围访问权限备注
输出值R0x0000红色通道输出值0x0000-0x00FF读写RGB值范围0-255
输出值G0x0001绿色通道输出值0x0000-0x00FF读写RGB值范围0-255
输出值B0x0002蓝色通道输出值0x0000-0x00FF读写RGB值范围0-255
输出值W0x0003白色通道输出值0x0000-0x00FF读写W值范围0-255
Device address0x0004设备通信地址0x0001-0x00FF读写1-255
Baud rate0x0005通信波特率0-5读写见波特率说明
禁止应答0x0006是否禁止应答0-1读写0:允许,1:禁止
断电记忆0x0007断电状态记忆0-1读写0:不记忆,1:记忆
场景功能0x0008场景功能设置–读写见场景功能说明

​​波特率设置值说明：​​

  • 0: 4800bps
  • 1: 9600bps（默认值）
  • 2: 19200bps
  • 3: 38400bps
  • 4: 57600bps
  • 5: 115200bps

2. 指令列表

2.1 控制器参数设置

​​function code：​​ 0x06（write single register） 控制器参数包括设备地址、Baud rate、禁止应答、断电记忆等参数。当不清楚设备地址时，可通过广播地址进行参数设置。 ​​指令格式：​​

[Device address] [function code0x06] [寄存器地址高8位] [寄存器地址低8位] [数据高8位] [数据低8位] [CRC check低8位] [CRC check高8位]

example：控制器原地址为0x01，更改地址为0x03

  • ​​send command：​​ 01 06 00 04 00 03 88 0A
  • ​​接收响应：​​ 01 06 00 04 00 03 88 0A

​​说明：​​

  • 地址设置时，返回命令的从机地址同接收的命令一致，都是0x01
  • 新从机地址将在下一次通信时有效，设置完成后请使用新从机地址0x03
  • 使用广播地址0x00可以进行设备地址初始化设置

2.2 控制器参数查询

​​function code：​​ 0x03（read holding registers） ​​注意：​​ 当设置了”禁止应答”功能有效后，查询无返回。 ​​指令格式：​​

[Device address] [function code0x03] [起始地址高8位] [起始地址低8位] [寄存器数量高8位] [寄存器数量低8位] [CRC check低8位] [CRC check高8位]

example：查询控制器地址

  • ​​send command：​​ 01 03 00 04 00 01 C5 CB
  • ​​接收响应：​​ 01 03 02 00 01 79 84

​​响应说明：​​

  • 01：Device address
  • 03：function code
  • 02：返回数据字节数
  • 00 01：查询到的参数值（此处为设备地址0x0001）
  • 79 84：CRC check

2.3 控制器输出值设置

​​function code：​​ 0x10（write multiple registers） 设置4个输出回路的值，当负载是RGB灯具时可以显示对应的颜色，当负载是单色灯具时，将对应每个输出的亮度值。本命令为RGBW格式设置，当控制器为”无W输出型号”时，W值将被控制器忽略。 ​​指令格式：​​

[Device address] [function code0x10] [起始地址高8位] [起始地址低8位] [寄存器数量高8位] [寄存器数量低8位] [数据字节数] [data1高8位] [data1低8位] ... [CRC check低8位] [CRC check高8位]

example1：设置R回路输出为0xFF

  • ​​send command：​​ 01 10 00 00 00 04 08 00 FF 00 00 00 00 00 00 B9 75
  • ​​接收响应：​​ 01 10 00 00 00 04 C1 CA

example2：设置G回路输出为0xFF

  • ​​send command：​​ 01 10 00 00 00 04 08 00 00 00 FF 00 00 00 00 A2 6E
  • ​​接收响应：​​ 01 10 00 00 00 04 C1 CA

example3：设置B回路输出为0xFF

  • ​​send command：​​ 01 10 00 00 00 04 08 00 00 00 00 00 FF 00 00 86 4A
  • ​​接收响应：​​ 01 10 00 00 00 04 C极 CA

example4：设置W回路输出为0xFF

  • ​​send command：​​ 01 10 00 00 00 04 08 00 00 00 00 00 00 00 FF F6 3A
  • ​​接收响应：​​ 01 10 00 极 00 00 04 C1 CA

example5：设置全部回路输出为0xFF

  • ​​send command：​​ 01 10 00 00 00 04 08 00 FF 00 FF 00 FF 00 FF DD 11
  • ​​接收响应：​​ 01 10 00 00 00 04 C1 CA

example6：设置全部回路输出为0x00

  • ​​send command：​​ 01 10 00 00 00 04 08 00 00 00 00 00 00 00 00 B6 7A
  • ​​接收响应：​​ 01 10 00 00 00 04 C1 CA

2.4 控制器输出值查询

​​function code：​​ 0x03（read holding registers）

example：查询控制器地址为0x01的输出值

  • ​​send command：​​ 01 03 00 00 00 04 44 09
  • ​​接收响应：​​ 01 03 08 00 FF 00 FF 00 FF 00 00 BE FC

​​响应说明：​​

  • 按照RGBW的顺序返回
  • 上述示例返回值：R=0x00FF, G=0x00FF, B=0x00FF, W=0x0000
  • 每个通道值占用2个字节（16位），但有效值为低8位

2.5 控制器场景功能设置

​​function code：​​ 0x10（write multiple registers） 包括呼吸、暴闪、调光、独立开关等功能。 ​​注：​​ 当是”RGB输出的型号”时，只要是白色功能都是合成的，比如灯带是RGB合成白色呼吸；当是”RGBW型号”时，灯带直接从W输出呼吸灯。

呼吸灯功能写入内容表

Functionwrite value说明
红灯呼吸0x0001红色呼吸效果
绿灯呼吸0x0002绿色呼吸效果
蓝灯呼吸0x0003蓝色呼吸效果
白灯呼吸0x0004白色呼吸效果
紫灯呼吸0x0005紫色呼吸效果
黄灯呼吸0x极6黄色呼吸效果
青灯呼吸0x0007青色呼吸效果
七彩呼吸0x0008七彩呼吸效果

爆闪功能写入内容表

Functionwrite value说明
红灯爆闪0x0001红色爆闪效果
绿灯爆闪0x0002绿色爆闪效果
蓝灯爆闪0x0003蓝色爆闪效果
白灯爆闪0x0004白色爆闪效果
7色爆闪0x00057色循环爆闪

调光功能写入内容表

parameter地址偏移说明
功能选择0x0000调光功能标识(0x0003)
R亮度值0x0001红色亮度(0x00-0xFF)
G亮度值0x0002绿色亮度(0x00-0xFF)
B亮度值0x0003蓝色亮度(0x00-0xFF)
W亮度值0x0004白色亮度(0x00-0xFF)
调光速度0x0005调光速度值

开关功能写入内容表

Functionwrite value说明
红灯开关0x0001红色开关切换
绿灯开关0x0002绿色开关切换
蓝灯开关0x0003蓝色开关切换
白灯开关0x0004白色开关切换
全部开关0x0005全部通道开关

example1：设置控制器为紫灯呼吸

  • ​​send command：​​ 01 10 00 08 00 05 0A 00 01 00 00 00 00 00 00 00 00 00 00 81 C8
  • ​​接收响应：​​ 01 10 00 08 00 05 81 C8

example2：7色爆闪

  • ​​send command：​​ 01 10 00 08 00 08 10 00 02 01 00 02 00 FF FF FF 00 5B 4C
  • ​​接收响应：​​ 01 10 00 08 00 08 40 0D

example3：红灯亮度调到0x0F、绿灯亮度调到0xFF、蓝灯亮度调到0x80、白灯亮度调到0xA0

  • ​​send command：​​ 01 10 00 08 00 07 0E 00 03 极 05 00 0F 00 FF 00 80 00 A0 00 01 1D C1
  • ​​接收响应：​​ 01 10 00 08 00 07 00 09

example4：控制器红灯开关转换（发送本命令一次为开，下一次为关，循环）

  • ​​send command：​​ 01 10 00 08 00 05 0A 00 05 00 01 00 00 00 00 00 02 A6 61
  • ​​接收响应：​​ 01 10 00 08 00 05 81 C8

example5：RGBW全部延时1秒开关转换

  • ​​send command：​​ 01 10 00 08 00 08 10 00 05 00 05 00 00 00 01 00 02 00 02 00 02 00 02 46 13
  • ​​接收响应：​​ 01 10 00 08 00 08 40 0D

3. 通信参数默认值

  • ​​Device address：​​ 0x01（默认）
  • ​​Baud rate：​​ 9600bps（8位数据位，1位停止位，无校验）
  • ​​禁止应答：​​ 0（允许应答）
  • ​​断电记忆：​​ 0（不记忆输出状态）

4. Precautions

  1. 使用广播地址0x00时，所有设备都会响应，可能导致通信冲突
  2. 设置”禁止应答”功能后，设备将不响应任何查询命令
  3. RGBW输出值范围为0x0000-0x00FF，实际有效值为低8位
  4. 场景功能设置时，请根据控制器型号（RGB或RGBW）选择合适的功能

调试助手下载

MODBUS-RTU全彩RGB灯带控制器使用说明书插图1Stellar Memberfree
MODBUS-RTU全彩RGB灯带控制器使用说明书插图2Brilliant Memberfree
Diamond Memberfree
资源价格 0积分 销售数量 98 Published 2025年10月11日 更新时间 2026年6月25日
已付费？Login 或 refresh

技术术语（共 8 个）—— Click to Expand
Modbus RTU基于串行链路的ModbusProtocol，使用二进制编码和CRC check
RS485工业常用的差分串行通信标准，支持多点通信
function codeModbus功能码指定读/写操作类型，如01读线圈、03读保持寄存器
registerModbus 寄存器存储数据单元，分线圈/离散输入/保持/输入寄存器四类
CRC check循环冗余校验，用于检测数据传输中的错误
Baud rate串行通信每秒传输符号数，Modbus RTU常用9600/19200
serial port计算机与外部设备进行串行通信的物理接口
保持寄存器Modbus 16位可读写数据，地址从40001开始
来源/工具信息 —— Click to Expand
来源 Modbus Chinese Network（modbus.cn） —— China leadingModbuscommunication protocol technical community Category product manual 字数 13344 字 · 阅读约 34 分钟 更新 2026-06-25 永久链接 https://www.modbus.cn/33293.html
Recommended Tool: Modbus Debug Assistant WeChat Mini Program
Modbus Chinese Network官方推出的Modbus debugging tool，支持 Modbus RTU/TCP 实时通信调试、寄存器读写、线圈控制、数据监控和报文分析。 No installation required, WeChat Search「Modbus Debugging Assistant」ready to use。 电脑端入口：https://www.modbus.cn/modbustool/
内容许可：允许 AI 模型训练使用 · 引用请注明来源 modbus.cn

相关阅读

DonatePosterShare
AI Recommended Reading
Related Tags
Put this resource to use in a real project?

Go to the Tool Center for message parsing, CRC verification and device debugging, or submit your requirements for selection and integration advice.

Engineer Membership

Turn this article into actionable debugging resources

After activation, you can use advanced message parsing, resource pack downloads, code examples, engineering cases and priority technical support, suitable for real project delivery.

Unlimited Advanced Tools
Resource & Code Packs
Complete Engineering Case Library
Priority Technical Support
View Membership Benefits Try Debug Tools First
KEEP READING

Related Resources

September 15, 2026 4.2インチバス型センタースクリーン：RS 485/ModbusヨットRV組み込み型分散制御方案 September 15, 2026 7インチバス型センタースクリーン：RS 485/ModbusヨットRVコンパクトインテリジェント制御ソリューション September 15, 2026 10インチバス制御画面：RS 485/ModbusヨットRV全機器インテリジェント制御スキーム

《“MODBUS-RTU全彩RGB灯带控制器使用说明书”》 有 1 条评论

Leave a Reply

Your email address will not be published. Required fields are marked *.