UBI/UBIFS Filesystem - Revision history

Pzimmermann at 05:39, 14 July 2020

2020-07-14T05:39:38Z

← Older revision		Revision as of 07:39, 14 July 2020
Line 131:		Line 131:
	You can also check the health of the NAND flash at the bootloader (for example when the linux isn't booting anymore). The following commands are needed for doing this:		You can also check the health of the NAND flash at the bootloader (for example when the linux isn't booting anymore). The following commands are needed for doing this:
	* <code>mtdparts</code> to get the name of the UBI device (in this example: "main-nand").		* <code>mtdparts</code> to get the name of the UBI device (in this example: "main-nand").
	* <code>ubi part main-nand</code> to set the current partition to the UBI device.		* <code>ubi part main-nand</code> to set the current partition to the UBI device (in this case it is set to main-nand).
	* <code>ubi info</code> to print the information about the UBI device.		* <code>ubi info</code> to print the information about the UBI device.

Pzimmermann at 07:55, 13 July 2020

2020-07-13T07:55:03Z

← Older revision		Revision as of 09:55, 13 July 2020
Line 105:		Line 105:
	<code> ubiformat /dev/mtdX –f Image.ubi </code>		<code> ubiformat /dev/mtdX –f Image.ubi </code>

	=== Check the health of ~~the~~ NAND-flash ===		== Check the health of a NAND-flash with features of the UBI device ==

	If an UBI Device is used on top of NAND-flash, you can use <code>ubinfo /dev/ubiY</code> to check the health of the NAND-flash.		If an UBI Device is used on top of NAND-flash, you can use <code>ubinfo /dev/ubiY</code> to check the health of the NAND-flash.

Pzimmermann: Added information on how to check the health status of the NAND flash trough features of UBI devices

2020-07-13T07:53:50Z

Added information on how to check the health status of the NAND flash trough features of UBI devices

← Older revision		Revision as of 09:53, 13 July 2020
Line 104:		Line 104:

	<code> ubiformat /dev/mtdX –f Image.ubi </code>		<code> ubiformat /dev/mtdX –f Image.ubi </code>

			=== Check the health of the NAND-flash ===

			If an UBI Device is used on top of NAND-flash, you can use <code>ubinfo /dev/ubiY</code> to check the health of the NAND-flash.

			Here an example:
			<tt>root@dhcom1bimx6ull:~# ubinfo /dev/ubi0
			ubi0
			Volumes count: 2
			Logical eraseblock size: 126976 bytes, 124.0 KiB
			Total amount of logical eraseblocks: 1019 (129388544 bytes, 123.3 MiB)
			Amount of available logical eraseblocks: 0 (0 bytes)
			Maximum count of volumes 128
			Count of bad physical eraseblocks: 5
			Count of reserved physical eraseblocks: 15
			Current maximum erase counter value: 40
			Minimum input/output unit size: 2048 bytes
			Character device major/minor: 242:0
			Present volumes: 0, 1</tt>

			Important are the following fields:
			* "'''Count of bad physical eraseblocks'''": This value indicates how many eraseblocks are bad. Note that there may be some eraseblocks that are bad when the NAND-flash memory was manufactured.
			* "'''Count of reserved physical eraseblocks'''": This number indicates how many eraseblocks are available as a reserve if other eraseblock gets bad. If this reserve is depleted then it is a sign that the NAND-flash is at the end of its life.
			* "'''Current maximum erase counter value'''": This value indicates how often the eraseblock with the highest number of erases was erased. Note that UBI devices use wear leveling to distribute the erases of heavely used eraseblocks to different eraseblocks. The number of erases an eraseblock can usually last until it gets bad depends on the NAND flash itself. '''Important''': The erase counter is saved inside the data structure of the UBI device, so if you erase the NAND flash without using <code>ubiformat</code> the current erase counter will get lost and reset to 1!

			You can also check the health of the NAND flash at the bootloader (for example when the linux isn't booting anymore). The following commands are needed for doing this:
			* <code>mtdparts</code> to get the name of the UBI device (in this example: "main-nand").
			* <code>ubi part main-nand</code> to set the current partition to the UBI device.
			* <code>ubi info</code> to print the information about the UBI device.

Lzenz: /* Flashing UBI/UBIFS Images */

2012-09-27T07:52:42Z

Flashing UBI/UBIFS Images

← Older revision		Revision as of 09:52, 27 September 2012
Line 93:		Line 93:
	== Flashing UBI/UBIFS Images ==		== Flashing UBI/UBIFS Images ==

	The following commands can be used to flash UBI/UBIFS Images. When you want to run a linux root-filesystem update please use the [[DHCOM Flash Update\|DHCOM Update Mechnism]]. In special cases you can use the following commands:		The following commands can be used to flash UBI/UBIFS Images on a running linux device (you can not flash your active root filesystem). When you want to run a linux root-filesystem update please use the subfunction [[DHCOM Update: Linux Root Filesystem\| Root Filesystem Update]] of the [[DHCOM Flash Update\|DHCOM Update Mechnism]]. In special cases you can use the following commands:

	=== Flash a UBIFS Image ===		=== Flash a UBIFS Image ===

Lzenz: /* Flashing UBI/UBIFS Images */

2012-09-27T07:47:35Z

Flashing UBI/UBIFS Images

← Older revision		Revision as of 09:47, 27 September 2012
Line 93:		Line 93:
	== Flashing UBI/UBIFS Images ==		== Flashing UBI/UBIFS Images ==

	The following commands can be used to flash UBI/UBIFS Images. When you want to run a linux root-filesystem update please use the [[DHCOM Flash Update\|DHCOM Update Mechnism]]. ~~You~~ can use the following commands ~~for data partitions.~~		The following commands can be used to flash UBI/UBIFS Images. When you want to run a linux root-filesystem update please use the [[DHCOM Flash Update\|DHCOM Update Mechnism]]. In special cases you can use the following commands:

	=== Flash a UBIFS Image ===		=== Flash a UBIFS Image ===

Lzenz: Created page with "== Overview == On DHCOM Systems with Linux the UBIFS Filesystem is used for the NAND-Flash root-filesystem. The Unsorted Block Image File System (UBIFS) is a filesystem for use ..."

2012-09-26T14:57:57Z

Created page with "== Overview == On DHCOM Systems with Linux the UBIFS Filesystem is used for the NAND-Flash root-filesystem. The Unsorted Block Image File System (UBIFS) is a filesystem for use ..."

New page

== Overview ==

On DHCOM Systems with Linux the UBIFS Filesystem is used for the NAND-Flash root-filesystem. The Unsorted Block Image File System (UBIFS) is a filesystem for use with raw flash memory media. UBIFS works on top of an Unsorted Block Images (UBI) device, which is itself on top of an MTD device.

For further details please have a look at

* [http://www.linux-mtd.infradead.org/doc/ubi.html UBI documentation]
* [http://www.linux-mtd.infradead.org/doc/ubifs.html UBIFS documentation]
* [http://www.linux-mtd.infradead.org/doc/general.html MTD documentation]

== Create Images ==

To create UBI-Images or UBIFS-Images you need to install the "mtd-utils" on your Linux host pc. We recommend to download the latest version of the mtd-utils form the [http://git.infradead.org/mtd-utils.git mtd-utils git-repository] because it is reported that some versions from the distribution repositorys are buggy and/or out of date.

=== Create UBIFS Images ===

To create a UBIFS Image you need some hardware-depended information.
* <code> <min io size> </code> Equals the page-size of the used NAND-Flash
* <code> <LEB size> </code> Logical Erase Block size
* <code> <Erase Blocks count> </code> maximum logical erase block count

If got this information, you can create a UBIFS-Image from a directory-tree with the following command:

<code># sodu mkfs.ubifs -F -r </path/to/your/rootfs/tree> -m <min io size> -e <LEB size> -c <Erase Blocks count> -o </path/to/output/Image.ubifs> </code>

'''Examples'''

''for am3517 with 256MB NAND-Flash''

<code># sudo mkfs.ubifs –F -r /work/rootfs -m 2048 -e 126976 -c 1700 -o am35x.ubifs </code>

''for i.MX25 with 256MB NAND-Flash''

<code># sudo mkfs.ubifs –F -r /work/rootfs -m 2048 -e 129024 -c 1700 -o imx25.ubifs </code>

'''Remark'''
To use the option -F you habe to run a kernel version 3.0 or higher. You need to have the "mtd-utils" version 1.5.x or higher, too.

Use the <code>ubinfo</code> command on your device to check the LEB size and count.
Example: <code># ubinfo /dev/ubi0 </code>

=== Create UBI Images ===

To create a UBI image you have to have already a UBIFS image. Use the following command:

<code># ubinize -vv -o <output image> -m <min io size> -p <PEB size>KiB -s <subpage-size> -O <VID-hdr-offset> <configuration file> </code>

* <code> <min io size> </code> Equals the page-size of the used NAND-Flash
* <code> <PEB size> </code> Physical Erase Block size (in KiB) - Equals the block size of the NAND-Flash
* <code> <Erase Blocks count> </code> Count of the available Erase Blocks
* <code> <subpage-size> </code> Subpage size in bytes. Default value is the minimum input/output size (page-size)
* <code> <VID-hdr-offset> </code> offset if the VID header from start of the PEB (default is the next min I/O unit or sub-page after the EC header)
* <code> <configuration file> </code> Path to a configuration file.

Example of a configuration file content (config.ini):
<code> [rootfs_volume]
mode=ubi
image=imx25.ubifs
vol_id=0
vol_type=dynamic
vol_name=nand_rootfs
vol_flags=autoresize</code>

'''Examples'''

''for am3517''

<code># sudo ubinize -vv -o am3517_rtfs.ubi -m 2048 -p 128KiB config.ini</code>

''for i.MX25''

<code># sudo ubinize -vv -o imx25_rtfs.ubi -m 2048 -p 128KiB -s 512 -O 512 config.ini </code>

== User-space tools ==

The UBI/UBIFS user-space tools are included within the mtd-utils.

some commands are:
* <code>ubinfo </code> - provides information about UBI devices and volumes found in the system;
* <code>ubiattach </code> - attaches MTD devices (which describe raw flash) to UBI and creates corresponding UBI devices;
* <code>ubidetach </code> - detaches MTD devices from UBI devices (the opposite to what ubiattach does);
* <code>ubimkvol </code> - creates UBI volumes on UBI devices;
* <code>ubirmvol </code> - removes UBI volumes from UBI devices;
* <code>ubiupdatevol </code> - updates UBI volumes;
* <code>ubiformat </code> - formats empty flash, erases flash and preserves erase counters, flashes UBI images to MTD devices;
* <code>mtdinfo </code> - reports information about MTD devices found in the system.

Use the "-h" option to get more information about the commands.

== Flashing UBI/UBIFS Images ==

The following commands can be used to flash UBI/UBIFS Images. When you want to run a linux root-filesystem update please use the [[DHCOM Flash Update|DHCOM Update Mechnism]]. You can use the following commands for data partitions.

=== Flash a UBIFS Image ===
<code>ubiformat /dev/mtdX
ubiattach -m X -d Y /dev/ubi_ctrl
ubimkvol /dev/ubiY -N volume_name -s -m
ubiupdatevol /dev/ubiY_0 /path/to/Image.ubifs </code>

=== Flash a UBI Image ===

<code> ubiformat /dev/mtdX –f Image.ubi </code>