board/armadeus/readme.txt

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