Huawei B525 Python API

As mentioned in my last post I was tinkering with the Optus provided Huawei B525 router features.
I've now manged to implement a few commands and MAC filtering via a Python2 API.

So far I'm using it to:
  1. Monitor my usage (I have a 500 GB cap)
  2. Implement time scheduling for my kids devices
Here's my usage display in Grafana.
I run OpenHab and persist the data from the Router using the python API into an Influxdb database that Grafana uses. Here's my current Grafana display:



The API will work with the following model:
  • B525s-65a
And may work with these others:
  • B618s-22d
  • B715s-23c
So far I've got MAC filtering implemented and a few API's to get traffic and other information.

Currently supported calls:
GET Requests
----------
getInfo()       => api/device/information
getTraffic()    => api/monitoring/traffic-statistics
getStats()      => api/monitoring/month_statistics")
getClients()    => api/wlan/host-list
getAllClients() => api/lan/HostInfo
getSignal()     => api/device/signal
getMacFilter()  => api/security/mac-filter
getLanSettings()=> api/dhcp/settings
getStaticHosts()=> api/dhcp/static-addr-info

POST Requests
-------------
doReboot()
doPowerOff()
setDenyMacFilter(macs)
setAllowMacFilter(macs)
setMacFilterOff()
setDhcpOff()
setDhcpOn(startAddress, endAddress, leaseTime=86400)
setLanAddress(ipaddress, netmask='255.255.255.0', url='homerouter.cpe')
setManualDns(primaryDns, secondaryDns='')
setAutomaticDns()
setAllLanSettings(settings)
setStaticHosts(settings)
Example usage is as follows:
router = B525Router(router='192.168.8.1', username='admin', password='xxx')

#Get Router information, example result below.
router.getInfo()

#Set DNS to Google
router.setManualDns('8.8.8.8', '8.8.4.4')

#Deny macs
router.setDenyMacFilter(['xx:xx:xx:xx:xx:xx','yy:yy:yy:yy:yy:yy', ...])
Router information returned from getInfo():
<response>
    <DeviceName>B525s-65a</DeviceName>
    <SerialNumber>xxx</SerialNumber>
    <Imei>xxx</Imei>
    <Imsi>xxx</Imsi>
    <Iccid>xxx</Iccid>
    <Msisdn/>
    <HardwareVersion>WL2B520M</HardwareVersion>
    <SoftwareVersion>11.189.63.00.74</SoftwareVersion>
    <WebUIVersion>21.100.44.00.03</WebUIVersion>
    <MacAddress1>XX:XX:XX:XX:XX:XX</MacAddress1>
    <MacAddress2/>
    <WanIPAddress>99.99.99.99</WanIPAddress>
    <wan_dns_address>99.99.99.99,99.99.99.99</wan_dns_address>
    <WanIPv6Address/>
    <wan_ipv6_dns_address/>
    <ProductFamily>LTE</ProductFamily>
    <Classify>cpe</Classify>
    <supportmode>LTE|WCDMA|GSM</supportmode>
    <workmode>LTE</workmode>
    <submask>255.255.255.255</submask>
</response>

Comments

  1. Veronica BrandtApril 10, 2019 at 12:36 PM

    This sounds fantastic! I would love to be able to keep tabs on internet usage amongst my family. I have the same router and I have a Raspberry Pi. Sounds like much to learn to do this though.

    ReplyDelete
  2. JarJarBinkxNovember 8, 2019 at 8:33 PM

    Hi, i need access to the Ethernet settings which i can't access with the Optus B525, would u know how i can do this the tab is mean't to be there just isn't because the device is with Optus.

    ReplyDelete
    Replies
    1. HamishFebruary 2, 2020 at 8:45 AM

      Hi JarJarBinkx,

      I've now added the ethernet settings to the Python API.

      In terms of the Modem web screens it doesn't look like the tab is easy to reenable, the html pages aren't available for me.
      - /html/ethernetsettings.html
      - /html/ethernetstatus.html

      Delete

Post a Comment

Popular posts from this blog

Experience with Optus 4G wireless broadband

Image
Some background, where I try not to gripe about NBN... O NBN!, wherefore art thou NBN! That pretty much sums up my experience over the last year, having relocated from Sydney with a decent NBN connection, to an ADSL1 connection in the Gold Coast. I was then left waiting for either an ADSL2 port to free up (not likely to happen) or NBN to finally arrive. NBN was expected here in Dec-18 and is now due in Dec-19.... So with NBN delayed another year, I was well and truly over my current connection. For the record I had 6 Mbps download and 0.3 Mbps upload. So uploading a picture to facebook would kill my internet. It's hard to believe this can be sold in Australia as an adequate service.... right not griping, moving on. Thankfully this is all behind me with the introduction of Optus's 4G wireless broadband plans, which were released in November 2018 replacing the Vividwireless service. Based on our usage of around 380 GB per month, I selected the the $80 500 GB plan. The ...
Read more

Port Forwarding on Optus 4G B525 router

Image
The port forwarding or "Virtual Server" settings are not available in the Optus customised web UI. However the underlying XML based API of the router still supports the function, at least for my B525s 65a model. So I've documented a couple of ways you can interact with the router API and set up port forwarding. Important!: Port forwarding will only work when the other device can access the private 10.*.*.* Optus IP Address of the router. I use it so my Optus mobile can access my home network. If you wanted to expose a service to the general internet then this likely won't work. Option 1 - Use the python API I've developed at  https://github.com/jinxo13/HuaweiB525Route r For those with scripting or programming experience Option 2 - Use Chrome and the Servistate plugin to interact with the B525's API directly I've provided a step by step guide - no programming experience is required Option 1 - Use the Python API Step 1 - Check the curre...
Read more

Huawei Modem/Router sending encrypted requests

This relates to my Huawei python API here . I'm adding a dedicated post on this as I expect it may be useful for others. This took me quite a while to get working and I couldn't find any working solutions online. This implements the javascript RSA encryption used for encrypting requests to be sent to the modem's underlying API in python. The javascript code is: function RSAEncrypt(text) { var m = pkcs1pad2(text,(this.n.bitLength()+7)>>3); if(m == null) return null; var c = this.doPublic(m); if(c == null) return null; var h = c.toString(16); if((h.length & 1) == 0) return h; else return "0" + h; } The python code I got working is: import uuid import hashlib import hmac from binascii import hexlify import math import base64 from Crypto.Cipher import PKCS1_v1_5 from Crypto.PublicKey.RSA import construct def rsa_encrypt(rsae, rsan, data): if (data is None or data == ''): return '' N = long(rsan,16) E = long(rsae,16) ...
Read more