Home button

RasPiOS_UnityConsole

Raspberry Pi 4 / 5 を Unity 製ゲームを遊ぶためのゲーム機にするオリジナル OS イメージ （pi-gen / arm64 / Raspberry Pi OS Lite（Debian trixie）ベース）。 Unity の Linux (x86_64) ビルドを box64 で動かし、 USB メモリの「ゲームカセット」を挿すだけで SD カードへ自動インストールする。

License: CC BY-SA 4.0（同梱フォント等は対象外） © ラジアン（柏木主税） / RadianN_kswg

特長

画面

いちばん上の画像は実機の HDMI 出力。下の画像は同じランチャーを Pi 上でオフスクリーン描画したもので、 ソフト名・メッセージ・空き容量は表示例。

ソフトメニュー	終了確認（ホームボタン短押し）
ソフトが多いとき（横スクロール）	Bluetooth ペアリング
ソフトが無いとき

• 640×360 の論理解像度で描き、画面に収まる最大の整数倍で拡大する（1280×720 なら2倍、1920×1080 なら3倍）ので、ドットが崩れない。
• ソフトは横並びのブロック（文字はソフト名の頭文字）。右上のブロック列は SD 全体に対する空き容量（16段）。
• 見出しは「ヘッドアップデイジー」、本文は「マルモニカ」。どちらも 患者長ひっく さんの ゼロピクセルフリーフォント。
• SFC・PS・SEGA 世代のゲーム機本体画面を参考に3案を作って比べ、32ビット CD-ROM 世代風の「ディスク・ブラウザ」案を採用した。

はじめかた

1. Releases から *.img.xz をダウンロードする （SHA256 はリリースノートに記載）。自分でビルドする場合は docs/build.md。
2. Raspberry Pi Imager の「カスタムイメージを使う」で microSD（16GB 以上）へ書き込む。 Imager の OS カスタマイズ（ユーザー名・Wi-Fi 等）は使わない。
3. Pi に microSD を挿し、HDMI とゲームパッド（またはキーボード）をつないで電源を入れる。 初回はパーティション拡張のために一度自動で再起動し、約1分半でランチャーが出る。
4. 初期アカウントは player / player で、SSH が有効。有線 LAN などのネットワークにつなぐ前に、 Type-C で PC とつないで ssh player@10.89.0.1 で入り、passwd でパスワードを変える （USB リンクの詳細）。

Unity アプリの作り方

1. Unity で Linux (x86_64) 向けにビルドする（Unity Personal で可）。
2. ビルド一式をフォルダ（または zip）にまとめる。フォルダ名がアプリ ID になる。

MyGame/
  MyGame.x86_64        ← 実行ファイル（必須・1つ）
  MyGame_Data/
  UnityPlayer.so
  game.json            ← 任意（表示名と起動引数）

{"name": "表示名", "args": ["-screen-fullscreen", "1", "-screen-width", "960", "-screen-height", "540"]}

アプリの入れ方

A. USB メモリ（ゲームカセット） — USB メモリのルートに UnityGames/ フォルダを作り、 ビルドフォルダか zip を置いて本体の USB ポートに挿す。SD へ自動でインストールされ、ランチャーに通知が出る。 導入済みの同名アプリはスキップするので、挿しっぱなしでもよい。どのポートに挿してもよい （既定では青い USB 3.0 ポートも USB 2.0 として動かす。理由）。

B. Type-C ケーブル（PC から転送） — 本体の Type-C 端子と PC をつなぐと、PC にシリアルポートが現れる。

pip install pyserial
python tools/send-app.py COM5 MyGame.zip        # Linux なら /dev/ttyACM0

C. SSH — 同じ Type-C 接続で ssh player@10.89.0.1 に入れる。ファイルを置いて ucon-install <zip|フォルダ> でも導入できる。

操作

ソフトを決定すると「起動 / USBメモリへバックアップ(退避) / 削除 / 戻る」を選べる。 ゲームパッドのボタン番号の割り当ては機種によって異なる（ボタン0 が A、ボタン1 が B）。 パッドは起動後の接続や抜き差しにも対応する（ランチャーが挿さった 1 台だけを開き直す）。 アナログスティックは倒した瞬間だけ 1 回動く（閾値 0.6 / 復帰 0.35 のヒステリシス）ので、 摩耗して値が揺れるスティックでもカーソルが走らない。

ゲーム側（Unity）のパッド入力: X にウィンドウマネージャが無くゲームの窓がフォーカスを得ないため、 ucon-run-app が SDL_JOYSTICK_ALLOW_BACKGROUND_EVENTS=1 を付けて起動する（Unity の Linux プレイヤーはパッドを SDL で読み、 既定ではフォーカスの無い窓のパッド入力を捨てる）。Input System を使うゲームはさらに InputSystem.settings.backgroundBehavior = IgnoreFocus にしておく（NTsWallpaperEngine で実機確認済み）。

ゲーム側のキーボード入力: WM が無い X では入力フォーカスが None のままでキー入力がどの窓にも配送されないため、 ucon-run-app が起動後（2 / 15 / 45 秒）に X の入力フォーカスを PointerRoot にする。 ポインタ下の窓＝全画面のゲームへキーが流れるようになる（2026-09-21 に仮想キーボードで実測。 設定前はキーが完全に無反応で、PointerRoot にした瞬間に届いた）。

なお X のキーボード自動リピート（既定 660ms / 25回毎秒）は「離上＋押下」の連打として届くので、 ゲーム側で長押しを判定するときは離上を少し様子見すること（NTsWallpaperEngine は 0.15 秒）。

対応ハードウェアと検証状況

box64 によるエミュレーションなので CPU 負荷は高く、重い 3D ゲームは厳しい。 USB メモリは「ゲームカセット」として使うため、USB メディアからの起動とは併用しない。

ドキュメント

• docs/build.md — イメージのビルド（WSL2 を含む）とステージ構成
• docs/maintenance.md — USB リンク、ファイルだけの更新、カセットと退避の仕組み、本体内のパス、既知の注意点
• docs/home-button.md — ホームボタン基板と JLCPCB 発注
• docs/gpio.md — GPIO 拡張（設計段階）。本体は MIT のサブモジュール lib/RasPiLib_UnityGpio/

リポジトリ構成

config                     pi-gen 設定（arm64 / trixie / STAGE_LIST）
build-image.sh             ビルドラッパー（pi-gen の取得 → 独自ステージ同期 → ビルド）
stage-unityconsole/
  00-base/                 パッケージ(X/GL/pygame/git 等)・config.txt・ディレクトリ・権限
  01-box64/                box64 の導入
  02-gadget/               Type-C USB ガジェット（NCM + ACM）・dnsmasq・シリアル受信
  03-cartridge/            USB カセット自動インストール・退避 CLI
  04-launcher/             ランチャー（キオスク X セッション）と同梱フォント
  05-purge-cloud-init/     cloud-init の除去（必ず最後）
lib/RasPiLib_UnityGpio/    GPIO 拡張の本体（サブモジュール・MIT。設計段階）
tools/send-app.py          PC 側のアプリ転送ツール（pyserial）
hardware/home-button/      ホームボタン基板（KiCad 10）と JLCPCB 発注データ
docs/                      ドキュメントと画面画像

ライセンス

本リポジトリの独自制作物（ビルド構成・スクリプト・ランチャー・PC 側ツール・ホームボタン基板の設計データ・ ドキュメント・画面デザインと画面画像）は Creative Commons 表示 - 継承 4.0 国際 (CC BY-SA 4.0) で公開しています。ライセンス正文は LICENSE を参照してください。 改変したものを公開するときは、同じ CC BY-SA 4.0（または互換ライセンス）で公開してください。

著作者（ライセンス主）: ラジアン（柏木主税） / RadianN_kswg

利用時のクレジット表記例:

RasPiOS_UnityConsole by ラジアン（柏木主税） / RadianN_kswg
CC BY-SA 4.0 https://creativecommons.org/licenses/by-sa/4.0/

同梱物・サードパーティ

• フォント（stage-unityconsole/04-launcher/files/fonts/ の x12y16pxMaruMonica.ttf と x14y24pxHeadUpDaisy.ttf） — © hicc（患者長ひっく）、ゼロピクセルフリーフォント。 CC BY-SA 4.0 の対象外で、作者の独自ライセンス（ソフトウェアへの同梱・再配布・商用利用は可、 フォント単体の販売は不可など）に従います。要約は fonts/README.md、 正式な規約は配布サイトを参照してください。
• lib/RasPiLib_UnityGpio/（サブモジュール）は別リポジトリ RasPiLib_UnityGpio の内容で、 CC BY-SA 4.0 の対象外です。MIT ライセンスに従います（同ディレクトリの LICENSE を参照）。
• ビルド基盤 pi-gen（BSD 3-Clause）は本リポジトリに含まれず、 ビルド時に build-image.sh が取得します。
• box64（MIT）は本リポジトリに含まれず、ビルド時に box64-debs から OS イメージへ導入されます。
• ビルドで生成される OS イメージには Raspberry Pi OS / Debian の各パッケージが含まれ、それぞれのライセンス （GPL ほか）に従います。CC BY-SA 4.0 が適用されるのは本リポジトリ収録の独自制作物のみです。 パッケージの一覧は各リリースに添付する .info ファイルにあり、ソースコードは Debian と Raspberry Pi のアーカイブ（apt-get source <パッケージ名>）から入手できます。
• 「Unity」は Unity Technologies、「Raspberry Pi」は Raspberry Pi Ltd の商標です。 本プロジェクトはいずれとも関係のない非公式のプロジェクトです。

クレジット

• 患者長ひっく（hicc）さん — ランチャーのピクセルフォント（ゼロピクセルフリーフォント）。
• Claude（Anthropic） — Cowork の Agent 機能による設計・実装・実機デバッグ支援、Claude Design による画面デザイン案の作成。