Pocket Pi SF32ハンドヘルドゲーム機¶

Pocket Piとは¶

SiFliSparks/PocketPi は、SF32LB52向けの携帯型ゲーム機およびエミュレーターのリファレンスです。固定したリビジョンでは、Nofrendo NESエミュレーター、LVGLのゲームブラウザー、320 × 240 ST7789 8080ディスプレイ経路、オーディオ、ステートの保存／読み込み、組み込みファイルシステム、TFカードのROMディレクトリを統合しています。公開されているビルド基準はHuangshan Pi／sf32lb52-lchspi-ulpターゲットです。

ローカル描画、入力、オーディオ、外部ストレージ、PSRAM割り当て、エミュレーター負荷がSF32LB52システム上でどのように共存するかを検証するのに適しています。リポジトリーには市販ゲームのROMは含まれていません。利用する権利のある.nes／.NESファイルは、各自で用意する必要があります。また、公開ソースは量産可能な携帯ゲーム機の完全な設計ではありません。バッテリー安全性、オーディオ、EMC、熱、ライセンス、コンテンツ配布に関するレビューの代わりにはなりません。

SF32実装を使う理由¶

NESエミュレーションは、CPUエミュレーション、PPU描画、オーディオサンプリング、低レイテンシ入力、ファイル読み出し、フレームバッファー、ステートセーブを連携させる必要があり、複数の組み込み技術要素を分かりやすい1つの負荷にまとめています。SF32LB52ベースのシステムは、この負荷に必要なディスプレイ、オーディオ、外部ストレージ、PSRAMを備え、Huangshan Piはバッテリー駆動の評価環境も提供します。

その価値は、すべてのNESタイトルが完全に互換であると主張することではありません。ROMマッパーの対応状況、フレームレート、オーディオ、セーブ動作、ピークメモリー使用量、入力レイテンシはゲームごとに異なる場合があります。追加するROMやマッパーごとに、互換性と著作権について個別の判断が必要です。

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

目標： ソフトウェア仕様に固定したPocketPiのcommitから再現可能なイメージをビルドし、利用権のあるテストROMを少なくとも1つ起動します。ディスプレイ、入力、オーディオ、一時停止、保存、読み込み、終了、復旧を検証した後、範囲を限定した変更を1件実施します。

このページでは、すべてのNESマッパー、PAL／NTSCタイミング、ゲームのオーディオ経路、セーブ形式、サードパーティーROMの動作を保証しません。ゲームコンテンツを複製または配布する権利も付与しません。固定したリビジョンにはトップレベルのライセンスファイルがありません。製品にコードを取り込んだりバイナリーを配布したりする前に、PocketPi、Nofrendo、および組み込まれるすべてのサードパーティーコンポーネントのライセンスを責任者が確認する必要があります。

開始前に、次のものを用意してください。

• SF32LB52-DevKit-ULP／Huangshan Pi、またはリポジトリーのsf32lb52-lchspi-ulpボード定義に合致するハードウェア。
• 固定したソースが想定する320 × 240ディスプレイ、AW9523 I²C入力エキスパンダー、キー、オーディオ、任意のTFカード経路。ボード名だけでは、すべての周辺機器が実装済みとは判断できません。
• SiFli-SDK、SCons、UART書き込み、ログ取得用のツール。
• 自作、パブリックドメイン、または適切なライセンスを得た.nesテストROM。
• ROMは、組み込みファイルシステム用ならリポジトリーのdisk/に配置します。TFカードを使う場合はファームウェアで設定されたROMディレクトリに置いてください。固定したリビジョンの実行時検索パスは/sdcard/roms/nesです。カードのマウントパスが一致することを該当リビジョンのソースで確認してください。
• フレーム動作、オーディオ、入力、メモリー、電流を確認する手段。

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

ハードウェア仕様¶

ソフトウェア仕様¶

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

ソフトウェア仕様に記載したPocketPiのリビジョンを使い、現在のmainが指すコミットをそのままビルドしないでください。

git clone https://github.com/SiFliSparks/PocketPi.git
cd PocketPi
git checkout 7d9fac2cb577d6c9b66a99521aebf3c9de0ae163
cd project
scons --board=sf32lb52-lchspi-ulp -j8

ビルドスクリプトは../diskをファイルシステムイメージに変換し、fs_rootとしてファームウェアに追加します。Windowsでは、生成されたbuild_sf32lb52-lchspi-ulp_hcpu\uart_download.batが書き込み手段を提供します。他のホストでは、対応するSiFli-SDK書き込みツールを使い、同等のパラメーターを記録してください。

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

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

flowchart LR
    B["ビルド入力\ndisk/ に使用権のある NES ROM を配置"] --> F["fs_root ファイルシステムイメージ"]
    C["TF カード\n/sdcard/roms/nes"] --> L["LVGL ゲームブラウザー"]
    F --> L
    L --> N["Nofrendo NES エミュレーター\nCPU、PPU、マッパー、ステート"]
    I["AW9523 I2C キー\nA/B、方向、Start、Select、Menu、L/R"] --> N
    N --> V["320 × 240 ST7789 ディスプレイ"]
    N --> A["32 kHz オーディオ経路"]
    N <--> S["ステート保存／読み込み"]
    D["SiFli-SDK とボード対応\nPSRAM、Flash、TF カード、バッテリー"] --> L
    D --> N

主な障害領域は、ファイルシステム／ROM、マッパー／エミュレーター、PSRAM／メモリー、ディスプレイ／フレームタイミング、AW9523入力、オーディオ、ステートセーブ、電源／リセットです。画面が真っ黒な場合は、単に「エミュレーターの障害」とせず、「ROMが見つからない」「画像デコードに失敗」「マッパー非対応」「フレームバッファー割り当て失敗」「LCD経路の障害」に切り分けてください。

段階1 — 未変更のゲーム基準構成を確立する¶

目標： 利用権のあるテストROMを1つ使い、ビルド入力からゲーム実行までの経路全体を実証します。

1. PocketPiとSiFli-SDKのコミット、およびボードと周辺機器のリビジョンを固定します。
2. ライセンスを確認した.nes ROMをdisk/に配置します。カバー画像を追加する場合は同じベース名の.jpgにします。ROMのハッシュ、入手元、マッパーを記録します。
3. クリーンビルドし、fs_rootが生成され、書き込み成果物に含まれていることを確認します。
4. 書き込み後に完全に電源を入れ直します。ゲームがリストに表示され、カバー画像または既定画像が見え、ゲームを起動できることを確認します。
5. 起動時間、安定した映像、キー応答、オーディオ、シリアルログを記録し、リセット後にもう一度再現します。

保存する証跡： リポジトリー／SDKのコミット、ボードと周辺機器、ROMのハッシュ／ライセンス、ビルドログ、ファイルシステムイメージ、書き込みログ、シリアルログ、ゲームリスト／実行画面の写真。

ゲート1の終了条件： 2回の完全な電源投入で同じROMがリストに表示されて起動し、映像、基本的な方向／A／B／Start／Select入力、オーディオが再現可能に動作する。

段階2 — 入力、ステート、障害復旧を検証する¶

目標： 「ゲームが起動する」状態から、レビュー可能な携帯ゲーム機の基準構成へ進めます。

ゲート2の終了条件： 選択したROMについて、入力、ディスプレイ、オーディオ、一時停止、保存、読み込み、終了、リセットを記録し、各障害を定義済みの領域に対応付ける。

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

目標： 別のエンジニアが同じファームウェアとコンテンツイメージを再ビルドできる状態にします。

1. PocketPi、SiFli-SDK、サードパーティーコアの各リビジョンを記録します。
2. ROMとカバー画像ごとに、ファイル名、ハッシュ、入手元、ライセンスを記載したdisk/マニフェストを作成します。再配布できないROMはコミットしないでください。
3. 空の出力ディレクトリからビルドし、fs_root、ファームウェア、メモリー／パーティション出力、書き込みスクリプト、ハッシュを保存します。
4. 2台目のPCまたはクリーンなディレクトリで再ビルドし、段階2の主要テストを繰り返します。

ゲート3の終了条件： ソースとコンテンツのマニフェストから、ハッシュが一致するか差分を説明できるイメージを再現し、未記録のローカルファイルに依存しない。

段階4 — 変更は一度に1つずつ行う¶

目標： エミュレーター、コンテンツ、ハードウェアの境界を測定します。

ゲート4の終了条件： 変更内容とコンテンツの権利をレビューし、元のイメージに復旧でき、選択したROMで段階2のすべてのテストに合格する。

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

カスタム携帯ゲーム機の設計やコンテンツ配布に進む前に、以下を確認してください。

• 対象ゲームが必要とするマッパーは何か。各ROMのフレームレート、オーディオ、メモリー、保存動作を評価したか。
• PocketPi、Nofrendo、SiFli-SDK、フォント、カバー画像、サウンド、ROMのライセンスと配布権は明確か。
• AW9523、LCD、オーディオ、TFカード、バッテリー、充電回路の回路図、BOM、量産試験は揃っているか。
• ゲーム中、リスト表示中、一時停止中、スリープ中、電源オフ時の電流、バッテリー寿命、温度、低バッテリー時の挙動はどうか。
• 電源断、バージョン更新、メディア容量不足、破損後にステートセーブをどう保護し、移行するか。
• ファイルシステム破損、更新失敗、黒画面、起動不能なROMからどう復旧するか。

ゲート5の終了条件： 互換性表、コンテンツ／ソフトウェアライセンス、ハードウェア担当、電力、復旧リスクに責任者を割り当て、「進める／保留／中止」を決定する。

製品設計への引き継ぎ¶

SF32チップまたはモジュールの選定、PSRAMとFlashのピーク使用量、ディスプレイ／フレームバッファー経路、AW9523入力マトリクス、オーディオアンプとスピーカー、TFカードと組み込みファイルシステム、ステートセーブ形式、バッテリー／充電回路、復旧用書き込みポート、ROM／マッパー互換性表、ライセンスの完全な一覧を引き継いでください。続けて SF32LB52x、SF32LB52-DevKit-ULP、SiFli-SDKのビルド、書き込み、モニター、量産設計を参照してください。

主な情報源¶

• SiFliSparks/PocketPi
• 固定した参照コミット7d9fac2
• LCKFB Huangshan Pi SF32LB52-ULPボード
• OpenSiFli/SiFli-SDK
• SiFli Wiki: Huangshan Pi開発ボードガイド
• SiFli-SDK Getting Started Guide
• pebri86/esplay-retro-emulation
• LVGLドキュメント

最終更新: 2026-10-19