Examples

All devices and services used in the following examples are taken from the TR-064 Description XML. Used actions are described in the XML refered with the SCPDURL element of each service. More details about the action can be obtained from the router manufacturer.

Devices/Services/Actions:

• InternetGatewayDevice

  • DeviceInfo

    • GetInfo
    • GetSecurityPort

• LANDevice

  • Hosts

    • GetHostNumberOfEntries/GetGenericHostEntry

  • WLANConfiguration

    • GetInfo/SetEnable

InternetGatewayDevice

DeviceInfo

Support urn:DeviceInfo-com:serviceId:DeviceInfo1.

GetInfo

Getting router information:

res = client.InternetGatewayDevice.DeviceInfo.GetInfo()
print('ManufacturerName', res.NewManufacturerName)
print('ManufacturerOUI', res.NewManufacturerOUI)
print('ModelName', res.NewModelName)
print('Description', res.NewDescription)

GetSecurityPort

Get port for secure access:

unsafe_client = tr064.Client('username', 'password', 'http://192.168.178.1:49000')
res = unsafe_client.InternetGatewayDevice.DeviceInfo.GetSecurityPort()

safe_client = tr064.Client('username', 'password', 'https://192.168.178.1:{}'.format(res.NewSecurityPort))

LANDevice

Hosts

GetHostNumberOfEntries/GetGenericHostEntry

List all assigned network devices:

number_of_entries = client.LANDevice.Hosts.GetHostNumberOfEntries()
for index in range(int(number_of_entries.NewHostNumberOfEntries)):
    host = client.LANDevice.Hosts.GetGenericHostEntry(NewIndex=index)
    print(host.NewIPAddress, host.NewMACAddress, host.NewHostName)

WLANConfiguration

GetInfo/SetEnable

Enable third WLAN device if not enabled:

info = client.LANDevice.WLANConfiguration[2].GetInfo()
if not bool(info.NewEnable):
    client.LANDevice.WLANConfiguration[2].SetEnable(NewEnable=1)