Pingo provides a uniform API to program devices like the Raspberry Pi, BeagleBone Black, pcDuino etc. just like the Python DBAPI provides an uniform API for database programming in Python.
The API is object-oriented but easy to use: a board is an instance of a Board subclass. Every board has a dictionary called pins which lists all GPIO pins on the board. Each pin is an instance of a Pin subclass with attributes that you can inspect to learn about its capabilities.
The name Pingo is a tribute to Garoa Hacker Clube, where the project started (the words pingo and garoa are related in Portuguese). To our English-speaking friends we like to say that it means "pin, go!" -- the main purpose of this package.
Blink.py on an UDOO board:
import pingo
from time import sleep
board = pingo.udoo.Udoo()
led_pin = board.pins[13]
led_pin.set_mode(pingo.OUT)
while True:
led_pin.on()
sleep(1)
led_pin.off()
sleep(1)To do the same on a Arduino Yún, just change the line were the board is instantiated, and the pin numbers as needed:
import pingo
from time import sleep
board = pingo.arduino.yun.YunBridge() # <---
led_pin = board.pins[13]
led_pin.set_mode(pingo.OUT)
while True:
led_pin.on()
sleep(1)
led_pin.off()
sleep(1)In the examples above, pingo.udoo pingo.arduino.yun are drivers, and the respective Udoo and YunBridge are classes implementing the pingo.board.Board interface.
The following table lists the drivers currently planned or under development.
| Board | Type | Module/Package | Status | Notes |
|---|---|---|---|---|
| Arduino Firmata | remote | arduino.firmata | level 1 | requires firmata library on any Arduino board |
| Arduino Yún | on-board | arduino.yun | experim. | requires Bridge sketch on the Arduino Yún |
| BeagleBone Black | on-board | bbb | experim. | |
| Fantasma | fake | ghost | level 0 | not a real board, just a software fake for testing |
| Intel Galileo | on-board | galileo | none | |
| Raspberry Pi | on-board | rpi | level 0 | requires RPi.GPIO on the Raspberry Pi |
| pcDuino | on-board | pcduino | experim. | |
| UDOO | on-board | udoo | level 0 |
- on-board
- Pingo and user code run on the board itself, using the Python interpreter installed in it.
- remote
- Pingo and user code run on host computer connected to board, controlling the board remotely. Useful for boards that are unable to run Python, like the Arduino UNO.
- fake
- Pingo and user code run on host computer emulating a dummy board in software. Useful for testing base classes from
board.pyand for teaching and demonstration.
- level 0
- Digital I/O: get/set high/low status of digital pins (no PWM support).
- level 1
- Analog input: read values from analog pins.
- level 2
- PWM output: set variable value for digital pins with PWM capability.
- experiments
- Some Python experiments have been done with the board. See the
experiments/directory for code that may be helpful to start a new driver for a board. - none
- Nothing has been done. Great opportunity for you to contribute with experiments and/or start a new driver.