SF32LB52向けArduboy2移植版¶

Arduboy2-SiFliとは¶

OpenSiFli/Arduboy2-SiFliは、SiFli開発環境向けにArduboy2ライブラリーをOpenSiFliが移植したものです。Arduboy2は、小型ゲーム機向けのアプリケーションモデルとして、フレームループ、ディスプレイバッファー、ボタン、スプライト、テキスト、オプションのサウンド制御を提供します。そのためSiFli移植版は、基板、ディスプレイ、入力、オーディオ、ビルド環境をSF32へ移したときに、Arduboy形式のゲームをどこまで維持できるかを検証する互換性テストとして役立ちます。

このリポジトリーはソフトウェアのリファレンスであり、完成したゲーム機や量産向けハードウェア設計ではありません。対象ボード、対応API、ビルド手順、再配布条件については、README、ソースツリー、サンプル、Issue履歴、ライセンスファイルを正式な情報源として扱ってください。このページはリファレンスに基づく設計判断を整理したものであり、リポジトリー内の実行手順に代わるものではありません。

このSF32移植版が役立つ理由¶

Arduboy形式のアプリケーションは、予測可能な描画ループ、小型のモノクロ/低解像度アセット、ボタン入力、オーディオのタイミング、厳密に制限されたメモリー予算など、組み込み製品に関する複数の設計要素を一度に試す小規模な題材です。このモデルをSF32へ移植すると、携帯ゲーム機、UIデモ機、教育機器など、ローカルで決定論的な操作を行う製品の初期リファレンスとして役立ちます。

その価値は、すべてのArduboyスケッチが変更なしで動くことではありません。移植によって明らかになる境界にあります。

• 対応するArduboy2 APIの範囲内であれば、ゲームの高レベルな更新、入力、描画、アセット処理は維持できます。
• 移植版では、元のハードウェアに暗黙的に依存していたディスプレイ、ボタン、オーディオ、タイミング、ストレージの前提を置き換える必要があります。
• AVRレジスター、Arduboy固有のピン、ディスプレイ転送、タイマー、EEPROM配置を直接制御するスケッチは、意図的な移植と、個別の回帰テストによる裏付けが必要です。

以上はエンジニアリング上の見通しであり、互換性を実測した結果ではありません。現在のOpenSiFliリポジトリーで確認し、選択したボードとコミットでの結果を記録してください。

目標、対象範囲、開始条件¶

このページでは、OpenSiFliのリファレンスから、再現可能なSF32ゲームまたはインタラクティブデモを作るまでの段階的な手順を示します。この移植版がすべてのArduboy2機能、すべてのArduboyゲーム、すべてのSF32ボードに対応することや、量産品質のディスプレイ/オーディオタイミングを実現することを主張するものではありません。また、サードパーティーのリポジトリーから複製したゲーム、フォント、画像、その他のアセットのライセンス権を定めるものでもありません。

目標: リポジトリーのサンプルまたは小規模なテストスケッチを実行できる、ソース管理されたArduboy2-SiFliのビルドを作成します。選定したディスプレイ/入力/オーディオ経路を実証し、より大きなゲームや製品への適用に進むべきか判断するための証跡を記録します。

対象読者: Arduinoツールを使用し、C/C++コードを確認し、SF32ボードへの書き込み、シリアル出力の読み取り、基本的なディスプレイ・入力・消費電力の測定を行えるファームウェア、ハードウェア、製品エンジニア。

開始前に、次のものを準備します。

• ArduinoCore-Zephyrのバリアントsf32lb52_devkit_lcd_sf32lb525uc6を使用するSF32LB52開発ボードと、以下に示す外付け周辺機器。READMEでは、ディスプレイ、ボタン、外付けEEPROM、オーディオの経路がSF32LB52ハードウェアで動作確認されたとしています。RGB LEDの経路も記載されていますが、テスト結果は示されていません。READMEは物理ボードのリビジョンを固定しておらず、OLEDモジュールの正確な型番も特定していません。
• 動作確認済みのArduino環境と、対応するOpenSiFliボードパッケージ。このバリアント名が示すのはソフトウェア上のボード設定とピンマップであり、すべてのSF32LB52-DevKit-LCD実機がプロジェクトの外部配線に適合することを保証するものではありません。周辺機器を接続する前に、実機の回路図を確認してください。
• Arduboy2-SiFliの正確なコミット、Arduinoコア/パッケージのバージョン、ホストOS、書き込みツール。
• USBデータ接続、およびシリアルログを取得してディスプレイ、ボタン、オーディオ出力を確認する手段。
• 派生版に含めるすべてのゲーム、画像、フォント、サウンドアセットを使用/再配布する権利。

ハードウェアとソフトウェアの仕様¶

ハードウェア仕様¶

ソフトウェア仕様¶

サポート対象の基準構成を選ぶ¶

製品カタログから似たボードを選ぶのではなく、OpenSiFliリポジトリーで指定されたボードとソフトウェアの組み合わせを基準にします。ボードパッケージ、ディスプレイ配線、入力割り当て、書き込み方法、ライブラリーの前提条件も基準構成の一部です。

Arduboy2-SiFliリポジトリーには、ボードのピンマップをまとめた独立ファイルはありません。具体的な対応表はREADMEのSiFli I/O mapping tableに掲載されています。ライブラリー内部の論理ピン定義はpins_sifli.h、ボード固有の配線設定はArduinoCore-ZephyrのDevicetree overlayで確認できます。これらはソフトウェア上の基準構成であり、実機の検証済み構成を示すものではありません。配線前に、実際のボードリビジョンと回路図を照合してください。

リポジトリーにはソフトウェア上のボードバリアントと周辺機器のピンマップがあり、ディスプレイ、ボタン、外付けEEPROM、オーディオの経路がSF32LB52ハードウェアで動作確認されたと記載されています。外付けRGB LEDの経路も説明されていますが、テスト結果は示されていません。物理ボードのリビジョン、OLEDモジュール/コントローラーの正確な型番、アクセサリー一式も特定されていません。配線や再現可能なハードウェア基準を宣言する前に、バリアントのピンマップを実機の回路図と照合し、使用した部品とリビジョンを記録してください。不足情報を別のSF32プロジェクトのピンマップやアドレスで補ってはいけません。

プロジェクトの開発段階と判断ポイント¶

各段階は機能チェックリストではなく、次へ進むか判断するゲートとして使います。

システム構成と依存関係¶

flowchart LR
    G["ゲームスケッチ\n更新、入力、描画、アセット"] --> A["Arduboy2-SiFli\n互換レイヤー"]
    A --> C["Arduinoコア\nボードパッケージとランタイム"]
    C --> S["SiFli-SDK / SF32\nGPIO、ディスプレイ、タイマー、ストレージ、オーディオ"]
    S --> H["選定したSF32ボード\nディスプレイ、ボタン、スピーカー、USB"]
    A --> R["リファレンステスト\nシリアルログと表示確認"]

これは判断用のモデルであり、リポジトリー内部でまったく同じモジュール名が使われているという主張ではありません。移植版を変更する前に、実際のソース境界を確認してください。製品上重要な経路は次のとおりです。

• フレームとタイミング: ゲームループは再現可能な周期で更新/描画する必要があります。タイミングに敏感なオーディオや入力動作は、対象ボードで測定してください。
• ディスプレイ: 互換レイヤーで、ゲームのバッファーと座標系を、選定したディスプレイコントローラー、ピクセル形式、向き、更新経路に対応付ける必要があります。
• 入力: ボタン名、極性、チャタリング対策、同時押し、ウェイクアップ/リセット動作をボード配線と照合してください。
• オーディオ: トーン生成、タイマーの所有関係、スピーカー接続、音量、ミュート動作は、検証が済むまでボード固有の要素として扱います。
• アセットとストレージ: 選定したゲームをリンクした後、フォント、スプライト、サウンドデータ、Flash配置、RAM使用量を測定します。
• 復旧: タイミング、メモリー、低消費電力設定を試す前に、確実な書き込み/復旧手段を確保してください。

主な障害領域は、アプリケーション/API互換性、ディスプレイ設定、入力配線、オーディオ/タイマー動作、メモリー/アセット配置、書き込み/復旧です。いずれかの領域で問題が起きても、単に「移植版が動かない」と報告すべきではありません。

段階1 — 未変更のリファレンスを確立する¶

目標: ライブラリーやゲームを変更する前に、リポジトリーに記載された基準構成が実際に動作することを確認します。

1. リポジトリーの手順を読み、デフォルトブランチまたはリリースを記録し、サンプル、ボード設定、依存関係、ライセンスファイルを確認します。
2. リポジトリーが要求する正確なArduinoコア/パッケージとツールをインストールし、ホストOSとツールのバージョンを記録します。
3. 資料に記載された最小のサンプルまたはテストスケッチをビルドして書き込みます。
4. シリアル出力を取得し、ディスプレイ表示、反応するボタン、サンプルでオーディオを使うかどうかを記録します。

保管する証跡: リポジトリーのコミット、依存関係/パッケージのバージョン、ボードリビジョン、配線または回路図の参照先、ビルド出力、書き込みログ、シリアルログ、簡潔な機能確認記録。

ゲート1の終了条件: 選定したボードで未変更のリファレンスをビルド/書き込みでき、リセットまたは電源再投入後も記載どおりに動作すること。

段階2 — 周辺機器とタイミングの境界を検証する¶

目標: ビルド成功と、ゲーム機として使える基準構成を区別します。

1. ディスプレイのクリア、全画面更新、スプライト/ビットマップ描画、テキスト表示、およびサンプルで使う座標系/向きの前提を検証します。
2. プロジェクトで使うすべての入力について、ボタン解放、同時押し、連打、該当する場合はリセット/ウェイクアップ動作を確認します。
3. オーディオを使う場合は、トーンの開始/停止、タイマーとの相互作用、ミュート動作、ディスプレイ/入力動作が音声経路に与える影響を確認します。
4. 通常動作中にリセット、ケーブルの抜き差し、不正または未完了の入力シーケンスを発生させます。ボードが再び書き込み/実行可能な状態に戻るか記録します。

保管する証跡: 画面の目視/キャプチャー結果、入力マトリクス、タイミング観測、オーディオ観測、リセット/復旧ログ、製品判断に影響する実測電流やレイテンシ。

ゲート2の終了条件: アプリケーションの不具合と、ボード設定、タイミング、電源の問題を切り分けられる程度に、選定した周辺機器経路を理解していること。

段階3 — 再現可能なソースの基準構成を整える¶

目標: 特定の開発機や配布バイナリーに依存せず、移植版を再現可能にします。

1. クリーンなチェックアウトから始め、リポジトリーが必要とするすべての依存関係を初期化します。
2. ボードパッケージ、Arduino IDE/CLIのバージョン、コンパイラー/ツールのバージョン、設定ファイル、生成アセットを記録します。
3. クリーンなディレクトリーでビルドし、生成イメージと、可能であればmap/サイズ情報を保存します。書き込みコマンドまたはツール出力も記録します。
4. 別のマシンで、またはビルドディレクトリーを削除した後に、再度ビルドします。

保管する証跡: ソースリビジョン、依存関係のリビジョン、ホスト/ツール一覧、ビルドログ、バイナリー等の成果物、サイズレポート、書き込みログ、シリアルログ。

ゲート3の終了条件: 文書化されていないローカルファイルや手動編集なしに、クリーンなチェックアウトから段階2の周辺機器テストに合格するイメージを再生成できること。

段階4 — 1本のゲームを計画的に移植する¶

目標: 管理された製品変更を一つ加えて、互換性の境界を実証します。

ディスプレイ、入力、オーディオ、アセットの要件が明確な小さなスケッチまたはゲームから始めます。未変更のリファレンスイメージを保管し、一度に変更する動作の種類を一つに限定してください。

根拠に基づく設計判断なしに、AVRレジスターアクセス、元のArduboyのピン前提、ストレージアドレスをSF32プロジェクトへ転用しないでください。サードパーティー製ゲーム/アセットのライセンスを派生ソースと一緒に保管し、再配布条件が不明なものは除外します。

保管する証跡: レビュー済み差分、アセットの出典、変更前後のイメージ、ビルド/書き込みログ、回帰テスト結果、ロールバック用イメージ。

ゲート4の終了条件: 適用したゲームがリファレンスの周辺機器テストに合格し、メモリー、タイミング、復旧、ライセンスの境界が記録されていること。

段階5 — 製品化準備のレビュー¶

チームが次の質問に答えられるまでは、移植デモから専用ハードウェア設計や実地試験へ進まないでください。

• どのSF32ボード、ディスプレイ、ボタン、スピーカー、電源が実際に対応し、どれがまだ仮定なのか。
• 製品の基準構成で測定したフレームレート、入力レイテンシ、オーディオ動作、起動時間、電流プロファイルは何か。
• 最悪条件のコンテンツも含め、ゲーム、アセット、フォント、ランタイムがFlash/RAMをどれだけ消費するか。
• リセット、電圧低下、保存中の電源断、アセット破損、書き込み失敗、不完全な更新の後に何が起きるか。
• 移植版のどの部分を製品チーム、OpenSiFli、SiFli、元のArduboy2コミュニティーが保守するのか。
• ゲーム、フォント、画像、サウンド、ライブラリーの各ライセンスは、予定する配布形態に適合するか。

ゲート5の終了条件: 残るリスクの担当者と根拠が明確であり、各項目に対策、明示的な延期、または中止の判断があること。

製品設計への引き継ぎ¶

選定したSF32デバイス、ディスプレイ/入力構成、オーディオ/タイマー計画、Flashとアセットの配置、電力測定、復旧方法、量産テストの前提をハードウェアセクションへ引き継ぎます。ゲームのディスプレイ、メモリー、パッケージ、電源、接続要件によって候補デバイスが変わる場合は、SF32製品セレクターを使用してください。ソフトウェアの基準構成は、まずArduinoを始めるから始め、Arduinoプラットフォーム概要へ進みます。

別のエンジニアが移植版を再ビルドし、周辺機器の結果を再現し、ボード固有の変更をすべて説明でき、専用基板やゲームライブラリーの拡張を承認する前に根拠をレビューできれば、このリファレンスは製品開発上の役割を果たしたと言えます。

主な情報源¶

• OpenSiFli/Arduboy2-SiFli
• MLXXXp/Arduboy2
• OpenSiFli/ArduinoCore-zephyr
• SF32でArduinoを始める
• Arduinoプラットフォーム概要
• SF32製品セレクター

最終更新: 2026-10-19