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

资源描述

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

《路灯智能照明管理系统软件需求.docx》由会员分享，可在线阅读，更多相关《路灯智能照明管理系统软件需求.docx（32页珍藏版）》请在冰点文库上搜索。

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

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

后台软件功能开发需求手册

文件修改记录

版本号

修改时间

作者

V1.0

一．引言

1.1编写目的

用于后台软件开发功能描述，通过该手册后台软件开发人员可以快速了解用户需求。

1.2设备定义

序号

术语

术语解释

备注

后台软件

Smart智慧路灯控制系统，部署在服务器上的应用程序，客户可以通过登录指定的网页对各个嵌入式设备进行远程控制操作。

后台软件可通过GOOGLE地图对所有的设备进行定位。

设备类型0x03

集控器

嵌入式控制设备。

于系统进行交互执行系统发送的控制指令，并负责下发给命令给各个节点

设备类型0x01

LED路灯终端

嵌入式设备，安装在LED路灯内部，路灯节点可以对LED进行调光，电压电流采集。

调光等级为0，25~255。

节点本身屏蔽掉1~24这些调光等级

设备类型0x02

视频设备

嵌入式设备，包括摄像头和监控芯片两部分，摄像头捕捉视频信息，监控芯片与系统通信，负责上传摄像头捕获到的视频信息

区域

对系统控制下的集中器和节点的一种逻辑划分，便于对集中器和节点针对不同范围下发指令

例如：

以地理范围为名字的区域。

江西南昌、三明某镇。

等

控制中心

系统中所有区域、集中器、分组、节点的总和

分组

对集中器控制下的节点的一种逻辑划分，便于对集中器下的节点按分组下发不同的指令

防盗终端

可以检测到路灯电缆是否被盗的装置。

本系统分为两种。

一种是末端LED终端设置为防盗终端属性，另一种是电力线载波防盗终端。

电力线防盗终端

设备类型0x04

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

说明有些数据字段可能是不定长。

所以数据包的数据长度字段要根据实际情况计算。

二．后台软件和集控器通信协议格式

后台软件→集控器数据帧格式：

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

xxxx

备注：

B表示字节单位，

CRC校验程序参考附件。

由于CRC校验程序有不同的版本，所以在后台软件请采用我们附件提供的程序这样确保集控器能识别

55表示的是十六进制的0x55

aa表示的是十六进制的0xaa

所有的通信协议如果未特殊说明都是十六进制数

设备类型列表：

0x01表示集控器

0x02表示LED终端

0x03表示后台软件

数据长度计算:

除数据包中包头以外的所有数据的个数。

有些数据字段可能是不定长。

所以数据包的数据长度字段要根据实际情况计算。

数据字段：

最大不超过200字节。

如果需要传输大包数据，则分包发送。

数据传输顺序：

高位在前低位在后，例如传输十六进制数0x12345678的顺序依次是0x120x340x560x78

三．通信协议定义

3.1重点说明：

3.1.1本通信协议大部分后台软件下发的数据字段内容和集控器应答的数据字段相同。

3.1.2除非单个查询LED灯具的当前亮度状态。

否则集控器当前调光状态就是LED灯具的当前亮度状态。

3.1.3设备定位可以

（1）通过在地图上拖曳放置，

（2）也可以通过直接在设备图标上输入经纬度信息。

（3）读取设备内的经纬度信息这三种方式定位

3.2配置集控器

3.2.1配置集控器时间

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0e

0006

xxxxxxxxxxxxxxxx

xxxx

备注：

数据字段依次表示年、月、日、星期、小时、分钟、秒。

十六进制表示。

年2个字节高位在左边低位在右边

月1个字节

日1个字节

星期1个字节

小时1个字节

分钟1个字节

秒1个字节

例如：

2013年3月23日星期六下午4点50分55秒数据字段的表达。

0x070xdd0x030x170x060x100x320x37

集控器→后台软件响应格式：

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0e

0006

xxxxxxxxxxxxxxxx

xxxx

3.2.2配置集控器的调光时间

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0008

（小时分亮度）*5

xxxx

备注：

小时、分、亮度各占一个字节，

采用24小时制，用16进制表示。

亮度值范围0，0X19~0XFF

最多能配置5个时间段调光

例如：

18.40分亮度0xff

21.20分亮度0x80

0.00分亮度0x30

6.00分亮度0x00数据字段的表达

0x120x280xff0x150x140x800x000x000x300x060x000x00

集控器→后台软件响应格式：

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0008

（小时分钟亮度）*5

xxxx

3.2.3配置集控器定时检测时间

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0X08

0009

小时分钟

xxxx

备注：

小时分钟各占一个字节，十六进制表示

例如：

设定控制器每天的检测时间是23.50分的数据字段表达.

0x170x32

集控器→后台软件响应格式：

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x08

0009

小时分钟

xxxx

3.2.4使能/禁止定时检测

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0X07

000A

0x00为使能,0x01为禁止

xxxx

集控器→后台软件响应格式：

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x07

000A

0x00为使能,0x01为禁止

xxxx

3.2.5配置集控器的经纬度和时区

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x2e

000B

40B

xxxx

经度在前、纬度在中间、时区在后面。

数据字段长度40个字节。

数据字段用ACSII表示

经度19个字节、不够后面补十六进制0x00来凑足19个字节

纬度19个字节、不够后面补十六进制0x00来凑足19个字节

时区2个字节

例如：

要表示经度正110.12345。

维度负65.123456。

时区正3

+110.123450x000x000x000x000x000x000x000x000x00

-65.1234560x000x000x000x000x000x000x000x000x00

集控器→后台软件响应格式：

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x2E

000B

原样返回

xxxx

3.2.6使能/禁止经纬度开关

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x07

000C

0x00为使能,0x01为禁止

xxxx

集控器→后台软件响应格式：

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x07

000C

0x00为使能,0x01为禁止

xxxx

3.2.7使能/禁止防盗功能

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x07

0017

0x00/0x01

xxxx

备注：

0x00表示使能0x01表示禁止

集控器→后台软件响应格式：

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x07

0017

0x00/0x01

xxxx

3.2.8使能/禁止短信报警功能

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x07

0018

0x00/0x01

xxxx

备注：

0x00表示使能0x01表示禁止

集控器→后台软件响应格式：

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x07

0018

0x00/0x01

xxxx

3.2.9配置短信报警目标号码（最多5个）

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0019

1B号码个数

号码

xxxx

备注：

短信报警目标号码最多5个，用16进制表示

每个号码20个字节

号码有效位用ACSII表示无效为用0x00填充

例如：

我要配置3个手机号码的数据字段格式如下

0X030X000X000X000X000X000X000X000X000X00

0X000X000X000X000X000X000X000X000X00

无需考虑国家区号代码，集控器程序中有设定

集控器→后台软件响应格式：

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x06

0019

N/A

xxxx

3.3配置终端

3.3.1配置终端分组信息

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0X0E

0007

6BUID

0X0001~0XFFFF

xxxx

备注：

UID表示LED终端地址信息。

数据字段中低2个字节表示分组信息，每一位代表一个分组信息。

1表示分组有效

0表示分组无效、删除组。

第0组不能配置，是默认组。

最大支持16组

例如0b1000100011110000

表示的意思是LED终端被分配到第15,11,7,6,5,4,0组。

其中第0组是默认组。

不会被编辑或者删除。

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0D

0007

6BUID

0X00/0X01

xxxx

备注：

数据字段低字节0x00表示集控器操作LED终端成功、通信正常。

0x01表示集控器操作LED终端失败、通信异常。

如果出现通信异常情况后台软件则提示“请逐个配置，检查该终端地址是否存在”

3.3.2配置LED终端为防盗终端

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0015

1B表示LED终端数量

LED终端UID

xxxx

备注：

数据字段最高1字节表示中LED终端数量这条命令总共要一次配置多少个防盗终端。

最大0x0f

例如.我要配置某3个地址的LED终端为防盗终端

0x030x1234567890100x1234567890120x123456789013

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0015

1B表示LED终端数量

LED终端UID

xxxx

3.3.3配置电力线防盗终端

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0016

1B表示电力线终端数量

电力线终端UID

xxxx

备注：

参照LED防盗终端解释

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0016

1B表示电力线终端数量

电力线终端UID

xxxx

备注：

3.4调光操作

3.4.1组播渐变调光

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x08

0002

0x00~0x0F

0x00~0xFF

xxxx

备注：

组播渐变调光

数据字段高字节表示组播地址

0x00表示广播地址

0x01~0x0f表示十五个组地址

数据字段低字节表示亮度数据，软件上要屏蔽0x01~0x18。

因为这些亮度对于LED终端自动认为是0亮度

例如：

组播0x07组亮度0x80数据字段表示

0x070x80

广播所有组亮度0xff数据字段表示

0x000x0f

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x09

0002

0x00~0x040

0x00~0x0F

0x00~0xFF

xxxx

备注：

当后台软件对集控器发调光命令时，集控器会检查回路电压,并将这个信息反馈到后台软件。

这样做的原因是因为组播调光时集控器和LED终端是单向通信，也就是说集控器是不知道LED终端执行情况。

响应数据字段中的数据分别表示

最高字节:

表示回路电压是否正常。

例如0b00000110表示有两路异常

中间字节：

表示组信息，例如0x04表示对“0x04组”调光

最后字节：

表示亮度信息

3.4.2组播瞬间调光

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x08

0003

0x00~0x0F

0x00~0xFF

xxxx

备注：

组播瞬间调光

数据字段高字节表示组播地址

0x00表示广播地址

0x01~0x0f表示十五个组地址

数据字段低字节表示亮度数据，软件上要屏蔽0x01~0x18。

因为这些亮度对于LED终端自动认为是0亮度

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x09

0003

0x00~0x040

0x00~0x0F

0x00~0xFF

xxxx

备注：

参考组播渐变调光

3.4.3单灯渐变调光

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0D

0004

6BUID

0x00~0xFF

xxxx

备注：

单灯调光需要使用UID地址

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0D

0004

6BUID

0x00/0x01

xxxx

备注：

数据字段低位字节=0x00表示通信正常，0x01表示通信异常。

3.4.4单灯瞬间调光

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0D

0005

6BUID

0x00~0xFF

xxxx

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0D

0005

6BUID

0x00/0x01

xxxx

备注：

数据字段低位字节=0x00表示通信正常，0x01表示通信异常。

3.4.5集控器执行自动调光后、上报后台软件

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x07

001B

当前亮度1B

xxxx

备注：

此命令表示集控器自动调光后将调光亮度上传后台1个字节表示亮度

3.5获取LED终端信息

3.5.1获取LED终端电参数状态

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0C

000D

LED终端UID

xxxx

备注：

后台软件通过LED终端UID来获取相应的参数

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x14

000D

UID（6B）

xxxx

备注：

数据字段格式为UID、电流、电压、功率、功率因数、灯具调光状态。

LED终端UID:

电流：

2个字节十六进制

电压：

2个字节十六进制

功率：

2个字节十六进制

功率因数：

1个字节十六进制

灯具调光：

1个字节十六进制

例如：

UID号0x123456789012的电压=220V、电流=1011毫安、功率=224W、功率因数=0.98、灯具调光=0xf8

UID:

0x120x340x560x780x900x12

电流：

0x000xdc

电压：

0x030xf3

功率：

0x000xe0

功率因数：

0x62

灯具调光：

0xf8

当电流、电压、功率、功率因数、灯具调光这8个字节全为0时表示这个UID终端通信异常

功率因数字段为0表示LED终端没有采集”功率因数”功能。

而不是功率因数值=0

3.5.2获取LED终端配置参数

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0C

000E

LED终端UID

xxxx

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x50

000E

UID（6B）

77B

xxxx

备注：

数据段格式UID分组信息调光时段备注信息设备类型经纬度

分组信息:

2个字节

有效时段数：

1字节十六进制

调光时段：

15个字节，从高到低表示小时分钟亮度，总共5段。

无效段填0x00.

备注信息：

20个字节,ACSII码表示，不够用0x00填充

设备类型：

1个字节

经纬度：

38个字节

当UID后面的77个字节全为0表示该终端不存在或者通信异常

3.5.3自动搜索LED终端

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x06

0013

N/A

xxxx

备注：

数据段为空

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0013

1B分包信息

2B终端个数

终端UID

xxxx

备注：

数据段格式：

分包信息+终端数量+终端UID列表

分包信息：

1字节，0x01分包未完成0x00分包完成。

终端数量：

1个字节十六进制表示

终端UID：

每个UID6个字节

数据字段不超过200字节。

需要传输大量数据则分包发送。

3.5.4手动添加LED终端

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0C

0014

终端UID6B

xxxx

备注：

数据字段6个字节的UID。

每次只能添加一个

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x0C

0014

终端UID6B

xxxx

备注：

数据字段全为0时表示LED终端不存在或者通信异常

3.6读取集控器参数

3.6.1读取集控器参数1

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

0x06

000F

N/A

xxxx

备注：

这个命令不带数据参数

集控器→后台软件响应格式

包头

数据长度

设备

类型

命令

数据

CRC

校验

55aa

000F

75B最多

xxxx

备注：

数据子段内容依次如下

系统时间：

xxxxxxxxxxxxxxxx，共8字节，十六进制表示

依次年、月、日、星期、小时、分钟、秒

调光时段数：

1字节0x01~0x05

调光时段：

小时、分钟、亮度。

分别用依次用十六进制表示，最多5段，也就是说最多15个字节

网络ID：

2字节

网络频点：

1字节

电池状态：

1字节。

0x00表示

展开阅读全文