drivers

README

TinyGo Drivers

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

Installing

go get github.com/tinygo-org/drivers

How to use

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

package main

import (
    "time"

    "machine"

    "github.com/tinygo-org/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.Temperature()
        println("Temperature:", float32(temp)/1000, "ºC")

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

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

Currently supported devices

Device Name	Interface Type
APA102 RGB LED	SPI
BH1750 ambient light sensor	I2C
BlinkM RGB LED	I2C
BMP180 barometer	I2C
"Easystepper" stepper motor controller	GPIO
ESP8266/ESP32 AT Command set for WiFi/TCP/UDP	UART
MAG3110 magnetometer	I2C
MMA8653 accelerometer	I2C
MPU6050 accelerometer/gyroscope	I2C
VL53L1X time-of-flight distance sensor	I2C
WS2812 RGB LED	GPIO

Contributing

This collection of drivers is part of the TinyGo project. Patches are welcome but new drivers should follow the patterns established by similar existing drivers.

License

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

Documentation

Overview

Package drivers is just a placeholder for the sub-packages. It is here just to be able to install the package without errors using go get -d github.com/tinygo-org/drivers