Introduction to the event 'TinyGo Keeb Tour uot;

This article introduces an event held in Japan. This is basically a translation of the following post, originally written in Japanese, into English.

https://sago35.hatenablog.com/entry/2024/10/29/095629

What is the TinyGo Keeb Tour 2024?

The TinyGo Keeb Tour 2024 is a hands-on workshop event combining TinyGo and DIY keyboards. Participants spend the morning soldering, followed by a software hands-on session in the afternoon. Don’t worry if you’re new to soldering—tools are provided, and staff are on hand to help.

It's exciting to see a keyboard you've built yourself working on a computer! The project for the event is the zero-kb02 macro pad (12 keys joystick rotary encoder display). Besides functioning as a keyboard or macro pad, it can also serve as a development board for TinyGo with additional ports for various uses. With one of these, you can enjoy a variety of projects.

Follow event information on Connpass:

https://tinygo-keeb.connpass.com/

Workshop materials and build guides are available here:

https://github.com/sago35/tinygo_keeb_workshop_2024

For support and communication before, during, and after the event, join us on Discord:

https://discord.gg/GKFsRXNRsX

The Beginning

On June 13, 2024, this tour started with a small team: micchie, ysaito, taknb2nch, and sago35. Many more staff members joined in as the project grew—thanks to everyone for their hard work!

The first kickoff meeting was scheduled for July 1, 2024. Before that date, we focused on designing and ordering the PCBs, with the current version finalized by June 16. The PCB design includes a matrix layout, and we ensured a display was included to make it fully enjoyable with TinyGo.

Traveling Across Regions

The 2024 tour covered four regions:

August 4, 2024 - Kobe with KOBE.go

Our first event! After deciding on the Kanto event on August 26, we organized a trial run in Kobe without soldering. We gathered at a hack bar, enjoyed drinks, and dived into the hands-on workshop, establishing a good flow for future sessions.

<script> // Detect dark theme var iframe = document.getElementById('tweet-1812817785573232674-192'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1812817785573232674&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1819986841254461926-188'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1819986841254461926&theme=dark" } </script>

August 26, 2024 - Kanto with Women Who Go Tokyo

This event included soldering. We found a suitable venue and borrowed equipment like soldering irons from HAKKO and nanbuwks. Despite being new to teaching soldering, we managed successfully.

There was also a session covering the basics of DIY keyboards.

While working through the hands-on activities, participants were free to create whatever they wanted, resulting in some interesting projects.

By the second stop on the tour, we had an official T-shirt. The design features a very long gopher holding an ISO Enter key and a soldering iron—such a cool design!

With knowledge accumulated from the first two events, the Sendai session went smoothly. The tour merchandise was expanded to include a tour towel—quite impressive!

The soldering process went well, with significant improvements in the steps and documentation based on KPT feedback from previous events. Although there were a few minor issues, things progressed smoothly.

<script> // Detect dark theme var iframe = document.getElementById('tweet-1812817785573232674-192'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1812817785573232674&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1819986841254461926-188'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1819986841254461926&theme=dark" } </script>We also enjoyed a traditional Imoni-kai (potato stew party)—it was delicious!<script> // Detect dark theme var iframe = document.getElementById('tweet-1820110456859812118-145'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1820110456859812118&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1827570363586507013-23'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1827570363586507013&theme=dark" } </script><script> // Detect dark theme var iframe = document.getElementById('tweet-1827630059580231788-223'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1827630059580231788&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1827623944167243924-715'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1827623944167243924&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1827490483171684527-794'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1827490483171684527&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1844911820097847705-733'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1844911820097847705&theme=dark" } </script>

In Sendai, participants created a variety of interesting projects, as expected.

The addition of the tour towel made for some fantastic photos.

October 26, 2024 - Fukuoka with Kizuku.go

Participants mainly followed the build guide on their smartphones or other small devices while working.

Even if there were any mistakes, the staff was ready to rework them, so participants could feel at ease!

We also showcased a new MIDI functionality demo specifically for the Fukuoka event. Afterward, we ended up having a spontaneous MIDI session, practically forgetting about the keyboard hands-on workshop!

To wrap up, we took a final group photo to commemorate the tour.

<script> // Detect dark theme var iframe = document.getElementById('tweet-1812817785573232674-192'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1812817785573232674&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1819986841254461926-188'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1819986841254461926&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1820110456859812118-145'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1820110456859812118&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1827570363586507013-23'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1827570363586507013&theme=dark" } </script> What is the zero-kb02 Hardware Used in the Tour? <script> // Detect dark theme var iframe = document.getElementById('tweet-1827630059580231788-223'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1827630059580231788&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1827623944167243924-715'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1827623944167243924&theme=dark" } </script>The zero-kb02 is a 12-key macro pad specifically designed for the TinyGo Keeb Tour 2024. It includes a rotary encoder and joystick, making it enjoyable for everyday use as a DIY keyboard or macro pad. It also features a screen, allowing it to function as a development board for TinyGo.<script> // Detect dark theme var iframe = document.getElementById('tweet-1827490483171684527-794'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1827490483171684527&theme=dark" } </script> <script> // Detect dark theme var iframe = document.getElementById('tweet-1844911820097847705-733'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1844911820097847705&theme=dark" } </script>As a demo, we’re developing a 2D game engine called Koebiten.<script> // Detect dark theme var iframe = document.getElementById('tweet-1844920215051829758-683'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1844920215051829758&theme=dark" } </script>

For more details on zero-kb02, including the actual PCB data, check here. Since it's open-source, you’re free to order it yourself or 3D print a case.

sago35 / keyboards

keyboards

This repository was created to manage the circuitry and firmware for the keyboards I designed.

The firmware is created using sago35/tinygo-keyboard.

sg24

kicanvas

zero-kb02/

kicanvas
case (stl / 3mf)
workshop - https://github.com/sago35/tinygo_keeb_workshop_2024

pinout

<script> // Detect dark theme var iframe = document.getElementById('tweet-1812817785573232674-192'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1812817785573232674&theme=dark" } </script>

Name	Pin	Info
VR_BTN	machine.GPIO0	InputPullup
WS2812	machine.GPIO1	Output
ROT_BTN1	machine.GPIO2	InputPullup
ROT_A1	machine.GPIO3	InputPullup
ROT_B1	machine.GPIO4	InputPullup
COL1	machine.GPIO5	Output
COL2	machine.GPIO6	Output
COL3	machine.GPIO7	Output
COL4	machine.GPIO8	Output
ROW1	machine.GPIO9	InputPulldown
ROW2	machine.GPIO10	InputPulldown
ROW3	machine.GPIO11	InputPulldown
SDA0_TX0	machine.GPIO12	I2C SDA
SCL0_RX0	machine.GPIO13	I2C SCL
EX01	machine.GPIO14	GPIO
EX02	machine.GPIO14	GPIO
EX03	machine.GPIO14	GPIO / ADC
EX04	machine.GPIO14	GPIO / ADC
VR_Y	machine.GPIO28	ADC
VR_X	machine.GPIO29	ADC

View on GitHub

The Nature of a Tour

Since this is a multi-event tour with the same theme, we’ve been able to gradually improve various aspects over time. For example, we’ve added notes to highlight common soldering mistakes and clarified the front and back sides of the PCB to prevent confusion. We also addressed questions like “How can I display Japanese fonts on the screen?” by adding relevant instructions to the workshop materials.

Contributions

The event has inspired contributions to both the TinyGo core and the hands-on workshop materials, which is fantastic.

• TinyGo Core
  https://github.com/tinygo-org/tinygo/issues/4519
• Hands-On Materials
  https://github.com/sago35/tinygo_keeb_workshop_2024/pulls?q=is:pr is:closed

Upcoming Plans

Planning an Online Event for Year-End

We’d like to hold an online event by the end of the year for people who already own a zero-kb02 or those interested in TinyGo embedded development. Stay tuned!

Interested in Hosting an Event in Your Area?

We’re looking for locations to host events in 2025 and beyond. If you’re interested, please reach out to the staff (micchie, ysaito, sago35, etc.). If there’s a local Go community, we’d love to collaborate with them as well.

Currently, the approach is to let local organizers handle venue selection. Events without soldering are possible (like the initial event in Kobe), but soldering is preferred if possible.

The TinyGo Keeb Tour Continues in 2025

The first event of 2025 is scheduled for January 13 in Takamatsu, Kagawa. We’re also considering additional locations as shown below.

TinyGo Conf!

We’re also planning a TinyGo event called TinyGo Conf in Japan.

In Closing

Thank you to all participants, the staff, and especially micchie, ysaito, and taknb2nch for starting this tour. We look forward to TinyGo Keeb Tour 2025!

Links

TinyGo Keeb Tour on Connpass (ha
Workshop Guide on GitHub
TinyGo
Create Your Own Keyboard with sago35/tinygo-keyboard

<script> // Detect dark theme var iframe = document.getElementById('tweet-1812817785573232674-192'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1812817785573232674&theme=dark" } </script>

The above is the detailed content of Introduction to the event 'TinyGo Keeb Tour uot;. For more information, please follow other related articles on the PHP Chinese website!