Skip to main content

An interface to the tosr0x line of USB-controlled relays.

Project description

A Python module for communicating with ‘TOSR0x’ USB relay controllers available at []( and other online retailers.

The module is a wrapper around Python’s default serial module. It provides functionality to detect TOSR0x devices, set relay states and query relay states.


  • A TOSR0x USB relay controller, (2-relay model tested but should work with 2:8-relay models)
  • Linux (may work with other Unix variants)
  • Python serial module (should be installed by default)



python install

If using Debian or a derivative (Ubuntu) additional USB permissions may be required:

Add the user to the ‘dialout’ group:

>sudo usermod -G dialout -a <username>

Add a udev rules file to allow access to usb devices:

>cat /etc/udev/rules.d/50-usb.rules # allow access to usb devices for users in dialout group ‘SUBSYSTEM==”usb”, MODE=”0666”, GROUP=”dialout”


Call the handler function to return a list of tosr0x objects:

>import tosr0x >th = tosr0x.handler()

Testing USB serial device on /dev/ttyUSB0 Testing USB serial device on /dev/ttyUSB1 Testing USB serial device on /dev/ttyUSB2 Testing USB serial device on /dev/ttyUSB3 TOSR0x device found on /dev/ttyUSB3

>myTosr0x = th[0] >print myT0sr0x

<tosr0x.relayModule instance at 0xb68be46c>

Alternatively, specify a USB serial device:

>th = tosr0x.handler(‘/dev/ttyUSB3’)

Testing USB serial device on /dev/ttyUSB3 TOSR0x device found on /dev/ttyUSB3

Set relay states to either 0 or 1:

>myTosr0x.set_relay_position(1,1) True

>myTosr0x.set_relay_position(2,0) True

(Note: relay numbering starts at 1. Set the state of all relays by using relay number 0)

Get relay positions, (returned as a dict {relay : state}):

>myTosr0x.get_relay_positions() {1: 1, 2: 0}


This module will form the basis of my forthcoming thermostat framework, [braubuddy](

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


This version
History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
tosr0x-0.2.0.tar.gz (3.9 kB) Copy SHA256 hash SHA256 Source None Jan 27, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page