summaryrefslogtreecommitdiff
path: root/board
diff options
context:
space:
mode:
authorFabio Estevam <fabio.estevam@nxp.com>2016-09-08 13:12:29 -0300
committerThomas Petazzoni <thomas.petazzoni@free-electrons.com>2016-09-08 22:25:40 +0200
commitd981c4b34a87db5833f42f050d7f548926994c98 (patch)
tree3273e7dd9d0c61b8e74f9f8d35d6b442fb66a8ac /board
parentb2216c6bb472d9e91c3f4e3f974d7a7af759ed77 (diff)
configs: Add support for warp7 board
Add support for warp7, which is a board based on NXP i.MX7S processor. More information about warp7 can be found at: https://www.element14.com/community/docs/DOC-79058 Signed-off-by: Fabio Estevam <fabio.estevam@nxp.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Diffstat (limited to 'board')
-rw-r--r--board/warp7/genimage.cfg41
-rwxr-xr-xboard/warp7/post-image.sh14
-rw-r--r--board/warp7/readme.txt93
3 files changed, 148 insertions, 0 deletions
diff --git a/board/warp7/genimage.cfg b/board/warp7/genimage.cfg
new file mode 100644
index 000000000..6d963acd5
--- /dev/null
+++ b/board/warp7/genimage.cfg
@@ -0,0 +1,41 @@
+# Minimal eMMC image for the Warp board
+#
+# We mimic the .sdcard Freescale's image format for i.MX7S:
+# * the eMMC card must have 1 kB free space at the beginning,
+# * U-Boot is dumped as is,
+# * a FAT partition at offset 8 MB is containing zImage and dtbs,
+# * a single root filesystem partition is required (Ext4 in this case).
+#
+
+image boot.vfat {
+ vfat {
+ files = {
+ "imx7s-warp.dtb",
+ "zImage"
+ }
+ }
+ size = 16M
+}
+
+image emmc.img {
+ hdimage {
+ }
+
+ partition u-boot {
+ in-partition-table = "no"
+ image = "u-boot.imx"
+ offset = 1024
+ }
+
+ partition boot {
+ partition-type = 0xC
+ bootable = "true"
+ image = "boot.vfat"
+ offset = 8M
+ }
+
+ partition rootfs {
+ partition-type = 0x83
+ image = "rootfs.ext4"
+ }
+}
diff --git a/board/warp7/post-image.sh b/board/warp7/post-image.sh
new file mode 100755
index 000000000..b4ac4608f
--- /dev/null
+++ b/board/warp7/post-image.sh
@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+BOARD_DIR="$(dirname $0)"
+GENIMAGE_CFG="${BOARD_DIR}/genimage.cfg"
+GENIMAGE_TMP="${BUILD_DIR}/genimage.tmp"
+
+rm -rf "${GENIMAGE_TMP}"
+
+genimage \
+ --rootpath "${TARGET_DIR}" \
+ --tmppath "${GENIMAGE_TMP}" \
+ --inputpath "${BINARIES_DIR}" \
+ --outputpath "${BINARIES_DIR}" \
+ --config "${GENIMAGE_CFG}"
diff --git a/board/warp7/readme.txt b/board/warp7/readme.txt
new file mode 100644
index 000000000..3c765f552
--- /dev/null
+++ b/board/warp7/readme.txt
@@ -0,0 +1,93 @@
+*****************
+Warp i.MX7S board
+*****************
+
+This file documents the Buildroot support for the Warp i.MX7S board.
+
+Build
+=====
+
+First, configure Buildroot for the Warp i.MX7S board:
+
+ make warp7_defconfig
+
+Build all components:
+
+ make
+
+You will find in output/images/ the following files:
+ - imx7s-warp.dtb
+ - rootfs.ext4
+ - rootfs.tar
+ - emmc.img
+ - u-boot.imx
+ - zImage
+
+Flash the eMMC image
+====================
+
+In the U-Boot prompt lauch:
+
+=> ums 0 mmc 0
+
+This will mount the eMMC content in the host PC as a mass storage device.
+
+To determine the device associated to the eMMC have a look in the
+/proc/partitions file:
+
+ cat /proc/partitions
+
+Buildroot prepares a bootable "emmc.img" image in the output/images/
+directory, ready to be dumped into the eMMC. Launch the following
+command:
+
+sudo dd if=output/images/emmc.img of=/dev/<your-emmc-device>
+
+*** WARNING! This will destroy all the eMMC content. Use it with care! ***
+
+For details about the medium image layout, see the definition in
+board/warp7/genimage.cfg.
+
+How to recover from a bad eMMC image
+====================================
+
+In case a bad U-Boot has been flashed to the eMMC and the board no
+longer boots, it is possible to recover using the imx_usb_loader utility.
+
+Put the warp7 board in USB download mode by removing the CPU board
+from the base board then putting switch 2 in the upper position.
+
+Connect a USB to serial adapter between the host PC and warp7 serial
+USB port, and also a USB cable between the OTG warp7 port and the host
+PC.
+
+Copy u-boot.imx to the imx_usb_loader folder.
+
+Load u-boot.imx via USB:
+
+$ sudo ./imx_usb u-boot.imx
+
+Then U-Boot should start and its messages will appear in the console program.
+
+Open a terminal program such as minicom.
+
+Use the default environment variables:
+
+=> env default -f -a
+=> saveenv
+=> ums 0 mmc 0
+
+sudo dd if=output/images/emmc.img of=/dev/<your-emmc-device>
+
+Put warp7 back in eMMC boot mode by placing switch 2 in the lower position
+and reboot the board.
+
+Boot the Warp i.MX7S board
+==========================
+
+To boot your newly created system:
+- put a micro USB cable into the Debug USB Port and connect using a terminal
+ emulator at 115200 bps, 8n1;
+- power on the board.
+
+Enjoy!