Build HAT Python library
Project description
Build HAT
The Python Build HAT library supports the Raspberry Pi Build HAT, an add-on board for the Raspberry Pi computer, which allows control of up to four LEGO® TECHNIC™ motors and sensors included in the SPIKE™ Portfolio.
Hardware
The Build HAT provides four connectors for LEGO® Technic™ motors and sensors from the SPIKE™ Portfolio. The available sensors include a distance sensor, a colour sensor, and a versatile force sensor. The angular motors come in a range of sizes and include integrated encoders that can be queried to find their position.
The Build HAT fits all Raspberry Pi computers with a 40-pin GPIO header, including — with the addition of a ribbon cable or other extension device — Raspberry Pi 400. Connected LEGO® Technic™ devices can easily be controlled in Python, alongside standard Raspberry Pi accessories such as a camera module.
Documentation
Library documentation: https://buildhat.readthedocs.io
Hardware documentation: https://www.raspberrypi.com/documentation/accessories/build-hat.html
Projects and inspiration: https://projects.raspberrypi.org/en/pathways/lego-intro
Installation
To install the Build HAT library, enter the following commands in a terminal:
pip3 install buildhat
Usage
See the detailed documentation for the Python objects available.
import time
from signal import pause
from buildhat import Motor
motor = Motor('A')
motor.set_default_speed(30)
print("Position", motor.get_aposition())
def handle_motor(speed, pos, apos):
print("Motor", speed, pos, apos)
motor.when_rotated = handle_motor
print("Run for degrees")
motor.run_for_degrees(360)
print("Run for seconds")
motor.run_for_seconds(5)
print("Run for rotations")
motor.run_for_rotations(2)
print("Start motor")
motor.start()
time.sleep(3)
print("Stop motor")
motor.stop()
pause()
Building locally
Using asdf:
asdf install
Then:
pip3 install . --user
Building the documentation
Instructions for regenerating the documentation can be found in
docs/README.md
. Briefly, assuming you have the appropriate python
modules installed:
$ (cd docs; make html)
will rebuild the documentation. The doc tree starts at docs/build/html/index.html
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file buildhat-0.7.0.tar.gz
.
File metadata
- Download URL: buildhat-0.7.0.tar.gz
- Upload date:
- Size: 160.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a0c30a9b9318a6e391afff971e99cdd8fb862e544941a0473f281fb11ff5c354 |
|
MD5 | cff76b052dba9ae7c866b427e6173bfa |
|
BLAKE2b-256 | d28d6b1f4db036d8afaa09adf55eeefc673c63fd4bd0d9e2f21fa04b625b13d3 |
File details
Details for the file buildhat-0.7.0-py3-none-any.whl
.
File metadata
- Download URL: buildhat-0.7.0-py3-none-any.whl
- Upload date:
- Size: 61.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | f06d555eabce4647a82c4de13fe1cded44c8906d8534bcdd7279f78190306799 |
|
MD5 | 7adb9a5bc00e45eb486fe1a3b5147f73 |
|
BLAKE2b-256 | ab9f7fc4f3b954431ff136f6d49d188ed0e0648a2faf444b22fde747cc2b51c9 |