Портативная игровая консоль Pocket Pi SF32¶

Что такое Pocket Pi?¶

SiFliSparks/PocketPi — это проект-образец портативной игровой консоли и эмулятора для SF32LB52. В зафиксированной ревизии исходного кода объединены эмулятор NES Nofrendo, игровой каталог на LVGL, дисплей ST7789 с интерфейсом 8080 и разрешением 320 × 240, аудиотракт, сохранение и загрузка состояния, встроенная файловая система и каталог ROM на TF-карте. В качестве открытой базовой конфигурации сборки используется Huangshan Pi / sf32lb52-lchspi-ulp.

Проект позволяет проверить совместную работу локальной графики, ввода, аудио, внешнего хранилища, распределения PSRAM и нагрузки эмулятора на системе SF32LB52. В репозитории нет коммерческих игровых ROM: пользователь должен самостоятельно предоставить файлы .nes/.NES, которыми вправе пользоваться. Открытый исходный код также не является готовым к серийному производству проектом портативной консоли и не заменяет проверку безопасности аккумулятора, аудио, ЭМС, теплового режима, лицензий и распространения контента.

Зачем нужна реализация на SF32?¶

Эмуляция NES объединяет несколько характерных для встраиваемых систем задач в одном наглядном сценарии: эмуляция CPU, графика PPU, обработка аудиосэмплов, низколатентный ввод, чтение файлов, буферизация кадров и сохранение состояния должны работать согласованно. Система на базе SF32LB52 предоставляет необходимые для этого ресурсы дисплея, аудио, внешнего хранения и PSRAM; Huangshan Pi также служит платформой для оценки работы от аккумулятора.

Это не означает, что все игры NES полностью совместимы. Поддержка мапперов ROM, частота кадров, аудио, сохранение состояния, пиковое потребление памяти и задержка ввода могут различаться в зависимости от игры. Для каждого добавляемого ROM-файла или маппера отдельно проверяйте совместимость и авторские права.

Результат, область применения и условия начала¶

Ожидаемый результат: собрать воспроизводимый образ из commit PocketPi, зафиксированного в спецификации ПО, запустить хотя бы один ROM-файл, которым разрешено пользоваться, проверить дисплей, ввод, аудио, паузу, сохранение, загрузку, выход и восстановление, а затем выполнить одно ограниченное изменение.

Эта статья не гарантирует поддержку всех мапперов NES, режимов PAL/NTSC, аудиотрактов игр, форматов сохранений или сторонних ROM-файлов. Она не предоставляет права копировать или распространять игровой контент. В корне репозитория на зафиксированной ревизии нет файла лицензии; прежде чем использовать код в продукте или распространять бинарные файлы, ответственный должен установить условия лицензирования PocketPi, Nofrendo и каждого включённого стороннего компонента.

Перед началом подготовьте:

• SF32LB52-DevKit-ULP / Huangshan Pi либо оборудование, соответствующее описанию платы sf32lb52-lchspi-ulp в репозитории;
• дисплей 320 × 240, расширитель ввода-вывода AW9523 с интерфейсом I²C, кнопки, аудио и предусмотренный кодом зафиксированной ревизии опциональный тракт TF-карты; одно лишь название платы не подтверждает, что все периферийные устройства установлены;
• SiFli-SDK, SCons, средства загрузки по UART и ведения журналов;
• тестовую ROM .nes, созданную самостоятельно, находящуюся в общественном достоянии или имеющую подходящую лицензию;
• ROM-файл в каталоге disk/ репозитория для встроенной файловой системы либо в каталоге ROM на 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["Входные данные сборки\nROM NES, которыми разрешено пользоваться, в disk/"] --> F["Образ файловой системы fs_root"]
    C["TF-карта\n/sdcard/roms/nes"] --> L["Каталог игр LVGL"]
    F --> L
    L --> N["Эмулятор NES Nofrendo\nCPU, PPU, мапперы, состояние"]
    I["Кнопки AW9523 по I²C\nA/B, направления, Start, Select, Menu, L/R"] --> N
    N --> V["Дисплей ST7789 (320 × 240)"]
    N --> A["Аудиотракт 32 kHz"]
    N <--> S["Сохранение / загрузка состояния"]
    D["SiFli-SDK и поддержка платы\nPSRAM, Flash, TF-карта, аккумулятор"] --> L
    D --> N

К основным областям отказа относятся файловая система/ROM, маппер/эмулятор, PSRAM/память, дисплей/тайминг кадров, ввод AW9523, аудио, сохранение состояния и питание/сброс. При чёрном экране сначала выясните, не обнаружена ли ROM, не удалось ли декодировать обложку, поддерживается ли маппер, выделился ли буфер кадров и исправен ли тракт LCD. Не сводите все такие случаи к общей ошибке эмулятора.

Этап 1 — Зафиксируйте исходную конфигурацию игры¶

Цель: на одной тестовой ROM, использование которой разрешено, подтвердить весь путь от входных данных сборки до запущенной игры.

1. Зафиксируйте коммиты PocketPi и SiFli-SDK, а также ревизии платы и периферийных устройств.
2. Поместите разрешённую ROM .nes в disk/; если добавляете обложку, используйте файл .jpg с тем же базовым именем. Запишите хеш ROM, источник и маппер.
3. Выполните чистую сборку и убедитесь, что fs_root создан и включён в файлы для загрузки.
4. Загрузите прошивку и выполните запуск после полного снятия питания. Убедитесь, что игра появилась в списке, отображается обложка или изображение по умолчанию и игру можно запустить.
5. Запишите время запуска, стабильность изображения, реакцию кнопок, аудио и последовательный журнал; затем сбросьте устройство и повторите тест.

Сохраняемые свидетельства: коммиты репозитория/SDK, версии платы и периферии, хеш и лицензия ROM, журнал сборки, образ файловой системы, журнал загрузки, последовательный журнал, снимки списка игр и работающей игры.

Критерий выхода из контрольной точки 1: при двух холодных запусках одна и та же ROM отображается в списке и запускается; поведение дисплея, основных направлений/A/B/Start/Select и аудио воспроизводимо.

Этап 2 — Проверьте ввод, сохранения и восстановление после отказов¶

Цель: превратить факт «игра запускается» в проверяемую базовую конфигурацию портативной консоли.

Критерий выхода из контрольной точки 2: для выбранной ROM задокументированы ввод, дисплей, аудио, пауза, сохранение, загрузка, выход и сброс; каждый отказ отнесён к определённой области.

Этап 3 — Подготовьте воспроизводимую базу исходников и контента¶

Цель: дать другому инженеру возможность собрать ту же прошивку и образ контента.

1. Зафиксируйте версии PocketPi, SiFli-SDK и всех сторонних ядер.
2. Создайте для disk/ манифест с именами файлов, хешами, источниками и лицензиями каждой ROM и обложки. Не добавляйте в репозиторий ROM, которые нельзя распространять.
3. Выполните сборку из пустого каталога результатов и сохраните fs_root, прошивку, результаты анализа памяти/разделов, скрипт загрузки и хеши.
4. Повторите сборку на втором компьютере или в чистом каталоге и заново выполните основные проверки этапа 2.

Критерий выхода из контрольной точки 3: по манифестам исходников и контента можно получить образ с совпадающими хешами либо объяснимыми различиями без недокументированных локальных файлов.

Этап 4 — Меняйте только одну переменную за раз¶

Цель: измерить границы возможностей эмулятора, контента и аппаратуры.

Критерий выхода из контрольной точки 4: изменение и права на контент проверены, исходный образ можно восстановить, а все проверки этапа 2 для выбранной ROM проходят.

Этап 5 — Оценка готовности продукта¶

Перед разработкой собственной аппаратуры портативной консоли или распространением контента ответьте на вопросы:

• Какие мапперы требуются целевому набору игр? Проверены ли частота кадров, аудио, память и сохранение состояния для каждой ROM?
• Ясны ли лицензии и права распространения PocketPi, Nofrendo, SiFli-SDK, шрифтов, обложек, звуковых файлов и ROM?
• Подготовлены ли полные схемы, ведомость компонентов (BOM) и производственные тесты для AW9523, LCD, аудио, TF-карты, аккумулятора и цепи зарядки?
• Каковы ток потребления во время игры, отображения списка, паузы, сна и выключения, а также время работы, температура и поведение при низком заряде?
• Как защищать и переносить сохранения после потери питания, обновления версии, заполнения носителя или повреждения данных?
• Как восстановить устройство при повреждении файловой системы, неудачном обновлении, чёрном экране или 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 по Huangshan Pi
• SiFli-SDK: руководство по началу работы
• pebri86/esplay-retro-emulation
• Документация LVGL

Последнее обновление: 2026-10-21