{"id":16219985,"url":"https://github.com/sago35/tinygo-workshop","last_synced_at":"2025-03-19T11:30:52.641Z","repository":{"id":46100359,"uuid":"426971859","full_name":"sago35/tinygo-workshop","owner":"sago35","description":"2021/11/13 開催の Go Conference 2021 Autumn 内の TinyGo ハンズオン用の記事","archived":false,"fork":false,"pushed_at":"2022-11-10T00:42:08.000Z","size":1852,"stargazers_count":34,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-15T17:04:20.653Z","etag":null,"topics":["tinygo","wioterminal"],"latest_commit_sha":null,"homepage":"https://gocon.connpass.com/event/226098/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sago35.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-11-11T11:13:52.000Z","updated_at":"2024-09-14T12:09:50.000Z","dependencies_parsed_at":"2023-01-22T17:45:09.049Z","dependency_job_id":null,"html_url":"https://github.com/sago35/tinygo-workshop","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sago35%2Ftinygo-workshop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sago35%2Ftinygo-workshop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sago35%2Ftinygo-workshop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sago35%2Ftinygo-workshop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sago35","download_url":"https://codeload.github.com/sago35/tinygo-workshop/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243985852,"owners_count":20379215,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["tinygo","wioterminal"],"created_at":"2024-10-10T11:56:44.961Z","updated_at":"2025-03-19T11:30:51.973Z","avatar_url":"https://github.com/sago35.png","language":"Go","readme":"# お知らせ\n\nTinyGo 0.26 + Wio Terminal という組み合わせで技術書「基礎から学ぶ TinyGoの組込み開発」 (2022/11/12 発売) を執筆しました。本ページと合わせて確認してみてください。\n\n* https://sago35.hatenablog.com/entry/2022/11/04/230919\n\n----\n\n![image.png](./images/15.png)  \nhttps://gocon.connpass.com/event/226098/\n\nこのページは 2021/11/13 に開催される Go Conference 2021 Autumn 内の Wio Terminal を使った TinyGo ハンズオン用の記事です。不明点は、このページのコメントや [twitter:sago35tk](https://twitter.com/sago35tk) で質問いただければサポートします。  \nTwitter のハッシュタグは [#gocon](https://twitter.com/hashtag/gocon) および [#goconT](https://twitter.com/hashtag/goconT) です。\n\n![image.png](./images/11.png)\n\n# ダウンロード\n\nダウンロードに時間がかかる可能性があるので、最初にダウンロードリンクを記載します。すぐにダウンロードを開始してください。明確にインストール済みである場合でも (実際には使用しないかもしれませんが) ダウンロードするようにしてください。  \nGo は Go 1.16 以降が入っていれば問題ありませんし、 Git はインストールされていればかなり古い Version でもおそらく問題ありません。しかし、もしものために説明を聞きつつダウンロードは進めてください。\n\n## Windows 環境\n\n以下の 3 ファイルをダウンロードしてください。\n\n* [Git](https://gitforwindows.org/)\n    * https://github.com/git-for-windows/git/releases/download/v2.33.1.windows.1/Git-2.33.1-64-bit.exe\n    * Download をクリックして Git-2.33.1-64-bit.exe のようなファイルをダウンロード\n* [Go](https://golang.org/dl/)\n    * https://golang.org/dl/go1.17.3.windows-amd64.msi\n    * 他 version の Go が入っている場合などは [zip 版](https://golang.org/dl/go1.17.3.windows-amd64.zip) を使っても良いですが、原則 msi 版を使ってください\n* [TinyGo](https://tinygo.org/getting-started/install/windows/)\n    * https://github.com/tinygo-org/tinygo/releases/download/v0.21.0/tinygo0.21.0.windows-amd64.zip\n\nハンズオンでは (WSL2 ではなく) Windows Native 版の Go および TinyGo を使用します。 Windows Native 環境に Git / Go などがインストールされていない場合はインストールが必要です。\n\n## macOS 環境\n\n以下の 2 ファイルをダウンロードしてください。\n\n* [Go](https://golang.org/dl/)\n    * https://golang.org/dl/go1.17.3.darwin-amd64.pkg\n        * apple M1 chip の mac についても darwin/amd64 をインストールしてください\n* [TinyGo](https://tinygo.org/getting-started/install/macos/)\n    * https://github.com/tinygo-org/tinygo/releases/download/v0.21.0/tinygo0.21.0.darwin-amd64.tar.gz\n\n## Linux 環境\n\n以下の 2 ファイルをインストールしてください。  \nまた Git がインストールされていない場合、後述の `apt install git` を実行してください。\n\n* [Go](https://golang.org/dl/)\n    * https://golang.org/dl/go1.17.3.linux-amd64.tar.gz\n* [TinyGo](https://tinygo.org/getting-started/install/linux/)\n    * https://github.com/tinygo-org/tinygo/releases/download/v0.21.0/tinygo_0.21.0_amd64.deb\n\nGit がインストールされていない場合、以下を実行してください。\n\n* Git\n    * `sudo apt install git`\n\n# はじめに\n\n2021/11/13 の Go Conference 2021 Autumn Online 当日に TinyGo ハンズオンを行います。ハンズオンでは、組込ソフトとしての側面にフォーカスし、 L チカ (LED を光らせる) などを行います。\n\n今回ハンズオンを実施するにあたり、 Seeed株式会社様より Wio Terminal ボードをスポンサー していただきました。この connpass イベントに参加申し込みをし、当選した人には TinyGo ハンズオンで使用する Wio Terminal ボードを事前に送付 いたします。  \nhttps://www.seeed.co.jp/\n\nこのイベントは日本語で開催されます。  \nThis event will be held in Japanese.\n\n# 対象としている読者\n\n以下を対象としています。  \nもちろん、すでに TinyGo + Wio Terminal で遊び倒している人でも問題ありません。\n\n* Go を少し触ったことがある\n* 組込マイコンで遊んだことがない\n* TinyGo を使ったことがない\n* Wio Terminal は今回が初めて\n\n# TinyGo とは\n\nマイコンや WASM などの Small Places 向けの Go Compiler です。  \n大雑把な理解としては Go の文法でマイコン開発や WASM 開発ができるもの、という程度の認識でよいです。\n\n* [TinyGo - Go on Microcontrollers and WASM](https://tinygo.org/)\n\n\n# Go と TinyGo の違い\n\n基本的な構文は Go と同じですが、パソコンを前提として作られている Go とは異なり、より小さいリソースで動作するような割り切りがあります。  \nまた、マイコンで使うためのいくつかのディレクティブが追加されています。\n\n* 0.21.0 時点で goroutine は GOMAXPROCS = 1 時のときの動作に近い\n    * 例えば `time.Sleep()` 等のブロックする命令が呼ばれない限り goroutine は切り替わらない\n* runtime package などいくつかの標準 package は TinyGo 側のものが使われる\n    * 一方で fmt や encoding などは Go のものが使われる\n* マイコンやターゲットボード向けの標準 package が追加されている\n    * マイコンやボード毎の差異を吸収するための machine package や runtime package など\n    * volatile アクセスのための runtime/volatile package\n* reflect package が完全ではない\n    * これにより、よく話題にあがる encoding/json が動かない、などが発生している\n* 未使用変数や未使用関数等は最適化により削除される\n\n# 必要な環境\n\nこのハンズオンでは PC と Wio Terminal 以外の外付けの部品は使用しません。  \n必要なのは TinyGo が動く PC と Wio Terminal のみです。\n\n* 機材\n    * PC (Windows / macOS / Linux のいずれか)\n        * 詳しくはオフィシャルページの [Getting Started / Quick install](https://tinygo.org/getting-started/install/) を参照\n        * 手元で Windows 10 および Ubuntu 20.04 の環境は試しています\n    * Wio Terminal\n        * 公式: https://www.seeedstudio.com/Wio-Terminal-p-4509.html\n        * 例えば以下から購入できます\n            * https://akizukidenshi.com/catalog/g/gM-15275/\n            * https://www.switch-science.com/catalog/6360/\n            * https://www.marutsu.co.jp/pc/i/1633550/\n            * https://www.amazon.co.jp/studio-MicroPython-Raspberry-ATSAMD51%E3%83%99%E3%83%BC%E3%82%B9-%E3%83%87%E3%83%A5%E3%82%A2%E3%83%AB%E3%83%90%E3%83%B3%E3%83%89WiFi/dp/B08CHBV88D\n* ソフトウェア\n    * [Getting Started / Quick install](https://tinygo.org/getting-started/install/) に従い以下をインストールする\n        * Go 1.17\n            * goenv 等は使用しないほうが環境立ち上げで失敗しにくい\n        * TinyGo 0.21.0\n    * 上記以外\n        * Git\n        * シリアル通信ソフト\n            * このハンズオンでは、このハンズオン用に作成した `github.com/sago35/yterm` を使います\n            * 例) Windows : [Tera Term](https://ttssh2.osdn.jp/) など\n            * 例) macOS / Linux : [Minicom](https://salsa.debian.org/minicom-team/minicom) や [GNU Screen](https://www.gnu.org/software/screen/) など\n\n\n# Wio Terminal とは\n\nWio Terminal は Seeed 社のディスプレイ付きの開発ボードです。320 x 240 のディスプレイ、 WiFi / BLE 搭載、ボタンに加速度センサに MicroSD カードスロットに、と非常に多機能です。\n\nマイコンは Microchip 社の ATSAMD51P19 (Arm Cortex-M4 120MHz) が搭載されています。\n\n公式 : https://www.seeedstudio.com/Wio-Terminal-p-4509.html  \n日本語 wiki : https://wiki.seeedstudio.com/jp/Wio-Terminal-Getting-Started/  \n英語 wiki : https://wiki.seeedstudio.com/Wio-Terminal-Getting-Started/\n\n![image.png](./images/01.png)\n\n![image.png](./images/02.png)\n\n※画像は [公式サイト](https://www.seeedstudio.com/Wio-Terminal-p-4509.html) より\n\n# 環境設定／インストール\n\n`tinygo version` で version が表示できるところまで環境設定を行います。  \n初回実行時は (特に Windows で) 少し時間がかかりますが、これは cached GOROOT を作るのに時間がかかるから、です。  \n二回目以降の tinygo コマンド実行時は cache されているので時間はかかりません。  \ncached GOROOT は、 Go と TinyGo それぞれの標準パッケージをマージした GOROOT を作成しています。  \ncached GOROOT の場所は以下のコマンドで確認できます。\n\n```\n$ tinygo info wioterminal\nLLVM triple:       thumbv7em-unknown-unknown-eabi\nGOOS:              linux\nGOARCH:            arm\nGOARM:             7\nbuild tags:        cortexm baremetal linux arm atsamd51p19a atsamd51p19 atsamd51 sam wioterminal tinygo math_big_pure_go gc.conservative scheduler.tasks serial.usb\ngarbage collector: conservative\nscheduler:         tasks\ncached GOROOT:     %LOCALAPPDATA%\\tinygo\\goroot-go1.17.3-e453cdef992707f5207f1d88a470047697dbe3a2e9e9d25eeaf1604099de8d75-syscall\n```\n\n## Windows\n\n### Git\n\n以下からダウンロードしてインストールしてください。\n\n* https://gitforwindows.org/\n    * https://github.com/git-for-windows/git/releases/download/v2.33.1.windows.1/Git-2.33.1-64-bit.exe\n\n\nインストールしたら、以下を実行してインストールできていることを確認してください。\n\n```\n$ git version\ngit version 2.33.1.windows.1\n```\n\n### Go\n\n以下からダウンロードしてインストールしてください。\n\n* https://golang.org/dl/\n    * https://golang.org/dl/go1.17.3.windows-amd64.msi\n\n\nインストールしたら、以下を実行してインストールできていることを確認してください。\n\n```\n$ go version\ngo version go1.17.3 windows/amd64\n```\n\n### TinyGo\n\n以下をダウンロードして生成される `tinygo` フォルダを `C:\\tinygo` となるように解凍／コピーしてください。最終的に `C:\\tinygo\\bin\\tinygo.exe` に `tinygo.exe` が存在すればよいです。\n\n* https://tinygo.org/getting-started/install/windows/\n    * https://github.com/tinygo-org/tinygo/releases/download/v0.21.0/tinygo0.21.0.windows-amd64.zip\n\n環境変数 PATH を通しておきます。このハンズオンでは cmd.exe もしくは Git に含まれる bash.exe を使用してください。\n\n```\n# cmd.exe を使う場合\n$ set PATH=C:\\tinygo\\bin;%PATH\n\n# Git に含まれる bash.exe を使う場合\n$ export PATH=/C/tinygo/bin:$PATH\n```\n\nインストールしたら、以下を実行してインストールできていることを確認してください。\n\n```\n$ tinygo version\ntinygo version 0.21.0 windows/amd64 (using go version go1.17 and LLVM version 11.0.0)\n```\n\n\n### yterm\n\n以下を実行してください。  \nWindows / macOS / Linux のそれぞれで実行可能です。\n\n```\n$ go install github.com/sago35/yterm@latest\n```\n\nインストールしたら、以下を実行してインストールできていることを確認してください。\n\n```\n$ yterm --help\n(略)\n```\n\nコマンドが実行できない場合は `%GOPATH%\\bin` を PATH を通してから再度実施してください。\n\n```\n# GOPATH を確認する\n$ go env GOPATH\nC:\\Users\\tinygo\\dev\n\n$ set PATH=%PATH%;C:\\Users\\tinygo\\dev\n```\n\n## macOS\n\n### Git\n\nmacOS の人はもしインストールされていない場合は以下でインストールしてください。\n\n* `brew install git`\n    * https://qiita.com/suke_masa/items/4bed855628f7414293f8\n\n```\n$ git version\ngit version 2.33.1\n```\n\n### Go\n\n以下からダウンロードしてインストールしてください。\n\n* https://golang.org/dl/\n    * intel chip : https://golang.org/dl/go1.17.3.darwin-amd64.pkg\n    * apple m1 chip : https://golang.org/dl/go1.17.3.darwin-arm64.pkg\n\n```\n$ go version\ngo version go1.17.3\n```\n\n### TinyGo\n\n以下をダウンロードして生成される `tinygo` フォルダを `~/tinygo` に解凍／コピーしてください。最終的に `~/tinygo/bin/tinygo` に `tinygo` の実行体が存在すればよいです。\n\n* https://tinygo.org/getting-started/install/macos/\n    * https://github.com/tinygo-org/tinygo/releases/download/v0.21.0/tinygo0.21.0.darwin-amd64.tar.gz\n\n環境変数 PATH を通しておきます。\n\n```\n$ export PATH=~/tinygo/bin:$PATH\n```\n\nインストールしたら、以下を実行してインストールできていることを確認してください。\n\n```\n$ tinygo version\ntinygo version 0.21.0 darwin/amd64 (using go version go1.17 and LLVM version 11.0.0)\n```\n\n### yterm\n\n以下を実行してください。  \nWindows / macOS / Linux のそれぞれで実行可能です。\n\n```\n$ go install github.com/sago35/yterm@latest\n```\n\nインストールしたら、以下を実行してインストールできていることを確認してください。\n\n```\n$ yterm --help\n(略)\n```\n\nコマンドが実行できない場合は `%GOPATH%\\bin` を PATH を通してから再度実施してください。\n\n```\n$ export PATH=$PATH:`go env GOPATH`/bin\n```\n\n## Linux\n\n### Git\n\n以下でインストールしてください。\n\n* `sudo apt install git`\n\nGit をインストールしたら、以下を実行してインストールできていることを確認してください。\n\n```\n$ git version\ngit version 2.33.1\n```\n\n### Go\n\n以下からダウンロードしてインストールしてください。\n\n* https://golang.org/dl/\n    * https://golang.org/dl/go1.17.3.linux-amd64.tar.gz\n\nインストール方法は以下に記載されています。\n\n    * https://golang.org/doc/install\n\nGo をインストールしたら、以下を実行してインストールできていることを確認してください。\n\n```\n$ go version\ngo version go1.17.3\n```\n\n### TinyGo\n\n以下をダウンロードして、後述の dpkg でインストールしてください。\n\n* https://tinygo.org/getting-started/install/linux/\n    * https://github.com/tinygo-org/tinygo/releases/download/v0.21.0/tinygo_0.21.0_amd64.deb\n\n```\n$ sudo dpkg -i tinygo_0.21.0_amd64.deb\n```\n\n環境変数 PATH を通しておきます。\n\n```\n$ export PATH=$PATH:/usr/local/tinygo/bin\n```\n\nインストールしたら、以下を実行してインストールできていることを確認してください。\n\n```\n$ tinygo version\ntinygo version 0.21.0 linux/amd64 (using go version go1.17 and LLVM version 11.0.0)\n```\n\n### yterm\n\n以下を実行してください。\nWindows / macOS / Linux のそれぞれで実行可能です。\n\n```\n$ go install github.com/sago35/yterm@latest\n```\n\nインストールしたら、以下を実行してインストールできていることを確認してください。\n\n```\n$ yterm --help\n(略)\n```\n\nコマンドが実行できない場合は `%GOPATH%\\bin` を PATH を通してから再度実施してください。\n\n```\n$ export PATH=$PATH:`go env GOPATH`/bin\n```\n\n## TinyGo のインストール確認1 (build)\n\n以下のコマンドで、正常にビルドが出来ることを確認してください。以下のように何らかの情報が表示されれば、 TinyGo のインストールは正常にできていて、少なくとも Wio Terminal の開発は可能となります。他のボード／マイコンについては別途追加インストールが必要になる場合があります。\n\n```\n$ tinygo build -o blinky.uf2 --target wioterminal --size short examples/blinky1\n   code    data     bss |   flash     ram\n   7556      36    6336 |    7592    6372\n```\n\n## TinyGo のインストール確認2 (手動でのマイコン書き換え)\n\n上記で `blinky.uf2` を作った場合は以下の方法で書き込むことができます。\ndocker を使っている場合は、このやり方がシンプルな書き込み方法になります。\n\n* ブートローダーに遷移させる\n    * 素早くリセットを 2 回実行します (参考: [Wio TerminalのUSB書き込みエラーの回復方法](https://qiita.com/carcon999/items/ec8045adc1309b2e5361))\n        * うまく遷移出来た場合、下記画像の青色 LED がやさしく光ります\n        * また、この時 OS からはマスストレージデバイスとして認識されます\n* マスストレージデバイスとして OS から認識されるので、 uf2 をルートドライブにコピーする\n    * Windows の場合は例えば `cmd.exe` から `copy blinky.uf2 D:` 等で書き込みできます\n\n書き込みが完了したら、 USB 端子付近の青色 LED が 1 秒周期で点滅します。この時マスストレージデバイスのマウントが解除されますが、正常な動作です。\n\n![image.png](./images/03.png)\n\n\u003e tips: マスストレージデバイスとして認識されない場合  \n\u003e セキュリティソフト／ポリシーなどによりマスストレージデバイス (※) のマウントを禁止している場合があります。この場合はハンズオンを継続することができません。  \n\u003e ※ USB フラッシュメモリ等\n\n## TinyGo のインストール確認3 (tinygo flash による書き換え)\n\n以下のコマンドを実行することで、ビルドしつつ書き換えすることができます。基本的にはこのやり方を使って開発のサイクルを回していきます。書き換えに成功したことが分かるように、先ほどとは違うものを書き込んでみましょう。\n\n```\n$ tinygo flash --target wioterminal --size short examples/button\n   code    data     bss |   flash     ram\n   7584      36    6336 |    7620    6372\n```\n\n`examples/button` は、 `machine.BUTTON` (別名: `machine.WIO_KEY_A`) が押された時だけ LED を点灯します。  \n`WIO_KEY_A` は Wio Terminal の上部に 3 つあるボタンの一番右 (内側) のボタンです。\n\n\u003e tips: examples の場所  \n\u003e TinyGo をインストールした場所の `src/examples` 以下に色々な例があります。\u003e もしくは、 [github.com/tinygo-org/tinygo/tree/release/src/examples](https://github.com/tinygo-org/tinygo/tree/release/src/examples) からもダウンロードできます。 すべてが Wio Terminal で実行できるわけではないことに注意が必要です。 Wio Terminal で動く形でまとめたものは以下にありますので適宜参照してください\n\u003e\n\u003e * [Wio Terminal の周辺デバイスを使用する](https://qiita.com/sago35/items/92b22e8cbbf99d0cd3ef#wio-terminal-%E3%81%AE%E5%91%A8%E8%BE%BA%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%99%E3%82%8B)\n\n### tinygo flash が失敗する場合\n\npanic してしまうような実行体をマイコンに書き込んだ場合などは、 tinygo flash が失敗します。\nこの場合は、手動でブートローダーモードに入れてから `tinygo flash` を使ってください。\n\n参考: [COM ポートが見つからない場合](https://qiita.com/sago35/items/92b22e8cbbf99d0cd3ef#com-%E3%83%9D%E3%83%BC%E3%83%88%E3%81%8C%E8%A6%8B%E3%81%A4%E3%81%8B%E3%82%89%E3%81%AA%E3%81%84%E5%A0%B4%E5%90%88)\n\n\n# L チカから始める開発の進め方\n\n`hello world` の組込み版といえば `L チカ` といって LED を点滅させるプログラムになります。  \nここでは、 `L チカ` を動作させてから、少しずつコードを改造していきます。\n\n\u003e Tips:\n\u003e TinyGo ではターゲットボード (`-target` オプションで指定するもの) 毎の差異を `machine` パッケージである程度吸収しています。ボード上に LED が存在する場合は、ほとんどの場合 `machine.LED` という名前で定義されています。  \n\u003e 例えば wioterminal の定義は以下にあります。\n\u003e\n\u003e * https://github.com/tinygo-org/tinygo/blob/release/src/machine/board_wioterminal.go\n\n## プロジェクトを開始する\n\n新しい場所に workshop という名前のフォルダを作成してください。\nその後 `go mod init` を実行してください。\n\n```\n$ cd (任意の場所)\n\n$ mkdir workshop\n\n$ cd workshop\n\n$ go mod init workshop\n```\n\nその後、 `./01_blinky` というフォルダを作り `./01_blinky/main.go` というファイルを以下の内容で作成してください。\n\n[./01_blinky/main.go](https://github.com/sago35/tinygo-workshop/blob/29c966607ddade5711ad5813595e0e57f68d679f/01_blinky/main.go) \n```go:./01_blinky/main.go\npackage main\n\nimport (\n\t\"machine\"\n\t\"time\"\n)\n\nfunc main() {\n\t//led := machine.LED\n\tled := machine.LCD_BACKLIGHT\n\tled.Configure(machine.PinConfig{Mode: machine.PinOutput})\n\tfor {\n\t\tled.Low()\n\t\ttime.Sleep(time.Millisecond * 500)\n\n\t\tled.High()\n\t\ttime.Sleep(time.Millisecond * 500)\n\t}\n}\n```\n\n以下で書き込むことができます。  \n`examples/blinky1` とは異なり液晶全体を LED として点滅させるコードになっています。\n\n```\n$ tinygo flash --target wioterminal --size short ./01_blinky/\n   code    data     bss |   flash     ram\n   7556      36    6336 |    7592    6372\n\n```\n\nうまく書き込みが出来たら、上記ソース内の `led` の定義を `machine.LCD_BACKLIGHT` から `machine.LED` に切り替えてみたり、 `time.Sleep` の待ち時間を変更して周期を変えてみましょう。  \nソース変更 → `tinygo flash` → 確認というのが、基本的な開発サイクルになります。\n\n\u003e tips: tinygo flash や tinygo build 時の package 指定方法  \n\u003e go build と同じで、現在フォルダの package を build / flash する場合は省略もしくは `.` で指定できます。例えば一つフォルダが深い場合は `./01_blinky` のような指定が必要ですが、同じ階層であれば `.` と書くか省略することができます。単一ファイルから構成されるソースをビルドする場合は、 `./01_blinky/main.go` のような指定もできます\n\n## LSP / gopls 対応\n\nTinyGo は、 machine package などを GOROOT に配置しているため設定を行うまでは gopls 等でエラーが表示され machine.LED の定義元へのジャンプ等が出来ません。 TinyGo は machine package など (Go を良く知っていても) 慣れていない package 構成であったり、 build-tag による分岐などが多いため LSP の設定をしておいた方が無難です。\n\n![image.png](./images/04.png)\n\n公式ドキュメントは以下にあります。\n\n* https://tinygo.org/docs/guides/ide-integration/\n\nVSCode の場合は `TinyGo` という拡張をインストールすると良いです。  \nVim (+ vim-lsp) の場合は github.com/sago35/tinygo.vim を使ってみてください。\n\n日本語の情報としては以下に記載しています。\n\n* [TinyGo + 'VSCode or Vim (もしくはそれ以外の LSP 対応エディタ)' で gopls 連携する方法](https://qiita.com/sago35/items/c30cbce4a0a3e12d899c)\n* [TinyGo + Vim で gopls するための設定](https://qiita.com/sago35/items/f0b058ed5c32b6446834)\n\n## 基本的な printf debug の方法\n\nデバッグ方法が分からないと次のステップに進みにくいです。  \n組込み環境のデバッグ方法にもいろいろありますが、ここでは `printf debug` を用いた方法を学びます。\n\n\u003e tips: メリットデメリット  \n\u003e このやり方は外部にデバッグ用のハードが不要なのが良いところです。一方で、 panic してしまうようなソースコードに対しては確認が困難です。そのような場合は Wio Terminal の外側に専用のデバッガを追加する形で対応しますが、ここでは扱いません。\n\n### println と fmt.Print\n\nTinyGo では `println` や `fmt.Print` 等で出力される先は USB-CDC or UART となっていて、 Wio Terminal は USB-CDC を使うように初期設定されています。シリアル通信ソフトを用いてマイコンからの出力を PC で受け取ったり、 PC からの出力をマイコンで受け取ったりすることができます。  \nここでは、 `printf debug` に必要なマイコン側から PC に出力するためのソースコードを紹介します。  \n先ほどのコードに `cnt` 変数を追加しつつ `fmt.Printf()` で値を確認してみましょう。  \n※追加した行には、 `// ← 追加` というコメントを記載しています\n\n[./01_blinky/main.go](https://github.com/sago35/tinygo-workshop/blob/00ee52475c538857d48e0d6e918265585032946d/01_blinky/main.go)  \n```go:./01_blinky/main.go\npackage main\n\nimport (\n\t\"fmt\" // ← 追加\n\t\"machine\"\n\t\"time\"\n)\n\nfunc main() {\n\t//led := machine.LED\n\tled := machine.LCD_BACKLIGHT\n\tled.Configure(machine.PinConfig{Mode: machine.PinOutput})\n\tcnt := 0 // ← 追加\n\tfor {\n\t\tcnt++                         // ← 追加\n\t\tfmt.Printf(\"cnt %d\\r\\n\", cnt) // ← 追加\n\t\tled.Low()\n\t\ttime.Sleep(time.Millisecond * 500)\n\n\t\tled.High()\n\t\ttime.Sleep(time.Millisecond * 500)\n\t}\n}\n```\n\n\u003e tips: シリアル通信の改行コード  \n\u003e シリアル通信は基本的には LF でもよいですが CRLF にしたほうが無難です。 `println()` で CRLF にする場合は面倒ですが `println(\"hello\", \"\\r\")` のようにすることができます。\n\nシリアルポートを開くと以下のように 1 秒毎に 1 行表示されると思います。例えば wioterminal に接続する場合は以下のように実行します。もし、うまく接続できない場合は後述のポート名を指定するやり方を試してください。シリアルポートのモニターが不要となった時は、 Ctrl-C で閉じてください。\n\n```\n$ yterm --target wioterminal\n...\ncnt : 6\ncnt : 7\ncnt : 8\ncnt : 9\ncnt : 10\n...\n```\n\nうまくいかない場合は、シリアルポートとして認識されているか、マイコンは動いているか、を確認してください。マイコンが動いているかどうかは、例えば LED 点灯状態により確認できます。上記のソースコードのように `L チカ` のようなコードを埋め込むと良いです。\n\n\n\u003e tips: TinyGo の main() 関数は終了しないようにする  \n\u003e main() 関数を抜けた場合、プログラムは完全に停止します。この状態では `tinygo flash` に失敗するなどあまり良くない状態となります。なので、基本的には `for { time.Sleep(time.Hour) }` などで `main()` 関数を抜けないようにするのが TinyGo 流となります。\n\n### ポートを指定して yterm で接続する\n\nWio Terminal が複数接続されている場合等はポートを指定して yterm に接続する必要があるかもしれません。まずはポート名を調べるために、 `yterm list` を実行します。\n\n```\n$ yterm list\nCOM8 2886 002D wioterminal\n```\n\n上記の場合は COM8 に wioterminal が存在するため以下を実行します。\n\n```\n$ yterm --port COM8\n```\n\nWindows の場合は `COM8` のような名前ですが他の OS では `/dev/cu.usb1` や `/dev/ttyACM1` のような名前でポートを指定できます。\n\n\u003e tips: なぜ yterm を使うか  \n\u003e Windows だと、ポートを開放しないとマイコン書き換え (`tinygo flash`) に失敗するため、説明することが増えるし、 OS 毎の説明を書くと複雑になるため。慣れている人は好きなソフトを使ってください。\n\n### Windows OS での注意点\n\nWindows では何らかのソフトがシリアルポートを開いている時は、他のソフトはアクセスできません。  \nyterm や Tera Term 等で接続しているときに `tinygo flash` しようとすると以下のようなエラーとなります。  \n通信ソフトを閉じるか、ブートローダーに遷移させてください。\n\n```\n$ tinygo flash --target wioterminal --size short ./01_blinky/\n   code    data     bss |   flash     ram\n  46096    1384    6336 |   47480    7720\nerror: failed to reset port %TEMP%\\tinygo914402091\\main.uf2: opening port: Serial port busy\n```\n\n## 外部 package を使用する1 (例を実行する)\n\nGo と基本的には同じで `import` に外部 package を追加した上で `go get` が必要になります。ここでは `tinygo.org/x/drivers/examples/ili9341/pyportal_boing` を動かす過程で `go get` を使います。以下を実行すると `go get` を促されます。\n\n```\n$ tinygo flash --target wioterminal --size short tinygo.org/x/drivers/examples/ili9341/pyportal_boing\nno required module provides package tinygo.org/x/drivers/examples/ili9341/pyportal_boing; to add it:\n        go get tinygo.org/x/drivers/examples/ili9341/pyportal_boing\n```\n\nしかし、指示通りに `go get` してもうまく行く場合もありますが、失敗する場合もあります。  \n失敗時はエラーメッセージが表示の通り TinyGo のみに存在する標準 package を見つけることができずエラーになります。\n\n```\n$ go get tinygo.org/x/drivers/examples/ili9341/pyportal_boing\ngo: downloading tinygo.org/x/drivers v0.18.0\ntinygo.org/x/drivers/examples/ili9341/pyportal_boing imports\n        tinygo.org/x/drivers/ili9341 imports\n        machine: package machine is not in GOROOT (c:\\go\\src\\machine)\n```\n\nこの場合は以下のように実施してください。\n\n```\n$ go get tinygo.org/x/drivers\ngo get: added tinygo.org/x/drivers v0.18.0\n```\n\nこれで実行できるようになりました。\n\n```\n$ tinygo flash --target wioterminal --size short tinygo.org/x/drivers/examples/ili9341/pyportal_boing\n   code    data     bss |   flash     ram\n  29964      36   37504 |   30000   37540\n```\n\nこの状態で `tinygo.org/x/drivers` への依存が `go.mod` に書き込まれているため、 `tinygo.org/x/drivers` 以下の package を使用することが出来るようになります。\n\n```:go.mod\nmodule workshop\n\ngo 1.17\n\nrequire tinygo.org/x/drivers v0.18.0 // indirect\n```\n\npyportal_boing のソースコードは以下にあります。\n\n* https://github.com/tinygo-org/drivers/tree/release/examples/ili9341/pyportal_boing\n\n## 外部パッケージを使用する2 (ブザーを鳴らす)\n\nWio Terminal にはブザーが搭載されています。  \n搭載されているブザーは High / Low の周期で音を制御することができます。  \n例えば周期として 440Hz で High / Low を変化させることで[ラの音 (A4)](https://ja.wikipedia.org/wiki/A440) を鳴らすことができます。\n\n![image.png](./images/05.png)\n\n\u003e tips: 回路図を確認する  \n\u003e 組込みにおいて各種センサー等がどこにどのように繋がっているかを確認しておく必要があります。 Wio Terminal の場合は以下にまとまっているので確認しておくと良いです。上記の図は、下記 pdf からの抜粋になります。  \n\u003e https://wiki.seeedstudio.com/Wio-Terminal-Getting-Started/  \n\u003e https://files.seeedstudio.com/wiki/Wio-Terminal/res/Wio-Terminal-SCH-v1.2.pdf\n\nブザーは tinygo.org/x/drivers/buzzer を使って動作させることができます。  \n上記で `go get tinygo.org/x/drivers` を実行している場合はそのまま動きます。  \n`tinygo.org/x/drivers/buzzer` は現状 time.Sleep() を用いた周波数制御であまり精度が良くないため綺麗な音は鳴らないのですが、 main.go を以下のように書き換えることで最低限の動作をさせることができます。  \n変更箇所は `// ↓ 追加` と `// ↑ 追加` の間、もしくは `// ← 追加` が書かれた行となります。\n\n[./01_blinky/main.go](./01_blinky/main.go)  \n```go:./01_blinky/main.go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"machine\"\n\t\"time\"\n\n\t\"tinygo.org/x/drivers/buzzer\" // ← 追加\n)\n\n// ↓ 追加\ntype note struct {\n\ttone     float64\n\tduration float64\n}\n// ↑ 追加\n\nfunc main() {\n\t//led := machine.LED\n\tled := machine.LCD_BACKLIGHT\n\tled.Configure(machine.PinConfig{Mode: machine.PinOutput})\n\tcnt := 0\n\n\t// ↓ 追加\n\tbzrPin := machine.WIO_BUZZER\n\tbzrPin.Configure(machine.PinConfig{Mode: machine.PinOutput})\n\tbzr := buzzer.New(bzrPin)\n\n\tnotes := []note{\n\t\t{buzzer.C3, buzzer.Quarter},\n\t\t{buzzer.D3, buzzer.Quarter},\n\t\t{buzzer.E3, buzzer.Quarter},\n\t}\n\t// ↑ 追加\n\n\tfor {\n\t\tcnt++\n\t\tfmt.Printf(\"cnt %d\\r\\n\", cnt)\n\t\tled.Low()\n\t\ttime.Sleep(time.Millisecond * 500)\n\n\t\tled.High()\n\t\ttime.Sleep(time.Millisecond * 500)\n\n\t\t// ↓ 追加\n\t\tfor _, n := range notes {\n\t\t\tbzr.Tone(n.tone, n.duration)\n\t\t\ttime.Sleep(10 * time.Millisecond)\n\t\t}\n\t\t// ↑ 追加\n\t}\n}\n```\n\n## 外部パッケージを使用する3 (ブザーを PWM で鳴らす)\n\n(2022/05/23 追記しました)  \n\ntinygo.org/x/drivers/tone を使うと PWM でブザーを鳴らすことができます。  \nWio Terminal は `machine.WIO_BUZZER` ピンを `machine.TCC0` として使う事で音を鳴らすことができます。  \n\n```go\n\tbzrPin := machine.WIO_BUZZER\n\tpwm := machine.TCC0\n\tspeaker, err := tone.New(pwm, bzrPin)\n\tspeaker.SetNote(tone.C6)\n```\n\nコードは以下にあります。\n\nhttps://github.com/sago35/tinygo-examples/blob/main/wioterminal/buzzer/main.go  \n\n# ハンズオン\n\n残りの時間で以下を実行してみましょう。すべてを実行するには時間が足りないと思うので、好きなものからチャレンジしてみてください。\n\n`USB-CDC 送受信` と `SPI / ILI9341 ディスプレイ` と `SPI / ILI9341 ディスプレイ 2` あたりを実行すると楽しみやすいと思います。\n\n困った時は以下の記事も参考になると思います。\n\n* [Wio Terminal の周辺デバイスを使用する](https://qiita.com/sago35/items/92b22e8cbbf99d0cd3ef#wio-terminal-%E3%81%AE%E5%91%A8%E8%BE%BA%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%99%E3%82%8B)\n\n## GPIO\n\n![image.png](./images/06.png)\n\n\nGPIO は machine.Pin を入力 (machine.PinInput 等) に設定することで入力端子として使用することができます。あるいは既に登場している LED のように machine.PinOutput に設定することで出力端子として使用することができます。実際には以下のようなコードになります。\n\n```go\n// ボタン A (WIO_KEY_A) を入力モードで初期化\nmachine.WIO_KEY_A.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\n// 現在の状態 (High / Low) を取得\nstatus := machine.WIO_KEY_A.Get()\n```\n\n```go\n// 液晶 (LCD_BACKLIGHT) を出力モードで初期化\nmachine.LCD_BACKLIGHT.Configure(machine.PinConfig{Mode: machine.PinOutput})\n\n// 出力を変化させる\nmachine.LCD_BACKLIGHT.High()\nmachine.LCD_BACKLIGHT.Low()\nmachine.LCD_BACKLIGHT.Toggle()\n```\n\n* https://tinygo.org/docs/reference/microcontrollers/machine/wioterminal/#type-pin\n* https://github.com/tinygo-org/tinygo/blob/v0.21.0/src/machine/machine_atsamd51.go#L23-L48\n\nここでは、 Wio Terminal に存在する以下のボタン／キーに対応するアプリケーションを作成します。\n\n* `WIO_KEY_A` ～ `WIO_KEY_B` が押されたら液晶を On にしつつシリアルにボタン名を出力\n* 十字キーの上下左右 (`WIO_5S_*`) が押されたら液晶を On にしつつシリアルにキー名を出力\n* 十字キー自身が押された (`WIO_5S_PRESS`) ら液晶を On にしつつシリアルにキー名を出力\n\n[./02_gpio/main.go](./02_gpio/main.go)  \n```go:./02_gpio/main.go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"machine\"\n\t\"time\"\n)\n\nconst (\n\tled = machine.LCD_BACKLIGHT\n)\n\nfunc main() {\n\tled.Configure(machine.PinConfig{Mode: machine.PinOutput})\n\n\tmachine.WIO_KEY_A.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\tmachine.WIO_KEY_B.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\tmachine.WIO_KEY_C.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\n\tmachine.WIO_5S_UP.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\tmachine.WIO_5S_LEFT.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\tmachine.WIO_5S_RIGHT.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\tmachine.WIO_5S_DOWN.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\tmachine.WIO_5S_PRESS.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\n\tfor {\n\t\tif !machine.WIO_KEY_A.Get() {\n\t\t\tled.Low()\n\t\t\tfmt.Printf(\"machine.WIO_KEY_A pressed\\r\\n\")\n\t\t} else if !machine.WIO_KEY_B.Get() {\n\t\t\tled.Low()\n\t\t\tfmt.Printf(\"machine.WIO_KEY_B pressed\\r\\n\")\n\t\t} else if !machine.WIO_KEY_C.Get() {\n\t\t\tled.Low()\n\t\t\tfmt.Printf(\"machine.WIO_KEY_C pressed\\r\\n\")\n\t\t} else if !machine.WIO_5S_UP.Get() {\n\t\t\tled.Low()\n\t\t\tfmt.Printf(\"machine.WIO_5S_UP pressed\\r\\n\")\n\t\t} else if !machine.WIO_5S_LEFT.Get() {\n\t\t\tled.Low()\n\t\t\tfmt.Printf(\"machine.WIO_5S_LEFT pressed\\r\\n\")\n\t\t} else if !machine.WIO_5S_RIGHT.Get() {\n\t\t\tled.Low()\n\t\t\tfmt.Printf(\"machine.WIO_5S_RIGHT pressed\\r\\n\")\n\t\t} else if !machine.WIO_5S_DOWN.Get() {\n\t\t\tled.Low()\n\t\t\tfmt.Printf(\"machine.WIO_5S_DOWN pressed\\r\\n\")\n\t\t} else if !machine.WIO_5S_PRESS.Get() {\n\t\t\tled.Low()\n\t\t\tfmt.Printf(\"machine.WIO_5S_PRESS pressed\\r\\n\")\n\t\t} else {\n\t\t\tled.High()\n\t\t}\n\n\t\ttime.Sleep(time.Millisecond * 10)\n\t}\n}\n```\n\n\u003e tips: ボタンが押されている時の電圧は回路によって決まる  \n\u003e ボタンを押している時に High で離した時に Low になる場合と、その逆になる場合の両方のパターンがあります。これは回路によって決まります。 Wio Terminal はすべてのボタンが Pull-Up されていて離している時は High になっています。\n\n## USB-CDC 送受信\n\n上記の printf debug にて USB-CDC 経由で Wio Terminal からのデータを PC で受け取ることが出来ました。ここでは PC から Wio Terminal にデータを送って操作してみましょう。\n\n題材は以下とします。\n\n* 仕様\n    * シリアルから `on\\n` と入力すると液晶を ON にする\n    * シリアルから `off\\n` と入力すると液晶を OFF にする\n    * シリアルから `toggle\\n` もしくは `t\\n` と入力すると液晶の ON と OFF を切り返る\n\n`println` や `fmt.Printf` を実行した場合、 Go だと `os.Stdout` に出力されますが、 TinyGo の場合は `machine.Serial` に出力されます。Wio Terminal の `machine.Serial` のデフォルト値は `*machine.USBCDC` 型なので USBCDC への出力となります。  \nでは入力はどうすればよいか。 `*machine.USBCDC` が `io.Reader` インターフェースを持つため普通に読み書きそうなのですが goroutine スイッチの兼ね合いにより TinyGo 0.21.0 時点では bufio.Scanner 等ではうまく動かないので以下のように書く必要があります。\n\n下記は `usbcdc.Buffered()` で Wio Terminal が受信したデータがあるかどうかを調べ、データがある場合のみ `usbcdc.ReadByte()` しています。このように書くことで、単に echo するだけのサーバーが出来上がります。\n\n[./03_usbcdc/main.go](https://github.com/sago35/tinygo-workshop/blob/efb627c1b927d6d81948347bb239e3a806510015/03_usbcdc/main.go)  \n```go:./03_usbcdc/main.go\npackage main\n\nimport (\n\t\"machine\"\n)\n\nfunc main() {\n\tusbcdc := machine.Serial\n\n\tfor {\n\t\tif usbcdc.Buffered() \u003e 0 {\n\t\t\tdata, _ := usbcdc.ReadByte()\n\n\t\t\t// just echo the character\n\t\t\tusbcdc.WriteByte(data)\n\t\t}\n\t}\n}\n```\n\nあとは USBCDC 経由で `on\\r\\n` もしくは `on\\n` と入力された場合等に所定のコマンド等を実行するようにします。改行文字が入力されるまでは buffer していくようにするとうまく処理できます。\n\n完成形は以下になります。\n\n[./03_usbcdc/main.go](./03_usbcdc/main.go)  \n```go:./03_usbcdc/main.go\npackage main\n\nimport (\n\t\"machine\"\n\t\"time\"\n)\n\nfunc main() {\n\tled := machine.LCD_BACKLIGHT\n\tled.Configure(machine.PinConfig{Mode: machine.PinOutput})\n\tled.High()\n\n\tusbcdc := machine.Serial\n\tusbcdc.Configure(machine.UARTConfig{})\n\n\tinput := make([]byte, 64)\n\ti := 0\n\tfor {\n\t\tif usbcdc.Buffered() \u003e 0 {\n\t\t\tdata, _ := usbcdc.ReadByte()\n\n\t\t\tswitch data {\n\t\t\tcase 13:\n\t\t\t\t// return key\n\t\t\t\tusbcdc.Write([]byte(\"\\r\\n\"))\n\n\t\t\t\tswitch string(input[:i]) {\n\t\t\t\tcase \"on\":\n\t\t\t\t\tled.High()\n\t\t\t\tcase \"off\":\n\t\t\t\t\tled.Low()\n\t\t\t\tcase \"toggle\", \"t\":\n\t\t\t\t\tled.Toggle()\n\t\t\t\t}\n\t\t\t\ti = 0\n\t\t\tdefault:\n\t\t\t\t// just echo the character\n\t\t\t\tusbcdc.WriteByte(data)\n\t\t\t\tinput[i] = data\n\t\t\t\ti++\n\t\t\t}\n\t\t}\n\t\ttime.Sleep(10 * time.Millisecond)\n\t}\n}\n```\n\n## タイマー割込み\n\nTinyGo では `time.Sleep()` や `time.Tick()` を用いてある程度の精度での周期処理等を実現できます。が、正確に刻みたい場合は systick を使うと良いです。以下は examples/systick と同じです。使うときは channel  と組み合わせると良いです。\n\n* https://github.com/tinygo-org/tinygo/blob/release/src/examples/systick/systick.go\n\n[./04_systick/main.go](./04_systick/main.go)  \n```go:./04_systick/main.go\npackage main\n\nimport (\n\t\"device/arm\"\n\t\"machine\"\n)\n\nvar timerCh = make(chan struct{}, 1)\n\nfunc main() {\n\t//led := machine.LED\n\tled := machine.LCD_BACKLIGHT\n\tled.Configure(machine.PinConfig{Mode: machine.PinOutput})\n\n\t// timer fires 10 times per second\n\tarm.SetupSystemTimer(machine.CPUFrequency() / 10)\n\n\tfor {\n\t\tled.Low()\n\t\t\u003c-timerCh\n\t\tled.High()\n\t\t\u003c-timerCh\n\t}\n}\n\n//export SysTick_Handler\nfunc timer_isr() {\n\tselect {\n\tcase timerCh \u003c- struct{}{}:\n\tdefault:\n\t\t// The consumer is running behind.\n\t}\n}\n```\n\n## PWM / ブザー\n\n![image.png](./images/07.png)\n\nここでは、 buzzer package を使ってドレミの歌を作ってみましょう。以下の buzzer package を使って音の高さと長さを処理することができます。\n\n* https://pkg.go.dev/tinygo.org/x/drivers@v0.17.1/buzzer\n\n完成版 (と言っても最初のフレーズのみですが) は以下。\n\n[./05_buzzer/main.go](./05_buzzer/main.go)  \n```go:./05_buzzer/main.go\npackage main\n\nimport (\n\t\"machine\"\n\t\"time\"\n\n\t\"tinygo.org/x/drivers/buzzer\"\n)\n\ntype note struct {\n\ttone     float64\n\tduration float64\n}\n\nfunc main() {\n\tbzrPin := machine.WIO_BUZZER\n\tbzrPin.Configure(machine.PinConfig{Mode: machine.PinOutput})\n\tbzr := buzzer.New(bzrPin)\n\n\tnotes := []note{\n\t\t{buzzer.C3, buzzer.Quarter},\n\t\t{buzzer.Rest, buzzer.Eighth},\n\t\t{buzzer.D3, buzzer.Eighth},\n\t\t{buzzer.E3, buzzer.Quarter},\n\t\t{buzzer.Rest, buzzer.Eighth},\n\t\t{buzzer.C3, buzzer.Eighth},\n\t\t{buzzer.E3, buzzer.Quarter},\n\t\t{buzzer.C3, buzzer.Quarter},\n\t\t{buzzer.E3, buzzer.Half},\n\t}\n\n\tfor _, n := range notes {\n\t\tbzr.Tone(n.tone, n.duration)\n\t\ttime.Sleep(10 * time.Millisecond)\n\t}\n\n\tfor {\n\t\ttime.Sleep(time.Hour)\n\t}\n}\n```\n\n\u003e tips: buzzer の音が綺麗に鳴らない  \n\u003e 綺麗な音を鳴らすには buzzer に対してある程度正確に ON / OFF 信号を与える必要があります。現時点の buzzer package はソフトウェアで時間を計算しているためあまり正確ではありません。いずれこの部分はハードウェア PWM 機能を使うことで改善していくはずです。\n\n追記) tinygo.org/x/drivers/tone を使うことで PWM 制御となり綺麗な音が鳴るようになります\n\n## ADC / 光センサー\n\n![image.png](./images/08.png)\n\nWio Terminal には本体背面の透明窓の中に光センサーが搭載されています。この光センサーは光の強さを電圧に変換する動きであるため、 Wio Terminal からは電圧を読むと光の強さを知ることができます。光が強い時は 0xFFFF に近い値となり、光が弱いときは 0x0000 に近い値となります。光センサーは `machine.WIO_LIGHT` という名前でアクセスできます。\n\nAD 値の読み取りを行う場合は、以下のように設定した上で使う必要があります。 TinyGo の ADC 初期設定は 12bit ADC で、左寄せとなっているため 0x0000 ～ 0xFFF0 の値を取ります。\n\n```go\n// machine.ADC 型の変数を作り、 Configure() をコールする\nsensor := machine.ADC{Pin: machine.WIO_LIGHT}\nsensor.Configure(machine.ADCConfig{})\n\n// AD 値を読み取る\nval := sensor.Get()\n```\n\nここでは、光の強さに対応する電圧値 (0x0000 - 0xFFFF) をシリアルに出力しつつ、 0x8000 以上であれば led (液晶画面) を ON にするプログラムを作成します。\n\nADC については以下に記載があります。\n\n* https://tinygo.org/docs/reference/microcontrollers/machine/wioterminal/#type-adc\n\n[./06_light_sensor/main.go](./06_light_sensor/main.go)  \n```go:./06_light_sensor/main.go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"machine\"\n\t\"time\"\n)\n\nfunc main() {\n\tmachine.InitADC()\n\n\tled := machine.LCD_BACKLIGHT\n\tled.Configure(machine.PinConfig{Mode: machine.PinOutput})\n\n\tsensor := machine.ADC{Pin: machine.WIO_LIGHT}\n\tsensor.Configure(machine.ADCConfig{})\n\n\tfor {\n\t\tval := sensor.Get()\n\t\tfmt.Printf(\"%04X\\r\\n\", val)\n\t\tif val \u003c 0x8000 {\n\t\t\tled.Low()\n\t\t} else {\n\t\t\tled.High()\n\t\t}\n\t\ttime.Sleep(time.Millisecond * 100)\n\t}\n}\n```\n\n## I2C / 加速度センサー\n\n![image.png](./images/09.png)\n\nWio Terminal には 3 軸加速度センサーである LIS3DH が搭載されています。 X / Y / Z 軸それぞれの加速度を読み取ることで傾き検知等が可能です。これは I2C 接続されているため、事前に I2C のセットアップが必要です。 I2C は回路図表記の `I2C0` ではなく `machine.I2C1` を使用します。\n\n```go\nmachine.I2C1.Configure(machine.I2CConfig{SCL: machine.SCL1_PIN, SDA: machine.SDA1_PIN})\n```\n\nLIS3DH の driver は以下にあります。I2C で所定のコマンドを発行すると値を読み取ることが出来るため、とても簡単に使用することができます。\n\n* https://pkg.go.dev/tinygo.org/x/drivers@v0.17.1/lis3dh\n\n[./07_lis3dh/main.go](./07_lis3dh/main.go)  \n```go:./07_lis3dh/main.go\npackage main\n\nimport (\n\t\"machine\"\n\t\"time\"\n\n\t\"tinygo.org/x/drivers/lis3dh\"\n)\n\nvar i2c = machine.I2C1\n\nfunc main() {\n\ti2c.Configure(machine.I2CConfig{SCL: machine.SCL1_PIN, SDA: machine.SDA1_PIN})\n\n\taccel := lis3dh.New(i2c)\n\taccel.Address = lis3dh.Address0 // address on the Wio Terminal\n\taccel.Configure()\n\taccel.SetRange(lis3dh.RANGE_2_G)\n\n\tprintln(accel.Connected())\n\n\tfor {\n\t\tx, y, z, _ := accel.ReadAcceleration()\n\t\tprintln(\"X:\", x, \"Y:\", y, \"Z:\", z)\n\n\t\t//rx, ry, rz := accel.ReadRawAcceleration()\n\t\t//println(\"X (raw):\", rx, \"Y (raw):\", ry, \"Z (raw):\", rz)\n\n\t\ttime.Sleep(time.Millisecond * 100)\n\t}\n}\n```\n\n\n## SPI / ILI9341 ディスプレイ\n\n![image.png](./images/10.png)\n\n画面を使った処理はパソコン上のプログラムとは異なる感動があると思います。 Wio Terminal には SPI 接続の ili9341 ディスプレイが搭載されています。解像度は 320x240 です。\n\n所定の初期化を実施した後は、比較的簡単に扱うことができます。ここでは単純な図形を表示してみます。初期化は以下のように行います。  \n`InitDisplay()` では ili9341 に接続されている SPI3 / LCD_SCK_PIN / LCD_SDO_PIN / LCD_SDI_PIN / LCD_BACKLIGHTの初期化を行い `*ili9341.Device` を返しています。以降は `*ili9341.Device` を用いて画面に描画していきます。\n\n```go\nfunc InitDisplay() *ili9341.Device {\n\tmachine.SPI3.Configure(machine.SPIConfig{\n\t\tSCK:       machine.LCD_SCK_PIN,\n\t\tSDO:       machine.LCD_SDO_PIN,\n\t\tSDI:       machine.LCD_SDI_PIN,\n\t\tFrequency: 48000000,\n\t})\n\n\t// configure backlight\n\tbacklight := machine.LCD_BACKLIGHT\n\tbacklight.Configure(machine.PinConfig{machine.PinOutput})\n\n\tdisplay := ili9341.NewSPI(\n\t\tmachine.SPI3,\n\t\tmachine.LCD_DC,\n\t\tmachine.LCD_SS_PIN,\n\t\tmachine.LCD_RESET,\n\t)\n\n\t// configure display\n\tdisplay.Configure(ili9341.Config{})\n\n\tbacklight.High()\n\n\tdisplay.SetRotation(ili9341.Rotation270)\n\n\treturn display\n}\n```\n\n`tinygo.org/x/drivers.Displayer` インターフェースは以下のように定義されていますので、基本的には `SetPixel()` で描画していくことになります。\n\n```go\ntype Displayer interface {\n\t// Size returns the current size of the display.\n\tSize() (x, y int16)\n\n\t// SetPizel modifies the internal buffer.\n\tSetPixel(x, y int16, c color.RGBA)\n\n\t// Display sends the buffer (if any) to the screen.\n\tDisplay() error\n}\n```\n\nしかし、 `SetPixel()` だけでは遅いし大変なので、多くの場合は `tinygo.org/x/tinydraw` や `tinygo.org/x/drivers/ili9341` の各種関数を用いて描画していきます。\n\n* https://pkg.go.dev/tinygo.org/x/drivers@v0.17.1/ili9341\n* https://pkg.go.dev/tinygo.org/x/tinydraw\n* https://pkg.go.dev/tinygo.org/x/tinyfont\n\nということで、 tinydraw と tinyfont を `go get` しておきましょう。\n\n```\n$ go get tinygo.org/x/tinydraw\ngo get: added tinygo.org/x/tinydraw v0.0.0-20200416172542-c30d6d84353c\n\n$ go get tinygo.org/x/tinyfont\n```\n\nここでは以下のような画面を作っていきましょう。この画面は [基礎から学ぶ 組込みRust](https://www.c-r.com/book/detail/1403) で作成する題材の TinyGo 版になります。\n\n![image.png](./images/11.png)\n\n画面の構成要素は以下の通りです。\n\n* body : x=20 y=20 の位置から w=280 h=200 を白い四角で塗りつぶす (ili9341.Device.FillRectangle)\n* lcd : x=25 y=25 の位置から w=270 h=160 を黒い四角で塗りつぶす (ili9341.Device.FillRectangle)\n* speaker : x=40+i*15 y=190 の位置から w=5 h=20 を黒い四角で塗りつぶす (ili9341.Device.FillRectangle)\n* buttons : x=40+i*60 y=40 の位置から w=40 h=5 を青い四角で塗りつぶす (ili9341.Device.FillRectangle)\n* 5-way key : x=260 y=180 r=20 の青い円で塗りつぶす (tinydraw.FilledCircle)\n* text : x=30 y=40 の位置にテキストを緑色で表示する (tinyfont.WriteLine)\n* 中心に TinyGo のロゴ (60x51) を表示する (drivers.Displayer.SetPixel)\n\n上記の画像は以下のようにして出力できます。なお、下記ソース内の `tinygo_logo_s_png` については、 png のデータから `const string` に変換したものを用意する必要があります。 以下の `graphics.go` を各自コピーして使ってください。\n\n* [./08_spi_ili9341](./08_spi_ili9341)\n\n[./08_spi_ili9341/main.go](./08_spi_ili9341/main.go)  \n```go:./08_spi_ili9341/main.go\npackage main\n\nimport (\n\t\"image/color\"\n\t\"image/png\"\n\t\"log\"\n\t\"machine\"\n\t\"strings\"\n\t\"time\"\n\n\t\"tinygo.org/x/drivers/ili9341\"\n\t\"tinygo.org/x/tinydraw\"\n\t\"tinygo.org/x/tinyfont\"\n\t\"tinygo.org/x/tinyfont/freemono\"\n)\n\nvar (\n\twhite = color.RGBA{R: 0xFF, G: 0xFF, B: 0xFF, A: 0xFF}\n\tred   = color.RGBA{R: 0xFF, G: 0x00, B: 0x00, A: 0xFF}\n\tgreen = color.RGBA{R: 0x00, G: 0xFF, B: 0x00, A: 0xFF}\n\tblue  = color.RGBA{R: 0x00, G: 0x00, B: 0xFF, A: 0xFF}\n\tblack = color.RGBA{R: 0x00, G: 0x00, B: 0x00, A: 0xFF}\n)\n\nfunc main() {\n\tdisplay := InitDisplay()\n\n\t// body\n\tdisplay.FillRectangle(20, 20, 280, 200, white)\n\n\t// lcd\n\tdisplay.FillRectangle(25, 25, 270, 160, black)\n\n\t// speaker\n\tfor i := int16(0); i \u003c 4; i++ {\n\t\tdisplay.FillRectangle(40+i*15, 190, 5, 20, black)\n\t}\n\n\t// buttons\n\tfor i := int16(0); i \u003c 3; i++ {\n\t\tdisplay.FillRectangle(40+i*60, 15, 40, 5, blue)\n\t}\n\n\t// 5-way key\n\ttinydraw.FilledCircle(display, 260, 180, 20, blue)\n\n\t// text\n\ttinyfont.WriteLine(display, \u0026freemono.Regular9pt7b, 30, 40, \"Booting Wio Terminal...\", green)\n\n\t// tinygo logo\n\t{\n\t\timg, err := png.Decode(strings.NewReader(tinygo_logo_s_png))\n\t\tif err != nil {\n\t\t\tlog.Fatal(err)\n\t\t}\n\n\t\tw := img.Bounds().Dx()\n\t\th := img.Bounds().Dy()\n\t\tfor y := 0; y \u003c h; y++ {\n\t\t\tfor x := 0; x \u003c w; x++ {\n\t\t\t\tr, g, b, _ := img.At(x, y).RGBA()\n\t\t\t\tdisplay.SetPixel((320-int16(w))/2+int16(x), (240-int16(h))/2+int16(y), color.RGBA{R: uint8(r \u003e\u003e 8), G: uint8(g \u003e\u003e 8), B: uint8(b \u003e\u003e 8), A: 0xFF})\n\t\t\t}\n\t\t}\n\t}\n\n\tfor {\n\t\ttime.Sleep(time.Hour)\n\t}\n}\n\nfunc InitDisplay() *ili9341.Device {\n\tmachine.SPI3.Configure(machine.SPIConfig{\n\t\tSCK:       machine.LCD_SCK_PIN,\n\t\tSDO:       machine.LCD_SDO_PIN,\n\t\tSDI:       machine.LCD_SDI_PIN,\n\t\tFrequency: 48000000,\n\t})\n\n\t// configure backlight\n\tbacklight := machine.LCD_BACKLIGHT\n\tbacklight.Configure(machine.PinConfig{machine.PinOutput})\n\n\tdisplay := ili9341.NewSPI(\n\t\tmachine.SPI3,\n\t\tmachine.LCD_DC,\n\t\tmachine.LCD_SS_PIN,\n\t\tmachine.LCD_RESET,\n\t)\n\n\t// configure display\n\tdisplay.Configure(ili9341.Config{})\n\n\tbacklight.High()\n\n\tdisplay.SetRotation(ili9341.Rotation270)\n\tdisplay.FillScreen(color.RGBA{R: 0x00, G: 0x00, B: 0x00, A: 0xFF})\n\n\treturn display\n}\n```\n\n\u003e tips: 画像表示について  \n\u003e png 画像は小さいサイズであれば Go 標準の image/png を使うことができます。解像度が大きくなってくると RAM サイズの制限で描画できない事が多いです。例えば 320 x 240 サイズの `image.Image` 型に Decode された状態だと内部では `*image.RGBA` 型となり最低でも 320 x 240 x 4 = 76800 byte のメモリが必要となります。実際には計算途中のテンポラリ RAM などを含めると Wio Terminal が持つ 192KB の RAM では足りないことが多いです。  \n\u003e このあたりを軽減するための package を `tinygo.org/x/drivers/image` に作っていますがまだ release されていません。\n\n## SPI / ILI9341 ディスプレイ 2\n\n`SPI / ILI9341 ディスプレイ` では静止画の表示のみでした。ここでは少し動きを加えていきます。\n\n以下のソースに瞬きを実装しているのでベースのソースコードとして go ファイルを 2 つダウンロードしてください。\n\n* [./11_spi_ili9341](https://github.com/sago35/tinygo-workshop/tree/de94799a9c6182bbee778366472ca5061819de7e/11_spi_ili9341)\n    * [main.go](https://github.com/sago35/tinygo-workshop/tree/de94799a9c6182bbee778366472ca5061819de7e/11_spi_ili9341/main.go)\n    * [graphics.go](https://github.com/sago35/tinygo-workshop/tree/de94799a9c6182bbee778366472ca5061819de7e/11_spi_ili9341/graphics.go)\n\n上記ソースの状態で以下のようにして、目を閉じたり開いたりを実装しています。\n\n```go\n\tinitEyes()\n\n\tfor {\n\t\tdrawEye(display, 127, 91, eyeOpen)\n\t\tdrawEye(display, 181, 91, eyeOpen)\n\t\ttime.Sleep(1500 * time.Millisecond)\n\t\tdrawEye(display, 127, 91, eyeClose)\n\t\tdrawEye(display, 181, 91, eyeClose)\n\t\ttime.Sleep(300 * time.Millisecond)\n\t}\n```\n\nここに対して以下を実装してみましょう。普通に実装しても良いですが、瞬きの時間管理とキー操作の管理を goroutine で分けると組込みでも Go が使えるのか、という実感がわくと思います。\n\n* 上下左右キーで目線を動かす (GPIO の例を参考に)\n* 一定時間で瞬きする\n\n実際のコードは以下です。\n\n* [./11_spi_ili9341/main.go](./11_spi_ili9341/main.go)\n\nコードの抜粋は以下です。 goroutine を使って瞬きを実現しています。 (もちろん、 goroutine を使わずに実現することもできます)\n\n```go\n\tinitEyes()\n\n\tmachine.WIO_5S_UP.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\tmachine.WIO_5S_LEFT.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\tmachine.WIO_5S_RIGHT.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\tmachine.WIO_5S_DOWN.Configure(machine.PinConfig{Mode: machine.PinInputPullup})\n\n\tredraw := true\n\txofs := int16(0)\n\tyofs := int16(0)\n\teye := eyeClose\n\teyeCh := make(chan struct{}, 1)\n\tgo func() {\n\t\tfor {\n\t\t\teyeCh \u003c- struct{}{}\n\t\t\ttime.Sleep(1500 * time.Millisecond)\n\t\t\teyeCh \u003c- struct{}{}\n\t\t\ttime.Sleep(300 * time.Millisecond)\n\t\t}\n\t}()\n\n\tfor {\n\t\tif !machine.WIO_5S_UP.Get() {\n\t\t\tif 0 \u003c yofs {\n\t\t\t\tyofs--\n\t\t\t\tredraw = true\n\t\t\t}\n\t\t} else if !machine.WIO_5S_LEFT.Get() {\n\t\t\tif -4 \u003c xofs {\n\t\t\t\txofs--\n\t\t\t\tredraw = true\n\t\t\t}\n\t\t} else if !machine.WIO_5S_RIGHT.Get() {\n\t\t\tif xofs \u003c 7 {\n\t\t\t\txofs++\n\t\t\t\tredraw = true\n\t\t\t}\n\t\t} else if !machine.WIO_5S_DOWN.Get() {\n\t\t\tif yofs \u003c 20 {\n\t\t\t\tyofs++\n\t\t\t\tredraw = true\n\t\t\t}\n\t\t}\n\n\t\tselect {\n\t\tcase \u003c-eyeCh:\n\t\t\tif eye == eyeOpen {\n\t\t\t\teye = eyeClose\n\t\t\t} else {\n\t\t\t\teye = eyeOpen\n\t\t\t}\n\t\t\tredraw = true\n\t\tdefault:\n\t\t}\n\n\t\tif redraw {\n\t\t\tdrawEye(display, 127+xofs, 91+yofs, eye)\n\t\t\tdrawEye(display, 181+xofs, 91+yofs, eye)\n\t\t\tredraw = false\n\t\t}\n\t\ttime.Sleep(50 * time.Millisecond)\n\t}\n```\n\n## WiFi\n\n![image.png](./images/12.png)\n\nWio Terminal には Realtek 社の RTL8720DN という WiFi / BLE に対応したチップが搭載されています。 TinyGo からもそのチップを使ってネットワークに接続したいですが、通常の Go の net/http package は大きすぎるため使用できません。そこで、機能制限がありますが TinyGo で使用できる Version を以下に作成しています。\n\n* https://pkg.go.dev/tinygo.org/x/drivers@v0.17.1/rtl8720dn\n\nRTL8720DN を使うためには、最初に firmware の Version Up が必要です。後述の手順に従い Version Up を実施してください。\n\nWiFi の例はコードが非常に長くなるため省略しますが、以下のようにアクセスすることができます。基本的な機能 (`http.Get()` や `http.Post()` など) は Go の標準 package と同じように使うことができます。以下はまだ release branch には merge されていないため `go get tinygo.org/x/drivers@dev` を実行し dev branch を使用するように変更してください。\n\n```go\nres, err := http.Get(url)\nres, err := http.Post(url, \"application/json\", body)\n\nreq, err := http.NewRequest(method, url, body)\nres, err := http.Do(req)\n```\n\ncookie も扱うことができます。\n\n```go\nimport \"tinygo.org/x/drivers/net/http/cookiejar\"\n\njar, err := cookiejar.New(nil)\nif err != nil {\n\treturn err\n}\nclient := \u0026http.Client{Jar: jar}\nhttp.DefaultClient = client\n\nres, err := http.Get(url)\n```\n\n[./09_webclient](./09_webclient) には HTTP アクセスを行う例があります。 10 秒毎に 1 回 `http://tinygo.org` にアクセスして結果を返します。 ssid と password を変更することで、自身の WiFi アクセスポイントに接続してください。 2.4GHz でも 5GHz でも接続可能です。\n\n[./10_webserver](./10_webserver) は Wio Terminal を Web Server にしてブラウザ経由で操作することができます。以下のような画面で LED の ON / OFF などを試すことができます。 ssid と password を変更することを忘れずに。 Wio Terminal の IP アドレスは USB-CDC 経由で表示させることができます。起動後 5 以内に USB-CDC メッセージを受信できるようにしておいてください。\n\n![image.png](./images/13.png)\n\n`/6` にアクセスすると以下のようにテトリスで遊ぶことができます。左右キーとスペースキーで操作できます。このテトリスは [たった464文字のテトロミノ落ち物パズル！創る力を拡大しよう、高専インカレ＆PCNサミットオンライン] (https://fukuno.jig.jp/3267) で紹介されていたものです。 Wio Terminal は実質的には js ファイルを serve しているだけでゲームには関わっていません。 (ゲーム自体は、アクセスした PC 側で処理されています)\n\n![image.png](./images/14.png)\n\nその他の例は以下にあるので色々と試してみてください。ソースコード内の ssid と password を設定するのを忘れずに。\n\n* https://github.com/tinygo-org/drivers/tree/dev/examples/rtl8720dn\n\n### RTL8720DN firmware の Version Up\n\n以下に従い Version Up を行います。\n\n* https://wiki.seeedstudio.com/Wio-Terminal-Network-Overview/\n\n#### Windows\n\n最低限のコマンドを記載します。これでうまくいかない場合は上記の Wiki に詳細があるので確認してください。\n\n```\n$ cd %USERPROFILE%\n$ git clone https://github.com/Seeed-Studio/ambd_flash_tool\n$ cd ambd_flash_tool\n$ .\\ambd_flash_tool.exe erase\n$ .\\ambd_flash_tool.exe flash\n```\n\n#### Linux\n\n最低限のコマンドを記載します。これでうまくいかない場合は上記の Wiki に詳細があるので確認してください。\n\n```\n$ cd ~\n$ git clone https://github.com/Seeed-Studio/ambd_flash_tool\n$ python3 ambd_flash_tool.py erase\n$ python3 ambd_flash_tool.py flash\n```\n\n# Bluetooth LE\n\n(現時点の TinyGo は BLE に対応していません)\n\n# まとめ\n\nこれでハンズオンは終了となります。開発環境の立ち上げから printf debug までを体験してもらい、その後外部 package の使い方を体験してもらいました。 Wio Terminal はネットワークにもアクセスできるため色々な題材に使うことができます。是非色々なものを作ってみてください。\n\n* https://tinygo.org/\n    * https://tinygo.org/docs/reference/microcontrollers/wioterminal/\n* https://wiki.seeedstudio.com/Wio-Terminal-Getting-Started/\n* https://www.seeed.co.jp/\n* [Wio Terminal で TinyGo プログラミングを始めよう](https://qiita.com/sago35/items/92b22e8cbbf99d0cd3ef)\n* [TinyGo + 'VSCode or Vim (もしくはそれ以外の LSP 対応エディタ)' で gopls 連携する方法](https://qiita.com/sago35/items/c30cbce4a0a3e12d899c)\n* [TinyGo + Vim で gopls するための設定](https://qiita.com/sago35/items/f0b058ed5c32b6446834)\n\n# よくある質問\n\n## JSON はどうやって扱うの？\n\nTinyGo は現状 reflect package のサポートが十分ではないため encoding/json は限定的にしか使えません。\nJSON 関連は、以下の package を使うと良いです。\n\n* Unmarshal\n    * https://github.com/tidwall/gjson\n    * https://github.com/buger/jsonparser\n* Marshal\n    * https://github.com/moznion/go-json-ice\n\n# LICENSE\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsago35%2Ftinygo-workshop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsago35%2Ftinygo-workshop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsago35%2Ftinygo-workshop/lists"}