Changes between Version 21 and Version 22 of newport


Ignore:
Timestamp:
12/20/2017 10:36:33 AM (10 months ago)
Author:
Tim Harvey
Comment:

added BSP section

Legend:

Unmodified
Added
Removed
Modified
  • newport

    v21 v22  
    5656
    5757== Software ==
    58  * [#source Source code for Newport including keeping abreast of changes]
     58 * [#bsp Gateworks Newport Board Support Package]
    5959 * [#images Pre-built Firmware Images]
    6060 * [#firmware Boot Firmware (up to and including the Bootloader)]
     
    101101
    102102
     103[=#bsp]
     104= Newport Board Support Package (BSP) =
     105Gateworks provides a Board Support Package for Newport which provides source code and an easy mechanism to build:
     106 * Gateworks Newport Linux Kernel
     107 * Gateworks Newport Boot Firmware
     108
    103109[=#source]
    104 = Source Code =
     110== BSP Source Code ==
    105111Newport Source code for the firmware, bootloader and kernel are hosted at !GitHub. We highly recommend you create a !GitHub account and 'Watch' these repositories to keep abreast of important feature additions, bugfixes, and firmware-releases. You can configure your !GitHub account to e-mail you when changes are made to repositories [https://github.com/settings/notifications here].
    106112
     
    115121
    116122[=#images]
    117 = Pre-built Firmware Images =
     123== Pre-built Firmware Images ==
    118124The [https://github.com/Gateworks/uboot-newport images-newport] !GitHub repository hosts various pre-built firmware images used for Newport:
    119125 * [https://github.com/Gateworks/images-newport/raw/master/gsc_630x.txt GSC firmware image]
     
    122128 * 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
    123129 * [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
     130
     131
     132[=#build]
     133== Building BSP from source ==
     134The Gateworks Newport Board Support Package uses the Google {{{repo}}} tool to manage multiple code repositories.
     135
     136The following pre-requisites are needed to build the Newport BSP:
     137 * Linux Development host (Ubuntu 16.04 is used by Gateworks and tested)
     138 * Python 2.x (required by the 'repo' tool)
     139 * Git (used for source code repositories)
     140
     141To obtain the code:
     142 1. Get repo tool (download latest version of tool and put it in your path)
     143{{{#!bash
     144mkdir $HOME/.bin/
     145export PATH=\$PATH:$HOME/.bin/repo >> $HOME/.profile
     146curl https://storage.googleapis.com/git-repo-downloads/repo > $HOME/.bin/repo
     147chmod a+x $HOME/.bin/repo
     148}}}
     149 2. Initialize repo (fetch the repo manifest)
     150{{{#!bash
     151mkdir $HOME/newport
     152cd $HOME/newport
     153repo init -u https://github.com/Gateworks/manifest-newport.git
     154}}}
     155 3. Sync repositories (repeat this when you want to fetch the latest code updates)
     156{{{#!bash
     157repo sync
     158}}}
     159  * This will fetch/update the source repos described [#source above]. The first time it can take several minutes depending on your Internet connection and will take approximately ~2.5GB of disk space
     160 4. Build 'Boot Firmware' (takes about 2 mins on a modern development system)
     161{{{#!bash
     162make -j8 firmware # build boot firmware using 8 sub-processes
     163}}}
     164  * additional targets you may want to make include 'linux' to build the Linux kernel
     165
     166The resulting {{{firmware-newport.img}}} can be installed to boot media (see [#firmware-update below])
    124167
    125168
     
    262305
    263306Gateworks provides a pre-built Boot Firmware (firmware-newport.img) ready to flash onto boot devices as well as source for building and/or modifying the boot firmware yourself.
     307
    264308
    265309[=#bootrom]