TR-369, also called User Services Platform (USP), like its predecessor TR-069 (CWMP), is a protocol standard developed by Broadband-Forum for the management and analysis of devices connected to a network. TR-369 uses standardized transport protocols (e.g. MQTT, WebSocket) which encapsulates the USP messages required for remote management control.
Figure: USP Agent and Controller Architecture
Typically:
Where provisioning is used to provide configuration information to many phones at once, remote management takes this one step further. Of course it is still possible to configure the phone remotely when it boots up, but with TR-369 the phone can actually be managed remotely. In addition to the provisioning of configuration you can also e.g.
Reboot the phone
Customise the phone look and feel
Push XML-Minibrowser pages to the phone
Update the firmware of the device
The TR-369 support over MQTT has been introduced in firmware version 10.1.161.
The support of WebSocket has been introduced in firmware version 10.1.182.
The current list of phone models supporting TR-369 is:
The support of TR-369 is not planned for other phone models, but feel free contact us to share your needs.
The introduction of TR-369 requires also an update to the provisionned datamodel file.
For further details about the parameter mapping and its syntax, refer to the TR-069 - Full Endpoint Management page and its subsections about parameter mapping. |
On factory reset, the param_map file of the phone contains these newly added lines:
# TR-369 parameters - SRAPS USP Controller
string:Device.LocalAgent.Controller.1.MTP.1.WebSocket.Host!={TR369_WEBSOCKETHOST|1}
unsignedInt:Device.LocalAgent.Controller.1.MTP.1.WebSocket.Port!={TR369_WEBSOCKETPORT|1}
string:Device.LocalAgent.Controller.1.MTP.1.WebSocket.Path!={TR369_WEBSOCKETPATH|1}
boolean:Device.LocalAgent.Controller.1.MTP.1.WebSocket.EnableEncryption!={TR369_WEBSOCKETSECURED|1}
string:Device.MQTT.Client.1.BrokerAddress!={TR369_MQTTADDRESS|1}
unsignedInt:Device.MQTT.Client.1.BrokerPort!={TR369_MQTTPORT|1}
string:Device.MQTT.Client.1.ProtocolVersion={tr369_mqtt_version|1}
string:Device.MQTT.Client.1.TransportProtocol={tr369_mqtt_transport|1}
string:Device.MQTT.Client.1.Username={tr369_mqtt_username|1}
string:Device.MQTT.Client.1.Password={tr369_mqtt_password|1}
string:Device.MQTT.Client.1.ClientID={tr369_mqtt_clientid|1}
unsignedInt:Device.MQTT.Client.1.ConnectRetryMaxInterval=30
string:Device.LocalAgent.Controller.1.MTP.1.MQTT.Topic!={TR369_MQTTTOPIC_CTRL|1}
string:Device.LocalAgent.MTP.1.MQTT.ResponseTopicConfigured!={TR369_MQTTTOPIC_RESP|1}
string:Device.LocalAgent.Controller.1.EndpointID={tr369_controller_endpointid|1}
string:Device.LocalAgent.Subscription.1.ID={tr369_controller_subscriptionid|1}
string:Device.LocalAgent.Controller.1.E2ESession.SessionMode={tr369_controller_e2emode|1}
unsignedInt:Device.LocalAgent.Controller.1.E2ESession.MaxUSPRecordSize={tr369_controller_e2esize|1}
boolean:Device.LocalAgent.Subscription.1.Enable={tr369_enable|1}
string:Device.LocalAgent.MTP.1.Protocol={tr369_mtp_protocol|1}
string:Device.LocalAgent.Controller.1.MTP.1.Protocol={tr369_mtp_protocol|1}
boolean:Device.LocalAgent.MTP.1.Enable!={TR369_MQTTENABLE|1}
boolean:Device.MQTT.Client.1.Enable!={TR369_MQTTENABLE|1}
boolean:Device.LocalAgent.Controller.1.Enable={tr369_enable|1}
boolean:Device.LocalAgent.Controller.1.BootParameter.1.Enable={tr369_enable|1}
boolean:Device.LocalAgent.Controller.1.MTP.1.Enable={tr369_enable|1}
# TR-369 parameters - Customer's USP Controller
string:Device.LocalAgent.Controller.2.MTP.1.WebSocket.Host!={TR369_WEBSOCKETHOST|2}
unsignedInt:Device.LocalAgent.Controller.2.MTP.1.WebSocket.Port!={TR369_WEBSOCKETPORT|2}
string:Device.LocalAgent.Controller.2.MTP.1.WebSocket.Path!={TR369_WEBSOCKETPATH|2}
boolean:Device.LocalAgent.Controller.2.MTP.1.WebSocket.EnableEncryption!={TR369_WEBSOCKETSECURED|2}
string:Device.MQTT.Client.2.BrokerAddress!={TR369_MQTTADDRESS|2}
unsignedInt:Device.MQTT.Client.2.BrokerPort!={TR369_MQTTPORT|2}
string:Device.MQTT.Client.2.ProtocolVersion={tr369_mqtt_version|2}
string:Device.MQTT.Client.2.TransportProtocol={tr369_mqtt_transport|2}
string:Device.MQTT.Client.2.Username={tr369_mqtt_username|2}
string:Device.MQTT.Client.2.Password={tr369_mqtt_password|2}
string:Device.MQTT.Client.2.ClientID={tr369_mqtt_clientid|2}
unsignedInt:Device.MQTT.Client.2.ConnectRetryMaxInterval=30
string:Device.LocalAgent.Controller.2.MTP.1.MQTT.Topic!={TR369_MQTTTOPIC_CTRL|2}
string:Device.LocalAgent.MTP.2.MQTT.ResponseTopicConfigured!={TR369_MQTTTOPIC_RESP|2}
string:Device.LocalAgent.Controller.2.EndpointID={tr369_controller_endpointid|2}
string:Device.LocalAgent.Subscription.2.ID={tr369_controller_subscriptionid|2}
string:Device.LocalAgent.Controller.2.E2ESession.SessionMode={tr369_controller_e2emode|2}
unsignedInt:Device.LocalAgent.Controller.2.E2ESession.MaxUSPRecordSize={tr369_controller_e2esize|2}
boolean:Device.LocalAgent.Subscription.2.Enable={tr369_enable|2}
string:Device.LocalAgent.MTP.2.Protocol={tr369_mtp_protocol|2}
string:Device.LocalAgent.Controller.2.MTP.1.Protocol={tr369_mtp_protocol|2}
boolean:Device.LocalAgent.MTP.2.Enable!={TR369_MQTTENABLE|2}
boolean:Device.MQTT.Client.2.Enable!={TR369_MQTTENABLE|2}
boolean:Device.LocalAgent.Controller.2.Enable={tr369_enable|2}
boolean:Device.LocalAgent.Controller.2.BootParameter.1.Enable={tr369_enable|2}
boolean:Device.LocalAgent.Controller.2.MTP.1.Enable={tr369_enable|2} |
In customized param_map files, these lines must be added. Otherwise, the USP Agent won't be able to run and contact the USP Controller.
In order to use Snom phones with TR-369, some phone settings need to be adjusted first. Adjusting the settings can be accomplished in one of the following ways.
Firmware 10.1.161 introduced many phone settings specific to TR-369 and MQTT configuration, while firmware 10.1.182 introduced the WebSocket support.
These can be divided into different groups:
Overall settings | WebSocket specific | MQTT specific |
|---|---|---|
The "Controller settings" reflects the configuration of the USP Controller where the phones are to be connected: the available settings are about identifying both the USP Agent and USP Controller to each other.
The list of MTP settings to change is based on the chosen tr369_mtp_protocol and must be configured accordingly.
The following settings support the {mac} keyword to be replaced by the uppercase MAC address:
While the above method is a quick way to test the TR-369 integration it is not suitable for large-scale installations. In case many phones need to be connected to a USP Controller, it is strongly recommended to use SRAPS (Snom auto provisioning).
By default, all phones reach automatically SRAPS (USP Controller) and give quick feedbacks about status and operational state.
The best practice is to let all phones under SRAPS management (as out of the box) and, if needed, providing an additional USP Controller by editing the following settings:
tr369_enable2tr369_controller_endpointid2tr369_controller_subscriptionid2tr369_controller_e2emode2tr369_controller_e2esize2tr369_mtp_protocol2tr369_websocket_uri2tr369_mqtt_hostport2tr369_mqtt_version2tr369_mqtt_transport2tr369_mqtt_username2tr369_mqtt_password2tr369_mqtt_clientid2tr369_mqtt_topic2Exception of tr369_enable, all settings with index '1' are hardcoded to SRAPS and cannot be overwritten.
Refer to the TR-369 page about the typical TR-369 / USP messages which are available.
Additional methods (operations) are defined in the USP data model. The mechanism is controlled using the Operate Message in conjunction with the Multi-Instance Request Object.
The USP Controller can call the following operations to execute on the phones
| Operation | URL to description |
|---|---|
Device.Reboot() | Device:2 datamodel link to Reboot() |
Device.FactoryReset() | Device:2 datamodel link to FactoryReset() |
If you have successfully tested Snom phones to work with your USP Controller, please send an email with your USP Controller details to marketing@snom.com and we will be happy to add your USP Controller to the supported list.