Changes between Version 27 and Version 28 of provisioning

Timestamp:

12/28/2024 12:12:35 AM (3 weeks ago)

Author:

Ryan Erbstoesser

Comment:

add custom rootfs example

provisioning

@@ -23 +23 @@
 Once completed, send Gateworks support team your .img.gz compressed disk image to be applied to a large order. 
 
-== More Venice Options
+== Venice Options
 
 
@@ -81 +81 @@
 1. Boot target to a Linux rescue image (below)
 1. Run a script that creates your partition table and partition contents from scratch (using the steps from the previous option)
+
+=== Option C Details
+
+This involves a custom_rootfs script used in conjuction with the Venice BSP ([wiki:venice/bsp])
+
+Before doing any of the following, be sure to build the Venice BSP once successfully before injecting any changes. 
+
+In the Venice BSP Makefile, on line 256, there is a hook for a custom_rootfs script to be ran. 
+[https://github.com/Gateworks/bsp-venice/blob/master/Makefile#L256]
+
+Basically, drop a file inside of the main directory when building the Venice BSP with the name starting with custom_rootfs will be ran. Example file name is custom_rootfs_test.sh
+{{{
+builder@jammy:~/venice$ ls
+Makefile  buildroot              firmware-imx-8.10      ftdi-usb-spi  linux-venice.tar.xz  noble-venice.ext4.xz  setup-environment         uboot-env.bin
+atf       cryptodev-linux        firmware-imx-8.10.bin  gnss_devkit   mkimage_jtag         noble-venice.img.gz   u-boot                    venice
+build     custom_rootfs_test.sh  firmware.img           linux         noble-venice.ext4    nrc7292               ublox-dev-kit-README.txt  venice-imx8mm-flash.bin
+}}}
+
+Inside this file, run a script that runs on the build machine to create and grab files to be placed into the Ubuntu filesystem. 
+
+The Ubuntu filesystem is of ext2 format, and thus e2tools must be used. In the example below, e2cp is a command that ends up copying files into the /root directory (default Gateworks home directory) when the Ubuntu OS is booted. 
+
+The below example does some random things such as grabbing a tar ball, creating a readme and then copying it into the Ubuntu OS. 
+
+After creating this file, re-run the make argument to rebuild the Gateworks BSP with the custom changes now integrated:
+{{{
+make -j8 ubuntu-image
+}}}
+
+The output should then be a file such as noble-venice.img.gz, which can then be flashed onto the Gateworks SBC and should contain the changes. 
+
+
+Example custom_rootfs_test.sh file:
+{{{
+#!/bin/bash
+
+set -x # enable script debugging (see all commands executed)
+set -e # exit on error
+
+IMAGE=$1
+KERNEL=linux
+
+# temp dir
+TMP=$(mktemp -d -t tmp.XXXXXX)
+
+#grab a tarball of some GPS files
+wget https://dev.gateworks.com/fae/gnss.tar -O $TMP/gnss.tar
+
+#create all files in TMP first
+mkdir -p $TMP/gnss_devkit
+tar -xvf $TMP/gnss.tar -C $TMP
+chmod +x $TMP/gnss_devkit/setup.sh
+
+#Create a readme file that is going to be placed into the /root directory
+cat <<\EOF > $TMP/ublox-dev-kit-README.txt
+This is a basic readme file
+EOF
+
+
+rm -rf $TMP/gnss.tar
+#now copy all TMP files into the actual Ubuntu Image at location specified 
+e2cp $TMP/* $IMAGE:/root/
+e2mkdir $IMAGE:/root/gnss_devkit
+chmod +x $TMP/gnss_devkit/setup.sh
+e2cp -p $TMP/gnss_devkit/* $IMAGE:/root/gnss_devkit/
+
+#cleanup TMP
+rm -rf $TMP
+}}}
 
 === Linux Rescue Image