Tr069协议详情全参数模型报告材料

实用文案

标准文档 1 参数定义

定义 终端的TR-069 参数模型 主要参考两个文档 TR-106 和TR-135 ，TR-106 定义了基于TR-069管理的设备的通用数据模型，TR-135 定义了STB 的特定数据模型。

由于目前针对STB 的数据管理没有提出具体要求，因此暂不实现TR-135中定义的数据模型。

在数据模型中，凡参数中有X_STB字样的，均有扩展参数。读写属性的值(wrie, Read) ,如果为“R”，则该参数是可读或可写的，如果为”-“，则该参数是不可读或不可写的。若必选属性的值为”M”,则该参数是必须实现的，若为”O”，则该参数的实现是可选的。

1.1 数据模型

红色表示暂不实现

Name Type Write Read Description 必 选

Device. DeviceSummary string(1024) - R 设备描述 M

Device.CA Object CA卡的相关信息 M

Device. DeviceInfo object 终端的详细信息描述 M

Device.ManagementServer object 终端管理系统相关的参数 M

Device.Config object 终端普通配置参数。 O

Device.GatewayInfo object 终端连接的网关设备信息 O

Device.Time object 终端中 NTP 时间客户端相关的参数。 M

erInterface object 终端用户接口相关的参数。 O

N object 终端中基于IP的网络连接信息 M

N.DHCP object O

N.Stats object O

N. IPPingDiagnostics M

N.T raceRouteDiagnostics O

Device.Services object 终端中特定服务相关配置 O

Device.X_STB_Config object STB特定配置 M

Device.X_STB_Stats object 终端状态 M

Device.X_STB_Statistic object 性能统计 M

Device.X_STB_AudienceStats object 用户收视率采集 M

Device.X_STB_Software object 软件版本管理 M

Device.X_STB_Alarm Object 当前告警信息 M 实用文案

标准文档

1.2 CA卡的相关信息 Device.CA

Name Type Write Read Description 必选

Device.CA CA信息查询 M

CAVersion String(5k) R CA版本 M

CAProvider String(5k) R 运营商信息 M

CASerialNumber String(5k) R CA序列号 M

1.3 设备详细信息 Device. DeviceInfo

Name Type Write Read Description 必 选

Device. DeviceInfo. object - - 设备的详细信息描述 M

Manufacturer string(64) - R 终端制造商（意义可读的字符串）。 M

ManufacturerOUI string(6) - R 设备制造商组织体系唯一标识。表示为六位十六进制数值，全部采用大写字母并包括任意前导零。 M

ModelName string(64) - R 终端型号名称（意义可读的字符串）。 M

Description string(256) - R 终端 设备完全描述（意义可读的字符串）。 M

ProductClass string(64) - R 使用序列号的产品类别标识。即，对于指定的制造商，此参数用于标识产品或产品类别，其中

SerialNumber 参数是唯一的。 M

SerialNumber string(64) - R 终端 序列号 M

HardwareVersion string(64) - R 标识特定终端型号和版本的字符串。 M

SoftwareVersion string(64) - R 各厂商自定义版本的命名方式。 M

EnabledOptions string(1024) - R 采用逗号分隔的终端支持的Option名称列表 O

AdditionalHardwareVersion string(64) - R 任何附加版本以逗号分隔O 实用文案

标准文档 的列表。表示任何供应商希望提供的附加硬件版本信息。如果没有可以为空字符串。

AdditionalSoftwareVersion string(64) - R 任何附加版本以逗号分隔的列表。表示任何供应商希望提供的附加软件版本信息。如果没有可以为空字符串。 O

ProvisioningCode string(64) - R 主要服务提供商和其他供应信息的标识，服务器用来确定服务提供商特定的定制和供应参数。当发生改变时，需立即上报终端管理系统。 M

DeviceStatus string - R 终端当前可选状态：

“Up” ”Initializing”

“Error” “Disabled M

UpTime unsignedInt - R 一次重启后的时间（以秒计）。 M

FirstUseDate dateTime - R 终端 首次成功建立网络连接的日期和时间。

O

DeviceLog string(32K) - R 终端记录的日志信息 O

HardwareVersion为终端设备的版本/型号

SoftwareVersion为终端上主系统软件的版本,在eBox上为”主框架”的版本号.

1.4 网管信息参数 Device.ManagementServer

Name Type Write Read Description 必 选

Device.ManagementServer. object - - 此对象包含与 终端管理系统

相关的参数，此 终端管理系统 与终端关联。 M

URL string(256) R R 终端利用终端

WAN 管理协议连接

终端管理系统

的URL。此参数必须为有效的

HTTP 或 HTTPS URL [8].。HTTPS URL 表示终端管理系统支持 SSL。终端 使用此 URL

的“主机”部分，以便在使用基于认证的鉴权时确认 终端管理系统 认证。当发生改变时，需立即上报终端管理系M 实用文案

标准文档 统。

Username string(256) R R 当使用终端WAN 管理协议建立与 终端管理系统 的连接时使用的用户名，此用户名只在基于HTTP的认证时使用。默认值为”STBAdmin”，且大小写敏感。 M

Password string(256) R R 当使用终端WAN 管理协议建立与 终端管理系统 的连接时使用的鉴权密码。只有当终端不使用客户端基于认证的鉴权时，才会用到此密码。在被读取时，该参数会忽略实际值而返回一个空字符串。采用统一密码的方式，默认值为”STBAdmin”，且大小写敏感 M

PeriodicInformEnable boolean R R 终端是否必须利用 Inform

方法调用定时向服务器端发送终端信息。默认为true M

PeriodicInformInterval unsignedInt

[1:] R R 在PeriodicInformEnable 为真时，终端 必须尝试连接 终端管理系统 并调用 Inform

方法的时间间隔。默认为3600秒 M

PeriodicInformTime dateTime R R 决定终端发起Inform 方法调用的时间参考绝对值。 每个

Inform 调用必须在

PeriodicInformInterval 加或减此参考时间的整数倍时进行。默认为0001-01-01T00:00:00Z.,即不采用此值做为时间参考。 M

ParameterKey string(32) - R 来自于服务器的最新的

SetParameterValues

，AddObject 或

DeleteObject 方法调用的

ParameterKey 自变量数值。如果没有此类调用，此数值为空。 M

ConnectionRequestURL string(256) - R 终端管理系统 向终端发起连接请求通知时所使用的 HTTP

URL。其形式如下：http://host:port/path.URL

的“主机”部分可以是终端管M 实用文案

标准文档 理接口的 IP 地址，用以替代域名。

ConnectionRequestUsername string(256) R R 终端管理系统 向终端发起连接请求时，鉴权过程使用的用户名。默认为 “itms”。 M

ConnectionRequestPassword string(256) R R 终端管理系统 向终端发起连接请求时，鉴权过程使用的密码。在被读取时，该参数会忽略实际值而返回一个空字符串。默认为 “itms”。 M

UpgradesManaged boolean R R 指示终端管理系统是否控制终端的升级。如果为真 (1)，终端应只利用 终端管理系统

寻求可用的升级。如果为假

(0)，则终端可以使用其他方法进行升级。 M

KickURL string(256) R R 只有当终端支持Kick方法是使用。 O

DownloadProgressURL string(256) R R 只有当终端支持LAN侧的Web页面用于显示下载进度时使用。 O

1.5 设备普通配置参数 Device.Config

Name Type Write Read Description 必选

Device.Config. object － － 此对象包含普通配置参数。 O

PersistentData string(256) R R 必须贯穿终端重启的任意用户数据。 M

ConfigFile string(32K) － R 终端当前配置的转储。此参数启用了备份和存储最后一次终端的已知良好状态的能力。此参数返回一个定义终端状态的供应商特定文档。此文档必须能够在使用 SetParameterValues

将终端状态写回时恢复该状态。 M