api_pitop_peripheral_devices.rst

API - pi-top Peripheral Devices

pi-topPROTO+

This module provides 2 classes - a simple way to use a pi-topPROTO+'s onboard ADC (analog-to-digital converter), and another to use it as a distance sensor.

These classes will work with original pi-top, pi-topCEED and pi-top [3]. pi-top [4] does not support the pi-topPROTO+'s modular rail connector, and so will not work.

Using the pi-topPROTO+ as a Distance Sensor

../examples/protoplus/distance_sensor.py

Class Reference: pi-topPROTO+ Distance Sensor

pitop.protoplus.sensors.DistanceSensor

Using the pi-topPROTO+'s onboard ADC

../examples/protoplus/adc.py

Class Reference: pi-topPROTO+ ADC Probe

pitop.protoplus.adc.ADCProbe

pi-topPULSE

This module provides a simple way to use a pi-topPULSE, and will work with any Raspberry Pi and/or pi-top.

The hardware representation of each color is 5 bits (i.e. only 32 different values). Without gamma correction, this would mean the actual color value changes only every 8th color intensity value. This module applies gamma correction, which means that pixels with seemingly different intensities actually have the same.

Using the pi-topPULSE's microphone

../examples/pulse/mic-demo.py

Using the pi-topPULSE's LED matrix: Test colors

../examples/pulse/leds-test_colors.py

Using the pi-topPULSE's LED matrix: Fancy Light Show!

../examples/pulse/leds-fancy_demo.py

Using the pi-topPULSE's LED matrix: Showing CPU temperature

../examples/pulse/leds-cpu_temp.py

Using the pi-topPULSE's LED matrix: Showing CPU usage

../examples/pulse/leds-cpu_usage.py

Module Reference: pi-topPULSE Configuration

pitop.pulse.configuration

Module Reference: pi-topPULSE LED Matrix

pitop.pulse.ledmatrix

Module Reference: pi-topPULSE Microphone

pitop.pulse.microphone

Advanced: EEPROM

The pi-topPULSE contains an EEPROM which was programmed using this settings file. during factory production.

See the Raspberry Pi Foundation's HAT Github repository for more information.