A Go library for Raspberry Pi HATs (Hardware Attached on Top), starting with the Sense HAT.
The Sense HAT has an 8x8 LED matrix that could be used to display the status of a headless server, to write a mini-game, or countless other possibilities.
You can create an 8x8 frame buffer, set pixels with (x,y) coordinates, and then draw the frame buffer to the screen.
fb := screen.NewFrameBuffer()
fb.SetPixel(0, 0, color.Red)
screen.Draw(fb)
Colors are specified as red, green, blue (RGB) components with a range of 0-255. However, these are converted down to 32 shades (0-31) before being sent to the screen.
cyan := color.New(0, 255, 255)
A frame buffer is an 8x8 texture that can be drawn to the screen, but you can also create textures of any size (width, height).
tx := texture.New(16, 16)
tx.SetPixel(8, 8, color.White)
Or load a PNG file into a new texture.
tx, err := texture.Load("image.png")
The blit
function will copy between textures with destination and source offsets (x, y) and dimensions (width, height). See the image scrolling example for one use, but this can always be used to draw multi-pixels sprites (opaque).
texture.Blit(fb.Texture, 0, 0, tx, 0, 0, 8, 8)
The Sense HAT has a tiny joystick control.
switch stick.ReadEvent() {
case stick.Up:
// go north
case stick.Down:
// go south
case stick.Left:
// go west
case stick.Right:
// go east
case stick.Enter:
// joystick pressed in
}
Gyroscope, Accelerometer, Magnetometer.
Not yet implemented.
Temperature, Humidity, Barometric pressure
Not yet implemented
- Carlisia Campos, Developer, California, U.S.
- Nathan Youngman, Developer, Alberta, Canada
- Olga Shalakhina, Illustrator, Ukraine
- Ravi Sastryk, Developer, California, U.S.
bobbleHAT in action:
- First light
- Scrolling gopher favicon
- Follow bobbleHAT on Twitter for more videos.
Team:
We bit off too much for a weekend-long hackathon, not having noticed the RTIMULib C++ dependency before starting. We hope this is just the beginning of a community effort to support the Sense HAT and other HATs with Go.
Visit nathany.com for a post-Gala post-mortem on developing with Go for the Pi.
The code is licensed under the Simplified BSD License. Copyright © 2016 bobbleHAT Authors.
The original Go gopher © 2009 Renée French. Used under Creative Commons Attribution 3.0 license.
Illustrations © 2016 Olga Shalakhina.