rkdeveloptool(1)

🌸 rkdeveloptool(1) — the rockusb bootloader utility, bestie edition 💅

okay so like, this is a General Commands Manual page for rkdeveloptool(1), and if you've ever got a Rockchip device chillin' in rockusb bootloader mode, this is your girl. she reads and writes storage. that's the whole vibe. ✨

---

✨ NAME ✨

rkdeveloptool — rockusb bootloader utility 🦋

---

🎀 SYNOPSIS 🎀

rkdeveloptool [OPTIONS] COMMAND [ARGS]...

COMMAND := {list | list-partitions | read | read-partition | write |
write-partition | write-partition-table | write-parameter | erase-flash
| boot | test-device | upgrade-loader | reset | reboot | reboot-maskrom
| shutdown | read-flash-id | read-flash-info | read-chip-info | read-
capability | pack | unpack | tag-spl }

OPTIONS := { -h | -v }

like... that's a LOT of commands, and she ate every single one 💖

---

💜 DESCRIPTION 💜

Reads or writes the storage of a rockchip device booted into the rockusb bootloader mode. that's it, that's the whole job description. no cap. 🔥

---

✨ OPTIONS ✨

• -h, --help — shows you the help message and then dips out 👋
• -v, --version — shows you the version number and also dips out. iconic behavior, honestly 🫶

---

👑 COMMANDS 👑

okay bestie, buckle up, this is the main character section 🌈

• list — shows all the connected devices. the vibe check of commands. 🔍
• list-partitions — shows the GPT partition table entries... but only if a GPT table actually exists on the flash. no GPT, no entries, that's just how it is 💀
• read START-SECTOR NUM-BYTES FILENAME — reads the specified number of bytes starting from the sector offset, and drops them into the specified file. 📖
• read-partition PARTITION FILENAME — reads the contents of a named partition into a file. so cute, so simple 🎀
• write START-SECTOR FILENAME — writes the contents of the file to the eMMC, starting at a specific sector. ✍️
• write-partition PARTITION FILENAME — writes the contents of the file into a named partition.
• write-partition-table DEFINITION-FILE — writes a whole new GPT partition table block, with the partitions defined in a file. ✨
• write-parameter ? — not sure what this does 🙈 literally the manpage says so, don't come for me
• erase-flash — wipes the internal flash storage. gone. deleted. bye. ⚠️
• boot FILENAME — loads an image into ram and boots it. main character energy fr fr 🚀
• test-device — checks if there's a device attached in the ready state. are you there bestie? 👀
• upgrade-loader FILENAME — writes a brand new rockusb bootloader to the flash. glow-up time 💅
• reset [SUBCODE] — resets the device. optionally you can pass a subcode, which is a number between 0 and 5. 🔄
• reboot — reboots the device. this is literally just an alias for reset 0, iykyk
• reboot-maskrom — resets the device and triggers maskrom mode. secret menu unlocked 🕵️
• shutdown — resets the device without triggering a reboot. night night 😴
• read-flash-id — reads the eMMC flash id. 🆔
• read-flash-info — reads the flash chip specifications. the spec sheet moment 📋
• read-chip-info — reads the SoC info bytes. 🧠
• read-capability — reads the permissions of the rockusb bootloader. what are you allowed to do, bestie? 🔐
• pack — merges a boot image. 🧳
• unpack [FILENAME] — unpacks a boot image into the separate files. reverse uno card 🃏
• tag-spl [TAG] [SPL-FILE] — prepends the tag to the SPL-FILE and saves it as filename.tag. 🏷️

---

🌸 EXAMPLES 🌸

Backup a partition of the device 💾

rkdeveloptool read-partition uboot uboot.img

Restore a partition of the device ♻️

rkdeveloptool write-partition uboot uboot.img

Read the bootloader magic block from sector 64 🔮

rkdeveloptool read 64 512 bootloader-magic.bin

---

lowkey reminder bestie: erase-flash does NOT play. it wipes your internal flash storage. no takebacks. 🚨

---

and that's the whole page, slay! this was rkdeveloptool, version dated 2024-06-19, from your friendly neighborhood rkdeveloptool manual. go forth and flash responsibly 💖✨🎀🦋🌸💅🫶