2015 SX-002
1) 日志文件要求是txt文本文件;
2) 本地日志文件提供至少存储500条日志的能力; 3) 所有日志文件要求保存在本地,保证断电不丢失;
4) 日志文件可以应ITMS+要求上传至ITMS+服务器,上传使用HTTP Post或
HTTP Put方式,上传后可以删除/清空; 5) 日志文件格式应符合附录B规定;
6) 日志中告警信息的记录应符合附录C规定。 8.1.4 设备标识要求
a) “爱WiFi”定制网关设备标识是唯一标识设备的参数,主要用途如下:
1) 终端综合管理系统唯一标识设备; 2) “爱WiFi”定制网关设备外壳标签标识。 b) “爱WiFi”定制网关设备标识定义见表3:
表3 “爱WiFi”定制网关设备标识定义
设备标识格式
配置文件应双备份,每个配置文件应具备CRC校验码进行合法性校验,配置文件应位于flash的两个不同块中,配置文件更新时应同时更新两个配置文件,读取配置时应使用CRC校验合法的那个配置文件。配置文件内容在设备内应加密保存。 8.1.6 设备注册认证功能
设备注册认证过程包括OLT注册和爱WiFi业务注册两个步骤。对于OLT注册流程,EPON上行设备应符合《中国电信EPON设备技术要求(V3.0)》要求,GPON上行设备应符合《中国电信GPON设备技术要求(V2.0)》要求。 8.1.6.1 OLT及ITMS+注册
当业务下发状态为初始值或下发失败(即
InternetGateway-29
2015 SX-002
Device.X_CT-COM_UserInfo.Result值为99或2),并且用户在PC上启动网页浏览器访问网站时,”爱WiFi”定制网关自动启动基于逻辑ID的设备注册认证功能:
a) 向用户PC强制推送逻辑ID设备注册认证页面
b) 检查认证重试次数(InternetGatewayDevice.X_CT-COM_UserInfo.Times)是否
超出限制(InternetGatewayDevice. X_CT-COM_ UserInfo.Limit) 1) 如果未超出限制,则按以下流程进行认证 — 引导用户输入逻辑ID
— 在未向OLT注册成功时,可利用该逻辑ID根据OLT的要求进行注册。 — 在向OLT注册成功并连接到ITMS+后,自动向ITMS+发起基于逻辑ID的设备
注册认证流程(InternetGatewayDevice.X_CT-COM_UserInfo.UserName的赋值等同LOID,将InternetGatewayDevice.X_CT-COM_UserInfo.UserId的赋值等同Password)
2) 如果已超出限制次数,则显示本功能不可用的原因,不允许进行逻辑ID输入,
并建议用户联系10000号。
基于逻辑ID的设备注册认证功能的用户提示信息要求参见附录F,认证流程的具体要求参见《中国电信家庭网关与增强型终端综合管理系统接口技术要求》附录F.22。认证过程中认证重试次数超出限制3分钟后自动清零,以允许用户重新进行认证。
在输入逻辑ID后,只要未注册成功,终端应在每次上电后向ITMS+发起基于逻辑ID的设备注册认证流程。
在用户每次修改逻辑ID后,应自动重新向OLT发起注册(可采取重启”爱WiFi”定制网关设备或只重启PON部分等方式)。
逻辑ID(包括LOID和Password)初始值为空,逻辑ID的修改在且仅在以下情况下被长期保存(其它情况下的修改仅在当次上电期间有效):
a) 在OLT或ITMS+首次注册成功前进行的任何修改
b) 首次注册成功后,通过本地界面修改逻辑ID且新的逻辑ID在OLT或ITMS+上注
册成功
c) 由ITMS+进行的远程修改 8.1.6.2 爱WiFi业务注册
应支持设备在“爱WiFi”管理平台的注册,注册要求应符合以下内容要求。
30
2015 SX-002
a) 注册流程
图2 WiFi终端注册流程图
流程描述:
① 装机员在WiFi终端上登录设备配置页面。 ② 设备推送配置界面。
③ 装机员在配置界面中点击“注册”,请求”爱WiFi”管理平台注册页面,消息要求见“b)注册请求”。
④ “爱WiFi”管理平台推送平台注册页面。
⑤ 装机员填入MAC、PIN码、用户名、密码等设备激活信息,并提交注册。
⑥ “爱WiFi”管理平台验证信息的正确性,验证成功时生成设备ID并返回WiFi终端;验证失败时,返回注册页面,执行步骤④。
⑦ 装机员看到设备ID生成后,点击“激活”按钮要求设备激活,消息要求见“c) 接收激活请求”。
⑧ 设备请求”爱WiFi”管理平台激活设备,消息要求见“d) 请求“爱WiFi”管理平台激活”。 ⑨ “爱WiFi”管理平台返回配置信息。
⑩ 设备返回激活结果页面给WiFi终端,消息要求见“e)响应激活请求”。
b) 注册请求
31
2015 SX-002
设备在使用”爱WiFi”业务之前,必须先注册到”爱WiFi”管理平台,注册消息要求如表4.
表4 注册请求
GET WiFi终端 请求协议头 Host GET /api10/register.htm? gw_address=<“爱WiFi”接口 IP地址>&gw_port=<“爱WiFi”组件监听端口>&gw_mac=<“爱WiFi”接口 mac地址>&soft_ver=<“爱WiFi”业务组件软件版本号> HTTP/1.1 “爱WiFi”管理平台IP地址 Request GET /api10/register.htm?gw_address=192.168.1.1&gw_port=2060&gw_mac=AABBCCDD1122&soft_ver=1.1.3 HTTP/1.1 实例 User-Agent: SmartWiFi 1.1.3 Host: 10.1.1.2 Response 注册页面 c) 接收激活请求
装机员提交注册后,WiFi管理平台分配设备标识,返回响应给装机员的控制台页面。控制台页面触发设备激活请求到设备,消息见表5。
表5 接收激活请求
WiFi终端 请求协议头 请求参数 dev_id “爱WiFi”管理平台分配给设备的标识。 Host GET GET /smartwifi/active?dev_id=<“爱WiFi”管理平台分配的设备身份标识> HTTP/1.1 设备”爱WiFi”业务组件IP地址 32
2015 SX-002 Request GET /smartwifi/active?dev_id=123dfdaefrer42334s HTTP/1.1 实例 User-Agent: SmartWiFi 1.1.3 Host: 192.168.1.1 d) 请求 “爱WiFi”管理平台激活,消息见表6.
表6 请求“爱WiFi”管理平台激活
GET GET /api10/register?dev_id=<“爱WiFi”管理平台分配的设备设备 身份标识>&mac=<“爱WiFi”接口MAC>&stage=active 请求HTTP/1.1 协议头 User-Agent 值为“SmartWiFi”+“协议的版本号”,中间用一个空格连接。 Host “爱WiFi”管理平台地址 dev_id “爱WiFi”管理平台分配给设备的标识。 请求mac “爱WiFi”业务的”爱WiFi”接口MAC地址 参数 stage 取值“active” Header HTTP/1.1 200 OK Body { “result”:<激活结果代码>, “message”:<激活结果描述>, “services”:{ “device_id”:<设备标识>, 响应 “account”:<用户名>, “active_date”:<激活日期> “servers”:{ “portals”:[{ “hostname”: