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