game and watch patch

為新的任天堂遊戲和觀看遊戲機定制固件。

這是什麼？

此存儲庫包含自定義代碼以及修補程序，以在庫存遊戲和觀看固件中添加其他功能。簡而言之，該項目使您可以運行遊戲的固件，並隨身攜帶Retro-Go。

特徵

• 在內部閃存庫2中與復古行動正確使用。
• 按按鈕組合（ LEFT + GAME ）從內部閃存庫2啟動復古啟動。
• 運行make help查看所有配置選項。

Mario（ PATCH_PARAMS="--device=mario" ）

• 能夠將整個固件存儲在內部閃光燈中！無需外部閃光！
  • 刪除“馬里奧歌”復活節彩蛋的選項。
  • 刪除5個睡眠插圖的選項。
  • LZMA壓縮數據。
  • 將盡可能多的數據移至內部固件。
• 可配置的超時。
• 通過--smb1=path-to-patched-smb1-rom.nes播放SMB1 ROM黑客攻擊的能力
• 通過--smb1-graphics=path-to-patch.ips動態加載SMB1 ROM黑客sprites的能力
  • 可以添加多達8個其他圖形集。
  • 通過時鐘屏幕上的向下按鈕循環。
  • 將所有IPS文件添加到ips/並讓Patcher通過標誌自動發現它們--smb1-graphics-glob
• 傾倒其他模擬器可播放的SMB1和SMB2 ROM。
• 有關更多信息，請參見Mario文檔。

Zelda（ PATCH_PARAMS="--device=zelda" ）

• 通過--no-beep在時間/時鐘上刪除第二個蜂鳴的能力
• 外部閃光節省將來。
• 有關更多信息，請參見Zelda文檔。

用法

此存儲庫使用GNWManager CLI工具。查看有關如何安裝的說明。

通過：安裝遊戲和觀察點python依賴（> = 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（馬里奧）

由於大多數人都將使用複古go使用它，因此希望使用最少的外部存儲量，並且不在乎睡眠圖像或馬里奧歌曲復活節彩蛋，所以這裡是推薦命令。請注意，這使用了內部銀行1的無證件128KB，並且需要安裝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

復古（Zelda）

假設您已將外部閃光燈升級到大於4MB的東西。請參閱Zelda文檔，以與庫存4MB閃光芯片一起使用Retro-Go。

 # 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，其中包含包含編譯和Flash自定義固件（CFW）所需的所有內容到您的Nintendo®Game＆Watch™System。此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組中。

故障排除/常見問題：

無法在RPI3上安裝Python依賴性keystone-engine

如果您無法在Raspberry Pi 3上安裝keystone-engine ，請嘗試：

1. 從raspi-config將GPU RAM更新為16MB
2. 構建和安裝來自來源的Keystone-Geneine（應花費約15分鐘）：

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

發展

開發功能的主要階段：

1. 找到在庫存ROM中控制的地方（通常是功能調用）。
2. 將庫存功能及其地址添加到Core/Inc/stock_firmware.h 。
3. 可能在Core/Src/main.c中實現自己的功能。您的自定義功能很可能會在（2）中調用該功能。您可能還必須添加-Wl,--undefined=my_custom_function在makefile中的LDFLAGS中，以使其不會被優化為無法到達的代碼。
4. 將補丁定義添加到patches/patches.py中。

雜誌

這是我第一次為封閉源二進制開發補丁。我記錄了自己的旅程，希望它對他人有所幫助。如果您有任何建議，技巧，技巧或類似的建議，請留下github問題，我將更新文檔！

致謝

感謝使這成為可能的社區！該倉庫是在其他人的幫助下建造的。該項目開發過程中引用的存儲庫：

• KBECKMANN的遊戲和觀看式retro-go
• Ghidraninja的遊戲和回顧
• Ghidraninja的遊戲和觀察基礎
• GMMAN的遊戲和觀察年會
• Jaames的遊戲和觀看歌曲

我還要感謝StackSmashing Discord的所有幫助（對@cyanic的特別喊叫）！