diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 95289c990f..811c23e810 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -4824,36 +4824,23 @@ 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: + image to a USB stick, or whatever media for which you + built your image, and boot the resulting media. + You can write the image by using + bmaptool or + dd: - $ sudo dd if=/var/tmp/wic/build/mkefidisk-201310230946-sda.direct of=/dev/sdb - [sudo] password for trz: - 182274+0 records in - 182274+0 records out - 93324288 bytes (93 MB) copied, 14.4777 s, 6.4 MB/s - [trz at empanada ~]$ sudo eject /dev/sdb + $ oe-run-native bmaptool copy /var/tmp/wic/build/mkefidisk-201310230946-sda.direct /dev/sdX - - - - This next example uses the - bmap-tool. - For this example, it is assumed you have write - access: + or - $ oe-run-native bmap-tool copy /home/trz/yocto/yocto-image/scripts/lib/image/canned-wks/mkefidisk.wks /dev/sdb + $ sudo dd if=/var/tmp/wic/build/mkefidisk-201310230946-sda.direct of=/dev/sdX For more information on how to use the - bmap-tool to flash a device + bmaptool to flash a device with an image, see the - "Flashing Images Using bmap-tool" + "Flashing Images Using bmaptool" section. diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index bcee11ba22..fd7e03f1aa 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -328,29 +328,39 @@ -
- Flashing Images Using <filename>bmap-tool</filename> +
+ Flashing Images Using <filename>bmaptool</filename> An easy way to flash an image to a bootable device is to use - bmap-tool, which is integrated into the + bmaptool, 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 + You can use bmaptool to flash any type of image. Use these steps to flash an image using - bmap-tool: + 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 + + Add the following to your local.conf file: - IMAGE_FSTYPES += "WIC WIC.BMAP" + IMAGE_FSTYPES += "wic wic.bmap" @@ -361,33 +371,35 @@ - Flash the image to the media by using the - bmap-tool depending on your particular + Flash the image to the media by using + bmaptool depending on your particular setup: - If you have write access, use this command form: + If you have write access to the media, + use this command form: - $ oe-run-native bmap-tool copy ./tmp/deploy/images/qemux86-64/core-image-minimal-machine.wic /dev/sdX + $ oe-run-native bmaptool copy ./tmp/deploy/images/qemux86-64/core-image-minimal-machine.wic /dev/sdX - If you do not have write access, use the following + If you do not have write access to + the media, 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 + 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-tool + $ sudo apt-get install bmap-tools @@ -397,26 +409,11 @@ - For help on the bmaptool command, use - bmaptool --help: + For help on the bmaptool command, use either of + the following commands: $ 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 + $ oe-run-native bmaptool --help