Skip to main content

Nobø Hub / Nobø Energy Control TCP/IP Interface

Project description

Nobø Hub / Nobø Energy Control TCP/IP Interface

This system/service/software is not officially supported or endorsed by Glen Dimplex Nordic AS, and the authors/maintainer(s) are not official partner of Glen Dimplex Nordic AS

The API (v1.1) for Nobø Hub can be found here

Quick Start

import asyncio
from pynobo import nobo

async def main():
    # Either call using the three last digits in the hub serial
    hub = nobo('123', loop=asyncio.get_event_loop()) 
    # or full serial and IP if you do not want to discover on UDP:
    hub = nobo('123123123123', '10.0.0.128', False, loop=asyncio.get_event_loop())

    # Connect to the hub
    await hub.start()

    # Inspect what you get
    def update(hub):
        print(hub.hub_info)
        print(hub.zones)
        print(hub.components)
        print(hub.week_profiles)
        print(hub.overrides)
        print(hub.temperatures)

    # Listen for data updates - register before getting initial data to avoid race condition
    hub.register_callback(callback=update)

    # Get initial data
    update(hub)

    # Hang around and wait for data updates
    await asyncio.sleep(60)

    # Stop the connection
    await hub.stop()

asyncio.run(main())

Available functionality

  • nobo class - When called it will initialize logger and dictionaries, connect to hub and start daemon thread.
  • nobo.API class - All the commands and responses from API v1.1, Some with sensible names, others not yet given better names.
  • nobo.DiscoveryProtocol - An asyncio.DatagramProtocol used to discover Nobø Ecohubs on the local network.

Discover and test connection

It is possible to discover hubs on the local network, and also test connectivity, before starting the background tasks.

# Discover all hubs on local network
hubs = await nobo.async_discover_hubs()

# Test connection to the first
(serial, ip) = hubs.pop()
hub = nobo(serial + '123', ip, False, loop=asyncio.get_event_loop())
await hub.async_connect_hub(ip=test_ip, serial=self.serial)

# Then start the background tasks
await hub.start()

# Or just close the connection right away
await hub.close()

Background Tasks

Calling start() will first try to discover the Nobø Ecohub on the local network, unless discover is set to False, which required IP address and full serial (12 digits). If an IP address is provided, or the hub is discovered, it will attempt to connect to it, and if successful, start the following tasks:

  • keep_alive - Send a periodic keep alive message to the hub
  • socket_receive - Handle incoming messages from the hub

If the connection is lost, it will attempt to reconnect.

Command Functions

These functions sends commands to the hub.

  • async_send_command - Send a list of command string(s) to the hub
  • async_create_override - Override hub/zones/components
  • async_update_zone - Update the name, week profile, temperature or override allowing for a zone.

Dictionary helper functions

These functions simplifies getting the data you want from the dictionaries. They do not perform any I/O, and can safely be called from the event loop.

  • get_week_profile_status - Get the status of a week profile at a certain time in the week
  • get_current_zone_mode - Get the mode of a zone at a certain time
  • get_current_component_temperature - Get the current temperature from a component
  • get_current_zone_temperature - Get the current temperature from (the first component in) a zone

Backwards compatibility

Synchronous wrapper methods are available for compatibility with v1.1.2, but it is recommended to switch to the async methods. If loop is not provided, initializing will start the async event loop in a daemon thread, discover and connect to hub before returning as before.

import time
from pynobo import nobo

def main():
    # Either call using the three last digits in the hub serial
    hub = nobo('123')
    # or full serial and IP if you do not want to discover on UDP:
    hub = nobo('123123123123', '10.0.0.128', False)

    # Inspect what you get
    def update(hub):
        print(hub.hub_info)
        print(hub.zones)
        print(hub.components)
        print(hub.week_profiles)
        print(hub.overrides)
        print(hub.temperatures)

    # Listen for data updates - register before getting initial data to avoid race condition
    hub.register_callback(callback=update)

    # Get initial data
    update(hub)

    # Hang around and wait for data updates
    time.sleep(60)

main()

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pynobo, version 1.3.0
Filename, size File type Python version Upload date Hashes
Filename, size pynobo-1.3.0-py3-none-any.whl (26.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pynobo-1.3.0.tar.gz (28.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page