Skip to content

PineNote: improve instructions on entering maskrom mode from u-boot #154

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gamelaster merged 1 commit into from
Feb 22, 2026
+11 −0
Merged

PineNote: improve instructions on entering maskrom mode from u-boot #154

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions content/documentation/PineNote/Development/Flashing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,17 @@ The community edition is shipped with Debian and a passive pen without a magnet,

#### U-Boot terminal

##### Stock UART dongle

The [stock UART dongle](/documentation/PineNote/Development/UART#stock_dongle) does not support regular USB functions while plugged in. It must be removed after entering maskrom so the host can communicate with the device in maskrom mode.

1. Connect to the PineNote via UART and USB simultaneously
2. Interrupt the U-Boot startup using `ctrl+c` sent over UART
3. In the U-Boot terminal over UART, run `rockusb 0 mmc 0`. The UART terminal should print `RKUSB` and display a spinner.
4. Remove the UART dongle and connect directly to the PineNote. `rkdeveloptool list` should now list the PineNote.

##### Non-stock UART dongle with passthrough

This method requires a [UART dongle with passthrough](/documentation/PineNote/Development/UART#usb_passthrough) allowing simultaneous UART & USB connections.

It is nice because you can easily switch back & forth between U-Boot and Rockusb without having to physically manipulate the PineNote or its connectors; this is especially helpful when trying to develop U-Boot.
Expand Down