Changes between Version 37 and Version 38 of newport


Ignore:
Timestamp:
02/08/2018 12:42:11 PM (8 months ago)
Author:
Tim Harvey
Comment:

added additional BSP target info

Legend:

Unmodified
Added
Removed
Modified
  • newport

    v37 v38  
    125125 * [https://github.com/Gateworks/bdk-newport bdk-newport] - Newport BDK (used as Secondary Program Loader) ([https://github.com/Gateworks/bdk-newport/subscription watch)]
    126126 * [https://github.com/Gateworks/atf-newport atf-newport] - Newport ATF (ARM Trusted Firmware) ([https://github.com/Gateworks/atf-newport/subscription watch)]
     127 * [https://github.com/Gateworks/openwrt openwrt] - Gateworks OpenWrt ([https://github.com/Gateworks/openwrt/subscription watch)]
    127128
    128129
     
    133134 * [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)
    134135 * 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
    135  * 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
     136 * 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
     137 * 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
    136138 * [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
    137139
     
    174176source newport/setup-environment
    175177}}}
    176  1. Build 'Boot Firmware' (takes about 2 mins on a modern development system)
    177 {{{#!bash
    178 make -j8 firmware # build boot firmware using 8 sub-processes
    179 }}}
    180   * additional targets you may want to make include 'linux' to build the Linux kernel
    181 
    182 The resulting {{{firmware-newport.img}}} can be installed to boot media (see [#firmware-update below])
     178 1. Build desired targets and images for example:
     179{{{#!bash
     180make -j8 openwrt-image # build openwrt-newport.img.gz
     181}}}
     182
     183The build targets supported by the Newport BSP include:
     184  * **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).
     185  * **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
     186  * **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
     187  * **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
     188
     189The resulting images can be installed to boot media (see [#firmware-update below])
     190
    183191
    184192[=#kernel]
    185193=== Building or modifying the Linux Kernel ===
    186 The Gateworks Newport BSP instructions above (pre-requisite) create an environment for building the Linux kernel. Here are some additional instructions for common actions:
    187  * Pre-Requisite: Perform instructions above for Newport BSP from source.
     194The Gateworks Newport BSP instructions [#bsp above] create an environment for building the Linux kernel among other targets.
     195
     196Here are some additional instructions for common actions (make sure you have installed the BSP and setup your shell environment as specified above):
    188197 * Modify Kernel configuration (enabling modules etc):
    189198{{{#!bash
     
    202211tar -cvJf /tftpboot/newport/linux-newport.tar.xz --numeric-owner -C install . # create tarball
    203212}}}
    204   - You can install this kernel on a running system via {{{cd /; tar xvf linux-newport.tar.xz}}}
     213
     214While 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.
     215
    205216
    206217=== Building Ubuntu Operating System - rootfs ===
     
    208219
    209220Information for building Ubuntu rootfs can be found here: [wiki:newport/ubuntu]
     221
    210222
    211223[=#firmware-version]