深圳励研科技ELD控制卡CL3000通讯协议0000.docVIP

深圳励研科技 CL3000系列异步控制系统 通讯协议 v1.0 目录 ====== 第一章 概述 2 §1.1 通讯数据包格式 2 第二章 控制类命令 4 §2.1 复位控制卡 4 §2.2 取运行状态 4 §2.3 校对控制卡时间 4 §2.4 读取控制卡时间 5 §2.5 设定自动开关屏时间 5 §2.6 暂停/继续节目播放 5 §2.7 设定屏体电源/开关模式 5 §2.8 设定亮度 5 §2.9 发送时间段亮度表 5 §2.10 切换当前播放的节目组 6 第三章 节目表控制播放类命令 6 §3.1 图片文件结构 6 §3.2 发送图片文件 7 §3.3 节目表结构 7 §3.4 发送节目表 8 第四章 实时显示类命令 9 §4.1 实时显示文字 9 §4.2 保存文字串为XMPX图片文件 10 §4.3 实时显示XMPX图片 10  概述 本文中，DWORD为4字节数据，WORD为双字节数据，BYTE为单字节数据。存储格式为小序，即4字节数据(32个bit)存储为：d7-d0，d15-d8,d23-d16,d31-d24；双字节数据(16个bit)存储为：d7-d0,d15-d8。 用于节目播放的图片、文字和字库存储在控制卡上的FLASH芯片中，控制卡标准配置为1片2MB的FLASH芯片，可根据用户要求增加一片2MB芯片或者改为2片4MB的芯片。FLASH芯片中每4096字节为1页，内容必须以页为单位占用存储，例如一张5000字节的图片要用2个FLASH页存储，即需要8192字节的存储空间。 CL3000系列控制卡支持串口和以太网通讯，网络通讯支持UDP/IP协议，不支持端口复用，即控制卡可以接收任意端口的数据，但是同一时刻只能接收一个主机的数据。网络通讯的通讯包格式与串口通讯相同。 §1.1 通讯数据包格式 CL3000的通讯数据包格式为： 7字节引导串+1字节屏号+1字节保留域+1字节包序号+4字节访问密钥+2字节数据长度+报文数据+2字节CRC 其中， 引导串：ESC+“$LYMIN”(ESC的ASCII码值为0x1b)。 屏 号：控制卡地址。出厂设置为0。 保留域：备用，填0。 包序号：从0开始编号，控制卡对该报文的响应报文将使用相同的编号，这样发送者可以判断响应报文所对应的发送报文。 密 钥：网络通讯用，串口通讯不使用填0xFFFFFFFF。 长 度：后面报文数据的长度。 数 据：发往控制卡的命令及数据。各命令的数据格式在后面章节中详细说明。 CRC ：对报文数据部分进行16位CRC校验的结果，校验算法见1.2节。 响应报文采用与发送报文相同的格式，只是引导串为 ESC+“$lymin”, 访问密钥字节则保留。 响应报文数据域开头3个字节固定为：命令+“OK”或“FL”，分别表示命令执行成功或失败的响应。如果有响应数据则紧跟在后面。 控制类命令 控制类命令包括复位控制卡、取运行状态、设定亮度、设定开关屏时间等。 §2.1 复位控制卡 命令格式：V+1字节复位类型+2字节参数 复位类型：0:重启播放流程 1:控制卡复位 2:释放网络，允许其它网络主机访问 参数保留，填0 §2.2 取运行状态 命令格式：A+1字节0+2字节数据长度+4字节0 数据长度为运行状态数据结构RunningStateStru的长度，该结构在MiniLED.h中定义。 返回报文中的数据域为运行状态数据结构。 §2.3 校对控制卡时间 命令格式：C+1字节秒+1字节分+1字节时+1字节日+1字节月+1字节周+1字节年+1字节0 周0-6依次表示星期日，星期一到星期六。 年0-99表示2000年到2099年。 §2.4 读取控制卡时间 命令格式：E 返回报文中的数据域格式为1字节秒+1字节分+1字节时+1字节日+1字节月+1字节周+1字节年+1字节0。 §2.5 设定自动开关屏时间 命令格式：B+1字节0+1字节数据长度4+1字节0+1字节自动开屏分+1字节自动开屏时+1字节自动关屏分+1字节自动关屏时 注意：时间大于所设置的关屏时间才关屏。 §2.6 暂停/继续节目播放 命令格式：K+1字节控制标志+2字节参数 控制标志：0暂停播放 1恢复继续播放 参数保留，填0 §2.7 设定屏体电源/开关模式 命令格式：P+1字节模式 模式：0:强行关屏 1:强行开屏 2:自动开关屏 §2.8 设定亮度 命令格式：Y+ 1字节设定亮度值 亮度值：0-15依次表示亮度等级1/16, 2/16, ... 16/16(全亮)。16表示使用亮度传感器自动调整，17表示使用时段亮度表的设定。其它值返回错误 §2.9 发送时间段亮度表