Radxa Wiki - User contributions [en]

Rock/Booting Linux

2016-01-25T02:58:30Z

Jack:

{{rock_header}}

{{Languages|rock/Booting Linux}}

__TOC__

== Requirement ==

* a radxa rock board (check your [[Rock/hardware revision|hardware revision]])
* a desktop/laptop running Linux(64bit preferred)
* a micro usb cable, one side plugged in to the OTG port of radxa rock, the other side plugged in to the usb port on desktop/laptop

== Prepare the build environment ==

=== Install the packages ===

Install packages for building kernel if you don't have them on your host.

sudo apt-get install build-essential lzop libncurses5-dev libssl-dev
If build on 64bit machine, also need to install:
sudo apt-get install libc6:i386

=== Install the toolchain ===

Refer [[Rock/install_toolchain | install toolchain]]

you can use any toolchain if you are sure it works, or you may have to fix any error introduced by toolchain.

=== Get the source code ===

git clone -b radxa-stable-3.0 https://github.com/radxa/linux-rockchip.git

or download here
http://pan.baidu.com/s/1jfOTo (china)

== Build the kernel ==

cd linux-rockchip

if your Rock is pro(Mid 2014) or the new lite(Mid 2014), check out [[Rock/hardware_revision| hardware revision]]

if you use the HDMI for dispaly device
make radxa_rock_pro_linux_hdmi_defconfig
or you use the LCD for the primary display device(hdmi dual display at the same time)
make radxa_rock_pro_linux_lvds_defconfig

if your rock is full version(2013) or engineering sample or the old lite(2013), use radxa_rock_linux_defconfig, check out [[Rock/hardware_revision| hardware revision]]
make radxa_rock_linux_defconfig

make -j8 kernel.img

The kernel will be at '''kernel.img''' (image for kernel partition) and '''arch/arm/boot/Image''' (raw binary)

if you want LZO compressed kernel, specify zkernel.img

make -j8 zkernel.img

The kernel will be at '''kernel.img''' (image for kernel partition) and '''arch/arm/boot/zImage''' (compressed binary)

=== Build the kernel modules ===

mkdir modules
make INSTALL_MOD_PATH=./modules modules modules_install

Now you have kernel modules in '''modules/lib/modules/''' and firmwares for some devices in '''modules/lib/firmware/'''.

== Generate the image ==

=== Generate the initramfs ===

cd ..
git clone https://github.com/radxa/initrd.git
make -C initrd

=== Generate the boot.img ===

Install mkbootimg

git clone https://github.com/neo-technologies/rockchip-mkbootimg.git
cd rockchip-mkbootimg
make
sudo make install
cd ..

Make boot.img

mkbootimg --kernel linux-rockchip/arch/arm/boot/Image --ramdisk initrd.img -o boot.img

Done. Now we have the '''boot.img''' (image for boot/recovery partition) for RR.

== Modify the parameter ==
There is a demo for parameter for sdcard you can get it or copy it to parameter file, but before you use you should modify it as the following guide

wget http://dl.radxa.com/rock/images/parameter/parameter_linux_sd

The linux rootfs can be put on the different partition or media(nand or uSD card or USB disk), so you need to tell the kernel which is the right rootfs to mount. So change the root= command line in your parameter to the rootfs you want to mount. The examples are:

root=/dev/block/mtd/by-name/linuxroot # rootfs in the nand partition named "linuxroot"
root=/dev/mmcblk0p1 # rootfs in the uSD card first partition
root=/dev/sda1 # rootfs in the U disk or the USB hard drive first partition
root=LABEL=linuxroot # rootfs in the partition with label "linuxroot", can be in uSD, U disk or USB hard drive.

== Next step ==

Now you refer [[rock/flash the image| flash the image]] to flash the generated boot.img to "boot" [[rock/partitions | partition]] parameter to "parameter" partition of your radxa rock board. And download a [http://dl.radxa.com/rock/images/ubuntu/latest/ prebuilt rootfs] or [[rock/ubuntu |make your own rootfs]]. You will get linux system boot into ramdisk and then switch root to real rootfs.

Rock/Camera

2015-08-05T12:00:32Z

Jack: /* CSI */

{{rock_header}}
__TOC__

== USB ==
=== Support list ===
Below is the list of the USB cameras supported by Radxa Rock stock Android firmware.

* '''Logitech''' C110/C210/C270
* '''madsn''' MD-903
* '''teclast''' L200
* '''bluelover''' T998
* '''gsou''' B18/D30/D50
* '''HYUNDAI''' S36

== CSI ==
On rock pro/lite, there is CSI camera interfaces, the rock pro/lite default kernel supports '''OV5640''' and '''OV2659''' sensors. Most sensors of this two model on the market are compatible with rock pro/lite on hardware. Note, the kernel should be newer than July, 25th. Check [https://github.com/radxa/linux-rockchip/commit/f0700a581320c2304dbfcd8ef682126e54ce5a36 this commit].

Kernel driver supports resolution 800*600, '''NV16''', '''YUV422P''' and '''YUYV''' formats.

Read image with ffmpeg from command line
.
ffmpeg -f video4linux2 -s 800*600 -r 20 -i /dev/video0 test.mp4

Program with V4L2 library examples.

NV16 format read and display example.
http://dl.radxa.com/users/jack/camera/sample/cap_img_nv16.c
# gcc -o cap_img_nv16 cap_img_nv16.c
# ./cap_img_nv16 -d /dev/videoX //your camera device

YUV422P format read and display example.
http://dl.radxa.com/users/jack/camera/sample/cap_img_yuv422p.c
# gcc -o cap_img_yuv422p cap_img_yuv422p.c
# ./cap_img_yuv422p -d /dev/videoX //your camera device

YUYV format read and display example.
http://dl.radxa.com/users/jack/camera/sample/cap_img_yuyv.c
# gcc -o cap_img_yuyv cap_img_yuyv.c
# ./cap_img_yuyv -d /dev/videoX //your camera device

Rock/Camera

2015-08-05T11:58:52Z

Jack: /* CSI */

{{rock_header}}
__TOC__

== USB ==
=== Support list ===
Below is the list of the USB cameras supported by Radxa Rock stock Android firmware.

* '''Logitech''' C110/C210/C270
* '''madsn''' MD-903
* '''teclast''' L200
* '''bluelover''' T998
* '''gsou''' B18/D30/D50
* '''HYUNDAI''' S36

== CSI ==
On rock pro/lite, there is CSI camera interfaces, the rock pro/lite default kernel supports '''OV5640''' and '''OV2659''' sensors. Most sensors of this two model on the market are compatible with rock pro/lite on hardware. Note, the kernel should be newer than July, 25th. Check [https://github.com/radxa/linux-rockchip/commit/f0700a581320c2304dbfcd8ef682126e54ce5a36 this commit].

Kernel driver supports resolution 800*600, '''NV16''' '''YUV422P''' and '''YUYV''' formats.

Read image with ffmpeg from command line
.
ffmpeg -f video4linux2 -s 800*600 -r 20 -i /dev/video0 test.mp4

Program with V4L2 library examples.

NV16 format read and display example.
http://dl.radxa.com/users/jack/camera/sample/cap_img_nv16.c
# gcc -o cap_img_nv16 cap_img_nv16.c
# ./cap_img_nv16 -d /dev/videoX //your camera device

YUV422P format read and display example.
http://dl.radxa.com/users/jack/camera/sample/cap_img_yuv422p.c
# gcc -o cap_img_yuv422p cap_img_yuv422p.c
# ./cap_img_yuv422p -d /dev/videoX //your camera device

YUYV format read and display example.
http://dl.radxa.com/users/jack/camera/sample/cap_img_yuyv.c
# gcc -o cap_img_yuyv cap_img_yuyv.c
# ./cap_img_yuyv -d /dev/videoX //your camera device

Rock/Camera

2015-08-05T01:16:45Z

Jack: /* CSI */

{{rock_header}}
__TOC__

== USB ==
=== Support list ===
Below is the list of the USB cameras supported by Radxa Rock stock Android firmware.

* '''Logitech''' C110/C210/C270
* '''madsn''' MD-903
* '''teclast''' L200
* '''bluelover''' T998
* '''gsou''' B18/D30/D50
* '''HYUNDAI''' S36

== CSI ==
On rock pro/lite, there is CSI camera interfaces, the rock pro/lite default kernel supports '''OV5640''' and '''OV2659''' sensors. Most sensors of this two model on the market are compatible with rock pro/lite on hardware. Note, the kernel should be newer than July, 25th. Check [https://github.com/radxa/linux-rockchip/commit/f0700a581320c2304dbfcd8ef682126e54ce5a36 this commit].

Kernel driver supports resolution 800*600, '''NV16''' and '''YUV420P''' formats.

Read image with ffmpeg from command line
.
ffmpeg -f video4linux2 -s 800*600 -r 20 -i /dev/video0 test.mp4

Program with V4L2 library examples.

NV16 format read and display example.
http://dl.radxa.com/users/jack/cap_img_nv16.c
# gcc -o cap_img_nv16 cap_img_nv16.c
# ./cap_img_nv16 -d /dev/videoX //your camera device

YUV422P format read and display example.
http://dl.radxa.com/users/jack/cap_img_yuv422p.c
# gcc -o cap_img_yuv422p cap_img_yuv422p.c
# ./cap_img_yuv422p -d /dev/videoX //your camera device

Rock/Camera

2015-08-04T12:48:08Z

Jack: /* CSI */

Rock2/wireless

2015-07-09T12:43:55Z

Jack:

{{rock2_header}}
1 change user to root
sudo su

2 install and config hostapd
#apt-get install hostapd
#vim.tiny /etc/hostapd/hostapd.conf
interface=wlan0
ctrl_interface=/var/run/hostapd
ssid=squareAP
channel=6
wpa=2
wpa_passphrase=12345678
#bridge=br0

3 install and config dnsmasq
#apt-get install dnsmasq
#vim.tiny /etc/dnsmasq.conf
interface=wlan0
bind-interfaces
except-interface=lo
dhcp-range=192.168.2.150,192.168.2.254,12h #configure the range of available ip
dhcp-option=3,192.168.2.1 #configure the server

4 edit /etc/network/interfaces
#vim.tiny /etc/network/interfaces
# interfaces(5) file used by ifup(8) and ifdown(8)
auto wlan0
iface wlan0 inet static
address 192.168.2.1
netmask 255.255.255.0

5 install haveged
#apt-get install haveged

6 start ap
#sudo su
#echo 2 > /sys/module/bcmdhd/parameters/op_mode
#hostapd -B /etc/hostapd/hostapd.conf
#ip addr add 192.168.2.1/24 dev wlan0
#service dnsmasq start
#echo 1 > /proc/sys/net/ipv4/ip_forward
#iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
#/etc/init.d/haveged start

7 change from AP mode to normal mode
#echo 0 > /sys/module/bcmdhd/parameters/op_mode
#reboot

Rock2/wireless

2015-07-09T12:41:42Z

Jack:

Rock2/wireless

2015-07-09T12:38:30Z

Jack:

{{rock2_header}}
1 change user to root
sudo su

2 install and config hostapd
#apt-get install hostapd
#vim.tiny /etc/hostapd/hostapd.conf
interface=wlan0
ctrl_interface=/var/run/hostapd
ssid=squareAP
channel=6
wpa=2
wpa_passphrase=12345678
#bridge=br0

3 install and config dnsmasq
#apt-get install dnsmasq
#vim.tiny /etc/dnsmasq.conf
interface=wlan0
bind-interfaces
except-interface=lo
dhcp-range=192.168.2.150,192.168.2.254,12h #configure the range of available ip
dhcp-option=3,192.168.2.1 #configure the server

4 edit /etc/network/interfaces
#vim.tiny /etc/network/interfaces
# interfaces(5) file used by ifup(8) and ifdown(8)
auto wlan0
iface wlan0 inet static
address 192.168.2.1
netmask 255.255.255.0

5 install haveged
#apt-get install haveged

6 start ap
#sudo su
#echo 2 > /sys/module/bcmdhd/parameters/op_mode
#hostapd -B /etc/hostapd/hostapd.conf
#ip addr add 192.168.2.1/24 dev wlan0
#service dnsmasq start
#echo 1 > /proc/sys/net/ipv4/ip_forward
#iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
#/etc/init.d/haveged start

7 change from AP mode to normal mode
#sudo su
#echo 0 > /sys/module/bcmdhd/parameters/op_mode
#reboot

Rock2/wireless

2015-07-09T10:05:52Z

Jack:

Rock2/wireless

2015-07-09T10:04:07Z

Jack:

{{rock2_header}}
1 change user to root
sudo su

2 install and config hostapd
#apt-get install hostapd
#vim.tiny /etc/hostapd/hostapd.conf
interface=wlan0
ctrl_interface=/var/run/hostapd
ssid=squareAP
channel=6
wpa=2
wpa_passphrase=12345678
#bridge=br0

3 install and config dnsmasq
#apt-get install dnsmasq
#vim.tiny /etc/dnsmasq.conf
interface=wlan0
bind-interfaces
except-interface=lo
dhcp-range=192.168.2.150,192.168.2.254,12h #configure the range of available ip
dhcp-option=3,192.168.2.1 #configure the server

4 edit /etc/network/interfaces
#vim.tiny /etc/network/interfaces
# interfaces(5) file used by ifup(8) and ifdown(8)
auto wlan0
iface wlan0 inet static
address 192.168.2.1
netmask 255.255.255.0

5 install haveged
#apt-get install haveged

6 start ap
#echo 2 > /sys/module/bcmdhd/parameters/op_mode
#hostapd -B /etc/hostapd/hostapd.conf
#ip addr add 192.168.2.1/24 dev wlan0
#service dnsmasq start
#echo 1 > /proc/sys/net/ipv4/ip_forward
#iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
#/etc/init.d/haveged start

Rock/linein

2015-06-04T02:05:48Z

Jack: rock pro/lite line in

{{rock_header}}

There are Line In from the extension header on rock pro. The latest Rabian has enabled Line in.

1 Tested module
http://detail.tmall.com/item.htm?spm=a1z10.3-b.w4011-3079905380.27.SocVjO&id=42576261888&rn=b482a0f48f9bab9ef1f5e1ffb433daed&abbucket=7#
Module power supply pins VCC GND connect to pro/lite extend port J8 pins 2 1.
Module audio out pin OUT connect to pro/lite extend port J8 pins 5/6.

2 Select capture from mic / line in
echo 1 > /tmp/rk1000_input_sel #RK1000 capture from mic
echo 2 > /tmp/rk1000_input_sel #RK1000 capture from line in

3 test cmd
capture:
arecord -D 'default' -V stereo -c 2 -f dat -d 100 out.wav #100 capture duration

Rock/linein

2015-06-01T07:44:34Z

Jack: rock pro/lite line in

1 Tested module
http://detail.tmall.com/item.htm?spm=a1z10.3-b.w4011-3079905380.27.SocVjO&id=42576261888&rn=b482a0f48f9bab9ef1f5e1ffb433daed&abbucket=7#
Module power supply pins VCC GND connect to pro/lite extend port J8 pins 2 1.
Module audio out pin OUT connect to pro/lite extend port J8 pins 5/6.

2 Select capture from mic / line in
echo 1 > /tmp/rk1000_input_sel #RK1000 capture from mic
echo 2 > /tmp/rk1000_input_sel #RK1000 capture from line in

Rock/linein

2015-06-01T07:34:24Z

Jack: rock pro/lite line in

1 Line in signal connect
Line in signal can connect to rock pro/lite extend port J8 PIN 5/6.

2 Select capture from mic / line in
echo 1 > /tmp/rk1000_input_sel #RK1000 capture from mic
echo 2 > /tmp/rk1000_input_sel #RK1000 capture from line in

3 Tested module
http://detail.tmall.com/item.htm?spm=a1z10.3-b.w4011-3079905380.27.SocVjO&id=42576261888&rn=b482a0f48f9bab9ef1f5e1ffb433daed&abbucket=7#

Rock2/wireless

2015-05-05T07:50:07Z

Jack:

1 change ap6335 mode and install driver
echo 2 > /sys/module/bcmdhd/parameters/op_mode
install ap6335 driver
insmod wlan.ko or echo 1 > /sys/class/rkwifi/driver

2 install and config hostapd
apt-get install hostapd
edit /etc/hostapd/hostapd.conf
interface=wlan0
ctrl_interface=/var/run/hostapd
ssid=squareAP
channel=6
wpa=2
wpa_passphrase=12345678
#bridge=br0

3 install and config dnsmasq
apt-get install dnsmasq
edit /etc/dnsmasq.conf
interface=wlan0
bind-interfaces
except-interface=lo
dhcp-range=192.168.2.150,192.168.2.254,12h #configure the range of available ip
dhcp-option=3,192.168.2.1 #configure the server

4 edit /etc/network/interfaces
# interfaces(5) file used by ifup(8) and ifdown(8)
auto wlan0
iface wlan0 inet static
address 192.168.2.1
netmask 255.255.255.0

5 install haveged
apt-get install haveged

6 start ap
hostapd -B /etc/hostapd/hostapd.conf
ip addr add 192.168.2.1/24 dev wlan0
service dnsmasq start
echo 1 > /proc/sys/net/ipv4/ip_forward
iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
/etc/init.d/haveged start

Rock2/wireless

2015-05-05T07:47:42Z

Jack: Rock2 AP6335 AP mode

1 change ap6335 mode and install driver
echo 2 > /sys/module/bcmdhd/parameters/op_mode
install ap6335 driver
insmod wlan.ko or echo 1 > /sys/class/rkwifi/driver

2 install hostapd
edit /etc/hostapd/hostapd.conf
interface=wlan0
ctrl_interface=/var/run/hostapd
ssid=squareAP
channel=6
wpa=2
wpa_passphrase=12345678
#bridge=br0

3 install and config dnsmasq
apt-get install dnsmasq
edit /etc/dnsmasq.conf
interface=wlan0
bind-interfaces
except-interface=lo
dhcp-range=192.168.2.150,192.168.2.254,12h #configure the range of available ip
dhcp-option=3,192.168.2.1 #configure the server

4 edit /etc/network/interfaces
# interfaces(5) file used by ifup(8) and ifdown(8)
auto wlan0
iface wlan0 inet static
address 192.168.2.1
netmask 255.255.255.0

5 install haveged
apt-get install haveged

6 start ap
hostapd -B /etc/hostapd/hostapd.conf
ip addr add 192.168.2.1/24 dev wlan0
service dnsmasq start
echo 1 > /proc/sys/net/ipv4/ip_forward
iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
/etc/init.d/haveged start

Rock/U-Boot

2015-01-19T03:47:36Z

Jack: /* Flash */

{{rock_header}}
{{Languages|rock/U-Boot}}

== Features ==

* both Rockchip proprietary USB protocol and fastboot USB protocol are supported (Rockchip USB tools works)
* format of partitions (images) are compatible to Rockchip proprietary bootloader (rkcrc, mkbootimg works)
* (need more investigation...)

== For NAND flash ==

=== Build ===
Refer [[Rock/install_toolchain | install toolchain]] if you don't have arm-eabi- on your system. Other toolchain(Linaro arm-linux-gnueabihf-gcc 4.9) may cause data abort errors.
git clone -b u-boot-rk3188 https://github.com/radxa/u-boot-rockchip.git
cd u-boot-rockchip
make rk30xx

The binary we need for nand flash are '''RK3188Loader_miniall.bin''' and '''uboot.img'''.

=== Flash ===
refer [[rock/flash_the_image| flash image page]]

use the new u-boot to erase the old loader
sudo upgrade_tool ef RK3188Loader_miniall.bin

flash new loader
sudo upgrade_tool ul RK3188Loader_miniall.bin

format NAND (first time only)
sudo upgrade_tool lf

flash parameter
upgrade_tool di -p parameter

paramter file
FIRMWARE_VER:4.2.2
MACHINE_MODEL:radxa_rock
MACHINE_ID:007
MANUFACTURER:RADXA
MAGIC: 0x5041524B
ATAG: 0x60000800
MACHINE: 3066
CHECK_MASK: 0x80
KERNEL_IMG: 0x60408000
CMDLINE:console=ttyFIQ0,115200 console=tty0 root=/dev/block/mtd/by-name/linuxroot rw rootfstype=ext4 init=/sbin/init mac_addr=de:ad:de:ad:be:ef initrd=0x62000000,0x00800000 mtdparts=rk29xxnand:0x00002000@0x00002000(uboot),0x00008000@0x00004000(boot),-@0x000c0000(linuxroot)

flash U-Boot
sudo upgrade_tool wl 0x2000 uboot.img
sudo upgrade_tool rd

flash kernel + ramdisk
upgrade_tool di -b boot-linux.img

flash root fs
upgrade_tool di linuxroot rootfs.img

Booting log can be found at: http://paste.ubuntu.com/9623598/

== For SD card ==
=== Build ===
Refer [[Rock/install_toolchain | install toolchain]] if you don't have arm-eabi- on your system. Other toolchain(Linaro arm-linux-gnueabihf-gcc 4.9) may cause data abort errors.
git clone -b u-boot-rk3188-sdcard https://github.com/radxa/u-boot-rockchip.git
cd u-boot-rockchip
make rk30xx
./pack-sd.sh

The binary we need for sdcard is '''u-boot-sd.img'''.

=== Flash ===

sudo dd if=u-boot-sd.img of=/dev/sdx seek=64

Insert the uSD card to rock pro, it will boot from u-boot on uSD card.

== Develop ==

Some important files and directories related to the Rockchip platform:

* [https://github.com/radxa/u-boot-rockchip/blob/master/UserManual '''UserManual'''] - documentation
* [https://github.com/radxa/u-boot-rockchip/blob/master/include/configs/rk30xx.h '''include/configs/rk30xx.h'''] - configuration file
* [https://github.com/radxa/u-boot-rockchip/tree/master/tools/rk_tools '''tools/rk_tools''']

* [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip '''board/rockchip''']
├── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common '''common''']
│   ├── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common/armlinux '''armlinux''']
│   ├── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common/common '''common''']
│   │   ├── A8MMU
│   │   ├── crc
│   │   ├── emmc
│   │   ├── fat
│   │   ├── rc4
│   │   ├── rockusb
│   │   ├── serial_p9
│   │   └── SPI
│   └── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common/platform '''platform''']
│   ├── rk2928
│   └── rk30
└── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/rk30xx '''rk30xx''']

* [https://github.com/radxa/u-boot-rockchip/tree/master/arch/arm/cpu/armv7/rk30xx '''arch/arm/cpu/armv7/rk30xx''']
* [https://github.com/radxa/u-boot-rockchip/blob/master/arch/arm/include/asm/arch-rk30xx/ '''arch/arm/include/asm/arch-rk30xx''']

== Unbrick ==

If something goes wrong and your device doesn't boot anymore, read [[rock/unbrick | Unbrick Rock]].

== External links ==

* http://androtab.info/rockchip/u-boot/ (working binaries)
* https://github.com/linux-rockchip/u-boot-rockchip (some improvement)

Rock/U-Boot

2015-01-19T02:33:06Z

Jack: /* Flash */

{{rock_header}}
{{Languages|rock/U-Boot}}

== Features ==

* both Rockchip proprietary USB protocol and fastboot USB protocol are supported (Rockchip USB tools works)
* format of partitions (images) are compatible to Rockchip proprietary bootloader (rkcrc, mkbootimg works)
* (need more investigation...)

== For NAND flash ==

=== Build ===
Refer [[Rock/install_toolchain | install toolchain]] if you don't have arm-eabi- on your system. Other toolchain(Linaro arm-linux-gnueabihf-gcc 4.9) may cause data abort errors.
git clone -b u-boot-rk3188 https://github.com/radxa/u-boot-rockchip.git
cd u-boot-rockchip
make rk30xx

The binary we need for nand flash are '''RK3188Loader_miniall.bin''' and '''uboot.img'''.

=== Flash ===
refer [[rock/flash_the_image| flash image page]]

use the new u-boot to erase the old loader
sudo upgrade_tool ef RK3188Loader_miniall.bin

flash new loader
sudo upgrade_tool ul RK3188Loader_miniall.bin

format NAND (first time only)
sudo upgrade_tool lf

flash parameter
upgrade_tool di -p parameter

paramter file
FIRMWARE_VER:4.2.2
MACHINE_MODEL:radxa_rock
MACHINE_ID:007
MANUFACTURER:RADXA
MAGIC: 0x5041524B
ATAG: 0x60000800
MACHINE: 3066
CHECK_MASK: 0x80
KERNEL_IMG: 0x60408000
CMDLINE:console=ttyFIQ0,115200 console=tty0 root=/dev/block/mtd/by-name/linuxroot rw rootfstype=ext4 init=/sbin/init mac_addr=de:ad:de:ad:be:ef initrd=0x62000000,0x00800000 mtdparts=rk29xxnand:0x00002000@0x00002000(uboot),0x00008000@0x00004000(boot),-@0x000c0000(linuxroot)

flash U-Boot
sudo upgrade_tool wl 0x2000 uboot.img
sudo upgrade_tool rd

flash kernel
upgrade_tool di -b boot-linux.img

flash root fs
upgrade_tool di linuxroot rootfs.img

Booting log can be found at: http://paste.ubuntu.com/9623598/

== For SD card ==
=== Build ===
Refer [[Rock/install_toolchain | install toolchain]] if you don't have arm-eabi- on your system. Other toolchain(Linaro arm-linux-gnueabihf-gcc 4.9) may cause data abort errors.
git clone -b u-boot-rk3188-sdcard https://github.com/radxa/u-boot-rockchip.git
cd u-boot-rockchip
make rk30xx
./pack-sd.sh

The binary we need for sdcard is '''u-boot-sd.img'''.

=== Flash ===

sudo dd if=u-boot-sd.img of=/dev/sdx seek=64

Insert the uSD card to rock pro, it will boot from u-boot on uSD card.

== Develop ==

Some important files and directories related to the Rockchip platform:

* [https://github.com/radxa/u-boot-rockchip/blob/master/UserManual '''UserManual'''] - documentation
* [https://github.com/radxa/u-boot-rockchip/blob/master/include/configs/rk30xx.h '''include/configs/rk30xx.h'''] - configuration file
* [https://github.com/radxa/u-boot-rockchip/tree/master/tools/rk_tools '''tools/rk_tools''']

* [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip '''board/rockchip''']
├── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common '''common''']
│   ├── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common/armlinux '''armlinux''']
│   ├── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common/common '''common''']
│   │   ├── A8MMU
│   │   ├── crc
│   │   ├── emmc
│   │   ├── fat
│   │   ├── rc4
│   │   ├── rockusb
│   │   ├── serial_p9
│   │   └── SPI
│   └── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common/platform '''platform''']
│   ├── rk2928
│   └── rk30
└── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/rk30xx '''rk30xx''']

* [https://github.com/radxa/u-boot-rockchip/tree/master/arch/arm/cpu/armv7/rk30xx '''arch/arm/cpu/armv7/rk30xx''']
* [https://github.com/radxa/u-boot-rockchip/blob/master/arch/arm/include/asm/arch-rk30xx/ '''arch/arm/include/asm/arch-rk30xx''']

== Unbrick ==

If something goes wrong and your device doesn't boot anymore, read [[rock/unbrick | Unbrick Rock]].

== External links ==

* http://androtab.info/rockchip/u-boot/ (working binaries)
* https://github.com/linux-rockchip/u-boot-rockchip (some improvement)

Rock/U-Boot

2015-01-19T02:04:44Z

Jack: /* Flash */

{{rock_header}}
{{Languages|rock/U-Boot}}

== Features ==

* both Rockchip proprietary USB protocol and fastboot USB protocol are supported (Rockchip USB tools works)
* format of partitions (images) are compatible to Rockchip proprietary bootloader (rkcrc, mkbootimg works)
* (need more investigation...)

== For NAND flash ==

=== Build ===
Refer [[Rock/install_toolchain | install toolchain]] if you don't have arm-eabi- on your system. Other toolchain(Linaro arm-linux-gnueabihf-gcc 4.9) may cause data abort errors.
git clone -b u-boot-rk3188 https://github.com/radxa/u-boot-rockchip.git
cd u-boot-rockchip
make rk30xx

The binary we need for nand flash are '''RK3188Loader_miniall.bin''' and '''uboot.img'''.

=== Flash ===
refer [[rock/flash_the_image| flash image page]]

use the new u-boot to erase the old loader
sudo upgrade_tool ef RK3188Loader_miniall.bin

flash new loader
sudo upgrade_tool ul RK3188Loader_miniall.bin

format NAND (first time only)
sudo upgrade_tool lf

flash parameter
upgrade_tool di -p parameter

paramter file
FIRMWARE_VER:4.2.2
MACHINE_MODEL:radxa_rock
MACHINE_ID:007
MANUFACTURER:RADXA
MAGIC: 0x5041524B
ATAG: 0x60000800
MACHINE: 3066
CHECK_MASK: 0x80
KERNEL_IMG: 0x60408000
CMDLINE:console=ttyFIQ0,115200 console=tty0 root=/dev/block/mtd/by-name/linuxroot rw rootfstype=ext4 init=/sbin/init mac_addr=de:ad:de:ad:be:ef initrd=0x62000000,0x00800000 mtdparts=rk29xxnand:0x00002000@0x00002000(uboot),0x00008000@0x00004000(boot),-@0x000c0000(linuxroot)

flash U-Boot
sudo upgrade_tool wl 0x2000 uboot.img
sudo upgrade_tool rd

flash kernel
upgrade_tool di -b boot-linux.img

flash root fs
upgrade_tool di linuxroot rootfs.img

Booting log can be found at: http://paste.ubuntu.com/9623598/

== For SD card ==
=== Build ===
Refer [[Rock/install_toolchain | install toolchain]] if you don't have arm-eabi- on your system. Other toolchain(Linaro arm-linux-gnueabihf-gcc 4.9) may cause data abort errors.
git clone -b u-boot-rk3188-sdcard https://github.com/radxa/u-boot-rockchip.git
cd u-boot-rockchip
make rk30xx
./pack-sd.sh

The binary we need for sdcard is '''u-boot-sd.img'''.

=== Flash ===

sudo dd if=u-boot-sd.img of=/dev/sdx seek=64

Insert the uSD card to rock pro, it will boot from u-boot on uSD card.

== Develop ==

Some important files and directories related to the Rockchip platform:

* [https://github.com/radxa/u-boot-rockchip/blob/master/UserManual '''UserManual'''] - documentation
* [https://github.com/radxa/u-boot-rockchip/blob/master/include/configs/rk30xx.h '''include/configs/rk30xx.h'''] - configuration file
* [https://github.com/radxa/u-boot-rockchip/tree/master/tools/rk_tools '''tools/rk_tools''']

* [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip '''board/rockchip''']
├── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common '''common''']
│   ├── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common/armlinux '''armlinux''']
│   ├── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common/common '''common''']
│   │   ├── A8MMU
│   │   ├── crc
│   │   ├── emmc
│   │   ├── fat
│   │   ├── rc4
│   │   ├── rockusb
│   │   ├── serial_p9
│   │   └── SPI
│   └── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/common/platform '''platform''']
│   ├── rk2928
│   └── rk30
└── [https://github.com/radxa/u-boot-rockchip/tree/master/board/rockchip/rk30xx '''rk30xx''']

* [https://github.com/radxa/u-boot-rockchip/tree/master/arch/arm/cpu/armv7/rk30xx '''arch/arm/cpu/armv7/rk30xx''']
* [https://github.com/radxa/u-boot-rockchip/blob/master/arch/arm/include/asm/arch-rk30xx/ '''arch/arm/include/asm/arch-rk30xx''']

== Unbrick ==

If something goes wrong and your device doesn't boot anymore, read [[rock/unbrick | Unbrick Rock]].

== External links ==

* http://androtab.info/rockchip/u-boot/ (working binaries)
* https://github.com/linux-rockchip/u-boot-rockchip (some improvement)

Rock/pilight

2014-12-26T11:41:54Z

Jack:

pilight is a free open source full fledge domotica solution that runs on a Raspberry Pi, HummingBoard, BananaPi, Radxa, but also on *BSD and various linuxes (tested on Arch, Ubuntu and Debian). It's open source and freely available for anyone. pilight works with a great deal of devices and is frequency independent. Therefor, it can control devices working at 315Mhz, 433Mhz, 868Mhz etc.

Pilight website: http: //pilight.org/
Patch and config file: http://dl.radxa.com/users/jack/pilight/

Run Pilight on Radxa rock pro:

1 Download Pilight code

git clone -b development https://github.com/pilight/pilight.git

2 Apply patch

git apply 0001-Modify-for-radxa-rock-pro.patch

3 Installation Tools

apt-get install cmake
apt-get install libunwind8-dev

4 Compiled code
./setup.sh

5 Add config file, need to modify configuration file for your device
cp config.json /etc/pilight/

6 Run Pilight
pilight-daemon

7 Phone / PC Login Pilight web server for remote control

[[File:Pilight_web_server.png]]

Next time, we will update
how to use the Rock + Pilight control 433 MHz wireless devices.

Rock

2014-12-26T11:40:20Z

Jack:

{{Languages|rock}}

<div class="col-md-8 mwbs-color-darker">
<div class="thumbnail ">http://wiki.radxa.com/mw/images/3/36/Rock.jpg</div>
<div class="caption">
<h3>Radxa Rock(Pro/Lite)</h3>
<p class="text-justify">Radxa Rock is a RK3188 based SBC(Single Board Computer) by [[Special:SpecialContact| Radxa]]. It has a quad core ARM processor, can run android or some Linux distributions. It also features 80 pin 2.54mm headers, which makes it easy to connect other sensors or use the GPIO.</p>
</div>
</div>
__TOC__
<div class="col-md-9">
<div class="panel panel-primary-light-border">
<div class="panel-heading"> <h3 class="panel-title"><i class="fa fa-hand-o-up"></i> Getting started</h3> </div>

<div class="panel-body">
The Radxa Rock is shipped with Android 4.2.2 (Jelly Bean) and Ubuntu/Linaro 13.09 dual boot on the NAND flash (on-board storage) and it works out of the box(Rock Pro is shipped with Android 4.4.2(Kitkat) on NAND flash). Let's read [[rock/Getting Started|Radxa Rock Getting Started Guide]] and hook everything up and start playing with the board.

Once you get started, you can [[Rock/flash_the_image|flash]] latest [[Rock/prebuilt_images|Android image and several Linux images]], or you can try to [[Rock/SD_images|boot Android/Linux from SD card]]. You can also [[Rock/Android_Build|build your own Android]], [[Rock/Booting_Linux|build your own kernel]], [[Rock/ubuntu|build your own Ubuntu root file system]], or whatever you want.

'''FAQs'''

Before you ask any questions about the Radxa Rock check if your question has already been asked and answered [[rock/FAQ|Radxa Rock FAQ]].

</div>
</div>
</div>
<div class="col-md-3 ">
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title"><i class="fa fa-download"></i> Download</h3>
</div>
<div class="panel-body">
Visit the '''[[rock/download| download]]''' page to get the download link and description of the source code, tools, images etc
</div>
</div>
</div>
<div class="clearfix"></div>
<div class="col-md-4 ">
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title"><i class="fa fa-users"></i> Community</h3>
</div>
<div class="panel-body">
'''Users'''

* [http://talk.radxa.com/ Radxa Talk]
* [https://plus.google.com/communities/114007636590240429960 Radxa Google Plus community]
* [https://www.facebook.com/groups/218416868348521/ Facebook Group Page]

'''Developers'''

* [https://groups.google.com/forum/#!forum/radxa radxa google groups], send emails to radxa@googlegroups.com to subscribe
* <tt>#radxa</tt> [http://en.wikipedia.org/wiki/Internet_Relay_Chat IRC] channel on [http://freenode.net/ Freenode]. Click to [http://webchat.freenode.net/?channels=radxa join #radxa on Freenode (WebChat mode)], or consult [http://irclog.whitequark.org/radxa/ IRC logs].
</div>
</div>
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title"><i class="fa fa-linux"></i> Linux</h3>
</div>
<div class="panel-body">
* [[rock/Booting Linux | Build your own kernel and boot into Linux]]
* [[rock/Linux Mainline | Build Linux Mainline]]
* [[rock/ubuntu| Make Ubuntu image]]
* [[rock/audio | Audio on Rock]]
* [[rock/display | Display on Rock]]
* [[rock/LED| Using LEDs on Rock]]
* [[rock/vnc | Setting up VNC server on Rock]]
* [[rock/sd lubuntu | Boot Lubuntu from SD card]] '''OBSOLETE'''
</div>
</div>
</div>
<div class="col-md-4">
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title"><i class="fa fa-cog"></i> Common HowTos</h3>
</div>
<div class="panel-body">
* [[rock/flash the image | Flash the image to NAND]]
* [[rock/SD images | Flash the image to SD card]]
* [[rock/SD upgrading | Upgrade NAND from SD card]]
* [[rock/backup| Backing up]]
* [[rock/Serial debug tools Setting | Serial console debugging]]
* [[rock/unbrick | Unbrick Rock]]
* [[rock/resize linux rootfs |Resize linux rootfs ]]
* [[rock/ir| Using IR on Rock]]
* [[rock/usb| Using USB on Rock]]
* [[rock/Wireless | Using Wireless on Rock]]
* [[rock/Camera | Using Camera on Rock]]
* [[rock/Tp,Lvds,Camera | Using Lvds,Tp,Camera on Rock]]
</div>
</div>
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title"><i class="fa fa-check-circle"></i> Others</h3>
</div>
<div class="panel-body">
* [[rock/dual boot| Dual boot Android/Linux]]
* [[rock/FreeBSD| Boot FreeBSD]]
</div>
</div>
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title"><i class="fa fa-gamepad"></i> Addons</h3>
</div>
<div class="panel-body">
* [[rock/cases | Cases]]
* [[rock/cables | Cables]]
* [[rock/shields | Extension boards]]
</div>
</div>
</div>
<div class="col-md-4 ">
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title"><i class="fa fa-hdd-o"></i> Hardware</h3>
</div>
<div class="panel-body">
* [[rock/specifications| Specifications]]
* [[rock/hardware revision | Hardware Revision]]
* [[rock/extension header | Extension Header]]
* [[rock/hardware docs | hardware documents]]
</div>
</div>
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title"><i class="fa fa-android"></i> Android</h3>
</div>
<div class="panel-body">
* [[rock/windows adb| ADB under Windows]]
* [[rock/linux adb| ADB under Linux]]
* [[rock/Android Build|Build Android image for RR]]
* [[rock/SD booting | Making bootable SD card]]
* [[rock/AP android |Make radxa as a WIFI_AP]]
* [[rock/Android backup | Backup your apps]]
* [[rock/Android dev tips | Some tips for android development]]
</div>
</div>
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title"><i class="fa fa-bold"></i> Bootloader</h3>
</div>
<div class="panel-body">
* [[rock/bootloader | Boot Loader]]
* [[rock/U-Boot | U-Boot]]
</div>
</div>
</div>
<div class="clearfix"></div>
<div class="col-md-6 pull-left">
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title">Projects</h3>
</div>
<div class="panel-body">
* [http://radxa.com/Rock/pilight Run Pilight on Radxa Rock for remote control]
* [http://hwswbits.blogspot.com/2013/10/diy-nas-with-rk3188-device-radxa-rock.html DIY low power NAS (home file server) with Radxa Rock]
* [http://www.megaleecher.net/Network_Sharing_Radxa_Rock Network sharing on Radxa Rock]
* [http://hwswbits.blogspot.com/2013/10/radxa-rock-communicating-with-i2c.html Hardware hacking: Communicating the Radxa with external I2C devices]
* [http://hwswbits.blogspot.com/2013/10/bitbanging-radxa-rock-gpios.html Hardware hacking: Control Radxa Rock's expansion header GPIOs]
</div>
</div>
</div>
<div class="col-md-6 pull-right">
<div class="panel panel-primary-light-border">
<div class="panel-heading">
<h3 class="panel-title">References</h3>
</div>
<div class="panel-body">
'''Photos'''

* [http://dl.radxa.com/rock/media/pic/hd/ Some high definition photos of the Radxa Rock engineering samples]

'''External'''

* [http://www.cnx-software.com/2013/09/07/radxa-rock-development-boards-with-rockchip-rk3188-are-available-for-developers-now/ cnx-soft - radxa rock development boards with rockchips rk3188 are available for developers now]
* [http://linuxgizmos.com/open-sbc-runs-android-and-linux-on-quad-core-rockchip/ linuxgizmos - open sbc runs android and linux on quad core rockchip]
* [http://minipute.com/2013/09/12/new-radxa-rock-single-board-computer-runs-rockchip-rk3188-90/3246 minipute - new radxa rock single board computer runs rockchip rk3188]
* [http://omglaptop.com/desktops/radxa-rock-specs-price/ omglaptop - Radxa Rock Specs]
* [http://liliputing.com/2013/10/picuntu-4-5-installer-loads-ubuntu-onto-rockchip-rk3188-devices.html PicUntu 4.5 with a GUI installer for RK3188 based devices]
</div>
</div>
</div>

[[Category:Rock]]

Rock/pilight

2014-12-26T11:31:37Z

Jack: Created page with "pilight is a free open source full fledge domotica solution that runs on a Raspberry Pi, HummingBoard, BananaPi, Radxa, but also on *BSD and various linuxes (tested on Arch, U..."

pilight is a free open source full fledge domotica solution that runs on a Raspberry Pi, HummingBoard, BananaPi, Radxa, but also on *BSD and various linuxes (tested on Arch, Ubuntu and Debian). It's open source and freely available for anyone. pilight works with a great deal of devices and is frequency independent. Therefor, it can control devices working at 315Mhz, 433Mhz, 868Mhz etc.

Pilight website: http: //pilight.org/
Patch and config file: http://dl.radxa.com/users/jack/pilight/

Run Pilight on Radxa rock pro:

1 Download Pilight code

git clone -b development https://github.com/pilight/pilight.git

2 Apply patch

git apply 0001-Modify-for-radxa-rock-pro.patch

3 Installation Tools

apt-get install cmake
apt-get install libunwind8-dev

4 Compiled code
./setup.sh

5 Add config file, need to modify configuration file for your device
cp config.json /etc /pilight /

6 Run Pilight
pilight-daemon

7 Phone / PC Login Pilight web server for remote control

[[File:Pilight_web_server.png]]

Next time, we will update
how to use the Rock + Pilight control 433 MHz wireless devices.

File:Pilight web server.png

2014-12-26T10:25:53Z

Jack:

Rock/display

2014-12-20T03:59:54Z

Jack: /* Set full color depth */

{{Languages|rock/display}}

__TOC__

The cpu of Radxa Rock - RK3188 has two LCD controllers, LCD0 and LCD1. On RR, LCD1 is connected to HDMI and LCD0 is connect to AV out and the LCD0 signal are also exported on the extension header.

There is some sysfs interface exported to control the display related stuff. '''The following should work on both Android and Linux.'''

=== Set display scale ===

root@radxa:# export SCALE=/sys/class/graphics/fb0/scale
#For the new Ubuntu 14.04 image, the path is changed to /sys/class/display/HDMI/scale, run
root@radxa:# export SCALE=/sys/class/display/HDMI/scale
root@radxa:# cat $SCALE
xscale=95 yscale=95
root@radxa:# echo 100 > $SCALE
root@radxa:# cat $SCALE
xscale=100 yscale=100

You can also set different scales for X and Y:

root@radxa:# echo xscale=80 > $SCALE
root@radxa:# echo yscale=100 > $SCALE
root@radxa:# cat $SCALE
xscale=80 yscale=100

=== Set HDMI output mode ===
you can see supported output modes by the following commands:
root@radxa:# cat /sys/class/display/display0.HDMI/modes
#For the new Ubuntu 14.04 image, the path is changed to
root@radxa:# cat /sys/class/display/HDMI/modes
1920x1080p-60
1920x1080p-50
1280x720p-60
1280x720p-50
720x576p-50
720x480p-60
check out the current display mode
root@radxa:# cat /sys/class/display/display0.HDMI/mode
#For the new Ubuntu 14.04 image, the path is changed to
root@radxa:# cat /sys/class/display/HDMI/mode
1280x720p-60
It's 720p@60hz

change the mode to 1080p@60hz
root@radxa:# echo 1920x1080p-60 > /sys/class/display/display0.HDMI/mode
#For the new Ubuntu 14.04 image, the path is changed to
root@radxa:# echo 1920x1080p-60 > /sys/class/display/HDMI/mode

=== Set font size of X and console ===
Change DPI to increase the font size in X
rock@radxa:~$ sudo nano ~/.Xresources

add the following lines:
! Xft settings
Xft.dpi: 120
Xft.antialias: true
Xft.rgba: rgb
Xft.hinting: true
Xft.hintstyle: hintslight

Change the console settings:
rock@radxa:~$ sudo dpkg-reconfigure console-setup
Go through the setup: hit enter, hit enter, choose the font and hit enter, hit enter, choose size and hit enter

Switch to console via ctrl+alt+f1 and verify your settings:
root@radxa:~# setupcon
Find the best solution by repeating the console-setup...

=== Set full color depth ===

To use full 24/32 bits color depth on the radxa rock linux image:

apt-get install fbset

cat <<eof>> /etc/init/fbset.conf
# fbset - run fbset to set truecolor fbmode
description "run fbset ASAP"
start on startup and started udev or starting lightdm
task
script
echo 0 > /sys/class/display/HDMI/enable
[ -x /bin/fbset ] && /bin/fbset -a -nonstd 1 -depth 32 -rgba "8/0,8/8,8/16,8/24"
echo 1 > /sys/class/display/HDMI/enable
end script
eof

cat <<eof>> /etc/X11/xorg.conf
Section "Screen"
Identifier "Default Screen"
DefaultDepth 24
EndSection
eof

After rebooting you should ''not'' see green/purple screen. If you do, something went wrong. You can then use serial console or SSH from another machine and manually submit these commands:

service lightdm stop
fbset -a -nonstd 1 -depth 32 -rgba 8/0,8/8,8/16,8/24
service lightdm start

To make this change permanent, timing is critical during bootup. fbset will need to be called before X / lightdm starts. In Linaro/Ubuntu an upstart script is needed - '''fbset.conf''' - see above. The condition "startup and started udev" will try to run fbset as early as possible. On my rk3188 this works reliably, but if you have issues, your best bet is to tinker with these "start on" conditions. Do not use '''/etc/rc.local''' for this - this script is run long ''after'' lightdm has been started by upstart.

=== Set framebuffer resolution ===

Set framebuffer resolution to 720 x 480 pixels
service lightdm stop
fbset -a -xres 720 -yres 480 -vxres 720 -vyres 480
service lightdm start

If you get a blank screen, try to reactivate the display
echo 1 > /sys/class/graphics/fb0/enable

A few examples of other framebuffer resolution settings: 720x576, 1024x600, 1280x720, 1920x1080
fbset -a -xres 720 -yres 576 -vxres 720 -vyres 576
fbset -a -xres 1024 -yres 600 -vxres 1024 -vyres 600
fbset -a -xres 1280 -yres 720 -vxres 1280 -vyres 720
fbset -a -xres 1920 -yres 1080 -vxres 1920 -vyres 1080

Rock/flash the image

2014-11-27T05:30:41Z

Jack: /* Before you start */

{{Languages|rock/flash_the_image}}
__TOC__

This page describes how to install an image to the nand flash of Radxa Rock, ie, how to flash the board. You can choose to either flash the whole nand image (ie, [[rock/update.img |update.img]]) to the board or just flash the selected [[rock/partitions |partitions]]. You can download the [[rock/prebuilt images| prebuilt images]] from our [http://dl.radxa.com/rock/images/ server] or build your own images.

== Before you start ==

Keep in mind that:
'''You can always flash the rock, it never bricks (as the name :)) unless some hardware damage occurs.'''

What you will need to flash the board is:
* a Radxa Rock board (check [[Rock/hardware_revision | hardware revision]]. there are Pro and Full/Lite, firmware is different)
* a PC running Windows (XP 32/64bit, Windows 7 32/64 bit) or Linux (32/64bit)
* a micro USB cable with one side plugged in to the OTG port of Radxa Rock and the other side plugged into the USB port on PC.

== Windows ==

The Windows tool for flashing the image is provided by Rockchip. To flash the [[rock/update.img| update.img]](you'd better click this link and read this page,it's very Important for the radxa beginner), you need to use the RKBatchTool and to flash the [[rock/partitions| partitions]], you will need to use RKDevelopTool. Both RKBatchTool and RKDevelopTool rely on the RK USB driver so you will need to install it first as below:

=== Install driver ===
# install using RKDriverAssistant tools - the easy way(Just for winXp, Vista, Win7,not support Win8)
# install manually (WinXp,Vista,Win7,Win8)

<p></p>
'''If you have already installed the USB driver please skip this step.'''

====a. Install using RK Driver Assistant tools ====
Note:The method just support WinXp,Vista,Win7, NOT SUPPORT Win8

There’s no need to connect your Rockchip device during this procedure just download and extract [http://dl.radxa.com/rock/tools/windows/RK_DriverAssitant.zip RKDriverAssistant.zip]
Then double click on DriverInstall.exe in the RKDriverAssistant directory to start the utility.
If you've previously tried to install the Rockchip USB drivers for any Rockchip devices make sure you click “Uninstall Driver” first.

[[File:RK_Driver_Assistant_Install_Uninstall.jpg]]

Then click “Install Driver” and when the driver has finish installing then shut down radxa board and connect the Radxa Rock board to your computer and let the board go to [[Rock/Loader mode|loader mode]], then your computer will detect the board and you will see it within device manager.

[[File:RK_Driver_Assistant_Install_Usb_driver.png]]

Now the driver should have been installed successfully!

====b. Install Manually====

Download driver file first. For WinXp,Vista,Win7,Download the file (usb_driver_v3.5.zip) from [http://dl.radxa.com/rock/tools/windows/usb_driver_v3.5.zip here] . For Win8 Download the file(usb_driver_v3.7.zip) from [http://dl.radxa.com/rock/tools/windows/Rockusb%20Driver%20v3.7.zip here]. shut down the Radxa Rock board then connect the Radxa Rock board to the computer and let the board go to [[Rock/Loader mode|loader mode]]. After your computer should detect the board and you will see an unknown device within device manager.

[[File:flash_image_1.jpg]]

Select the Unknown device then right click and select "Update Driver Software".

[[File:flash_image_2.jpg]]

Select "Browse the computer for driver software".

[[File:flash_image_2.5.jpg]]

Find the file unzipped file you downloaded earlier (usb_driver_v3.5.zip) and select either the 32/64bit folder then click "OK" to install.

[[File:flash_image_3.jpg]]

When the driver is installed successful you will then see a Rockusb Device in the device manager window.

[[File:flash_image_6.jpg]]

Now the driver is installed successfully.

===Flash Image===
There are two methods to flash an image.

# use RKBatchTool (Factory upgrading firmware tool, flash update.img only, it will erase everything.)
# use RKAndroidTool (Development tool, can flash by partitions)
<br/>
====Using RKBatchTool to flash update.img====

Download RKBatchTool from [http://dl.radxa.com/rock/tools/windows/RK_BatchTool_V1.7.zip here]. Then unzip it and double click RKBatchTool.exe, you will now see the interface as follows:

[[File:flash_image_7.jpg]]

Select an image (rockdev/update.img). For information on how to make nand image see [[Rock/update.img | update.img]]<br/>
[[File:flash_image_8.jpg]]

Power down the Radxa Rock board and connect the Radxa Rock board to the computer then let the board go to [[Rock/Loader mode|loader mode]] after the program should detect the device.<br/>
[[File:flash_image_9.jpg]]

Click the "Upgrade" button to begin flashing and when the flashing process finishes successfully you will see the following interface.<br/>
[[File:flash_image_10.jpg]]

If the flashing has aborted ,it could possibly be an error with the update.img, you can either try to redo the operations above or make the update.img again!

Here is the video

http://v.youku.com/v_show/id_XNjkzNDk3MjEy.html

====Using RKAndroidTool to flash image by partitions ====
Download RKAndroidTools from [http://dl.radxa.com/rock/tools/windows/RKDevelopTool_v1.37.zip here]. Unzip it the file and double click RKAndroidTool.exe, you will then see the interface as follows:

[[File:rkandroidtool_flash_image_1.png]]

Power down the Radxa Rock board and connect the Radxa Rock board to the computer and let the board go to [[Rock/Loader mode|loader mode]] then the program will detect it.

[[File:rkandroidtool_flash_image_2.png]]

There are eight selections to choose from so select the correct row and then select the checkbox to the left of the row to select it. After you must click the column on the right side for the path of the file you want to flash. You can then select one or more files and flash them at once. Finally Click "Run" to flash images to the device (the right most selection shows the log of the progress).

[[File:rkandroidtool_flash_image_3.png]]

[[File:rkandroidtool_flash_image_4.png]]

If successful the board will disconnect from the tool and boot into the system.

Please Note:

# The kernel is contained within the boot.img when you package the image by "./mkimage.sh ota" please see [[Rock/Android_Build]] for more information.
# you can flash one of more image at one time as needed

=== Troubleshooting ===
==== RKBatchTool can not recognize the board ====
1.Loader mode : USB device HW: VID_2207&PID_310B <br/>
2.Boot into Android: USB device HW: VID_2207&PID_0006

For loader mode<br/>
I have use manual install within loader mode for PID_310B.
The "Rockusb device" driver installed successfully on Vista but the RKBatchTool can not connect to the RK3188 board for img flashing.

For loader mode cannot connect issue [Solved]<br/>
Root Cause: RK3188 board is connected to laptop via USB 3.0 PMMCIA card.
It's a USB2.0 to USB3.0 compatibility issue so switch USB 3.0 port to a USB 2.0 then the RKBatchTool should connect to the RK3188 board for img flashing.

==== Flashing failed ====

After flashing, the uart print

DDR Version 1.04 20130517 In DDR3 300MHz Bus Width=32 Col=10 Bank=8 Row=15 CS=2 Die Bus-Width=16 Size=2048MB Memory OK OUT BUILD=====6 SdmmcInit=0 20 F:32 1061 0 0 40 FlashReadRetry error!!,row = fff000 FlashReadRetry error!!,row = fff000

and not boot.

If flashing failed, try to format the nand flash before flashing it.
* RKAndroid tool - click "Erease IDB" button to format the nand flash
* RK Batch tool - click "Restore" to format and then flash the image

==== Preparing IDB failed ====
This happens at upgrading bootloader, if you need to upgrade the bootloader or the update.img contains a new bootloader, you probably will meet this. The rock is "bricked". Follow this [[rock/unbrick | unbrick instructions]] to unbrick it.

== Linux ==
Rockchip has provided tools for upgrading within Linux (closed source) since Android 4.4. It's called '''upgrade_tool'''.
It supports update.img, parameter, bootloader and other partitions, and it's command line based.

rkflashkit is an open source GUI version flashing tool for rockchip devices. It can not flash bootloader or parameter, only supports kernel and other partitions, but it supports backup the partitions.

For developers:
''The initial RE work of the Rockchip bootloader updating protocol is by naobsd and has been improved by some in '''rkflashtool'''. linuxerwang has made a GUI version of the rkflashtool called '''rkflashkit'''. Please note: both '''rkflashtool''' and '''rkflashkit''' can '''not''' flash the [[rock/update.img]] and can only flash within [[rock/bootloader]] mode and not [[rock/mask rom]] mode because the [[rock/mask rom]] updating protocol is not RE yet. If you are interested in the RE protocol ping naobsd at #radxa on IRC. Since the [[rock/bootloader]] has remained unchanged for a long time it's enough for normal usage. If you don't know what this means, just ignore it.''

=== Upgrade_tool from Rockchip ===

Download the Rockchip linux upgrade tool [http://dl.radxa.com/rock/tools/linux/Linux_Upgrade_Tool_v1.21.zip here]. Unzip it and you will get a file called '''upgrade_tool''' which is a binary executable file under Linux.
==== Flash update.img ====
Let the board go to [[Rock/Loader mode|loader mode]] and run the following command to flash the [[rock/update.img | update.img]]:
sudo ./upgrade_tool '''uf''' /path/to/update.img #(UF Upgrade Flash)

If you have an error with upgrading you can low level format the nand flash first with the following command:
sudo ./upgrade_tool '''lf''' #(LF Lowlevel Format) This will erase everything on nand

==== Flash parameter ====
sudo ./upgrade_tool '''di''' -p /path/to/parameter #(DI Download Image)

==== Flash bootloader ====
sudo ./upgrade_tool '''ul''' /path/to/bootloader #(UL Upgrade Loader)

==== Flash the kernel(boot.img) ====
sudo ./upgrade_tool '''di''' -b /path/to/boot.img #(DI Download Image)

==== Others ====
There are other commands in the upgrade_tool, such as:
UL: upgrade the loader
EF: erease the nand flash

=== Flash with rkflashtool ===

rkflashtool is an open source tool to write nand flash via the loader mode for rockchip platform.

To install rkflashtool:

sudo apt-get install build-essential libusb-1.0-0-dev
git clone https://github.com/linux-rockchip/rkflashtool
cd rkflashtool
make
sudo cp rkflashtool rkcrc rkunpack rkunsign /usr/local/bin

To read/write parameter:

rkflashtool p > param
rkflashtool P < param

To read/write partitions:

rkflashtool r boot > boot.img
rkflashtool w boot < boot.img

rkflashtool r linuxroot > linuxroot.ext4
rkflashtool w linuxroot < linuxroot.ext4

=== Rkflashkit with GUI ===
You can download the pre-built rkflashkit [http://dl.radxa.com/rock/tools/linux/rkflashkit_0.1.1_all.deb here] or build it yourself with the following command:

git clone https://github.com/linuxerwang/rkflashkit
cd rkflashkit
./waf debian

And install it with the following command

sudo apt-get install python-gtk2
sudo dpkg -i rkflashkit_0.1.1_all.deb

Run it with the following command

sudo rkflashkit

You can see the interface looks like this:

[[File:rkflashkit1.png| 600px]]

Connect the Radxa Rock board to the computer and let the board go into [[Rock/Loader mode|loader mode]] you will then see the the program detect the board in loader mode.

# Click the Nand partition and you will see the partitions of the board listed then choose the one you want to flash.
# Choose the location of the image you want to flash to that partition.
# Click the "Flash image" button and it will start flashing
# After it's finished click "Reboot Device" button to reboot the board.

[[File:rkflashkit2.png| 500px]] [[File:rkflashkit3.png| 500px]]

=== Troubleshooting ===
==== Creating Comm Object failed! ====
that's udev issues… You can solve this by creating a new file in /etc/udev/rules.d/ with the rule for the rock.

To do that, copy and paste these commands:

echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="2207", MODE="0666", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/51-android.rules

Finally, just remove and reinsert the USB cable.

==== What's verision of My board and Which Image should I flash! ====

refer to [[Rock/update.img|update.img]]

== Install the image on RR without PC ==
If you want to write the image on RR without any other host PC, you can download the image and write with dd:
sudo dd if=XXX.img of=/dev/block/mtd/by-name/XXX bs=16384 conv=sync,fsync

== Videos tutorial ==
*Flashing the image to nand flash https://www.youtube.com/watch?v=r20lOKu2E1s&feature=youtu.be