后台软件功能开发需求手册一．引言1.1编写目的用于后台软件开发功能描述，通过该手册后台软件开发人员可以快速了解用户需求。
1.2设备定义1.3专业名词解释●什么是UID：LED终端唯一的地址信息。
共6个字节。
可以理解为类似MAC地址。
●后台软件发给集控器对于LED终端的的命令操作时。
集控器对后台软件响应有两种可能，一种是操作成功另一种是操作失败●渐变调光：是指LED灯具从亮到暗或者从暗到亮是一个缓慢逐渐变化的过程。
●瞬间调光：是指LED灯具从亮到暗或者从暗到亮是一贯快速改变的过程。
●组：LED终端可以分成0~0x0f共16个组，其中第0组是默认组。
不可编辑和删除。
0x01~0x0f组需要先创建再进行操作。
组信息存放在LED终端中。
●组播：对LED终端的0x01~0x0f组进行调光操作。
●广播：对LED终端0x00组进行调光操作。
是一种特殊的组播。
●防盗终端：启动电缆防盗功能时我们有两种防盗终端。
一种是电力线载波防盗终端主要负责白天防盗。
另一种是LED终端当着防盗终端使用，主要在晚上负责防盗。
●网络ID:请解释●网络频点：请解释●分包：当数据字段大于200字节时，集控器要进行分包发数据。
后台软件再将接受的分包数据组成完整数据。
●定时检测：集控器按照所设定的时间向LED终端下发“获取LED终端电参数命令”。
并将获取的信息上传至后台软件。
●二进制表示格式：例如十进制数80的二进制表示为 0b01010000说明有些数据字段可能是不定长。
所以数据包的数据长度字段要根据实际情况计算。
二．后台软件和集控器通信协议格式备注：B表示字节单位，CRC校验程序参考附件。
由于CRC校验程序有不同的版本，所以在后台软件请采用我们附件提供的程序这样确保集控器能识别55表示的是十六进制的0x55aa表示的是十六进制的0xaa所有的通信协议如果未特殊说明都是十六进制数设备类型列表：0x01表示集控器0x02 表示LED终端0x03表示后台软件数据长度计算:除数据包中包头以外的所有数据的个数。
有些数据字段可能是不定长。
所以数据包的数据长度字段要根据实际情况计算。
数据字段：最大不超过200字节。
如果需要传输大包数据，则分包发送。
数据传输顺序：高位在前低位在后，例如传输十六进制数0x12345678的顺序依次是 0x12 0x34 0x56 0x78三．通信协议定义3.1重点说明：3.1.1本通信协议大部分后台软件下发的数据字段内容和集控器应答的数据字段相同。
3.1.2除非单个查询LED灯具的当前亮度状态。
否则集控器当前调光状态就是LED灯具的当前亮度状态。
3.1.3设备定位可以（1）通过在地图上拖曳放置，（2）也可以通过直接在设备图标上输入经纬度信息。
（3）读取设备内的经纬度信息这三种方式定位3.2配置集控器3.2.1配置集控器时间备注：数据字段依次表示年、月、日、星期、小时、分钟、秒。
十六进制表示。
年2个字节高位在左边低位在右边月1个字节日1个字节星期1个字节小时1个字节分钟1个字节秒1个字节例如：2013年3月23日星期六下午4点50分55秒数据字段的表达。
0x07 0xdd 0x03 0x17 0x06 0x10 0x32 0x37集控器 后台软件响应格式：3.2.2配置集控器的调光时间采用24小时制，用16进制表示。
亮度值范围0，0X19~0XFF最多能配置5个时间段调光例如：18.40分亮度0xff21.20分亮度0x800.00分亮度0x306.00分亮度0x00 数据字段的表达0x12 0x28 0xff 0x15 0x14 0x80 0x00 0x00 0x30 0x06 0x00 0x003.2.3配置集控器定时检测时间例如：设定控制器每天的检测时间是23.50分的数据字段表达. 0x17 0x323.2.4使能/禁止定时检测3.2.5配置集控器的经纬度和时区数据字段长度40个字节。
数据字段用ACSII表示经度19个字节、不够后面补十六进制0x00来凑足19个字节纬度19个字节、不够后面补十六进制0x00来凑足19个字节时区2个字节例如：要表示经度正110.12345 。
维度负65.123456。
时区正3 +110.12345 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00-65.123456 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00+33.2.6使能/禁止经纬度开关3.2.7 使能/禁止防盗功能备注：0x00表示使能 0x01表示禁止3.2.8使能/禁止短信报警功能3.2.9配置短信报警目标号码（最多5个）每个号码20个字节号码有效位用ACSII表示无效为用0x00填充例如：我要配置3个手机号码的数据字段格式如下0X03 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X000X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 0X00 无需考虑国家区号代码，集控器程序中有设定3.3配置终端3.3.1配置终端分组信息备注：UID表示LED终端地址信息。
数据字段中低2个字节表示分组信息，每一位代表一个分组信息。
1表示分组有效0表示分组无效、删除组。
第0组不能配置，是默认组。
最大支持16组例如 0b1000 1000 1111 0000表示的意思是LED终端被分配到第15,11,7,6,5,4,0组。
其中第0组是默认组。
不会被编辑或者删除。
集控器→后台软件响应格式0x01表示集控器操作LED终端失败、通信异常。
如果出现通信异常情况后台软件则提示“请逐个配置，检查该终端地址是否存在”3.3.2配置LED终端为防盗终端多少个防盗终端。
最大0x0f例如.我要配置某3个地址的LED终端为防盗终端0x03 0x123456789010 0x123456789012 0x123456789013 集控器→后台软件响应格式配置电力线防盗终端集控器→后台软件响应格式3.4调光操作3.4.1组播渐变调光数据字段高字节表示组播地址0x00表示广播地址0x01~0x0f表示十五个组地址数据字段低字节表示亮度数据，软件上要屏蔽0x01~0x18。
因为这些亮度对于LED终端自动认为是0亮度例如：组播0x07组亮度0x80数据字段表示0x07 0x80广播所有组亮度0xff数据字段表示0x00 0x0f集控器→后台软件响应格式息反馈到后台软件。
这样做的原因是因为组播调光时集控器和LED终端是单向通信，也就是说集控器是不知道LED终端执行情况。
响应数据字段中的数据分别表示最高字节: 表示回路电压是否正常。
例如0b0000 0110 表示有两路异常中间字节：表示组信息，例如 0x04表示对“0x04组”调光最后字节：表示亮度信息3.4.2组播瞬间调光数据字段高字节表示组播地址0x00表示广播地址0x01~0x0f表示十五个组地址数据字段低字节表示亮度数据，软件上要屏蔽0x01~0x18。
因为这些亮度对于LED终端自动认为是0亮度集控器→后台软件响应格式3.4.3单灯渐变调光集控器→后台软件响应格式3.4.4单灯瞬间调光3.4.5集控器执行自动调光后、上报后台软件3.5获取LED终端信息3.5.1获取LED终端电参数状态集控器→后台软件响应格式LED终端UID:电流：2个字节十六进制电压：2个字节十六进制功率：2个字节十六进制功率因数：1个字节十六进制灯具调光：1个字节十六进制例如：UID号0x123456789012 的电压=220V、电流=1011毫安、功率=224W、功率因数=0.98、灯具调光=0xf8UID:0x12 0x34 0x56 0x78 0x90 0x12电流：0x00 0xdc电压：0x03 0xf3功率：0x00 0xe0功率因数：0x62灯具调光：0xf8当电流、电压、功率、功率因数、灯具调光这8个字节全为0时表示这个UID 终端通信异常功率因数字段为0表示LED终端没有采集”功率因数”功能。
而不是功率因数值=03.5.2获取LED终端配置参数集控器→后台软件响应格式分组信息:2个字节有效时段数：1字节十六进制调光时段：15个字节，从高到低表示小时分钟亮度，总共5段。
无效段填0x00.备注信息：20个字节,ACSII码表示，不够用0x00填充设备类型：1个字节经纬度：38个字节当UID后面的77个字节全为0表示该终端不存在或者通信异常3.5.3自动搜索LED终端集控器→后台软件响应格式备注：数据段格式：分包信息+终端数量+终端UID列表分包信息：1字节，0x01分包未完成 0x00分包完成。
终端数量：1个字节十六进制表示终端UID：每个UID 6个字节数据字段不超过200字节。
需要传输大量数据则分包发送。
3.5.4手动添加LED终端集控器→后台软件响应格式3.6读取集控器参数3.6.1读取集控器参数1集控器→后台软件响应格式系统时间：xx xx xx xx xx xx xx xx，共8字节，十六进制表示依次年、月、日、星期、小时、分钟、秒调光时段数：1字节0x01~0x05调光时段：小时、分钟、亮度。
分别用依次用十六进制表示，最多5段，也就是说最多15个字节网络ID：2字节网络频点：1字节电池状态：1字节。
0x00表示电池有电0x01电量低。
指的是集中控制器内部时钟电池。
经纬度开关灯使能状态：1字节0x00表示使能0x01表示禁止经纬度和时区：40个字节。
格式定义参照“3.2.5命令”3.6.2读取集控器参数2集控器→后台软件响应格式定时检测使能状态： 1字节 0x00表示使能 0x01禁止定时检测时间：2字节小时、分钟分别依次用十六进制表示防盗使能状态：1字节 0x00表示使能 0x01禁止无线防盗终端数量： 1字节最大0x0f电力线防盗终端数量：1字节,最大0x0f无线防盗终端UID地址：电力线防盗终端UID地址:3.6.3读取集控器参数3集控器→后台软件响应格式短信报警功能使能状态：1字节 0x00表示使能 0x01禁止短信报警号码个数：1个字节范围0x00~0x05短信手机号码：格式详见“3.2.9”命令3.6.4读取集控器参数4集控器→后台软件响应格式分包信息：0x01分包未完成 0x00分包完成。
LED终端数量：1个字节十六进制表示LED终端UID：每个UID 6个字节数据字段不超过200字节。
需要传输大量数据则分包发送。
3.6.5读取集控器所有LED终端历史电参数集控器→后台软件响应格式3.6.6读取所有LED终端实时电参数集控器→后台软件响应格式3.7交流柜操作3.7.1交流接触器操作集控器→后台软件响应格式0表示正常 1异常例如：如果收到数据是0b0000 0110表示3相回路电压两相正常一相异常。