Display Functions

These commands are available three ways — in the FREE-WILi GUI app, in a serial terminal, and on the device itself. See Connecting it to a computer for how to reach them.

List Display Apps

Lists the firmware images available in the SD card /apps/ directory.

How to use it — press l. At the prompt, enter: List /apps on the SD card.

Restore Display Firmware

Reflashes /apps/FW2Display.uf2 to restore the standard display GUI.

How to use it — press r. At the prompt, enter: Reflash the stock display firmware.

Display Bootloader Version

Enters the display bootloader, reads its version, and releases the link without transferring anything.

How to use it — press v. At the prompt, enter: Query the display CPU bootloader.

Reset Display CPU

Pulses the display processor reset so it cold-boots its flash image.

How to use it — press x. At the prompt, enter: Pulse the display reset line.

Power Cycle Display

Cuts the display processor's power rail and restores it, giving a true power-on reset. Heavier than Reset Display CPU, which only pulses RUN. Bootloader entry uses RUN/BOOT on its own; use this when a warm reset is not enough.

How to use it — press c. At the prompt, enter: Drop and restore the display's 3V3_S9 rail.

Set RAM App Argument

Arms up to 128 bytes for the NEXT Run RAM App, placed at a fixed address near the top of the display's RAM window. Blank clears it. An armed argument makes the launch noticeably slower: the fused bootloader cannot seek, so the loader must pad the wire up to that address.

How to use it — press g. At the prompt, enter: Text handed to the next RAM app (blank clears).

What you enter — text.

Run PSRAM App

Runs /apps/ on the display processor from PSRAM (0x11000000 window, up to 8 MB). Two-hop launch: a small SRAM stub is staged through the fused bootloader, then the stub receives the image into PSRAM and jumps to it. Flash is untouched; Reset Display CPU restores the stock firmware. The image must be a UF2 whose blocks target the PSRAM window.

How to use it — press p. At the prompt, enter: the UF2 filename in /apps.

What you enter — filename.

Load PSRAM Data

Stages /apps/ verbatim into the display's PSRAM at bytes from 0x11000000, and leaves the loader stub running instead of launching anything. For bulk assets that would otherwise have to travel inside the app's own UF2. The file is taken as raw bytes: no UF2 decode. Repeat for as many blobs as needed, then Run PSRAM App -- the stub stays resident between calls, so only the first pays the two-hop entry, and the launch overwrites only what the app image itself covers. Staged data does NOT survive a display reset.

How to use it — press s. At the prompt, enter: Filename in /apps and a hex PSRAM offset.

What you enter — filename, offset.

See also: Display Apps panel — the on-screen panel for this.