drivers

README

TinyGo Drivers

This package provides a collection of hardware drivers for devices that can be used together with TinyGo.

Installing

go get tinygo.org/x/drivers

How to use

Here is an example in TinyGo that uses the BMP180 digital barometer:

package main

import (
    "time"

    "machine"

    "tinygo.org/x/drivers/bmp180"
)

func main() {
    machine.I2C0.Configure(machine.I2CConfig{})
    sensor := bmp180.New(machine.I2C0)
    sensor.Configure()

    connected := sensor.Connected()
    if !connected {
        println("BMP180 not detected")
        return
    }
    println("BMP180 detected")

    for {
        temp, _ := sensor.ReadTemperature()
        println("Temperature:", float32(temp)/1000, "°C")

        pressure, _ := sensor.ReadPressure()
        println("Pressure", float32(pressure)/100000, "hPa")

        time.Sleep(2 * time.Second)
    }
}

Currently supported devices

The following 48 devices are supported.

Device Name	Interface Type
ADT7410 I2C Temperature Sensor	I2C
ADXL345 accelerometer	I2C
AMG88xx 8x8 Thermal camera sensor	I2C
APA102 RGB LED	SPI
AT24CX 2-wire serial EEPROM	I2C
BBC micro:bit LED matrix	GPIO
BH1750 ambient light sensor	I2C
BlinkM RGB LED	I2C
BME280 humidity/pressure sensor	I2C
BMP180 barometer	I2C
Buzzer	GPIO
DS1307 real time clock	I2C
DS3231 real time clock	I2C
ESP32 as WiFi Coprocessor with Arduino nina-fw	SPI
ESP8266/ESP32 AT Command set for WiFi/TCP/UDP	UART
GPS module	I2C/UART
HC-SR04 Ultrasonic distance sensor	GPIO
HD44780 LCD controller	GPIO
HUB75 RGB led matrix	SPI
ILI9341 TFT color display	SPI
L293x motor driver	GPIO/PWM
L9110x motor driver	GPIO/PWM
LIS3DH accelerometer	I2C
LSM6DS3 accelerometer	I2C
MAG3110 magnetometer	I2C
MCP3008 analog to digital converter (ADC)	SPI
Microphone - PDM	I2S/PDM
MMA8653 accelerometer	I2C
MPU6050 accelerometer/gyroscope	I2C
PCD8544 display	SPI
Resistive Touchscreen (4-wire)	GPIO
Semihosting	Debug
Shift register (PISO)	GPIO
Shift registers (SIPO)	GPIO
SHT3x Digital Humidity Sensor	I2C
SPI NOR Flash Memory	SPI/QSPI
SSD1306 OLED display	I2C / SPI
SSD1331 TFT color display	SPI
ST7735 TFT color display	SPI
ST7789 TFT color display	SPI
Stepper motor "Easystepper" controller	GPIO
Thermistor	ADC
TMP102 I2C Temperature Sensor	I2C
VEML6070 UV light sensor	I2C
VL53L1X time-of-flight distance sensor	I2C
Waveshare 2.13" (B & C) e-paper display	SPI
Waveshare 2.13" e-paper display	SPI
WS2812 RGB LED	GPIO

Contributing

Your contributions are welcome!

Please take a look at our CONTRIBUTING.md document for details.

License

This project is licensed under the BSD 3-clause license, just like the Go project itself.

Documentation

Overview

Package drivers provides a collection of hardware drivers for TinyGo (https://tinygo.org) for devices such as sensors and displays.

Here is an example in TinyGo that uses the BMP180 digital barometer:

package main

import (
	"time"
	"machine"

	"tinygo.org/x/drivers/bmp180"
)

func main() {
	machine.I2C0.Configure(machine.I2CConfig{})
	sensor := bmp180.New(machine.I2C0)
	sensor.Configure()

	connected := sensor.Connected()
	if !connected {
		println("BMP180 not detected")
		return
	}
	println("BMP180 detected")

	for {
		temp, _ := sensor.ReadTemperature()
		println("Temperature:", float32(temp)/1000, "°C")

		pressure, _ := sensor.ReadPressure()
		println("Pressure", float32(pressure)/100000, "hPa")

		time.Sleep(2 * time.Second)
	}
}

Each individual driver is contained within its own sub-package within this package and there are no interdependencies in order to minimize the final size of compiled code that uses any of these drivers.

Index

• Constants
• type Displayer

Constants

const Version = "0.12.0"

Version returns a user-readable string showing the version of the drivers package for support purposes. Update this value before release of new version of software.

Types

type Displayer

type Displayer interface {
	// Size returns the current size of the display.
	Size() (x, y int16)

	// SetPizel modifies the internal buffer.
	SetPixel(x, y int16, c color.RGBA)

	// Display sends the buffer (if any) to the screen.
	Display() error
}