TamaGo - bare metal Go
tamago | https://github.com/usbarmory/tamago
Copyright (c) The TamaGo Authors. All Rights Reserved.
TamaGo is a framework that enables compilation and execution of unencumbered Go applications on bare metal processors.
The projects spawns from the desire of reducing the attack surface of embedded systems firmware by removing any runtime dependency on C code and Operating Systems.
The TamaGo framework consists of the following components:
A modified Go distribution
which extends GOOS support to the tamago target, allowing bare metal
execution through a runtime/goos
overlay set by GOOSPKG.
Go packages for processor/SoC support.
Go packages for board support.
The modifications are minimal against the original Go compiler, runtime and the target application (one import required), with a clean separation from other architectures.
Strong emphasis is placed on code re-use from existing architectures already included within the standard Go runtime, see Internals.
The modifications maintain complete standard library support.
Such aspects are motivated by the desire of providing a framework that allows secure Go firmware development on embedded systems.
GOOS=tamago support to the corresponding Go version, and
TamaGo library:
The main documentation can be found on the project wiki.
The package API documentation can be found on pkg.go.dev.
The following table summarizes currently supported x86-64 targets
(GOOS=tamago GOARCH=amd64).
| CPU | Platform | CPU package | Platform package |
|---|---|---|---|
| AMD/Intel 64-bit | Cloud Hypervisor | amd64 | cloud_hypervisor/vm |
| AMD/Intel 64-bit | Firecracker microvm | amd64 | firecracker/microvm |
| AMD/Intel 64-bit | QEMU microvm | amd64 | qemu/microvm |
| AMD/Intel 64-bit | UEFI | amd64 | uefi/x64 |
| AMD/Intel 64-bit | Google Compute Engine | amd64 | google/gcp, uefi/x64 |
The following table summarizes currently supported ARM SoCs and boards
(GOOS=tamago GOARCH=arm).
| SoC | Board | SoC package | Board package |
|---|---|---|---|
| NXP i.MX6ULZ/i.MX6UL | USB armory Mk II | imx6ul | usbarmory/mk2 |
| NXP i.MX6ULL/i.MX6UL | USB armory Mk II LAN | imx6ul | usbarmory/mk2 |
| NXP i.MX6ULL/i.MX6ULZ | MCIMX6ULL-EVK | imx6ul | mx6ullevk |
| Broadcom BCM2835 | Raspberry Pi Zero | bcm2835 | pi/pizero |
| Broadcom BCM2835 | Raspberry Pi 1 Model A+ | bcm2835 | pi/pi1 |
| Broadcom BCM2835 | Raspberry Pi 1 Model B+ | bcm2835 | pi/pi1 |
| Broadcom BCM2836 | Raspberry Pi 2 Model B | bcm2835 | pi/pi2 |
| Nuvoton NUC980 | NuMaker-IIoT-NUC980G2 | nuc980 | nuc980iiot |
The following table summarizes currently supported ARM64 SoCs and boards
(GOOS=tamago GOARCH=arm64).
| SoC | Board | SoC package | Board package |
|---|---|---|---|
| NXP i.MX8M Plus | 8MPLUSLPD4-EVK | imx8mp | imx8mpevk |
| Microchip LAN969x | EVB-LAN9696-24port | lan969x | lan9696evb |
The following table summarizes currently supported RISC-V SoCs and boards
(GOOS=tamago GOARCH=riscv64).
| SoC | Board | SoC package | Board package |
|---|---|---|---|
| AI Foundry Erbium | erbium_emu | erbium | erbium_emu |
| AI Foundry ET-SoC-1 | sys_emu | etsoc1 | sys_emu |
| Fisilink FSL91030 | MilkV Vega | fsl91030 | vega |
| Fisilink FSL91030 | Nuclei QEMU | fsl91030 | eval_soc |
| SiFive FU540 | QEMU sifive_u | fu540 | qemu/sifive_u |
The following table summarizes currently supported LoongArch SoCs and boards
(GOOS=tamago GOARCH=loong64).
| SoC | Board
No open issues yet, or sync has not completed.