add tinygo example

Signed-off-by: Simon Waldherr <[email protected]>

Author: SimonWaldherr

readme.md

@@ -256,7 +256,7 @@ From the root directory (`$GOPATH/github.com/SimonWaldherr/golang-examples`), ru
 go test -bench=. -benchmem advanced/json_bench/main_test.go
 ```
 
-Make pipeable unix applications with os.Stdin ([Golang Playground](https://play.golang.org/p/NqrUOfBmJtt))
+Make pipe-able unix applications with os.Stdin ([Golang Playground](https://play.golang.org/p/NqrUOfBmJtt))
 
 ```Shell
 go run pipe.go
@@ -451,7 +451,7 @@ List files in working directory
 go run explorer.go
 ```
 
-run assemply code from golang
+run assembly code from golang
 
 ```Shell
 go run assembly.go
@@ -581,6 +581,17 @@ Hash Map standard functions in golang
 go run map.go
 ```
 
+### TinyGo
+
+You can even use Go on microcontrollers, the keyword here is [TinyGo](https://tinygo.org/), a go compiler specially developed for SBCs and MCUs.  
+If you want to blink the LED of your Raspberry Pi Pico, try this: 
+
+```Shell
+tinygo build -o firmware.uf2 -target=pico ./tinygo/blink.go
+```
+
+and then upload it to the pico.
+
 ## Compile
 
 One great aspect of Golang is, that you can start go applications via ```go run name.go```, but also compile it to an executable with ```go build name.go```. After that you can start the compiled version which starts much faster.

tinygo/README.md

@@ -0,0 +1,68 @@
+# Using TinyGo on a Raspberry Pi Pico
+
+## 1. **Download and Install TinyGo**
+- **Download TinyGo:** Visit the [official TinyGo website](https://tinygo.org/getting-started/). Choose the installation method suitable for your operating system (Windows, macOS, or Linux). 
+- **Install TinyGo:** Follow the installation instructions provided on the website for your platform. Typically, you can install TinyGo via package managers like `brew` for macOS, `apt` for Linux, or directly from the release binaries.
+
+For Linux (e.g., Ubuntu/Debian):
+```bash
+wget https://github.com/tinygo-org/tinygo/releases/download/v0.28.1/tinygo_0.28.1_amd64.deb
+sudo dpkg -i tinygo_0.28.1_amd64.deb
+```
+
+- **Set Environment Variables:** Add the TinyGo installation directory to your system's `PATH` and set the `GOROOT` environment variable. For example:
+  ```bash
+  export PATH=$PATH:/usr/local/tinygo/bin
+  export GOROOT=/usr/local/go
+  ```
+
+## 2. **Compiling a Program**
+- **Write a Program:** Create a simple `main.go` file:
+  ```go
+  package main
+
+  import "machine"
+  import "time"
+
+  func main() {
+      led := machine.LED
+      led.Configure(machine.PinConfig{Mode: machine.PinOutput})
+
+      for {
+          led.High()
+          time.Sleep(time.Millisecond * 500)
+          led.Low()
+          time.Sleep(time.Millisecond * 500)
+      }
+  }
+  ```
+
+- **Compile with TinyGo:** To compile the Go program for the Raspberry Pi Pico, run:
+  ```bash
+  tinygo build -o firmware.uf2 -target=pico main.go
+  ```
+  This command generates a `firmware.uf2` file compatible with the Pico.
+
+## 3. **Uploading to Raspberry Pi Pico**
+- **Put Pico in Bootloader Mode:** Hold down the BOOTSEL button on the Pico, then plug it into your computer. Release the button once connected. The Pico will mount as a USB storage device.
+- **Upload the Firmware:** Copy the generated `firmware.uf2` file to the mounted Pico drive. Once copied, the Pico will reboot and start running the program.
+
+## 4. **Example Programs**
+- **Blink an LED:** The provided code example makes the onboard LED blink every half a second.
+- **Button Control:** Extend the example by reading a button input to control the LED.
+  
+  ```go
+  button := machine.BUTTON
+  button.Configure(machine.PinConfig{Mode: machine.PinInputPullup})
+
+  for {
+      if !button.Get() {
+          led.High()
+      } else {
+          led.Low()
+      }
+      time.Sleep(time.Millisecond * 10)
+  }
+  ```
+
+This setup lets you quickly develop and deploy Go programs on a Raspberry Pi Pico using TinyGo, making it a powerful tool for microcontroller projects.

tinygo/blink.go

@@ -0,0 +1,18 @@
+package main
+
+import (
+    "machine"
+    "time"
+)
+
+func main() {
+    led := machine.Pin(25) // Use Pin 19 on Pico W
+    led.Configure(machine.PinConfig{Mode: machine.PinOutput})
+
+    for {
+        led.High()
+        time.Sleep(time.Millisecond * 500)
+        led.Low()
+        time.Sleep(time.Millisecond * 500)
+    }
+}