import huawei_lte.router as lte
   import huawei_lte.xmlobjects as xmlobjects
   from huawei_lte.errors import RouterError
   
   #Connect to the router
   router = lte.B525Router('192.168.8.1')
   router.login(username='admin', password='xxx') #Throws RouterError on a login error


   #Get a list of what API calls appear to be are supported (GET requests only)
   response = router.features

   #Get the router detailed information
   response = router.device.info

   #Commands
   response = router.device.do_reboot()
   response = router.device.do_poweroff()

   #Custom API calls
   response = router.api('device/information') #GET call to http://<host>/api/device/information
   response = router.api('device/control', {'Control': 1}) #Sends the XML request as below
   response = router.api(url='device/control', data={'Control': 1}, encrypted=True) #Send an encrypted payload
   #Send the raw XML
   request = '<?xml version="1.0" encoding="UTF-8"?><request><Control>1</Control></request>'
   response = router.api('device/control', request)

   #Returns various information from the router
   response = router.device.info
   response = router.device.signal
   response = router.device.signal_strength #CUSTOM: Alternate signal strength determination
   response = router.device.circleled #not available on Optus B525
   response = router.device.status #Various device status values

   response = router.monitoring.traffic #Current traffic
   response = router.monitoring.stats #Monthly statistics
   response = router.monitoring.trafficalert #Monthly data alert settings
   response = router.monitoring.notifications

   response = router.security.timerule #Not available on Optus B525
   response = router.security.bridgemode #Not available on Optus B525

   response = route.user.last_login

   response = router.lan.clients #Currently connected clients
   response = router.lan.all_clients #All known clients
   response = router.lan.settings
   response = router.lan.static_hosts

   response = router.wan.port_forwards

   response = router.net.mode #Current supported 2G/3G/4G mode and bands
   response = router.net.modelist #Expanded list of supported bands, contains non-XML value lists
   response = router.net.modelist2 #CUSTOM: Provides an XML format friendly expanded list

   #Manage 2G/3G/4G options
   response = router.net.set_network_mode({'mode': 'AUTO'})
   response = router.net.set_network_mode({'mode': '2G'})
   response = router.net.set_network_mode({'mode': '3G'})
   response = router.net.set_network_mode({'mode': '4G'})
   response = router.net.set_lte_band({'bands': ['B40', 'B28', 'B7', 'B1', 'B3', 'B8']})
   response = router.net.set_network_band({'bands': ['W2100', 'GSM900', 'W850', 'GSM1800', 'GSM850', 'GSM1900', 'W1900', 'W900']})

   #Manage port forwarding
   response = router.wan.port_forwards
   response = router.wan.add_port_forward({
      'name':'IPSEC1',
      'startwanport':500,
      'startlanport':500,
      'localip': '192.168.8.11',
      'protocol': 'UDP'})
   response = router.wan.add_port_forward({
      'name':'IPSEC2',
      'startwanport':4500,
      'startlanport':4500,
      'localip': '192.168.8.11',
      'protocol': 'UDP'})
   response = router.wan.remove_port_forward({'name': 'IPSEC1'})
   response = router.wan.clear_port_forwards()

   #Manage LAN settings
   response = router.lan.settings
   response = router.lan.set_dns_auto() #DNS set automatically by router
   response = router.lan.set_dns({'primary': '192.168.8.11', 'secondary': '192.168.8.1'})
   response = router.lan.set_ipaddress({'ipaddress': '192.168.8.1', 'netmask': '255.255.255.0'}) #Sets the routers LAN IP Address
   response = router.lan.set_dhcp({'startaddress':'192.168.8.100', 'endaddress': '192.168.8.200'})
   response = router.lan.set_dhcp_off()
   
   #Manage static IP assignment
   response = router.lan.add_static_host([
      {'macaddress': '92:1b:46:9d:be:86', 'ipaddress': '192.168.8.100'},
      {'macaddress': '92:1b:46:9d:be:87', 'ipaddress': '192.168.8.102'}
      ])
   response = router.lan.remove_static_host({'macaddress': '92:1b:46:9d:be:86'})
   response = router.lan.clear_static_hosts()

   #Manage MAC filtering
   response = router.security.macfilter
   #Set filtering to Deny mode
   response = router.security.deny_macaddress(['92:1b:46:9d:be:86', '92:1b:46:9d:be:87'])
   #Set filtering to Allow mode
   response = router.security.allow_macaddress(['92:1b:46:9d:be:86', '92:1b:46:9d:be:87'])
   response = router.security.set_macfilter_off()

   #Manage DDNS settings
   response = router.wan.ddns
   response = router.wan.add_ddns({
      'username': 'bilbo.baggins@gmail.com',
      'password': 'elevenses',
      'domain': 'bilbo.ddns.net',
      'provider': 'No-IP.com'
   })
   response = router.wan.remove_ddns({'domain': 'bilbo.ddns.net'})
   #Change the DDNS password
   response = router.wan.edit_ddns({
      'username': 'bilbo.baggins@gmail.com',
      'password': 'smaug_rules',
      'domain': 'bilbo.ddns.net',
      'provider': 'No-IP.com'
   })

   #Manage monitoring
   response = router.monitoring.clear_stats()
   response = router.monitoring.set_trafficalert({
      'startday': 8, #Plan starts on the 8th of each month
      'datalimit': '500GB', #500GB Monthly data limit - can be specified in MB, GB
      'threshold': 90 #Alert at 90% of usage
      })

   #Change Ethernet settings
   response = router.ethernet.status #current ethernet connection status
   response = router.ethernet.connection #Friendly mode and connection state information
   response = router.ethernet.settings #Current ethernet settings

   #Automatically select the best ethernet mode (recommended default)
   response = router.ethernet.set_auto()
   #You can set all the settings below (apart from the static info)
   response = router.ethernet.set_auto({'username': 'fred', 'password': 'secret', 'authmode': 0})

   #LTE mode - so uses 3G or 4G
   response = router.ethernet.set_lan_only()
   
   #Connect with PPPOE 0=AUTO, 1=PAP, 2=CHAP
   response = router.ethernet.set_pppoe({'username': 'fred', 'password': 'secret', 'authmode': 0})
   
   #An IP address is provided automatically
   response = router.ethernet.set_dynamic() 
   #Get an assinged IP Address but override the provided DNS settings
   response = router.ethernet.set_dynamic({'primarydns': '8.8.8.8', 'secondarydns':'8.8.4.4'})
   #Use either PPOE or an assigned IP Address
   response = router.ethernet.set_ppoe_dynamic() 
   
   #Use a static IP Address
   response = router.ethernet.set_static({'ipaddress': '192.168.1.3', 'netmask': '255.255.255.0', 'gateway': '192.168.1.1', 'primarydns': '8.8.8.8', 'secondarydns': '8.8.4.4'})

   #Logout
   router.logout() #Throws RouterError on a logout error