summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/ref-variables.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/ref-variables.xml')
-rw-r--r--documentation/ref-manual/ref-variables.xml65
1 files changed, 65 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 03d2034dba..b41d08d21a 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7484,6 +7484,71 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7484 </glossdef> 7484 </glossdef>
7485 </glossentry> 7485 </glossentry>
7486 7486
7487 <glossentry id='var-TEST_TARGET'><glossterm>TEST_TARGET</glossterm>
7488 <glossdef>
7489 <para>
7490 Specifies the target controller to use when running tests
7491 against a test image.
7492 The default controller to use is "qemu":
7493 <literallayout class='monospaced'>
7494 TEST_TARGET = "qemu"
7495 </literallayout>
7496 A target controller is a class that defines how an
7497 image gets deployed on a target and how a target is started.
7498 A layer can extend the controllers by adding a module
7499 in the layer's <filename>/lib/oeqa/controllers</filename>
7500 directory and by inheriting the
7501 <filename>BaseTarget</filename> class, which is an abstract
7502 class that cannot be used as a value of
7503 <filename>TEST_TARGET</filename>.
7504 </para>
7505
7506 <para>
7507 You can provide the following arguments with
7508 <filename>TEST_TARGET</filename>:
7509 <itemizedlist>
7510 <listitem><para><emphasis>"qemu":</emphasis>
7511 Boots a QEMU image and runs the tests.
7512 See the
7513 "<ulink url='&YOCTO_DOCS_DEV_URL;#qemu-image-enabling-tests'>QEMU</ulink>"
7514 section in the Yocto Project Development Manual for
7515 more information.
7516 </para></listitem>
7517 <listitem><para><emphasis>"QemuTarget":</emphasis>
7518 Identical to "qemu".
7519 </para></listitem>
7520 <listitem><para><emphasis>"simpleremote":</emphasis>
7521 Runs the tests on target hardware that is already
7522 up and running.
7523 The hardware can be on the network or it can be
7524 a device running an image on QEMU.
7525 You must also set
7526 <link linkend='var-TEST_TARGET_IP'><filename>TEST_TARGET_IP</filename></link>
7527 when you use "simpleremote".
7528 <note>
7529 This argument is defined in
7530 <filename>meta/lib/oeqa/targetcontrol.py</filename>.
7531 The small caps names are kept for compatibility
7532 reasons.
7533 </note>
7534 </para></listitem>
7535 <listitem><para><emphasis>"SimpleRemoteTarget":</emphasis>
7536 Identical to "simpleremote".
7537 </para></listitem>
7538 <listitem><para><emphasis>"GummibootTarget":</emphasis>
7539 Automatically deploys and runs tests on an
7540 EFI-enabled machine that has a master image
7541 installed.
7542 <note>
7543 This argument is defined in
7544 <filename>meta/lib/oeqa/controllers/masterimage.py</filename>.
7545 </note>
7546 </para></listitem>
7547 </itemizedlist>
7548 </para>
7549 </glossdef>
7550 </glossentry>
7551
7487 <glossentry id='var-TEST_SUITES'><glossterm>TEST_SUITES</glossterm> 7552 <glossentry id='var-TEST_SUITES'><glossterm>TEST_SUITES</glossterm>
7488 <glossdef> 7553 <glossdef>
7489 <para> 7554 <para>