Changes between Version 37 and Version 38 of newport

Timestamp:

02/08/2018 08:42:11 PM (6 years ago)

Author:

Tim Harvey

Comment:

added additional BSP target info

newport

@@ -125 +125 @@
  * [https://github.com/Gateworks/bdk-newport bdk-newport] - Newport BDK (used as Secondary Program Loader) ([https://github.com/Gateworks/bdk-newport/subscription watch)]
  * [https://github.com/Gateworks/atf-newport atf-newport] - Newport ATF (ARM Trusted Firmware) ([https://github.com/Gateworks/atf-newport/subscription watch)]
+ * [https://github.com/Gateworks/openwrt openwrt] - Gateworks OpenWrt ([https://github.com/Gateworks/openwrt/subscription watch)]
 
 
@@ -133 +134 @@
  * [https://github.com/Gateworks/images-newport/raw/master/firmware-newport.img boot firmware image] (everything up to and including the bootloader stored on the embedded FLASH boot device) (see [wiki:newport/boot newport/boot] for details)
  * Download linux-newport.tar.xz from [https://github.com/Gateworks/linux-newport/releases/latest latest Newport kernel release] - Compressed TAR archive of pre-built Linux kernel
- * Download xenial-newport.img.gz from [https://github.com/Gateworks/images-newport/releases/latest latest Newport firmware release] - Compressed Disk Image containing Firmware and Ubuntu 16.04 Xenial 
+ * Download xenial-newport.img.gz from [https://github.com/Gateworks/images-newport/releases/latest latest Newport Ubuntu release] - Compressed Disk Image containing Firmware and Ubuntu 16.04 Xenial
+ * Download openwrt-newport.img.gz from [http://dev.gateworks.com/newport/openwrt/openwrt-newport.img.gz latest Newport OpenWrt build] - Compressed Disk Image containing Firmware and OpenWrt
  * [http://dev.gateworks.com/newport/ubuntu/xenial/latest/xenial-newport.tar.xz xenial-newport.tar.xz] - Compressed TAR archive of Ubuntu 16.04 Xenial arm64 root filesystem
 
@@ -174 +176 @@
 source newport/setup-environment
 }}}
- 1. Build 'Boot Firmware' (takes about 2 mins on a modern development system)
-{{{#!bash
-make -j8 firmware # build boot firmware using 8 sub-processes
-}}}
-  * additional targets you may want to make include 'linux' to build the Linux kernel
-
-The resulting {{{firmware-newport.img}}} can be installed to boot media (see [#firmware-update below])
+ 1. Build desired targets and images for example:
+{{{#!bash
+make -j8 openwrt-image # build openwrt-newport.img.gz
+}}}
+
+The build targets supported by the Newport BSP include:
+  * **firmware-image** - builds 'firmware-newport.img': 16MB [wiki:newport/boot Boot Firmware] which includes the BDK/ATF/U-Boot and Device-Tree images - (takes about 2 mins on a modern development system).
+  * **kernel_image** - builds linux-newport.tar.xz - A compressed tarball of the kernel (boot/Image) and kernel modules (lib/modules/*) which can be used on top of any compatible root filesystem 
+  * **ubuntu-image** - builds ubuntu-newport.img.gz: A Compressed Disk Image which includes the 16MB [wiki:newport/boot Boot Firmware] (BDK/ATF/U-Boot and Device-Tree images) as well as the Kenrel and Ubuntu root filesystem
+  * **openwrt-image** - builds openwrt-newport.img.gz: A Compressed Disk Image which includes the 16MB [wiki:newport/boot Boot Firmware] (BDK/ATF/U-Boot and Device-Tree images) as well as the OpenWrt Kenrel and root filesystem
+
+The resulting images can be installed to boot media (see [#firmware-update below])
+
 
 [=#kernel]
 === Building or modifying the Linux Kernel ===
-The Gateworks Newport BSP instructions above (pre-requisite) create an environment for building the Linux kernel. Here are some additional instructions for common actions:
- * Pre-Requisite: Perform instructions above for Newport BSP from source.
+The Gateworks Newport BSP instructions [#bsp above] create an environment for building the Linux kernel among other targets.
+
+Here are some additional instructions for common actions (make sure you have installed the BSP and setup your shell environment as specified above):
  * Modify Kernel configuration (enabling modules etc):
 {{{#!bash
@@ -202 +211 @@
 tar -cvJf /tftpboot/newport/linux-newport.tar.xz --numeric-owner -C install . # create tarball
 }}}
-  - You can install this kernel on a running system via {{{cd /; tar xvf linux-newport.tar.xz}}}
+
+While the resulting kernel modules must be placed on the root filesystem the kernel image must be placed in a partition readable by the U-Boot Bootloader. Therefore placing the kernel within the root filesystem as above does not work if you use a filesystem that U-Boot does not natively support (like F2FS or BTRFS for example). U-Boot only supports FAT and EXT (and UBI for NAND devices) natively.
+
 
 === Building Ubuntu Operating System - rootfs ===
@@ -208 +219 @@
 
 Information for building Ubuntu rootfs can be found here: [wiki:newport/ubuntu]
+
 
 [=#firmware-version]