tinygodriver

tinygodriver

Host-side network drivers for TinyGo.

TinyGo’s net / net/http packages do not talk to the OS directly. They call a Netdever registered with UseNetdev. On microcontrollers that is usually Wi-Fi firmware. On a desktop host there is no default driver, which produces:

Netdev not set

This repository provides desktop Netdever implementations so the same TinyGo networking code can run on Linux, macOS, and Windows.

Packages

Quick start

Blank-import the driver before any net / net/http use. Under TinyGo, init registers the host driver automatically:

package main

import (
	"fmt"
	"net/http"
	"os"

	_ "github.com/shibukawa/tinygodriver/netdev"
)

func main() {
	mux := http.NewServeMux()
	mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintf(w, "hello method=%s path=%q\n", r.Method, r.URL.Path)
	})
	addr := os.Getenv("ADDR")
	if addr == "" {
		addr = ":8080"
	}
	fmt.Println("listening on", addr)
	http.ListenAndServe(addr, mux)
}

Build with TinyGo

tinygo build -o server ./examples/httpserver
./server
# curl http://127.0.0.1:8080/

Standard go build / go run also work: the driver is a no-op registrar because stock Go’s net package does not use netdev.

go run ./examples/httpserver

Explicit registration

import "github.com/shibukawa/tinygodriver/netdev"

func main() {
	netdev.Use(netdev.New())
	// ...
}

Examples

Platform notes

See netdev/README.md for TLS (OpenSSL), DNS, and platform limitations.

• IPv4 only (matches TinyGo’s net port).
• TLS (IPPROTO_TLS): OpenSSL 3 on macOS (and standard Go on Linux). TinyGo on Linux and Windows currently return ErrProtocolNotSupported for TLS.
• OpenSSL 3 is required for TLS builds (openssl@3 via Homebrew on macOS, libssl-dev on Debian/Ubuntu).

Install

go get github.com/shibukawa/tinygodriver/netdev@latest

Requires TinyGo for TinyGo builds. Compatible with the Netdever interface in tinygo-org/drivers/netdev.

License

Apache License 2.0