diff options
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 22 | ||||
-rw-r--r-- | documentation/ref-manual/ref-variables.xml | 23 |
2 files changed, 17 insertions, 28 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index afda0a439d..4bb9d7113b 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
@@ -11400,8 +11400,8 @@ | |||
11400 | within a separately started QEMU or any | 11400 | within a separately started QEMU or any |
11401 | other virtual machine manager. | 11401 | other virtual machine manager. |
11402 | </para></listitem> | 11402 | </para></listitem> |
11403 | <listitem><para><emphasis>"Systemd-bootTarget":</emphasis> | 11403 | <listitem><para><emphasis>"SystemdbootTarget":</emphasis> |
11404 | Choose "Systemd-bootTarget" if your hardware is | 11404 | Choose "SystemdbootTarget" if your hardware is |
11405 | an EFI-based machine with | 11405 | an EFI-based machine with |
11406 | <filename>systemd-boot</filename> as bootloader and | 11406 | <filename>systemd-boot</filename> as bootloader and |
11407 | <filename>core-image-testmaster</filename> | 11407 | <filename>core-image-testmaster</filename> |
@@ -11409,10 +11409,10 @@ | |||
11409 | Also, your hardware under test must be in a | 11409 | Also, your hardware under test must be in a |
11410 | DHCP-enabled network that gives it the same IP | 11410 | DHCP-enabled network that gives it the same IP |
11411 | address for each reboot.</para> | 11411 | address for each reboot.</para> |
11412 | <para>If you choose "Systemd-bootTarget", there are | 11412 | <para>If you choose "SystemdbootTarget", there are |
11413 | additional requirements and considerations. | 11413 | additional requirements and considerations. |
11414 | See the | 11414 | See the |
11415 | "<link linkend='selecting-systemd-boottarget'>Selecting Systemd-bootTarget</link>" | 11415 | "<link linkend='selecting-systemdboottarget'>Selecting SystemdbootTarget</link>" |
11416 | section, which follows, for more information. | 11416 | section, which follows, for more information. |
11417 | </para></listitem> | 11417 | </para></listitem> |
11418 | <listitem><para><emphasis>"BeagleBoneTarget":</emphasis> | 11418 | <listitem><para><emphasis>"BeagleBoneTarget":</emphasis> |
@@ -11458,12 +11458,12 @@ | |||
11458 | </para> | 11458 | </para> |
11459 | </section> | 11459 | </section> |
11460 | 11460 | ||
11461 | <section id='selecting-systemd-boottarget'> | 11461 | <section id='selecting-systemdboottarget'> |
11462 | <title>Selecting Systemd-bootTarget</title> | 11462 | <title>Selecting SystemdbootTarget</title> |
11463 | 11463 | ||
11464 | <para> | 11464 | <para> |
11465 | If you did not set <filename>TEST_TARGET</filename> to | 11465 | If you did not set <filename>TEST_TARGET</filename> to |
11466 | "Systemd-bootTarget", then you do not need any information | 11466 | "SystemdbootTarget", then you do not need any information |
11467 | in this section. | 11467 | in this section. |
11468 | You can skip down to the | 11468 | You can skip down to the |
11469 | "<link linkend='qemu-image-running-tests'>Running Tests</link>" | 11469 | "<link linkend='qemu-image-running-tests'>Running Tests</link>" |
@@ -11472,7 +11472,7 @@ | |||
11472 | 11472 | ||
11473 | <para> | 11473 | <para> |
11474 | If you did set <filename>TEST_TARGET</filename> to | 11474 | If you did set <filename>TEST_TARGET</filename> to |
11475 | "Systemd-bootTarget", you also need to perform a one-time | 11475 | "SystemdbootTarget", you also need to perform a one-time |
11476 | setup of your master image by doing the following: | 11476 | setup of your master image by doing the following: |
11477 | <orderedlist> | 11477 | <orderedlist> |
11478 | <listitem><para><emphasis>Set <filename>EFI_PROVIDER</filename>:</emphasis> | 11478 | <listitem><para><emphasis>Set <filename>EFI_PROVIDER</filename>:</emphasis> |
@@ -11543,7 +11543,7 @@ | |||
11543 | 11543 | ||
11544 | <para> | 11544 | <para> |
11545 | The final thing you need to do when setting | 11545 | The final thing you need to do when setting |
11546 | <filename>TEST_TARGET</filename> to "Systemd-bootTarget" is | 11546 | <filename>TEST_TARGET</filename> to "SystemdbootTarget" is |
11547 | to set up the test image: | 11547 | to set up the test image: |
11548 | <orderedlist> | 11548 | <orderedlist> |
11549 | <listitem><para><emphasis>Set up your <filename>local.conf</filename> file:</emphasis> | 11549 | <listitem><para><emphasis>Set up your <filename>local.conf</filename> file:</emphasis> |
@@ -11552,7 +11552,7 @@ | |||
11552 | <literallayout class='monospaced'> | 11552 | <literallayout class='monospaced'> |
11553 | IMAGE_FSTYPES += "tar.gz" | 11553 | IMAGE_FSTYPES += "tar.gz" |
11554 | INHERIT += "testimage" | 11554 | INHERIT += "testimage" |
11555 | TEST_TARGET = "Systemd-bootTarget" | 11555 | TEST_TARGET = "SystemdbootTarget" |
11556 | TEST_TARGET_IP = "192.168.2.3" | 11556 | TEST_TARGET_IP = "192.168.2.3" |
11557 | </literallayout> | 11557 | </literallayout> |
11558 | </para></listitem> | 11558 | </para></listitem> |
@@ -11969,7 +11969,7 @@ | |||
11969 | The target controller object used to deploy | 11969 | The target controller object used to deploy |
11970 | and start an image on a particular target | 11970 | and start an image on a particular target |
11971 | (e.g. QemuTarget, SimpleRemote, and | 11971 | (e.g. QemuTarget, SimpleRemote, and |
11972 | Systemd-bootTarget). | 11972 | SystemdbootTarget). |
11973 | Tests usually use the following: | 11973 | Tests usually use the following: |
11974 | <itemizedlist> | 11974 | <itemizedlist> |
11975 | <listitem><para><emphasis><filename>ip</filename>:</emphasis> | 11975 | <listitem><para><emphasis><filename>ip</filename>:</emphasis> |
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 346090f0d4..206a77012d 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml | |||
@@ -15285,9 +15285,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
15285 | <!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> | 15285 | <!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> |
15286 | Specifies the target controller to use when running tests | 15286 | Specifies the target controller to use when running tests |
15287 | against a test image. | 15287 | against a test image. |
15288 | The default controller to use is "qemu": | 15288 | The default controller to use is "QemuTarget": |
15289 | <literallayout class='monospaced'> | 15289 | <literallayout class='monospaced'> |
15290 | TEST_TARGET = "qemu" | 15290 | TEST_TARGET = "QemuTarget" |
15291 | </literallayout> | 15291 | </literallayout> |
15292 | </para> | 15292 | </para> |
15293 | 15293 | ||
@@ -15306,35 +15306,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
15306 | You can provide the following arguments with | 15306 | You can provide the following arguments with |
15307 | <filename>TEST_TARGET</filename>: | 15307 | <filename>TEST_TARGET</filename>: |
15308 | <itemizedlist> | 15308 | <itemizedlist> |
15309 | <listitem><para><emphasis>"qemu" and "QemuTarget":</emphasis> | 15309 | <listitem><para><emphasis>"QemuTarget":</emphasis> |
15310 | Boots a QEMU image and runs the tests. | 15310 | Boots a QEMU image and runs the tests. |
15311 | See the | 15311 | See the |
15312 | "<ulink url='&YOCTO_DOCS_DEV_URL;#qemu-image-enabling-tests'>Enabling Runtime Tests on QEMU</ulink>" | 15312 | "<ulink url='&YOCTO_DOCS_DEV_URL;#qemu-image-enabling-tests'>Enabling Runtime Tests on QEMU</ulink>" |
15313 | section in the Yocto Project Development Tasks | 15313 | section in the Yocto Project Development Tasks |
15314 | Manual for more information. | 15314 | Manual for more information. |
15315 | </para></listitem> | 15315 | </para></listitem> |
15316 | <listitem><para><emphasis>"simpleremote" and "SimpleRemoteTarget":</emphasis> | 15316 | <listitem><para><emphasis>"SimpleRemoteTarget":</emphasis> |
15317 | Runs the tests on target hardware that is already | 15317 | Runs the tests on target hardware that is already |
15318 | up and running. | 15318 | up and running. |
15319 | The hardware can be on the network or it can be | 15319 | The hardware can be on the network or it can be |
15320 | a device running an image on QEMU. | 15320 | a device running an image on QEMU. |
15321 | You must also set | 15321 | You must also set |
15322 | <link linkend='var-TEST_TARGET_IP'><filename>TEST_TARGET_IP</filename></link> | 15322 | <link linkend='var-TEST_TARGET_IP'><filename>TEST_TARGET_IP</filename></link> |
15323 | when you use "simpleremote" or "SimpleRemoteTarget". | 15323 | when you use "SimpleRemoteTarget". |
15324 | <note> | 15324 | <note> |
15325 | This argument is defined in | 15325 | This argument is defined in |
15326 | <filename>meta/lib/oeqa/targetcontrol.py</filename>. | 15326 | <filename>meta/lib/oeqa/controllers/simpleremote.py</filename>. |
15327 | The small caps names are kept for compatibility | ||
15328 | reasons. | ||
15329 | </note> | ||
15330 | </para></listitem> | ||
15331 | <listitem><para><emphasis>"GummibootTarget":</emphasis> | ||
15332 | Automatically deploys and runs tests on an | ||
15333 | EFI-enabled machine that has a master image | ||
15334 | installed. | ||
15335 | <note> | ||
15336 | This argument is defined in | ||
15337 | <filename>meta/lib/oeqa/controllers/masterimage.py</filename>. | ||
15338 | </note> | 15327 | </note> |
15339 | </para></listitem> | 15328 | </para></listitem> |
15340 | </itemizedlist> | 15329 | </itemizedlist> |