浙江電信-愛wifi融合終端書v2.0

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

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

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

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

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

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

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

8、戶接入融合終端時使用默認值彈出 portal。默認 devid 見下表：4省份默認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 默認 devid 信息3.3網(wǎng)關(guān)1）設(shè)備觸發(fā)頁面，具體參數(shù)如下：5請求地址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版本返回數(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ā)頁面參數(shù)2）頁面向網(wǎng)關(guān)發(fā)起設(shè)備驗證，具體參數(shù)如下：表格 3-5頁面向網(wǎng)關(guān)發(fā)起設(shè)備驗證參數(shù)3）網(wǎng)關(guān)向認證服務(wù)器發(fā)起設(shè)備

11、驗證，具體參數(shù)如下：6請求地址GEThttps:/auth-servort/api10/register參數(shù)dev_id設(shè)備 IDmac網(wǎng)關(guān) MAC 地址stage=active激活返回數(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: 請求地址GET參數(shù)dev_id設(shè)備 ID返回數(shù)據(jù)表格

12、3-6 網(wǎng)關(guān)向認證服務(wù)器發(fā)起設(shè)備驗證參數(shù)3.4網(wǎng)關(guān)心跳網(wǎng)關(guān)定期向認證服務(wù)器提交設(shè)備狀態(tài)，具體參數(shù)如下：7請求地址GEThttps:/auth-servort/api10/參數(shù)dev_id設(shè)備 IDgw_id設(shè)備主機名sys_uptime設(shè)備開機時間sys_memfree系統(tǒng)當(dāng)前可用內(nèi)存sys_load系統(tǒng)負載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)定期向認證服務(wù)器提交設(shè)備狀態(tài)參數(shù)3.5網(wǎng)關(guān)管理1）網(wǎng)關(guān)向認證服務(wù)器請求任務(wù)，具體參數(shù)如下：8請求地址GEThttps:/auth-servort/api10/taskrequest參數(shù)dev_id設(shè)備 IDmac系統(tǒng)導(dǎo)入的 MAC返回數(shù)據(jù)JSONresult: OK | FAIL, message:, task: task_id: xx task_code: task_params: file:/xx.imgtask_code: SMARTWIFI_TASK_REBOOT1000 *Wi-Fi 名稱wan_ipWAN 口 IPwan_protoWAN 口協(xié)議soft_verWi

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

15、將非愛 wifi 的 修改為 KFC-101，即去掉 aWiFi-字段SMARTWIFI_TASK_SYSUPGRADE 3000SMARTWIFI_TASK_TER_REFUSE 4001tokens: “x”,”,”SMARTWIFI_TASK_WHITE_LIST 4002mac: “”, “”/每次收到新的白 請求，先刪除原先所有白 內(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 表示進入逃生模式，F(xiàn)AIL 表示退出逃生模式，正常認證上網(wǎng)，time 表示退出逃生模式時間，即在開啟逃生模式內(nèi)如果 1800 秒后還沒接收到退出指令，自動退出，time 參數(shù)在 release 為 OK 時必須存在，F(xiàn)AIL 時，可選SMARTWIFI_TASK_WIFI_CONTROL 5004“wifiswitch”:”O(jiān)N|OFF”/其中 ON 表示開，OFF 表示關(guān)，此 開關(guān)針對的是非 awifi 熱點SMARTWIFI_TASK_LAN_CONTROL 5005“l(fā)answitch

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

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

20、2）網(wǎng)關(guān)向認證服務(wù)器提交令牌驗證，具體參數(shù)如下：表格 3-12 網(wǎng)關(guān)向認證服務(wù)器提交令牌驗證參數(shù)13請求地址GEThttps:/auth-servort/api10/auth參數(shù)stage=login上網(wǎng)請求類型ip上網(wǎng)設(shè)備 IPmac上網(wǎng)設(shè)備 MACtoken臨時令牌ing客戶端下行流量outgoing客戶端上行流量返回數(shù)據(jù)StringAuth: -1(error) | 0(denied) | 1(allowed)請求地址GET參數(shù)token臨時令牌url第一次請求的上網(wǎng)地址返回數(shù)據(jù)無請求地址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è)備主機名url第一次請求的上網(wǎng)地址operation前向運營位，value 為 2返回數(shù)據(jù)3.8WiFi 門戶認證成功后網(wǎng)關(guān)重定向到WiFi 門戶頁面，具體參數(shù)如下：表格 3-13 認證成功后網(wǎng)關(guān)重定向到WiFi 門戶頁面參數(shù)3.9終端心跳網(wǎng)關(guān)定期向認證服務(wù)器提交終端狀態(tài)信息，具體參數(shù)如下：表格 3-14 網(wǎng)關(guān)定期向認證服務(wù)器提交終端狀態(tài)信息參數(shù)3.10用戶下線1）用戶通過終端網(wǎng)關(guān)請求下線，具體參數(shù)如下：14請求地址GET參數(shù)token臨時令牌請求地址GEThttps:/auth-servort/api10/auth參數(shù)stage=counters請求狀態(tài)為

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

23、戶上網(wǎng)行為日志，具體參數(shù)如下：15請求地址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”,請求地址GEThttps:/auth-servort/api10/auth參數(shù)stage=logout請求狀態(tài)為下線信息ip上網(wǎng)設(shè)備 IPmac上網(wǎng)設(shè)備 MACtoken

24、臨時令牌ing客戶端下行流量outgoing客戶端上行流量返回數(shù)據(jù)StringAuth: -1(error) | 0(denied) | 1(allowed)logout單個終端用戶下線請求返回數(shù)據(jù)無表格 3-17 設(shè)備定期向日志服務(wù)器上報用戶上網(wǎng)行為日志參數(shù)3.12系統(tǒng)升級3.12.1 Uboot 工作原理1）uboot 雙系統(tǒng)（方案一）本系統(tǒng)要求升級kernel，升級過程中不確定可能導(dǎo)致網(wǎng)關(guān)升級失敗。為防止升級失敗導(dǎo)致產(chǎn)品故障，特引入雙系統(tǒng)自動修復(fù)功能。請按下面的邏輯流程設(shè)計uboot引導(dǎo)方案。整個路由系統(tǒng)由uboot+Kernel1（以下簡稱K1）+Kernel2（以下簡稱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”返回數(shù)據(jù)JSONresult: OK | FAIL message:校驗K1是否完整否是判斷K1=K2否是圖 3-1 Uboot 啟動 kernel 流程方案一設(shè)計說明：因本系統(tǒng)要求急方案。2）uboot 雙系統(tǒng)（方案二）升級kernel,故設(shè)計雙kernel做為升級失敗的應(yīng)否判斷data分區(qū)啟動標(biāo)志位3是是否重啟次數(shù)3次,且延時后不在2點5點是否

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

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

28、erfirmware 版本號devid設(shè)備id(在綁定的設(shè)備識別碼)m設(shè)備型號HDver硬件版本號r供應(yīng)商city城市(預(yù)留)applyid為隨機生成數(shù)，考慮使用 long 類型的時間值rdMD5為 ap與key 的md5 計算值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)第二次請求實例：具體參數(shù)說明：表格

29、3-21 網(wǎng)關(guān)第二次請求實例參數(shù)4）開機上報版本號：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返回碼（錯誤的情況下才會使用此參數(shù)，返回格式直接是返回碼，如 0001，若正確，則服務(wù)器返回固件升級 url 地址）0001版本號為空0002設(shè)備型號為空0003隨機請求數(shù)為空0004請求 MD5 為空0005MD5 值比對錯誤0006系統(tǒng) MD5 值計算異常0007設(shè)備型號或硬件版本號在服務(wù)器中無版本信息0008服務(wù)器主動放棄網(wǎng)關(guān)請求0009網(wǎng)關(guān)固件版本號與服務(wù)器

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

31、認證操作。3.15DHCP 設(shè)置商戶自用aWiFi起止地址為: 192.168.125 115- 10起止地址為: 192.168.10 51 - 192.168.10 250租期固定為30分鐘3.16雙第一個為用戶自用: 如abcde. 通過此上線用戶采用普通認證，缺省名為“chinanet”第二個到“aWiFi”時，不為“aWiFi”，上網(wǎng)用戶接入采用portal認證，且當(dāng)用戶連接路配置頁面注：為了與原先兼容，aWiFi的修改仍然采用下發(fā)，由于原先只有一個，現(xiàn)在是雙，網(wǎng)關(guān)處理時，需要做相應(yīng)的修改，采用uci來設(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 長度： 0 x10；內(nèi)容： 光貓 MAC +F + 終端 MAC， 長度 14 個字節(jié)；作用范圍：aWiFi 端口下掛終端，對傳統(tǒng)光貓業(yè)務(wù)不起作用。234 設(shè)備要求廠家必須按照愛 WiFi 的要求，將信息以面。的形式貼于相應(yīng)的終端外殼背內(nèi)容包含：登錄、服務(wù)、設(shè)備名稱、設(shè)備型號、固件版本、電源、配具體址、配置、S/N 以及（包含+MAC 地址）。示意圖如下：尺寸為厘米厘米。圖 4-1 路由器信息

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

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

35、l t整型0 成功 非 0 失敗Msg字符串成功或失敗的消息名稱類型說明type字符串1:DHCP2:PPPOE3:靜態(tài)地址ipaddress字符串當(dāng)選擇靜態(tài)地址時有效mask字符串當(dāng)選擇靜態(tài)地址時有效gateway字符串當(dāng)選擇靜態(tài)地址時有效dns字符串當(dāng)選擇靜態(tài)地址時有效username字符串當(dāng)選擇 PPPOE 時有效passwd字符串當(dāng)選擇 PPPOE 時有效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接口類型：路由器接口說明：設(shè)置路由器本身的網(wǎng)絡(luò)參數(shù)，包括自身的等參數(shù)；同 web 設(shè)置第二步。請求參數(shù)：ip 地址，子網(wǎng)掩碼、網(wǎng)關(guān)表格 5-5 設(shè)置路由器內(nèi)網(wǎng)請求參數(shù)響應(yīng)參數(shù)：表格 5-6 設(shè)置路由器內(nèi)網(wǎng)響應(yīng)參數(shù)調(diào)用示例：27名稱類型說明result整型0 成功 非 0 失敗msg字符串成功或失敗的消息名稱類型說明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 進制 IP 地址 & mask=16 進制 IP 地址& gateway=16 進制 IP 地址& dns=16 進制 IP 地址 ResponseBody:“result”:”0”,”msg”:”成功失敗原因”5.2.4設(shè)置無線參數(shù):setWifi接口類型：路由器接口說明：設(shè)置路由器的 wifi 參數(shù)，包括號）、信道選擇；同 web 設(shè)置第三步。請求參數(shù)：、中文名（僅限支持的路由器型表格 5-7 設(shè)置無線參數(shù)請求參數(shù)響應(yīng)參數(shù)

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

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

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

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

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