toolchain: bump Codescape IMG MIPS version to 2016.05-06
[buildroot-gz.git] / board / olimex / a20_olinuxino / readme.txt
blob070b7a5ec7c23151069da81ff62cad2c412c2f73
1 A20-OLinuXino-LIME and A20-OLinuXino-MICRO
3 Intro
4 =====
6 These are open hardware boards, all based on the Allwinner A20 SoC.
8 for more details about the boards see the following pages:
9  - https://www.olimex.com/Products/OLinuXino/open-source-hardware
10  - https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-MICRO/
11  - https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/
12  - https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME2/
14 The following defconfigs are available:
15  - olimex_a20_olinuxino_micro_defconfig
16    for the A20-OLinuXino-MICRO board using mainline kernel
17  - olimex_a20_olinuxino_lime_defconfig
18    for the A20-OLinuXino-LIME board using mainline kernel
19  - olimex_a20_olinuxino_lime_mali_defconfig
20    for the A20-OLinuXino-LIME board using legacy linux-sunxi kernel
21  - olimex_a20_olinuxino_lime2_defconfig
22    for the A20-OLinuXino-LIME2 board using mainline kernel
24 The legacy linux-sunxi kernels are based on the vendor code drops.
25 They are only useful when accelerated 3D graphics and multimedia support
26 is strictly necessary.
28 The Mainline Kernel is already a much better choice for a headless server.
29 And also the mainline kernel works fine even for a basic Linux desktop
30 system running on top of a simple framebuffer, which may be good enough for
31 the users who do not need fancy 3D graphics or video playback acceleration.
33 (see http://linux-sunxi.org/Linux_Kernel for more details)
35 How to build it
36 ===============
38 Configure Buildroot:
40     $ make <board>_defconfig
42 Compile everything and build the rootfs image:
44     $ make
46 Result of the build
47 -------------------
49 After building, you should get a tree like this:
51     output/images/
52     +-- rootfs.ext2
53     +-- rootfs.ext4 -> rootfs.ext2
54     +-- script.bin (lime_mali)
55     +-- sdcard.img
56     +-- sun7i-a20-olinuxino-lime.dtb (lime, mainline)
57     +-- sun7i-a20-olinuxino-lime2.dtb (lime2, mainline)
58     +-- sun7i-a20-olinuxino-micro.dtb (micro, mainline)
59     +-- u-boot.bin
60     +-- u-boot-sunxi-with-spl.bin
61     `-- zImage
64 How to write the SD card
65 ========================
67 The sdcard.img file is a complete bootable image ready to be written
68 on the boot medium. To install it, simply copy the image to a uSD
69 card:
71     # dd if=output/images/sdcard.img of=/dev/sdX
73 Where 'sdX' is the device node of the uSD.
75 Eject the SD card, insert it in the A20-OLinuXino board, and power it up.