splinter98/btsmarthub_devicelist

Retrieve a list of devices from a bt smarthub or bt smarthub 2 on a local network

BT Smarthub Device List v.0.2.1

Python package allowing for a BT Smart Hub or BT Smart Hub 2 router to be queried for devices. The package will output either all devices stored in the router's memory or just the devices connected at present as a list of dicts with the following keys:

• UserHostName (Device Name)
• PhysAddress (MAC Address)
• IPAddress (Last Known IP of Device)
• Active (Boolean for if the Device is Connected to the Router)

For use with a BT Smart Hub 2, set the smarthub_model flag to 2, for a BT Smart Hub 1 set the smarthub_model flag to 1. If you are not sure, leave the flag blank and it will attempt to determine the hub type.

If the router is a BT Smart Hub 2 and you set the include_connections flag to True then the additional keys will additionally be populated:

• ConnectionType (Ether | 2G | 5G fixed/wifi 2.4Ghz/wifi 5Ghz)
• ParentName (Name of parent device is connecting through - e.g. wifi disks name)
• ParentPhysAddress ( MAC Address of the parent)

NB. If a device hasn't been connected for a while, is a disk or the router itself then the additional fields may be set to 'Unknown'

Seeking PR for the following devices:

BT Smart Hub (Home Hub 6B)

Installation

$ pip install btsmarthub_devicelist

Example

from btsmarthub_devicelist import BTSmartHub
smarthub = BTSmartHub(router_ip='192.168.1.254', smarthub_model=1)
device_list = smarthub.get_devicelist(only_active_devices=True, include_connections=True)
print(devicelist)