Tr069協(xié)議參數(shù)模型

1、1參數(shù)定義定義終端的TR-069參數(shù)模型主要參考兩個文檔TR-106和TR-135,TR-106定義了基于TR-069管理的設(shè)備的通用數(shù)據(jù)模型，TR-135定義了STB的特定數(shù)據(jù)模型。由于目前針對STB的數(shù)據(jù)管理沒有提出具體要求，因此暫不實(shí)現(xiàn)TR-135中定義的數(shù)據(jù)模型。在數(shù)據(jù)模型中，凡參數(shù)中有X_STB字樣的，均有擴(kuò)展參數(shù)。讀寫屬性的值(wrie,Read),如果為“R”，則該參數(shù)是可讀或可寫的，如果為”-“，則該參數(shù)是不可讀或不可寫的。若必選屬性的值為”M”,則該參數(shù)是必須實(shí)現(xiàn)的，若為”O(jiān)”，則該參數(shù)的實(shí)現(xiàn)是可選的。1.1數(shù)據(jù)模型紅色表示暫不實(shí)現(xiàn)NameTypeWriteReadDescr

2、iption必選DeviceDeviceSummarystring(1024)R設(shè)備描述MDeviceCAObjectCA卡的相關(guān)信息MDeviceDeviceinfoobject終端的詳細(xì)信息描述MDeviceManagementServerobject終端管理系統(tǒng)相關(guān)的參數(shù)MDevice.Configobject終端普通配置參數(shù)。ODevice.Gatewaylnfoobject終端連接的網(wǎng)關(guān)設(shè)備信息ODevice.Timeobject終端中NTP時間客戶端相關(guān)的參數(shù)。MDevice.UserInterfaceobject終端用戶接口相關(guān)的參數(shù)。ODevice.LANobject終端中基于

3、IP的網(wǎng)絡(luò)連接信息MDevice.LAN.DHCPobjectODevice.LAN.StatsobjectODevice.LAN.IPPingDiagnosticsMDevice.LAN.TraceRouteDiagnosticsODevice.Servicesobject終端中特定服務(wù)相關(guān)配置ODevice.XSTBConfigobjectSTB特定配置MDevice.XSTBStatsobject終端狀態(tài)MDevice.XSTBStatisticobject性能統(tǒng)計MDevice.XSTBAudienceStatsobject用戶收視率采集MDevice.XSTBSoftwareobje

4、ct軟件版本管理MDevice.XSTBAlarmObject當(dāng)前告警信息M1.2CA卡的相關(guān)信息Device.CANameTypeWriteReadDevice.CACAVersionString(5k)DescriptionCA信息查詢CA版本必選MMCAProviderString(5k)R運(yùn)營商信息RCA序列號CASerialNumberString(5k)1.3設(shè)備詳細(xì)信息Device.DeviceInfoNameTypeWriteReadDescription必選DeviceDeviceInfo.object設(shè)備的詳細(xì)信息描述MManufacturerstring(64)R終端制造

5、商（意義可讀的字符串）。MManufacturerOUIstring(6)R設(shè)備制造商組織體系唯一標(biāo)識。表示為六位十六進(jìn)制數(shù)值,全部采用大寫字母并包括任意前導(dǎo)零。MModelNamestring(64)一R終端型號名稱（意義可讀的字符串）。MDescriptionstring(256)R終端設(shè)備完全描述（意義可讀的字符串）。MProductClassstring(64)R使用序列號的產(chǎn)品類別標(biāo)識。即,對于指定的制造商，此參數(shù)用于標(biāo)識產(chǎn)品或產(chǎn)品類別，其中SerialNumber參數(shù)是唯一的。MSerialNumberstring(64)R終端序列號MHardwareVersionstring(6

6、4)R標(biāo)識特定終端型號和版本的字符串。MSoftwareVersionstring(64)R各廠商自定義版本的命名方式。MEnabledOptionsstring(1024)一R采用逗號分隔的終端支持的Option名稱列表OAdditionalHardwareVersionstring(64)R任何附加版本以逗號分隔的列表。表示任何供應(yīng)商希望提供的附加硬件版本信息。如果沒有可以為空字符串。OAdditionalSoftwareVersionstring(64)R任何附加版本以逗號分隔的列表。表示任何供應(yīng)商希望提供的附加軟件版本信息。如果沒有可以為空字符串。OProvisioningCodest

7、ring(64)R主要服務(wù)提供商和其他供應(yīng)信息的標(biāo)識，服務(wù)器用來確定服務(wù)提供商特定的定制和供應(yīng)參數(shù)。當(dāng)發(fā)生改變時，需立即上報終端管理系統(tǒng)。MDeviceStatusstringR終端當(dāng)前可選狀態(tài)：“Up”Initializing”“Error”“DisabledMUpTimeunsignedInt一R一次重啟后的時間（以秒計）。MFirstUseDatedateTime一R終端首次成功建立網(wǎng)絡(luò)連接的日期和時間。ODeviceLogstring(32K)一R終端記錄的日志信息OHardwareVersion為終端設(shè)備的版本/型號SoftwareVersion為終端上主系統(tǒng)軟件的版本，在eBox上

8、為”主框架”的版本號.1.4網(wǎng)管信息參數(shù)Device.ManagementServerNameTypeWriteReadDescription必選DeviceManagementServerobject此對象包含與終端管理系統(tǒng)相關(guān)的參數(shù)，此終端管理系統(tǒng)與終端關(guān)聯(lián)。MURLstring(256)RR終端利用終端WAN管理協(xié)議連接終端管理系統(tǒng)的URL。此參數(shù)必須為有效的HTTP或HTTPSURL8.。HTTPSURL表示終端管理系統(tǒng)支持SSL。終端使用此URL的“主機(jī)”部分，以便在使用基于認(rèn)證的鑒權(quán)時確認(rèn)終端管理系統(tǒng)認(rèn)證。當(dāng)發(fā)生改變M時，需立即上報終端管理系統(tǒng)。Usernamestring(256

9、)RR當(dāng)使用終端WAN管理協(xié)議建立與終端管理系統(tǒng)的連接時使用的用戶名，此用戶名只在基于HTTP的認(rèn)證時使用。默認(rèn)值為”STBAdmin”，且大小寫敏感。MPasswordstring(256)RR當(dāng)使用終端WAN管理協(xié)議建立與終端管理系統(tǒng)的連接時使用的鑒權(quán)密碼。只有當(dāng)終端不使用客戶端基于認(rèn)證的鑒權(quán)時，才會用到此密碼。在被讀取時，該參數(shù)會忽略實(shí)際值而返回一個空字符串。采用統(tǒng)一密碼的方式，默認(rèn)值為”STBAdmin”，且大小寫敏感MPeriodicInformEnablebooleanRR終端是否必須利用Inform方法調(diào)用定時向服務(wù)器端發(fā)送終端信息。默認(rèn)為trueMPeriodicInforml

10、ntervalunsignedInt1：RR在PeriodicInformEnable為真時，終端必須嘗試連接終端管理系統(tǒng)并調(diào)用Inform方法的時間間隔。默認(rèn)為3600秒MPeriodicInformTimedateTimeRR決定終端發(fā)起Inform方法調(diào)用的時間參考絕對值。每個Inform調(diào)用必須在PeriodicInformInterval加或減此參考時間的整數(shù)倍時進(jìn)行。默認(rèn)為00010101T00:00:00Z.,即不采用此值做為時間參考。MParameterKeystring(32)R來自于服務(wù)器的最新的SetParameterValues，AddObject或DeleteObje

11、ct方法調(diào)用的ParameterKey自變量數(shù)值。如果沒有此類調(diào)用，此數(shù)值為空。MConnectionRequestURLstring(256)R終端管理系統(tǒng)向終端發(fā)起連接請求通知時所使用的HTTPURL。其形式如下：Mhttp:/host:port/path.URL的“主機(jī)”部分可以是終端管理接口的IP地址，用以替代域名。ConnectionRequestUsernamestring(256)RR終端管理系統(tǒng)向終端發(fā)起連接請求時，鑒權(quán)過程使用的用戶名。默認(rèn)為“itms”。MConnectionRequestPasswordstring(256)RR終端管理系統(tǒng)向終端發(fā)起連接請求時，鑒權(quán)過程使

12、用的密碼。在被讀取時，該參數(shù)會忽略實(shí)際值而返回一個空字符串。默認(rèn)為“itms”。MUpgradesManagedbooleanRR指示終端管理系統(tǒng)是否控制終端的升級。如果為真(1)，終端應(yīng)只利用終端管理系統(tǒng)尋求可用的升級。如果為假(0)，則終端可以使用其他方法進(jìn)行升級。MKickURLstring(256)RR只有當(dāng)終端支持Kick方法是使用。ODownloadProgressURLstring(256)RR只有當(dāng)終端支持LAN側(cè)的Web頁面用于顯示下載進(jìn)度時使用。O1.5設(shè)備普通配置參數(shù)Device.ConfigNameTypeWriteReadDescription必選Device.Con

13、fig.object此對象包含普通配置參數(shù)。OPersistentDatastring(256)RR必須貫穿終端重啟的任意用戶數(shù)據(jù)。MConfigFilestring(32K)R終端當(dāng)前配置的轉(zhuǎn)儲。此參數(shù)啟用了備份和存儲最后一次終端的已知良好狀態(tài)的能力。此參數(shù)返回一個定義終端狀態(tài)的供應(yīng)商特定文檔。此文檔必須能夠在使用SetParameterValues將終端狀態(tài)寫回時恢復(fù)該狀態(tài)。M網(wǎng)關(guān)信息Device.GatewayInfoNameTypeWriteReadDescription必選Device.GatewayInfo.object這個對象包含有已連接的網(wǎng)關(guān)設(shè)備的信息OManufacturer

14、OUIstring(6)R相關(guān)網(wǎng)關(guān)設(shè)備的0UI?？兆址畼?biāo)識沒有監(jiān)測到相關(guān)的網(wǎng)關(guān)設(shè)備。MProductClassstring(64)R用于標(biāo)識相關(guān)網(wǎng)關(guān)設(shè)備的產(chǎn)品類型?？兆址畼?biāo)識沒有監(jiān)測到相關(guān)網(wǎng)關(guān)設(shè)備。MSerialNumberstring(64)R用于標(biāo)識相關(guān)網(wǎng)關(guān)設(shè)備的序列號。空字符串標(biāo)識沒有監(jiān)測到相關(guān)網(wǎng)關(guān)設(shè)備。M時間配置參數(shù)Device.TimeNameTypeWriteReadDescription必選Device.Timeobject此對象包含與終端中NTP時間客戶端相關(guān)的參數(shù)。是否支持此對象是可選的。MNTPServerlstring(64)RR第一個NTP時間服務(wù)器。可以為域名或I

15、P地址。當(dāng)發(fā)生改變時，需立即上報終端管理系統(tǒng)。ONTPServer2string(64)RR第二個NTP時間服務(wù)器。可以為域名或IP地址。ONTPServer3string(64)RR第三個NTP時間服務(wù)器。可以為域名或IP地址。ONTPServer4string(64)RR第四個NTP時間服務(wù)器?？梢詾橛蛎騃P地址。ONTPServer5string(64)RR第五個NTP時間服務(wù)器?？梢詾橛蛎騃P地址。OCurrentLocalTimedateTime一R終端本地時區(qū)中的當(dāng)前日期和時間MLocalTimeZonestring(256)RR本地時間與UTC的偏差，形式如下：+hh:mmh

16、h:mm。當(dāng)發(fā)生改變時，需立即上報終端管理系M統(tǒng)。用戶接口相關(guān)參數(shù)Device.UserInterfaceNameTypeWriteReadDescription必選Device.UserInterface.object此對象包含與終端用戶接口相關(guān)的參數(shù)。是否支持此對象是可選的。OPasswordRequiredbooleanRR只有當(dāng)終端提供密碼保護(hù)的LAN側(cè)用戶接口時，此參數(shù)才適用。指示本地用戶接口是否必須要求密碼，以便供用戶選擇。如果此參數(shù)為假，則由用戶來選擇是否使用密碼。PasswordUserSelectablebooleanRR只有當(dāng)終端提供密碼保護(hù)的LAN側(cè)用戶接口并支持LAN側(cè)

17、自動配置時，此參數(shù)才適用。指示用戶是否可以直接選擇密碼以保護(hù)終端的本地用戶接口，或者必須使用與LAN側(cè)自動配置協(xié)議相同的密碼。UpgradeAvailablebooleanRR指示某個終端升級是可用的，允許終端將此信息顯示給用戶。WarrantyDatedateTimeRR指示與終端相關(guān)的保修期過期的日期和時間。ISPNamestring(64)RR客戶的ISP名稱。ISPHelpDeskstring(32)RRISP的咨詢電話號碼。ISPHomePagestring(256)RRISP主頁的URL。ISPHelpPagestring(256)RRISP在線支持頁面的URLISPLogoBas

18、e64(5460)RRBase64編碼的Gf或JPEG圖像。二進(jìn)制圖像大小限制為4095k以下。ISPLogoSizeunsignedInt0:4095RR未編碼的二進(jìn)制圖像大小(K)。如果ISPLogoSize輸入值為0,則ISPLogo被清除。ISPLogoSize也能夠用于圖片的檢測圖片的正確傳輸與Base64字符串到圖片大小的轉(zhuǎn)換。ISPMailServerstring(256)RRISP郵件服務(wù)器的URL。ISPNewsServerstring(256)RRISP新聞服務(wù)器的URL。TextColorstring(6)RRRGB表示的GUI屏幕文字顏色BackgroundColors

19、tring(6)RRRGB表示的GUI屏幕背景顏色ButtonColorstring(6)RRRGB表示的GUI屏幕按鈕顏色ButtonTextColorstring(6)RRRGB表示的GUI屏幕按鈕文字顏色.AutoUpdateServerstring(256)RR終端用于檢查是否有最新更新并進(jìn)行直接下載的服務(wù)器地址。當(dāng)Device.-ManagementServer.-UpgradesManaged為true時，不能使用本參數(shù)。UserUpdateServerstring(256)RR用戶通過瀏覽器檢査是否有最新的更新并下載到PC上的服務(wù)器地址。當(dāng)Device.Management-Se

20、rver.Upgrades-Managed為true時，不能使用本參數(shù)。AvailableLanguagesstring(256)RR可選語種CurrentLanguagestring(6)RR當(dāng)前語言LAN接口參數(shù)Device.LANNameTypeWriteReadDescription必選Device.LAN.object終端中基于IP的網(wǎng)絡(luò)連接信息，此處只有1個LAN信息上報MAddressingTypestringRR給網(wǎng)絡(luò)接口分配地址的方法，枚舉類型：“DHCP”“Static”當(dāng)發(fā)生改變時，需立即上報終端管理系統(tǒng)。MIPAddressstringRR當(dāng)前分配給網(wǎng)絡(luò)接口的IP地址。

21、本參數(shù)在AddressingType為”DHCP”時為只讀。MSubnetMaskstringRR子網(wǎng)掩碼MDefaultGatewaystringRR默認(rèn)網(wǎng)關(guān)MDNSServersstring(256)RR逗號分隔的DNS服務(wù)器地址。MMACAddressstringRRMAC地址MMACAddressOverridebooleanRRMACAddress參數(shù)是否能夠被重寫。True:可改寫；False:不可改寫。ODHCPOptionNumberOfEntriesunsignedInt一RDHCPoption表中的入口個數(shù)ODHCP參數(shù)配置Device.LAN.DHCPOption.iNa

22、meTypeWriteReadDescriptionDefaultDevice.LAN.DHCPOption.i.objectRR本對象用于DHCPoption的配置。每個實(shí)例都代表DHCP客戶端請求中的個DHCPoption。.ORequestBooleanRR本入口是表示向DHCP服務(wù)器的請求，或DHCP客戶端M發(fā)送值。tagunsignedInt1:254RRRFC2132中定義的DHCPoption標(biāo)簽MValueBase64RR如果請求為false時，用于標(biāo)識DHCPoption的base64編碼的八進(jìn)制字符串。MLAN狀態(tài)參數(shù)Device.LAN.StatsNameTypeWrit

23、eReadDescription必選Device.LAN.Stats.object這個對象包括默認(rèn)IP接口的統(tǒng)計信息。OConnectionUpTimeunsignedIntR網(wǎng)卡連接網(wǎng)絡(luò)的時間（秒為單位）TotalBytesSentunsignedIntR從上次在DeviceInfo.UpTime中描述的重啟時間開始，通過這個接口發(fā)送的IP負(fù)載總字節(jié)數(shù)TotalBytesReceivedunsignedIntR從上次在DeviceInfo.UpTime中描述的重啟時間開始，通過這個接口接收的IP負(fù)載總字節(jié)數(shù)TotalPacketsSentunsignedIntR從上次在DeviceInfo.

24、UpTime中描述的重啟時間開始，通過這個接口發(fā)送的IP包總XL數(shù)TotalPacketsReceivedunsignedIntR從上次在DeviceInfo.UpTime中描述的重啟時間開始，通過這個接口接收的IP包總數(shù)CurrentDayIntervalunsignedIntR從開始今日統(tǒng)計開始所經(jīng)過的時間（以秒為單位）。設(shè)備可以在每個CurrentDay間隔之前加上采用UTC格式表示的日期。CurrentDayBytesSentunsignedIntR從CurrentDayInterval定義的今日統(tǒng)計時間開始，通過這個接口發(fā)送的IP字節(jié)總數(shù)CurrentDayBytesReceived

25、unsignedIntR從CurrentDayInterval定義的今日統(tǒng)計時間開始，通過這個接口接收的IP字節(jié)總數(shù)CurrentDayPacketsSentunsignedIntR從CurrentDayInterval定義的今日統(tǒng)計時間開始，通過這個接口發(fā)送的IP包總數(shù)CurrentDayPacketsReceivedunsignedIntR從CurrentDayInterval定義的今日統(tǒng)計時間開始，通過這個接口接收的IP包總數(shù)QuarterHourIntervalunsignedIntR從開始QuarterHour統(tǒng)計開始所經(jīng)過的時間（以秒為單位）QuarterHourBytesSent

26、unsignedIntR從QuarterHourInterval定義的今日統(tǒng)計時間開始，通過這個接口發(fā)送的IP字節(jié)總數(shù)QuarterHourBytesReceivedunsignedIntR從QuarterHourInterval定義的今日統(tǒng)計時間開始，通過這個接口接收的IP字節(jié)總數(shù)QuarterHourPacketsSentunsignedIntR從QuarterHourInterval定義的今日統(tǒng)計時間開始，通過這個接口發(fā)送的IP包總數(shù)QuarterHourPacketsReceivedunsignedIntR從QuarterHourInterval定義的今日統(tǒng)計時間開始，通過這個接口發(fā)送

27、的IP包總數(shù)Ping診斷參數(shù)Device.LAN.IPPingDiagnosticsNameTypeWriteReadDescription必選Device.LAN.IPPingDiagnostics.object這個對象提供IP層的ping診斷MDiagnosticsStatestringRR表示診斷數(shù)據(jù)的情況，如果終端管理系統(tǒng)要求設(shè)置這個值，則可以是：MNoneRequestedCompleteError_CannotResolveHostNameError_InternalErrorOtherHoststring(256)RR用于ping診斷的主機(jī)名或地址。MNumberOfRepeti

28、tionsunsignedInt1：RR在報告結(jié)果之前，ping診斷重復(fù)的次數(shù)。MTimeoutunsignedInt1:RR用毫秒表示的ping診斷超時時間MDataBlockSizeunsignedInt1:65535RR每個ping命令發(fā)送的數(shù)據(jù)大小，以字節(jié)為單位，要求固定大小為32字節(jié)MDSCPunsignedInt0:64RR測試包中用于DiffServ的碼點(diǎn)，默認(rèn)值為0MSuccessCountunsignedIntR在最近的ping測試中成功的次數(shù)。.MFailureCountunsignedIntR在最近的ping測試中失敗的次數(shù)。MAverageResponseTimeuns

29、ignedIntR以毫秒為單位的最近一次ping測試所有成功響應(yīng)的平均時間。MMinimumResponseTimeunsignedIntR以毫秒為單位的最近一次ping測試所有成功響應(yīng)中的最短時間MMaximumResponseTimeunsignedIntR以毫秒為單位的最近一次ping測試所有成功響應(yīng)中的最長時間M路由主機(jī)參數(shù)Device.LAN.TraceRouteDiagnosticsNameTypeWriteReadDescription必選Device.LAN.TraceRouteDiagnostics.object一一用于路由診斷的對象ODiagnosticsStatestri

30、ngRR表示診斷數(shù)據(jù)的情況，如果終端管理系統(tǒng)要求設(shè)置這個值，則可以是：NoneRequestedCompleteError_CannotResolveHostNameError_InternalErrorOtherHoststring(256)RR用于路由診斷的主機(jī)名或地址。TimeoutunsignedInt1:RR用毫秒表示的路由診斷超時時間DataBlockSizeunsignedInt1:65535RR每個路由診斷發(fā)送的數(shù)據(jù)大小，以字節(jié)為單位，要求固定大小為32字節(jié)MaxHopCountunsignedInt1:64RR發(fā)送的測試數(shù)據(jù)包的最大跳數(shù)（最大TTL數(shù)），默認(rèn)為30跳DSCPu

31、nsignedInt0:64RR測試包中用于DiffServ的碼點(diǎn)，默認(rèn)值為0.ResponseTimeunsignedIntR以毫秒表示的最近一次路由主機(jī)測試的響應(yīng)時間，如果無法決定具體路由，則默認(rèn)為0NumberOfRouteHopsunsignedInt一R用于發(fā)現(xiàn)路由的跳數(shù)，如果無法決定路由，則默認(rèn)為0.LAN.TraceRouteDiagnostics.RouteHops.i.object一用于表示被發(fā)現(xiàn)的路由對象，如果路由無法達(dá)到，則這個對象沒有實(shí)例。HopHostString(256)一RI.IODevice.Services(暫時不實(shí)現(xiàn)NameTypeWriteReadDescription必選Device.ServiceobjectOSTBServiceNu