Welcome to the Jam HAT repo! Here you'll find example code to get you started with the Jam Hat.

For assembly instructions please refer to our Getting Started Guide.

The Jam Hat has been included in version 1.5 of GPIO Zero.

Ensure your version of GPIO Zero is up to date by opening a terminal window and typing:

sudo apt-get update
sudo apt-get install python3-gpiozero python-gpiozero

From there you can add the Jam Hat into your Python script by using.

# Import the JamHat from gpiozero along with sleep from time.
from gpiozero import JamHat
from time import sleep

# Make the JamHat object.
jamhat = JamHat()

# Turn on the JamHat lights and buzzer, wait for 1 second and then turn it off.
jamhat.on()
sleep(1)
jamhat.off()

For more usage please refer to the Getting Started Guide or the GPIO Zero docs.

For other projects you may want to use a library like RPi.GPIO in which case you will need to set up the pins by hand. The table below shows the pin numbers for BCM, Board and the matching GPIO Zero objects.

For example to set up the Red LED using RPi.GPIO:

# mport the library
import RPi.GPIO as GPIO

# Set the pin mode to be BCM
GPIO.setmode(GPIO.BCM)

# Set LED1 to be an output.
GPIO.setup(5,GPIO.OUT)

# Turn LED1 on.
GPIO.output(5,1)

There are several scripts here to show you what you can do with the Jam Hat.

This sample script shows you how to cycle through the leds, each led having a set pitch, then playing the pitch on the buzzer.

This sample script shows you how to make the buzzer buzz with the push of a button.

This sample script shows you how to use the buttons to create a simple counter.

Walk through the LEDs on the board.

Play the Mario Theme tune via the Buzzer. This currently uses RPi.GPIO but will be transferred over into GPIO Zero soon.

If you have an issue with the Jam Hat, please open an issue. When opening an issue please provide:

Setup information including

• Raspbian version
• GPIO Zero version
• How you have connected the Jam Hat (on the Raspberry Pi, controlling pins over daemon etc.)
• A sample of the code you've used
• The error being presented.

Issues opened without this information will be closed off until this information can be provided.