A python library for Sakura Communication Module
Python
Clone or download
Latest commit 1f03eac Jun 1, 2018

README.md

Python library for SakuraIO travis-ci

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

Docs

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

For Hardware

It currently tested with Raspberry Pi only.

Requirements

Python2

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

Python3

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

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())

Serial (UART)

from sakuraio.hardware.rpi import SakuraIOSerial

sakuraio = SakuraIOSerial("/dev/ttyS0")
print(sakuraio.get_unique_id())

NOTE

Disable serial console by using raspi-config.

output

16X0000001