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