Changes between Version 11 and Version 12 of linux/ubi

Timestamp:

03/05/2019 10:33:28 PM (5 years ago)

Author:

Bobby Jones

Comment:

Add split update section

linux/ubi

@@ -327 +327 @@
 '''Note that operating on the ubi device as described here destroys the wear-leveling information contained in the UBI therefore it is recommended to work at the ubi volume layer to replace ubifs volumes as described below'''
 
+[=#SplitMethod]
+==== Updating UBI with low RAM devices:
+For some devices, the size of the NAND flash exceeds the size of RAM. In this scenario the instructions from the prior section would fail as you would run out of RAM space before you could finish retrieving the file to program the NAND flash with.
+
+To work around this limitation Gateworks has created an installable U-Boot script that will apply UBI files containing a single partition image. This can be particularly useful for updating the firmware of a running target.
+
+To update using a split UBI:
+ '''1. Split your UBI
+  In most situations the RAM of your device will be smaller than the image file required to update your system, therefore it is necessary to split the image file and apply the resulting compressed parts in a piece wise update. The below example uses the {{{split}}} command to split the input file into parts that are reasonably smaller than the RAM size of the board which will be consuming the update.
+ {{{#!bash
+FILE=xenial-large.ubi
+# Split file every 200M with suffix ".part" and decimal increment
+split -d -b 200M ${FILE} ${FILE}.part
+for i in $(ls ${FILE}.*); do
+ mv $i ${FILE}.$(echo $i | cut -d'.' -f3)
+done
+
+# Result will be multiple files such as xenial-large.ubi.partXX that are <= 200M and
+# which adhere to the naming convention required by the script (ends with .partXX in sequential order)
+}}}  
+ '''2. Install the U-Boot script
+  On the target machine, source the [http://trac.gateworks.com/raw-attachment/wiki/linux/ubi/nand_split_update.scr nand_split_update.scr] U-Boot script attached to this page (or copy its contents with an editor). For example via tftp:
+{{{#!bash
+setenv serverip 192.168.1.100
+tftp nand_split_update.scr
+source $loadaddr
+}}}
+ '''3. Configure your U-Boot environment 
+  From the script's usage:
+{{{
+The following environment variables need to be set in order for this script to run:
+
+    splitfile    - full path file name prefix of the splitted files (eg file.ubi for file.ubi.part00)
+}}}
+  An example configuration:
+{{{#!bash
+setenv splitfile xenial-large.ubi          # ubi file from example above
+}}}
+
+ '''4. Run the added script with {{{run nand_split_update}}}
+
+
+
 
 [=#uboot-ubifs]