View source for CM-T43: U-Boot: Firmware Update

== Introduction ==
The CM-T43 firmware consists of two components: Secondary Program Loader (SPL) and U-Boot, both provided on a single binary image {{filename|cm-t43-firmware}}.
This article describes the firmware update process for CM-T43 system-on-module product.

== Preliminary setup ==
* Make sure to power off the CM-T43 evaluation platform.
* Connect the host PC to the SB-SOM-T43 base-board (connector P8) via the serial cable supplied with the evaluation kit. 
* Start terminal emulation software on your PC. Set baud rate to 115200 bps, 8 bit per frame, 1 stop bit, no parity, no flow control.
* Turn on the CM-T43 evaluation system. The U-Boot boot-loader will start and you will get a command prompt in the terminal window.
{{Note|If the boot settings of your CM-T43 are different than default, you may need to press and hold ^C while turning the CM-T43 on, in order to get command prompt.}}

== Updating Firmware on the SPI flash ==
CM-T43 firmware can be updated from an SD card, usb storage, or using network TFTP download. 
Both methods are performed from the U-Boot command line and include following common steps:
# Loading binary image from the selected media to the CM-T43 DRAM
# Flashing image to the on-board SPI flash

=== Updating from SD card ===
* Copy the firmware binary image {{filename|cm-t43-firmware}} from [http://compulab.co.il/products/computer-on-modules/cm-t43/#devres U-Boot package for CM-T43] to the root directory of the SD card.
* Insert the SD card into the P9 socket on SB-SOM-T43.
* Start the U-Boot MMC subsystem:
<pre>
# mmc dev 0
# mmc rescan
</pre>
* Check that the storage device is ready:
<pre>
# ls mmc 0
</pre>
* Load the firmware binary into the memory:
<pre>
# load mmc 0 80a00000 cm-t43-firmware
</pre>
* Proceed to [[#Flashing images|Flashing images]] section

=== Updating from USB storage ===
* Copy the firmware binary image {{filename|cm-t43-firmware}} from [http://compulab.co.il/products/computer-on-modules/cm-t43/#devres U-Boot package for CM-T43] to the root directory of the USB storage device.
* Plug the USB storage device into the USB host connector (P6) on SB-SOM-T43. 
* Start the U-Boot USB subsystem:
<pre>
# usb start
</pre>
* Check that the storage device is ready:
<pre>
# ls usb 0
</pre>
* Load the firmware binary into the memory:
<pre>
# load usb 0 80a00000 cm-t43-firmware
</pre>
* Proceed to [[#Flashing images|Flashing images]] section

=== Updating from TFTP server ===
* Setup a TFTP server
* Put the firmware binary image {{filename|cm-t43-firmware}} in the root directory of the TFTP server
* Setup U-Boot networking:
: for dynamic IP configuration:
<pre>
# dhcp
</pre>
: or for static IP configuration:
<pre>
# setenv ipaddr <ip address>
</pre>
* Setup the TFTP server ip address:
<pre>
# setenv serverip <server ip>
</pre>
* Download the firmware binary into the memory:
<pre>
# tftp 80a00000 cm-t43-firmware
</pre>
* Proceed to [[#Flashing images|Flashing images]] section

=== Flashing images ===
* Make U-Boot probe the on-board SPI flash:
<pre>
# sf probe 0
</pre>
* Erase the on-board SPI flash:
<pre>
# sf erase 0 c0000
</pre>
* Write the firmware image into the on-board SPI flash:
<pre>
# sf write 80a00000 0 c0000
</pre>
* Reset the CM-T43 evaluation platform.

== Installing firmware on an SD card ==
CM-T43 system-on-module uses SPI flash as its main boot storage.
In addition to the on-board SPI flash, the CM-T43 can also boot from an SD-card.
The firmware can be installed as either raw data written into the SD-card, or as a file located in a FAT formatted partition.

=== Installing firmware as raw data ===
* Make sure that the SD card partitions do not start in the first 1MB of the SD card. Otherwise, the partitions may be overwritten by this procedure.
* Insert the SD card into the workstation card reader
* The SD card will be identified as {{filename|/dev/sdX}}, where X is the SD card drive letter.
* Run the following command:
<pre>
dd if=cm-t43-firmware of=/dev/sdX bs=1K seek=320 oflag=dsync
</pre>

=== Installing firmware as files in a FAT formatted partition ===
* Copy the file {{filename|MLO}} located in the images folder into the SD-card partition.
* Copy the file {{filename|u-boot.img}} located in the images folder into the SD-card partition.

== See also ==

* [[CM-T43: U-Boot: Firmware Overview]]
* [[U-Boot quick reference]]
* [[U-Boot images]]
* [[CM-T43: Linux: Getting started|Getting started with Linux on CM-T43]]
* [http://www.denx.de/wiki/U-Boot/Documentation U-Boot documentation]
* [http://processors.wiki.ti.com/index.php/SD/MMC_format_for_OMAP3_boot SD/MMC format for OMAP3 boot]

[[Category:U-Boot]]
[[Category:CM-T43]]