Changes between Version 13 and Version 14 of newport/bsp


Ignore:
Timestamp:
08/01/2018 05:18:49 PM (12 months ago)
Author:
Ryan Erbstoesser
Comment:

organize and add some explanations

Legend:

Unmodified
Added
Removed
Modified
  • newport/bsp

    v13 v14  
    44Gateworks provides a Board Support Package for Newport which provides source code and an easy mechanism to build different images, including Ubuntu and OpenWrt.
    55
     6Gateworks uses the term 'BSP' to describe one 'image' file, that contains everything, including all boot firmware, operating system (rootfs and kernel).
     7
     8The Gateworks BSP is the easiest comprehensive software process because it contains everything. If a deep dive, expert path is desired, each piece of the BSP (boot firmware, rootfs, kernel) can all be built separately.
     9
    610 * [#kernel Gateworks Newport Linux Kernel]
    711 * [wiki:newport/boot Gateworks Newport Boot Firmware]
     12
     13[=#images]
     14== BSP Pre-Built Firmware Images ==
     15
     16Pre-built firmware images can be found on http://dev.gateworks.com/newport:
     17 * [http://dev.gateworks.com/newport/images/gsc_630x.txt GSC firmware image]
     18 * [http://dev.gateworks.com/newport/boot_firmware/firmware-newport.img firmware-newport.img] - Boot Firmware (everything up to and including the bootloader stored on the embedded FLASH boot device) (see [wiki:newport/boot newport/boot] for details)
     19 * [http://dev.gateworks.com/newport/kernel/linux-newport.tar.xz linux-newport.tar.xz] - Compressed TAR archive of pre-built Linux kernel
     20 * [http://dev.gateworks.com/newport/images/xenial-newport.img.gz xenial-newport.img.gz] - Compressed Disk Image containing Firmware and Ubuntu 16.04 Xenial
     21 * [http://dev.gateworks.com/newport/images/openwrt-newport.img.gz openwrt-newport.img.gz] - Compressed Disk Image containing Firmware and OpenWrt
     22 * [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
     23
     24''' Installation ''' instructions are at the following URL: [wiki:/newport/firmware#UpdateFirmwareviaSerialConsoleandEthernetfromBootloader Newport Flashing Instructions]
    825
    926[=#source]
     
    2239
    2340
    24 [=#images]
    25 == Pre-built Firmware Images ==
    26 
    27 Pre-built firmware images can be found on http://dev.gateworks.com/newport:
    28  * [http://dev.gateworks.com/newport/images/gsc_630x.txt GSC firmware image]
    29  * [http://dev.gateworks.com/newport/boot_firmware/firmware-newport.img firmware-newport.img] - Boot Firmware (everything up to and including the bootloader stored on the embedded FLASH boot device) (see [wiki:newport/boot newport/boot] for details)
    30  * [http://dev.gateworks.com/newport/kernel/linux-newport.tar.xz linux-newport.tar.xz] - Compressed TAR archive of pre-built Linux kernel
    31  * [http://dev.gateworks.com/newport/images/xenial-newport.img.gz xenial-newport.img.gz] - Compressed Disk Image containing Firmware and Ubuntu 16.04 Xenial
    32  * [http://dev.gateworks.com/newport/images/openwrt-newport.img.gz openwrt-newport.img.gz] - Compressed Disk Image containing Firmware and OpenWrt
    33  * [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
    34 
    35 ''' Installation ''' instructions are at the following URL: [wiki:/newport/firmware#UpdateFirmwareviaSerialConsoleandEthernetfromBootloader Newport Flashing Instructions]
    36 
    3741[=#build]
    38 == Building BSP from source ==
    39 Below are instructions for building all of the bootloader components and Linux kernel and Ubuntu or OpenWrt.  Pre-built images are available [#images above].
     42== Building the BSP from source ==
     43Below are instructions for building the entire BSP, which includes all of the bootloader components and Linux kernel and Ubuntu or OpenWrt.  Pre-built images are available [#images above].
    4044
    4145The Gateworks Newport Board Support Package uses the Google {{{repo}}} tool to manage multiple code repositories.
     
    8488
    8589[=#kernel]
    86 == Building or modifying the Linux Kernel ==
     90== Building or Modifying the Linux Kernel for Newport ==
    8791The Gateworks Newport BSP instructions [#build above] create an environment for building the Linux kernel among other targets.
    8892
    89 Here are some additional instructions for common actions (make sure you have installed the BSP and setup your shell environment as specified above):
     93Some additional instructions for common actions (make sure you have already installed the BSP and setup your shell environment as specified above):
    9094 * Modify Kernel configuration (enabling modules etc):
    9195{{{#!bash
     
    110114== Building Ubuntu Operating System - rootfs ==
    111115
    112 You can build a Ubuntu image from the BSP, but you cannot build the isolated rootfs.
     116You can build an entire Ubuntu image from the BSP noted above (which will boot on a Newport SBC), but it does not include building the isolated rootfs.
    113117
    114 The rootfs is not part of the Gateworks BSP described above.
     118The actual building of the Ubuntu rootfs does not happen in the Gateworks BSP instructions described above.
    115119
    116 Information for building Ubuntu rootfs can be found here: [wiki:newport/ubuntu]
     120Information for manually building Ubuntu rootfs can be found here: [wiki:newport/ubuntu]
    117121