PyVLCB 0.1.1

A library for CBUS / VLCB communication

PyVLCB Python Software Library for CBUS / VLCB

This is a small software library for CBUS and VLCB using Python.

It's designed for use with the MERG CANUSB4 CBUS adapter.

Install

For most systems including a Raspberry Pi then Python is managed using virtual environment. To setup a virtual environment enter the following commands

mkdir ~/venv
python3 -m venv ~/venv/pyvlcb --system-site-packages

You will then need to run the following command to activate the virtual environment

source ~/venv/pyvlcb/bin/activate

To instally the latest release use

pip install pyvlcb

Development

The latest source code is available from GitHub. PyVLCB on GitHub.

Installing as a git submodule

To install the library, as a submodule in your own git project repository, then enter your project directory and run:

git submodule add https://github.com/penguintutor/pyvlcb.git lib/pyvlcb
pip install lib/pyvlcb

If you subsequently want to get the latest version of the library run a git pull then use the pip install command again.

Important To use as a submodule you must create your own git project first and install within the project folder.

Library Reference

See the link below for the library reference documentation PyVLCB Library Reference Documentation

Demo examples

Example code is stored within the demo folder available from GitHub. Copy these into your project folder to test the library and connectivity. The demos are created for a Raspberry Pi or other Linux computer. The USB port is hard-coded as /dev/ttyACM0 For other computers / USB ports then edit the python file directory and update the port statement.

More Details

For more details see: PenguinTutor PyVLCB library page

For an example of a program using this library see the PenguinTutor Pi SignalBox project page