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

1 參數(shù)定義定義 終端的TR-069 參數(shù)模型 主要參考兩個文檔 TR-106 和TR-135 ，TR-106 定義了基于TR-069管理的設(shè)備的通用數(shù)據(jù)模型，TR-135 定義了STB 的特定數(shù)據(jù)模型。由于目前針對STB 的數(shù)據(jù)管理沒有提出具體要求，因此暫不實現(xiàn)TR-135中定義的數(shù)據(jù)模型。在數(shù)據(jù)模型中，凡參數(shù)中有X_STB字樣的，均有擴展參數(shù)。讀寫屬性的值(wrie, Read) ,如果為“R”，則該參數(shù)是可讀或可寫的，如果為”-“，則該參數(shù)是不可讀或不可寫的。若必選屬性的值為”M”,則該參數(shù)是必須實現(xiàn)的，若為”O(jiān)”，則該參數(shù)的實現(xiàn)是可選的。 1.1 數(shù)據(jù)模型 紅色表示暫不實現(xiàn)NameTypeWriteReadDescription必 選Device. DeviceSummarystring(1024)-R設(shè)備描述MDevice.CAObjectCA卡的相關(guān)信息MDevice. DeviceInfoobject終端的詳細(xì)信息描述MDevice.ManagementServerobject終端管理系統(tǒng)相關(guān)的參數(shù)MDevice.Configobject終端普通配置參數(shù)。ODevice.GatewayInfoobject終端連接的網(wǎng)關(guān)設(shè)備信息ODevice.Timeobject終端中 NTP 時間客戶端相關(guān)的參數(shù)。MDevice.UserInterfaceobject終端用戶接口相關(guān)的參數(shù)。ODevice.LANobject終端中基于IP的網(wǎng)絡(luò)連接信息MDevice.LAN.DHCPobjectODevice.LAN.StatsobjectODevice.LAN. IPPingDiagnosticsMDevice.LAN.T raceRouteDiagnosticsODevice.Servicesobject終端中特定服務(wù)相關(guān)配置ODevice.X_STB_ConfigobjectSTB特定配置MDevice.X_STB_Statsobject終端狀態(tài)MDevice.X_STB_Statisticobject性能統(tǒng)計MDevice.X_STB_AudienceStatsobject用戶收視率采集MDevice.X_STB_Softwareobject軟件版本管理MDevice.X_STB_AlarmObject當(dāng)前告警信息M 1.2 CA卡的相關(guān)信息 Device.CANameTypeWriteReadDescription必選Device.CACA信息查詢MCAVersionString(5k)RCA版本MCAProviderString(5k)R運營商信息MCASerialNumberString(5k)RCA序列號M1.3 設(shè)備詳細(xì)信息 Device. DeviceInfoNameTypeWriteReadDescription必 選Device. DeviceInfo.object-設(shè)備的詳細(xì)信息描述MManufacturerstring(64)-R終端制造商（意義可讀的字符串）。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(64)-R標(biāo)識特定終端型號和版本的字符串。MSoftwareVersionstring(64)-R各廠商自定義版本的命名方式。MEnabledOptionsstring(1024)-R采用逗號分隔的終端支持的Option名稱列表 OAdditionalHardwareVersionstring(64)-R任何附加版本以逗號分隔的列表。表示任何供應(yīng)商希望提供的附加硬件版本信息。如果沒有可以為空字符串。OAdditionalSoftwareVersionstring(64)-R任何附加版本以逗號分隔的列表。表示任何供應(yīng)商希望提供的附加軟件版本信息。如果沒有可以為空字符串。OProvisioningCodestring(64)-R主要服務(wù)提供商和其他供應(yīng)信息的標(biāo)識，服務(wù)器用來確定服務(wù)提供商特定的定制和供應(yīng)參數(shù)。當(dāng)發(fā)生改變時，需立即上報終端管理系統(tǒng)。MDeviceStatusstring-R終端當(dāng)前可選狀態(tài)： “Up” ”Initializing” “Error” “DisabledMUpTimeunsignedInt-R一次重啟后的時間（以秒計）。MFirstUseDatedateTime-R終端 首次成功建立網(wǎng)絡(luò)連接的日期和時間。ODeviceLogstring(32K)-R終端記錄的日志信息OHardwareVersion為終端設(shè)備的版本/型號SoftwareVersion為終端上主系統(tǒng)軟件的版本,在eBox上為”主框架”的版本號.1.4 網(wǎng)管信息參數(shù) Device.ManagementServerNameTypeWriteReadDescription必 選Device.ManagementServer.object-此對象包含與 終端管理系統(tǒng) 相關(guān)的參數(shù)，此 終端管理系統(tǒng) 與終端關(guān)聯(lián)。M URLstring(256)RR終端利用終端WAN 管理協(xié)議連接終端管理系統(tǒng)的URL。此參數(shù)必須為有效的 HTTP 或 HTTPS URL 8.。HTTPS URL 表示終端管理系統(tǒng)支持 SSL。終端 使用此 URL 的“主機”部分，以便在使用基于認(rèn)證的鑒權(quán)時確認(rèn) 終端管理系統(tǒng) 認(rèn)證。當(dāng)發(fā)生改變時，需立即上報終端管理系統(tǒng)。MUsernamestring(256)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ù)會忽略實際值而返回一個空字符串。采用統(tǒng)一密碼的方式，默認(rèn)值為”STBAdmin”，且大小寫敏感MPeriodicInformEnablebooleanRR終端是否必須利用 Inform 方法調(diào)用定時向服務(wù)器端發(fā)送終端信息。默認(rèn)為trueMPeriodicInformIntervalunsignedInt1:RR在PeriodicInformEnable 為真時，終端 必須嘗試連接 終端管理系統(tǒng) 并調(diào)用 Inform 方法的時間間隔。默認(rèn)為3600秒MPeriodicInformTimedateTimeRR決定終端發(fā)起Inform 方法調(diào)用的時間參考絕對值。 每個 Inform 調(diào)用必須在 PeriodicInformInterval 加或減此參考時間的整數(shù)倍時進(jìn)行。默認(rèn)為0001-01-01T00:00:00Z.,即不采用此值做為時間參考。MParameterKeystring(32)-R 來自于服務(wù)器的最新的 SetParameterValues，AddObject 或 DeleteObject 方法調(diào)用的 ParameterKey 自變量數(shù)值。如果沒有此類調(diào)用，此數(shù)值為空。MConnectionRequestURLstring(256)-R終端管理系統(tǒng) 向終端發(fā)起連接請求通知時所使用的 HTTP URL。其形式如下：http:/host:port/path.URL 的“主機”部分可以是終端管理接口的 IP 地址，用以替代域名。MConnectionRequestUsernamestring(256)RR終端管理系統(tǒng) 向終端發(fā)起連接請求時，鑒權(quán)過程使用的用戶名。默認(rèn)為 “itms”。MConnectionRequestPasswordstring(256)RR終端管理系統(tǒng) 向終端發(fā)起連接請求時，鑒權(quán)過程使用的密碼。在被讀取時，該參數(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.Config.object此對象包含普通配置參數(shù)。O PersistentDatastring(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)。M1.6 網(wǎng)關(guān)信息 Device.GatewayInfoNameTypeWriteReadDescription必選Device.GatewayInfo.object這個對象包含有已連接的網(wǎng)關(guān)設(shè)備的信息OManufacturerOUIstring(6)R相關(guān)網(wǎng)關(guān)設(shè)備的OUI?？兆址畼?biāo)識沒有監(jiān)測到相關(guān)的網(wǎng)關(guān)設(shè)備。M ProductClassstring(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è)備。M1.7 時間配置參數(shù) Device.TimeNameTypeWriteReadDescription必選Device.Time.object-此對象包含與終端中 NTP 時間客戶端相關(guān)的參數(shù)。 是否支持此對象是可選的。MNTPServer1string(64)RR第一個 NTP 時間服務(wù)器?？梢詾橛蛎?IP 地址。當(dāng)發(fā)生改變時，需立即上報終端管理系統(tǒng)。ONTPServer2string(64)RR第二個 NTP 時間服務(wù)器?？梢詾橛蛎?IP 地址。ONTPServer3string(64)R R第三個 NTP 時間服務(wù)器。可以為域名或 IP 地址。ONTPServer4string(64)RR第四個 NTP 時間服務(wù)器?？梢詾橛蛎?IP 地址。ONTPServer5string(64)RR第五個 NTP 時間服務(wù)器。可以為域名或 IP 地址。OCurrentLocalTimedateTimeR終端本地時區(qū)中的當(dāng)前日期和時間MLocalTimeZonestring(256)RR本地時間與 UTC 的偏差，形式如下：+hh:mm hh:mm。當(dāng)發(fā)生改變時，需立即上報終端管理系統(tǒng)。M1.8 用戶接口相關(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è)自動配置時，此參數(shù)才適用。指示用戶是否可以直接選擇密碼以保護(hù)終端的本地用戶接口，或者必須使用與 LAN 側(cè)自動配置協(xié)議相同的密碼。UpgradeAvailablebooleanRR指示某個終端升級是可用的，允許終端將此信息顯示給用戶。WarrantyDatedateTimeRR指示與終端相關(guān)的保修期過期的日期和時間。ISPNamestring(64)RR客戶的 ISP 名稱。ISPHelpDeskstring(32)RRISP 的咨詢電話號碼。ISPHomePagestring(256)RRISP 主頁的 URL。ISPHelpPagestring(256)RRISP 在線支持頁面的URLISPLogoBase64(5460)RRBase64編碼的Gif或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屏幕文字顏色BackgroundColorstring(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-Server.Upgrades-Managed為true時，不能使用本參數(shù)。AvailableLanguagesstring(256)RR可選語種CurrentLanguagestring(6)RR當(dāng)前語言1.9 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地址。本參數(shù)在AddressingType為”DHCP”時為只讀。MSubnetMaskstringRR子網(wǎng)掩碼MDefaultGatewaystringRR默認(rèn)網(wǎng)關(guān)MDNSServersstring(256)RR逗號分隔的DNS服務(wù)器地址。MMACAddressstringRRMAC地址MMACAddressOverridebooleanRRMACAddress參數(shù)是否能夠被重寫。True:可改寫； False:不可改寫。ODHCPOptionNumberOfEntriesunsignedIntRDHCP option表中的入口個數(shù)O1.9.1 DHCP參數(shù)配置Device.LAN.DHCPOption.iNameTypeWriteReadDescriptionDefaultDevice.LAN.DHCPOption.i.objectR R 本對象用于DHCP option的配置。每個實例都代表DHCP客戶端請求中的一個DHCP option。.ORequestBooleanRR本入口是表示向DHCP服務(wù)器的請求，或DHCP客戶端發(fā)送值。MtagunsignedInt1:254RRRFC 2132中定義的DHCP option標(biāo)簽MValueBase64RR如果請求為false時，用于標(biāo)識DHCP option的base64編碼的八進(jìn)制字符串。M1.9.2 LAN狀態(tài)參數(shù) Device.LAN.StatsNameTypeWriteReadDescription必選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.UpTime中描述的重啟時間開始，通過這個接口發(fā)送的IP包總數(shù)TotalPacketsReceivedunsignedIntR從上次在DeviceInfo.UpTime中描述的重啟時間開始，通過這個接口接收的IP包總數(shù)CurrentDayIntervalunsignedIntR從開始今日統(tǒng)計開始所經(jīng)過的時間(以秒為單位)。設(shè)備可以在每個CurrentDay間隔之前加上采用UTC格式表示的日期。CurrentDayBytesSentunsignedIntR從CurrentDayInterval定義的今日統(tǒng)計時間開始，通過這個接口發(fā)送的IP字節(jié)總數(shù)CurrentDayBytesReceivedunsignedIntR從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)過的時間(以秒為單位)QuarterHourBytesSentunsignedIntR從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ā)送的IP包總數(shù)1.9.3 Ping診斷參數(shù)Device.LAN.IPPingDiagnosticsNameTypeWriteReadDescription必選Device.LAN.IPPingDiagnostics.object 這個對象提供IP層的ping診斷MDiagnosticsStatestringRR表示診斷數(shù)據(jù)的情況，如果終端管理系統(tǒng)要求設(shè)置這個值，則可以是： None Requested Complete Error_CannotResolveHostName Error_Internal Error_OtherMHoststring(256)RR用于ping診斷的主機名或地址。MNumberOfRepetitionsunsignedInt1:RR在報告結(jié)果之前，ping診斷重復(fù)的次數(shù)。MTimeoutunsignedInt1:RR用毫秒表示的ping診斷超時時間MDataBlockSizeunsignedInt1:65535RR每個ping命令發(fā)送的數(shù)據(jù)大小，以字節(jié)為單位，要求固定大小為32字節(jié)MDSCPunsignedInt0:64RR測試包中用于DiffServ的碼點，默認(rèn)值為0MSuccessCountunsignedIntR在最近的ping測試中成功的次數(shù)。.MFailureCountunsignedIntR在最近的ping測試中失敗的次數(shù)。MAverageResponseTimeunsignedIntR以毫秒為單位的最近一次ping測試所有成功響應(yīng)的平均時間。MMinimumResponseTimeunsignedIntR以毫秒為單位的最近一次ping測試所有成功響應(yīng)中的最短時間MMaximumResponseTimeunsignedIntR以毫秒為單位的最近一次ping測試所有成功響應(yīng)中的最長時間M1.9.4 路由主機參數(shù)Device.LAN.TraceRouteDiagnosticsNameTypeWriteReadDescription必選Device.LAN.TraceRouteDiagnostics.object- 用于路由診斷的對象ODiagnosticsStatestringR R表示診斷數(shù)據(jù)的情況，如果終端管理系統(tǒng)要求設(shè)置這個值，則可以是： None Requested Complete Error_CannotResolveHostName Error_Internal Error_OtherHoststring(256)R R用于路由診斷的主機名或地址。TimeoutunsignedInt1:R R用毫秒表示的路由診斷超時時間DataBlockSizeunsignedInt1:65535R R每個路由診斷發(fā)送的數(shù)據(jù)大小，以字節(jié)為單位，要求固定大小為32字節(jié)MaxHopCountunsignedInt1:64R R發(fā)送的測試數(shù)據(jù)包的最大跳數(shù)(最大TTL數(shù))，默認(rèn)為30跳DSCPunsignedInt0:64R R測試包中用于DiffServ的碼點，默認(rèn)值為0.ResponseTimeunsignedInt-R以毫秒表示的最近一次路由主機測試的響應(yīng)時間，如果無法決定具體路由，則默認(rèn)為0 NumberOfRouteHopsunsignedInt-R用于發(fā)現(xiàn)路由的跳數(shù)，如果無法決定路由，則默認(rèn)為0.LAN.TraceRouteDiagnostics.RouteHops.i.object-用于表示被發(fā)現(xiàn)的路由對象，如果路由無法達(dá)到，則這個對象沒有實例。HopHostString(256)-R1.10 Device.Services（暫時不實現(xiàn)）NameTypeWriteReadDescription必選Device.Serviceobject OSTBServiceNumberOfEntriesunsignedIntSTBService.i.Object1.11 終端配置參數(shù) Device.X_STB_ConfigNameTypeWriteReadDescription必選Device.X_STB_Config.object- STB 特定配置MSTBIDString(32)-R終端IDMUserIDString(36)-RSTB用戶編號MServiceIDListString（256）-R支持的服務(wù)列表（用半角分號分隔）M1.12 終端運行狀態(tài)參數(shù) Device.X_STB_Stats NameTypeWriteReadDescription必選Device.X_STB_Stats.object- 終端狀態(tài)MSTBOnlineStatusString(1)-R0 當(dāng)前在線，活躍1 待機 MCPULoad unsignedInt0:100-RCPU占用率（1100）MMemLoad unsignedInt0:100-R內(nèi)存占用比率（1100）MStorageLoad unsignedInt0:100-R存儲占用比率MServiceUsingString(256)-R正在使用的業(yè)務(wù)，依次包含業(yè)務(wù)種類和業(yè)務(wù)內(nèi)容，以半角字符分號分割。MBuffeRatiorunsignedInt0:100-R緩沖利用率MBufferOverflowboolean-R緩沖區(qū)是否溢出MBufferEmptyboolean-R緩沖區(qū)是否為空MBandwidthunsignedInt0:-R當(dāng)前媒體流傳輸帶寬M1.13 用戶收視率采集參數(shù)Device. X_STB_ AudienceStats NameTypeWriteReadDescription必選Device.X_STB_ AudienceStats.object用戶收視率采集MRequestRecordBoolean RR請求開始/終止記錄MMaxCollectI