The HDC protocol

The purpose of the Host Device Communication protocol is to simplify the communication between the firmware of a device with severely limited computing resources and the software on the computer to which it's connected via a serial communication link, like UART / USB-CDC / Virtual COM Port.

Python implementation of the HDC protocol

The hdcproto package contains the Python implementation of the HDC protocol, and it's mainly meant for the implementation of HDC-host software.

Installation

The hdcproto package is currently in pre-alpha stage, thus might be not listed by default in your graphical package management tool.
You can install it into your project's virtual environment via the usual command:

pip install hdcproto

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ hdcproto

pip install --index-url https://test.pypi.org/simple/ --no-deps hdcproto

Usage

The hdcproto.host.proxy module implements generic proxy base-classes that can be used as building blocks to define proxy-classes that are specific for a given device and provide a convenient API for the HDC-host software to interact with the HDC-device.

Have a look at the hdcproto.demo.minimal sub-package, where you'll see an example of how proxy-classes are defined and how they are used to communicate with an HDC-device running the Demo_Minimal firmware example.