summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml74
1 files changed, 69 insertions, 5 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 08237ea9ac..01cfd92222 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -5801,13 +5801,31 @@
5801 (or something similar) is installed. 5801 (or something similar) is installed.
5802 Also, your hardware under test must be in a 5802 Also, your hardware under test must be in a
5803 DHCP-enabled network that gives it the same IP 5803 DHCP-enabled network that gives it the same IP
5804 address for each reboot. 5804 address for each reboot.</para>
5805 <para>If you choose "GummibootTarget", there are
5806 additional requirements and considerations.
5807 See the
5808 "<link linkend='selecting-gummiboottarget'>Selecting GummibootTarget</link>"
5809 section, which follows, for more information.
5805 </para></listitem> 5810 </para></listitem>
5806 </itemizedlist> 5811 </itemizedlist>
5807 </para> 5812 </para>
5813 </section>
5814
5815 <section id='selecting-gummiboottarget'>
5816 <title>Selecting GummibootTarget</title>
5817
5818 <para>
5819 If you did not set <filename>TEST_TARGET</filename> to
5820 "GummibootTarget", then you do not need any information
5821 in this section.
5822 You can skip down to the
5823 "<link linkend='qemu-image-running-tests'>Running Tests</link>"
5824 section.
5825 </para>
5808 5826
5809 <para> 5827 <para>
5810 If you set <filename>TEST_TARGET</filename> to 5828 If you did set <filename>TEST_TARGET</filename> to
5811 "GummibootTarget", you also need to perform a one-time 5829 "GummibootTarget", you also need to perform a one-time
5812 setup of your master image by doing the following: 5830 setup of your master image by doing the following:
5813 <orderedlist> 5831 <orderedlist>
@@ -5821,11 +5839,57 @@
5821 <listitem><para><emphasis>Build the master image:</emphasis> 5839 <listitem><para><emphasis>Build the master image:</emphasis>
5822 Build the <filename>core-image-testmaster</filename> 5840 Build the <filename>core-image-testmaster</filename>
5823 image. 5841 image.
5842 The <filename>core-image-testmaster</filename>
5843 recipe is provided as an example for a
5844 "master" image and you can customize the image
5845 recipe as you would any other recipe.
5846 </para>
5847 <para>Here are the image recipe requirements:
5848 <itemizedlist>
5849 <listitem><para>Inherits
5850 <filename>core-image</filename>
5851 so that kernel modules are installed.
5852 </para></listitem>
5853 <listitem><para>Installs normal linux utilities
5854 not busybox ones (e.g.
5855 <filename>bash</filename>,
5856 <filename>coreutils</filename>,
5857 <filename>tar</filename>,
5858 <filename>gzip</filename>, and
5859 <filename>kmod</filename>).
5860 </para></listitem>
5861 <listitem><para>Uses a custom
5862 initramfs image with a custom installer.
5863 A normal image that you can install usually
5864 creates a single rootfs partition.
5865 This image uses another installer that
5866 creates a specific partition layout.
5867 Not all Board Support Packages (BSPs)
5868 can use an installer.
5869 For such cases, you need to manually create
5870 the following partition layout on the
5871 target:
5872 <itemizedlist>
5873 <listitem><para>First partition mounted
5874 under <filename>/boot</filename>,
5875 labeled "boot".
5876 </para></listitem>
5877 <listitem><para>The main rootfs
5878 partition where this image gets
5879 installed, which is mounted under
5880 <filename>/</filename>.
5881 </para></listitem>
5882 <listitem><para>Another partition
5883 labeled "testrootfs" where test
5884 images get deployed.
5885 </para></listitem>
5886 </itemizedlist>
5887 </para></listitem>
5888 </itemizedlist>
5824 </para></listitem> 5889 </para></listitem>
5825 <listitem><para><emphasis>Install image:</emphasis> 5890 <listitem><para><emphasis>Install image:</emphasis>
5826 Install the image on the target system. 5891 Install the image that you just built on the target
5827 &lt;Need some clarification here from Stefan, 5892 system.
5828 partition layout, etc.&gt;
5829 </para></listitem> 5893 </para></listitem>
5830 </orderedlist> 5894 </orderedlist>
5831 </para> 5895 </para>