kikuzo / python-sakuraio

A python library for Sakura Communication Module

Python library for SakuraIO

WARNING: This library is under development with destructive changes.

Overview

This library contains two functions. One is to connect to Sakura Communication Modules (for Hardware). Another one is to connect to Platform API in https://api.sakura.io/ (for Service).

Documentation

For API documentation, usage and examples see files in the "./doc" directory. The ".rst" files can be read in any text editor or being converted to HTML or PDF using Sphinx. An HTML version is online at

http://python-sakuraio.readthedocs.io/

For Hardware

It currently supports I2C (SMBus) ONLY, and tested with Raspberry Pi.

Requirements

Python2

• Python = 2.7
• python-smbus (for I2C)
• python-rpi.gpio (for GPIO on Raspberry Pi)

Python3

• Python >= 3.4
• python3-smbus (for I2C)
• python3-rpi.gpio (for GPIO on Raspberry Pi)

Install

If you want to use python3 it may be required replace pip to pip3.

# From PyPi
sudo pip install sakuraio
# From Github.com
sudo pip install -e git+https://github.com/sakuraio/python-sakuraio.git#egg=sakuraio

Example

I2C (SMBus)

from sakuraio.hardware.rpi import SakuraIOSMBus

sakuraio = SakuraIOSMBus()
print(sakuraio.get_unique_id())

NOTE

DO NOT update linux kernel from Linux raspberrypi 4.4.50-v7+.

It is reported that OSError: [Errno 121] Remote I/O error occurs with later version.

SPI (GPIO)

from sakuraio.hardware.rpi import SakuraIOGPIO

sakuraio = SakuraIOGPIO()
print(sakuraio.get_unique_id())

output

16X0000001