aboutsummaryrefslogtreecommitdiff
path: root/board/olimex/a20_olinuxino_lime/readme.txt
blob: 4a5853b18e0f36255b80e005564f82d3eeecde8d (plain)
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
A20-OLinuXino-LIME

Intro
=====

This is a open hardware board,
see https://www.olimex.com/Products/OLinuXino/open-source-hardware

The legacy linux-sunxi kernels are based on the vendor code drops.
They are only useful when accelerated 3D graphics and multimedia support
is strictly necessary.

The Mainline Kernel is already a much better choice for a headless server.
And also the mainline kernel works fine even for a basic Linux desktop
system running on top of a simple framebuffer, which may be good enough for
the users who do not need fancy 3D graphics or video playback acceleration.

How to build it
===============

    $ make olimex_a20_olinuxino_lime_defconfig

or

    $ make olimex_a20_olinuxino_lime_mali_defconfig

Compile everything and build the rootfs image:

    $ make

Result of the build
-------------------

After building, you should get a tree like this:

    output/images/
    +-- rootfs.ext2
    +-- rootfs.ext4 -> rootfs.ext2
    +-- script.bin (mali)
    +-- sun7i-a20-olinuxino-lime.dtb (mainline)
    +-- u-boot.bin
    +-- u-boot-sunxi-with-spl.bin
    `-- zImage


How to write the SD card
========================


Prepare the SD card
-------------------

Erase existing stuff, and create an unique Linux partition with `fdisk`.

    # fdisk /dev/sdX
    Command (m for help): o
    Building a new DOS disklabel with disk identifier 0xf9e1616a.
    Changes will remain in memory only, until you decide to write them.
    After that, of course, the previous content won't be recoverable.

    Command (m for help): n
    Partition type:
        p   primary (0 primary, 0 extended, 4 free)
        e   extended
    Select (default p): p
    Partition number (1-4, default 1): 1
    First sector (2048-7626751, default 2048): 2048
    Last sector, +sectors or +size{K,M,G} (2048-7626751, default 7626751): 
    Using default value 7626751

    Command (m for help): p

    Disk /dev/sdX: 3904 MB, 3904897024 bytes
    4 heads, 16 sectors/track, 119168 cylinders, total 7626752 sectors
    Units = sectors of 1 * 512 = 512 bytes
    Sector size (logical/physical): 512 bytes / 512 bytes
    I/O size (minimum/optimal): 512 bytes / 512 bytes
    Disk identifier: 0xf9e1616a

            Device Boot      Start         End      Blocks   Id  System
    /dev/sdX1                 2048     7626751     3812352   83  Linux

    Command (m for help): w
    The partition table has been altered!

    Calling ioctl() to re-read partition table.
    Syncing disks.

Copy images on the SD card
--------------------------

    # dd if=output/images/rootfs.ext2 of=/dev/sdX1
    # dd if=output/images/u-boot-sunxi-with-spl.bin of=/dev/sdX bs=1024 seek=8


Finish
======

Eject the SD card, insert it in the A20-OLinuXino-LIME board, and power it up.