浙江電信-愛(ài)wifi融合終端書(shū)v2.0

1、2016 年 04 月中國(guó)電信愛(ài) WiFi 運(yùn)營(yíng)中心文檔修訂歷史日期版本修改內(nèi)容修改人審核備注2015/10/22V1.0創(chuàng)建2016/01/04V2.0新增任務(wù) 5003、5004，3.6 節(jié)添加前向運(yùn)營(yíng)標(biāo)志位2016/02/24V2.0修改任務(wù) 2003，執(zhí)行方式，詳見(jiàn) 2003 任務(wù)說(shuō)明2016/03/11V2.0修改 3.6 節(jié)用戶(hù)登錄 operation 值由 1 改為 2區(qū)分設(shè)備2016/03/14V2.0增加 3.4、3.9 節(jié) operation 標(biāo)志位標(biāo)識(shí)用戶(hù)群體2016/03/21V2.0新增 3.5 節(jié) 5006 任務(wù)，下發(fā)operation 值區(qū)分場(chǎng)景2016/03/2

2、4V2.0新增 3.4 節(jié) release 參數(shù)，逃生狀態(tài)位上報(bào)當(dāng)前狀態(tài)2016/04/06V2.0新增 3.5 節(jié) 5007 任務(wù)，awifi 控制開(kāi)關(guān)正 文 目 錄前言1設(shè)備類(lèi)型2技術(shù)規(guī)范3123接入服務(wù)器及白3.1. ..4接入服務(wù)器3廠(chǎng)商提交融合終端設(shè)備信息3白3APP地址3默認(rèn) devid03.113.12網(wǎng)關(guān). 5網(wǎng)關(guān)心跳7網(wǎng)關(guān)管理8用戶(hù)登錄12用戶(hù)認(rèn)證13WiFi 門(mén)戶(hù)14終端心跳14用戶(hù)下線(xiàn)14行為日志上報(bào)15系統(tǒng)升級(jí)2.2Uboot 工作原理16網(wǎng)關(guān)應(yīng)用端升級(jí)方案

3、18提供 watchdogWiFidog 等服務(wù)進(jìn)程53.163.17設(shè)備lan 口免認(rèn)證22DHCP 設(shè)置22雙. 22TCP option 帶終端 MAC 信息23要求24452B 客戶(hù)端配置路由接口協(xié)議25接口通用說(shuō)明25接口詳情25登錄路由器:loginRouter25設(shè)置上網(wǎng)方式:set ernet26設(shè)置路由器內(nèi)網(wǎng):setNetwork27設(shè)置無(wú)線(xiàn)參數(shù):setWifi28獲取路由器登錄名：getLoginName28獲取路由器激活狀態(tài):getActiveS e2....75.2.85

4、.2.9設(shè)置路由路登錄：setLoginPwd29重啟路由器:restart30恢復(fù)出廠(chǎng)設(shè)置: restore31獲取路由設(shè)備激活信息: getRegisterInfo315.2.1062C 客戶(hù)端接口協(xié)議33獲取Wan 口 MAC 地址:getwanmac336.1針對(duì) APP 的認(rèn)證上網(wǎng):appauth336.2附錄一：縮略語(yǔ)35附錄二：愛(ài)WiFi 設(shè)備記表361 前言本標(biāo)準(zhǔn)目的是制定愛(ài)WiFi 融合終端的設(shè)備規(guī)范，以作為愛(ài)WiFi 設(shè)備入圍、選型、采購(gòu)、認(rèn)證的技術(shù)依據(jù)。愛(ài) WiFi 運(yùn)營(yíng)中心在簽訂合同前，根據(jù)需要修改和補(bǔ)充書(shū)，修改補(bǔ)充后的最終規(guī)范書(shū)將作為合同的組成部分。愛(ài)WiFi 運(yùn)營(yíng)中

5、心在任何時(shí)候保留和擁有對(duì)書(shū)的解釋權(quán)和修改權(quán)。愛(ài) WiFi 運(yùn)營(yíng)中心，廠(chǎng)家不得以向第透露書(shū)內(nèi)容。廠(chǎng)家應(yīng)承諾：在供貨時(shí)提供的設(shè)備已解決驗(yàn)證測(cè)試中出現(xiàn)的所有問(wèn)題，并形成穩(wěn)定的供貨版本。廠(chǎng)家應(yīng)對(duì)以下見(jiàn)附錄 2 愛(ài)WiFi 設(shè)備每一項(xiàng)要求，如實(shí)地填寫(xiě)說(shuō)明其設(shè)備的支持程度，具體記表。首先對(duì)實(shí)現(xiàn)或滿(mǎn)足程度明確做出“滿(mǎn)足”、“不滿(mǎn)足”、“部分滿(mǎn)足”等應(yīng)答，然后做出具體、詳細(xì)的說(shuō)明。不得使用“明白”、“理解”等詞語(yǔ)。在答復(fù)中，要求明確滿(mǎn)足的程度，凡采用“詳見(jiàn)”、“參見(jiàn)”方式說(shuō)明的，應(yīng)指明參見(jiàn)文檔的具體章節(jié)或頁(yè)碼。如無(wú)特別說(shuō)明，廠(chǎng)家支持的功能應(yīng)為設(shè)備已實(shí)現(xiàn)的功能，不包括有能力支持但尚未實(shí)現(xiàn)的、近期將要實(shí)現(xiàn)的、未來(lái)

6、計(jì)劃實(shí)現(xiàn)的功能。愛(ài) WiFi 運(yùn)營(yíng)中心將適時(shí)進(jìn)行驗(yàn)證測(cè)試，如發(fā)現(xiàn)廠(chǎng)家支持的功能和性能要求與不符，愛(ài) WiFi 運(yùn)營(yíng)中心將保留采取進(jìn)一步措施（如取消供貨、追討賠償?shù)龋┑臋?quán)利。12 設(shè)備類(lèi)型的設(shè)備類(lèi)型：需至少具備1個(gè)USB接口，一個(gè)接口，一個(gè)AV口，支持雙功能。廠(chǎng)家應(yīng)在附錄2愛(ài)WiFi設(shè)備記表中詳細(xì)列出設(shè)備的型號(hào)、軟、硬件版本、相關(guān)息。（如網(wǎng)關(guān)套片型號(hào)）、器（FLASH、RAM）的容量等信2技術(shù)規(guī)范接入服務(wù)器及白3.1.1接入服務(wù)器接入服務(wù)器必須按照以下信息進(jìn)行配置：表格 3-1 接入服務(wù)器配置信息3.1.2廠(chǎng)商提交融合終端設(shè)備信息廠(chǎng)家必須提交融合終端設(shè)備“品牌、型號(hào)、中文型號(hào)、固件版本、組件版本

7、、MAC 地址、PIN、省、市、區(qū)”信息，具體樣例如下：表格 3-2 融合終端設(shè)備信息3.1.3白廠(chǎng)家提供的設(shè)備必須配置如下白信息：3.1.4地址APP廠(chǎng)家設(shè)備必須配置地址：APP3http/iwifiapp/品牌（英文）型號(hào)中文型號(hào)固件版本組件版本MACPIN省市區(qū)FiberHomeMR820MR8201.0.01.0.048555A46311111111浙江杭州下城區(qū)接入服務(wù)器及端口platform-server: 80portal-server: 80auth-server: 80utils-server：803.2默認(rèn)devid如果商戶(hù)不綁定設(shè)備，則融合終端使用默認(rèn)的 devid，當(dāng)用

8、戶(hù)接入融合終端時(shí)使用默認(rèn)值彈出 portal。默認(rèn) devid 見(jiàn)下表：4省份默認(rèn)devid備注市DEFAULT_BJ_0026市DEFAULT_TJ_0002重慶市DEFAULT_CQ_0003市DEFAULT_SH_0004河北省DEFAULT_HB_0005省DEFAULT_HN_0006陜西省DEFAULT_SX_0007山西省DEFAULT_SX_0008山東省DEFAULT_SD_0009省DEFAULT_GS_0010遼寧省DEFAULT_LN_0011吉林省DEFAULT_JL_0012黑龍江省DEFAULT_HLJ_0013云南省DEFAULT_YN_0014省DEFAULT

9、_GZ_0015福建省DEFAULT_FJ_0016省DEFAULT_GD_0017海南省DEFAULT_HN_0018省DEFAULT_TW_0019表格 3-3 默認(rèn) devid 信息3.3網(wǎng)關(guān)1）設(shè)備觸發(fā)頁(yè)面，具體參數(shù)如下：5請(qǐng)求地址GEThttps:/platform-servort/api10/register.htm參數(shù)gw_mac網(wǎng)關(guān) MAC 地址gw_address網(wǎng)關(guān) IP 地址gw_port網(wǎng)關(guān)端soft_verwifidog版本返回?cái)?shù)據(jù)https:/platform-servort/api10/register.htm省DEFAULT_SC_0020省DEFAULT_HB

10、_0021湖南省DEFAULT_HN_0022江西省DEFAULT_JX_0023省DEFAULT_AH_0024江蘇省DEFAULT_JS_0025浙江省DEFAULT_ZJ_0001青海省DEFAULT_QH_0027DEFAULT_XJ_0028內(nèi)DEFAULT_NM_0029DEFAULT_NX_0030DEFAULT_XZ_0031廣西壯族DEFAULT_GX_0032特別行政區(qū)DEFAULT_AM_0033特別行政區(qū)DEFAULT_XG_0034表格 3-4 設(shè)備觸發(fā)頁(yè)面參數(shù)2）頁(yè)面向網(wǎng)關(guān)發(fā)起設(shè)備驗(yàn)證，具體參數(shù)如下：表格 3-5頁(yè)面向網(wǎng)關(guān)發(fā)起設(shè)備驗(yàn)證參數(shù)3）網(wǎng)關(guān)向認(rèn)證服務(wù)器發(fā)起設(shè)備

11、驗(yàn)證，具體參數(shù)如下：6請(qǐng)求地址GEThttps:/auth-servort/api10/register參數(shù)dev_id設(shè)備 IDmac網(wǎng)關(guān) MAC 地址stage=active激活返回?cái)?shù)據(jù)JSONresult : OK | FAIL, message:, servi: device_id:, account:, active_date:, servers: portals: hostname:., ssl_available: yes | no, ssl_port:, http_port:, path: /, , ,platforms: 請(qǐng)求地址GET參數(shù)dev_id設(shè)備 ID返回?cái)?shù)據(jù)表格

12、3-6 網(wǎng)關(guān)向認(rèn)證服務(wù)器發(fā)起設(shè)備驗(yàn)證參數(shù)3.4網(wǎng)關(guān)心跳網(wǎng)關(guān)定期向認(rèn)證服務(wù)器提交設(shè)備狀態(tài)，具體參數(shù)如下：7請(qǐng)求地址GEThttps:/auth-servort/api10/參數(shù)dev_id設(shè)備 IDgw_id設(shè)備主機(jī)名sys_uptime設(shè)備開(kāi)機(jī)時(shí)間sys_memfree系統(tǒng)當(dāng)前可用內(nèi)存sys_load系統(tǒng)負(fù)載hostname:., ssl_available: yes | no, ssl_port:,http_port:, path: /, ,auths: hostname:., ssl_available: yes | no, ssl_port:,http_port:, path: /, 表

13、格 3-7 網(wǎng)關(guān)定期向認(rèn)證服務(wù)器提交設(shè)備狀態(tài)參數(shù)3.5網(wǎng)關(guān)管理1）網(wǎng)關(guān)向認(rèn)證服務(wù)器請(qǐng)求任務(wù)，具體參數(shù)如下：8請(qǐng)求地址GEThttps:/auth-servort/api10/taskrequest參數(shù)dev_id設(shè)備 IDmac系統(tǒng)導(dǎo)入的 MAC返回?cái)?shù)據(jù)JSONresult: OK | FAIL, message:, task: task_id: xx task_code: task_params: file:/xx.imgtask_code: SMARTWIFI_TASK_REBOOT1000 *Wi-Fi 名稱(chēng)wan_ipWAN 口 IPwan_protoWAN 口協(xié)議soft_verWi

14、fidog版本hard_ver硬件版本uptimewifidog 服務(wù)啟動(dòng)時(shí)間mac系統(tǒng)導(dǎo)入的 MACoperation前向運(yùn)營(yíng)位，value 為 2release逃生狀態(tài)位返回?cái)?shù)據(jù)StringPong | Task9SMARTWIFI_TASK_PORTALSTART 2000SMARTWIFI_TASK_PORTALSTOP2001SMARTWIFI_TASK_PORTALRESTART 2002 *SMARTWIFI_TASK_SETBASEINFO 2003hostname: yyy /此任務(wù)同時(shí)修改兩個(gè) ，例如下發(fā)任務(wù)的 為 aWiFi-KFC-101,在修改愛(ài) wifi 的 的同時(shí)

15、將非愛(ài) wifi 的 修改為 KFC-101，即去掉 aWiFi-字段SMARTWIFI_TASK_SYSUPGRADE 3000SMARTWIFI_TASK_TER_REFUSE 4001tokens: “x”,”,”SMARTWIFI_TASK_WHITE_LIST 4002mac: “”, “”/每次收到新的白 請(qǐng)求，先刪除原先所有白 內(nèi)容SMARTWIFI_TASK_FLOW_CONTROL 5001outbound: 1234,inbound: 4321/ k bit，0 表示不控制流量10SMARTWIFI_TASK_SET_DEVID 5002servi: device_id:,

16、 account:, active_date:, servers: portals: hostname:., ssl_available: yes | no, ssl_port:, http_port:, path: /, , ,platforms: hostname:., ssl_available: yes | no, ssl_port:,http_port:, path: /, ,auths: hostname:., ssl_available: yes | no, ssl_port:,http_port:, path: /, 11SMARTWIFI_TASK_RELEASE_CONTR

17、OL 5003“release”: “OK | FAIL”, “time”:1800/ 秒/其中 OK 表示進(jìn)入逃生模式，F(xiàn)AIL 表示退出逃生模式，正常認(rèn)證上網(wǎng)，time 表示退出逃生模式時(shí)間，即在開(kāi)啟逃生模式內(nèi)如果 1800 秒后還沒(méi)接收到退出指令，自動(dòng)退出，time 參數(shù)在 release 為 OK 時(shí)必須存在，F(xiàn)AIL 時(shí)，可選SMARTWIFI_TASK_WIFI_CONTROL 5004“wifiswitch”:”O(jiān)N|OFF”/其中 ON 表示開(kāi)，OFF 表示關(guān)，此 開(kāi)關(guān)針對(duì)的是非 awifi 熱點(diǎn)SMARTWIFI_TASK_LAN_CONTROL 5005“l(fā)answitch

18、”:”O(jiān)N|OFF”/其中 ON 表示 Lan 口進(jìn)行愛(ài) wifi 認(rèn)證，OFF 表示 Lan口不需要愛(ài) wifi 認(rèn)證，且默認(rèn)出廠(chǎng)是需要 awifi 認(rèn)證SMARTWIFI_TASK_OPERATION 5006“operation”:表格 3-8 網(wǎng)關(guān)向認(rèn)證服務(wù)器請(qǐng)求任務(wù)參數(shù)2）網(wǎng)關(guān)向認(rèn)證服務(wù)器提交任務(wù)執(zhí)行結(jié)果，具體參數(shù)如下：表格 3-9 網(wǎng)關(guān)向認(rèn)證服務(wù)器提交任務(wù)執(zhí)行結(jié)果參數(shù)3.6用戶(hù)登錄用戶(hù)觸發(fā)登錄頁(yè)面，具體參數(shù)如下：12請(qǐng)求地址GEThttps:/auth-servort/api10/taskresult參數(shù)dev_id設(shè)備 IDmac系統(tǒng)導(dǎo)入的 MACtask_id任務(wù)類(lèi)型resul

19、t： OK | FAIL任務(wù)執(zhí)行結(jié)果message任務(wù)執(zhí)行結(jié)果說(shuō)明（大于 8個(gè)字符）返回?cái)?shù)據(jù)JSONresult: OK | FAIL, message:/用于完美酒店的設(shè)備上，默認(rèn)值為 2，體現(xiàn)在 3.4、 3.6、3.9 節(jié)的 operation 上SMARTWIFI_TASK_AWIFI_CTL 5007“awifiswitch”:”O(jiān)N|OFF”/其中 ON 表示開(kāi)，OFF 表示關(guān)，此開(kāi)關(guān)針對(duì)的是 awifi 熱點(diǎn)，注意與 5004 任務(wù)劃分清楚表格 3-10 用戶(hù)觸發(fā)登錄頁(yè)面參數(shù)3.7用戶(hù)認(rèn)證1）頁(yè)面向網(wǎng)關(guān)提交用戶(hù)上網(wǎng)令牌，具體參數(shù)如下：表格 3-11 頁(yè)面向網(wǎng)關(guān)提交用戶(hù)上網(wǎng)令牌參數(shù)

20、2）網(wǎng)關(guān)向認(rèn)證服務(wù)器提交令牌驗(yàn)證，具體參數(shù)如下：表格 3-12 網(wǎng)關(guān)向認(rèn)證服務(wù)器提交令牌驗(yàn)證參數(shù)13請(qǐng)求地址GEThttps:/auth-servort/api10/auth參數(shù)stage=login上網(wǎng)請(qǐng)求類(lèi)型ip上網(wǎng)設(shè)備 IPmac上網(wǎng)設(shè)備 MACtoken臨時(shí)令牌ing客戶(hù)端下行流量outgoing客戶(hù)端上行流量返回?cái)?shù)據(jù)StringAuth: -1(error) | 0(denied) | 1(allowed)請(qǐng)求地址GET參數(shù)token臨時(shí)令牌url第一次請(qǐng)求的上網(wǎng)地址返回?cái)?shù)據(jù)無(wú)請(qǐng)求地址GET參數(shù)dev_id設(shè)備 IDcnt_mac上網(wǎng)設(shè)備 MAC 地址gw_address網(wǎng)關(guān) IP

21、地址gw_port網(wǎng)關(guān)端gw_id設(shè)備主機(jī)名url第一次請(qǐng)求的上網(wǎng)地址operation前向運(yùn)營(yíng)位，value 為 2返回?cái)?shù)據(jù)3.8WiFi 門(mén)戶(hù)認(rèn)證成功后網(wǎng)關(guān)重定向到WiFi 門(mén)戶(hù)頁(yè)面，具體參數(shù)如下：表格 3-13 認(rèn)證成功后網(wǎng)關(guān)重定向到WiFi 門(mén)戶(hù)頁(yè)面參數(shù)3.9終端心跳網(wǎng)關(guān)定期向認(rèn)證服務(wù)器提交終端狀態(tài)信息，具體參數(shù)如下：表格 3-14 網(wǎng)關(guān)定期向認(rèn)證服務(wù)器提交終端狀態(tài)信息參數(shù)3.10用戶(hù)下線(xiàn)1）用戶(hù)通過(guò)終端網(wǎng)關(guān)請(qǐng)求下線(xiàn)，具體參數(shù)如下：14請(qǐng)求地址GET參數(shù)token臨時(shí)令牌請(qǐng)求地址GEThttps:/auth-servort/api10/auth參數(shù)stage=counters請(qǐng)求狀態(tài)為

22、上報(bào)信息ip上網(wǎng)設(shè)備 IPmac上網(wǎng)設(shè)備 MACtoken臨時(shí)令牌ing客戶(hù)端下行流量outgoing客戶(hù)端上行流量gw_id設(shè)備主機(jī)名operation前向運(yùn)營(yíng)位，value 為 2返回?cái)?shù)據(jù)StringAuth: -1(error) | 0(denied) | 1(allowed) | 6(failed)請(qǐng)求地址GET參數(shù)dev_id設(shè)備 IDgw_id設(shè)備主機(jī)名url第一次請(qǐng)求上網(wǎng)的 url返回?cái)?shù)據(jù)表格 3-15 用戶(hù)通過(guò)終端網(wǎng)關(guān)請(qǐng)求下線(xiàn)參數(shù)2）網(wǎng)關(guān)向認(rèn)證服務(wù)器提交用戶(hù)下線(xiàn)信息，具體參數(shù)如下：表格 3-16 網(wǎng)關(guān)向認(rèn)證服務(wù)器提交用戶(hù)下線(xiàn)信息參數(shù)3.11行為日志上報(bào)設(shè)備定期向日志服務(wù)器上報(bào)用

23、戶(hù)上網(wǎng)行為日志，具體參數(shù)如下：15請(qǐng)求地址Thttps:/log-servort/api10/upload參數(shù)gw_id;pubinfo dev_id:002293aabb07, “compres”: none ( zip, .) logs: “time”:“2014/07/21/18:23:33”,“user”:”,“c nt_mac”:”12323232”, “l(fā)og_type”:”1“，“l(fā)og_value”:”ht”,請(qǐng)求地址GEThttps:/auth-servort/api10/auth參數(shù)stage=logout請(qǐng)求狀態(tài)為下線(xiàn)信息ip上網(wǎng)設(shè)備 IPmac上網(wǎng)設(shè)備 MACtoken

24、臨時(shí)令牌ing客戶(hù)端下行流量outgoing客戶(hù)端上行流量返回?cái)?shù)據(jù)StringAuth: -1(error) | 0(denied) | 1(allowed)logout單個(gè)終端用戶(hù)下線(xiàn)請(qǐng)求返回?cái)?shù)據(jù)無(wú)表格 3-17 設(shè)備定期向日志服務(wù)器上報(bào)用戶(hù)上網(wǎng)行為日志參數(shù)3.12系統(tǒng)升級(jí)3.12.1 Uboot 工作原理1）uboot 雙系統(tǒng)（方案一）本系統(tǒng)要求升級(jí)kernel，升級(jí)過(guò)程中不確定可能導(dǎo)致網(wǎng)關(guān)升級(jí)失敗。為防止升級(jí)失敗導(dǎo)致產(chǎn)品故障，特引入雙系統(tǒng)自動(dòng)修復(fù)功能。請(qǐng)按下面的邏輯流程設(shè)計(jì)uboot引導(dǎo)方案。整個(gè)路由系統(tǒng)由uboot+Kernel1（以下簡(jiǎn)稱(chēng)K1）+Kernel2（以下簡(jiǎn)稱(chēng)K2）組成，雙

25、系統(tǒng)涉及到uboot的訂制，訂制uboot的工作流程圖如下：16 “time”:“2014/07/21/18:23:33”,“user”:”,“c nt_mac”:”123232233”, “l(fā)og_type”:”1“，“l(fā)og_value”:”h”返回?cái)?shù)據(jù)JSONresult: OK | FAIL message:校驗(yàn)K1是否完整否是判斷K1=K2否是圖 3-1 Uboot 啟動(dòng) kernel 流程方案一設(shè)計(jì)說(shuō)明：因本系統(tǒng)要求急方案。2）uboot 雙系統(tǒng)（方案二）升級(jí)kernel,故設(shè)計(jì)雙kernel做為升級(jí)失敗的應(yīng)否判斷data分區(qū)啟動(dòng)標(biāo)志位3是是否重啟次數(shù)3次,且延時(shí)后不在2點(diǎn)5點(diǎn)是否

26、是否否服務(wù)器應(yīng)答立即升級(jí)超時(shí)或是否是流量小于10KB/s延時(shí)3次否是否執(zhí)行 Sysupgrade成功否次數(shù)3是是圖 3-3 升級(jí)流程圖2）計(jì)劃任務(wù)使用計(jì)劃任務(wù)（2點(diǎn)5點(diǎn)）觸發(fā)網(wǎng)關(guān)向服務(wù)器請(qǐng)求升級(jí)事件：網(wǎng)關(guān)以MAC地址后2位為機(jī)延時(shí)產(chǎn)生隨機(jī)數(shù)，使升級(jí)請(qǐng)求在2:00-5:00范圍內(nèi)隨網(wǎng)關(guān)向服務(wù)器發(fā)送請(qǐng)求開(kāi)始升級(jí)檢查當(dāng)前流量是否小于10KB/s（5分鐘內(nèi)），如果是則進(jìn)行下一步3） http 請(qǐng)求格式網(wǎng)關(guān)第一次請(qǐng)求實(shí)例：19結(jié)束升級(jí)上報(bào)當(dāng)前固件版本重啟路由器寫(xiě)日志延時(shí)20分鐘寫(xiě)日志AP固件返回URL返回響應(yīng)碼延時(shí)20分鐘隨機(jī)延時(shí)發(fā)送請(qǐng)求計(jì)劃任務(wù)觸發(fā)升級(jí)程序具體參數(shù)說(shuō)明：表格 3-19 網(wǎng)關(guān)第一次請(qǐng)求實(shí)

27、例參數(shù)對(duì) rdMD5 中 key 的說(shuō)明：升級(jí)請(qǐng)求服務(wù)器的 url：20upgrade/update do key：2b71da2b1fbe1fa24db4ee8f9354c818key=2b71da2b1fbe1fa24db4ee8f9354c818(key 由WiFi 中心 指定，此處為樣例) 對(duì)applyid=123456789&key=2b71da2b1fbe1fa24db4ee8f9354c818串進(jìn)行 MD5 求值，并將計(jì)算得到的 MD5 作為rdMd5 值當(dāng)做參數(shù)發(fā)送給服務(wù)器參數(shù)備注chinanet.txt廠(chǎng)商自己定義該文件名字，用于存放服務(wù)器返回的消息url網(wǎng)關(guān)請(qǐng)求服務(wù)器地址v

28、erfirmware 版本號(hào)devid設(shè)備id(在綁定的設(shè)備識(shí)別碼)m設(shè)備型號(hào)HDver硬件版本號(hào)r供應(yīng)商city城市(預(yù)留)applyid為隨機(jī)生成數(shù)，考慮使用 long 類(lèi)型的時(shí)間值rdMD5為 ap與key 的md5 計(jì)算值wget c O /tmp/chinanet.txturl?devid=&ve=V1.0.0&m=chinanet-7620n&Hdve=&r=zte&city=310000&applyid=123456789&rdMD5=519fcfa3e4b0622a f2a8ae3261c4768b服務(wù)器返回：表格 3-20 服務(wù)器返回參數(shù)網(wǎng)關(guān)第二次請(qǐng)求實(shí)例：具體參數(shù)說(shuō)明：表格

29、3-21 網(wǎng)關(guān)第二次請(qǐng)求實(shí)例參數(shù)4）開(kāi)機(jī)上報(bào)版本號(hào)：21參數(shù)備注devid設(shè)備IDver當(dāng)前版本mac設(shè)備mac地址參數(shù)備注url網(wǎng)關(guān)固件地址wget -c -O /tmp/chinanet.bin “url”參數(shù)備注retCode返回碼（錯(cuò)誤的情況下才會(huì)使用此參數(shù)，返回格式直接是返回碼，如 0001，若正確，則服務(wù)器返回固件升級(jí) url 地址）0001版本號(hào)為空0002設(shè)備型號(hào)為空0003隨機(jī)請(qǐng)求數(shù)為空0004請(qǐng)求 MD5 為空0005MD5 值比對(duì)錯(cuò)誤0006系統(tǒng) MD5 值計(jì)算異常0007設(shè)備型號(hào)或硬件版本號(hào)在服務(wù)器中無(wú)版本信息0008服務(wù)器主動(dòng)放棄網(wǎng)關(guān)請(qǐng)求0009網(wǎng)關(guān)固件版本號(hào)與服務(wù)器

30、上固件版本號(hào)相同或更高表格3-22 開(kāi)機(jī)上報(bào)版本號(hào)參數(shù)實(shí)例：3.13提供watchdogWiFidog 等服務(wù)進(jìn)程提供WiFidog 守護(hù)進(jìn)程,一旦WiFidog 運(yùn)行出現(xiàn)問(wèn)題的時(shí)候自動(dòng)重啟WiFidog服務(wù) 修改wifidog閑時(shí)下線(xiàn)時(shí)間為30分鐘修改方法如下：編譯wifidog.conf，將內(nèi)容為Check的地方改為如下參數(shù)：erval,CntTimeout當(dāng)WiFidog與服務(wù)器連接失敗，默認(rèn)放行（原WiFidog自帶此功能）3.14lan 口免認(rèn)證當(dāng)用戶(hù)使用WiFi 連接網(wǎng)關(guān)上網(wǎng)時(shí)需要進(jìn)行認(rèn)證流程；而當(dāng)用戶(hù)使用網(wǎng)線(xiàn)連接網(wǎng)關(guān)的 lan 口時(shí)可直接上網(wǎng)，無(wú)需登陸 portal 頁(yè)面及后繼的

31、認(rèn)證操作。3.15DHCP 設(shè)置商戶(hù)自用aWiFi起止地址為: 192.168.125 115- 10起止地址為: 192.168.10 51 - 192.168.10 250租期固定為30分鐘3.16雙第一個(gè)為用戶(hù)自用: 如abcde. 通過(guò)此上線(xiàn)用戶(hù)采用普通認(rèn)證，缺省名為“chinanet”第二個(gè)到“aWiFi”時(shí)，不為“aWiFi”，上網(wǎng)用戶(hù)接入采用portal認(rèn)證，且當(dāng)用戶(hù)連接路配置頁(yè)面注：為了與原先兼容，aWiFi的修改仍然采用下發(fā)，由于原先只有一個(gè)，現(xiàn)在是雙，網(wǎng)關(guān)處理時(shí)，需要做相應(yīng)的修改，采用uci來(lái)設(shè)置相22Checerval60CntTimeout30wget url?devi

32、d=&ve=V1.0.0url :upgrade/conve.do應(yīng)的。TCP option 帶終端 MAC 信息3.17TCP option key 值（kind）： 0 xc8；TCP option 長(zhǎng)度： 0 x10；內(nèi)容： 光貓 MAC +F + 終端 MAC， 長(zhǎng)度 14 個(gè)字節(jié)；作用范圍：aWiFi 端口下掛終端，對(duì)傳統(tǒng)光貓業(yè)務(wù)不起作用。234 設(shè)備要求廠(chǎng)家必須按照愛(ài) WiFi 的要求，將信息以面。的形式貼于相應(yīng)的終端外殼背內(nèi)容包含：登錄、服務(wù)、設(shè)備名稱(chēng)、設(shè)備型號(hào)、固件版本、電源、配具體址、配置、S/N 以及（包含+MAC 地址）。示意圖如下：尺寸為厘米厘米。圖 4-1 路由器信息

33、地址定義為下：http:/oms/pang/bind.htm?mac=其中“http:/oms/pang/bind.htm?mac=”為固定，MAC 地址每臺(tái)設(shè)備不同。終端外殼正面應(yīng)有愛(ài)WiFi 圖標(biāo)，尺寸為 3 厘米1 厘米。242B 客戶(hù)端配置路由接口協(xié)議接口通用說(shuō)明所有接口都以 HTTP 協(xié)議并且以 get 方法傳輸所有接口都返回 JSON 格式數(shù)據(jù)所有返回的字段無(wú)論何時(shí)都存在，只是失敗時(shí)可能為空路由器接口形式：5. 所有的請(qǐng)求響應(yīng)都是小寫(xiě)字母5.2接口詳情5.2.1登錄路由器:loginRouter接口類(lèi)型：路由器接口說(shuō)明：調(diào)用該接口，輸入?yún)?shù)用戶(hù)名和錯(cuò)誤則返回相對(duì)應(yīng)的錯(cuò)誤信息。請(qǐng)求參

34、數(shù)：，驗(yàn)證正確后，給與成功的返回，表格 5-1 登錄路由器接口請(qǐng)求參數(shù)響應(yīng)參數(shù)：表格 5-2 登錄路由器接口響應(yīng)參數(shù)25名稱(chēng)類(lèi)型說(shuō)明result整型0 成功 非 0 失敗msg字符串成功或失敗的消息名稱(chēng)類(lèi)型說(shuō)明username字符串必須passwd字符串必須http:/網(wǎng)關(guān) ip:2060/app/接口名調(diào)用示例：5.2.2設(shè)置上網(wǎng)方式:seternet接口類(lèi)型：路由器接口說(shuō)明：根據(jù)客戶(hù)端提交的上網(wǎng)方式類(lèi)型參數(shù)，設(shè)置路由器中的 wlan 的方式，同 web 設(shè)置頁(yè)面的第一步。請(qǐng)求參數(shù)：表格 5-3 設(shè)置上網(wǎng)方式接口請(qǐng)求參數(shù)響應(yīng)參數(shù)：表格 5-4 設(shè)置上網(wǎng)方式接口響應(yīng)參數(shù)26名稱(chēng)類(lèi)型說(shuō)明Resu

35、l t整型0 成功 非 0 失敗Msg字符串成功或失敗的消息名稱(chēng)類(lèi)型說(shuō)明type字符串1:DHCP2:PPPOE3:靜態(tài)地址ipaddress字符串當(dāng)選擇靜態(tài)地址時(shí)有效mask字符串當(dāng)選擇靜態(tài)地址時(shí)有效gateway字符串當(dāng)選擇靜態(tài)地址時(shí)有效dns字符串當(dāng)選擇靜態(tài)地址時(shí)有效username字符串當(dāng)選擇 PPPOE 時(shí)有效passwd字符串當(dāng)選擇 PPPOE 時(shí)有效URL：http:/網(wǎng)關(guān)地址:2060/app/ loginRouter?username=admin&passwd=admin ResponseBody:“result”:”0”,”msg”:”成功|失敗原因”調(diào)用示例：5.2.3設(shè)

36、置路由器內(nèi)網(wǎng):setNetwork接口類(lèi)型：路由器接口說(shuō)明：設(shè)置路由器本身的網(wǎng)絡(luò)參數(shù)，包括自身的等參數(shù)；同 web 設(shè)置第二步。請(qǐng)求參數(shù)：ip 地址，子網(wǎng)掩碼、網(wǎng)關(guān)表格 5-5 設(shè)置路由器內(nèi)網(wǎng)請(qǐng)求參數(shù)響應(yīng)參數(shù)：表格 5-6 設(shè)置路由器內(nèi)網(wǎng)響應(yīng)參數(shù)調(diào)用示例：27名稱(chēng)類(lèi)型說(shuō)明result整型0 成功 非 0 失敗msg字符串成功或失敗的消息名稱(chēng)類(lèi)型說(shuō)明Ipaddress字符串必須Mask字符串必須gateway字符串可選，保留，暫未使用URL:DHCP:http:/網(wǎng)關(guān)地址:2060/app/seternet? type=1PPPOE:http:/ 網(wǎng)關(guān)地址:2060/app/seternet?t

37、ype=2&username=& passwd=123456靜態(tài)地址: http:/網(wǎng)關(guān)地址:2060/app/seternet?type=3&ipaddress=16 進(jìn)制 IP 地址 & mask=16 進(jìn)制 IP 地址& gateway=16 進(jìn)制 IP 地址& dns=16 進(jìn)制 IP 地址 ResponseBody:“result”:”0”,”msg”:”成功失敗原因”5.2.4設(shè)置無(wú)線(xiàn)參數(shù):setWifi接口類(lèi)型：路由器接口說(shuō)明：設(shè)置路由器的 wifi 參數(shù)，包括號(hào)）、信道選擇；同 web 設(shè)置第三步。請(qǐng)求參數(shù)：、中文名（僅限支持的路由器型表格 5-7 設(shè)置無(wú)線(xiàn)參數(shù)請(qǐng)求參數(shù)響應(yīng)參數(shù)

38、：表格 5-8 設(shè)置無(wú)線(xiàn)參數(shù)請(qǐng)求參數(shù)調(diào)用示例：5.2.5獲取路由器登錄名：getLoginName接口類(lèi)型：路由器接口28URL: http:/ 網(wǎng)關(guān)地址 :2060/app/setWifi?=awifi&pwd=123456&name= 愛(ài) wifi& channel=11ResponseBody:“result”:”0”,”msg”:”成功|失敗原因”名稱(chēng)類(lèi)型說(shuō)明result整型0 成功 非 0 失敗msg字符串成功或失敗的消息名稱(chēng)類(lèi)型說(shuō)明字符串必須pwd字符串非必須name字符串非必須，中文名稱(chēng)channel字符串非必須，默認(rèn)自動(dòng)URL: http:/網(wǎng)關(guān)地址:2060/app/setN

39、etwork?ipaddress=16 進(jìn)制 IP 地址&mask=16 進(jìn)制IP 地址& gateway=16 進(jìn)制 IP 地址ResponseBody:“result”:”0”,”msg”:”成功|失敗原因”說(shuō)明：獲取路由器登錄名響應(yīng)參數(shù)：表格 5-9 獲取路由器登錄名響應(yīng)參數(shù)調(diào)用示例：5.2.6獲取路由器激活狀態(tài):getActiveSe接口類(lèi)型：路由器接口說(shuō)明：獲取路由器激活狀態(tài)響應(yīng)參數(shù)：表格 5-10 獲取路由器激活狀態(tài)響應(yīng)參數(shù)調(diào)用示例：5.2.7設(shè)置路由路登錄：setLoginPwd接口類(lèi)型：路由器接口說(shuō)明：設(shè)置路由器登錄29URL: http:/網(wǎng)關(guān)地址:2060/app/ get

40、ActiveSe ResponseBody:“result”:”0”,”msg”:”成功|失敗原因”,”data”:”1(已激活)|0(未激活)”名稱(chēng)類(lèi)型說(shuō)明result整型0 成功 非 0 失敗msg字符串成功或失敗的消息data字符型設(shè)備是否已經(jīng)激活URL: http:/網(wǎng)關(guān)地址:2060/app/getLoginName ResponseBody:“result”:”0”,”msg”:”成功|失敗原因”,”data”:”admin”名稱(chēng)類(lèi)型說(shuō)明result整型0 成功 非 0 失敗msg字符串成功或失敗的消息data字符串登錄名請(qǐng)求參數(shù)：表格 5-11 設(shè)置路由器登錄請(qǐng)求參數(shù)響應(yīng)參數(shù)：表

41、格 5-12 設(shè)置路由器登錄響應(yīng)參數(shù)調(diào)用示例：5.2.8重啟路由器:restart接口類(lèi)型：路由器接口說(shuō)明：重啟路由器響應(yīng)參數(shù)：表格5-13 重啟路由器響應(yīng)參數(shù)調(diào)用示例：30URL: http:/網(wǎng)關(guān)地址:2060/app/ restart ResponseBody:“result”:”0”,”msg”:”成功|失敗原因”名稱(chēng)類(lèi)型說(shuō)明result整型0 成功 非 0 失敗msg字符串成功或失敗的消息URL: http:/網(wǎng)關(guān)地址:2060/app/ setLoginPwd ResponseBody:“result”:”0”,”msg”:”成功|失敗原因”名稱(chēng)類(lèi)型說(shuō)明result整型0 成功 非

42、 0 失敗msg字符串成功或失敗的消息名稱(chēng)類(lèi)型說(shuō)明oldpasswd字符串必須nesswd字符串必須5.2.9恢復(fù)出廠(chǎng)設(shè)置: restore接口類(lèi)型：路由器接口說(shuō)明：恢復(fù)路由器出廠(chǎng)設(shè)置響應(yīng)參數(shù)：表格 5-14 恢復(fù)出廠(chǎng)設(shè)置響應(yīng)參數(shù)調(diào)用示例：5.2.10 獲取路由設(shè)備激活信息: getRegisterInfo接口類(lèi)型：路由器接口說(shuō)明：獲取路由器設(shè)備激活信息響應(yīng)參數(shù)：表格 5-15 獲取路由器設(shè)備激活信息響應(yīng)參數(shù)調(diào)用示例：31名稱(chēng)類(lèi)型說(shuō)明result整型0 成功 非 0 失敗msg字符串成功或失敗的消息gw_mac字符串路由的Wan 口mac 地址gw_address字符串路由的網(wǎng)關(guān)地址gw_port字符串路由端soft_ver字符串版本號(hào)URL: http:/網(wǎng)關(guān)地址:2060/app/ restore ResponseBody:“result”:”0”,”msg”:”成功|失敗原因”名稱(chēng)類(lèi)型說(shuō)明result整型0 成功 非 0 失敗msg字符串成功或失敗的消息32URL: http:/網(wǎng)關(guān)地址:2060/app/ getRegi