BPI-SINOVOIP / BPI-WiringPi2-Python

Supports BananaPi BPI -M1 / M1Plus / M2 /
12 stars 8 forks source link

BPI-WiringPi2-Python README

This is a modified WiringPi2-Python for BPI M1 / M1Plus /M2. We call it BPI-WiringPi2-Python. It is based on the original WiringPi for Raspberry Pi created by Drogon. The modification is done by BPI-Team. The BPI-WiringPi2-Python API usage are the same to the WiringPi2-Pytho.

Testing: Build with gcc version 4.6.3 (Debian 4.6.3-14+rpi1) Built against Python 2.7.2, Python 3.2.3

Prerequisites: You must have python-dev and python-setuptools installed If you manually rebuild the bindings with swig -python wiringpi.i

YOU MUST FIRST INSTALL BPI-WiringPi!!

git clone https://github.com/BPI-SINOVOIP/BPI-WiringPi.git -b BPI_M1_M1Plus
cd BPI-WiringPi
chmod +x ./build
sudo ./build

Get/setup repo:

git clone https://github.com/BPI-SINOVOIP/BPI-WiringPi2-Python.git -b BPI_M1_M1Plus
cd BPI-WiringPi2-Python

Build & install with: sudo python setup.py install

Or Python 3: sudo python3 setup.py install

Class-based Usage: Description incoming!

Usage:

import wiringpi2

wiringpi2.wiringPiSetup() # For sequential pin numbering, one of these MUST be called before using IO functions
# OR
wiringpi2.wiringPiSetupSys() # For /sys/class/gpio with GPIO pin numbering
# OR
wiringpi2.wiringPiSetupGpio() # For GPIO pin numbering

Setting up IO expanders (This example was tested on a quick2wire board with one digital IO expansion board connected via I2C):

wiringpi2.mcp23017Setup(65,0x20)
wiringpi2.pinMode(65,1)
wiringpi2.digitalWrite(65,1)

General IO:

wiringpi2.pinMode(6,1) # Set pin 6 to 1 ( OUTPUT )
wiringpi2.digitalWrite(6,1) # Write 1 ( HIGH ) to pin 6
wiringpi2.digitalRead(6) # Read pin 6

Setting up a peripheral: WiringPi2 supports expanding your range of available "pins" by setting up a port expander. The implementation details of your port expander will be handled transparently, and you can write to the additional pins ( starting from PIN_OFFSET >= 64 ) as if they were normal pins on the Pi.

wiringpi2.mcp23017Setup(PIN_OFFSET,I2C_ADDR)

Soft Tone

Hook a speaker up to your Pi and generate music with softTone. Also useful for generating frequencies for other uses such as modulating A/C.

wiringpi2.softToneCreate(PIN)
wiringpi2.softToneWrite(PIN,FREQUENCY)

Bit shifting:

wiringpi2.shiftOut(1,2,0,123) # Shift out 123 (b1110110, byte 0-255) to data pin 1, clock pin 2

Serial:

serial = wiringpi2.serialOpen('/dev/ttyS2',115200) # Requires device/baud and returns an ID
wiringpi2.serialPuts(serial,"hello")
wiringpi2.serialClose(serial) # Pass in ID