You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Andrea Barisani 4acb83c52f optimize imx USB driver to improve overall throughput 17 hours ago
_dev improve coverage 4 months ago
arm make indentation consistent with coding style 1 month ago
bits tidying 1 month ago
board initialize I2C bus when enabling debug accessory 2 weeks ago
dma clarify alignment requirements 3 weeks ago
example move example application to 9 months ago
internal/reg Fix incorrect data type 2 weeks ago
soc optimize imx USB driver to improve overall throughput 17 hours ago
LICENSE improve coverage 4 months ago tidying 2 weeks ago
go.mod bump module language version 1 month ago
go.sum move example application to 9 months ago

TamaGo - bare metal Go for ARM SoCs

tamago |

Copyright (c) F-Secure Corporation

TamaGo gopher


Andrea Barisani |

Andrej Rosano |


TamaGo is a framework that enables compilation and execution of unencumbered Go applications on bare metal ARM System-on-Chip (SoC) components.

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.

  • Go packages for SoC driver support.

  • Go packages for board support.

The modifications are meant to be minimal for both the Go distribution (< ~4000 LOC changed) 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.

Both aspects are motivated by the desire of providing a framework that allows secure Go firmware development on embedded systems.

Current release level

The current release for the TamaGo modified Go distribution is tamago1.15.3, which adds GOOS=tamago support to go1.15.3.

Binary releases for amd64 and armv7l Linux hosts are available.


The main documentation can be found on the project wiki.

The package API documentation can be found on

Supported hardware

The following table summarizes currently supported SoCs and boards.

SoC Board SoC package Board package
NXP i.MX6ULL USB armory Mk II imx6 usbarmory/mark-two
NXP i.MX6ULL MCIMX6ULL-EVK imx6 mx6ullevk
BCM2835 Raspberry Pi Zero bcm2835 pi/pizero
BCM2836 Raspberry Pi 2 bcm2835 pi/pi2


Go applications are simply required to import, the relevant board package to ensure that hardware initialization and runtime support takes place:

import (
	// Example for USB armory Mk II
	_ ""

Build the TamaGo compiler (or use the latest binary release):

git clone -b latest
cd tamago-go/src && ./all.bash
cd ../bin && export TAMAGO=`pwd`/go

Go applications can be compiled with the compiler built in the previous step, with the addition of a few flags/variables:

# Example for USB armory Mk II
  ${TAMAGO} build -ldflags "-T 0x80010000  -E _rt0_arm_tamago -R 0x1000"

See the respective board package README file for compilation information for each specific target.

Executing and debugging

See the respective board package README file for execution and debugging information for each specific target (real or emulated).

The example application provides sample driver usage and instructions for native as well as emulated execution.


tamago |
Copyright (c) F-Secure Corporation

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation under version 3 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

See accompanying LICENSE file for full details.

The TamaGo logo is adapted from the Go gopher designed by Renee French and licensed under the Creative Commons 3.0 Attributions license. Go Gopher vector illustration by Hugo Arganda.