bobbleHAT

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

Related Projects

Gobot
EMBD
sense-hat (Python)
RTIMULib (C++ dependency of sense-hat)
golang-evdev (Go bindings for the Linux input subsystem)
evdev (Go implementation of the Linux evdev API)

Bobblehat

Install / Use

README