File: rkdeveloptool.1.scd

package info (click to toggle)
rkdeveloptool 1.32%2Bpine64git20240226.17823e9-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 396 kB
  • sloc: cpp: 7,346; sh: 16; makefile: 4
file content (117 lines) | stat: -rw-r--r-- 2,589 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
rkdeveloptool(1) "rkdeveloptool"

# 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 }

# DESCRIPTION

Reads or writes the storage of a rockchip device booted into the rockusb
bootloader mode

# OPTIONS

*-h, --help*
	Show the help message and quit

*-v, --version*
	Show the version number and quit

# COMMANDS

*list*
	Show the connected devices

*list-partitions*
	Show the GPT partition table entries if a GPT table exists on the flash

*read* START-SECTOR NUM-BYTES FILENAME
	Read the specified number of bytes from the sector offset into the specified
	file

*read-partition* PARTITION FILENAME
	Read the contents of a named partition to a file

*write* START-SECTOR FILENAME
	Write the contents of the file to the eMMC starting at a specific sector

*write-partition* PARTITION FILENAME
	Write the contents of the file into a named partition

*write-partition-table* DEFINITION-FILE
	Write a new GPT partition table block with partitions defined in a file

*write-parameter* ?
	Not sure what this does

*erase-flash*
	Wipe the internal flash storage

*boot* FILENAME
	Load an image into ram and boot it

*test-device*
	Check if there is a device attached in the ready state

*upgrade-loader* FILENAME
	Write a new rockusb bootloader to the flash

*reset* [SUBCODE]
	Reset the device. Optionally with a subcode which is a number between 0
	and 5

*reboot*
	Reboot the device, this is an alias for *reset 0*

*reboot-maskrom*
	Reset the device and trigger maskrom mode

*shutdown*
	Reset device without triggering a reboot

*read-flash-id*
	Read the eMMC flash id

*read-flash-info*
	Read the flash chip specifications

*read-chip-info*
	Read the SoC info bytes

*read-capability*
	Read the permissions of the rockusb bootloader

*pack*
	Merge a boot image

*unpack* [FILENAME]
	Unpack a boot image into the separate files

*tag-spl* [TAG] [SPL-FILE]
	Prepend the tag to the SPL-FILE and save 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