add rom-corruption

Author: hasumikin

_data/sidebars/picoruby_sidebar.yml

@@ -23,6 +23,10 @@ entries:
       url: "/index.html"
       output: web, pdf
       type: homepage
+    - title: R2P2 ROM corruption
+      url: "/rom-corruption"
+      output: web, pdf
+      type: homepage
     - title: R2P2 WiFi Config
       url: "/wifi"
       output: web

_data/sidebars/picoruby_sidebar.yml.template

@@ -26,6 +26,10 @@ entries:
       url: /index.html
       output: web, pdf
       type: homepage
+    - title: R2P2 ROM corruption
+      url: /rom-corruption
+      output: web, pdf
+      type: homepage
     - title: R2P2 WiFi Config
       url: /wifi
       output: web

images/r2p2-init-failure.png

@@ -57,9 +57,10 @@ Microcontroller programming framework.
 
 #### 1-1 Getting start with R2P2
 
-- Download the latest `R2P2-*.uf2` from the releases page of the repository
+- Download the latest `R2P2-*.uf2` from [the releases page of the repository](https://github.com/picoruby/R2P2/releases)
 - Drag and drop it into the RPI-RP2 drive
 - Open a proper port in your terminal emulator
+- Check if the ROM is sane. See [R2P2 ROM corruption on RP2040/RP2350](rom-corruption)
 
 <iframe width="560" height="315" src="https://www.youtube.com/embed/s4M4rBnPSus?si=--2VC4Od8wssmHUs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
 

images/r2p2-init-success.png

@@ -0,0 +1,32 @@
+---
+keywords: documentation
+layout: page
+tags: [tips]
+title: R2P2 ROM corruption on RP2040/RP2350
+sidebar: picoruby_sidebar
+permalink: rom-corruption
+folder: r2p2
+---
+
+R2P2 formats part of the flash ROM as a FAT disk during its first startup and generates the directories and files necessary for the system.
+This process may sometimes fail, so please follow the steps below to verify that initialization has been successful.
+
+- Start R2P2 and connect to a terminal emulator
+- If initialization is complete, regardless it's successful or not, the shell should be running
+- Execute the `reboot` command here
+- The microcontroller will restart, and R2P2's initialization process should be displayed on the terminal
+- At this time, file integrity checks may fail as shown in the image below
+
+  ![](/images/r2p2-init-failure.png)
+
+- If this happens, please `reboot` again
+- If the same file check fails again, of if another file fails, it is suspected that the flash ROM state has become corrupted
+- Download `flash_nuke.uf2` from the page below and install it on the microcontroller
+
+    [https://www.raspberrypi.com/documentation/microcontrollers/pico-series.html#resetting-flash-memory](https://www.raspberrypi.com/documentation/microcontrollers/pico-series.html#resetting-flash-memory)
+
+- Since the microcontroller's ROM will be zero-cleared, install R2P2 again and repeat this procedure until all checks pass as shown in the image below
+
+  ![](/images/r2p2-init-success.png)
+
+Even in cases other than the above, if you feel that the ROM has become corrupted, please refer to this procedure to initialize the microcontroller.