μCritter Firmware Pupdate!

Step 1: Get Your Critter into DFU Mode

Important: Your μCritter needs to be in its special "Device Firmware Update" (DFU) mode to receive the new firmware. Pick ONE of the following ways to enter DFU mode. You'll know it worked when you see the DFU Bootloader screen.

The Paperclip Poke: Gently insert a paperclip (or similar) into the tiny reset hole above the speaker. Keep it pressed while *also* holding down Start + Select + Down. Release the paperclip first, then the buttons. Voilà!
The Sleepy Wake-up: Is your Critter asleep? Wake it up by pressing any button, but make sure you're *also* holding down Start + Select + Down as it wakes.
The Menu Nap: Navigate the menu to Power → Sleep. Let it nod off, then wake it using the "Sleepy Wake-up" method above (wake while holding Start + Select + Down).

Once you see the DFU Bootloader screen, connect your μCritter to the computer with a USB cable. Now you're ready for the OS-specific steps below!

Why the fuss with refreshes later? The μCritter has a two-stage bootloader (MCUBOOT) for safety. Your computer needs to talk to both stages, which sometimes requires a couple of page refreshes during the connection process. Follow the on-screen prompts carefully!

Step 2: macOS Flashing Dance

Okay, Mac users! Because of the two-stage bootloader, we need to do a little connect-refresh-connect shuffle. The page will guide you!

Make sure your Critter is connected via USB and showing the DFU Bootloader screen.
Click the big orange "Flash My Critter!" button above (or other prompt text it shows).
A browser pop-up appears *if needed*. Select MCUBOOT and click Connect.
Heads Up! If you see CAT PROTOTYPE instead of MCUBOOT in the list, your Critter isn't in DFU mode! Go back to Step 1 and try entering DFU mode again before continuing.
The status message above the button will tell you when to Refresh this web page (⌘+R). Follow the prompt!
After refreshing, if prompted, click the button again (it might say "Connect Stage 2") and select MCUBOOT again if the pop-up appears.
The status message will tell you when to Refresh the page ONE MORE TIME (⌘+R). Follow the prompt!
After the final refresh, if prompted, click the button again (it might say "Connect to Flash"). Flashing should begin automatically!

Did it work? Watch the progress log. Once flashing completes, your Critter should automatically reboot, ready for action!

Step 2: Windows Driver Wrangling & Flashing Dance

Howdy, Windows user! First, a **mandatory** driver setup using Zadig for **both** DFU stages, then follow the on-screen prompts for the flashing process.

A. Install the WinUSB Driver with Zadig (Do This TWICE!)

Fetch Zadig: Download the latest version from zadig.akeo.ie.
Critter in DFU Mode (Stage 1): Ensure μCritter is in DFU Bootloader mode (Step 1) and connected via USB.
Run Zadig (as Admin): Right-click Zadig, choose "Run as administrator".
Reveal All Devices: In Zadig, `Options` → `List All Devices` (check it).
Install for Stage 1: Find and select MCUBOOT (USB ID 2FE3:0100). Ensure WinUSB is selected. Click "Replace/Install Driver". Confirm prompts. Close Zadig for now.
Start Web Flash (Stage 1 Connect): Go back to this browser page. Click the big orange button above ("Flash My Critter!"). Select `MCUBOOT` in the browser pop-up, click Connect.
Heads Up! If you see CAT PROTOTYPE instead of MCUBOOT, go back to Step 1 and retry DFU mode before doing Zadig.
Wait for Disconnect & Stage 2: The device will connect, then disconnect as it switches to Stage 2. The page status *might* eventually prompt you to Refresh, but **IGNORE THAT PROMPT FOR NOW!** Wait about 5-10 seconds for Windows to recognize the Stage 2 device.
Install for Stage 2: Re-open Zadig (as Admin). Go to `Options` → `List All Devices` again. Now, find the *new* MCUBOOT device in the list (it might appear briefly and will likely have USB ID 2FE3:FFFF or could still be 2FE3:0100). Select it. Ensure WinUSB is selected. Click "Replace/Install Driver" again. Close Zadig.
HARDWARE & BROWSER RESTART (CRITICAL):
- Unplug the μCritter's USB cable.
- Completely CLOSE your web browser (all windows).
- Re-open your web browser and navigate back to this WebDFU page.
- Re-plug the μCritter's USB cable (ensure it's still in DFU mode!).
NOW Refresh Page (if needed): The page should reload. It *might* automatically detect the state and prompt you to refresh again, or ask you to click "Connect Stage 2". Follow the on-screen prompts.

B. Windows Flashing Dance (After Zadig x2 & Restarts)

With drivers installed and everything restarted, follow the remaining prompts:

If prompted, click the button (e.g., "Connect Stage 2") and select MCUBOOT if the pop-up appears.
The status message will tell you when to Refresh the page ONE MORE TIME (Ctrl+R or F5). Follow the prompt!
After the final refresh, if prompted, click the button again (e.g., "Connect to Flash"). Flashing should begin automatically!

Watch the progress log. Your Critter will reboot automatically when done. High five!

Step 2: Linux Permissions & Flashing Dance

Alright Linux adventurers! First, a quick `udev` rule setup, then follow the on-screen prompts for flashing.

A. Create the udev Rule (One-Time Setup)

Open Terminal.
Edit Rules File: sudo nano /etc/udev/rules.d/51-mcuboot.rules

Paste Lines: Add both lines below:

SUBSYSTEM=="usb", ATTR{idVendor}=="2fe3", ATTR{idProduct}=="0100", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="2fe3", ATTR{idProduct}=="ffff", MODE="0666", GROUP="plugdev"

Group Check: Ensure your user is in `plugdev` group (`groups $USER`). If not: `sudo usermod -aG plugdev $USER`, then log out/in.

Save & Exit Nano: Ctrl+X, then Y, then Enter.
Reload Rules: sudo udevadm control --reload-rules && sudo udevadm trigger

Alternate One Liner: Alternatively, paste the one liner below into terminal and run it.

echo -e 'SUBSYSTEM=="usb", ATTR{idVendor}=="2fe3", ATTR{idProduct}=="0100", MODE="0666", GROUP="plugdev"\nSUBSYSTEM=="usb", ATTR{idVendor}=="2fe3", ATTR{idProduct}=="ffff", MODE="0666", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/51-mcuboot.rules > /dev/null && sudo usermod -aG plugdev $USER && sudo udevadm control --reload-rules && sudo udevadm trigger

Group Check: Ensure your user is in `plugdev` group (`groups $USER`). If not: `sudo usermod -aG plugdev $USER`, then log out/in.

Re-plug Critter: Unplug/replug USB while in DFU mode.

B. Linux Flashing Dance

With permissions granted, the page will now guide the connect-refresh tango:

Critter connected? DFU mode active? Good.
Click the big orange button above (text may vary based on state).
Select MCUBOOT in the browser pop-up *if needed*, click Connect.
Heads Up! If you see CAT PROTOTYPE instead of MCUBOOT, your Critter isn't in DFU mode! Go back to Step 1.
The status message above the button will tell you when to Refresh this web page (Ctrl+R or F5). Follow the prompt!
After refreshing, if prompted, click the button again (it might say "Connect Stage 2") and select MCUBOOT again if the pop-up appears.
The status message will tell you when to Refresh the page ONE MORE TIME (Ctrl+R or F5). Follow the prompt!
After the final refresh, if prompted, click the button again (it might say "Connect to Flash"). Flashing should begin automatically!

Watch the progress log. Your μCritter will restart itself when the update is complete. Nicely done!

Flash Your Critter

Step 1: Get Your Critter into DFU Mode

Step 2: macOS Flashing Dance

Step 2: Windows Driver Wrangling & Flashing Dance

A. Install the WinUSB Driver with Zadig (Do This TWICE!)

B. Windows Flashing Dance (After Zadig x2 & Restarts)

Step 2: Linux Permissions & Flashing Dance

A. Create the udev Rule (One-Time Setup)

B. Linux Flashing Dance