pineworkslabs 0.2.0

An access layer for the Pineworks Labs RP2040 GPIO board

Pineworks Labs Breakout Interface

Installation

pip install pineworkslabs

RP2040 GPIO Standalone

The RP2040 GPIO is a standalone module which uses the telemetrix library to interface over serial.

Importing

To import this package, run:

import pineworkslabs.GPIO as GPIO

Connecting to the GPIO

When the package is imported on a connected PC, the setup code will find a compatible GPIO board on a connected COM port.

Example: blink an LED

import pineworkslabs.GPIO as GPIO
import time
GPIO.setmode(GPIO.PINEWORKS)

pin = 20

while True:
    try:
        GPIO.setup(pin, GPIO.OUT)
        GPIO.output(pin, GPIO.HIGH)
        time.sleep(0.25)
        GPIO.output(pin, GPIO.LOW)
        time.sleep(0.25)
    except KeyboardInterrupt:
        GPIO.cleanup()

Raspberry Pi 4 / LePotato

Pineworks Labs legacy GPIO boards are a breakout module to be used with a Raspberry Pi 4+ or a Libre Computer Board (LePotato AML-905X-CC-V1.0-A).

Importing

To import this package on the RPi or LePotato, run:

import pineworkslabs.RPi as GPIO

Setting the mode

The relevant difference between the Raspberry Pi and the LePotato for this package is the GPIO pinout. Use the following command to set the appropriate pinout lookup table:

setmode(RASPBERRY_PI_LOOKUP)

or

setmode(LE_POTATO_LOOKUP)

Not all pins are available for output, depending on the mode.

Reading and writing pins

To read a pin, first set it up using the IN flag, then read it with input.

pin: int | str = 20
setup(pin, IN)
print(input(pin))

Similarly, to write a pin, set it up using the OUT flag, then write to it with output.

pin: int | str = 20
setup(pin, OUT)
output(pin, HIGH)

Cleaning up

To reset all pins to LOW, run:

cleanup()

Example: blink an LED (LePotato)

import pineworkslabs.RPi as GPIO
import time
GPIO.setmode(GPIO.LE_POTATO_LOOKUP)

pin = 20

while True:
    try:
        GPIO.setup(pin, GPIO.OUT)
        GPIO.output(pin, GPIO.HIGH)
        time.sleep(0.25)
        GPIO.output(pin, GPIO.LOW)
        time.sleep(0.25)
    except KeyboardInterrupt:
        GPIO.cleanup()

Acknowledgements

We are indebted to the work of the telemetrix team for serial connectivity between the PC and the GPIO board, and the gpiod team for the interface between the Raspberry Pi/LePotato and the GPIO.