readme.txt
1Introduction
2============
3
4Armadeus APFxx are Systems On Module (SOM) based on Freescale/NXP i.MX
5processors associated with an FPGA (except on APF28). Non volatile
6data are stored in on-module NOR or NAND Flash, depending on the
7model. These SOM can be used on Armadeus development boards or with
8custom docking boards.
9
10Supported platforms
11===================
12
13Buildroot currently supports the following Armadeus platforms with the
14associated defconfigs:
15
16 * APF27 SOM + devt board -> armadeus_apf27_defconfig
17 * APF51 SOM + devt board -> armadeus_apf51_defconfig
18 * APF28 SOM + devt board -> armadeus_apf28_defconfig
19
20Vanilla Linux versions are preferred to Freescale's one in these
21configurations.
22
23How to build it
24===============
25
26Configure Buildroot
27-------------------
28
29Let's say you own an APFxx SOM with it's corresponding development
30board, all you have to do is:
31
32 $ make armadeus_apfxx_defconfig
33
34where "apfxx" is the version of your SOM.
35
36Launch build
37------------
38
39 $ make
40
41Result of the build
42-------------------
43
44When the build is finished, you will end up with:
45
46 output/images/
47 +-- imx**-apfxxdev.dtb [1]
48 +-- rootfs.tar
49 +-- rootfs.ubi
50 +-- rootfs.ubifs
51 +-- uImage
52
53[1] Only if the kernel version used uses a Device Tree.
54
55Building U-Boot is currently not supported in these configurations.
56
57Installation
58============
59
60You will require a serial connection to the board and a TFTP server on
61your Host PC. Assuming your server is configured for exporting
62/tftpboot/ directory, you will have to copy the generated images to
63it:
64
65 $ cp output/images/uImage /tftpboot/apfxx-linux.bin
66 $ cp output/images/*.dtb /tftpboot/
67 $ cp output/images/rootfs.ubi /tftpboot/apfxx-rootfs.ubi
68
69where "apfxx" is the version of your SOM, as used with _defconfigs.
70
71Then on your serial terminal, all you have to do is:
72
73* interrupt the boot process and access U-Boot console by pressing any
74 key when booting,
75* configure board and server IP addresses with "ipaddr" and "serverip"
76 environment variables,
77* if you want to update kernel:
78 BIOS > run update_kernel
79* if you want to update device tree:
80 BIOS > run update_dtb
81* if you want to update rootfs:
82 BIOS > run update_rootfs
83
84That's it !
85