pitop
stable
1. Getting Started
1.1. Installing the SDK
1.1.1. pi-topOS
1.1.2. Using apt
1.1.3. Using PyPI
1.1.4. Building from source
1.2. Checking that the SDK is installed and working
1.3. What next!?
2. Overview
2.1. pi-top [4]
2.1.1. Interacting with onboard pi-top [4] hardware
2.1.2. Physical computing with pi-top [4]
2.2. pi-top laptops
2.2.1. Interacting with onboard pi-top laptop hardware
2.2.2. Using peripherals with a pi-top laptop
2.3. pi-topCEED
2.3.1. Interacting with onboard pi-topCEED hardware
2.3.2. Using peripherals with a pi-topCEED
3. Key Concepts
3.1. pi-top Maker Architecture
3.1.1. Inputs and Outputs
3.1.2. Digital and Analog
3.1.3. Ports and Pins
3.1.3.1. Digital Ports
3.1.3.2. Analog Ports
3.1.3.3. Motor Ports
3.1.3.4. ServoMotor Ports
3.1.3.5. I2C Ports
3.1.4. Identifying PMA port for a component
3.1.4.1. Digital component
3.1.4.2. Analog component
3.1.4.3. Motor component
3.1.5. More Information
3.2. pi-top [4] Miniscreen
4. Recipes
4.1. PMA: Using a Button to Control an LED
4.2. Robotics Kit: DIY Rover
4.3. Robotics Kit: Robot - Moving Randomly
4.4. Robotics Kit: Robot - Line Detection
4.5. Displaying camera stream in pi-top [4]’s miniscreen
4.6. Robotics Kit: Robot - Control using Bluedot
4.7. Using the pi-topPULSE’s LED matrix to show the battery level
4.8. Choose a pi-top [4] miniscreen startup animation
5. API - pi-top Device
5.1. Pitop
5.1.1. Class Reference: Pitop
5.1.2. Using the Pitop object
5.1.2.1. Attaching objects and saving configuration to a file
5.1.2.2. Loading an existing configuration
5.2. pi-top Battery
5.2.1. Class Reference: pi-top Battery
5.3. pi-top Display
5.3.1. Class Reference: pi-top Display
5.4. pi-top [4] Miniscreen
5.4.1. Using the Miniscreen’s OLED Display
5.4.1.1. Displaying text
5.4.1.2. Showing an image
5.4.1.3. Loop a GIF
5.4.1.4. Displaying an GIF once
5.4.1.5. Displaying an GIF once through frame by frame
5.4.1.6. Displaying an GIF looping in background
5.4.1.7. Handling basic 2D graphics drawing and displaying
5.4.1.8. Displaying a clock
5.4.1.9. Display a particle-based screensaver
5.4.1.10. Prim’s algorithm
5.4.1.11. 2-Player Pong Game
5.4.2. Class Reference: pi-top [4] Miniscreen
5.4.3. Using the Miniscreen’s Buttons
5.4.4. Class Reference: pi-top [4] Miniscreen Button
6. API - pi-top Maker Architecture (PMA) Components
6.1. Button
6.2. Buzzer
6.3. Encoder Motor
6.3.1. Parameters
6.4. LED
6.5. Light Sensor
6.6. Potentiometer
6.7. Servo Motor
6.8. Sound Sensor
6.9. Ultrasonic Sensor
7. API - pi-top Peripheral Devices
7.1. pi-topPROTO+
7.1.1. Using the pi-topPROTO+ as a Distance Sensor
7.1.2. Class Reference: pi-topPROTO+ Distance Sensor
7.1.3. Using the pi-topPROTO+’s onboard ADC
7.1.4. Class Reference: pi-topPROTO+ ADC Probe
7.2. pi-topPULSE
7.2.1. Using the pi-topPULSE’s microphone
7.2.2. Using the pi-topPULSE’s LED matrix: Test colors
7.2.3. Using the pi-topPULSE’s LED matrix: Fancy Light Show!
7.2.4. Using the pi-topPULSE’s LED matrix: Showing CPU temperature
7.2.5. Using the pi-topPULSE’s LED matrix: Showing CPU usage
7.2.6. Module Reference: pi-topPULSE Configuration
7.2.7. Module Reference: pi-topPULSE LED Matrix
7.2.8. Module Reference: pi-topPULSE Microphone
7.2.9. Advanced: EEPROM
8. API - System Peripheral Devices
8.1. USB Camera
8.1.1. Using a USB Camera to Access Image Data
8.1.2. Using a USB Camera to Capture Video
8.1.3. Adding Motion Detection to a USB Camera
8.1.4. Processing Camera Frame
8.1.5. Processing Camera Frame Stream with OpenCV (Convert to grayscale)
8.1.6. Ball Color Detection with OpenCV
8.1.7. Class Reference: USB Camera
8.2. Keyboard Button
8.2.1. Class Reference: KeyboardButton
8.2.2. Special Key Names
9. Command-Line Tools (CLI)
9.1. ‘pi-top’ Command
9.1.1. pi-top battery
9.1.2. pi-top display
9.1.2.1. pi-top display brightness
9.1.2.2. pi-top display backlight
9.1.2.3. pi-top display blank_time
9.1.3. pi-top devices
9.1.4. pi-top imu
9.1.5. pi-top oled
9.1.5.1. pi-top oled display
9.1.5.2. pi-top oled spi
9.1.6. pi-top support
9.1.6.1. pi-top support links
9.1.6.2. pi-top support health_check
10. 🧪 Labs - Experimental APIs ⚠️
10.1. Web
10.1.1. Servers
10.1.1.1. WebServer
10.1.1.2. WebController
10.1.1.3. RoverWebController
10.1.2. Blueprints
10.1.2.1. BaseBlueprint
10.1.2.2. WebComponentsBlueprint
10.1.2.3. MessagingBlueprint
10.1.2.4. VideoBlueprint
10.1.2.5. ControllerBlueprint
10.1.2.6. RoverControllerBlueprint
11. More Information
11.1. Frequently Asked Questions
11.1.1. How does this SDK work?
11.1.2. What is PMA?
11.1.3. I keep getting an Exception - what is the problem?
11.1.4. Where did this SDK come from?
11.1.5. I was using an older version of the Python libraries. How can I update to use this SDK?
11.1.6. I lost my miniscreen menu - where is it?
11.2. API Changes
11.3. Contributing
11.4. References
11.5. Requirements
11.6. License
pitop
Docs
»
Index
Edit on GitHub
Index
A
|
B
|
C
|
D
|
E
|
F
|
G
|
H
|
I
|
K
|
L
|
M
|
O
|
P
|
R
|
S
|
T
|
U
|
V
|
W
|
Z
A
active_high (pitop.pma.Buzzer attribute)
(pitop.pma.LED attribute)
active_time (pitop.pma.Button attribute)
ADCProbe (class in pitop.protoplus.adc)
angle_range (pitop.pma.ServoMotor attribute)
B
BACK (pitop.pma.parameters.Direction attribute)
backlight (pitop.display.Display attribute)
backward() (pitop.pma.EncoderMotor method)
Battery (class in pitop.battery)
beep() (pitop.pma.Buzzer method)
blank() (pitop.display.Display method)
blanking_timeout (pitop.display.Display attribute)
blink() (pitop.pma.Buzzer method)
(pitop.pma.LED method)
bottom_left (pitop.miniscreen.Miniscreen attribute)
bottom_right (pitop.miniscreen.Miniscreen attribute)
bounding_box (pitop.miniscreen.Miniscreen attribute)
BRAKE (pitop.pma.parameters.BrakingType attribute)
braking_type (pitop.pma.EncoderMotor attribute)
BrakingType (class in pitop.pma.parameters)
brightness (pitop.display.Display attribute)
brightness() (in module pitop.pulse.ledmatrix)
Button (class in pitop.pma)
Buzzer (class in pitop.pma)
C
Camera (class in pitop.camera)
cancel_button (pitop.miniscreen.Miniscreen attribute)
capacity (pitop.battery.Battery attribute)
capture_image() (pitop.camera.Camera method)
center (pitop.miniscreen.Miniscreen attribute)
clear() (in module pitop.pulse.ledmatrix)
(pitop.miniscreen.Miniscreen method)
CLOCKWISE (pitop.pma.parameters.ForwardDirection attribute)
close() (pitop.pma.Button method)
(pitop.pma.Buzzer method)
(pitop.pma.LED method)
(pitop.pma.UltrasonicSensor method)
(pitop.protoplus.sensors.DistanceSensor method)
closed (pitop.pma.Button attribute)
(pitop.pma.Buzzer attribute)
(pitop.pma.LED attribute)
COAST (pitop.pma.parameters.BrakingType attribute)
config (pitop.pma.Button attribute)
(pitop.pma.Buzzer attribute)
(pitop.pma.LED attribute)
contrast() (pitop.miniscreen.Miniscreen method)
COUNTER_CLOCKWISE (pitop.pma.parameters.ForwardDirection attribute)
current_angle (pitop.pma.ServoMotor attribute)
current_frame() (pitop.camera.Camera method)
current_rpm (pitop.pma.EncoderMotor attribute)
current_speed (pitop.pma.EncoderMotor attribute)
(pitop.pma.ServoMotor attribute)
D
decrement_brightness() (pitop.display.Display method)
device (pitop.miniscreen.Miniscreen attribute)
Direction (class in pitop.pma.parameters)
disable_device() (in module pitop.pulse.configuration)
Display (class in pitop.display)
display() (pitop.miniscreen.Miniscreen method)
display_image() (pitop.miniscreen.Miniscreen method)
display_image_file() (pitop.miniscreen.Miniscreen method)
display_multiline_text() (pitop.miniscreen.Miniscreen method)
display_text() (pitop.miniscreen.Miniscreen method)
distance (pitop.pma.EncoderMotor attribute)
(pitop.pma.UltrasonicSensor attribute)
DistanceSensor (class in pitop.protoplus.sensors)
down_button (pitop.miniscreen.Miniscreen attribute)
draw() (pitop.miniscreen.Miniscreen method)
draw_image() (pitop.miniscreen.Miniscreen method)
draw_image_file() (pitop.miniscreen.Miniscreen method)
draw_multiline_text() (pitop.miniscreen.Miniscreen method)
draw_text() (pitop.miniscreen.Miniscreen method)
E
eeprom_enabled() (in module pitop.pulse.configuration)
enable_device() (in module pitop.pulse.configuration)
EncoderMotor (class in pitop.pma)
F
flip_h() (in module pitop.pulse.ledmatrix)
flip_v() (in module pitop.pulse.ledmatrix)
format (pitop.camera.Camera attribute)
FORWARD (pitop.pma.parameters.Direction attribute)
forward() (pitop.pma.EncoderMotor method)
forward_direction (pitop.pma.EncoderMotor attribute)
ForwardDirection (class in pitop.pma.parameters)
from_config() (pitop.pma.Button class method)
(pitop.pma.Buzzer class method)
(pitop.pma.LED class method)
from_file() (pitop.pma.Button class method)
(pitop.pma.Buzzer class method)
(pitop.pma.LED class method)
from_file_system() (pitop.camera.Camera class method)
from_usb() (pitop.camera.Camera class method)
G
get_brightness() (in module pitop.pulse.ledmatrix)
get_distance() (pitop.protoplus.sensors.DistanceSensor method)
get_frame() (pitop.camera.Camera method)
get_full_state() (pitop.battery.Battery class method)
get_pixel() (in module pitop.pulse.ledmatrix)
get_raw_distance() (pitop.protoplus.sensors.DistanceSensor method)
get_shape() (in module pitop.pulse.ledmatrix)
H
height (pitop.miniscreen.Miniscreen attribute)
held_time (pitop.pma.Button attribute)
hide() (pitop.miniscreen.Miniscreen method)
hold_repeat (pitop.pma.Button attribute)
hold_time (pitop.pma.Button attribute)
I
import_class() (pitop.pma.Button static method)
(pitop.pma.Buzzer static method)
(pitop.pma.LED static method)
in_range (pitop.pma.UltrasonicSensor attribute)
inactive_time (pitop.pma.Button attribute)
increment_brightness() (pitop.display.Display method)
is_active (pitop.miniscreen.Miniscreen attribute)
(pitop.pma.Button attribute)
(pitop.pma.Buzzer attribute)
(pitop.pma.LED attribute)
is_charging (pitop.battery.Battery attribute)
is_detecting_motion() (pitop.camera.Camera method)
is_full (pitop.battery.Battery attribute)
is_held (pitop.pma.Button attribute)
is_lit (pitop.pma.LED attribute)
is_pressed (pitop.keyboard.KeyboardButton attribute)
(pitop.miniscreen.miniscreen.MiniscreenButton attribute)
(pitop.pma.Button attribute)
is_recording() (in module pitop.pulse.microphone)
(pitop.camera.Camera method)
K
KeyboardButton (class in pitop.keyboard)
L
LED (class in pitop.pma)
lid_is_open (pitop.display.Display attribute)
LightSensor (class in pitop.pma)
M
max_distance (pitop.pma.UltrasonicSensor attribute)
max_rpm (pitop.pma.EncoderMotor attribute)
max_speed (pitop.pma.EncoderMotor attribute)
mcu_enabled() (in module pitop.pulse.configuration)
microphone_sample_rate_is_16khz() (in module pitop.pulse.configuration)
microphone_sample_rate_is_22khz() (in module pitop.pulse.configuration)
Miniscreen (class in pitop.miniscreen)
MiniscreenButton (class in pitop.miniscreen.miniscreen)
mode (pitop.miniscreen.Miniscreen attribute)
O
off() (in module pitop.pulse.ledmatrix)
(pitop.pma.Buzzer method)
(pitop.pma.LED method)
on() (pitop.pma.Buzzer method)
(pitop.pma.LED method)
own_state (pitop.camera.Camera attribute)
(pitop.Pitop attribute)
(pitop.pma.Button attribute)
(pitop.pma.Buzzer attribute)
(pitop.pma.EncoderMotor attribute)
(pitop.pma.LED attribute)
(pitop.pma.LightSensor attribute)
(pitop.pma.Potentiometer attribute)
(pitop.pma.ServoMotor attribute)
(pitop.pma.SoundSensor attribute)
(pitop.pma.UltrasonicSensor attribute)
P
pin (pitop.pma.Button attribute)
(pitop.pma.Buzzer attribute)
(pitop.pma.LED attribute)
(pitop.pma.UltrasonicSensor attribute)
Pitop (class in pitop)
pitop.pulse.configuration (module)
pitop.pulse.ledmatrix (module)
pitop.pulse.microphone (module)
play_animated_image() (pitop.miniscreen.Miniscreen method)
play_animated_image_file() (pitop.miniscreen.Miniscreen method)
poll() (pitop.protoplus.adc.ADCProbe method)
position (pitop.pma.Potentiometer attribute)
Potentiometer (class in pitop.pma)
power() (pitop.pma.EncoderMotor method)
prepare_image() (pitop.miniscreen.Miniscreen method)
pressed_time (pitop.pma.Button attribute)
print_config() (pitop.pma.Button method)
(pitop.pma.Buzzer method)
(pitop.pma.LED method)
print_state() (pitop.pma.Button method)
(pitop.pma.Buzzer method)
(pitop.pma.LED method)
pull_up (pitop.pma.Button attribute)
R
raw_distance (pitop.protoplus.sensors.DistanceSensor attribute)
read_all() (pitop.protoplus.adc.ADCProbe method)
read_value() (pitop.protoplus.adc.ADCProbe method)
reading (pitop.pma.LightSensor attribute)
(pitop.pma.SoundSensor attribute)
record() (in module pitop.pulse.microphone)
refresh() (pitop.miniscreen.Miniscreen method)
reset() (pitop.miniscreen.Miniscreen method)
reset_device_state() (in module pitop.pulse.configuration)
rotation() (in module pitop.pulse.ledmatrix)
rotation_counter (pitop.pma.EncoderMotor attribute)
run_tests() (in module pitop.pulse.ledmatrix)
S
save() (in module pitop.pulse.microphone)
save_config() (pitop.pma.Button method)
(pitop.pma.Buzzer method)
(pitop.pma.LED method)
select_button (pitop.miniscreen.Miniscreen attribute)
ServoMotor (class in pitop.pma)
set_all() (in module pitop.pulse.ledmatrix)
set_bit_rate_to_signed_16() (in module pitop.pulse.microphone)
set_bit_rate_to_unsigned_8() (in module pitop.pulse.microphone)
set_control_to_hub() (pitop.miniscreen.Miniscreen method)
set_control_to_pi() (pitop.miniscreen.Miniscreen method)
set_debug_print_state() (in module pitop.pulse.ledmatrix)
set_max_fps() (pitop.miniscreen.Miniscreen method)
set_microphone_sample_rate_to_16khz() (in module pitop.pulse.configuration)
set_microphone_sample_rate_to_22khz() (in module pitop.pulse.configuration)
set_pixel() (in module pitop.pulse.ledmatrix)
set_power() (pitop.pma.EncoderMotor method)
set_sample_rate_to_16khz() (in module pitop.pulse.microphone)
set_sample_rate_to_22khz() (in module pitop.pulse.microphone)
set_target_rpm() (pitop.pma.EncoderMotor method)
set_target_speed() (pitop.pma.EncoderMotor method)
setting (pitop.pma.ServoMotor attribute)
should_redisplay() (pitop.miniscreen.Miniscreen method)
show() (in module pitop.pulse.ledmatrix)
(pitop.miniscreen.Miniscreen method)
size (pitop.miniscreen.Miniscreen attribute)
sleep() (pitop.miniscreen.Miniscreen method)
smooth_acceleration (pitop.pma.ServoMotor attribute)
SoundSensor (class in pitop.pma)
source (pitop.pma.Buzzer attribute)
(pitop.pma.LED attribute)
source_delay (pitop.pma.Buzzer attribute)
(pitop.pma.LED attribute)
speaker_enabled() (in module pitop.pulse.configuration)
spi_bus (pitop.miniscreen.Miniscreen attribute)
start() (in module pitop.pulse.ledmatrix)
start_detecting_motion() (pitop.camera.Camera method)
start_handling_frames() (pitop.camera.Camera method)
start_video_capture() (pitop.camera.Camera method)
state (pitop.pma.Button attribute)
(pitop.pma.Buzzer attribute)
(pitop.pma.LED attribute)
stop() (in module pitop.pulse.ledmatrix)
(in module pitop.pulse.microphone)
(pitop.pma.EncoderMotor method)
(pitop.pma.ServoMotor method)
stop_animated_image() (pitop.miniscreen.Miniscreen method)
stop_detecting_motion() (pitop.camera.Camera method)
stop_handling_frames() (pitop.camera.Camera method)
stop_video_capture() (pitop.camera.Camera method)
sweep() (pitop.pma.ServoMotor method)
T
target_angle (pitop.pma.ServoMotor attribute)
target_rpm() (pitop.pma.EncoderMotor method)
target_speed (pitop.pma.ServoMotor attribute)
threshold_distance (pitop.pma.UltrasonicSensor attribute)
time_remaining (pitop.battery.Battery attribute)
toggle() (pitop.pma.Buzzer method)
(pitop.pma.LED method)
top_left (pitop.miniscreen.Miniscreen attribute)
top_right (pitop.miniscreen.Miniscreen attribute)
torque_limited (pitop.pma.EncoderMotor attribute)
U
UltrasonicSensor (class in pitop.pma)
unblank() (pitop.display.Display method)
up_button (pitop.miniscreen.Miniscreen attribute)
V
value (pitop.pma.Button attribute)
(pitop.pma.Buzzer attribute)
(pitop.pma.LED attribute)
(pitop.pma.LightSensor attribute)
(pitop.pma.Potentiometer attribute)
(pitop.pma.SoundSensor attribute)
(pitop.pma.UltrasonicSensor attribute)
values (pitop.pma.Button attribute)
(pitop.pma.Buzzer attribute)
(pitop.pma.LED attribute)
visible (pitop.miniscreen.Miniscreen attribute)
W
wait_for_active() (pitop.pma.Button method)
wait_for_in_range() (pitop.pma.UltrasonicSensor method)
wait_for_inactive() (pitop.pma.Button method)
wait_for_out_of_range() (pitop.pma.UltrasonicSensor method)
wait_for_press() (pitop.pma.Button method)
wait_for_release() (pitop.pma.Button method)
wake() (pitop.miniscreen.Miniscreen method)
wattage (pitop.battery.Battery attribute)
wheel_circumference (pitop.pma.EncoderMotor attribute)
wheel_diameter (pitop.pma.EncoderMotor attribute)
when_activated (pitop.pma.Button attribute)
when_deactivated (pitop.pma.Button attribute)
when_held (pitop.pma.Button attribute)
when_in_range (pitop.pma.UltrasonicSensor attribute)
when_out_of_range (pitop.pma.UltrasonicSensor attribute)
when_pressed (pitop.keyboard.KeyboardButton attribute)
(pitop.miniscreen.miniscreen.MiniscreenButton attribute)
(pitop.pma.Button attribute)
when_released (pitop.keyboard.KeyboardButton attribute)
(pitop.miniscreen.miniscreen.MiniscreenButton attribute)
(pitop.pma.Button attribute)
when_system_controlled (pitop.miniscreen.Miniscreen attribute)
when_user_controlled (pitop.miniscreen.Miniscreen attribute)
width (pitop.miniscreen.Miniscreen attribute)
Z
zero_point (pitop.pma.ServoMotor attribute)
Read the Docs
v: stable
Versions
latest
stable
v0.32.0-1
v0.31.0-4
v0.31.0-3
v0.31.0-2
v0.31.0-1
v0.30.0-1
v0.29.0-2
v0.29.0-1
v0.28.0-1
v0.27.1-1
v0.26.3-1
v0.26.2-1
v0.26.1-1
v0.26.0-1
v0.25.0-1
v0.24.3-1
v0.24.2-1
v0.24.1-3
v0.24.1-1
v0.24.0-1
v0.23.0-1
v0.22.0-1
v0.21.0-1
v0.20.3-2
v0.20.3-1
v0.20.2-1
v0.20.1-1
v0.20.0-2
v0.19.0
v0.18.12
v0.18.11
v0.18.10
v0.18.9
v0.18.7
v0.18.6
v0.18.5
v0.18.4
v0.18.3
v0.18.2
v0.18.1
v0.18.0
v0.17.1
v0.17.0
v0.16.6
v0.16.5
v0.16.4
0.16.2
Downloads
pdf
html
epub
On Read the Docs
Project Home
Builds
Free document hosting provided by
Read the Docs
.