diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index b2a2e32c5d..95289c990f 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -4823,10 +4823,14 @@
- Continuing with the example, you can now directly
- dd the image to a USB stick, or
- whatever media for which you built your image,
- and boot the resulting media:
+ Continuing with the example, you can now write the
+ image to a USB stick, or whatever media for which
+ you built your image, and boot the resulting media.
+
+
+
+ The following example uses dd
+ to write the image to a USB stick:
$ sudo dd if=/var/tmp/wic/build/mkefidisk-201310230946-sda.direct of=/dev/sdb
[sudo] password for trz:
@@ -4836,6 +4840,23 @@
[trz at empanada ~]$ sudo eject /dev/sdb
+
+
+ This next example uses the
+ bmap-tool.
+ For this example, it is assumed you have write
+ access:
+
+ $ oe-run-native bmap-tool copy /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/mkefidisk.wks /dev/sdb
+
+
+ For more information on how to use the
+ bmap-tool to flash a device
+ with an image, see the
+ "Flashing Images Using bmap-tool"
+ section.
+
+
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml
index b59f54b085..bcee11ba22 100644
--- a/documentation/dev-manual/dev-manual-start.xml
+++ b/documentation/dev-manual/dev-manual-start.xml
@@ -328,6 +328,99 @@
+
+ Flashing Images Using <filename>bmap-tool</filename>
+
+
+ An easy way to flash an image to a bootable device is to use
+ bmap-tool, which is integrated into the
+ OpenEmbedded build system.
+
+
+
+ Following, is an example that shows how to flash a Wic image.
+
+ You can use bmap-tool to flash any
+ type of image.
+
+ Use these steps to flash an image using
+ bmap-tool:
+
+
+ Add the following to your local.conf
+ file:
+
+ IMAGE_FSTYPES += "WIC WIC.BMAP"
+
+
+
+ Either have your image ready (pre-built) or take the step
+ build the image:
+
+ $ bitbake image
+
+
+
+ Flash the image to the media by using the
+ bmap-tool depending on your particular
+ setup:
+
+
+ If you have write access, use this command form:
+
+ $ oe-run-native bmap-tool copy ./tmp/deploy/images/qemux86-64/core-image-minimal-machine.wic /dev/sdX
+
+
+
+ If you do not have write access, use the following
+ commands:
+
+ $ sudo bash
+ $ PATH=tmp/sysroots/x86_64-linux/usr/bin/ bmaptool copy ./tmp/deploy/images/qemux86-64/core-image-minimal-machine.wic /dev/sdX
+
+
+ If you are using Ubuntu 16.10 or Debian,
+ you can install
+ bmaptool using the
+ following command and then use the tool
+ without specifying
+ PATH even from the
+ root account:
+
+ $ sudo apt-get install bmap-tool
+
+
+
+
+
+
+
+
+
+ For help on the bmaptool command, use
+ bmaptool --help:
+
+ $ bmaptool --help
+ usage: bmaptool [-h] [--version] [-q] [-d] {create,copy} ...
+
+ Create block map (bmap) and copy files using bmap. The documentation can be
+ found here: source.tizen.org/documentation/reference/bmaptool
+
+ optional arguments:
+ -h, --help show this help message and exit
+ --version show program's version number and exit
+ -q, --quiet be quiet
+ -d, --debug print debugging information
+
+ subcommands:
+ {create,copy}
+ create generate bmap for an image file (which should be a sparse
+ file)
+ copy write an image to a block device using bmap
+
+
+
+
Using Pre-Built Binaries and QEMU