Changes between Version 22 and Version 23 of newport/bsp

Timestamp:

02/08/2019 08:15:37 PM (5 years ago)

Author:

Tim Harvey

Comment:

added section on configuring OpenWrt

newport/bsp

@@ -1 +1 @@
 [[PageOutline]]
 
-= Newport Board Support Package (BSP) =
+= Newport Board Support Package (BSP)
 Gateworks provides a Board Support Package for Newport which provides source code and an easy mechanism to build different images, including Ubuntu and OpenWrt.
 
@@ -12 +12 @@
 
 [=#images]
-== BSP Pre-Built Firmware Images ==
+== BSP Pre-Built Firmware Images
 
 Pre-built firmware images can be found on http://dev.gateworks.com/newport.
@@ -30 +30 @@
 ''' Installation ''' instructions are at the following URL: [wiki:/newport/firmware#UpdateFirmwareviaSerialConsoleandEthernetfromBootloader Newport Flashing Instructions] 
 
+
 [=#source]
-== BSP Source Code ==
+== BSP Source Code
 Newport 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].
 
@@ -46 +47 @@
 
 [=#build]
-== Building the BSP from source ==
+== Building the BSP from source
 Below 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].
 
@@ -96 +97 @@
   * [wiki:/newport/boot#BuildingaBootableDiskImages Creating Entire Disk Images for Booting]
 
+
 [=#kernel]
-== Building or Modifying the stand-alone Linux Kernel for Newport Ubuntu
+=== Modifying the stand-alone Linux Kernel (ie for Ubuntu)
 The Gateworks Newport BSP instructions [#build above] create an environment for building the Linux kernel among other targets.
 
@@ -120 +122 @@
 
 
-== Building Ubuntu Operating System - rootfs
+=== Modifying OpenWrt (toolchain, apps, kernel)
+The OpenWrt build system includes building its own toolchain and kernel (so the kernel and toolchain directories in the bsp directory are not used)
 
-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. 
+Modifying OpenWrt toolchain, installed applications, and general configuration:
+{{{#!bash
+make -C openwrt menuconfig # configure toolchain, installed applications and general configuration
+}}}
+ - this results in a custom {{{.config}}} file in the {{{openwrt}}} directory which you may want to save away
 
-The actual building of the Ubuntu rootfs does not happen in the Gateworks BSP instructions described above. 
+Modifying OpenWrt kernel:
+{{{#!bash
+make -C openwrt kernel_menuconfig
+}}}
+ - this results in modifying {{{target/linux/octeontx/config-*}}} in the {{{openwrt}}} directory which you may want to save away
+ - Note that some kernel configurations get over-written by OpenWrt despite what you may select here
 
-Information for manually building Ubuntu rootfs can be found here: [wiki:newport/ubuntu]
+Build/rebuild OpenWrt (with your customizations):
+{{{#!bash
+make openwrt
+}}}
+ - results in build artifacts in {{openwrt/bin/targets/octeontx/generic/}}} including rootfs tarball, linux kernel, and squashfs filesystem
 
+Building OpenWrt Image from Newport BSP directory:
+{{{#!bash
+make openwrt-image # builds OpenWrt for octeontx and compressed disk image
+}}}
+ * results in {{{openwrt-newport.img} - see {{{bsp/Makefile}}} {{{openwrt-image}}} target for details