ateccx08: inttial implementation for ATECCx08

This working implementation for the ATECCx08 family of cryptgraphic processors has random number generation and other needed supporting functions. It also includes a sample of how to connect it to the Go crypto/rand package. More cryptographic functions await a future interation. Signed-off-by: deadprogram <ron@hybridgroup.com>
gps: improve parsing and add tests to verify
2026-07-26 18:48:41 +00:00 · 2023-01-20 20:44:51 +01:00 · 2023-01-17 07:48:22 +01:00 · 2023-01-17 07:48:22 +01:00 · 2023-01-17 07:48:22 +01:00 · 2023-01-17 07:48:22 +01:00
268 changed files with 7534 additions and 2000 deletions
@@ -1,3 +1,34 @@
+0.23.0
+---
+- **new devices**
+    - Add GC9A01 Driver (#452)
+    - Initial support for VL6180x sensor
+
+- **enhancements**
+    - **rtl8720dn**
+        - refactor by bringing this driver more in line with wifinina and espat
+    - **ssd1306**
+        - add getter method to the current buffer
+    - **makeybutton**
+        - revise to better match the algorithm defined by the original
+    - **espat,wifinina,rtl8720dn**
+        - change ssid/pass from const to var
+
+- **bugfixes**
+    - **microbitmatrix**
+        - fix inverted axis
+    - **espat**
+        - Trim quotes from IP returned by espat's GetDNS()
+    - **all**
+        - correct go fmt
+
+- **examples**
+    - **rtl8720dn**
+        - remove wifi setting
+        - add call to optional debug setting
+        - update all remaining examples for refactored API
+
+
 0.22.0
 ---
 - **new devices**
@@ -53,6 +53,8 @@ smoke-test:
 	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=pyportal ./examples/flash/console/qspi
 	@md5sum ./build/test.hex
+	tinygo build -size short -o ./build/test.hex -target=microbit ./examples/gc9a01/main.go
+	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=feather-m0 ./examples/gps/i2c/main.go
 	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=feather-m0 ./examples/gps/uart/main.go
@@ -101,6 +103,8 @@ smoke-test:
 	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=microbit ./examples/microbitmatrix/main.go
 	@md5sum ./build/test.hex
+	tinygo build -size short -o ./build/test.hex -target=microbit-v2 ./examples/microbitmatrix/main.go
+	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=itsybitsy-m0 ./examples/mma8653/main.go
 	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=itsybitsy-m0 ./examples/mpu6050/main.go
@@ -143,6 +147,8 @@ smoke-test:
 	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=itsybitsy-m0 ./examples/vl53l1x/main.go
 	@md5sum ./build/test.hex
+	tinygo build -size short -o ./build/test.hex -target=itsybitsy-m0 ./examples/vl6180x/main.go
+	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=microbit ./examples/waveshare-epd/epd2in13/main.go
 	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=microbit ./examples/waveshare-epd/epd2in13x/main.go
@@ -205,6 +211,8 @@ endif
 	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=xiao ./examples/pcf8563/timer/
 	@md5sum ./build/test.hex
+	tinygo build -size short -o ./build/test.hex -target=pico ./examples/qmi8658c/main.go
+	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=feather-m0 ./examples/ina260/main.go
 	@md5sum ./build/test.hex
 	tinygo build -size short -o ./build/test.hex -target=nucleo-l432kc ./examples/aht20/main.go
@@ -241,6 +249,9 @@ endif
 	@md5sum ./build/test.uf2
 	tinygo build -size short -o ./build/test.uf2 -target=circuitplay-express ./examples/makeybutton/main.go
 	@md5sum ./build/test.uf2
+	tinygo build -size short -o ./build/test.hex -target=nucleo-wl55jc ./examples/lora/lorawan/atcmd/
+	@md5sum ./build/test.hex
+

 # rwildcard is a recursive version of $(wildcard) 
 # https://blog.jgc.org/2011/07/gnu-make-recursive-wildcard-function.html
@@ -52,7 +52,7 @@ func main() {

 ## Currently supported devices

-The following 82 devices are supported.
+The following 91 devices are supported.

 | Device Name                                                                                                                                                                                         | Interface Type |
 |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------|
@@ -63,6 +63,7 @@ The following 82 devices are supported.
 | [APA102 RGB LED](https://cdn-shop.adafruit.com/product-files/2343/APA102C.pdf)                                                                                                                      | SPI |
 | [APDS9960 Digital proximity, ambient light, RGB and gesture sensor](https://cdn.sparkfun.com/assets/learn_tutorials/3/2/1/Avago-APDS-9960-datasheet.pdf)                                            | I2C |
 | [AT24CX 2-wire serial EEPROM](https://www.openimpulse.com/blog/wp-content/uploads/wpsc/downloadables/24C32-Datasheet.pdf)                                                                           | I2C |
+| [ATECCx08 cryptographic processor](https://datasheet.octopart.com/ATSAMA5D27-WLSOM1-Microchip-datasheet-149595509.pdf)                                                                           | I2C |
 | [AXP192 single Cell Li-Battery and Power System Management](https://github.com/m5stack/M5-Schematic/blob/master/Core/AXP192%20Datasheet_v1.1_en_draft_2211.pdf)                                     | I2C |
 | [BBC micro:bit LED matrix](https://github.com/bbcmicrobit/hardware/blob/master/SCH_BBC-Microbit_V1.3B.pdf)                                                                                          | GPIO |
 | [BH1750 ambient light sensor](https://www.mouser.com/ds/2/348/bh1750fvi-e-186247.pdf)                                                                                                               | I2C |
@@ -97,10 +98,10 @@ The following 82 devices are supported.
 | [LPS22HB MEMS nano pressure sensor](https://www.st.com/resource/en/datasheet/dm00140895.pdf)                                                                                                        | I2C |
 | [LSM6DS3 accelerometer](https://www.st.com/resource/en/datasheet/lsm6ds3.pdf)                                                                                                                       | I2C |
 | [LSM6DSOX accelerometer](https://www.st.com/resource/en/datasheet/lsm6dsox.pdf)                                                                                                                     | I2C |
-| [LSM6DS3TR accelerometer](https://www.st.com/resource/en/datasheet/lsm6ds3tr.pdf)                                                                                                                     | I2C |
+| [LSM6DS3TR accelerometer](https://www.st.com/resource/en/datasheet/lsm6ds3tr.pdf)                                                                                                                   | I2C |
 | [LSM303AGR accelerometer](https://www.st.com/resource/en/datasheet/lsm303agr.pdf)                                                                                                                   | I2C |
 | [LSM9DS1 accelerometer](https://www.st.com/resource/en/datasheet/lsm9ds1.pdf)                                                                                                                       | I2C |
-| [Makey Button](https://makeymakey.com/)                                                                                                                   | GPIO |
+| [Makey Button](https://makeymakey.com/)                                                                                                                                                             | GPIO |
 | [MAG3110 magnetometer](https://www.nxp.com/docs/en/data-sheet/MAG3110.pdf)                                                                                                                          | I2C |
 | [MAX7219 & MAX7221 display driver](https://datasheets.maximintegrated.com/en/ds/MAX7219-MAX7221.pdf)                                                                                                | SPI |
 | [MCP2515 Stand-Alone CAN Controller with SPI Interface](https://ww1.microchip.com/downloads/en/DeviceDoc/MCP2515-Family-Data-Sheet-DS20001801K.pdf)                                                 | SPI |
@@ -112,13 +113,15 @@ The following 82 devices are supported.
 | [P1AM-100 Base Controller](https://facts-engineering.github.io/modules/P1AM-100/P1AM-100.html)                                                                                                      | SPI |
 | [PCD8544 display](http://eia.udg.edu/~forest/PCD8544_1.pdf)                                                                                                                                         | SPI |
 | [PCF8563 real time clock](https://www.nxp.com/docs/en/data-sheet/PCF8563.pdf)                                                                                                                       | I2C |
+| [QMI8658C accelerometer/gyroscope](https://www.qstcorp.com/upload/pdf/202202/%EF%BC%88%E5%B7%B2%E4%BC%A0%EF%BC%89QMI8658C%20datasheet%20rev%200.9.pdf)                                              | I2C |
 | [Resistive Touchscreen (4-wire)](http://ww1.microchip.com/downloads/en/Appnotes/doc8091.pdf)                                                                                                        | GPIO |
 | [RTL8720DN 2.4G/5G Dual Bands Wireless and BLE5.0](https://www.seeedstudio.com/Realtek8720DN-2-4G-5G-Dual-Bands-Wireless-and-BLE5-0-Combo-Module-p-4442.html)                                       | UART |
-| [SCD4x CO2 Sensor](https://sensirion.com/media/documents/C4B87CE6/627C2DCD/CD_DS_SCD40_SCD41_Datasheet_D1.pdf) | I2C |
+| [SCD4x CO2 Sensor](https://sensirion.com/media/documents/C4B87CE6/627C2DCD/CD_DS_SCD40_SCD41_Datasheet_D1.pdf)                                                                                      | I2C |
 | [Semihosting](https://wiki.segger.com/Semihosting)                                                                                                                                                  | Debug |
 | [Servo](https://learn.sparkfun.com/tutorials/hobby-servo-tutorial/all)                                                                                                                              | PWM |
 | [Shift register (PISO)](https://en.wikipedia.org/wiki/Shift_register#Parallel-in_serial-out_\(PISO\))                                                                                               | GPIO |
 | [Shift registers (SIPO)](https://en.wikipedia.org/wiki/Shift_register#Serial-in_parallel-out_(SIPO))                                                                                                | GPIO |
+| [SH1106 OLED display](https://www.velleman.eu/downloads/29/infosheets/sh1106_datasheet.pdf) | I2C / SPI |
 | [SHT3x Digital Humidity Sensor](https://www.sensirion.com/fileadmin/user_upload/customers/sensirion/Dokumente/2_Humidity_Sensors/Datasheets/Sensirion_Humidity_Sensors_SHT3x_Datasheet_digital.pdf) | I2C |
 | [SHTC3 Digital Humidity Sensor (RH/T)](https://www.sensirion.com/fileadmin/user_upload/customers/sensirion/Dokumente/2_Humidity_Sensors/Datasheets/Sensirion_Humidity_Sensors_SHTC3_Datasheet.pdf)  | I2C |
 | [SPI NOR Flash Memory](https://en.wikipedia.org/wiki/Flash_memory#NOR_flash)                                                                                                                        | SPI/QSPI |
@@ -132,16 +135,18 @@ The following 82 devices are supported.
 | [Thermistor](https://www.farnell.com/datasheets/33552.pdf)                                                                                                                                          | ADC |
 | [TM1637 7-segment LED display](https://www.mcielectronics.cl/website_MCI/static/documents/Datasheet_TM1637.pdf)                                                                                     | I2C |
 | [TMP102 I2C Temperature Sensor](https://download.mikroe.com/documents/datasheets/tmp102-data-sheet.pdf)                                                                                             | I2C |
-| [UC8151 All-in-one driver IC for ESL](https://www.buydisplay.com/download/ic/UC8151C.pdf)                                                                                          | I2C |
+| [UC8151 All-in-one driver IC for ESL](https://www.buydisplay.com/download/ic/UC8151C.pdf)                                                                                                           | I2C |
 | [VEML6070 UV light sensor](https://www.vishay.com/docs/84277/veml6070.pdf)                                                                                                                          | I2C |
 | [VL53L1X time-of-flight distance sensor](https://www.st.com/resource/en/datasheet/vl53l1x.pdf)                                                                                                      | I2C |
+| [VL6180X time-of-flight distance sensor](https://www.st.com/resource/en/datasheet/vl6180x.pdf)                                                                                                      | I2C |
 | [Waveshare 2.13" (B & C) e-paper display](https://www.waveshare.com/w/upload/d/d3/2.13inch-e-paper-b-Specification.pdf)                                                                             | SPI |
 | [Waveshare 2.13" e-paper display](https://www.waveshare.com/w/upload/e/e6/2.13inch_e-Paper_Datasheet.pdf)                                                                                           | SPI |
-| [Waveshare 2.9" e-paper display (V1)](https://www.waveshare.com/w/upload/e/e6/2.9inch_e-Paper_Datasheet.pdf)                                                                                           | SPI |
+| [Waveshare 2.9" e-paper display (V1)](https://www.waveshare.com/w/upload/e/e6/2.9inch_e-Paper_Datasheet.pdf)                                                                                        | SPI |
 | [Waveshare 4.2" e-paper B/W display](https://www.waveshare.com/w/upload/6/6a/4.2inch-e-paper-specification.pdf)                                                                                     | SPI |
+| [Waveshare GC9A01 TFT round display](https://www.waveshare.com/w/upload/5/5e/GC9A01A.pdf)                                                                                                           | SPI |
 | [WS2812 RGB LED](https://cdn-shop.adafruit.com/datasheets/WS2812.pdf)                                                                                                                               | GPIO |
 | [XPT2046 touch controller](http://grobotronics.com/images/datasheets/xpt2046-datasheet.pdf)                                                                                                         | GPIO |
-| [Semtech SX126x Lora](https://www.semtech.com/products/wireless-rf/lora-transceiv-ers/sx1261)                                                                                                       | SPI |
+| [Semtech SX126x Lora](https://www.semtech.com/products/wireless-rf/lora-connect/sx1261)                                                                                                             | SPI |
 | [SSD1289 TFT color display](http://aitendo3.sakura.ne.jp/aitendo_data/product_img/lcd/tft2/M032C1289TP/3.2-SSD1289.pdf)                                                                             | GPIO |

 ## Contributing
@@ -1,7 +1,6 @@
 // Package adt7410 provides a driver for the adt7410 I2C Temperature Sensor.
 //
 // Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ADT7410.pdf
-//
 package adt7410 // import "tinygo.org/x/drivers/adt7410"

 import (
@@ -3,7 +3,6 @@
 // Datasheet EN: http://www.analog.com/media/en/technical-documentation/data-sheets/ADXL345.pdf
 //
 // Datasheet JP: http://www.analog.com/media/jp/technical-documentation/data-sheets/ADXL345_jp.pdf
-//
 package adxl345 // import "tinygo.org/x/drivers/adxl345"

 import "tinygo.org/x/drivers"
@@ -2,7 +2,6 @@
 // a digital proximity, ambient light, RGB and gesture sensor.
 //
 // Datasheet: https://cdn.sparkfun.com/assets/learn_tutorials/3/2/1/Avago-APDS-9960-datasheet.pdf
-//
 package apds9960

 import (
@@ -1,10 +1,7 @@
 //go:build !nano_33_ble
-// +build !nano_33_ble

 package apds9960

-import "tinygo.org/x/drivers"
-
 // Configure sets up the APDS-9960 device.
 func (d *Device) Configure(cfg Configuration) {
 	// configure device
@@ -1,5 +1,4 @@
 //go:build nano_33_ble
-// +build nano_33_ble

 package apds9960

@@ -0,0 +1,258 @@
+// Package ateccx08 provides a driver for the ATECCx08 I2C cryptographic co-processor.
+//
+// Datasheet: https://datasheet.octopart.com/ATSAMA5D27-WLSOM1-Microchip-datasheet-149595509.pdf
+package ateccx08 // import "tinygo.org/x/drivers/ateccx08"
+
+import (
+	"errors"
+	"time"
+
+	"tinygo.org/x/drivers"
+)
+
+var (
+	maxCommandTime = (200 + 50) * time.Millisecond
+)
+
+var (
+	ErrWakeup          = errors.New("error on wakeup")
+	ErrInvalidCRCCheck = errors.New("invalid CRC check")
+	ErrLockFailed      = errors.New("locked failed")
+)
+
+type Device struct {
+	bus     drivers.I2C
+	Address uint8
+}
+
+// New returns ATECCx08 device for the provided I2C bus using default address.
+func New(i2c drivers.I2C) *Device {
+	return &Device{
+		bus:     i2c,
+		Address: Address,
+	}
+}
+
+// Configure the ATECCx08 device.
+func (d *Device) Configure() error {
+	return nil
+}
+
+// Connected returns whether ATECCx08 has been found.
+func (d *Device) Connected() bool {
+	if err := d.Wakeup(); err != nil {
+		return false
+	}
+
+	v, err := d.Version()
+	if err != nil {
+		return false
+	}
+
+	return (v == ATECC508 || v == ATECC608)
+}
+
+// Wakeup the ATECC by trying to write something to address 0x00
+func (d *Device) Wakeup() error {
+	d.bus.Tx(uint16(0x0), []byte{0x00}, nil)
+	time.Sleep(1500 * time.Microsecond)
+	d.bus.Tx(uint16(d.Address), []byte{0x00}, nil)
+	time.Sleep(maxCommandTime)
+
+	var status [4]byte
+	if err := d.readResponse(status[:]); err != nil {
+		return err
+	}
+
+	if status[0] != StatusAfterWake {
+		return ErrWakeup
+	}
+
+	return nil
+}
+
+// Sleep puts the ATECC to sleep.
+func (d *Device) Sleep() {
+	d.bus.Tx(uint16(d.Address), []byte{0x01}, nil)
+	time.Sleep(time.Millisecond)
+}
+
+// Idle puts the ATECC in idle mode.
+func (d *Device) Idle() {
+	d.bus.Tx(uint16(d.Address), []byte{0x02}, nil)
+	time.Sleep(time.Millisecond)
+}
+
+type ATECCVersion uint16
+
+func (at ATECCVersion) String() string {
+	switch at {
+	case ATECC508:
+		return "ATECC508"
+	case ATECC608:
+		return "ATECC608"
+	case ATECCNone:
+		return "No ATECCx08"
+	default:
+		return "Unknown"
+	}
+}
+
+// Version returns what version of ATECC is being used.
+// Either ATECC508, ATECC608, or ATECCNone.
+func (d *Device) Version() (ATECCVersion, error) {
+	var version [4]byte
+	d.Wakeup()
+	defer d.Idle()
+
+	d.sendCommand(cmdInfo, 0x00, 0, nil)
+
+	time.Sleep(maxCommandTime)
+	if err := d.readResponse(version[:]); err != nil {
+		return ATECCNone, err
+	}
+
+	return ATECCVersion(uint16(version[2])<<8 | uint16(version[3])&0xf000), nil
+}
+
+// Random returns an array of 32 byte-sized random numbers.
+func (d *Device) Random() ([32]byte, error) {
+	var random [32]byte
+	d.Wakeup()
+	defer d.Idle()
+
+	d.sendCommand(cmdRandom, 0x00, 0, nil)
+	time.Sleep(23 * time.Millisecond)
+
+	err := d.readResponse(random[:])
+	return random, err
+}
+
+// Read reads from the device memory.
+func (d *Device) Read(zone, address int, data []byte) error {
+	d.Wakeup()
+	defer d.Idle()
+
+	d.sendCommand(cmdRead, byte(zone), uint16(address), nil)
+	time.Sleep(5 * time.Millisecond)
+
+	return d.readResponse(data)
+}
+
+// IsLocked checks to see if the ATECC is locked.
+// Config zone (0) must be locked to generate random numbers.
+func (d *Device) IsLocked() bool {
+	return d.IsZoneLocked(0)
+}
+
+// IsZoneLocked checks to see if a specific zone in the ATECC is locked.
+func (d *Device) IsZoneLocked(zone int) bool {
+	var config [4]byte
+
+	if zone < 0 || zone > 8 {
+		return false
+	}
+
+	switch zone {
+	case 0, 1:
+		if err := d.Read(0, 0x15, config[:]); err != nil {
+			return false
+		}
+
+		// LockConfig
+		loc := 3
+
+		// LockData
+		if zone == 1 {
+			loc = 2
+		}
+
+		if config[loc] == 0 {
+			return true
+		}
+
+	default:
+		if err := d.Read(0, 0x16, config[:]); err != nil {
+			return false
+		}
+
+		slot := byte(zone<<2) | 2
+
+		if (config[0] & slot) == 0 {
+			return true
+		}
+
+		return false
+	}
+
+	return false
+}
+
+// Lock locks a zone in the device.
+// Note that you cannot unlock a device zone once locked,
+// so make sure you know what you are doing!
+func (d *Device) Lock(zone int) error {
+	var status [1]byte
+	d.Wakeup()
+	defer d.Idle()
+
+	d.sendCommand(cmdLock, byte(zone)|0x80, 0, nil)
+	time.Sleep(32 * time.Millisecond)
+
+	d.readResponse(status[:])
+
+	if status[0] != 0 {
+		return ErrLockFailed
+	}
+
+	return nil
+}
+
+var cmdBuf [64]byte
+
+func (d *Device) sendCommand(opcode, param1 byte, param2 uint16, data []byte) error {
+	cmdBuf[0] = 0x03
+	cmdBuf[1] = byte(8 + len(data) - 1)
+	cmdBuf[2] = opcode
+	cmdBuf[3] = param1
+	cmdBuf[4] = byte(param2 & 0xff)
+	cmdBuf[5] = byte(param2 >> 8)
+	copy(cmdBuf[6:], data)
+
+	crc := crc16(cmdBuf[1 : 6+len(data)])
+	cmdBuf[6+len(data)] = crc[0]
+	cmdBuf[6+len(data)+1] = crc[1]
+
+	if err := d.bus.Tx(uint16(d.Address), cmdBuf[:6+len(data)+2], nil); err != nil {
+		return err
+	}
+
+	time.Sleep(time.Millisecond)
+	return nil
+}
+
+func (d *Device) readResponse(data []byte) error {
+	var sz [1]byte
+	if err := d.bus.Tx(uint16(d.Address), []byte{cmdAddress}, sz[:]); err != nil {
+		return err
+	}
+
+	rx := make([]byte, sz[0])
+	if err := d.bus.Tx(uint16(d.Address), []byte{cmdAddress}, rx); err != nil {
+		return err
+	}
+
+	size := len(rx) - 2
+	payload := rx[:size]
+	payloaddata := rx[1:size]
+	payloadcrc := rx[size:]
+
+	crcCheck := crc16(payload)
+	if !(crcCheck[0] == payloadcrc[0] &&
+		crcCheck[1] == payloadcrc[1]) {
+		return ErrInvalidCRCCheck
+	}
+
+	copy(data, payloaddata)
+	return nil
+}
@@ -0,0 +1,32 @@
+// from https://github.com/usbarmory/armoryctl/blob/master/atecc608/atecc608.go#L104
+// thank you!
+package ateccx08
+
+const (
+	CRC16Poly uint16 = 0x8005
+)
+
+func crc16(data []byte) []byte {
+	var crc uint16
+
+	for i := 0; i < len(data); i++ {
+		for shift := uint8(0x01); shift > 0x00; shift <<= 1 {
+			// data and crc bits
+			var d uint8
+			var c uint8
+
+			if uint8(data[i])&uint8(shift) != 0 {
+				d = 1
+			}
+
+			c = uint8(crc >> 15)
+			crc <<= 1
+
+			if d != c {
+				crc ^= CRC16Poly
+			}
+		}
+	}
+
+	return []byte{byte(crc & 0xff), byte(crc >> 8)}
+}
@@ -0,0 +1,39 @@
+package ateccx08
+
+const (
+	// Address is default I2C address.
+	Address = 0x60
+)
+
+const (
+	ATECCNone = 0
+	ATECC508  = 0x5000
+	ATECC608  = 0x6000
+)
+
+const (
+	cmdAddress = 0x03
+	cmdCounter = 0x24
+	cmdGenKey  = 0x40
+	cmdInfo    = 0x30
+	cmdLock    = 0x17
+	cmdNonce   = 0x16
+	cmdRandom  = 0x1B
+	cmdSHA     = 0x47
+	cmdSign    = 0x41
+	cmdWrite   = 0x12
+	cmdRead    = 0x02
+)
+
+const (
+	StatusSuccess         = 0x00
+	StatusMiscompare      = 0x01
+	StatusParseError      = 0x03
+	StatusECCFault        = 0x05
+	StatusSelfTestError   = 0x07
+	StatusHealthTestError = 0x08
+	StatusExecutionError  = 0x0f
+	StatusAfterWake       = 0x11
+	StatusWatchdogExpire  = 0xee
+	StatusCRCError        = 0xff
+)
@@ -3,7 +3,6 @@
 //
 // http://www.x-powers.com/en.php/Info/product_detail/article_id/29
 // Datasheet: https://github.com/m5stack/M5-Schematic/blob/master/Core/AXP192%20Datasheet_v1.1_en_draft_2211.pdf
-//
 package axp192 // import "tinygo.org/x/drivers/axp192"

 import (
@@ -2,7 +2,6 @@
 //
 // Datasheet:
 // https://www.mouser.com/ds/2/348/bh1750fvi-e-186247.pdf
-//
 package bh1750 // import "tinygo.org/x/drivers/bh1750"

 import (
@@ -1,7 +1,6 @@
 // Package blinkm implements a driver for the BlinkM I2C RGB LED.
 //
 // Datasheet: http://thingm.com/fileadmin/thingm/downloads/BlinkM_datasheet.pdf
-//
 package blinkm // import "tinygo.org/x/drivers/blinkm"

 import "tinygo.org/x/drivers"
@@ -3,11 +3,11 @@
 //
 // Datasheet:
 // https://cdn-shop.adafruit.com/datasheets/BST-BME280_DS001-10.pdf
-//
 package bme280

 import (
 	"math"
+	"time"

 	"tinygo.org/x/drivers"
 )
@@ -34,11 +34,27 @@ type calibrationCoefficients struct {
 	h6 int8
 }

+type Oversampling byte
+type Mode byte
+type FilterCoefficient byte
+type Period byte
+
+// Config contains settings for filtering, sampling, and modes of operation
+type Config struct {
+	Pressure    Oversampling
+	Temperature Oversampling
+	Humidity    Oversampling
+	Period      Period
+	Mode        Mode
+	IIR         FilterCoefficient
+}
+
 // Device wraps an I2C connection to a BME280 device.
 type Device struct {
 	bus                     drivers.I2C
 	Address                 uint16
 	calibrationCoefficients calibrationCoefficients
+	Config                  Config
 }

 // New creates a new BME280 connection. The I2C bus must already be
@@ -52,9 +68,34 @@ func New(bus drivers.I2C) Device {
 	}
 }

-// Configure sets up the device for communication and
-// read the calibration coefficientes.
+// ConfigureWithSettings sets up the device for communication and
+// read the calibration coefficients.
+//
+// The default configuration is the Indoor Navigation settings
+// from the BME280 datasheet.
 func (d *Device) Configure() {
+	d.ConfigureWithSettings(Config{})
+}
+
+// ConfigureWithSettings sets up the device for communication and
+// read the calibration coefficients.
+//
+// The default configuration if config is left at defaults is
+// the Indoor Navigation settings from the BME280 datasheet.
+func (d *Device) ConfigureWithSettings(config Config) {
+	d.Config = config
+
+	// If config is not initialized, use Indoor Navigation defaults.
+	if d.Config == (Config{}) {
+		d.Config = Config{
+			Mode:        ModeNormal,
+			Period:      Period0_5ms,
+			Temperature: Sampling2X,
+			Humidity:    Sampling1X,
+			Pressure:    Sampling16X,
+			IIR:         Coeff16,
+		}
+	}

 	var data [24]byte
 	err := d.bus.ReadRegister(uint8(d.Address), REG_CALIBRATION, data[:])
@@ -94,10 +135,18 @@ func (d *Device) Configure() {
 	d.calibrationCoefficients.h4 = 0 + (int16(h2lsb[3]) << 4) | (int16(h2lsb[4] & 0x0F))
 	d.calibrationCoefficients.h5 = 0 + (int16(h2lsb[5]) << 4) | (int16(h2lsb[4]) >> 4)

-	d.bus.WriteRegister(uint8(d.Address), CTRL_HUMIDITY_ADDR, []byte{0x3f})
-	d.bus.WriteRegister(uint8(d.Address), CTRL_MEAS_ADDR, []byte{0xB7})
-	d.bus.WriteRegister(uint8(d.Address), CTRL_CONFIG, []byte{0x00})
+	d.Reset()

+	d.bus.WriteRegister(uint8(d.Address), CTRL_CONFIG, []byte{byte(d.Config.Period<<5) | byte(d.Config.IIR<<2)})
+	d.bus.WriteRegister(uint8(d.Address), CTRL_HUMIDITY_ADDR, []byte{byte(d.Config.Humidity)})
+
+	// Normal mode, start measuring now
+	if d.Config.Mode == ModeNormal {
+		d.bus.WriteRegister(uint8(d.Address), CTRL_MEAS_ADDR, []byte{
+			byte(d.Config.Temperature<<5) |
+				byte(d.Config.Pressure<<2) |
+				byte(d.Config.Mode)})
+	}
 }

 // Connected returns whether a BME280 has been found.
@@ -113,6 +162,20 @@ func (d *Device) Reset() {
 	d.bus.WriteRegister(uint8(d.Address), CMD_RESET, []byte{0xB6})
 }

+// SetMode can set the device to Sleep, Normal or Forced mode
+//
+// Calling this method is optional, Configure can be used to set the
+// initial mode if no mode change is desired.  This method is most
+// useful to switch between Sleep and Normal modes.
+func (d *Device) SetMode(mode Mode) {
+	d.Config.Mode = mode
+
+	d.bus.WriteRegister(uint8(d.Address), CTRL_MEAS_ADDR, []byte{
+		byte(d.Config.Temperature<<5) |
+			byte(d.Config.Pressure<<2) |
+			byte(d.Config.Mode)})
+}
+
 // ReadTemperature returns the temperature in celsius milli degrees (°C/1000)
 func (d *Device) ReadTemperature() (int32, error) {
 	data, err := d.readData()
@@ -149,7 +212,8 @@ func (d *Device) ReadHumidity() (int32, error) {
 // ReadAltitude returns the current altitude in meters based on the
 // current barometric pressure and estimated pressure at sea level.
 // Calculation is based on code from Adafruit BME280 library
-// 	https://github.com/adafruit/Adafruit_BME280_Library
+//
+//	https://github.com/adafruit/Adafruit_BME280_Library
 func (d *Device) ReadAltitude() (alt int32, err error) {
 	mPa, _ := d.ReadPressure()
 	atmP := float32(mPa) / 100000
@@ -186,6 +250,16 @@ func readIntLE(msb byte, lsb byte) int16 {
 // readData does a burst read from 0xF7 to 0xF0 according to the datasheet
 // resulting in an slice with 8 bytes 0-2 = pressure / 3-5 = temperature / 6-7 = humidity
 func (d *Device) readData() (data [8]byte, err error) {
+	if d.Config.Mode == ModeForced {
+		// Write the CTRL_MEAS register to trigger a measurement
+		d.bus.WriteRegister(uint8(d.Address), CTRL_MEAS_ADDR, []byte{
+			byte(d.Config.Temperature<<5) |
+				byte(d.Config.Pressure<<2) |
+				byte(d.Config.Mode)})
+
+		time.Sleep(d.measurementDelay())
+	}
+
 	err = d.bus.ReadRegister(uint8(d.Address), REG_PRESSURE, data[:])
 	if err != nil {
 		println(err)
@@ -256,3 +330,39 @@ func (d *Device) calculateHumidity(data [8]byte, tFine int32) int32 {
 	return int32(100 * h)

 }
+
+// measurementDelay returns how much time each measurement will take
+// on the device.
+//
+// This is used in forced mode to wait until a measurement is complete.
+func (d *Device) measurementDelay() time.Duration {
+	const MeasOffset = 1250
+	const MeasDur = 2300
+	const HumMeasOffset = 575
+	const MeasScalingFactor = 1000
+
+	// delay is based on over-sampling rate - this table converts from
+	// setting to number samples
+	sampleRateConv := []int{0, 1, 2, 4, 8, 16}
+
+	tempOsr := 16
+	if d.Config.Temperature <= Sampling16X {
+		tempOsr = sampleRateConv[d.Config.Temperature]
+	}
+
+	presOsr := 16
+	if d.Config.Temperature <= Sampling16X {
+		presOsr = sampleRateConv[d.Config.Pressure]
+	}
+
+	humOsr := 16
+	if d.Config.Temperature <= Sampling16X {
+		humOsr = sampleRateConv[d.Config.Humidity]
+	}
+
+	max_delay := ((MeasOffset + (MeasDur * tempOsr) +
+		((MeasDur * presOsr) + HumMeasOffset) +
+		((MeasDur * humOsr) + HumMeasOffset)) / MeasScalingFactor)
+
+	return time.Duration(max_delay) * time.Millisecond
+}
@@ -20,6 +20,50 @@ const (
 	CHIP_ID  = 0x60
 )

+// Increasing sampling rate increases precision but also the wait time for measurements. The datasheet has a table of
+// suggested values for oversampling, output data rates, and iir filter coefficients by use case.
+const (
+	SamplingOff Oversampling = iota
+	Sampling1X
+	Sampling2X
+	Sampling4X
+	Sampling8X
+	Sampling16X
+)
+
+// In normal mode (the default) the sensor takes masurements periodically.  In forced
+// mode, the sensor takes a measurement only when requested.
+//
+// For use-cases with infrequent sampling, forced mode is more power efficient.
+const (
+	ModeNormal Mode = 0x03
+	ModeForced Mode = 0x01
+	ModeSleep  Mode = 0x00
+)
+
+// IIR filter coefficients, higher values means steadier measurements but slower reaction times
+const (
+	Coeff0 FilterCoefficient = iota
+	Coeff2
+	Coeff4
+	Coeff8
+	Coeff16
+)
+
+// Period of standby in normal mode which controls how often measurements are taken
+//
+// Note Period10ms and Period20ms are out of sequence, but are per the datasheet
+const (
+	Period0_5ms  Period = 0b000
+	Period62_5ms        = 0b001
+	Period125ms         = 0b010
+	Period250ms         = 0b011
+	Period500ms         = 0b100
+	Period1000ms        = 0b101
+	Period10ms          = 0b110
+	Period20ms          = 0b111
+)
+
 const (
 	SEALEVEL_PRESSURE float32 = 1013.25 // in hPa
 )
@@ -3,7 +3,6 @@
 //
 // Datasheet:
 // https://cdn-shop.adafruit.com/datasheets/BST-BMP180-DS000-09.pdf
-//
 package bmp180 // import "tinygo.org/x/drivers/bmp180"

 import (
@@ -1,5 +1,4 @@
 // Package buzzer provides a very simplistic driver for a connected buzzer or low-fidelity speaker.
-//
 package buzzer // import "tinygo.org/x/drivers/buzzer"

 import (
@@ -55,6 +54,12 @@ func (l *Device) Tone(hz, duration float64) (err error) {

 	tempo := ((60 / l.BPM) * (duration * 1000))

+	// no tone during rest, just let the duration pass.
+	if hz == Rest {
+		time.Sleep(time.Duration(tempo) * time.Millisecond)
+		return
+	}
+
 	for i := 0.0; i < tempo*1000; i += tone * 2.0 {
 		if err = l.On(); err != nil {
 			return
@@ -1,9 +1,9 @@
 package buzzer

 const (
-	Whole   = 4
-	Half    = 2
-	Quarter = 1
+	Whole   = 4.0
+	Half    = 2.0
+	Quarter = 1.0
 	Eighth  = 0.500
 )

@@ -1,5 +1,4 @@
 //go:build tinygo
-// +build tinygo

 // Package dht provides a driver for DHTXX family temperature and humidity sensors.
 //
@@ -1,5 +1,4 @@
 //go:build mimxrt1062 || stm32f405 || atsamd51 || stm32f103xx || k210 || stm32f407
-// +build mimxrt1062 stm32f405 atsamd51 stm32f103xx k210 stm32f407

 package dht // import "tinygo.org/x/drivers/dht"

@@ -1,5 +1,4 @@
 //go:build !mimxrt1062 && !stm32f405 && !atsamd51 && !stm32f103xx && !k210 && !stm32f407
-// +build !mimxrt1062,!stm32f405,!atsamd51,!stm32f103xx,!k210,!stm32f407

 package dht // import "tinygo.org/x/drivers/dht"

@@ -1,5 +1,4 @@
 //go:build tinygo
-// +build tinygo

 // Package dht provides a driver for DHTXX family temperature and humidity sensors.
 //
@@ -11,6 +10,7 @@ package dht // import "tinygo.org/x/drivers/dht"

 import (
 	"machine"
+	"runtime/interrupt"
 	"time"
 )

@@ -160,8 +160,8 @@ func (t *device) read() error {
 // interrupts
 func receiveSignals(pin machine.Pin, result []counter) {
 	i := uint8(0)
-	machine.UART1.Interrupt.Disable()
-	defer machine.UART1.Interrupt.Enable()
+	mask := interrupt.Disable()
+	defer interrupt.Restore(mask)
 	for ; i < 40; i++ {
 		result[i*2] = expectChange(pin, false)
 		result[i*2+1] = expectChange(pin, true)
@@ -1,5 +1,4 @@
 //go:build tinygo
-// +build tinygo

 // Package dht provides a driver for DHTXX family temperature and humidity sensors.
 //
@@ -1,5 +1,4 @@
 //go:build tinygo
-// +build tinygo

 package dht // import "tinygo.org/x/drivers/dht"

@@ -3,22 +3,22 @@
 //
 // Here is an example in TinyGo that uses the BMP180 digital barometer:
 //
-// 	package main
+//	package main
 //
-// 	import (
+//	import (
 //		"time"
 //		"machine"
 //
-// 		"tinygo.org/x/drivers/bmp180"
-// 	)
+//		"tinygo.org/x/drivers/bmp180"
+//	)
 //
-// 	func main() {
+//	func main() {
 //		machine.I2C0.Configure(machine.I2CConfig{})
 //		sensor := bmp180.New(machine.I2C0)
 //		sensor.Configure()
 //
-// 		connected := sensor.Connected()
-// 		if !connected {
+//		connected := sensor.Connected()
+//		if !connected {
 //			println("BMP180 not detected")
 //			return
 //		}
@@ -38,5 +38,4 @@
 // 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.
-//
 package drivers // import "tinygo.org/x/drivers"
@@ -2,7 +2,6 @@
 //
 // Datasheet:
 // https://datasheets.maximintegrated.com/en/ds/DS1307.pdf
-//
 package ds1307 // import "tinygo.org/x/drivers/ds1307"

 import (
@@ -15,7 +15,6 @@
 //
 // AT command set:
 // https://www.espressif.com/sites/default/files/documentation/4a-esp8266_at_instruction_set_en.pdf
-//
 package espat // import "tinygo.org/x/drivers/espat"

 import (
@@ -29,7 +29,7 @@ func (d *Device) GetDNS(domain string) (string, error) {
 		return "", errors.New("Invalid domain lookup result")
 	}
 	res := strings.Split(r[1], "\r\n")
-	return res[0], nil
+	return strings.Trim(res[0], `"`), nil
 }

 // ConnectTCPSocket creates a new TCP socket connection for the ESP8266/ESP32.
@@ -0,0 +1,53 @@
+package main
+
+import (
+	"machine"
+
+	"encoding/hex"
+	"time"
+
+	"tinygo.org/x/drivers/ateccx08"
+)
+
+func main() {
+	time.Sleep(5 * time.Second)
+	println("Looking for ATECCx08...")
+
+	machine.I2C0.Configure(machine.I2CConfig{})
+
+	atecc := ateccx08.New(machine.I2C0)
+	atecc.Configure()
+
+	if !atecc.Connected() {
+		for {
+			println("could not connect to ATECCx08")
+			time.Sleep(time.Second)
+		}
+	}
+
+	version, _ := atecc.Version()
+
+	println(version.String(), "started")
+
+	if !atecc.IsLocked() {
+		for i := 10; i > 0; i-- {
+			println(version.String(), "is not locked. Locking in", i, "seconds...")
+			time.Sleep(time.Second)
+		}
+
+		// locks the Configuration zone... PERMANENTLY!
+		atecc.Lock(0)
+	}
+
+	println(version.String(), "locked.")
+
+	for {
+		data, err := atecc.Random()
+		if err != nil {
+			println(err)
+		}
+
+		println(hex.EncodeToString(data[:]))
+		time.Sleep(500 * time.Millisecond)
+	}
+}
@@ -0,0 +1,49 @@
+package main
+
+import (
+	"machine"
+
+	"crypto/rand"
+	"encoding/hex"
+	"time"
+
+	"tinygo.org/x/drivers/ateccx08"
+)
+
+var atecc *ateccx08.Device
+
+func main() {
+	time.Sleep(5 * time.Second)
+	println("Looking for ATECCx08...")
+
+	machine.I2C0.Configure(machine.I2CConfig{})
+
+	atecc = ateccx08.New(machine.I2C0)
+	atecc.Configure()
+
+	if !atecc.Connected() {
+		for {
+			println("could not connect to ATECCx08")
+			time.Sleep(time.Second)
+		}
+	}
+
+	version, _ := atecc.Version()
+
+	println(version.String(), "started")
+
+	if !atecc.IsLocked() {
+		for {
+			println(version.String(), "is not locked. Random numbers will not actually be random.")
+			time.Sleep(time.Second)
+		}
+	}
+
+	var result [13]byte
+	for {
+		rand.Read(result[:])
+		encodedString := hex.EncodeToString(result[:])
+		println(encodedString)
+		time.Sleep(500 * time.Millisecond)
+	}
+}
@@ -0,0 +1,52 @@
+// connects the Go crypto/rand package to the random number generation
+// on the ATECCx08 cryptographic processor.
+package main
+
+import (
+	"crypto/rand"
+	"errors"
+)
+
+var (
+	errNoATECC = errors.New("no ATECCx08")
+)
+
+func init() {
+	rand.Reader = &reader{}
+}
+
+type reader struct{}
+
+func (r *reader) Read(b []byte) (n int, err error) {
+	if len(b) == 0 {
+		return
+	}
+
+	if atecc == nil {
+		return 0, errNoATECC
+	}
+
+	if !atecc.IsLocked() {
+		panic("ATECCx08 is not locked and cannot produce random numbers!")
+	}
+
+	rnds, err := atecc.Random()
+	if err != nil {
+		return 0, err
+	}
+
+	for i := 0; i < len(b); i += 32 {
+		if i+32 > len(b) {
+			copy(b[i:], rnds[:(len(b)-i)])
+			break
+		}
+
+		copy(b[i:], rnds[:])
+		rnds, err = atecc.Random()
+		if err != nil {
+			return 0, err
+		}
+	}
+
+	return len(b), nil
+}
@@ -6,7 +6,6 @@
 //
 // More information on the Espressif AT command set at:
 // https://www.espressif.com/sites/default/files/documentation/4a-esp8266_at_instruction_set_en.pdf
-//
 package main

 import (
@@ -19,9 +18,11 @@ import (
 // change actAsAP to true to act as an access point instead of connecting to one.
 const actAsAP = false

-// access point info
-const ssid = "YOURSSID"
-const pass = "YOURPASS"
+var (
+	// access point info
+	ssid string
+	pass string
+)

 // these are the default pins for the Arduino Nano33 IoT.
 // change these to connect to a different UART or pins for the ESP8266/ESP32
@@ -3,7 +3,6 @@
 //
 // In other words:
 // Your computer <--> UART0 <--> MCU <--> UART1 <--> ESP8266 <--> INTERNET
-//
 package main

 import (
@@ -17,9 +16,11 @@ import (
 // change actAsAP to true to act as an access point instead of connecting to one.
 const actAsAP = false

-// access point info
-const ssid = "YOURSSID"
-const pass = "YOURPASS"
+var (
+	// access point info
+	ssid string
+	pass string
+)

 // these are the default pins for the Arduino Nano33 IoT.
 // change these to connect to a different UART or pins for the ESP8266/ESP32
@@ -3,7 +3,6 @@
 //
 // In other words:
 // Your computer <--> UART0 <--> MCU <--> UART1 <--> ESP8266
-//
 package main

 import (
@@ -14,9 +13,11 @@ import (
 	"tinygo.org/x/drivers/net"
 )

-// access point info
-const ssid = "YOURSSID"
-const pass = "YOURPASS"
+var (
+	// access point info
+	ssid string
+	pass string
+)

 // IP address of the listener aka "hub". Replace with your own info.
 const hubIP = "0.0.0.0"
@@ -7,8 +7,7 @@
 //
 // You must install the Paho MQTT package to build this program:
 //
-// 		go get -u github.com/eclipse/paho.mqtt.golang
-//
+//	go get -u github.com/eclipse/paho.mqtt.golang
 package main

 import (
@@ -20,9 +19,11 @@ import (
 	"tinygo.org/x/drivers/net/mqtt"
 )

-// access point info
-const ssid = "YOURSSID"
-const pass = "YOURPASS"
+var (
+	// access point info
+	ssid string
+	pass string
+)

 // IP address of the MQTT broker to use. Replace with your own info.
 const server = "tcp://test.mosquitto.org:1883"
@@ -7,8 +7,7 @@
 //
 // You must also install the Paho MQTT package to build this program:
 //
-// 		go get -u github.com/eclipse/paho.mqtt.golang
-//
+//	go get -u github.com/eclipse/paho.mqtt.golang
 package main

 import (
@@ -21,9 +20,11 @@ import (
 	"tinygo.org/x/drivers/net/mqtt"
 )

-// access point info
-const ssid = "YOURSSID"
-const pass = "YOURPASS"
+var (
+	// access point info
+	ssid string
+	pass string
+)

 // IP address of the MQTT broker to use. Replace with your own info.
 //const server = "tcp://test.mosquitto.org:1883"
@@ -3,7 +3,6 @@
 //
 // In other words:
 // Your computer <--> UART0 <--> MCU <--> UART1 <--> ESP8266
-//
 package main

 import (
@@ -14,9 +13,11 @@ import (
 	"tinygo.org/x/drivers/net"
 )

-// access point info
-const ssid = "YOURSSID"
-const pass = "YOURPASS"
+var (
+	// access point info
+	ssid string
+	pass string
+)

 // IP address of the server aka "hub". Replace with your own info.
 const serverIP = "0.0.0.0"
@@ -1,5 +1,4 @@
 //go:build m5stack_core2
-// +build m5stack_core2

 package main

@@ -1,5 +1,4 @@
 //go:build m5stack_core2
-// +build m5stack_core2

 package main

@@ -0,0 +1,39 @@
+package main
+
+import (
+	"machine"
+	"time"
+
+	"image/color"
+
+	"tinygo.org/x/drivers/gc9a01"
+)
+
+func main() {
+	machine.SPI0.Configure(machine.SPIConfig{
+		Frequency: 80000000,
+	})
+	display := gc9a01.New(machine.SPI0, machine.P6, machine.P7, machine.P8, machine.P9)
+	display.Configure(gc9a01.Config{Orientation: gc9a01.HORIZONTAL, Width: 240, Height: 240})
+
+	width, height := display.Size()
+
+	white := color.RGBA{255, 255, 255, 255}
+	red := color.RGBA{255, 0, 0, 255}
+	blue := color.RGBA{0, 0, 255, 255}
+	green := color.RGBA{0, 255, 0, 255}
+	black := color.RGBA{0, 0, 0, 255}
+
+	display.FillScreen(black)
+
+	display.FillRectangle(0, 0, width/2, height/2, white)
+	display.FillRectangle(width/2, 0, width/2, height/2, red)
+	display.FillRectangle(0, height/2, width/2, height/2, green)
+	display.FillRectangle(width/2, height/2, width/2, height/2, blue)
+	display.FillRectangle(width/4, height/4, width/2, height/2, black)
+
+	for {
+		time.Sleep(time.Hour)
+	}
+
+}
@@ -1,5 +1,4 @@
 //go:build atsamd21
-// +build atsamd21

 package initdisplay

@@ -9,8 +8,6 @@ import (
 	"tinygo.org/x/drivers/ili9341"
 )

-var ()
-
 func InitDisplay() *ili9341.Device {
 	machine.SPI0.Configure(machine.SPIConfig{
 		SCK:       machine.SPI0_SCK_PIN,
@@ -1,5 +1,4 @@
 //go:build feather_m0 || feather_m4 || feather_m4_can || feather_nrf52840 || feather_nrf52840_sense || feather_stm32f405 || feather_rp2040
-// +build feather_m0 feather_m4 feather_m4_can feather_nrf52840 feather_nrf52840_sense feather_stm32f405 feather_rp2040

 package initdisplay

@@ -1,5 +1,4 @@
 //go:build m5stack
-// +build m5stack

 package initdisplay

@@ -1,5 +1,4 @@
 //go:build m5stack_core2
-// +build m5stack_core2

 package initdisplay

@@ -1,5 +1,4 @@
 //go:build pyportal
-// +build pyportal

 package initdisplay

@@ -1,5 +1,4 @@
 //go:build wioterminal
-// +build wioterminal

 package initdisplay

@@ -0,0 +1,41 @@
+# AT-CMD implementation of at-lora command set
+
+This example implements the AT command set as used by Seeed in the LoRa-E5 series of boards, but in the form of a TinyGo program that provides a serial interface. 
+
+See https://files.seeedstudio.com/products/317990687/res/LoRa-E5%20AT%20Command%20Specification_V1.0%20.pdf for more information.
+
+```
+$ tinygo monitor
+Connected to /dev/ttyACM0. Press Ctrl-C to exit.
+AT: OK
+VER: 0.0.1 (sx127x v18)
+```
+
+# Building
+
+Run the following commands from the main `drivers` directory.
+
+## Simulator
+
+Builds/flashes atcmd console application with simulator instead of actual LoRa radio.
+
+```
+tinygo flash -target pico ./examples/lora/lorawan/atcmd/
+```
+
+## PyBadge with LoRa Featherwing 
+
+Builds/flashes atcmd console application on PyBadge using LoRa Featherwing (RFM95/SX1276).
+
+```
+tinygo flash -target pybadge -tags featherwing ./examples/lora/lorawan/atcmd/
+```
+
+## LoRa-E5 
+
+Builds/flashes atcmd console application on Lora-E5 using onboard SX126x.
+
+```
+tinygo flash -target lorae5 ./examples/lora/lorawan/atcmd/
+```
+
@@ -0,0 +1,485 @@
+package main
+
+import (
+	"encoding/hex"
+	"strings"
+
+	"tinygo.org/x/drivers/examples/lora/lorawan/common"
+	"tinygo.org/x/drivers/lora/lorawan"
+)
+
+// Use to test if connection to module is OK.
+func quicktest() {
+	writeCommandOutput("AT", "OK")
+}
+
+// Check firmware version.
+func version() {
+	writeCommandOutput("VER", common.CurrentVersion()+" ("+common.FirmwareVersion()+")")
+}
+
+// Use to check the ID of the LoRaWAN module, or change the ID.
+func id(args string) error {
+	cmd := "ID"
+
+	// look for comma in args
+	param, val, hasComma := strings.Cut(args, ",")
+	if hasComma {
+		// set
+		data := strings.Trim(val, "\"'")
+
+		// convert data from hex formatted string
+		data = strings.ReplaceAll(data, " ", "")
+		hexdata, err := hex.DecodeString(data)
+		if err != nil {
+			writeCommandOutput(cmd, err.Error())
+
+			return err
+		}
+
+		switch param {
+		case "DevAddr":
+			if err := session.SetDevAddr(hexdata); err != nil {
+				writeCommandOutput(cmd, err.Error())
+
+				return err
+			}
+
+			writeCommandOutput(cmd, "DevAddr, "+session.GetDevAddr())
+		case "DevEui":
+			if err := otaa.SetDevEUI(hexdata); err != nil {
+				writeCommandOutput(cmd, err.Error())
+
+				return err
+			}
+
+			writeCommandOutput(cmd, "DevEui, "+otaa.GetDevEUI())
+		case "AppEui":
+			if err := otaa.SetAppEUI(hexdata); err != nil {
+				writeCommandOutput(cmd, err.Error())
+
+				return err
+			}
+
+			writeCommandOutput(cmd, "AppEui, "+otaa.GetAppEUI())
+		default:
+			return errInvalidCommand
+		}
+
+		return nil
+	}
+
+	// get
+	switch param {
+	case "DevAddr":
+		writeCommandOutput(cmd, "DevAddr, "+session.GetDevAddr())
+	case "DevEui":
+		writeCommandOutput(cmd, "DevEui, "+otaa.GetDevEUI())
+	case "AppEui":
+		writeCommandOutput(cmd, "AppEui, "+otaa.GetAppEUI())
+	default:
+		writeCommandOutput(cmd, "DevAddr, "+session.GetDevAddr())
+		writeCommandOutput(cmd, "DevEui, "+otaa.GetDevEUI())
+		writeCommandOutput(cmd, "AppEui, "+otaa.GetAppEUI())
+	}
+
+	return nil
+}
+
+// Use to reset the module. If module returns error, then reset function is invalid.
+func reset() error {
+	radio.Reset()
+
+	writeCommandOutput("RESET", "OK")
+	return nil
+}
+
+// Use to send string format frame which is no need to be confirmed by the server.
+func msg(data string) error {
+	cmd := "MSG"
+	writeCommandOutput(cmd, "Start")
+
+	if err := radio.Tx([]byte(data), defaultTimeout); err != nil {
+		writeCommandOutput(cmd, err.Error())
+
+		return err
+	}
+
+	writeCommandOutput(cmd, "Done")
+	return nil
+}
+
+// Use to send string format frame which must be confirmed by the server
+func cmsg(data string) error {
+	cmd := "CMSG"
+	writeCommandOutput(cmd, "Start")
+
+	if err := radio.Tx([]byte(data), defaultTimeout); err != nil {
+		writeCommandOutput(cmd, err.Error())
+
+		return err
+	}
+
+	// TODO: confirmation
+
+	writeCommandOutput(cmd, "Done")
+	return nil
+}
+
+// Use to send hex format frame which is no need to be confirmed by the server
+func msghex(data string) error {
+	cmd := "MSGHEX"
+	writeCommandOutput(cmd, "Start")
+
+	writeCommandOutput(cmd, "Done")
+	return nil
+}
+
+// Use to send hex format frame which must be confirmed by the server.
+func cmsghex(data string) error {
+	cmd := "CMSGHEX"
+	writeCommandOutput(cmd, "Start")
+
+	writeCommandOutput(cmd, "Done")
+	return nil
+}
+
+// Use to send string format LoRaWAN proprietary frames
+func pmsg(data string) error {
+	cmd := "PMSG"
+	writeCommandOutput(cmd, "Start")
+
+	writeCommandOutput(cmd, "Done")
+	return nil
+}
+
+// Use to send hex format LoRaWAN proprietary frames.
+func pmsghex(data string) error {
+	cmd := "PMSGHEX"
+	writeCommandOutput(cmd, "Start")
+
+	writeCommandOutput(cmd, "Done")
+
+	return nil
+}
+
+// Set PORT number which will be used by MSG/CMSG/MSGHEX/CMSGHEX command to send
+// message, port number should range from 1 to 255. User should refer to LoRaWAN
+// specification to choose port.
+func port(p string) error {
+	cmd := "PMSG"
+	writeCommandOutput(cmd, p)
+
+	return nil
+}
+
+// Set ADR function of LoRaWAN module
+func adr(state string) error {
+	cmd := "ADR"
+	writeCommandOutput(cmd, state)
+
+	return nil
+}
+
+// Use LoRaWAN defined DRx to set datarate of LoRaWAN AT modem.
+func dr(rate string) error {
+	cmd := "DR"
+	writeCommandOutput(cmd, rate)
+
+	return nil
+}
+
+// Channel Configuration
+func ch(channel string) error {
+	cmd := "CH"
+	writeCommandOutput(cmd, channel)
+
+	return nil
+}
+
+// Set and Check Power
+func power(setting string) error {
+	cmd := "POWER"
+	writeCommandOutput(cmd, setting)
+
+	return nil
+}
+
+// Unconfirmed message repeats times.
+func rept(setting string) error {
+	cmd := "REPT"
+	writeCommandOutput(cmd, setting)
+
+	return nil
+}
+
+// Confirmed message retry times. Valid range 0~254,
+// if retry times is less than 2, only one message will
+// be sent. Random delay 3 - 10s between each retry
+// (band duty cycle limitation has the priority)
+func retry(setting string) error {
+	cmd := "RETRY"
+	writeCommandOutput(cmd, setting)
+
+	return nil
+}
+
+func rxwin2(setting string) error {
+	cmd := "RXWIN2"
+	writeCommandOutput(cmd, setting)
+
+	return nil
+}
+
+func rxwin1(setting string) error {
+	cmd := "RXWIN1"
+	writeCommandOutput(cmd, setting)
+
+	return nil
+}
+
+func key(setting string) error {
+	cmd := "KEY"
+
+	// look for comma in args
+	param, val, hasComma := strings.Cut(setting, ",")
+	if hasComma {
+		// set
+		data := strings.Trim(val, "\"'")
+
+		// convert data from hex formatted string
+		data = strings.ReplaceAll(data, " ", "")
+		hexdata, err := hex.DecodeString(data)
+		if err != nil {
+			writeCommandOutput(cmd, err.Error())
+
+			return err
+		}
+
+		switch param {
+		case "APPKEY":
+			if err := otaa.SetAppKey(hexdata); err != nil {
+				writeCommandOutput(cmd, err.Error())
+
+				return err
+			}
+
+			writeCommandOutput(cmd, "APPKEY, "+otaa.GetAppKey())
+		default:
+			return errInvalidCommand
+		}
+	}
+
+	// cannot get keys
+	return errInvalidCommand
+}
+
+func fdefault(setting string) error {
+	cmd := "FDEFAULT"
+	writeCommandOutput(cmd, "OK")
+
+	return nil
+}
+
+func mode(setting string) error {
+	cmd := "MODE"
+	writeCommandOutput(cmd, setting)
+
+	return nil
+}
+
+func join(setting string) error {
+	// TODO: check that DevEUI, AppEUI, and AppKey have values
+
+	cmd := "JOIN"
+	writeCommandOutput(cmd, "Starting")
+	if err := lorawan.Join(otaa, session); err != nil {
+		writeCommandOutput(cmd, err.Error())
+
+		return err
+	}
+
+	writeCommandOutput(cmd, "Network joined")
+	writeCommandOutput(cmd, "DevEui, "+otaa.GetDevEUI())
+	writeCommandOutput(cmd, "AppEui, "+otaa.GetAppEUI())
+	writeCommandOutput(cmd, "DevAddr, "+session.GetDevAddr())
+	writeCommandOutput(cmd, "NetID, "+otaa.GetNetID())
+	writeCommandOutput(cmd, "NwkSKey, "+session.GetNwkSKey())
+	writeCommandOutput(cmd, "AppSKey, "+session.GetAppSKey())
+	writeCommandOutput(cmd, "Done")
+	return nil
+}
+
+func beacon(setting string) error {
+	cmd := "BEACON"
+	writeCommandOutput(cmd, "Starting")
+
+	writeCommandOutput(cmd, "Done")
+
+	return nil
+}
+
+func class(setting string) error {
+	cmd := "CLASS"
+	writeCommandOutput(cmd, "Starting")
+
+	writeCommandOutput(cmd, "Done")
+
+	return nil
+}
+
+func delay(setting string) error {
+	cmd := "DELAY"
+	writeCommandOutput(cmd, setting)
+
+	return nil
+}
+
+func lw(setting string) error {
+	cmd := "LW"
+	writeCommandOutput(cmd, setting)
+
+	return nil
+}
+
+func wdt(setting string) error {
+	cmd := "WDT"
+	writeCommandOutput(cmd, "Not implemented")
+
+	return nil
+}
+
+func lowpower(setting string) error {
+	cmd := "LOWPOWER"
+	writeCommandOutput(cmd, "Not implemented")
+
+	return nil
+}
+
+func vdd(setting string) error {
+	cmd := "VDD"
+	writeCommandOutput(cmd, "Not implemented")
+
+	return nil
+}
+
+func temp(setting string) error {
+	cmd := "TEMP"
+	writeCommandOutput(cmd, "Not implemented")
+
+	return nil
+}
+
+func rtc(setting string) error {
+	cmd := "RTC"
+	writeCommandOutput(cmd, "Not implemented")
+
+	return nil
+}
+
+func eeprom(setting string) error {
+	cmd := "EEPROM"
+	writeCommandOutput(cmd, "Not implemented")
+
+	return nil
+}
+
+func uartcmd(setting string) error {
+	cmd := "UART"
+	writeCommandOutput(cmd, "Not implemented")
+
+	return nil
+}
+
+func test(setting string) error {
+	cmd := "TEST"
+	writeCommandOutput(cmd, "Not implemented")
+
+	return nil
+}
+
+func log(setting string) error {
+	cmd := "LOG"
+	writeCommandOutput(cmd, "Not implemented")
+
+	return nil
+}
+
+func send(data string) error {
+	cmd := "SEND"
+	writeCommandOutput(cmd, "Start")
+
+	// remove leading/trailing quotes
+	data = strings.Trim(data, "\"'")
+
+	if err := radio.Tx([]byte(data), defaultTimeout); err != nil {
+		writeCommandOutput(cmd, err.Error())
+
+		return err
+	}
+
+	writeCommandOutput(cmd, "Done")
+	return nil
+}
+
+func sendhex(data string) error {
+	cmd := "SENDHEX"
+	writeCommandOutput(cmd, "Start")
+
+	// remove leading/trailing quotes
+	data = strings.Trim(data, "\"'")
+
+	// convert data from hex formatted string
+	data = strings.ReplaceAll(data, " ", "")
+	payload, err := hex.DecodeString(data)
+	if err != nil {
+		writeCommandOutput(cmd, err.Error())
+
+		return err
+	}
+
+	if err := radio.Tx(payload, defaultTimeout); err != nil {
+		writeCommandOutput(cmd, err.Error())
+
+		return err
+	}
+
+	writeCommandOutput(cmd, "Done")
+	return nil
+}
+
+func recv(setting string) error {
+	cmd := "RECV"
+
+	data, err := common.Lorarx()
+	if err != nil {
+		writeCommandOutput(cmd, "ERROR "+err.Error())
+		return err
+	}
+	writeCommandOutput(cmd, string(data))
+
+	return nil
+}
+
+func recvhex(setting string) error {
+	cmd := "RECVHEX"
+
+	data, err := common.Lorarx()
+	if err != nil {
+		writeCommandOutput(cmd, "ERROR "+err.Error())
+		return err
+	}
+	writeCommandOutput(cmd, string(data))
+
+	return nil
+}
+
+func crlf() {
+	uart.Write([]byte("\r\n"))
+}
+
+func writeCommandOutput(cmd, data string) {
+	uart.Write([]byte("+" + cmd + ": "))
+	uart.Write([]byte(data))
+	crlf()
+}
@@ -0,0 +1,76 @@
+// AT command set console running on the device UART to communicate with
+// an attached LoRa device.
+//
+// Computer <-> UART <-> MCU <-> SPI <-> SX126x/SX127x
+//
+// Connect using default baudrate for this hardware, 8-N-1 with your terminal program.
+// For details on the AT command set, see:
+// https://files.seeedstudio.com/products/317990687/res/LoRa-E5%20AT%20Command%20Specification_V1.0%20.pdf
+package main
+
+import (
+	"machine"
+	"time"
+
+	"tinygo.org/x/drivers/examples/lora/lorawan/common"
+	"tinygo.org/x/drivers/lora"
+	"tinygo.org/x/drivers/lora/lorawan"
+)
+
+// change these to test a different UART or pins if available
+var (
+	uart  = machine.Serial
+	tx    = machine.UART_TX_PIN
+	rx    = machine.UART_RX_PIN
+	input = make([]byte, 0, 64)
+
+	radio   lora.Radio
+	session *lorawan.Session
+	otaa    *lorawan.Otaa
+
+	defaultTimeout uint32 = 1000
+)
+
+func main() {
+	uart.Configure(machine.UARTConfig{TX: tx, RX: rx})
+
+	var err error
+	radio, err = common.SetupLora()
+	if err != nil {
+		fail(err.Error())
+	}
+
+	session = &lorawan.Session{}
+	otaa = &lorawan.Otaa{}
+	lorawan.UseRadio(radio)
+
+	for {
+		if uart.Buffered() > 0 {
+			data, _ := uart.ReadByte()
+
+			switch data {
+			case 13:
+				// return key
+				if err := parse(input); err != nil {
+					uart.Write([]byte("ERROR: "))
+					uart.Write([]byte(err.Error()))
+					crlf()
+				}
+				input = input[:0]
+			default:
+				// just capture the character
+				input = append(input, data)
+			}
+		}
+		time.Sleep(10 * time.Millisecond)
+	}
+}
+
+func fail(msg string) {
+	for {
+		uart.Write([]byte(msg))
+		crlf()
+
+		time.Sleep(time.Minute)
+	}
+}
@@ -0,0 +1,115 @@
+package main
+
+import (
+	"errors"
+	"strings"
+)
+
+var (
+	errInvalidCommand = errors.New("Invalid command")
+)
+
+func parse(data []byte) error {
+	switch {
+	case len(data) < 2, string(data[0:2]) != "AT":
+		return errInvalidCommand
+	case len(data) == 2:
+		// just the AT command by itself
+		quicktest()
+	case len(data) < 6 || data[2] != '+':
+		return errInvalidCommand
+	default:
+		// parse the rest of the command
+		cmd, args, _ := strings.Cut(string(data[3:]), "=")
+		return parseCommand(cmd, args)
+	}
+
+	return nil
+}
+
+func parseCommand(cmd, args string) error {
+	switch cmd {
+	case "VER":
+		version()
+	case "ID":
+		id(args)
+	case "RESET":
+		reset()
+	case "MSG":
+		msg(args)
+	case "CMSG":
+		cmsg(args)
+	case "MSGHEX":
+		msghex(args)
+	case "CMSGHEX":
+		cmsghex(args)
+	case "PMSG":
+		pmsg(args)
+	case "PMSGHEX":
+		pmsg(args)
+	case "PORT":
+		port(args)
+	case "ADR":
+		adr(args)
+	case "DR":
+		dr(args)
+	case "CH":
+		ch(args)
+	case "POWER":
+		power(args)
+	case "REPT":
+		rept(args)
+	case "RETRY":
+		retry(args)
+	case "RXWIN2":
+		rxwin2(args)
+	case "RXWIN1":
+		rxwin1(args)
+	case "KEY":
+		key(args)
+	case "FDEFAULT":
+		fdefault(args)
+	case "MODE":
+		mode(args)
+	case "JOIN":
+		join(args)
+	case "BEACON":
+		join(args)
+	case "CLASS":
+		class(args)
+	case "DELAY":
+		delay(args)
+	case "LW":
+		lw(args)
+	case "WDT":
+		wdt(args)
+	case "LOWPOWER":
+		lowpower(args)
+	case "VDD":
+		vdd(args)
+	case "TEMP":
+		temp(args)
+	case "RTC":
+		rtc(args)
+	case "EEPROM":
+		eeprom(args)
+	case "UART":
+		uartcmd(args)
+	case "TEST":
+		test(args)
+	case "LOG":
+		log(args)
+	case "RECV":
+		recv(args)
+	case "RECVHEX":
+		recvhex(args)
+	case "SEND":
+		send(args)
+	case "SENDHEX":
+		sendhex(args)
+	default:
+		return errInvalidCommand
+	}
+
+	return nil
+}
@@ -0,0 +1,35 @@
+# Simple Lorawan example
+
+This demo code will connect Lorawan network and send sample uplink message
+
+You may change your Lorawan keys (AppEUI, DevEUI, AppKEY) in key-default.go
+
+
+```
+$ tinygo monitor
+Connected to /dev/ttyACM0. Press Ctrl-C to exit.
+Lorawan Simple Demo
+Start Lorawan Join sequence
+loraConnect: Connected !
+```
+
+# Building
+
+## Simulator
+
+```
+tinygo flash -target pico ./examples/lora/lorawan/basic-demo
+```
+
+## PyBadge with LoRa Featherwing 
+
+```
+tinygo flash -target pybadge -tags featherwing ./examples/lora/lorawan/basic-demo
+```
+
+## LoRa-E5 
+
+```
+tinygo flash -target lorae5 ./examples/lora/lorawan/basic-demo
+```
+
@@ -0,0 +1,11 @@
+//go:build !customkeys
+
+package main
+
+// These are sample keys, so the example builds
+// Either change here, or create a new go file and use customkeys build tag
+func setLorawanKeys() {
+	otaa.SetAppEUI([]uint8{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})
+	otaa.SetDevEUI([]uint8{0xB3, 0xD5, 0x41, 0x00, 0x0A, 0xF1, 0xA4, 0x45})
+	otaa.SetAppKey([]uint8{0x12, 0x22, 0xA3, 0xFF, 0x0C, 0x7B, 0x76, 0x7B, 0x8F, 0xD3, 0x12, 0x4F, 0xCE, 0x7A, 0x32, 0x16})
+}
@@ -0,0 +1,107 @@
+// Simple code for connecting to Lorawan network and uploading sample payload
+package main
+
+import (
+	"errors"
+	"strconv"
+	"time"
+
+	"tinygo.org/x/drivers/examples/lora/lorawan/common"
+	"tinygo.org/x/drivers/lora"
+	"tinygo.org/x/drivers/lora/lorawan"
+)
+
+const (
+	LORAWAN_JOIN_TIMEOUT_SEC    = 180
+	LORAWAN_RECONNECT_DELAY_SEC = 15
+	LORAWAN_UPLINK_DELAY_SEC    = 60
+)
+
+var (
+	radio   lora.Radio
+	session *lorawan.Session
+	otaa    *lorawan.Otaa
+)
+
+func loraConnect() error {
+	start := time.Now()
+	var err error
+	for time.Since(start) < LORAWAN_JOIN_TIMEOUT_SEC*time.Second {
+		println("Trying to join network")
+		err = lorawan.Join(otaa, session)
+		if err == nil {
+			println("Connected to network !")
+			return nil
+		}
+		println("Join error:", err, "retrying in", LORAWAN_RECONNECT_DELAY_SEC, "sec")
+		time.Sleep(time.Second * LORAWAN_RECONNECT_DELAY_SEC)
+	}
+
+	err = errors.New("Unable to join Lorawan network")
+	println(err.Error())
+	return err
+}
+
+func failMessage(err error) {
+	println("FATAL:", err)
+	for {
+	}
+}
+
+func main() {
+	println("*** Lorawan basic join and uplink demo ***")
+
+	// Board specific Lorawan initialization
+	var err error
+	radio, err = common.SetupLora()
+	if err != nil {
+		failMessage(err)
+	}
+
+	// Required for LoraWan operations
+	session = &lorawan.Session{}
+	otaa = &lorawan.Otaa{}
+
+	// Initial Lora modulation configuration
+	loraConf := lora.Config{
+		Freq:           868100000,
+		Bw:             lora.Bandwidth_125_0,
+		Sf:             lora.SpreadingFactor9,
+		Cr:             lora.CodingRate4_7,
+		HeaderType:     lora.HeaderExplicit,
+		Preamble:       12,
+		Ldr:            lora.LowDataRateOptimizeOff,
+		Iq:             lora.IQStandard,
+		Crc:            lora.CRCOn,
+		SyncWord:       lora.SyncPublic,
+		LoraTxPowerDBm: 20,
+	}
+	radio.LoraConfig(loraConf)
+
+	// Connect the lorawan with the Lora Radio device.
+	lorawan.UseRadio(radio)
+
+	// Configure AppEUI, DevEUI, APPKey
+	setLorawanKeys()
+
+	// Try to connect Lorawan network
+	if err := loraConnect(); err != nil {
+		failMessage(err)
+	}
+
+	// Try to periodicaly send an uplink sample message
+	upCount := 1
+	for {
+		payload := "Hello TinyGo #" + strconv.Itoa(upCount)
+
+		if err := lorawan.SendUplink([]byte(payload), session); err != nil {
+			println("Uplink error:", err)
+		} else {
+			println("Uplink success, msg=", payload)
+		}
+
+		println("Sleeping for", LORAWAN_UPLINK_DELAY_SEC, "sec")
+		time.Sleep(time.Second * LORAWAN_UPLINK_DELAY_SEC)
+		upCount++
+	}
+}
@@ -0,0 +1,10 @@
+package common
+
+import (
+	"errors"
+)
+
+var (
+	errRadioNotFound = errors.New("radio not found")
+	errRxTimeout     = errors.New("radio RX timeout")
+)
@@ -0,0 +1,40 @@
+//go:build !featherwing && !stm32wlx && !sx126x
+
+package common
+
+import "tinygo.org/x/drivers/lora"
+
+// do simulator setup here
+func SetupLora() (lora.Radio, error) {
+	return &SimLoraRadio{}, nil
+}
+
+type SimLoraRadio struct {
+}
+
+func (sr *SimLoraRadio) Reset() {
+}
+
+func (sr *SimLoraRadio) Tx(pkt []uint8, timeoutMs uint32) error {
+	return nil
+}
+
+func (sr *SimLoraRadio) Rx(timeoutMs uint32) ([]uint8, error) {
+	return nil, nil
+}
+
+func (sr *SimLoraRadio) SetFrequency(freq uint32)    {}
+func (sr *SimLoraRadio) SetIqMode(mode uint8)        {}
+func (sr *SimLoraRadio) SetCodingRate(cr uint8)      {}
+func (sr *SimLoraRadio) SetBandwidth(bw uint8)       {}
+func (sr *SimLoraRadio) SetCrc(enable bool)          {}
+func (sr *SimLoraRadio) SetSpreadingFactor(sf uint8) {}
+func (sr *SimLoraRadio) LoraConfig(cnf lora.Config)  {}
+
+func FirmwareVersion() string {
+	return "simulator " + CurrentVersion()
+}
+
+func Lorarx() ([]byte, error) {
+	return nil, nil
+}
@@ -0,0 +1,65 @@
+//go:build stm32wlx
+
+package common
+
+import (
+	"machine"
+
+	"tinygo.org/x/drivers/lora"
+	"tinygo.org/x/drivers/sx126x"
+)
+
+const (
+	FREQ                      = 868100000
+	LORA_DEFAULT_RXTIMEOUT_MS = 1000
+	LORA_DEFAULT_TXTIMEOUT_MS = 5000
+)
+
+var (
+	loraRadio *sx126x.Device
+)
+
+var spi = machine.SPI3
+
+func newRadioControl() sx126x.RadioController {
+	return sx126x.NewRadioControl()
+}
+
+// do sx126x setup here
+func SetupLora() (lora.Radio, error) {
+	loraRadio = sx126x.New(spi)
+	loraRadio.SetDeviceType(sx126x.DEVICE_TYPE_SX1262)
+
+	// Create radio controller for target
+	loraRadio.SetRadioController(newRadioControl())
+
+	if state := loraRadio.DetectDevice(); !state {
+		return nil, errRadioNotFound
+	}
+
+	loraConf := lora.Config{
+		Freq:           FREQ,
+		Bw:             lora.Bandwidth_500_0,
+		Sf:             lora.SpreadingFactor9,
+		Cr:             lora.CodingRate4_7,
+		HeaderType:     lora.HeaderExplicit,
+		Preamble:       12,
+		Ldr:            lora.LowDataRateOptimizeOff,
+		Iq:             lora.IQStandard,
+		Crc:            lora.CRCOn,
+		SyncWord:       lora.SyncPrivate,
+		LoraTxPowerDBm: 20,
+	}
+
+	loraRadio.LoraConfig(loraConf)
+
+	return loraRadio, nil
+}
+
+func FirmwareVersion() string {
+	return "sx126x"
+}
+
+func Lorarx() ([]byte, error) {
+	return loraRadio.Rx(LORA_DEFAULT_RXTIMEOUT_MS)
+}
@@ -0,0 +1,69 @@
+//go:build !stm32wlx && sx126x
+
+package common
+
+import (
+	"machine"
+
+	"tinygo.org/x/drivers/lora"
+	"tinygo.org/x/drivers/sx126x"
+)
+
+const (
+	FREQ                      = 868100000
+	LORA_DEFAULT_RXTIMEOUT_MS = 1000
+	LORA_DEFAULT_TXTIMEOUT_MS = 5000
+)
+
+var (
+	loraRadio *sx126x.Device
+)
+
+var (
+	spi                        = machine.SPI0
+	nssPin, busyPin, dio1Pin   = machine.GP17, machine.GP10, machine.GP11
+	rxPin, txLowPin, txHighPin = machine.GP13, machine.GP12, machine.GP12
+)
+
+func newRadioControl() sx126x.RadioController {
+	return sx126x.NewRadioControl(nssPin, busyPin, dio1Pin, rxPin, txLowPin, txHighPin)
+}
+
+// do sx126x setup here
+func SetupLora() (lora.Radio, error) {
+	loraRadio = sx126x.New(spi)
+	loraRadio.SetDeviceType(sx126x.DEVICE_TYPE_SX1262)
+
+	// Create radio controller for target
+	loraRadio.SetRadioController(newRadioControl())
+
+	if state := loraRadio.DetectDevice(); !state {
+		return nil, errRadioNotFound
+	}
+
+	loraConf := lora.Config{
+		Freq:           FREQ,
+		Bw:             lora.Bandwidth_500_0,
+		Sf:             lora.SpreadingFactor9,
+		Cr:             lora.CodingRate4_7,
+		HeaderType:     lora.HeaderExplicit,
+		Preamble:       12,
+		Ldr:            lora.LowDataRateOptimizeOff,
+		Iq:             lora.IQStandard,
+		Crc:            lora.CRCOn,
+		SyncWord:       lora.SyncPrivate,
+		LoraTxPowerDBm: 20,
+	}
+
+	loraRadio.LoraConfig(loraConf)
+
+	return loraRadio, nil
+}
+
+func FirmwareVersion() string {
+	return "sx126x"
+}
+
+func Lorarx() ([]byte, error) {
+	return loraRadio.Rx(LORA_DEFAULT_RXTIMEOUT_MS)
+}
@@ -0,0 +1,85 @@
+//go:build featherwing
+
+package common
+
+import (
+	"strconv"
+
+	"machine"
+
+	"tinygo.org/x/drivers/lora"
+	"tinygo.org/x/drivers/sx127x"
+)
+
+const (
+	FREQ                      = 868100000
+	LORA_DEFAULT_RXTIMEOUT_MS = 1000
+	LORA_DEFAULT_TXTIMEOUT_MS = 5000
+)
+
+var (
+	// We assume LoRa Featherwing module is connected to PyBadge:
+	rstPin    = machine.D11
+	csPin     = machine.D10
+	dio0Pin   = machine.D6
+	dio1Pin   = machine.D9
+	spi       = machine.SPI0
+	loraRadio *sx127x.Device
+)
+
+// do sx127x setup here
+func SetupLora() (lora.Radio, error) {
+	rstPin.Configure(machine.PinConfig{Mode: machine.PinOutput})
+	csPin.Configure(machine.PinConfig{Mode: machine.PinOutput})
+	dio0Pin.Configure(machine.PinConfig{Mode: machine.PinInputPullup})
+	dio1Pin.Configure(machine.PinConfig{Mode: machine.PinInputPullup})
+	spi.Configure(machine.SPIConfig{Frequency: 500000, Mode: 0})
+
+	loraRadio = sx127x.New(spi, csPin, rstPin)
+	loraRadio.Reset()
+
+	if state := loraRadio.DetectDevice(); !state {
+		return nil, errRadioNotFound
+	}
+
+	// Setup DIO0 interrupt Handling
+	if err := dio0Pin.SetInterrupt(machine.PinRising, dioIrqHandler); err != nil {
+		println("could not configure DIO0 pin interrupt:", err.Error())
+	}
+
+	// Setup DIO1 interrupt Handling
+	if err := dio1Pin.SetInterrupt(machine.PinRising, dioIrqHandler); err != nil {
+		println("could not configure DIO1 pin interrupt:", err.Error())
+	}
+
+	// Prepare for Lora Operation
+	loraConf := lora.Config{
+		Freq:           FREQ,
+		Bw:             lora.Bandwidth_125_0,
+		Sf:             lora.SpreadingFactor9,
+		Cr:             lora.CodingRate4_7,
+		HeaderType:     lora.HeaderExplicit,
+		Preamble:       12,
+		Iq:             lora.IQStandard,
+		Crc:            lora.CRCOn,
+		SyncWord:       lora.SyncPublic,
+		LoraTxPowerDBm: 20,
+	}
+
+	loraRadio.LoraConfig(loraConf)
+
+	return loraRadio, nil
+}
+
+func dioIrqHandler(machine.Pin) {
+	loraRadio.HandleInterrupt()
+}
+
+func FirmwareVersion() string {
+	v := loraRadio.GetVersion()
+	return "sx127x v" + strconv.Itoa(int(v))
+}
+
+func Lorarx() ([]byte, error) {
+	return loraRadio.Rx(LORA_DEFAULT_RXTIMEOUT_MS)
+}
@@ -0,0 +1,7 @@
+package common
+
+const VERSION = "0.0.1"
+
+func CurrentVersion() string {
+	return VERSION
+}
@@ -9,7 +9,7 @@ import (

 var (
 	led    machine.Pin = machine.LED
-	button machine.Pin = machine.BUTTON
+	button machine.Pin = machine.D10
 	key    *makeybutton.Button
 )

@@ -25,6 +25,7 @@ func main() {
 		case makeybutton.Released:
 			led.Low()
 		}
-		time.Sleep(100 * time.Millisecond)
+		// the more frequent the more responsive
+		time.Sleep(50 * time.Millisecond)
 	}
 }
@@ -2,7 +2,6 @@
 // to read data from the onboard MEMS microphone.
 //
 // Uses ideas from the https://github.com/adafruit/Adafruit_CircuitPlayground repo.
-//
 package main

 import (
@@ -0,0 +1,66 @@
+// Connects to an QMI8658C I2C accelerometer/gyroscope and print the read data.
+// This example was made with the "WaveShare RP2040 Round LCD 1.28in" in mind.
+// For more infor about this development board:
+// https://www.waveshare.com/wiki/RP2040-LCD-1.28
+package main
+
+import (
+	"machine"
+	"time"
+
+	imu "tinygo.org/x/drivers/qmi8658c"
+)
+
+func main() {
+	i2c := machine.I2C1
+	// This is the default pinout for the "WaveShare RP2040 Round LCD 1.28in"
+	err := i2c.Configure(machine.I2CConfig{
+		SDA:       machine.GP6,
+		SCL:       machine.GP7,
+		Frequency: 100000,
+	})
+	if err != nil {
+		println("unable to configure I2C:", err)
+		return
+	}
+	// Create a new device
+	d := imu.New(i2c)
+
+	// Check if the device is connected
+	if !d.Connected() {
+		println("unable to connect to sensor")
+		return
+	}
+
+	// This IMU has multiple configurations like output data rate, multiple
+	// measurements scales, low pass filters, low power modes, all the vailable
+	// values can be found in the datasheet and were defined at registers file.
+	// This is the default configuration which will be used if the `nil` value
+	// is passed do the `Configure` method.
+	config := imu.Config{
+		SPIMode:     imu.SPI_4_WIRE,
+		SPIEndian:   imu.SPI_BIG_ENDIAN,
+		SPIAutoInc:  imu.SPI_AUTO_INC,
+		AccEnable:   imu.ACC_ENABLE,
+		AccScale:    imu.ACC_8G,
+		AccRate:     imu.ACC_NORMAL_1000HZ,
+		AccLowPass:  imu.ACC_LOW_PASS_2_62,
+		GyroEnable:  imu.GYRO_FULL_ENABLE,
+		GyroScale:   imu.GYRO_512DPS,
+		GyroRate:    imu.GYRO_1000HZ,
+		GyroLowPass: imu.GYRO_LOW_PASS_2_62,
+	}
+	d.Configure(config)
+
+	// Read the accelation, rotation and temperature data and print them.
+	for {
+		acc_x, acc_y, acc_z := d.ReadAcceleration()
+		gyro_x, gyro_y, gyro_z := d.ReadRotation()
+		temp, _ := d.ReadTemperature()
+		println("-------------------------------")
+		println("acc:", acc_x, acc_y, acc_z)
+		println("gyro:", gyro_x, gyro_y, gyro_z)
+		println("temp:", temp)
+		time.Sleep(time.Millisecond * 100)
+	}
+}
@@ -7,15 +7,16 @@
 //
 // You must install the Paho MQTT package to build this program:
 //
-// 		go get -u github.com/eclipse/paho.mqtt.golang
+//	go get -u github.com/eclipse/paho.mqtt.golang
 //
 // You can check that mqttpub is running successfully with the following command.
 //
-// 		mosquitto_sub -h test.mosquitto.org -t tinygo
-//
+//	mosquitto_sub -h test.mosquitto.org -t tinygo
 package main

 import (
+	"machine"
+
 	"fmt"
 	"math/rand"
 	"time"
@@ -28,23 +29,23 @@ import (
 // You can override the setting with the init() in another source code.
 // func init() {
 //    ssid = "your-ssid"
-//    password = "your-password"
+//    pass = "your-password"
 //    debug = true
 //    server = "tinygo.org"
 // }

 var (
-	ssid     string
-	password string
-	server   string = "tcp://test.mosquitto.org:1883"
-	debug           = false
+	ssid   string
+	pass   string
+	server string = "tcp://test.mosquitto.org:1883"
+	debug         = false
 )

 var buf [0x400]byte

 var lastRequestTime time.Time
 var conn net.Conn
-var adaptor *rtl8720dn.RTL8720DN
+var adaptor *rtl8720dn.Driver

 func main() {
 	err := run()
@@ -59,18 +60,17 @@ var (
 )

 func run() error {
-	rtl, err := setupRTL8720DN()
-	if err != nil {
-		return err
-	}
-	net.UseDriver(rtl)
+	// change the UART and pins as needed for platforms other than the WioTerminal.
+	adaptor = rtl8720dn.New(machine.UART3, machine.PB24, machine.PC24, machine.RTL8720D_CHIP_PU)
+	adaptor.Debug(debug)
+	adaptor.Configure()

-	err = rtl.ConnectToAccessPoint(ssid, password, 10*time.Second)
+	err := adaptor.ConnectToAccessPoint(ssid, pass, 10*time.Second)
 	if err != nil {
 		return err
 	}

-	ip, subnet, gateway, err := rtl.GetIP()
+	ip, subnet, gateway, err := adaptor.GetIP()
 	if err != nil {
 		return err
 	}
@@ -1,74 +0,0 @@
-//go:build wioterminal
-// +build wioterminal
-
-package main
-
-import (
-	"device/sam"
-	"machine"
-	"runtime/interrupt"
-	"time"
-
-	"tinygo.org/x/drivers/rtl8720dn"
-)
-
-var (
-	uart UARTx
-)
-
-func handleInterrupt(interrupt.Interrupt) {
-	// should reset IRQ
-	uart.Receive(byte((uart.Bus.DATA.Get() & 0xFF)))
-	uart.Bus.INTFLAG.SetBits(sam.SERCOM_USART_INT_INTFLAG_RXC)
-}
-
-func setupRTL8720DN() (*rtl8720dn.RTL8720DN, error) {
-	machine.RTL8720D_CHIP_PU.Configure(machine.PinConfig{Mode: machine.PinOutput})
-	machine.RTL8720D_CHIP_PU.Low()
-	time.Sleep(100 * time.Millisecond)
-	machine.RTL8720D_CHIP_PU.High()
-	time.Sleep(1000 * time.Millisecond)
-	if debug {
-		waitSerial()
-	}
-
-	uart = UARTx{
-		UART: &machine.UART{
-			Buffer: machine.NewRingBuffer(),
-			Bus:    sam.SERCOM0_USART_INT,
-			SERCOM: 0,
-		},
-	}
-
-	uart.Interrupt = interrupt.New(sam.IRQ_SERCOM0_2, handleInterrupt)
-	uart.Configure(machine.UARTConfig{TX: machine.PB24, RX: machine.PC24, BaudRate: 614400})
-
-	rtl := rtl8720dn.New(uart)
-	rtl.Debug(debug)
-
-	_, err := rtl.Rpc_tcpip_adapter_init()
-	if err != nil {
-		return nil, err
-	}
-
-	return rtl, nil
-}
-
-// Wait for user to open serial console
-func waitSerial() {
-	for !machine.Serial.DTR() {
-		time.Sleep(100 * time.Millisecond)
-	}
-}
-
-type UARTx struct {
-	*machine.UART
-}
-
-func (u UARTx) Read(p []byte) (n int, err error) {
-	if u.Buffered() == 0 {
-		time.Sleep(1 * time.Millisecond)
-		return 0, nil
-	}
-	return u.UART.Read(p)
-}
@@ -7,16 +7,17 @@
 //
 // You must also install the Paho MQTT package to build this program:
 //
-// 		go get -u github.com/eclipse/paho.mqtt.golang
+//	go get -u github.com/eclipse/paho.mqtt.golang
 //
 // You can check that mqttpub/mqttsub is running successfully with the following command.
 //
-// 		mosquitto_sub -h test.mosquitto.org -t tinygo/tx
-// 		mosquitto_pub -h test.mosquitto.org -t tinygo/rx -m "hello world"
-//
+//	mosquitto_sub -h test.mosquitto.org -t tinygo/tx
+//	mosquitto_pub -h test.mosquitto.org -t tinygo/rx -m "hello world"
 package main

 import (
+	"machine"
+
 	"fmt"
 	"math/rand"
 	"time"
@@ -29,23 +30,23 @@ import (
 // You can override the setting with the init() in another source code.
 // func init() {
 //    ssid = "your-ssid"
-//    password = "your-password"
+//    pass = "your-password"
 //    debug = true
 //    server = "tinygo.org"
 // }

 var (
-	ssid     string
-	password string
-	server   string = "tcp://test.mosquitto.org:1883"
-	debug           = false
+	ssid   string
+	pass   string
+	server string = "tcp://test.mosquitto.org:1883"
+	debug         = false
 )

 var buf [0x400]byte

 var lastRequestTime time.Time
 var conn net.Conn
-var adaptor *rtl8720dn.RTL8720DN
+var adaptor *rtl8720dn.Driver

 func main() {
 	err := run()
@@ -68,18 +69,17 @@ func subHandler(client mqtt.Client, msg mqtt.Message) {
 }

 func run() error {
-	rtl, err := setupRTL8720DN()
-	if err != nil {
-		return err
-	}
-	net.UseDriver(rtl)
+	// change the UART and pins as needed for platforms other than the WioTerminal.
+	adaptor = rtl8720dn.New(machine.UART3, machine.PB24, machine.PC24, machine.RTL8720D_CHIP_PU)
+	adaptor.Debug(debug)
+	adaptor.Configure()

-	err = rtl.ConnectToAccessPoint(ssid, password, 10*time.Second)
+	err := adaptor.ConnectToAccessPoint(ssid, pass, 10*time.Second)
 	if err != nil {
 		return err
 	}

-	ip, subnet, gateway, err := rtl.GetIP()
+	ip, subnet, gateway, err := adaptor.GetIP()
 	if err != nil {
 		return err
 	}
@@ -1,74 +0,0 @@
-//go:build wioterminal
-// +build wioterminal
-
-package main
-
-import (
-	"device/sam"
-	"machine"
-	"runtime/interrupt"
-	"time"
-
-	"tinygo.org/x/drivers/rtl8720dn"
-)
-
-var (
-	uart UARTx
-)
-
-func handleInterrupt(interrupt.Interrupt) {
-	// should reset IRQ
-	uart.Receive(byte((uart.Bus.DATA.Get() & 0xFF)))
-	uart.Bus.INTFLAG.SetBits(sam.SERCOM_USART_INT_INTFLAG_RXC)
-}
-
-func setupRTL8720DN() (*rtl8720dn.RTL8720DN, error) {
-	machine.RTL8720D_CHIP_PU.Configure(machine.PinConfig{Mode: machine.PinOutput})
-	machine.RTL8720D_CHIP_PU.Low()
-	time.Sleep(100 * time.Millisecond)
-	machine.RTL8720D_CHIP_PU.High()
-	time.Sleep(1000 * time.Millisecond)
-	if debug {
-		waitSerial()
-	}
-
-	uart = UARTx{
-		UART: &machine.UART{
-			Buffer: machine.NewRingBuffer(),
-			Bus:    sam.SERCOM0_USART_INT,
-			SERCOM: 0,
-		},
-	}
-
-	uart.Interrupt = interrupt.New(sam.IRQ_SERCOM0_2, handleInterrupt)
-	uart.Configure(machine.UARTConfig{TX: machine.PB24, RX: machine.PC24, BaudRate: 614400})
-
-	rtl := rtl8720dn.New(uart)
-	rtl.Debug(debug)
-
-	_, err := rtl.Rpc_tcpip_adapter_init()
-	if err != nil {
-		return nil, err
-	}
-
-	return rtl, nil
-}
-
-// Wait for user to open serial console
-func waitSerial() {
-	for !machine.Serial.DTR() {
-		time.Sleep(100 * time.Millisecond)
-	}
-}
-
-type UARTx struct {
-	*machine.UART
-}
-
-func (u UARTx) Read(p []byte) (n int, err error) {
-	if u.Buffered() == 0 {
-		time.Sleep(1 * time.Millisecond)
-		return 0, nil
-	}
-	return u.UART.Read(p)
-}
@@ -4,28 +4,31 @@
 package main

 import (
+	"machine"
+
 	"errors"
 	"fmt"
 	"runtime"
 	"time"

 	"tinygo.org/x/drivers/net"
+	"tinygo.org/x/drivers/rtl8720dn"
 )

 // IP address of the server aka "hub". Replace with your own info.
 // You can override the setting with the init() in another source code.
 // func init() {
 //    ssid = "your-ssid"
-//    password = "your-password"
+//    pass = "your-password"
 //    ntpHost = "129.6.15.29"
 //    debug = true
 // }

 var (
-	ssid     string
-	password string
-	ntpHost  = "129.6.15.29"
-	debug    = false
+	ssid    string
+	pass    string
+	ntpHost = "129.6.15.29"
+	debug   = false
 )

 const NTP_PACKET_SIZE = 48
@@ -41,18 +44,16 @@ func main() {
 }

 func run() error {
-	rtl, err := setupRTL8720DN()
-	if err != nil {
-		return err
-	}
-	net.UseDriver(rtl)
+	adaptor := rtl8720dn.New(machine.UART3, machine.PB24, machine.PC24, machine.RTL8720D_CHIP_PU)
+	adaptor.Debug(debug)
+	adaptor.Configure()

-	err = rtl.ConnectToAccessPoint(ssid, password, 10*time.Second)
+	err := adaptor.ConnectToAccessPoint(ssid, pass, 10*time.Second)
 	if err != nil {
 		return err
 	}

-	ip, subnet, gateway, err := rtl.GetIP()
+	ip, subnet, gateway, err := adaptor.GetIP()
 	if err != nil {
 		return err
 	}
@@ -99,9 +100,7 @@ func getCurrentTime(conn *net.UDPSerialConn) (time.Time, error) {
 		} else if n == 0 {
 			continue // no packet received yet
 		} else if n != NTP_PACKET_SIZE {
-			if n != NTP_PACKET_SIZE {
-				return time.Time{}, fmt.Errorf("expected NTP packet size of %d: %d", NTP_PACKET_SIZE, n)
-			}
+			return time.Time{}, fmt.Errorf("expected NTP packet size of %d: %d", NTP_PACKET_SIZE, n)
 		}
 		return parseNTPpacket(), nil
 	}
@@ -1,72 +0,0 @@
-//go:build wioterminal
-// +build wioterminal
-
-package main
-
-import (
-	"device/sam"
-	"machine"
-	"runtime/interrupt"
-	"time"
-
-	"tinygo.org/x/drivers/rtl8720dn"
-)
-
-var (
-	uart UARTx
-)
-
-func handleInterrupt(interrupt.Interrupt) {
-	// should reset IRQ
-	uart.Receive(byte((uart.Bus.DATA.Get() & 0xFF)))
-	uart.Bus.INTFLAG.SetBits(sam.SERCOM_USART_INT_INTFLAG_RXC)
-}
-
-func setupRTL8720DN() (*rtl8720dn.RTL8720DN, error) {
-	machine.RTL8720D_CHIP_PU.Configure(machine.PinConfig{Mode: machine.PinOutput})
-	machine.RTL8720D_CHIP_PU.Low()
-	time.Sleep(100 * time.Millisecond)
-	machine.RTL8720D_CHIP_PU.High()
-	time.Sleep(1000 * time.Millisecond)
-	waitSerial()
-
-	uart = UARTx{
-		UART: &machine.UART{
-			Buffer: machine.NewRingBuffer(),
-			Bus:    sam.SERCOM0_USART_INT,
-			SERCOM: 0,
-		},
-	}
-
-	uart.Interrupt = interrupt.New(sam.IRQ_SERCOM0_2, handleInterrupt)
-	uart.Configure(machine.UARTConfig{TX: machine.PB24, RX: machine.PC24, BaudRate: 614400})
-
-	rtl := rtl8720dn.New(uart)
-	rtl.Debug(debug)
-
-	_, err := rtl.Rpc_tcpip_adapter_init()
-	if err != nil {
-		return nil, err
-	}
-
-	return rtl, nil
-}
-
-// Wait for user to open serial console
-func waitSerial() {
-	for !machine.Serial.DTR() {
-		time.Sleep(100 * time.Millisecond)
-	}
-}
-
-type UARTx struct {
-	*machine.UART
-}
-
-func (u UARTx) Read(p []byte) (n int, err error) {
-	if u.Buffered() == 0 {
-		time.Sleep(1 * time.Millisecond)
-		return 0, nil
-	}
-	return u.UART.Read(p)
-}
@@ -4,28 +4,30 @@
 // You can open a server to accept connections from this program using:
 //
 // nc -w 5 -lk 8080
-//
 package main

 import (
+	"machine"
+
 	"bytes"
 	"fmt"
 	"time"

 	"tinygo.org/x/drivers/net"
+	"tinygo.org/x/drivers/rtl8720dn"
 )

 // You can override the setting with the init() in another source code.
 // func init() {
-//    ssid = "sghome-gw"
-//    password = "3af25537b4524"
+//    ssid = "your-ssid"
+//    pass = "your-password"
 //    serverIP = "192.168.1.119"
 //    debug = true
 // }

 var (
 	ssid     string
-	password string
+	pass     string
 	serverIP = ""
 	debug    = false
 )
@@ -41,18 +43,16 @@ func main() {
 }

 func run() error {
-	rtl, err := setupRTL8720DN()
-	if err != nil {
-		return err
-	}
-	net.UseDriver(rtl)
+	adaptor := rtl8720dn.New(machine.UART3, machine.PB24, machine.PC24, machine.RTL8720D_CHIP_PU)
+	adaptor.Debug(debug)
+	adaptor.Configure()

-	err = rtl.ConnectToAccessPoint(ssid, password, 10*time.Second)
+	err := adaptor.ConnectToAccessPoint(ssid, pass, 10*time.Second)
 	if err != nil {
 		return err
 	}

-	ip, subnet, gateway, err := rtl.GetIP()
+	ip, subnet, gateway, err := adaptor.GetIP()
 	if err != nil {
 		return err
 	}
@@ -1,72 +0,0 @@
-//go:build wioterminal
-// +build wioterminal
-
-package main
-
-import (
-	"device/sam"
-	"machine"
-	"runtime/interrupt"
-	"time"
-
-	"tinygo.org/x/drivers/rtl8720dn"
-)
-
-var (
-	uart UARTx
-)
-
-func handleInterrupt(interrupt.Interrupt) {
-	// should reset IRQ
-	uart.Receive(byte((uart.Bus.DATA.Get() & 0xFF)))
-	uart.Bus.INTFLAG.SetBits(sam.SERCOM_USART_INT_INTFLAG_RXC)
-}
-
-func setupRTL8720DN() (*rtl8720dn.RTL8720DN, error) {
-	machine.RTL8720D_CHIP_PU.Configure(machine.PinConfig{Mode: machine.PinOutput})
-	machine.RTL8720D_CHIP_PU.Low()
-	time.Sleep(100 * time.Millisecond)
-	machine.RTL8720D_CHIP_PU.High()
-	time.Sleep(1000 * time.Millisecond)
-	waitSerial()
-
-	uart = UARTx{
-		UART: &machine.UART{
-			Buffer: machine.NewRingBuffer(),
-			Bus:    sam.SERCOM0_USART_INT,
-			SERCOM: 0,
-		},
-	}
-
-	uart.Interrupt = interrupt.New(sam.IRQ_SERCOM0_2, handleInterrupt)
-	uart.Configure(machine.UARTConfig{TX: machine.PB24, RX: machine.PC24, BaudRate: 614400})
-
-	rtl := rtl8720dn.New(uart)
-	rtl.Debug(debug)
-
-	_, err := rtl.Rpc_tcpip_adapter_init()
-	if err != nil {
-		return nil, err
-	}
-
-	return rtl, nil
-}
-
-// Wait for user to open serial console
-func waitSerial() {
-	for !machine.Serial.DTR() {
-		time.Sleep(100 * time.Millisecond)
-	}
-}
-
-type UARTx struct {
-	*machine.UART
-}
-
-func (u UARTx) Read(p []byte) (n int, err error) {
-	if u.Buffered() == 0 {
-		time.Sleep(1 * time.Millisecond)
-		return 0, nil
-	}
-	return u.UART.Read(p)
-}
@@ -1,6 +1,8 @@
 package main

 import (
+	"machine"
+
 	"bufio"
 	"fmt"
 	"strings"
@@ -14,17 +16,17 @@ import (
 // You can override the setting with the init() in another source code.
 // func init() {
 //    ssid = "your-ssid"
-//    password = "your-password"
+//    pass = "your-password"
 //    debug = true
 //    url = "https://www.example.com"
 //    test_root_ca = "..."
 // }

 var (
-	ssid     string
-	password string
-	url      string = "https://www.example.com"
-	debug           = false
+	ssid  string
+	pass  string
+	url   string = "https://www.example.com"
+	debug        = false
 )

 // Set the test_root_ca created by the following command
@@ -57,7 +59,6 @@ var buf [0x1000]byte

 var lastRequestTime time.Time
 var conn net.Conn
-var adaptor *rtl8720dn.RTL8720DN

 func main() {
 	err := run()
@@ -68,20 +69,19 @@ func main() {
 }

 func run() error {
-	rtl, err := setupRTL8720DN()
-	if err != nil {
-		return err
-	}
-	rtl.SetRootCA(&test_root_ca)
-	net.UseDriver(rtl)
+	adaptor := rtl8720dn.New(machine.UART3, machine.PB24, machine.PC24, machine.RTL8720D_CHIP_PU)
+	adaptor.Debug(debug)
+	adaptor.Configure()
+
+	adaptor.SetRootCA(&test_root_ca)
 	http.SetBuf(buf[:])

-	err = rtl.ConnectToAccessPoint(ssid, password, 10*time.Second)
+	err := adaptor.ConnectToAccessPoint(ssid, pass, 10*time.Second)
 	if err != nil {
 		return err
 	}

-	ip, subnet, gateway, err := rtl.GetIP()
+	ip, subnet, gateway, err := adaptor.GetIP()
 	if err != nil {
 		return err
 	}
@@ -1,72 +0,0 @@
-//go:build wioterminal
-// +build wioterminal
-
-package main
-
-import (
-	"device/sam"
-	"machine"
-	"runtime/interrupt"
-	"time"
-
-	"tinygo.org/x/drivers/rtl8720dn"
-)
-
-var (
-	uart UARTx
-)
-
-func handleInterrupt(interrupt.Interrupt) {
-	// should reset IRQ
-	uart.Receive(byte((uart.Bus.DATA.Get() & 0xFF)))
-	uart.Bus.INTFLAG.SetBits(sam.SERCOM_USART_INT_INTFLAG_RXC)
-}
-
-func setupRTL8720DN() (*rtl8720dn.RTL8720DN, error) {
-	machine.RTL8720D_CHIP_PU.Configure(machine.PinConfig{Mode: machine.PinOutput})
-	machine.RTL8720D_CHIP_PU.Low()
-	time.Sleep(100 * time.Millisecond)
-	machine.RTL8720D_CHIP_PU.High()
-	time.Sleep(1000 * time.Millisecond)
-	waitSerial()
-
-	uart = UARTx{
-		UART: &machine.UART{
-			Buffer: machine.NewRingBuffer(),
-			Bus:    sam.SERCOM0_USART_INT,
-			SERCOM: 0,
-		},
-	}
-
-	uart.Interrupt = interrupt.New(sam.IRQ_SERCOM0_2, handleInterrupt)
-	uart.Configure(machine.UARTConfig{TX: machine.PB24, RX: machine.PC24, BaudRate: 614400})
-
-	rtl := rtl8720dn.New(uart)
-	rtl.Debug(debug)
-
-	_, err := rtl.Rpc_tcpip_adapter_init()
-	if err != nil {
-		return nil, err
-	}
-
-	return rtl, nil
-}
-
-// Wait for user to open serial console
-func waitSerial() {
-	for !machine.Serial.DTR() {
-		time.Sleep(100 * time.Millisecond)
-	}
-}
-
-type UARTx struct {
-	*machine.UART
-}
-
-func (u UARTx) Read(p []byte) (n int, err error) {
-	if u.Buffered() == 0 {
-		time.Sleep(1 * time.Millisecond)
-		return 0, nil
-	}
-	return u.UART.Read(p)
-}
@@ -1,28 +1,31 @@
 package main

 import (
+	"machine"
+
 	"fmt"
 	"strconv"
 	"time"

 	"tinygo.org/x/drivers/net"
 	"tinygo.org/x/drivers/net/http"
+	"tinygo.org/x/drivers/rtl8720dn"
 )

 // IP address of the server aka "hub". Replace with your own info.
 // You can override the setting with the init() in another source code.
 // func init() {
 //    ssid = "your-ssid"
-//    password = "your-password"
+//    pass = "your-password"
 //    hubIP = "192.168.1.118"
 //    debug = true
 // }

 var (
-	ssid     string
-	password string
-	hubIP    = ""
-	debug    = false
+	ssid  string
+	pass  string
+	hubIP = ""
+	debug = false
 )

 var buf [0x400]byte
@@ -36,19 +39,18 @@ func main() {
 }

 func run() error {
-	rtl, err := setupRTL8720DN()
-	if err != nil {
-		return err
-	}
-	net.UseDriver(rtl)
+	adaptor := rtl8720dn.New(machine.UART3, machine.PB24, machine.PC24, machine.RTL8720D_CHIP_PU)
+	adaptor.Debug(debug)
+	adaptor.Configure()
+
 	http.SetBuf(buf[:])

-	err = rtl.ConnectToAccessPoint(ssid, password, 10*time.Second)
+	err := adaptor.ConnectToAccessPoint(ssid, pass, 10*time.Second)
 	if err != nil {
 		return err
 	}

-	ip, subnet, gateway, err := rtl.GetIP()
+	ip, subnet, gateway, err := adaptor.GetIP()
 	if err != nil {
 		return err
 	}
@@ -1,72 +0,0 @@
-//go:build wioterminal
-// +build wioterminal
-
-package main
-
-import (
-	"device/sam"
-	"machine"
-	"runtime/interrupt"
-	"time"
-
-	"tinygo.org/x/drivers/rtl8720dn"
-)
-
-var (
-	uart UARTx
-)
-
-func handleInterrupt(interrupt.Interrupt) {
-	// should reset IRQ
-	uart.Receive(byte((uart.Bus.DATA.Get() & 0xFF)))
-	uart.Bus.INTFLAG.SetBits(sam.SERCOM_USART_INT_INTFLAG_RXC)
-}
-
-func setupRTL8720DN() (*rtl8720dn.RTL8720DN, error) {
-	machine.RTL8720D_CHIP_PU.Configure(machine.PinConfig{Mode: machine.PinOutput})
-	machine.RTL8720D_CHIP_PU.Low()
-	time.Sleep(100 * time.Millisecond)
-	machine.RTL8720D_CHIP_PU.High()
-	time.Sleep(1000 * time.Millisecond)
-	waitSerial()
-
-	uart = UARTx{
-		UART: &machine.UART{
-			Buffer: machine.NewRingBuffer(),
-			Bus:    sam.SERCOM0_USART_INT,
-			SERCOM: 0,
-		},
-	}
-
-	uart.Interrupt = interrupt.New(sam.IRQ_SERCOM0_2, handleInterrupt)
-	uart.Configure(machine.UARTConfig{TX: machine.PB24, RX: machine.PC24, BaudRate: 614400})
-
-	rtl := rtl8720dn.New(uart)
-	rtl.Debug(debug)
-
-	_, err := rtl.Rpc_tcpip_adapter_init()
-	if err != nil {
-		return nil, err
-	}
-
-	return rtl, nil
-}
-
-// Wait for user to open serial console
-func waitSerial() {
-	for !machine.Serial.DTR() {
-		time.Sleep(100 * time.Millisecond)
-	}
-}
-
-type UARTx struct {
-	*machine.UART
-}
-
-func (u UARTx) Read(p []byte) (n int, err error) {
-	if u.Buffered() == 0 {
-		time.Sleep(1 * time.Millisecond)
-		return 0, nil
-	}
-	return u.UART.Read(p)
-}
@@ -1,10 +1,12 @@
 package main

 import (
+	"machine"
+
 	"fmt"
 	"time"

-	"tinygo.org/x/drivers/examples/rtl8720dn"
+	"tinygo.org/x/drivers/rtl8720dn"
 )

 var (
@@ -20,13 +22,11 @@ func main() {
 }

 func run() error {
-	//rtl8720dn.Debug(true)
-	rtl, err := rtl8720dn.Setup()
-	if err != nil {
-		return err
-	}
+	adaptor := rtl8720dn.New(machine.UART3, machine.PB24, machine.PC24, machine.RTL8720D_CHIP_PU)
+	adaptor.Debug(debug)
+	adaptor.Configure()

-	ver, err := rtl.Version()
+	ver, err := adaptor.Version()
 	if err != nil {
 		return nil
 	}
@@ -1,14 +1,18 @@
 package main

 import (
+	"machine"
+
 	"bufio"
 	"fmt"
 	"image/color"
 	"strings"
 	"time"

-	"tinygo.org/x/drivers/net"
+	"tinygo.org/x/drivers/ili9341"
 	"tinygo.org/x/drivers/net/http"
+	"tinygo.org/x/drivers/rtl8720dn"
+
 	"tinygo.org/x/tinyfont/proggy"
 	"tinygo.org/x/tinyterm"
 )
@@ -17,19 +21,28 @@ import (
 // If debug is enabled, a serial connection is required.
 // func init() {
 //    ssid = "your-ssid"
-//    password = "your-password"
+//    pass = "your-password"
 //    debug = false // true
 //    server = "tinygo.org"
 // }

 var (
-	ssid     string
-	password string
-	url      = "http://tinygo.org/"
-	debug    = false
+	ssid  string
+	pass  string
+	url   = "http://tinygo.org/"
+	debug = false
 )

 var (
+	display = ili9341.NewSPI(
+		machine.SPI3,
+		machine.LCD_DC,
+		machine.LCD_SS_PIN,
+		machine.LCD_RESET,
+	)
+
+	backlight = machine.LCD_BACKLIGHT
+
 	terminal = tinyterm.NewTerminal(display)

 	black = color.RGBA{0, 0, 0, 255}
@@ -66,21 +79,22 @@ func run() error {
 		fmt.Fprintf(terminal, "Running in debug mode.\r\n")
 		fmt.Fprintf(terminal, "A serial connection is required to continue execution.\r\n")
 	}
-	rtl, err := setupRTL8720DN()
-	if err != nil {
-		return err
-	}
-	net.UseDriver(rtl)
+
+	adaptor := rtl8720dn.New(machine.UART3, machine.PB24, machine.PC24, machine.RTL8720D_CHIP_PU)
+	adaptor.Debug(debug)
+	adaptor.Configure()
+
+	http.UseDriver(adaptor)
 	http.SetBuf(buf[:])

 	fmt.Fprintf(terminal, "ConnectToAP()\r\n")
-	err = rtl.ConnectToAccessPoint(ssid, password, 10*time.Second)
+	err := adaptor.ConnectToAccessPoint(ssid, pass, 10*time.Second)
 	if err != nil {
 		return err
 	}
 	fmt.Fprintf(terminal, "connected\r\n\r\n")

-	ip, subnet, gateway, err := rtl.GetIP()
+	ip, subnet, gateway, err := adaptor.GetIP()
 	if err != nil {
 		return err
 	}
@@ -134,3 +148,15 @@ func run() error {
 		time.Sleep(10 * time.Second)
 	}
 }
+
+func init() {
+	machine.SPI3.Configure(machine.SPIConfig{
+		SCK:       machine.LCD_SCK_PIN,
+		SDO:       machine.LCD_SDO_PIN,
+		SDI:       machine.LCD_SDI_PIN,
+		Frequency: 40000000,
+	})
+	display.Configure(ili9341.Config{})
+
+	backlight.Configure(machine.PinConfig{machine.PinOutput})
+}
@@ -1,98 +0,0 @@
-//go:build wioterminal
-// +build wioterminal
-
-package main
-
-import (
-	"device/sam"
-	"machine"
-	"runtime/interrupt"
-	"time"
-
-	"tinygo.org/x/drivers/ili9341"
-	"tinygo.org/x/drivers/rtl8720dn"
-)
-
-var (
-	uart UARTx
-)
-
-var (
-	display = ili9341.NewSPI(
-		machine.SPI3,
-		machine.LCD_DC,
-		machine.LCD_SS_PIN,
-		machine.LCD_RESET,
-	)
-
-	backlight = machine.LCD_BACKLIGHT
-)
-
-func init() {
-	machine.SPI3.Configure(machine.SPIConfig{
-		SCK:       machine.LCD_SCK_PIN,
-		SDO:       machine.LCD_SDO_PIN,
-		SDI:       machine.LCD_SDI_PIN,
-		Frequency: 40000000,
-	})
-	display.Configure(ili9341.Config{})
-
-	backlight.Configure(machine.PinConfig{machine.PinOutput})
-}
-
-func handleInterrupt(interrupt.Interrupt) {
-	// should reset IRQ
-	uart.Receive(byte((uart.Bus.DATA.Get() & 0xFF)))
-	uart.Bus.INTFLAG.SetBits(sam.SERCOM_USART_INT_INTFLAG_RXC)
-}
-
-func setupRTL8720DN() (*rtl8720dn.RTL8720DN, error) {
-	machine.RTL8720D_CHIP_PU.Configure(machine.PinConfig{Mode: machine.PinOutput})
-	machine.RTL8720D_CHIP_PU.Low()
-	time.Sleep(100 * time.Millisecond)
-	machine.RTL8720D_CHIP_PU.High()
-	time.Sleep(1000 * time.Millisecond)
-	if debug {
-		waitSerial()
-	}
-
-	uart = UARTx{
-		UART: &machine.UART{
-			Buffer: machine.NewRingBuffer(),
-			Bus:    sam.SERCOM0_USART_INT,
-			SERCOM: 0,
-		},
-	}
-
-	uart.Interrupt = interrupt.New(sam.IRQ_SERCOM0_2, handleInterrupt)
-	uart.Configure(machine.UARTConfig{TX: machine.PB24, RX: machine.PC24, BaudRate: 614400})
-
-	rtl := rtl8720dn.New(uart)
-	rtl.Debug(debug)
-
-	_, err := rtl.Rpc_tcpip_adapter_init()
-	if err != nil {
-		return nil, err
-	}
-
-	return rtl, nil
-}
-
-// Wait for user to open serial console
-func waitSerial() {
-	for !machine.Serial.DTR() {
-		time.Sleep(100 * time.Millisecond)
-	}
-}
-
-type UARTx struct {
-	*machine.UART
-}
-
-func (u UARTx) Read(p []byte) (n int, err error) {
-	if u.Buffered() == 0 {
-		time.Sleep(1 * time.Millisecond)
-		return 0, nil
-	}
-	return u.UART.Read(p)
-}
@@ -1,28 +1,30 @@
 package main

 import (
+	"machine"
+
 	"bufio"
 	"fmt"
 	"strings"
 	"time"

-	"tinygo.org/x/drivers/net"
 	"tinygo.org/x/drivers/net/http"
+	"tinygo.org/x/drivers/rtl8720dn"
 )

 // You can override the setting with the init() in another source code.
 // func init() {
 //    ssid = "your-ssid"
-//    password = "your-password"
+//    pass = "your-password"
 //    url = "http://tinygo.org/"
 //    debug = true
 // }

 var (
-	ssid     string
-	password string
-	url      = "http://tinygo.org/"
-	debug    = false
+	ssid  string
+	pass  string
+	url   = "http://tinygo.org/"
+	debug = false
 )

 var buf [0x400]byte
@@ -36,19 +38,19 @@ func main() {
 }

 func run() error {
-	rtl, err := setupRTL8720DN()
-	if err != nil {
-		return err
-	}
-	net.UseDriver(rtl)
+	adaptor := rtl8720dn.New(machine.UART3, machine.PB24, machine.PC24, machine.RTL8720D_CHIP_PU)
+	adaptor.Debug(debug)
+	adaptor.Configure()
+
+	http.UseDriver(adaptor)
 	http.SetBuf(buf[:])

-	err = rtl.ConnectToAccessPoint(ssid, password, 10*time.Second)
+	err := adaptor.ConnectToAccessPoint(ssid, pass, 10*time.Second)
 	if err != nil {
 		return err
 	}

-	ip, subnet, gateway, err := rtl.GetIP()
+	ip, subnet, gateway, err := adaptor.GetIP()
 	if err != nil {
 		return err
 	}
@@ -1,72 +0,0 @@
-//go:build wioterminal
-// +build wioterminal
-
-package main
-
-import (
-	"device/sam"
-	"machine"
-	"runtime/interrupt"
-	"time"
-
-	"tinygo.org/x/drivers/rtl8720dn"
-)
-
-var (
-	uart UARTx
-)
-
-func handleInterrupt(interrupt.Interrupt) {
-	// should reset IRQ
-	uart.Receive(byte((uart.Bus.DATA.Get() & 0xFF)))
-	uart.Bus.INTFLAG.SetBits(sam.SERCOM_USART_INT_INTFLAG_RXC)
-}
-
-func setupRTL8720DN() (*rtl8720dn.RTL8720DN, error) {
-	machine.RTL8720D_CHIP_PU.Configure(machine.PinConfig{Mode: machine.PinOutput})
-	machine.RTL8720D_CHIP_PU.Low()
-	time.Sleep(100 * time.Millisecond)
-	machine.RTL8720D_CHIP_PU.High()
-	time.Sleep(1000 * time.Millisecond)
-	waitSerial()
-
-	uart = UARTx{
-		UART: &machine.UART{
-			Buffer: machine.NewRingBuffer(),
-			Bus:    sam.SERCOM0_USART_INT,
-			SERCOM: 0,
-		},
-	}
-
-	uart.Interrupt = interrupt.New(sam.IRQ_SERCOM0_2, handleInterrupt)
-	uart.Configure(machine.UARTConfig{TX: machine.PB24, RX: machine.PC24, BaudRate: 614400})
-
-	rtl := rtl8720dn.New(uart)
-	rtl.Debug(debug)
-
-	_, err := rtl.Rpc_tcpip_adapter_init()
-	if err != nil {
-		return nil, err
-	}
-
-	return rtl, nil
-}
-
-// Wait for user to open serial console
-func waitSerial() {
-	for !machine.Serial.DTR() {
-		time.Sleep(100 * time.Millisecond)
-	}
-}
-
-type UARTx struct {
-	*machine.UART
-}
-
-func (u UARTx) Read(p []byte) (n int, err error) {
-	if u.Buffered() == 0 {
-		time.Sleep(1 * time.Millisecond)
-		return 0, nil
-	}
-	return u.UART.Read(p)
-}
@@ -7,19 +7,20 @@ import (
 	"time"

 	"tinygo.org/x/drivers/net/http"
+	"tinygo.org/x/drivers/rtl8720dn"
 )

 // You can override the setting with the init() in another source code.
 // func init() {
 //    ssid = "your-ssid"
-//    password = "your-password"
+//    pass = "your-password"
 //    debug = true
 // }

 var (
-	ssid     string
-	password string
-	debug    = false
+	ssid  string
+	pass  string
+	debug = false
 )

 var led = machine.LED
@@ -37,18 +38,18 @@ func main() {
 }

 func run() error {
-	rtl, err := setupRTL8720DN()
-	if err != nil {
-		return err
-	}
-	http.UseDriver(rtl)
+	adaptor := rtl8720dn.New(machine.UART3, machine.PB24, machine.PC24, machine.RTL8720D_CHIP_PU)
+	adaptor.Debug(debug)
+	adaptor.Configure()

-	err = rtl.ConnectToAccessPoint(ssid, password, 10*time.Second)
+	http.UseDriver(adaptor)
+
+	err := adaptor.ConnectToAccessPoint(ssid, pass, 10*time.Second)
 	if err != nil {
 		return err
 	}

-	ip, subnet, gateway, err := rtl.GetIP()
+	ip, subnet, gateway, err := adaptor.GetIP()
 	if err != nil {
 		return err
 	}
@@ -1,74 +0,0 @@
-//go:build wioterminal
-// +build wioterminal
-
-package main
-
-import (
-	"device/sam"
-	"machine"
-	"runtime/interrupt"
-	"time"
-
-	"tinygo.org/x/drivers/rtl8720dn"
-)
-
-var (
-	uart UARTx
-)
-
-func handleInterrupt(interrupt.Interrupt) {
-	// should reset IRQ
-	uart.Receive(byte((uart.Bus.DATA.Get() & 0xFF)))
-	uart.Bus.INTFLAG.SetBits(sam.SERCOM_USART_INT_INTFLAG_RXC)
-}
-
-func setupRTL8720DN() (*rtl8720dn.RTL8720DN, error) {
-	machine.RTL8720D_CHIP_PU.Configure(machine.PinConfig{Mode: machine.PinOutput})
-	machine.RTL8720D_CHIP_PU.Low()
-	time.Sleep(100 * time.Millisecond)
-	machine.RTL8720D_CHIP_PU.High()
-	time.Sleep(1000 * time.Millisecond)
-	if debug {
-		waitSerial()
-	}
-
-	uart = UARTx{
-		UART: &machine.UART{
-			Buffer: machine.NewRingBuffer(),
-			Bus:    sam.SERCOM0_USART_INT,
-			SERCOM: 0,
-		},
-	}
-
-	uart.Interrupt = interrupt.New(sam.IRQ_SERCOM0_2, handleInterrupt)
-	uart.Configure(machine.UARTConfig{TX: machine.PB24, RX: machine.PC24, BaudRate: 614400})
-
-	rtl := rtl8720dn.New(uart)
-	rtl.Debug(debug)
-
-	_, err := rtl.Rpc_tcpip_adapter_init()
-	if err != nil {
-		return nil, err
-	}
-
-	return rtl, nil
-}
-
-// Wait for user to open serial console
-func waitSerial() {
-	for !machine.Serial.DTR() {
-		time.Sleep(100 * time.Millisecond)
-	}
-}
-
-type UARTx struct {
-	*machine.UART
-}
-
-func (u UARTx) Read(p []byte) (n int, err error) {
-	if u.Buffered() == 0 {
-		time.Sleep(1 * time.Millisecond)
-		return 0, nil
-	}
-	return u.UART.Read(p)
-}
@@ -1,79 +0,0 @@
-//go:build wioterminal
-// +build wioterminal
-
-package rtl8720dn
-
-import (
-	"device/sam"
-	"machine"
-	"runtime/interrupt"
-	"time"
-
-	"tinygo.org/x/drivers/rtl8720dn"
-)
-
-var (
-	uart  UARTx
-	debug bool
-)
-
-func handleInterrupt(interrupt.Interrupt) {
-	// should reset IRQ
-	uart.Receive(byte((uart.Bus.DATA.Get() & 0xFF)))
-	uart.Bus.INTFLAG.SetBits(sam.SERCOM_USART_INT_INTFLAG_RXC)
-}
-
-func Setup() (*rtl8720dn.RTL8720DN, error) {
-	machine.RTL8720D_CHIP_PU.Configure(machine.PinConfig{Mode: machine.PinOutput})
-	machine.RTL8720D_CHIP_PU.Low()
-	time.Sleep(100 * time.Millisecond)
-	machine.RTL8720D_CHIP_PU.High()
-	time.Sleep(1000 * time.Millisecond)
-	if debug {
-		waitSerial()
-	}
-
-	uart = UARTx{
-		UART: &machine.UART{
-			Buffer: machine.NewRingBuffer(),
-			Bus:    sam.SERCOM0_USART_INT,
-			SERCOM: 0,
-		},
-	}
-
-	uart.Interrupt = interrupt.New(sam.IRQ_SERCOM0_2, handleInterrupt)
-	uart.Configure(machine.UARTConfig{TX: machine.PB24, RX: machine.PC24, BaudRate: 614400})
-
-	rtl := rtl8720dn.New(uart)
-	rtl.Debug(debug)
-
-	_, err := rtl.Rpc_tcpip_adapter_init()
-	if err != nil {
-		return nil, err
-	}
-
-	return rtl, nil
-}
-
-// Wait for user to open serial console
-func waitSerial() {
-	for !machine.Serial.DTR() {
-		time.Sleep(100 * time.Millisecond)
-	}
-}
-
-type UARTx struct {
-	*machine.UART
-}
-
-func (u UARTx) Read(p []byte) (n int, err error) {
-	if u.Buffered() == 0 {
-		time.Sleep(1 * time.Millisecond)
-		return 0, nil
-	}
-	return u.UART.Read(p)
-}
-
-func Debug(b bool) {
-	debug = b
-}
@@ -1,5 +1,4 @@
 //go:build feather_m4 || feather_m4_can || feather_nrf52840
-// +build feather_m4 feather_m4_can feather_nrf52840

 package main

@@ -1,5 +1,4 @@
 //go:build grandcentral_m4
-// +build grandcentral_m4

 package main

@@ -1,5 +1,4 @@
 //go:build atsamd21 && !p1am_100
-// +build atsamd21,!p1am_100

 package main

@@ -1,5 +1,4 @@
 //go:build p1am_100
-// +build p1am_100

 package main

@@ -1,5 +1,4 @@
 //go:build pygamer
-// +build pygamer

 package main

@@ -1,5 +1,4 @@
 //go:build pyportal
-// +build pyportal

 package main

@@ -1,5 +1,4 @@
 //go:build thingplus_rp2040
-// +build thingplus_rp2040

 package main

@@ -1,5 +1,4 @@
 //go:build wioterminal
-// +build wioterminal

 package main

@@ -1,5 +1,4 @@
 //go:build tinygo
-// +build tinygo

 package console

@@ -1,5 +1,4 @@
 //go:build feather_m4 || feather_m4_can || feather_nrf52840
-// +build feather_m4 feather_m4_can feather_nrf52840

 package main

@@ -1,5 +1,4 @@
 //go:build grandcentral_m4
-// +build grandcentral_m4

 package main

@@ -1,5 +1,4 @@
 //go:build atsamd21 && !p1am_100
-// +build atsamd21,!p1am_100

 package main

@@ -1,5 +1,4 @@
 //go:build p1am_100
-// +build p1am_100

 package main

@@ -1,5 +1,4 @@
 //go:build pygamer
-// +build pygamer

 package main

@@ -1,5 +1,4 @@
 //go:build pyportal
-// +build pyportal

 package main

@@ -1,5 +1,4 @@
 //go:build thingplus_rp2040
-// +build thingplus_rp2040

 package main

@@ -1,5 +1,4 @@
 //go:build wioterminal
-// +build wioterminal

 package main

--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
deadprogram	68d4991da1	ateccx08: inttial implementation for ATECCx08 This working implementation for the ATECCx08 family of cryptgraphic processors has random number generation and other needed supporting functions. It also includes a sample of how to connect it to the Go crypto/rand package. More cryptographic functions await a future interation. Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-20 20:44:51 +01:00
deadprogram	f2637a87d2	gps: improve parsing and add tests to verify Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-17 07:48:22 +01:00
deadprogram	ecb343b3b3	gps: improve error handling Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-17 07:48:22 +01:00
deadprogram	0b62d4fb4a	gps: add support for GLL sentence type, add original sentence to gps errors Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-17 07:48:22 +01:00
deadprogram	5b461ec2d1	gps: improve error handling Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-17 07:48:22 +01:00
Vincent Janelle	b1c9612158	(#501 ) make IP.String() method return something sensible	2023-01-16 13:43:59 +01:00
deadprogram	0b6e1d0e78	lorawan: increment devnonce don't just create a new one each join attempt Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	49e7a6d6c8	sx126x: actually set the frequency when calling SetFrequency() Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	be644b36fe	lorawan: simplify GetRand16() function Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	409723e496	lorawan: set devNonce to new random value on each attempt to join Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	8aa3530c8b	lorawan: increase timeout values for tx/rx Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	390854ee45	examples: set pin mappings for sx126x external board Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	ce5dd65dad	sx126x: pre-define all errors to avoid heap allocations Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	73e9d5bfec	sx126x: move RadioController into separate file for clarity Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	462d2b3315	sx126x: correct RX/TX pin mapping for TheThingsIndustries GNSE board Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	9e70ecbe64	sx126x: there is no dio0 just dio1 Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	d6d06396b4	sx126x: refactor to RadioController interface to more easily handle non-STM32WL boards and remove duplicated code Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	80b2a4a569	lora/lorawan: set functions for keys Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	556aa9e6d3	examples: lorawan atcmd outputs needed info after Join to reuse, aka 'OTAA provisioning' Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
deadprogram	4bc8ecdbdd	lora/lorawan: completed functions needed for Join OTAA process Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-16 09:33:13 +01:00
sago35	999f42dc03	net/http: add PostForm()	2023-01-11 21:29:12 +01:00
Olivier Fauchon	a1b47cd778	lorawan: Add test in Makefile	2023-01-11 07:48:30 +01:00
Olivier Fauchon	889536f7f0	Lorawan uplink support and new lorawan 'basic-demo' example	2023-01-11 07:48:30 +01:00
deadprogram	301e6bc35b	examples: improvements to README for LoRaWAN atcmd example Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-10 22:45:01 +01:00
deadprogram	49b390f7bc	examples: lorawan atcmd able to join Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-10 22:45:01 +01:00
deadprogram	a62fc01d81	lora/lorawan: implement minimal Join() function, and supporting functions Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-10 22:45:01 +01:00
deadprogram	36dfdf568e	examples: move atcmd into lorawan Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-10 22:45:01 +01:00
deadprogram	7b5a3970ca	lorawan: add initial LoRaWAN stack support Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-10 22:45:01 +01:00
deadprogram	3433364586	examples: example with LoRa AT command set implementation Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-10 22:45:01 +01:00
deadprogram	338be928c9	sx126x, sx127x: remove extra Lora in functions to avoid stuttering Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-09 07:36:07 +01:00
deadprogram	98943393a5	sx127x: correct header type implicit/explcit as they were reversed Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-09 07:36:07 +01:00
deadprogram	6b817faed3	sx126x: add Reset() and needed pin Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-09 07:36:07 +01:00
deadprogram	9b14ee3ec5	sx127x: lora rx/tx example working, now assumes pybadge+featherwing Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-09 07:36:07 +01:00
deadprogram	6d51370512	lora: created shared RadioEvent Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-09 07:36:07 +01:00
deadprogram	2005d7d483	lora: move shared config for sx126x/sx127x to single package Signed-off-by: deadprogram <ron@hybridgroup.com>	2023-01-09 07:36:07 +01:00
Olivier Fauchon	f15eec822f	sx127x: Ajout du support d'interruptions RXTimeout (DIO1)	2023-01-09 07:36:07 +01:00
Olivier Fauchon	dc4f0c974a	sx127x: Major cleanup/rewrite, and tests pass with lorawan stack tests	2023-01-09 07:36:07 +01:00
Olivier Fauchon	28ddb2681d	sx127x: Driver for Semtech sx127x radio modules This first version of the driver has been tested with BB-FRM9x module	2023-01-09 07:36:07 +01:00
BCG	877342d0ff	add suport for SH1106 display driver	2022-12-23 09:30:37 +01:00
deadprogram	8b3075fdba	build: remove older format build tags Signed-off-by: deadprogram <ron@hybridgroup.com>	2022-12-21 17:47:14 -05:00
Kenneth Bell	7d58709b7d	bme280: improve config support	2022-12-20 11:13:43 +01:00
Jason Del Ponte	789bbbd89f	Update DHT22 receive to use runtime/interrupt Fixes #483 by updating the DHT22 device to use runtime/interrupt instead of machine.UART1 for interrupt disabling while receiving signals from the device.	2022-12-20 11:10:52 +01:00
Lucas Bremgartner	ea944c8933	buzzer: no tone during rest	2022-12-19 22:01:39 +01:00
Lucas Bremgartner	d27859453c	buzzer: make all note durations float64	2022-12-19 22:01:39 +01:00
Damian Gryski	0ccd979f23	examples: fix odd if sequence found by static analysis	2022-12-04 21:26:47 +01:00
John Clark	a888570c8c	fix broken link for lora sx1261	2022-11-23 22:13:43 +01:00
Michael Meister	5b2c2f800d	vl53l1x: Add getter for the effective SPAD count Implement function to get the effective SPAD count. Signed-off-by: Michael Meister <michael.meister@bytesatwork.ch>	2022-11-15 17:58:24 +01:00
Scott Feldman	0ec887c9d8	wifinina: add support for http server (#480 ) * wifinina: add support for http server This adds http.ListenAndServe() implementation for wifinina. Included is an example webserver, basically copied from the rtl8720dn/webserver. Tested on Arduino Nano RP2040 Connect. Also tried testing on Arduino Nano33 IoT but test panics with "out of memory". There's only 32K of SRAM on the Nano33, vs 264K on the rp2040 Connect.	2022-11-14 22:24:15 +01:00
Lucas Bremgartner	c5dbe18be1	lsm303agr: fix I2C address auto increment for multi data read fixes: #475	2022-10-31 10:02:44 +01:00
Andy Janata	2bca84b8d1	remove unused import	2022-10-29 23:39:52 +02:00
Lucas Bremgartner	690daebcd1	microbitmatrix: add smoke test for microbitmatrix with microbit-v2	2022-10-29 22:49:31 +02:00
Lucas Bremgartner	89770a7d05	microbitmatrix: add support for brightness of led pixels Inspired by brightness levels in micro:bit MicroPython	2022-10-29 22:49:31 +02:00
Lucas Bremgartner	8a39bb7aae	microbitmatrix: harmonize v1 and v2 implementation	2022-10-29 22:49:31 +02:00
Lucas Bremgartner	a106fd48ce	microbitmatrix: move Size() to verion agnostic part	2022-10-29 22:49:31 +02:00
Lucas Bremgartner	b2fdd3c333	microbitmatrix: add link to schema for microbit V2	2022-10-29 22:49:31 +02:00
Ayke van Laethem	42dc6eb068	mpu6050: return I2C error when configuring fails An I2C bus can generate errors (like any I/O can), but they weren't returned. This commit fixes this oversight. Found while trying to figure out why LLVM 15 is broken just for the itsybitsy-m4.	2022-10-18 20:32:33 +02:00
Rafael Badiale	c00cb3abdd	qmi8658c: Add support for the QMI8658C sensor (#467 ) * Add support for the QMI8658C sensor * qmi8656c: update ReadTemperature signature * Update README devices count	2022-10-02 14:14:37 +02:00
deadprogram	81bc1bcad1	all: prepare for release 0.23.0 Signed-off-by: deadprogram <ron@hybridgroup.com>	2022-10-01 23:07:23 +02:00
deadprogram	1bb1b621c6	all: correct go fmt Signed-off-by: deadprogram <ron@hybridgroup.com>	2022-09-25 13:23:16 +02:00
Lucas Bremgartner	98ba5a231a	microbitmatrix: fix inverted axis Resolves #460	2022-09-24 13:19:37 +02:00
sago35	5af2512901	espat,wifinina,rtl8720dn: change ssid/pass from const to var	2022-09-24 11:34:29 +02:00
Lucas Matte	4061adf6db	Add GC9A01 Driver (#452 ) * Added driver for gc9a01 round display and example code	2022-09-18 15:22:07 +02:00
Alexandre Jomin	7133c2e9db	feat(ssd1306): add getter method to the current buffer	2022-09-16 18:51:10 +02:00
deadprogram	0ea72e7f1e	makeybutton: revise to better match the algorithm defined by the original Signed-off-by: deadprogram <ron@hybridgroup.com>	2022-09-16 18:34:36 +02:00
sago35	7396a5be43	examples/rtl8720dn: remove wifi setting	2022-09-06 13:51:46 +02:00
deadprogram	c409e8f3cf	examples/rtl8720dn: add call to optional debug setting Signed-off-by: deadprogram <ron@hybridgroup.com>	2022-09-06 13:29:15 +02:00
deadprogram	a6a8d478b9	examples/rtl8720dn: update all remaining examples for refactored API Signed-off-by: deadprogram <ron@hybridgroup.com>	2022-09-06 13:29:15 +02:00
deadprogram	54ddb895cc	rtl8720dn: refactor by bringing this driver more in line with wifinina and espat Signed-off-by: deadprogram <ron@hybridgroup.com>	2022-09-06 13:29:15 +02:00
Daniel Esteban	6f05615f3e	Initial support for VL6180x sensor required changes	2022-09-05 16:04:30 +02:00
Arsen6331	2a2e897261	Trim quotes from IP returned by espat's GetDNS()	2022-08-19 18:55:09 +02:00