README
¶
A Go library for Raspberry Pi HATs (Hardware Attached on Top), starting with the Sense HAT.
Documentation
Screen
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)
Stick
The Sense HAT has a tiny joystick control.
input, err := stick.Open("/dev/input/event0")
if err != nil {
log.Fatal(err)
}
for {
select {
case e := <-input.Events:
switch e.Code {
case stick.Enter:
fmt.Println("⏎")
case stick.Up:
fmt.Println("↑")
case stick.Down:
fmt.Println("↓")
case stick.Left:
fmt.Println("←")
case stick.Right:
fmt.Println("→")
}
}
}
Motion
Gyroscope, Accelerometer, Magnetometer.
Not yet implemented.
Weather
Temperature, Humidity, Barometric pressure
Not yet implemented
Gopher Gala 2016
Team
- Carlisia Campos, Developer, California, U.S.
- Nathan Youngman, Developer, Alberta, Canada
- Olga Shalakhina, Illustrator, Ukraine
- Ravi Sastryk, Developer, California, U.S.
Media
bobbleHAT in action:
- First light
- Scrolling gopher favicon
- Follow bobbleHAT on Twitter for more videos.
Team:
License
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.
Related Projects
Documentation
¶
Overview ¶
Package bobblehat is a library for Raspberry Pi HATs (Hardware Attached on Top).
Please see the README for usage.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
examples
|
|
|
Package sense is a library for the Sense HAT on Raspberry Pi.
|
Package sense is a library for the Sense HAT on Raspberry Pi. |
|
screen
Package screen provides access to the Sense HAT's 8x8 LED matrix.
|
Package screen provides access to the Sense HAT's 8x8 LED matrix. |
|
screen/color
Package color defines a 16-bit RGB565 color.
|
Package color defines a 16-bit RGB565 color. |
|
screen/texture
Package texture loads and creates abitrary sized RGB565 images.
|
Package texture loads and creates abitrary sized RGB565 images. |