Metadata-Version: 2.1
Name: pyRockBlock
Version: 1.0.5
Summary: The definitive RockBLOCK Python 3 package.
Home-page: https://github.com/cathedral30/pyRockBlock
Author: Henry Cooper
Author-email: cooper.henry30@gmail.com
Project-URL: Documentation, https://cathedral30.github.io/pyRockBlock/
License-File: LICENSE

pyRockBLOCK
===========

**pyRockBLOCK** is the definitive Python 3 library for users of the RockBLOCK.

Requirements
============
- Python 3.6 and newer

Installation
============

This installs a package that can be used from Python (``import pyRockBlock``).

To install for all users on the system, administrator rights (root)
may be required.

From PyPI
---------
pyRockBlock can be installed from PyPI::

    python -m pip install pyRockBlock

Connecting to your RockBLOCK
============================

Once your rockBLOCK has been connected to your device via USB you will need to find its local address.

Linux / macOS
-------------

List all local devices::

    ls /dev/tty*

The name will vary depending on machine but will generally include USB in the name (e.g. ``/dev/ttyUSB0`` or ``/dev/tty.usbserial-FTH9I1S5``)

Windows
----------

List COM devices::

    mode

When connected to my machine the port was ``COM6`` but this will vary, it can be helpful to run the command before connecting to see what port becomes active.

Starting pyRockBLOCK
--------------------

Once you have the address of your device, create an instance of RockBlock and call the connect method::

    from pyRockBlock import RockBlock

    rb = RockBlock(<device address>)
    rb.connect()
