Git Browser for ODROID
Code Review Sign In
git.odroid.com / WiringPi2-Python / b1169c8364e0820ad3e8ef6122812c7ac288bf9c / . / README
blob: 2889e216abfbfb7e752d796da673f269cf150675 [file] [log] [blame]
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]1
2WiringPi: An implementation of most of the Arduino Wiring
3 functions for the Raspberry Pi
4
Philip Howard0429f1f2013-03-27 22:26:03 +0000[diff] [blame]5WiringPi2: WiringPi version 2 implements new functions for managing IO expanders.
6
Philip Howardb1169c82013-03-27 23:08:14 +0000[diff] [blame^]7Testing:
8 Build with gcc version 4.6.3 (Debian 4.6.3-14+rpi1)
9 Built against Python 2.7.2, Python 3.2.3
10
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]11Prerequisites:
12 You must have python-dev and python-setuptools installed
13 If you manually rebuild the bindings with swig -python wiringpi.i
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]14
15Get/setup repo:
Philip Howard0429f1f2013-03-27 22:26:03 +0000[diff] [blame]16 git clone https://github.com/Gadgetoid/WiringPi2-Python.git
Philip Howardfb7c8912013-03-27 22:48:19 +0000[diff] [blame]17 cd WiringPi2-Python
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]18
19Build & install with:
20 sudo python setup.py install
21
Philip Howardfb7c8912013-03-27 22:48:19 +0000[diff] [blame]22Or Python 3
23 sudo python3 setup.py install
24
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]25Class-based Usage:
Philip Howard0429f1f2013-03-27 22:26:03 +0000[diff] [blame]26 No classes have been created for this version yet.
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]27
28Usage:
Philip Howardb1169c82013-03-27 23:08:14 +0000[diff] [blame^]29 import wiringpi2
30 wiringpi2.wiringPiSetup // For sequential pin numbering, one of these MUST be called before using IO functions
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]31 OR
Philip Howardb1169c82013-03-27 23:08:14 +0000[diff] [blame^]32 wiringpi2.wiringPiSetupSys // For /sys/class/gpio with GPIO pin numbering
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]33 OR
Philip Howardb1169c82013-03-27 23:08:14 +0000[diff] [blame^]34 wiringpi2.wiringPiSetupGpio // For GPIO pin numbering
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]35
Philip Howard0429f1f2013-03-27 22:26:03 +0000[diff] [blame]36 Setting up IO expanders (This example was tested on a quick2wire board with one digital IO expansion board connected via I2C):
Philip Howardb1169c82013-03-27 23:08:14 +0000[diff] [blame^]37 wiringpi2.mcp23017Setup(65,0x20)
38 wiringpi2.pinMode(65,1)
39 wiringpi2.digitalWrite(65,1)
Philip Howard0429f1f2013-03-27 22:26:03 +0000[diff] [blame]40
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]41 General IO:
Philip Howardb1169c82013-03-27 23:08:14 +0000[diff] [blame^]42 wiringpi2.pinMode(1,1) // Set pin 1 to output
43 wiringpi2.digitalWrite(1,1) // Write 1 HIGH to pin 1
44 wiringpi2.digitalRead(1) // Read pin 1
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]45
46 Bit shifting:
Philip Howardb1169c82013-03-27 23:08:14 +0000[diff] [blame^]47 wiringpi2.shiftOut(1,2,0,123) // Shift out 123 (b1110110, byte 0-255) to data pin 1, clock pin 2
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]48
49 Serial:
Philip Howardb1169c82013-03-27 23:08:14 +0000[diff] [blame^]50 serial = wiringpi2.serialOpen('/dev/ttyAMA0',9600) // Requires device/baud and returns an ID
51 wiringpi2.serialPuts(serial,"hello")
52 wiringpi2.serialClose(serial) // Pass in ID
Philip Howard567ee002013-03-27 22:22:00 +0000[diff] [blame]53
54Full details at:
Philip Howard0429f1f2013-03-27 22:26:03 +0000[diff] [blame]55 http://www.wiringpi.com