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相关参数 |