Changes between Version 22 and Version 23 of newport/bsp


Ignore:
Timestamp:
02/08/2019 08:15:37 PM (8 months ago)
Author:
Tim Harvey
Comment:

added section on configuring OpenWrt

Legend:

Unmodified
Added
Removed
Modified
  • newport/bsp

    v22 v23  
    11[[PageOutline]]
    22
    3 = Newport Board Support Package (BSP) =
     3= Newport Board Support Package (BSP)
    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
     
    1212
    1313[=#images]
    14 == BSP Pre-Built Firmware Images ==
     14== BSP Pre-Built Firmware Images
    1515
    1616Pre-built firmware images can be found on http://dev.gateworks.com/newport.
     
    3030''' Installation ''' instructions are at the following URL: [wiki:/newport/firmware#UpdateFirmwareviaSerialConsoleandEthernetfromBootloader Newport Flashing Instructions]
    3131
     32
    3233[=#source]
    33 == BSP Source Code ==
     34== BSP Source Code
    3435Newport 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].
    3536
     
    4647
    4748[=#build]
    48 == Building the BSP from source ==
     49== Building the BSP from source
    4950Below 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].
    5051
     
    9697  * [wiki:/newport/boot#BuildingaBootableDiskImages Creating Entire Disk Images for Booting]
    9798
     99
    98100[=#kernel]
    99 == Building or Modifying the stand-alone Linux Kernel for Newport Ubuntu
     101=== Modifying the stand-alone Linux Kernel (ie for Ubuntu)
    100102The Gateworks Newport BSP instructions [#build above] create an environment for building the Linux kernel among other targets.
    101103
     
    120122
    121123
    122 == Building Ubuntu Operating System - rootfs
     124=== Modifying OpenWrt (toolchain, apps, kernel)
     125The OpenWrt build system includes building its own toolchain and kernel (so the kernel and toolchain directories in the bsp directory are not used)
    123126
    124 You 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.
     127Modifying OpenWrt toolchain, installed applications, and general configuration:
     128{{{#!bash
     129make -C openwrt menuconfig # configure toolchain, installed applications and general configuration
     130}}}
     131 - this results in a custom {{{.config}}} file in the {{{openwrt}}} directory which you may want to save away
    125132
    126 The actual building of the Ubuntu rootfs does not happen in the Gateworks BSP instructions described above.
     133Modifying OpenWrt kernel:
     134{{{#!bash
     135make -C openwrt kernel_menuconfig
     136}}}
     137 - this results in modifying {{{target/linux/octeontx/config-*}}} in the {{{openwrt}}} directory which you may want to save away
     138 - Note that some kernel configurations get over-written by OpenWrt despite what you may select here
    127139
    128 Information for manually building Ubuntu rootfs can be found here: [wiki:newport/ubuntu]
     140Build/rebuild OpenWrt (with your customizations):
     141{{{#!bash
     142make openwrt
     143}}}
     144 - results in build artifacts in {{openwrt/bin/targets/octeontx/generic/}}} including rootfs tarball, linux kernel, and squashfs filesystem
    129145
     146Building OpenWrt Image from Newport BSP directory:
     147{{{#!bash
     148make openwrt-image # builds OpenWrt for octeontx and compressed disk image
     149}}}
     150 * results in {{{openwrt-newport.img} - see {{{bsp/Makefile}}} {{{openwrt-image}}} target for details