xref: /OK3568_Linux_fs/u-boot/doc/README.rockusb (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunRockusb (Rockchip USB protocol)
2*4882a593Smuzhiyun=====================================================
3*4882a593Smuzhiyun
4*4882a593SmuzhiyunOverview
5*4882a593Smuzhiyun--------
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunRockusb protocol is widely used by Rockchip SoC based devices. It can
8*4882a593Smuzhiyunread/write info, image to/from devices. This document briefly describes how to
9*4882a593Smuzhiyunuse Rockusb for upgrading firmware (e.g. kernel, u-boot, rootfs, etc.).
10*4882a593Smuzhiyun
11*4882a593SmuzhiyunTools
12*4882a593Smuzhiyun--------
13*4882a593SmuzhiyunThere are many tools can support Rockusb protocol. rkdeveloptool
14*4882a593Smuzhiyun(https://github.com/rockchip-linux/rkdeveloptool) is open source,
15*4882a593SmuzhiyunIt is maintained by Rockchip. People don't want to build from source
16*4882a593Smuzhiyuncan download from here
17*4882a593Smuzhiyun(https://github.com/rockchip-linux/rkbin/blob/master/tools/rkdeveloptool)
18*4882a593Smuzhiyun
19*4882a593SmuzhiyunUsage
20*4882a593Smuzhiyun--------
21*4882a593SmuzhiyunThe Usage of Rockusb command is:
22*4882a593Smuzhiyun
23*4882a593Smuzhiyunrockusb <USB_controller> <devtype> <dev[:part]>
24*4882a593Smuzhiyun
25*4882a593Smuzhiyune.g. rockusb 0 mmc 0
26*4882a593Smuzhiyun
27*4882a593SmuzhiyunOn your U-Boot console, type this command to enter rockusb mode.
28*4882a593SmuzhiyunOn your host PC. use lsusb command. you should see a usb device
29*4882a593Smuzhiyunusing 0x2207 as its USB verdor id.
30*4882a593Smuzhiyun
31*4882a593Smuzhiyunfor more detail about the rkdeveloptool. please read the usage.
32*4882a593Smuzhiyun
33*4882a593Smuzhiyunrkdeveloptool -h
34*4882a593Smuzhiyun
35*4882a593Smuzhiyunuse rkdeveloptool wl command to write lba. BeginSec is the lba on device
36*4882a593Smuzhiyunyou want to write.
37*4882a593Smuzhiyun
38*4882a593Smuzhiyunsudo rkdeveloptool wl  <BeginSec> <File>
39*4882a593Smuzhiyun
40*4882a593Smuzhiyunto flash U-Boot image use below command. U-Boot binary is made by mkimage.
41*4882a593Smuzhiyunsee doc/README.rockchip for more detail about how to get U-Boot binary.
42*4882a593Smuzhiyun
43*4882a593Smuzhiyunsudo rkdeveloptool wl  64 <U-Boot binary>
44*4882a593Smuzhiyun
45*4882a593SmuzhiyunThere are plenty of Rockusb command. but wl(write lba) and
46*4882a593Smuzhiyunrd(reboot) command. These two command can let people flash
47*4882a593Smuzhiyunimage to device.
48*4882a593Smuzhiyun
49*4882a593SmuzhiyunTo do
50*4882a593Smuzhiyun-----
51*4882a593Smuzhiyun* Fully support Rockusb protocol
52