路灯智能照明管理系统软件需求

1、后台软件功能开发需求手册文件修改记录版本号修改时间作者V1.0一引言1.1编写目的用于后台软件开发功能描述，通过该手册后台软件开发人员可以快速了解用户需求。1.2设备定义序号术语术语解释备注1后台软件Smart智慧路灯控制系统，部署在服务器上的应用程序，客户可以通过登录指定的网页对各个嵌入式设备进行远程控制操作。后台软件可通过GOOGLE地图对所有的设备进行定位。设备类型0x032集控器嵌入式控制设备。于系统进行交互执行系统发送的控制指令，并负责下发给命令给各个节点设备类型0x013LED路灯终端嵌入式设备，安装在LED路灯内部，路灯节点可以对LED进行调光，电压电流采集。调光等级为0，252

2、55。节点本身屏蔽掉124这些调光等级设备类型0x024视频设备嵌入式设备，包括摄像头和监控芯片两部分，摄像头捕捉视频信息，监控芯片与系统通信，负责上传摄像头捕获到的视频信息5区域对系统控制下的集中器和节点的一种逻辑划分，便于对集中器和节点针对不同范围下发指令例如：以地理范围为名字的区域。江西南昌、三明某镇。等6控制中心系统中所有区域、集中器、分组、节点的总和7分组对集中器控制下的节点的一种逻辑划分，便于对集中器下的节点按分组下发不同的指令8防盗终端可以检测到路灯电缆是否被盗的装置。本系统分为两种。一种是末端LED终端设置为防盗终端属性，另一种是电力线载波防盗终端。9电力线防盗终端设备类型0x

3、041.3专业名词解释l 什么是UID：LED终端唯一的地址信息。共6个字节。可以理解为类似MAC地址。l 后台软件发给集控器对于LED终端的的命令操作时。集控器对后台软件响应有两种可能，一种是操作成功 另一种是操作失败l 渐变调光：是指LED灯具从亮到暗或者从暗到亮是一个缓慢逐渐变化的过程。l 瞬间调光：是指LED灯具从亮到暗或者从暗到亮是一贯快速改变的过程。l 组：LED终端可以分成00x0f共16个组，其中第0组是默认组。不可编辑和删除。0x010x0f组需要先创建再进行操作。组信息存放在LED终端中。l 组播：对LED终端的0x010x0f组进行调光操作。l 广播：对LED终端0x00

4、组进行调光操作。是一种特殊的组播。l 防盗终端：启动电缆防盗功能时我们有两种防盗终端。一种是电力线载波防盗终端主要负责白天防盗。另一种是LED终端当着防盗终端使用，主要在晚上负责防盗。l 网络ID:请解释l 网络频点：请解释l 分包：当数据字段大于200字节时，集控器要进行分包发数据。后台软件再将接受的分包数据组成完整数据。l 定时检测：集控器按照所设定的时间向LED终端下发“获取LED终端电参数命令”。并将获取的信息上传至后台软件。l 二进制表示格式：例如十进制数80的二进制表示为 0b01010000说明有些数据字段可能是不定长。所以数据包的数据长度字段要根据实际情况计算。二后台软件和集控

5、器通信协议格式后台软件à集控器数据帧格式：包头数据长度设备类型命令数据CRC校验55 aaxxxxxx xxxx xx2B1B1B2B2B备注：B表示字节单位，CRC校验程序参考附件。由于CRC校验程序有不同的版本，所以在后台软件请采用我们附件提供的程序这样确保集控器能识别55表示的是十六进制的0x55aa表示的是十六进制的0xaa所有的通信协议如果未特殊说明都是十六进制数设备类型列表：0x01表示集控器0x02 表示LED终端0x03表示后台软件数据长度计算:除数据包中包头以外的所有数据的个数。有些数据字段可能是不定长。所以数据包的数据长度字段要根据实际情况计算。数据字段：最大不超

6、过200字节。如果需要传输大包数据，则分包发送。数据传输顺序：高位在前低位在后，例如传输十六进制数0x12345678的顺序依次是 0x12 0x34 0x56 0x78三通信协议定义3.1重点说明：本通信协议大部分后台软件下发的数据字段内容和集控器应答的数据字段相同。3.1.2除非单个查询LED灯具的当前亮度状态。否则集控器当前调光状态就是LED灯具的当前亮度状态。3.1.3设备定位可以（1）通过在地图上拖曳放置，（2）也可以通过直接在设备图标上输入经纬度信息。（3）读取设备内的经纬度信息这三种方式定位3.2配置集控器3.2.1配置集控器时间包头数据长度设备类型命令数据CRC校验55 aa0

7、x0e0300 06xx xx xx xx xx xx xx xxxx xx备注： 数据字段依次表示年、月、日、星期、小时、分钟、秒。十六进制表示。年 2个字节 高位在左边低位在右边月 1个字节日 1个字节星期 1个字节小时 1个字节分钟 1个字节秒 1个字节例如：2013年3月23日星期六下午4点50分55秒 数据字段的表达。0x07 0xdd 0x03 0x17 0x06 0x10 0x32 0x37集控器à后台软件响应格式：包头数据长度设备类型命令数据CRC校验55 aa0x0e0100 06xx xx xx xx xx xx xx xxxx xx3.2.2配置集控器的调光时间

8、包头数据长度设备类型命令数据CRC校验55 aaxx0300 08（小时 分 亮度）*5xx xx备注：小时、分、亮度 各占一个字节，采用24小时制 ，用16进制表示。亮度值范围 0，0X190XFF最多能配置5个时间段调光例如：18.40分 亮度 0xff 21.20分 亮度 0x80 0.00分 亮度 0x30 6.00分 亮度0x00 数据字段的表达0x12 0x28 0xff 0x15 0x14 0x80 0x00 0x00 0x30 0x06 0x00 0x00集控器à后台软件响应格式：包头数据长度设备类型命令数据CRC校验55 aaxx0100 08（小时分钟 亮度）*5

9、xx xx3.2.3配置集控器定时检测时间包头数据长度设备类型命令数据CRC校验55 aa0X080300 09小时 分钟xx xx备注：小时分钟各占一个字节，十六进制表示例如：设定控制器每天的检测时间是23.50分的数据字段表达.0x17 0x32集控器à后台软件响应格式：包头数据长度设备类型命令数据CRC校验55 aa0x080100 09小时 分钟xx xx3.2.4使能/禁止定时检测包头数据长度设备类型命令数据CRC校验55 aa0X070300 0A0x00为使能,0x01为禁止xx xx集控器à后台软件响应格式：包头数据长度设备类型命令数据CRC校验55 aa0

10、x070100 0A0x00为使能,0x01为禁止xx xx3.2.5配置集控器的经纬度和时区包头数据长度设备类型命令数据CRC校验55 aa0x2e0300 0B40B xx xx经度在前、纬度在中间、时区在后面。数据字段长度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.12345

11、6 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00+3集控器à后台软件响应格式：包头数据长度设备类型命令数据CRC校验55 aa0x2E0100 0B原样返回xx xx使能/禁止经纬度开关包头数据长度设备类型命令数据CRC校验55 aa0x070300 0C0x00为使能,0x01为禁止xx xx集控器à后台软件响应格式：包头数据长度设备类型命令数据CRC校验55 aa0x070100 0C0x00为使能,0x01为禁止xx xx3.2.7 使能/禁止防盗功能包头数据长度设备类型命令数据CRC校验55 aa0x070300 170x

12、00/ 0x01xx xx备注：0x00表示使能 0x01表示禁止集控器à后台软件响应格式：包头数据长度设备类型命令数据CRC校验55 aa0x070100 170x00/ 0x01xx xx3.2.8使能/禁止短信报警功能包头数据长度设备类型命令数据CRC校验55 aa0x070300180x00/ 0x01xx xx备注：0x00表示使能 0x01表示禁止集控器à后台软件响应格式：包头数据长度设备类型命令数据CRC校验55 aa0x070100 180x00/ 0x01xx xx3.2.9配置短信报警目标号码（最多5个）包头数据长度设备类型命令数据CRC校验55 aan

13、0300 191B号码个数号码xx xx备注：短信报警目标号码最多5个 ，用16进制表示每个号码20个字节号码有效位用ACSII表示 无效为用0x00填充例如：我要配置3个手机号码的数据字段格式如下无需考虑国家区号代码，集控器程序中有设定集控器à后台软件响应格式：包头数据长度设备类型命令数据CRC校验55 aa0x060100 19N/Axx xx3.3配置终端3.3.1配置终端分组信息包头数据长度设备类型命令数据CRC校验55 aa0X0E0300 076B UID0X00010XFFFFxx xx备注：UID表示LED终端地址信息。数据字段中低2个字节表示分组信息，每一位代表一个

14、分组信息。1表示分组有效0表示分组无效、删除组。第0组不能配置，是默认组。最大支持16组例如 0b1000 1000 1111 0000表示的意思是LED终端被分配到第15,11,7,6,5,4,0组。其中第0组是默认组。不会被编辑或者删除。集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aa0x0D0100 076B UID0X00/0X01xx xx备注：数据字段低字节 0x00表示集控器操作LED终端成功、通信正常 。0x01表示集控器操作LED终端失败、通信异常。如果出现通信异常情况后台软件则提示“请逐个配置，检查该终端地址是否存在”配置LED终端为防盗终

15、端包头数据长度设备类型命令数据CRC校验55 aan0300 151B表示LED终端数量LED终端UID xx xx备注：数据字段最高1字节表示中LED终端数量 这条命令总共要一次配置多少个防盗终端。最大0x0f例如.我要配置某3个地址的LED终端为防盗终端集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aan0100 151B表示LED终端数量LED终端UID xx xx配置电力线防盗终端包头数据长度设备类型命令数据CRC校验55 aan0300 161B表示电力线终端数量电力线终端UID xx xx备注：参照LED防盗终端解释集控器à后台软件响应格式

16、包头数据长度设备类型命令数据CRC校验55 aan0100 161B表示电力线终端数量电力线终端UID xx xx备注：3.4调光操作3.4.1组播渐变调光包头数据长度设备类型命令数据CRC校验55 aa0x080300 020x000x0F0x000xFFxx xx备注：组播渐变调光数据字段高字节表示组播地址 0x00表示广播地址 0x010x0f表示十五个组地址数据字段低字节表示亮度数据 ，软件上要屏蔽0x010x18。因为这些亮度对于LED终端自动认为是0亮度例如：组播0x07组 亮度0x80数据字段表示0x07 0x80广播所有组 亮度0xff数据字段表示0x00 0x0f集控器

17、24;后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aa0x090100 020x000x0400x000x0F0x000xFFxx xx备注：当后台软件对集控器发调光命令时，集控器会检查回路电压,并将这个信息反馈到后台软件。这样做的原因是因为组播调光时集控器和LED终端是单向通信，也就是说集控器是不知道LED终端执行情况。响应数据字段中的数据分别表示最高字节: 表示回路电压是否正常。例如0b0000 0110 表示有两路异常中间字节：表示组信息，例如 0x04表示对“0x04组”调光最后字节：表示亮度信息组播瞬间调光包头数据长度设备类型命令数据CRC校验55 aa0x08030

18、0 030x000x0F0x000xFFxx xx备注：组播瞬间调光数据字段高字节表示组播地址 0x00表示广播地址 0x010x0f表示十五个组地址数据字段低字节表示亮度数据 ，软件上要屏蔽0x010x18。因为这些亮度对于LED终端自动认为是0亮度集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aa0x090100 030x000x0400x000x0F0x000xFFxx xx备注：参考组播渐变调光单灯渐变调光包头数据长度设备类型命令数据CRC校验55 aa0x0D0300 046B UID0x000xFFxx xx备注：单灯调光需要使用UID地址集控器&#

19、224;后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aa0x0D0100 046B UID0x00/ 0x01xx xx备注：数据字段低位字节=0x00表示通信正常，0x01表示通信异常。单灯瞬间调光包头数据长度设备类型命令数据CRC校验55 aa0x0D0300 056B UID0x000xFFxx xx集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aa0x0D0100 056B UID0x00/ 0x01xx xx备注：数据字段低位字节=0x00表示通信正常，0x01表示通信异常。 3.4.5集控器执行自动调光后、上报后台软件包头数据长度设备

20、类型命令数据CRC校验55 aa0x070100 1B当前亮度 1Bxx xx备注：此命令表示集控器自动调光后将调光亮度上传后台 1个字节表示亮度3.5获取LED终端信息获取LED终端电参数状态包头数据长度设备类型命令数据CRC校验55 aa0x0C0300 0DLED终端UIDxx xx备注：后台软件通过LED终端UID来获取相应的参数集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aa0x140100 0DUID（6B）8Bxx xx备注：数据字段格式为 UID、电流、电压、功率、功率因数、灯具调光状态。LED终端UID:电流：2个字节 十六进制电压：2个字节

21、 十六进制功率：2个字节 十六进制功率因数：1个字节 十六进制灯具调光：1个字节 十六进制 UID:0x12 0x34 0x56 0x78 0x90 0x12 电流：0x00 0xdc电压：0x03 0xf3 功率：0x00 0xe0 功率因数：0x62 灯具调光：0xf8当电流、电压、功率、功率因数、灯具调光这8个字节全为0时表示这个UID终端通信异常功率因数字段为0表示LED终端没有采集”功率因数”功能。而不是功率因数值=0获取LED终端配置参数包头数据长度设备类型命令数据CRC校验55 aa0x0C0300 0ELED终端UIDxx xx集控器à后台软件响应格式包头数据长度设备

22、类型命令数据CRC校验55 aa0x500100 0EUID（6B）77Bxx xx备注：数据段格式 UID 分组信息 调光时段 备注信息 设备类型 经纬度分组信息:2个字节有效时段数：1字节 十六进制调光时段：15个字节，从高到低表示 小时 分钟 亮度，总共5段。无效段填0x00.备注信息：20个字节,ACSII码表示，不够用0x00填充 设备类型：1个字节经纬度：38个字节当UID后面的77个字节全为0表示该终端不存在或者通信异常自动搜索LED终端包头数据长度设备类型命令数据CRC校验55 aa0x060300 13N/Axx xx备注：数据段为空集控器à后台软件响应格式包头数据

23、长度设备类型命令数据CRC校验55 aan0100 131B分包信息2B终端个数终端UIDxx xx备注：数据段格式： 分包信息+终端数量+终端UID列表分包信息：1字节 ，0x01分包未完成 0x00分包完成。终端数量：1个字节 十六进制表示终端UID：每个UID 6个字节数据字段不超过200字节。需要传输大量数据则分包发送。手动添加LED终端包头数据长度设备类型命令数据CRC校验55 aa0x0C0300 14终端UID 6Bxx xx备注：数据字段6个字节的UID。每次只能添加一个集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aa0x0C0100 14终端

24、UID 6Bxx xx备注：数据字段全为0时表示LED终端不存在或者通信异常3.6读取集控器参数读取集控器参数1包头数据长度设备类型命令数据CRC校验55 aa0x060300 0FN/Axx xx备注：这个命令不带数据参数集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aaxx0100 0F75B 最多xx xx备注：数据子段内容依次如下系统时间：xx xx xx xx xx xx xx xx，共8字节，十六进制表示 依次年、月、日、星期、小时、分钟、秒调光时段数：1字节 0x010x05 调光时段：小时、分钟、亮度。分别用依次用十六进制表示，最多5段，也就是说

25、最多15个字节网络ID：2字节网络频点：1字节电池状态：1字节。0x00表示电池有电 0x01电量低。指的是集中控制器内部时钟电池。经纬度开关灯使能状态：1字节 0x00表示使能 0x01表示禁止经纬度和时区：40个字节。格式定义参照 “3.2.5命令”读取集控器参数2包头数据长度设备类型命令数据CRC校验55 aa0x060300 10N/Axx xx备注：这个命令不带数据参数集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aaxx0100 104B1B 无线1B 有线无线地址有线地址xx xx备注：数据字段内容依次是定时检测使能状态： 1字节 0x00表示使能

26、 0x01禁止定时检测时间：2字节 小时、分钟分别依次用十六进制表示防盗使能状态：1字节 0x00表示使能 0x01禁止无线防盗终端数量： 1字节 最大0x0f电力线防盗终端数量：1字节,最大0x0f无线防盗终端UID地址：电力线防盗终端UID地址:读取集控器参数3包头数据长度设备类型命令数据CRC校验55 aa0x060300 11N/Axx xx备注：这个命令不带数据参数集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aan0100 111B1B号码个数号码xx xx备注：数据字段内容依次是短信报警功能使能状态：1字节 0x00表示使能 0x01禁止短信报警号

27、码个数：1个字节 范围0x000x05短信手机号码：格式详见“”命令3.6.4读取集控器参数4包头数据长度设备类型命令数据CRC校验55 aa0x060300 1CN/Axx xx备注：这条命令是用来读取集控器中保存的LED终端UID集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aan0100 1C1B分包信息1B字节 LED终端个数LED终端UIDxx xx备注：数据段格式： 分包信息+LED终端数量+LED终端UID列表分包信息：0x01分包未完成 0x00分包完成。LED终端数量：1个字节 十六进制表示LED终端UID：每个UID 6个字节数据字段不超过2

28、00字节。需要传输大量数据则分包发送。读取集控器所有LED终端历史电参数包头数据长度设备类型命令数据CRC校验55 aa0x060300 1DN/Axx xx备注：这是后台软件用来读取集控器内部保存的LED终端电参数信息命令。集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aa0x140100 1DUID（6B）8Bxx xx备注：数据字段参考“”3.6.6读取所有LED终端实时电参数包头数据长度设备类型命令数据CRC校验55 aa0x060300 1EN/Axx xx备注：这是后台软件通过集控器实时读取所有LED终端电参数信息命令。集控器à后台软件响应

29、格式包头数据长度设备类型命令数据CRC校验55 aa0x140100 1EUID（6B）8Bxx xx备注：数据字段参考“”3.7交流柜操作3.7.1交流接触器操作包头数据长度设备类型命令数据CRC校验55 aa0x070300 010x00/ 0x01xx xx备注：数据字段0x00表示闭合回路 0x01表示断开回路集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aa0x070100 011Bxx xx备注：数据字段低3位分别表示三相电是否正常。 0表示正常 1异常例如：如果收到数据是0b0000 0110表示3相回路电压两相正常一相异常。解释：集控器能够检测到

30、交流接触器闭和后3相交流回路电压是否正常读取三相回路电压包头数据长度设备类型命令数据CRC校验55 aa0x060300 12N/Axx xx备注：这个命令数据字段空集控器à后台软件响应格式包头数据长度设备类型命令数据CRC校验55 aa0x0C0100 12 2B*3xx xx备注：数据字段共6个字节，表示3个回路的电压。十六精制表示例如：表示三相的电压分别是 220V 230V 200V 0x00 0xDC 0x00 0XE6 0x00 0XC8交流柜继电器动作主动告诉后台包头数据长度设备类型命令数据CRC校验55 aa0x070100 1A0x00/ 0x01xx xx备注：数

31、据字段1个字节 ，0x00表示继电器闭合， 0x01继电器断开4软件包含的功能。4.1用户登录4.1.1在浏览器中输入软件的地址,再填写用户名和密码，单击登录按钮。4.1.2登录界面设计设计成将文件放到软件指定的文件夹。方便经常更改。按用户权限分为超级用户、管理员用户、普通用户。超级用户：所有权限。能创建管理员用户管理员用户：只能创建普通用户。有权限操作所有控制设备普通用户：查看、采集LED终端信息。修改系统开灯时间。4.1.4用户登录系统后3分钟未操作则退出系统，自动回到用户登录界面。4.2区域管理区域管理是为了对系统控制下的集中器和节点的一种逻辑划分，便于对集中器和节点针对不同范围下发指令

32、，方便管理。关于回路上电、回路断电、开灯、关灯的一些操作建议：对于实际的实施应用中，建议回路上电、回路断电、开灯、关灯操作切勿过于频繁，操作时间间隔5秒以上为佳；对于定时任务设定，时间间隔10分钟以上为佳。4.2.1新增区域修改区域删除区域为了保证不被误删除。所要删除区域必须保证这个区域内没有集控器和终端等设备。如果有这些设备则先要删除这些设备后才能删除区域。区域上电将区域内管理的每个集控器所在的交流柜开关闭合。给路灯供电。区域断电区域渐变调光区域瞬间调光4.2.5区域终端数据查询4.2.6区域数据导出4.3集中器管理新增集控器4.3.2删除集控器删除集控器必须先删除这个集控器节点下的信息。如

33、分组、等信息终端。主要是误删除太多的数据。4.3.3读取、修改、远程下载配置集控器配置集控器参照上面的协议。建议将这些功能做进一个对话框中集中管理。这些参数能保存在服务器中，下次更换换集控器时直接导入这些数据后远程下载到集控器。4.3.4集控器开灯将集控器所在的交流柜开关闭合。给路灯供电。4.3.5集控器断电4.3.6集控器渐变调光4.3.7集控器瞬间调光4.3.8集控器终端数据查询查询所有的LED终端电参数信息。用3.6.6命令读取集控器内部保存的LED终端UID。用3.6.4命令4.3.9集控器终端数据导出。4.3.10集控器数据导出。这个功能便于更换新的集控器时重新设定参数。4.3.11设置后台软件每天查询集控器的时间。集控器每天会按照设置的时间执行“3.5.1获取LED终端电参数状态”命令。并将这些