boot

The boot folder contains files that are added to the boot partition. Its Makefile downloads required firmware from their source repos on GitHub during the build.

The two types of boot files integrated in this folder are:

  • configuration files
  • firmware files

Configuration files

You can modify the following configuration files either before running a build or after the image is built and flashed, directly in the boot partition. The system checks the files during the next device boot:

  • network
  • wpa_supplicant.conf

network

The network file sets certain network variables at boot time if the file timestamp is newer than its corresponding setting file in the system partition.

The table below outlines the variables, what they control, and provides an example of how to set them:

VariableUsageExample
HOSTNAMESets the device host name. The default hostname is qnxpi.HOSTNAME=qnxpi
IP_ADDRSets a static IP address. If not present, the default value obtains an IP address via DHCP.IP_ADDR=192.168.0.220
TIME_SERVERSSets one or more time servers, if present.TIME_SERVERS=0.pool.ntp.org:1.pool.ntp.org

wpa_supplicant.conf

The wpa_supplicant.conf file overrides Wi-Fi network details prior to first boot or on subsequent boots.

Refer to the "Wi-Fi" section of the QSTI chapter for more details on how to populate the file.

You can also set the same network configurations by altering a Wi-Fi snippets. Refer to the "wifi-custom" entry in "snippets" for more details.

Firmware files

The Raspberry Pi firmware files are available to download from GitHub. The Makefile in this folder automates the process to make this process as seamless as possible.

Device firmware files are downloaded in this folder and incorporated into the boot partition directly.

Wi-Fi firmware is downloaded in the wifi subfolder, also from GitHub, but these files are integrated into the system partition.

Note that no customization is necessary at this time for firmware files that are integrated during the build.

Page updated: