View source for IOT-DIN-IMX8PLUS: U-Boot: Installation

== Overview ==
This article provides instructions needed to install the U-Boot firmware onto the Compulab IOT-DIN-IMX8PLUS internal storage.
The recommended installation procedure is using a host PC with a Debian-based operating system.

== Preparing Installation Media ==
Prepare [[IOT-DIN-IMX8PLUS: Debian Linux: Preparing Live Media|Debian Linux Live Media]]

== Installing U-Boot Firmware onto the internal storage ==
=== Booting into installation environment ===
* Insert the Live USB flash drive into the [[IOT-DIN-IMX8PLUS: Getting Started#Front_panel|USB3.0 port]]
* Power on the device
* Press a key to prevent a possible autoboot and get into the U-Boot command prompt.
* Run a command below:
:<pre>run bsp_bootcmd</pre>
{{Note|''U-Boot 2021.04-compulab-1.5'' version or later runs ''bsp_bootcmd'' by default}}
* Wait for the Linux login prompt
* [[IOT-DIN-IMX8PLUS: Debian_Linux: How-To_Guide#Connection_and_Login|Login]] as '''compulab''' user

=== Running U-Boot Firmware installation ===
* Invoke '''cl-uboot''' utility
:<pre>compulab@compulab-imx8mp:~$ sudo cl-uboot</pre> 
* Select an appropriate U-Boot image by determining device's [[IOT-DIN-IMX8PLUS: U-Boot: Recovery#Determining_RAM_size|DRAM size]]
<pre>
Select a U-Boot file:
─────────────────────────────────────────────────────────────────────────────────────────

       ┌─────────────────────────────────────────────────────────────────────┐
       │  Available U-Boot files:                                            │
       │ ┌─────────────────────────────────────────────────────────────────┐ │
       │ │                                                                 │ │
       │ │                      ( ) flash.bin.d1d8                         │ │
       │ │                      (*) flash.bin.d2d4                         │ │
       │ │                                                                 │ │
       │ │                                                                 │ │
       │ │                                                                 │ │
       │ └─────────────────────────────────────────────────────────────────┘ │
       │                     <  OK  >        <Cancel>                        │
       └─────────────────────────────────────────────────────────────────────┘
</pre>
* Select '''mmcblk2boot0''' as a boot device
<pre>
Select a boot device:
─────────────────────────────────────────────────────────────────────────────────────────

       ┌─────────────────────────────────────────────────────────────────────┐
       │  Available boot devices:                                            │
       │ ┌─────────────────────────────────────────────────────────────────┐ │
       │ │                                                                 │ │
       │ │                      ( ) mmcblk2                                │ │
       │ │                      (*) mmcblk2boot0                           │ │
       │ │                                                                 │ │
       │ │                                                                 │ │
       │ │                                                                 │ │
       │ └─────────────────────────────────────────────────────────────────┘ │
       │                     <  OK  >        <Cancel>                        │
       └─────────────────────────────────────────────────────────────────────┘
</pre>
* Installation will start
* When installation is complete, the following message will show up:
<pre>

       ┌─────────────────────────────────────────────────────────────────────┐
       │ U Boot flash result:                                                │
       │─────────────────────────────────────────────────────────────────────│
       │ 1807+1 records in                                                   │
       │ 1807+1 records out                                                  │
       │ 1850392 bytes (1.9 MB, 1.8 MiB) copied, 0.120991 s, 15.3 MB/s       │
       │                                                                     │
       │                                                                     │
       │─────────────────────────────────────────────────────────────────────│
       │                              <  OK  >                               │
       └─────────────────────────────────────────────────────────────────────┘
</pre>
* Press '''OK''' to exit utility

= After Installation =
* Turn off the device
* Remove installation media
* Turn on the device
* Press a key to prevent a possible autoboot and get into the U-Boot command prompt
* Restore default boot environment, save it and reset device:
:<pre>env default -a ; saveenv ; reset</pre>

[[Category:Linux]]
[[Category:U-Boot]]
[[Category:IOT-DIN-IMX8PLUS]]