game and watch patch

Пользовательская прошивка для более новой игры Nintendo Game and Watch.

Что это?

Этот репо содержит пользовательский код, а также утилиту исправления, чтобы добавить дополнительные функциональные возможности в акционерную игру и просмотреть прошивку. Короче говоря, этот проект позволяет вам запустить прошивку, которую ваша игра и часы пришли вместе с Retro-Go.

Функции

• Работает правильно с Retro-GO во внутреннем банк Flash 2.
• Нажмите кнопку комбинации ( LEFT + GAME ), чтобы запустить Retro-GO из внутреннего банка Flash 2.
• make help , чтобы увидеть все параметры конфигурации.

Mario ( PATCH_PARAMS="--device=mario" )

• Возможность хранить всю прошивку во внутренней вспышке! Внешняя вспышка не требуется!
  • Возможность удалить пасхальное яйцо "Mario Song".
  • Возможность удалить 5 спящих иллюстраций.
  • LZMA сжатые данные.
  • Разумно перемещайте как можно больше данных во внутреннюю прошивку.
• Настраиваемые тайм -ауты.
• Способность играть в SMB1 ROM Hacks через --smb1=path-to-patched-smb1-rom.nes
• Возможность динамической загрузки SMB1 ROM-хак-спрайтов для часов через --smb1-graphics=path-to-patch.ips
  • Может добавить до 8 дополнительных графических наборов.
  • Прокатитесь через кнопку вниз на экране часов.
  • Добавьте все свои файлы IPS в ips/ и пусть паттер автоматически обнаруживает их через флаг --smb1-graphics-glob
• Свалки SMB1 и SMB2 ПЗУ, которые играют другие эмуляторы.
• Смотрите документ Mario для получения дополнительной информации.

Zelda ( PATCH_PARAMS="--device=zelda" )

• Возможность удалить второй звуковой сигнал во времени/часах через --no-beep
• Внешние сбережения вспышки придут в будущем.
• Смотрите документ Zelda для получения дополнительной информации.

Использование

В этом репо используется инструмент Gnwmanager CLI. Смотрите инструкции о том, как установить.

Установите зависимости от Python Game-Patch-Patch (> = Python3.6, требуется) через:

 pip3 install -r requirements.txt

Разместите свой internal_flash_backup_${DEVICE}.bin и flash_backup_${DEVICE}.bin в корне этого репо. Чтобы извлечь их из вашей системы GNW, см. Учебное пособие по разблокировке GNWManager. Например, если мы исправляем игру mario и смотрим, нам нужны файлы internal_flash_backup_mario.bin и flash_backup_mario.bin в корневом каталоге этого проекта.

См. Подходящий раздел ниже для модели вашего устройства.

Для получения дополнительных параметров конфигурации запустите make help .

Retro Go (Mario)

Поскольку большинство людей будут использовать это с Retro-GO, хотят минимальный объем используемого внешнего хранилища и не заботятся о спящих изображениях или пасхальном яйце песни Mario, вот рекомендованные команды. Обратите внимание, что это использует незарегистрированные 128 КБ внутреннего банка 1 и требует установленной версии OpenOCD.

 # in this repo
make clean
make PATCH_PARAMS="--device=mario --internal-only" flash

# in the retro-go repo
make clean
make -j8 INTFLASH_BANK=2 flash

Retro Go (Zelda)

Это предполагает, что вы обновили внешнюю вспышку до чего -то большего, чем 4 МБ. См. Документ Zelda для использования Retro-Go с флэш-чипом 4 МБ.

 # in this repo
make clean
make PATCH_PARAMS="--device=zelda" flash

# in the retro-go repo
make clean
# In this example, I'm assuming you have a 64MB flash chip (60 = 64 - 4)
make -j8 EXTFLASH_SIZE_MB=60 EXTFLASH_OFFSET=4194304 INTFLASH_BANK=2 flash

Стройте и вспыхивайте с помощью Docker

Если вы знакомы с Docker и предпочитаете решение, в котором вам не нужно вручную устанавливать инструментальные инструменты и так далее, разверните этот раздел и читайте дальше.

Чтобы уменьшить количество потенциальных ловушек при установке различных программ, предоставляется DockerFile, содержащий все, что необходимо для компиляции и вспыхивания пользовательской прошивки (CFW) для вашей системы Nintendo® Game & Watch ™. Этот DockerFile написан тареков x86-64 машины под управлением Linux.

Шаги, чтобы вспыхивать из контейнера Docker (работая на Linux, например, Archlinux или Ubuntu):

 # Go into the docker directory of this repo.
cd docker/

# Pull the pre-built docker image.
docker pull brianpugh/game-and-watch-patch:latest

# When done, use the image to create a container with the attached docker-compose.yaml file.
# You have to edit the compose file and set the path to the directory with your firmware backup (volumes section of the file).
docker compose up -d

# This will create and run a container game-and-watch-patch.
# The firmware backup files will be mounted into /tmp/firmware of the container.
# Now, go inside the container copy the backup files and proceed as described above in the Usage section.
docker exec -it game-and-watch-patch /bin/bash

Если вы столкнетесь с проблемами разрешения, убедитесь, что ваш пользователь находится в группе Docker.

Устранение неполадок/FAQ:

Невозможно установить питоне зависимости keystone-engine на RPI3

Если вы не можете установить keystone-engine на Raspberry Pi 3, попробуйте:

1. Обновить оперативную память о GPU до 16 МБ от raspi-config
2. Стройте и установите двигатель Keystone из источника (должно занять ~ 15 минут):

 git clone https://github.com/keystone-engine/keystone
cd keystone/bindings/python/
python3 -m pip install .

Разработка

Основные этапы разработки функции:

1. Найдите место, чтобы взять под контроль в стоковом ПЗУ (обычно функциональные вызовы).
2. Добавьте функцию запаса и его адрес в Core/Inc/stock_firmware.h .
3. Реализуйте свою собственную функцию, возможно, в Core/Src/main.c . Есть большая вероятность, что ваша пользовательская функция вызовет функцию в (2). Вам также, вероятно, придется добавить -Wl,--undefined=my_custom_function в LDFLAGS в makefile, чтобы он не был оптимизирован как недоступный код.
4. Добавьте определение патча в patches/patches.py .

Журнал

Это мой первый раз, когда когда -либо разрабатывался патчи для бинарного из закрытого исходного кода. Я задокументировал свое путешествие в надежде, что это поможет другим людям. Если у вас есть какие -либо рекомендации, советы, хитрости или что -то в этом роде, оставьте проблему GitHub, и я обновлю документацию!

Подтверждение

Спасибо сообществу, которое сделало это возможным! Это репо было построено с помощью других. Репо ссылаются на разработку этого проекта:

• Game-watch-retro-go от Kbeckmann
• Game-and Watch-Backup от Ghidraninja
• Игровая база от Ghidraninja
• Игровое и наблюдение за деакриптом Gmman
• Игровое и наблюдение за песчами-Jaames

Я также хотел бы поблагодарить Discord Stacksmashing за всю помощь (особый крик @cyanic)!