TR-069 是由 DSL 論壇開發的 CPE 廣域網路管理協議。它定義了 ACS 自動配置伺服器對 CPE 用戶端設備進行安全自動化配置和集中管理的框架。
圖 1-1 TR-069 圖解設計
本文檔適用於門禁設備和話機設備。
本文檔面向需要了解 TR-069 配置、RPC 方法、TR-111 擴展及參數模型的研發和測試人員。
ACS 自動配置伺服器
CPE 客戶端設備
話機預設未啟用 TR-069。使用者可使用管理員權限登入 Web 頁面,進入 系統 → 自動部署 → TR069,並在對應區域配置參數。
圖 2-1
| 名稱 | 描述 |
| Enable TR069 | 啟用狀態 |
| ACS Server Type | 配置項 |
| ACS Server Address | 伺服器位址或URL |
| ACS Login Account | 使用者名稱 |
| ACS Login Password | 密碼 |
| STUN Server Address | STUN相關參數 |
| Enable STUN | 啟用狀態 |
RPC 方法用於 CPE 與 ACS 的雙向通訊,ACS 可透過 RPC 取得、設定、監控和維護設備參數。
| RPC | 節點說明 |
| GetRPCMethods | RPC功能說明 |
| SetParameterValues | RPC功能說明 |
| GetParameterValues | RPC功能說明 |
| GetParameterNames | RPC功能說明 |
| GetParameterAttributes | RPC功能說明 |
| SetParameterAttributes | RPC功能說明 |
| Download | RPC功能說明 |
| FactoryReset | RPC功能說明 |
| Reboot | RPC功能說明 |
TR-111 屬於 TR-069 協議族,用於擴展閘道關聯和 NAT 後設備連線請求能力,使 ACS 能夠更好地管理 LAN 側設備。
TR-111 supports gateway association so that the ACS can identify the gateway used by a LAN-side device.
TR-111 supports UDP/STUN based connection requests for CPE devices located behind NAT gateways.
網路架構包含 Internet Gateway Device 和 LAN Device 兩類資料模型。參數名稱採用點分層樹狀結構,參數類型基於 SOAP 資料類型。
Internet Gateway Device
LAN Device
Parameter names use a dotted tree hierarchy.
Parameter types are based on SOAP data types.
| 節點名 | 類型 | 節點說明 |
| InternetGatewayDevice.DeviceInfo. | Object | 設備資訊 |
| InternetGatewayDevice.DeviceInfo.Manufacturer | String | 設備製造商 |
| InternetGatewayDevice.DeviceInfo.ManufacturerOUI | String | 設備製造商 |
| InternetGatewayDevice.DeviceInfo.ModelName | String | 產品型號 |
| InternetGatewayDevice.DeviceInfo.Description | String | 設備資訊 |
| InternetGatewayDevice.DeviceInfo.ProductClass | String | 產品型號 |
| InternetGatewayDevice.DeviceInfo.SerialNumber | String | 設備資訊 |
| InternetGatewayDevice.DeviceInfo.SoftwareVersion | String | 版本資訊 |
| InternetGatewayDevice.DeviceInfo.HardwareVersion | String | 版本資訊 |
| InternetGatewayDevice.DeviceInfo.SpecVersion | String | 版本資訊 |
| InternetGatewayDevice.DeviceInfo.ProvisioningCode | String | 配置項 |
| InternetGatewayDevice.DeviceInfo.UpTime | String | 時間參數 |
| InternetGatewayDevice.DeviceInfo.DeviceLog | String | 設備資訊 |
| InternetGatewayDevice.DeviceInfo.VendorConfigFile.{i}. | Object | 配置項 |
| InternetGatewayDevice.DeviceInfo.VendorConfigFile.{i}.Name | String | 配置項 |
| InternetGatewayDevice.DeviceInfo.VendorConfigFile.{i}.Version | String | 版本資訊 |
| InternetGatewayDevice.DeviceInfo.VendorConfigFile.{i}.Date | String | 時間參數 |
| InternetGatewayDevice.DeviceInfo.VendorConfigFile.{i}.Description | String | 配置項 |
| InternetGatewayDevice.ManagementServer. | Object | 設備資訊 |
| InternetGatewayDevice.ManagementServer.URL | String | 伺服器位址或URL |
| InternetGatewayDevice.ManagementServer.Username | String | 使用者名稱 |
| InternetGatewayDevice.ManagementServer.Password | String | 密碼 |
| InternetGatewayDevice.ManagementServer.PeriodicInformEnable | String | 啟用狀態 |
| InternetGatewayDevice.ManagementServer.PeriodicInformInterval | String | 時間參數 |
| InternetGatewayDevice.ManagementServer.PeriodicInformTime | String | 時間參數 |
| InternetGatewayDevice.ManagementServer.ParameterKey | String | 配置項 |
| InternetGatewayDevice.ManagementServer.ConnectionRequestURL | String | 伺服器位址或URL |
| InternetGatewayDevice.ManagementServer.ConnectionRequestUsername | String | 使用者名稱 |
| InternetGatewayDevice.ManagementServer.ConnectionRequestPassword | String | 密碼 |
| InternetGatewayDevice.ManagementServer.UDPConnectionRequestAddress | String | 伺服器位址或URL |
| InternetGatewayDevice.ManagementServer.UDPConnectionRequestAddressNotificationLimit | String | 時間參數 |
| InternetGatewayDevice.ManagementServer.STUNEnable | String | STUN相關參數 |
| InternetGatewayDevice.ManagementServer.STUNServerAddress | String | STUN相關參數 |
| InternetGatewayDevice.ManagementServer.STUNServerPort | String | STUN相關參數 |
| InternetGatewayDevice.ManagementServer.STUNUsername | String | 使用者名稱 |
| InternetGatewayDevice.ManagementServer.STUNPassword | String | 密碼 |
| InternetGatewayDevice.ManagementServer.STUNMaximumKeepAlivePeriod | String | STUN相關參數 |
| InternetGatewayDevice.ManagementServer.STUNMinimumKeepAlivePeriod | String | STUN相關參數 |
| InternetGatewayDevice.ManagementServer.NATDetected | String | STUN相關參數 |
| InternetGatewayDevice.ManagementServer.KickURL | String | 伺服器位址或URL |
| InternetGatewayDevice.ManagementServer.UpgradesManaged | String | 啟用狀態 |
| InternetGatewayDevice.Time. | object | 時間參數 |
| InternetGatewayDevice.Time.Enable | Boolean | 啟用狀態 |
| InternetGatewayDevice.Time.NTPServer1 | string | 伺服器位址或URL |
| InternetGatewayDevice.Time.NTPServer2 | string | 伺服器位址或URL |
| InternetGatewayDevice.Time.CurrentLocalTime | dateTime | 時間參數 |
| InternetGatewayDevice.Time.LocalTimeZone | String | 時間參數 |
| InternetGatewayDevice.Time.LocalTimeZoneName | String | 時間參數 |
| InternetGatewayDevice.Layer3Forwarding. | Object | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.ForwardNumberOfEntries | Unsigned | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.{i}. | object | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.1.Enable | string | 啟用狀態 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.1.Status | string | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.1.Type | string | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.{i}.DestIPAddress | string | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.{i}.DestSubnetMask | string | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.{i}.SourceIPAddress | string | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.{i}.SourceSubnetMask | string | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.{i}.GatewayIPAddress | string | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.{i}.Interface | string | 路由或轉送參數 |
| InternetGatewayDevice.Layer3Forwarding.Forwarding.{i}.ForwardingMetric | string | 路由或轉送參數 |
| InternetGatewayDevice.UserInterface. | Object | 使用者介面資訊 |
| InternetGatewayDevice.UserInterface.UpgradeAvailable | String | 使用者介面資訊 |
| InternetGatewayDevice.UserInterface.CurrentLanguage | String | 使用者介面資訊 |
| InternetGatewayDevice.Services.VoiceService.{i}. | object | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceServiceNumberOfEntries | unsignedInt | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfileNumberOfEntries | unsignedInt | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities. | object | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.MaxProfileCount | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.MaxLineCount | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.MaxSessionCount | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SignalingProtocols | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.FaxT38 | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.FaxPassThrough | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.ModemPassThrough | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.ToneGeneration | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.RingGeneration | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.VoiceLineTests | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SIP. | object | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SIP.Role | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SIP.Extensions | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SIP.Transports | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SIP.URISchemes | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SIP.EventSubscription | boolean | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SIP.ResponseMap | boolean | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SIP.TLSAuthenticationProtocols | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SIP.TLSAuthenticationKeySize | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.SIP.TLSEncryptionProtocols | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.H323. | object | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.H323.FastStart | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.H323.H235AuthenticationMethods | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.Codecs | object | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.Codecs.{i}.EntryId | unsignedInt | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.Codecs.{i}.Codec | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.Capabilities.Codecs.{i}.BitRate | unsignedInt | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}. | object | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Reset | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.NumberOfLines | unsignedInt | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Name | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SignalingProtocol | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.MaxSessions | unsignedInt | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.DTMFMethod | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.STUNEnable | boolean | STUN相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.STUNServer | string | STUN相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.RTP. | object | RTP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.RTP.LocalPortMin | unsignedInt | RTP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.RTP.LocalPortMax | unsignedInt | RTP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.RTP.DSCPMark | string | RTP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.RTP.TelephoneEventPayloadType | string | RTP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}. | object | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.Enable | boolean | 啟用狀態 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.DirectoryNumber | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.Status | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallState | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.RingMuteStatus | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.RingVolumeStatus | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.SIP. | object | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.SIP.AuthUserName | string | 使用者名稱 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.SIP.AuthPassword | string | 密碼 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures. | object | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.CallWaitingEnable | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.CallForwardUnconditionalEnable | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.CallForwardUnconditionalNumber | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.CallForwardOnBusyEnable | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.CallForwardOnBusyNumber | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.CallForwardOnNoAnswerEnable | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.CallForwardOnNoAnswerNumber | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.CallTransferEnable | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.MWIEnable | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.MessageWaiting | string | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.AnonymousCallEnable | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.CallingFeatures.DoNotDisturbEnable | boolean | VoIP能力或線路參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP. | object | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.ProxyServer | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.ProxyServerPort | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.ProxyServerTransport | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.RegistrarServer | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.RegistrarServerPort | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.RegistrarServerTransport | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.UserAgentDomain | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.UserAgentPort | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.UserAgentTransport | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.Organization | string | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.RegisterRetryInterval | string | 時間參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.RegisterExpires | string | 時間參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.DSCPMark | unsignedInt | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.VLANIDMark | int | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.EthernetPriorityMark | int | SIP相關參數 |
| InternetGatewayDevice.Services.VoiceService.{i}.VoiceProfile.{i}.SIP.X_ATP_OptionTime. | object | 時間參數 |
| InternetGatewayDevice.Services.VoiceService.1.VoiceProfile.6.SIP.X_ATP_OptionTime.IntervalTime | tUnsigned | 時間參數 |
| InternetGatewayDevice.Services.VoiceService.1.VoiceProfile.6.SIP.X_ATP_OptionTime.OptionsType | unsignedInt | SIP相關參數 |