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.
 
 
 
 
 
Ayke van Laethem cad3e03f94
Allow imports from GOROOT
6 years ago
lib Add runtime support for the nRF52 7 years ago
src Improve print functions 6 years ago
.gitignore Automatically convert .svd files to Go source files 7 years ago
.gitmodules Add runtime support for the nRF52 7 years ago
Makefile Add AVR support 7 years ago
README.markdown compiler: Implement interface calls 6 years ago
analysis.go go fmt 6 years ago
arm.ld Assorted allocator fixes 7 years ago
avr.S Add AVR support 7 years ago
avr.ld Add AVR support 7 years ago
compiler.go Allow imports from GOROOT 6 years ago
gen-device.py Add AVR support 7 years ago
ir.go Refactor: Use our own types as much as possible from the analysis 6 years ago
main.go Split up tgo.go 6 years ago

README.markdown

TinyGo - Go compiler for microcontrollers

We never expected Go to be an embedded language and so it's got serious problems [...].

-- Rob Pike, GopherCon 2014 Opening Keynote

TinyGo is a project to bring Go to microcontrollers and small systems with a single processor core. It is similar to emgo but a major difference is that I want to keep the Go memory model (which implies garbage collection of some sort). Another difference is that TinyGo uses LLVM internally instead of emitting C, which hopefully leads to smaller and more efficient code and certainly leads to more flexibility.

My original reasoning was: if Python can run on microcontrollers, then certainly Go should be able to and run on even lower level micros.

Example program (blinky):

import "machine"

func main() {
	led := machine.GPIO{machine.LED}
	led.Configure(machine.GPIOConfig{Mode: machine.GPIO_OUTPUT})
	for {
		led.Low()
		runtime.Sleep(runtime.Millisecond * 1000)

		led.High()
		runtime.Sleep(runtime.Millisecond * 1000)
	}
}

Currently supported features:

  • control flow
  • many (but not all) basic types: most ints, strings, structs
  • function calling
  • interfaces for basic types (with type switches and asserts)
  • goroutines (very initial support)
  • function pointers (non-blocking)

Not yet supported:

  • float, complex, etc.
  • maps
  • slices
  • interface methods
  • garbage collection
  • defer
  • closures
  • channels
  • introspection (if it ever gets implemented)
  • standard library (needs more language support)
  • ...

Analysis

The goal is to reduce code size (and increase performance) by performing all kinds of whole-program analysis passes. The official Go compiler doesn't do a whole lot of analysis (except for escape analysis) becauses it needs to be fast, but embedded programs are necessarily smaller so it becomes practical. And I think especially program size can be reduced by a large margin when actually trying to optimize for it.

Implemented analysis passes:

  • Check which functions are blocking. Blocking functions a functions that call sleep, chan send, etc. It's parents are also blocking.
  • Check whether the scheduler is needed. It is only needed when there are go statements for blocking functions.
  • Check whether a given type switch or type assert is possible with type-based alias analysis. I would like to use flow-based alias analysis in the future.