深圳励研科技led控制卡cl3000通讯协议

CL3000系列异步控制系统通讯协议 v1.0目录=第一章概述2§1.1通讯数据包格式2§1.2CRC校验和算法3第二章控制类命令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”，分别表示命令执行成功或失败的响应。如果有响应数据则紧跟在后面。§1.2CRC校验和算法下面用C语言描述CRC校验算法：WORD CRC_Table256 =0x0000,0x1021,0x2042,0x3063,0x4084,0x50a5,0x60c6,0x70e7,0x8108,0x9129,0xa14a,0xb16b,0xc18c,0xd1ad,0xe1ce,0xf1ef,0x1231,0x0210,0x3273,0x2252,0x52b5,0x4294,0x72f7,0x62d6,0x9339,0x8318,0xb37b,0xa35a,0xd3bd,0xc39c,0xf3ff,0xe3de,0x2462,0x3443,0x0420,0x1401,0x64e6,0x74c7,0x44a4,0x5485,0xa56a,0xb54b,0x8528,0x9509,0xe5ee,0xf5cf,0xc5ac,0xd58d,0x3653,0x2672,0x1611,0x0630,0x76d7,0x66f6,0x5695,0x46b4,0xb75b,0xa77a,0x9719,0x8738,0xf7df,0xe7fe,0xd79d,0xc7bc,0x48c4,0x58e5,0x6886,0x78a7,0x0840,0x1861,0x2802,0x3823,0xc9cc,0xd9ed,0xe98e,0xf9af,0x8948,0x9969,0xa90a,0xb92b,0x5af5,0x4ad4,0x7ab7,0x6a96,0x1a71,0x0a50,0x3a33,0x2a12,0xdbfd,0xcbdc,0xfbbf,0xeb9e,0x9b79,0x8b58,0xbb3b,0xab1a,0x6ca6,0x7c87,0x4ce4,0x5cc5,0x2c22,0x3c03,0x0c60,0x1c41,0xedae,0xfd8f,0xcdec,0xddcd,0xad2a,0xbd0b,0x8d68,0x9d49,0x7e97,0x6eb6,0x5ed5,0x4ef4,0x3e13,0x2e32,0x1e51,0x0e70,0xff9f,0xefbe,0xdfdd,0xcffc,0xbf1b,0xaf3a,0x9f59,0x8f78,0x9188,0x81a9,0xb1ca,0xa1eb,0xd10c,0xc12d,0xf14e,0xe16f,0x1080,0x00a1,0x30c2,0x20e3,0x5004,0x4025,0x7046,0x6067,0x83b9,0x9398,0xa3fb,0xb3da,0xc33d,0xd31c,0xe37f,0xf35e,0x02b1,0x1290,0x22f3,0x32d2,0x4235,0x5214,0x6277,0x7256,0xb5ea,0xa5cb,0x95a8,0x8589,0xf56e,0xe54f,0xd52c,0xc50d,0x34e2,0x24c3,0x14a0,0x0481,0x7466,0x6447,0x5424,0x4405,0xa7db,0xb7fa,0x8799,0x97b8,0xe75f,0xf77e,0xc71d,0xd73c,0x26d3,0x36f2,0x0691,0x16b0,0x6657,0x7676,0x4615,0x5634,0xd94c,0xc96d,0xf90e,0xe92f,0x99c8,0x89e9,0xb98a,0xa9ab,0x5844,0x4865,0x7806,0x6827,0x18c0,0x08e1,0x3882,0x28a3,0xcb7d,0xdb5c,0xeb3f,0xfb1e,0x8bf9,0x9bd8,0xabbb,0xbb9a,0x4a75,0x5a54,0x6a37,0x7a16,0x0af1,0x1ad0,0x2ab3,0x3a92,0xfd2e,0xed0f,0xdd6c,0xcd4d,0xbdaa,0xad8b,0x9de8,0x8dc9,0x7c26,0x6c07,0x5c64,0x4c45,0x3ca2,0x2c83,0x1ce0,0x0cc1,0xef1f,0xff3e,0xcf5d,0xdf7c,0xaf9b,0xbfba,0x8fd9,0x9ff8,0x6e17,0x7e36,0x4e55,0x5e74,0x2e93,0x3eb2,0x0ed1,0x1ef0;计算CRC校验的子函数:void CRC(WORD *CRCValue,BYTE ch);WORDNewCRC = *CRCValue;BYTECV;CV=(NewCRC>>8)ch)&0xff;NewCRC=(NewCRC<<8)CRC_TableCV;*CRCValue = NewCRC;假设待校验的数据为n字节，存放在字节数组ByteAry中，则完整的CRC校验算法如下：WORDCRCResult = 0;for (int I=0;I<n;+I) CRC(&CRCResult,ByteAryI);第二章 控制类命令控制类命令包括复位控制卡、取运行状态、设定亮度、设定开关屏时间等。§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发送时间段亮度表命令格式：'B'+1字节1+1字节数据长度+1字节0+2字节时段1 + 每个时间段两个字节，格式为bit15保留填0，bit14.10小时，bit9.4分钟，bit3.0亮度。值为0表示无效时段，则后面的时段设置忽略。最多6个亮度时间段，即数据长度最大12个字节。§2.10 切换当前播放的节目组命令格式：'X'+1字节标识+2字节节目组编号+16字节节目组播放参数标识：bit7=1保存当前选择的节目组（需要有电池）；bit6=1设置新的节目组播放参数；其它bit保留填0节目组编号：0-999，与节目表项Flag字段中的所属节目组号对应节目组播放参数：用于给节目组中的特殊节目传递参数，当标识字节中的bit6=1时才会起作用。每个分区4个字节，从第一个分区开始依次排列。第三章 节目表控制播放类命令节目表控制播放类命令涉及两个方面，一是播放的内容，即图片文件，另一是节目表，控制卡根据节目表设定的效果来播放图片。§3.1图片文件结构CL3000所使用的图片文件为自定义格式，其基本结构为： 文件头 + 图片点阵数据文件头为12字节，其格式见CL3000程序员手册中的PicFileHdr结构定义。图片点阵数据格式定义如下：像素点按