Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

The Flash-N-Go infrastructure (or FnG infrastructure) is a software product for NXP i.MX Edge devices created by SECO. Consisting of three parts: Flash-N-Go Boot, Flash-N-Go System and Flash-N-Go Update; it provides a convenient way of booting, flashing, testing and updating edge devices. FnG Infrastructure is available on the following series of devices:

  • Products of the SAN* family of devices with i.MX6: SANTARO, SANTOKA, SANTINO,…

  • NALLINO with i.MX6ULL

  • TANARO with i.MX8MM

...

Booting Flash-N-Go System

There are two possible options for booting the device into Flash-N-Go System instead of booting the target OS. The first one is pressing down and holding the bootmode switch while the power supply is switched on. The location of the bootmode switch is shown in the following figure

...

Alternatively, the bootselect tool can be used, available modes are regular for normal target OS and alternative for Flash-N-Go System.

Info

The bootmode switch needs to be held on each boot process. The selection made with bootselect is persistent.

...

Expand
titleUsing bootselect tool

It is also possible to use abbreviation such as a for alternative and so on.

Code Block
languagebash
root@santaro:~# bootselect a
alternative
root@santaro:~# bootselect r
regular

...

The manual system update considers a manual operating system (OS) installation via a console. The progress can be done locally using mass storage devices or using a network connection. The update process described here requires an Ethernet connection of the device to a development PC, either directly or via intranet. Also, a TFTP-Server or HTTP-Server is required on the development PC. There are several, also free, TFTP-Servers and HTTP-Servers online available. Please make sure that the timeout settings of the TFTP-Server are set to 60 seconds at a minimum. The installation of target OSes, and Flash-N-Go System and Flash-N-Go Boot should work via console one- or two-liners. All device partitioning, deployment actions should be done by shell scripts executed by the simple command. See Booting Flash-N-Go System for instructions on how to boot into the management system.

...

note
Code Block
languagebash
sconfig dhcp on
reboot 

It is also necessary to install a TFTP-server or HTTP-server on a host PC.

Installation via network

The common concept of the installation is always similar.

  1. Set the download source variable TFTP (or URL for newer installation script versions)

  2. Download the installation script (with curl) and

  3. Execute the installation script (with sh).

These concatenating these steps the installation can be done in one-liner commands.

Info

Our latest releases can be found here (FnG-System) and here (Yocto)

Example 1: Install Yocto

...

Kirkstone 25.0

Set the variable location, then call curl to download it to pipe to sh

Code Block
breakoutModewide
FNG="https://secostorage.blob.core.windows.net/seco-ne-public/HMI/Linux-Yocto/Releases/Yocto-kirkstone-

...

25.0

...

  • GUF-Yocto-15.0-r4523-9-SANTARO-boot.cfg

  • GUF-Yocto-15.0-r4523-9-SANTARO-fng-install.sh

  • GUF-Yocto-15.0-r4523-9-SANTARO-imx6-santaro-x1.dtb

  • GUF-Yocto-15.0-r4523-9-SANTARO-imx6-santaro-x2.dtb

  • GUF-Yocto-15.0-r4523-9-SANTARO-linuximage.bin

  • GUF-Yocto-15.0-r4523-9-SANTARO-modules.tgz

  • GUF-Yocto-15.0-r4523-9-SANTARO-pkg.py

  • GUF-Yocto-15.0-r4523-9-SANTARO-root.tar.gz

To start the upgrade process use:

Code Block
breakoutModewide
languagebash
export TFTP=tftp://<TFTP-Server IP> ; curl $TFTP/GUF-Yocto-15.0-r4523-9-SANTARO-fng-install.sh | sh
Info

Replace <TFTP-Server IP> with the IP address of your TFTP-server

Example 2: Upgrade to Flash-N-Go System 8.0

Download the Flash-N-Go System files listed below from the Flash-N-Go/FNGSystem/FNGSystem8.0 folder of the support server.

  • Flash-N-Go-System-8.0-python-3.1.4.ext2

  • Flash-N-Go-System-8.0-self-init.sh

  • Flash-N-Go-System-8.0-self-update.sh

  • Flash-N-Go-System-8.0.cpio.gz

  • GF_Bootlogo_Flash-N-Go-System.png

  • boot-alt.cfg

  • fng_wipe_emmc.sh

Additionally, download the Kernel Files files listed below from the Flash-N-Go/FNGSystem/FNGSystem-8.0/GUFYocto-35.0-r5982-0 directory of the support server. Place them in a subfolder of the TFTP-Server root folder named GUF-Yocto-35.0-r5982-0

  • GUF-Yocto-35.0-r5982-0-IMX6GUF-imx6dl-santaro.dtb

  • GUF-Yocto-35.0-r5982-0-IMX6GUF-imx6dl-santino-lt.dtb

  • GUF-Yocto-35.0-r5982-0-IMX6GUF-imx6dl-santino.dtb

  • GUF-Yocto-35.0-r5982-0-IMX6GUF-imx6dl-santoka.dtb

  • GUF-Yocto-35.0-r5982-0-IMX6GUF-imx6q-santaro.dtb

  • GUF-Yocto-35.0-r5982-0-IMX6GUF-imx6q-santoka.dtb

  • GUF-Yocto-35.0-r5982-0-IMX6GUF-linuximage.bin

  • GUF-Yocto-35.0-r5982-0-IMX6GUF-modules.ext4

  • ParamFile.txt

  • md5sums.txt

To start the upgrade process use the following lines

Code Block
breakoutModewide
languagebash
export TFTP=<TFTP-Server IP>
curl tftp://$TFTP/Flash-N-Go-System-8.0-self-update.sh | -s -- --ParamFile=GUF-Yocto-35.0-r5982-0/ParamFile.txt
Info

Replace <TFTP-Server IP> with the IP address of your TFTP-server

Example 3: Upgrade Flash-N-Go Boot to version 13.0

Download the Flash-N-Go Boot files listed below from the Flash-N-Go/FNGBoot/FNGBoot-v13.0r3476/ directory of the support server.

  • GF_iMX6x-FNGBoot-v13.0r3797_26-09-2019.bin

  • fng_boot_update.sh

  • md5sums.txt

Code Block
languagebash
export TFTP=<TFTP-Server IP>; curl tftp://$TFTP/fng_boot_update.sh | sh
Info
Replace <TFTP-Server IP> with the IP address of your TFTP-server
/seco-mx6/fng-install.sh"
curl --location "$FNG" | sh -s -- --url="$(dirname "$FNG")"

The parameter url of the script should point to the location of the folder where the installation files are located.

Example 2: Install Flash-N-Go System 51

The process is similar to installing the target OS

Code Block
breakoutModewide
FNG="https://secostorage.blob.core.windows.net/seco-ne-public/HMI/Flash-N-Go/FNGSystem/FNGSystem-51.0/seco-mx6/fngsystem-self-update.sh"
curl --location "$FNG" | sh -s -- --url="$(dirname "$FNG")"

Security Considerations

The Flash-N-Go System is designed as a management system to install and update target operating systems and change the device configurations. Thus it runs with root privileges. This may be a concern for some scenarios. Therefore some security considerations are necessary.

...