diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 908530cd0e..60af73d0ed 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -6253,79 +6253,87 @@ Some notes from Cal:
Flashing Images Using bmaptool
- An easy way to flash an image to a bootable device is to use
- bmaptool, which is integrated into the
- OpenEmbedded build system.
+ A fast and easy way to flash an image to a bootable device
+ is to use Bmaptool, which is integrated into the OpenEmbedded
+ build system.
+ Bmaptool is a generic tool that creates a file's block map (bmap)
+ and then uses that map to copy the file.
+ As compared to traditional tools such as dd or cp, Bmaptool
+ can copy (or flash) large files like raw system image files
+ much faster.
+ Notes
+
+
+ If you are using Ubuntu or Debian distributions, you
+ can install the bmap-tools package
+ using the following command and then use the tool
+ without specifying PATH even from
+ the root account:
+
+ $ sudo apt-get install bmap-tools
+
+
+
+ If you are unable to install the
+ bmap-tools package, you will
+ need to build Bmaptool before using it.
+ Use the following command:
+
+ $ bitbake bmap-tools-native
+
+
+
+
Following, is an example that shows how to flash a Wic image.
-
- You can use bmaptool to flash any
- type of image.
-
- Use these steps to flash an image using
- bmaptool:
-
- Unless you are able to install the
- bmap-tools package as mentioned in the note
- in the second bullet of step 3 further down, you will need to build
- bmaptool before using it.
- Build the tool using the following command:
-
- $ bitbake bmap-tools-native
-
-
+ Realize that while this example uses a Wic image, you can use
+ Bmaptool to flash any type of image.
+ Use these steps to flash an image using Bmaptool:
- Update the local.conf File:
- Add the following to your local.conf
- file:
+ Update your local.conf File:
+ You need to have the following set in your
+ local.conf file before building
+ your image:
IMAGE_FSTYPES += "wic wic.bmap"
Get Your Image:
- Either have your image ready (pre-built) or take the step
- build the image:
+ Either have your image ready (pre-built with the
+ IMAGE_FSTYPES
+ setting previously mentioned) or take the step to build
+ the image:
$ bitbake image
Flash the Device:
- Flash the device with the image by using
- bmaptool depending on your particular
- setup:
+ Flash the device with the image by using Bmaptool
+ depending on your particular setup.
+ The following commands assume the image resides in the
+ Build Directory's deploy/images/
+ area:
- If you have write access to the media,
- use this command form:
+ If you have write access to the media, use this
+ command form:
- $ oe-run-native bmap-tools-native bmaptool copy ./tmp/deploy/images/qemux86-64-core-image-minimal-machine.wic /dev/sdX
+ $ oe-run-native bmap-tools-native bmaptool copy build-directory/tmp/deploy/images/machine/image.wic /dev/sdX
- If you do not have write access to
- the media, use the following
- commands:
+ If you do not have write access to the media, set
+ your permissions first and then use the same
+ command form:
$ sudo chmod 666 /dev/sdX
- $ oe-run-native bmap-tools-native bmaptool copy ./tmp/deploy/images/qemux86-64-core-image-minimal-machine.wic /dev/sdX
+ $ oe-run-native bmap-tools-native bmaptool copy build-directory/tmp/deploy/images/machine/image.wic /dev/sdX
-
- If you are using Ubuntu or Debian distributions,
- you can install the
- bmap-tools package using
- the following command and then use the tool
- without specifying
- PATH even from the
- root account:
-
- $ sudo apt-get install bmap-tools
-
-