Support for i.MX RT microcontrollers.

Embedded Go supports the i.MX RT106x family. You may know it as Teensy 4 which is a family of the popular development boards based on the i.MX RT1062.

Prerequisites

1. Go complier.

   You can download it from go.dev/dl.

2. Git command.

   To instll git on Linux use the package manager provided by your Linux distribution (apt, pacman, rpm, ...).

   Windows users may check the git for Windows website.

   The Mac users may use the git command provided by the Xcode commandline tools. Another way is to use the Homebrew package manager.

Getting started

1. Install the Embedded Go toolchain.

   Make sure the $GOPATH/bin directory is in your PATH, as tools installed with the go install command will be placed here. If you didn't set the GOPATH environment variable manually you can find its default value using the go env GOPATH command.

   Then install the Embedded Go toolchain using the following two commands:

   go install github.com/embeddedgo/dl/go1.24.5-embedded@latest
   go1.24.5-embedded download

2. Install egtool.

   go install github.com/embeddedgo/tools/egtool@latest

3. Create a project directory containing the main.go file with your first Go program for Teensy 4.x.

   package main
   
   import (
   	"time"
   
   	"github.com/embeddedgo/imxrt/devboard/teensy4/board/leds"
   )
   
   func main() {
   	for {
   		leds.User.Toggle()
   		time.Sleep(time.Second/2)
   	}
   }

4. Initialize your project

   go mod init firstprog
   go mod tidy

5. Copy the go.env file suitable for your board (here is one for Teensy and another one for a board with 4 MB flash).

6. Compile your first program

   export GOENV=go.env
   go build

   or

   GOENV=go.env go build

   or

   egtool build

   The last one is like GOENV=go.env go build but looks for the go.env file up the current module directory tree.

7. Connect your Teensy to your computer and press the onboard button.

8. Load and run.

   egtool load

9. See the Embedded Go website for more information.

Examples

See more example code for supported develompent boards.