First step to PicoRuby

入門以前から始める PicoRuby のあそび方
2025.07.19. PicoRuby Overflow会議

1. 入門以前から始める PicoRuby のあそび方 @makicamel PicoRuby Overflow会議 2025.07.19
2. 自己紹介 @makicamel / 川原万季 Ruby とビール とお酒が好き 好きな言葉は「エイってやってバーン」 PicoPicoRuby始めました https://picopicoruby.connpass.com/ PicoRuby・電子工作歴 1 ヶ月 ピカピカの初心者
3. 自己紹介 電車でRuby! コーナーあります PicoRuby で操作できるプラレール 遊んでいってください
4. RubyKaigi 2025 Lightning Talk 　　Road to RubyKaigi: Making Tinny Chiptunes with Ruby 　https://rubykaigi.org/2025/presentations/lt/
5. RubyKaigi 2025 Lightning Talk Road to RubyKaigi Rubyist による Rubyist のための Ruby 製のゲーム ターミナル上で遊ぶ横スクロールアクションゲーム バグを倒し〆切から逃れて RubyKaigi 参加を目指す 　　Road to RubyKaigi: Making Tinny Chiptunes with Ruby 　https://rubykaigi.org/2025/presentations/lt/ 　　Road to RubyKaigi 　https://github.com/makicamel/road_to_rubykaigi
6. RubyKaigi 2025 Lightning Talk Ruby で音を作って鳴らすお話をした 音は波 波形データをつくって オーディオ API に渡すと 音が鳴らせる 　　Road to RubyKaigi: Making Tinny Chiptunes with Ruby 　https://rubykaigi.org/2025/presentations/lt/ 　　Road to RubyKaigi 　https://github.com/makicamel/road_to_rubykaigi
7. Road to RubyKaigi デモ 　　Road to RubyKaigi 　https://github.com/makicamel/road_to_rubykaigi
8. Road to RubyKaigi
9. PicoRuby 　　PicoRuby 　https://github.com/picoruby/picoruby
10. PicoRuby 軽量 Ruby 実装 マイコンで動作する @hasumikin さん作 　PicoRuby 　https://github.com/picoruby/picoruby
13. 電子工作未経験
14. 電子工作未経験 ゴールまでの道筋が見えない 何をどうしたら音が鳴るんです？ 常識がない とりあえず強い電圧かけたらいいんじゃないですか？(｡∀゜) 知らない単語・概念がとにかく多い シリアル通信、ボーレート、GPIO、入出力ピン...
15. 電子工作未経験 ...というひとが音の鳴る小さなデバイスをつくった話をします トークのゴール 初心者: 電子工作概観のイメージがわかる ベテラン: 「初心者はこんなことがわからないんだ」という気づき
16. つくってみよう Road to RubyKaigi の音を鳴らすだけのデバイス ゲーム丸ごと作るのはステップとして大きすぎる 波形データは前に作ったのでできそうな気がする 音を鳴らすと楽しい
17. 目次 概観を眺める 1. PicoRuby のあそび方 2. 初心者のふりかえり 3.
18. 目次 概観を眺める 1. PicoRuby のあそび方 2. 初心者のふりかえり 3.
19. 概観図
20. 概観図 1. 電池
21. 概観図 1. 電池 電圧 3V Raspberry Pi Pico の起動には約 3V 必要[^1] 単三電池はだいたい 1 本 1.5V 2 本直列でつないだら 3V 今回はリチウム電池を使用 小さい基盤に乗せたかったので [^1]: 訂正追記 1.8V から動作します
22. 概観図 2. スイッチ
23. 概観図 2. スイッチ 回路の開閉をする 閉じていると回路がつながっている Raspberry Pi Pico に電源が供給される 開いていると回路が切断されている Raspberry Pi Pico に電源が供給されない デバイス電源の ON / OFF 切り替えに使用
24. 概観図 3. 抵抗
25. 概観図 3. 抵抗 電源からパーツやマイコンに流す電流を制限する 電流が大きすぎるとパーツなどを破壊する パーツには定格電流がある 抵抗を利用して適切な電流を流す 定格電流はパーツのデータシートに記載がある
26. 概観図 3. 抵抗 抵抗値はオームの法則で求める V = IR 電圧(V) = 電流(A) * 抵抗(Ω) e.g. 電源電圧が3V、流したい電流が30mA、スピーカーの抵抗が 15Ω ・ 3V = 0.03A * (R + 15) Ω ・ R = 3 / 0.03 - 15 　 => 85Ω ・ 85Ωの抵抗が必要 → 100Ωの抵抗を使う
27. 概観図 3. 抵抗 抵抗の抵抗値はカラーコードから読み取る ref. 抵抗のカラーコード計算機 https://akizukidenshi.com/catalog/pages/reg-calc.aspx 判別むずすぎ問題 赤と茶、青と黒... テスターでも確認可
28. 概観図 4. Raspberry Pi Pico
29. 概観図 4. Raspberry Pi Pico 波形データを作り電気信号として出力する PicoRuby でプログラミングできる
30. 概観図 4. Raspberry Pi Pico Raspberry Pi Pico マイコンボード RP2040 搭載 USB で電源供給とプログラム書き込み可 　Raspberry Pi Pico 　https://www.raspberrypi.com/products/raspberry-pi-pico/
31. 概観図 4. Raspberry Pi Pico Raspberry Pi Pico マイコンボード RP2040 搭載 USB で電源供給とプログラム書き込み可 RP2040 マイコンチップ 　Raspberry Pi Pico 　https://www.raspberrypi.com/products/raspberry-pi-pico/
32. 概観図 4. RP2040（Raspberry Pi Pico） 7㎟ に CPU・メモリ・ペリフェラルなどがつまっている ペリフェラル: 機能専用ハードウェア デジタル I/O PWM 通信インターフェース etc 　RP2040 　https://www.raspberrypi.com/products/rp2040/
33. 概観図 4. RP2040（Raspberry Pi Pico） PWM モジュール Pulse Width Modulation 一定の周波数・電圧 High の比率で 信号を生成する e.g. モーター制御 - 平均電圧を変えて回転数を制御 e.g. 赤外線リモコン - 赤外線信号パターンを指定
34. 概観図 4. RP2040（Raspberry Pi Pico） PWM モジュール PicoRuby で波形データを生成 # PWMモジュールで0.5秒ずつド,レ,ミの波形データを生成する require 'pwm' pwm = PWM.new(0, duty: 50) [262, 294, 330].each do |frequency| # ド,レ,ミの周波数 pwm.frequency(frequency) t = Time.now while (Time.now - t) < 0.5; end # 0.5秒ビジーループさせる end
35. 概観図 5. スピーカー
36. 概観図 5. スピーカー 音声出力装置 PWM モジュールで生成した波形データを電気信号として入力する
37. 概観図 完成
38. 目次 概観を眺める 1. PicoRuby のあそび方 2. 初心者のふりかえり 3.
39. PicoRuby のあそび方 1. Raspberry Pi Pico を USB でパソコンとつなぐ 2. R2P2[^2]を Raspberry Pi Pico にインストール 最新リリースから uf2 ファイルをダウンロードしてドラッグ & ドロップで完了 3. シリアル通信で接続 mac だと `TERM=vt100 screen /dev/tty.usbmodem*` 4. シェル起動 [^2]: PicoRuby 用シェルシステム 　https://github.com/picoruby/R2P2
40. PicoRuby のあそび方 irb `puts 'Hello, PicoRuby!'` /home/app.rb このパスにファイルを置くと Raspberry Pi Pico 起動時に実行される ドキュメント https://picoruby.github.io/
41. PicoRuby のあそび方 irb で遊んでいると Out of Memory に遭遇しやすい Raspberry Pi Pico のメモリは 256KB ref MacBook Pro (M3 Pro) のメモリは 32GB 1 / 125000 大きなオブジェクト生成は避けたほうがよい
42. PicoRuby のあそび方 Road to RubyKaigi の BGM 元実装は配列を value としたハッシュの配列 メロディー 1 音、ベース 2 音 このままだとメモリ足りないかも
43. PicoRuby のあそび方: データ圧縮 使用する音程は 2 オクターブ 14 音 + 休符の 15 音 2^4 => 16 なので 1 音を 4bit（16 進数 1 文字）で表してデータ圧縮する 音程に番号を割り当て 16 進数で表す e.g. E4 → 2（10 進数） → 0x2（16 進数） NOTE_MAPPING = { C4: 0, D4: 1, E4: 2, F4: 3, A4: 5, B4: 6, REST: 4, # ... }
44. PicoRuby のあそび方: データ圧縮 音階を 16 進数の配列に変換 e.g. [C4, D4, E4] → [0x0, 0x1, 0x2] 左シフトしてひとつの Integer にする e.g. [0x0, 0x1, 0x2] → 0x210（16 進数） → 528（10 進数） 小さくなった！
45. PicoRuby のあそび方: データ圧縮 音の長さも同様に圧縮 十六部音符: 0, 八分音符: 1, 四分音符: 2 エンコードした Integer をコードに埋め込み SCORES = [ { notes: [45589323163098, 120693318330058, ...] }, # メロディー { notes: [72588760057059, 72588760057059, ...] }, # ベース 1 { notes: [85991239857509, 85991239857509, ...] }, # ベース 2 ]
46. PicoRuby のあそび方: データ圧縮 再生時にデコード DECODER = Proc.new do |packed, shift| # 音程インデックスと音の長さをセットで取り出す index_duration = (packed >> (shift * NOTE_BITS)) & 0b111111 # デコード時は右シフト [ NOTE_MAPPING[index_duration & 0b1111], # 音程の番号 0.25 * 2 ** ((index_duration >> FREQUENCY_BITS) & 0b11) # 音の長さ ] end 無事音が鳴った 　　https://github.com/makicamel/picoruby-phrase/blob/main/player.rb
47. 目次 概観を眺める 1. PicoRuby のあそび方 2. 初心者のふりかえり 3.
48. 初心者のふりかえり 勢いよく進むタイプの話者が勢いよくハマってきたこととそのふりかえり
49. 初心者のふりかえり はんだづけが下手 正しい回路のはずなのに電圧が低い はんだが溶けない・つかない やり直しすぎてランドが溶けて電導体が無 YouTube べんり How To Solder Electronic Component. Tutorial[^3] はとくにお勧め 自分のはんだづけがうまくいかない理由・対処法がわかる [^3]: https://www.youtube.com/watch?v=dQ7AUjb1tkA&t=1323s
50. 初心者のふりかえり はんだづけが下手 両面スルーホール基盤を使う 片面ノンスルーホール基盤は非初心者向け ブレッドボード基盤を使う ブレッドボードのように縦横にランドが繋がっている はんだづけ負担が減る
51. 初心者のふりかえり 配線が下手 よくわからないけどごちゃついている どう整理したらよいかわからない 対策 電源用配線は電源専用にして他の用途と混ぜない 電源、グラウンド、それ以外の色を決める 配線は短いほうがいい パーツの下をくぐらせるとメンテしづらいので避ける
52. 初心者のふりかえり 回路のデバッグができない 意図通り動かない時にどう調査したらよいかわからない 何はともあれテスターで確認 意図通りの電圧がきているか？ 配線が間違っているかも はんだづけがうまくできていないかも 電池がへたっているかも 意図通りに導通しているか？ PWM は電圧が変化するので電圧ではなく導通チェックする
53. 初心者のふりかえり 回路のデバッグができない 大きな故障箇所から範囲を狭めて問題箇所を探る プリントデバッグと一緒
54. 初心者のふりかえり とりあえず全部配線したけどうまく動かない どこに原因があるかさっぱりわからない とりあえず全部配線しない 1 ステップずつ確かに動作することを確認する 信頼のおけるものを積み上げる パーツが壊れている可能性もある プログラミングで単体テストするのと同じ
55. 初心者のふりかえり データシートが読めない 常用単語がわからない 読み方がわからない 何が書いてあるかわからない 欲しい情報を明確にしてから臨むとよさそう 定格電流 ピン番号 etc
56. 初心者のふりかえり パーツショップに何も調べず行く えっ、パーツの種類、多すぎ...？ 選び方がわからない 欲しい部品を事前に調べる 商品コードをメモしておくとスムーズ 見ているだけでも楽しいのは楽しい 詳しい人と行くと発見がたくさんあって楽しい 明日7月20日にアフターイベントやります
57. 初心者がハマらなかった穴 聞く人がいない 毎日 @youchan に相談していた マイコンボードの裏表からデバッグの仕方、通信プロトコルまで 物理デバイスは特に相談できる人がいたほうがいい コミュニティ naniwa.rb（大阪）　https://naniwarb.doorkeeper.jp/ PicoPicoRuby（東京） https://picopicoruby.connpass.com/ Twitter でつぶやくと拾ってくれるひともいるかも
58. Special Thanks @youchan
59. Happy Hacking!