Tinygo - Go-компилятор для встраиваемых систем (форк https://github.com/tinygo-org/tinygo) С поддержкой сборки динамических библиотек
Найти файл
2023-06-09 17:30:02 +02:00
.circleci ci: switch to Go 1.20 2023-02-03 07:31:38 -08:00
.github/workflows build: only make comment on sizediff job when run from the main repo, take 2 2023-06-07 12:54:15 +02:00
bin all: add stub pieces for GoLand support 2018-12-01 18:32:34 +01:00
builder main: add -internal-nodwarf flag 2023-06-06 11:46:16 +02:00
cgo cgo: allow LDFLAGS: --export=... 2023-05-04 20:45:02 +02:00
compileopts main: add -internal-nodwarf flag 2023-06-06 11:46:16 +02:00
compiler compiler: limit level of pointer-to-pointer-to-... types 2023-06-09 17:30:02 +02:00
docs docs: change links in README and remove old ReadTheDocs pages to point to TinyGo.org site 2019-01-13 20:29:45 +01:00
goenv goenv: update to new v0.28.0 development version 2023-02-14 19:32:02 +01:00
hooks dockerhub: use post checkout hook for git submodule init 2020-08-03 08:30:31 +02:00
interp interp: add support for reading a pointer tag 2023-05-20 23:57:20 +02:00
lib Revert "Bump CMSIS to 5.9.0" 2022-12-16 21:26:49 +01:00
loader Added missing TCPAddr and UDPAddr implementations to the net package 2023-03-10 10:11:32 -08:00
src compiler,reflect: add tagged pointers for **T etc 2023-06-09 17:30:02 +02:00
stacksize build: support machine outlining pass in stacksize calculation 2022-03-12 12:55:38 +01:00
targets Support for the M5STACK M5StickC ESP32-PICO device 2023-06-08 09:27:41 +02:00
testdata compiler,transform: fix for pointer-to-pointer type switches from @aykevl 2023-06-09 17:30:02 +02:00
tests build: drop deprecated build tags 2022-12-19 23:20:11 +01:00
tools tools: use geomean for sizediff 2023-06-06 09:30:35 +02:00
transform compiler,transform: fix for pointer-to-pointer type switches from @aykevl 2023-06-09 17:30:02 +02:00
.dockerignore docker: ignore changes to CI itself to avoid breaking cache on images 2023-02-18 19:41:11 +01:00
.gitignore all: git ignore smoketest output 2022-07-08 13:01:14 +02:00
.gitmodules Revert "Bump CMSIS to 5.9.0" 2022-12-16 21:26:49 +01:00
BUILDING.md all: drop support for Go 1.16 and Go 1.17 2022-08-30 12:38:06 +02:00
CHANGELOG.md feat: fix typos 2023-03-24 09:22:38 -07:00
CODE-OF-CONDUCT.md docs: add official code of conduct using 'Contributor Covenant' 2019-12-04 21:53:46 +01:00
colorwriter.go all: implement gdb sub-command for easy debugging 2018-10-03 19:03:22 +02:00
CONTRIBUTING.md docs: update CONTRIBUTING links to point to web site. Also replace Azure build badge with Windows build on GH Actions. 2021-11-18 17:49:13 -05:00
CONTRIBUTORS update my name in the contributors list 2020-09-12 16:51:47 +02:00
corpus_test.go main: stuff test runner options into their own struct 2023-03-31 09:07:13 +02:00
Dockerfile ci: switch to Go 1.20 2023-02-03 07:31:38 -08:00
go.mod builder: implement Nordic DFU file writer in Go 2023-05-13 09:52:42 +02:00
go.sum builder: implement Nordic DFU file writer in Go 2023-05-13 09:52:42 +02:00
LICENSE docs: update LICENSE year 2023-04-27 09:08:37 +02:00
main.go main: add -internal-nodwarf flag 2023-06-06 11:46:16 +02:00
main_test.go main: stuff test runner options into their own struct 2023-03-31 09:07:13 +02:00
Makefile Add smoke test for target m5stick-c 2023-06-08 09:27:41 +02:00
monitor.go main: print source location when a panic happens in -monitor 2023-04-26 18:40:35 +02:00
monitor_test.go main: print source location when a panic happens in -monitor 2023-04-26 18:40:35 +02:00
README.md docs: update README for brevity and to add further info about webassembly 2023-04-27 09:08:37 +02:00
util_unix.go build: drop deprecated build tags 2022-12-19 23:20:11 +01:00
util_windows.go gdb: support daemonization on windows 2021-03-04 14:46:10 +01:00

TinyGo - Go compiler for small places

Linux macOS Windows Docker CircleCI

TinyGo is a Go compiler intended for use in small places such as microcontrollers, WebAssembly (wasm/wasi), and command-line tools.

It reuses libraries used by the Go language tools alongside LLVM to provide an alternative way to compile programs written in the Go programming language.

Embedded

Here is an example program that blinks the built-in LED when run directly on any supported board with onboard LED:

package main

import (
    "machine"
    "time"
)

func main() {
    led := machine.LED
    led.Configure(machine.PinConfig{Mode: machine.PinOutput})
    for {
        led.Low()
        time.Sleep(time.Millisecond * 1000)

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

The above program can be compiled and run without modification on an Arduino Uno, an Adafruit ItsyBitsy M0, or any of the supported boards that have a built-in LED, just by setting the correct TinyGo compiler target. For example, this compiles and flashes an Arduino Uno:

tinygo flash -target arduino examples/blinky1

WebAssembly

TinyGo is very useful for compiling programs both for use in browsers (WASM) as well as for use on servers and other edge devices (WASI).

TinyGo programs can run in Fastly Compute@Edge (https://developer.fastly.com/learning/compute/go/), Fermyon Spin (https://developer.fermyon.com/spin/go-components), wazero (https://wazero.io/languages/tinygo/) and many other WebAssembly runtimes.

Here is a small TinyGo program for use by a WASI host application:

package main

//go:wasm-module yourmodulename
//export add
func add(x, y uint32) uint32 {
	return x + y
}

// main is required for the `wasi` target, even if it isn't used.
func main() {}

This compiles the above TinyGo program for use on any WASI runtime:

tinygo build -o main.wasm -target=wasi main.go

Installation

See the getting started instructions for information on how to install TinyGo, as well as how to run the TinyGo compiler using our Docker container.

Supported targets

Embedded

You can compile TinyGo programs for over 94 different microcontroller boards.

For more information, please see https://tinygo.org/docs/reference/microcontrollers/

WebAssembly

TinyGo programs can be compiled for both WASM and WASI targets.

For more information, see https://tinygo.org/docs/guides/webassembly/

Operating Systems

You can also compile programs for Linux, macOS, and Windows targets.

For more information:

Currently supported features:

For a description of currently supported Go language features, please see https://tinygo.org/lang-support/.

Documentation

Documentation is located on our web site at https://tinygo.org/.

You can find the web site code at https://github.com/tinygo-org/tinygo-site.

Getting help

If you're looking for a more interactive way to discuss TinyGo usage or development, we have a #TinyGo channel on the Gophers Slack.

If you need an invitation for the Gophers Slack, you can generate one here which should arrive fairly quickly (under 1 min): https://invite.slack.golangbridge.org

Contributing

Your contributions are welcome!

Please take a look at our Contributing page on our web site for details.

Project Scope

Goals:

  • Have very small binary sizes. Don't pay for what you don't use.
  • Support for most common microcontroller boards.
  • Be usable on the web using WebAssembly.
  • Good CGo support, with no more overhead than a regular function call.
  • Support most standard library packages and compile most Go code without modification.

Non-goals:

  • Be efficient while using zillions of goroutines. However, good goroutine support is certainly a goal.
  • Be as fast as gc. However, LLVM will probably be better at optimizing certain things so TinyGo might actually turn out to be faster for number crunching.
  • Be able to compile every Go program out there.

Why this project exists

We never expected Go to be an embedded language and so its 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 we 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.

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

License

This project is licensed under the BSD 3-clause license, just like the Go project itself.

Some code has been copied from the LLVM project and is therefore licensed under a variant of the Apache 2.0 license. This has been clearly indicated in the header of these files.

Some code has been copied and/or ported from Paul Stoffregen's Teensy libraries and is therefore licensed under PJRC's license. This has been clearly indicated in the header of these files.