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終端電參數狀態”命令。并將這些