How camm2325/microlink works
MicroLink is an asynchronous Tailscale client for ESP32, with WiFi and cellular connectivity. An application initializes and starts the client; coordination registers it with the control plane and obtains peer information, while the WireGuard manager provisions peers and handles DISCO path discovery. Network I/O, DERP relaying, and WireGuard transport provide connectivity to tailnet peers. Separate capabilities include cellular failover, runtime HTTP configuration, cached peers, STUN discovery, and TCP/UDP APIs. The README documents task responsibilities; some implementation links are omitted where sampled source does not establish them.
Main entry points: microlink.c Client runtime · ml_coord.c Control coordination · microlink.h Client API · ml_wg_mgr.c Peer and DISCO manager
Components 25
Client and Coordination
- Client API
components/microlink/include/microlink.h - Client runtime
components/microlink/src/microlink.c - Control coordination
components/microlink/src/ml_coord.c - HTTP/2 transport
components/microlink/src/ml_h2.c - TCP socket API
components/microlink/src/ml_tcp.c - UDP socket API
components/microlink/src/ml_udp.c
Network Connectivity
- DERP relay client
components/microlink/src/ml_derp.c - STUN discovery
components/microlink/src/ml_stun.c - Network I/O
components/microlink/src/ml_net_io.c - Network failover
components/microlink/src/ml_net_switch.c - Cellular PPP
components/microlink/src/ml_cellular.c - AT socket bridge
components/microlink/src/ml_at_socket.c
WireGuard Tunnel
- Peer and DISCO manager
components/microlink/src/ml_wg_mgr.c - WireGuard lwIP interface
components/microlink/components/wireguard_lwip/src/wireguardif.c - WireGuard protocol
components/microlink/components/wireguard_lwip/src/wireguard.c - WireGuard cryptography
components/microlink/components/wireguard_lwip/src/crypto.c
Configuration and State
- HTTP config server
components/microlink/src/ml_config_httpd.c - Config web UI
components/microlink/src/ml_config_html.h - NVS peer cache
components/microlink/src/ml_peer_nvs.c
Other components
- ESP32 application
- Tailscale control plane
- DERP relay service
- WiFi and cellular
- Tailnet peers
- NVS settings
Connections 23
- ESP32 application → Client API: uses
components/microlink/include/microlink.h - Client API → Client runtime: starts client
- Client runtime → Control coordination: runs task
- Control coordination → Tailscale control plane: registers and polls
components/microlink/src/ml_coord.c - Control coordination → HTTP/2 transport: uses HTTP/2
- Control coordination → Peer and DISCO manager: sends peer updates
components/microlink/src/ml_wg_mgr.c - Client runtime → DERP relay client: runs task
- DERP relay client → DERP relay service: relays traffic
- Client runtime → Network I/O: runs task
- Client runtime → Peer and DISCO manager: runs task
- Network failover → WiFi and cellular: selects network
- Network failover → Cellular PPP: fails over
components/microlink/src/ml_net_switch.c - Network failover → AT socket bridge: uses fallback
components/microlink/src/ml_net_switch.c - Peer and DISCO manager → WireGuard lwIP interface: provisions peers
components/microlink/src/ml_wg_mgr.c - WireGuard lwIP interface → WireGuard protocol: uses protocol
components/microlink/components/wireguard_lwip/src/wireguardif.c - WireGuard protocol → WireGuard cryptography: uses cryptography
components/microlink/components/wireguard_lwip/src/wireguard.c - Peer and DISCO manager → Tailnet peers: discovers paths
- STUN discovery → Tailscale control plane: discovers endpoints
- Client API → TCP socket API: offers TCP
components/microlink/include/microlink.h - Client API → UDP socket API: offers UDP
components/microlink/include/microlink.h - HTTP config server → Config web UI: serves UI
- HTTP config server → NVS settings: persists settings
- Control coordination → NVS peer cache: loads cached peers