board/via/imx6_vab820/readme.txt

   1 VIA VAB-820/AMOS-820
   2 ====================
   3
   4 This file documents the Buildroot support for the VIA VAB-820 board and
   5 VIA AMOS-820 system, which are built around a Freescale i.MX6 Quad/Dual SoC.
   6 The kernel and u-boot is based on the official VIA BSP, which is in turn
   7 based on the Freescale Linux 3.10.17_1.0.0_ga BSP.
   8
   9
  10 Configuring and building Buildroot
  11 ----------------------------------
  12
  13 Start from the defconfig:
  14
  15   $ make via_imx6_vab820_defconfig
  16
  17 You can edit build options the usual way:
  18
  19   $ make menuconfig
  20
  21 When you are happy with the setup, run:
  22
  23   $ make
  24
  25 The result of the build with the default settings should be these files:
  26
  27   output/images
  28   ├── boot.vfat
  29   ├── imx6q-vab820.dtb
  30   ├── rootfs.ext2
  31   ├── rootfs.ext4 -> rootfs.ext2
  32   ├── rootfs.tar
  33   ├── sdcard.img
  34   ├── u-boot.imx
  35   └── uImage
  36
  37 Copy the bootable `sdcard.img` onto an SD card with "dd":
  38
  39   $ sudo dd if=output/images/sdcard.img of=/dev/sdX bs=1M conv=fsync
  40
  41 where "sdX" is the appropriate partition of your card.
  42
  43 For details about the medium image layout, see the definition in
  44 `board/via/imx6_vab820/genimage.cfg`.
  45
  46
  47 Setting up your SD card manually
  48 --------------------------------
  49
  50 *Important*: pay attention which partition you are modifying so you don't
  51 accidentally erase the wrong file system, e.g your host computer or your
  52 external storage!
  53
  54 In the default setup you need to create 2 partitions on your SD card:
  55 a boot partition and a root partition. In this guide and in the default u-boot
  56 settings the boot partition is vfat, while the root partition is ext4.
  57
  58 You also need to leave space for u-boot at the beginning of the card, before
  59 all the partitions.
  60
  61 For example, if your SD card is at /dev/sdX, using fdisk, and starting from
  62 an empty card, the steps are along these lines:
  63
  64   # fdisk /dev/sdX
  65   n         (new partition)
  66   p         (primary partition)
  67   1         (first partition)
  68   <return>  (default first sector, should be at least 1MB from the beginning
  69              which is 2048 sectors if the sector size is 512KB)
  70   +50M      (50MB size, as an example)
  71   t         (switch partition type)
  72   b         (select "W95 FAT32" type)
  73   n         (the second partition)
  74   p         (primary partition)
  75   2         (second partition)
  76   <return>  (default first sector)
  77   <return>  (use all remaining space)
  78   p         (print so the partition looks something like this below)
  79     Device     Boot  Start      End  Sectors  Size Id Type
  80     /dev/sdX1         2048   104447   102400   50M  b W95 FAT32
  81     /dev/sdX2       104448 15564799 15460352  7.4G 83 Linux
  82   w         (save changes)
  83
  84 After this you need to format the newly created file system:
  85
  86   # mkfs.vfat -L boot /dev/sdX1
  87   # mkfs.ext4 -L rootfs /dev/sdX2
  88
  89 Now the system can be copied onto the card. First copy the u-boot onto
  90 the region of the card before the first partition (starting from the
  91 root directory of buildroot):
  92
  93   # dd if=output/images/u-boot.imx of=/dev/sdX bs=512 seek=2
  94
  95 Mount the first partition /dev/sdX1, and copy the kernel and the
  96 compiled device tree:
  97
  98   # cp output/images/uImage /mnt/<BOOT-PARTITION>
  99   # cp output/images/imx6q-vab820.dtb /mnt/<BOOT-PARTITION>
 100
 101 Finally, copy the root file system onto the mounted (empty) /dev/sdX2
 102 rootfs partition:
 103
 104   # tar xf output/images/rootfs.tar -C /mnt/<ROOTFS-PARTITION>
 105
 106
 107 Booting
 108 -------
 109
 110 To use the on-card u-boot, you need adjust jumper J11 located just next to
 111 the SD card slot on the VAB-820 board. The correct position for SD card
 112 boot is jumping the two pins towards the inside of the board.
 113
 114 To modify the default boot parameters compiled into u-boot, you can create
 115 a boot script with the file name `boot.scr` and place it onto the boot
 116 partition (same directory as `uImage`).
 117
 118 If you want to have the login prompt on the serial debug line instead of
 119 the console, adjust the buildroot settings as:
 120 "System Configuration > getty options > TTY port > ttymxc1"