diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2017-06-28 10:16:07 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2017-07-12 00:28:14 +0100 |
commit | d552379be3b0240866d1a7d6fe206c0d93aeb43b (patch) | |
tree | a874e83a0df4ccf3d44252621322ca3f1676a58f /documentation/dev-manual/dev-manual-start.xml | |
parent | 15a41d25e961b4e4becc549cbbb25573c51cadfa (diff) | |
download | poky-d552379be3b0240866d1a7d6fe206c0d93aeb43b.tar.gz |
dev-manual: Moved the "Flashing Images using bmaptool" section.
Fixes [YOCTO #11630]
Moved this section from the "Getting Started with the Yocto
Project" section. The topic is not really a getting started
topic. It is better suited in the "Common Tasks" chapter.
(From yocto-docs rev: d6cdade9066bdbce0596672978c178d2ec82c9a4)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual/dev-manual-start.xml')
-rw-r--r-- | documentation/dev-manual/dev-manual-start.xml | 89 |
1 files changed, 0 insertions, 89 deletions
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 459254c078..1155d8fc85 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml | |||
@@ -789,95 +789,6 @@ | |||
789 | </para> | 789 | </para> |
790 | </section> | 790 | </section> |
791 | 791 | ||
792 | <section id='flashing-images-using-bmaptool'> | ||
793 | <title>Flashing Images Using <filename>bmaptool</filename></title> | ||
794 | |||
795 | <para> | ||
796 | An easy way to flash an image to a bootable device is to use | ||
797 | <filename>bmaptool</filename>, which is integrated into the | ||
798 | OpenEmbedded build system. | ||
799 | </para> | ||
800 | |||
801 | <para> | ||
802 | Following, is an example that shows how to flash a Wic image. | ||
803 | <note> | ||
804 | You can use <filename>bmaptool</filename> to flash any | ||
805 | type of image. | ||
806 | </note> | ||
807 | Use these steps to flash an image using | ||
808 | <filename>bmaptool</filename>: | ||
809 | <note> | ||
810 | Unless you are able to install the | ||
811 | <filename>bmap-tools</filename> package as mentioned in the note | ||
812 | in the second bullet of step 3 further down, you will need to build | ||
813 | <filename>bmaptool</filename> before using it. | ||
814 | Build the tool using the following command: | ||
815 | <literallayout class='monospaced'> | ||
816 | $ bitbake bmap-tools-native | ||
817 | </literallayout> | ||
818 | </note> | ||
819 | <orderedlist> | ||
820 | <listitem><para> | ||
821 | Add the following to your <filename>local.conf</filename> | ||
822 | file: | ||
823 | <literallayout class='monospaced'> | ||
824 | IMAGE_FSTYPES += "wic wic.bmap" | ||
825 | </literallayout> | ||
826 | </para></listitem> | ||
827 | <listitem><para> | ||
828 | Either have your image ready (pre-built) or take the step | ||
829 | build the image: | ||
830 | <literallayout class='monospaced'> | ||
831 | $ bitbake <replaceable>image</replaceable> | ||
832 | </literallayout> | ||
833 | </para></listitem> | ||
834 | <listitem><para> | ||
835 | Flash the image to the media by using | ||
836 | <filename>bmaptool</filename> depending on your particular | ||
837 | setup: | ||
838 | <itemizedlist> | ||
839 | <listitem><para> | ||
840 | If you have write access to the media, | ||
841 | use this command form: | ||
842 | <literallayout class='monospaced'> | ||
843 | $ oe-run-native bmaptool-native bmaptool copy ./tmp/deploy/images/qemux86-64-core-image-minimal-<replaceable>machine</replaceable>.wic /dev/sd<replaceable>X</replaceable> | ||
844 | </literallayout> | ||
845 | </para></listitem> | ||
846 | <listitem><para> | ||
847 | If you do not have write access to | ||
848 | the media, use the following | ||
849 | commands: | ||
850 | <literallayout class='monospaced'> | ||
851 | $ sudo bash | ||
852 | $ PATH=tmp/sysroots/x86_64-linux/usr/bin/ bmaptool copy ./tmp/deploy/images/qemux86-64/core-image-minimal-<replaceable>machine</replaceable>.wic /dev/sd<replaceable>X</replaceable> | ||
853 | </literallayout> | ||
854 | <note> | ||
855 | If you are using Ubuntu or Debian distributions, | ||
856 | you can install the | ||
857 | <filename>bmap-tools</filename> package using the | ||
858 | following command and then use the tool | ||
859 | without specifying | ||
860 | <filename>PATH</filename> even from the | ||
861 | root account: | ||
862 | <literallayout class='monospaced'> | ||
863 | $ sudo apt-get install bmap-tools | ||
864 | </literallayout> | ||
865 | </note> | ||
866 | </para></listitem> | ||
867 | </itemizedlist> | ||
868 | </para></listitem> | ||
869 | </orderedlist> | ||
870 | </para> | ||
871 | |||
872 | <para> | ||
873 | For help on the <filename>bmaptool</filename> command, use the | ||
874 | following command: | ||
875 | <literallayout class='monospaced'> | ||
876 | $ bmaptool --help | ||
877 | </literallayout> | ||
878 | </para> | ||
879 | </section> | ||
880 | |||
881 | <section id='using-pre-built-binaries-and-qemu'> | 792 | <section id='using-pre-built-binaries-and-qemu'> |
882 | <title>Using Pre-Built Binaries and QEMU</title> | 793 | <title>Using Pre-Built Binaries and QEMU</title> |
883 | 794 | ||