|
@@ -1,13 +1,13 @@
|
|
|
.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
|
|
|
|
|
|
-Flashing Images Using ``bmaptool``
|
|
|
-**********************************
|
|
|
+Flashing Images Using `bmaptool`
|
|
|
+********************************
|
|
|
|
|
|
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
|
|
|
+`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
|
|
|
+such as `dd` or `cp`, `bmaptool` can copy (or flash) large files like raw
|
|
|
system image files much faster.
|
|
|
|
|
|
.. note::
|
|
@@ -20,13 +20,13 @@ system image files much faster.
|
|
|
$ sudo apt 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::
|
|
|
+ need to build `bmaptool` before using it. Use the following command::
|
|
|
|
|
|
$ bitbake bmaptool-native
|
|
|
|
|
|
Following, is an example that shows how to flash a Wic image. 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:
|
|
|
+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 your local.conf File:* You need to have the following set
|
|
|
in your ``local.conf`` file before building your image::
|
|
@@ -39,7 +39,7 @@ any type of image. Use these steps to flash an image using bmaptool:
|
|
|
|
|
|
$ bitbake image
|
|
|
|
|
|
-#. *Flash the Device:* Flash the device with the image by using bmaptool
|
|
|
+#. *Flash the Device:* Flash the device with the image by using `bmaptool`
|
|
|
depending on your particular setup. The following commands assume the
|
|
|
image resides in the :term:`Build Directory`'s ``deploy/images/`` area:
|
|
|
|