From 761c6172f677fa851bd9c8645297b4ea99c2d8fb Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 11 Apr 2014 08:52:46 -0700 Subject: ref-manual, dev-manual: Edits to running tests on hardware Fixes [YOCTO #5554] Applied edits to the section in the dev-manual on running tests on hardware. Edited the TEST_TARGET and TEST_IMAGE variables. (From yocto-docs rev: a26ba11c739aabab4009a944d9b622e2814c7fca) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../dev-manual/dev-manual-common-tasks.xml | 80 +++++++++++++++------- 1 file changed, 56 insertions(+), 24 deletions(-) (limited to 'documentation/dev-manual') diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 63aba00abb..fa6e9cd9b8 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -5660,7 +5660,7 @@
- QEMU + Enabling Runtime Tests on QEMU In order to run tests, you need to do the following: @@ -5750,7 +5750,43 @@
- Hardware + Enabling Runtime Tests on Hardware + + + The OpenEmbedded build system can run tests on real + hardware, and for certain devices it can also deploy + the image to be tested onto the device beforehand. + + + + For automated deployment, a "master image" is installed + onto the hardware once as part of setup. + Then, each time tests are to be run, the following + occurs: + + The master image is booted into and + used to write the image to be tested to + a second partition. + + The device is then rebooted using an + external script that you need to provide. + + The device boots into the image to be + tested. + + + + + + When running tests (independent of whether the image + has been deployed automatically or not), the device is + expected to be connected to a network on a + pre-determined IP address. + You can either use static IP addresses written into + the image, or set the image to use DHCP and have your + DHCP server on the test network assign a known IP address + based on the MAC address of the device. + In order to run tests on hardware, you need to set @@ -5762,13 +5798,17 @@ "SimpleRemoteTarget": Choose "SimpleRemoteTarget" if you are going to - run tests on a target system that is already up and - running either on the network or as an image in - QEMU. + run tests on a target system that is already + running the image to be tested and is available + on the network. + You can use "SimpleRemoteTarget" in conjunction + with either real hardware or an image running + within a separately started QEMU or any + other virtual machine manager. "GummiBootTarget": Choose "GummiBootTarget" if your hardware is - a running EFI machine with + an EFI-based machine with gummiboot as bootloader and core-image-testmaster (or something similar) is installed. @@ -5781,8 +5821,8 @@ If you set TEST_TARGET to - "GummiBootTarget", you also need to - setup your master image by doing the following: + "GummiBootTarget", you also need to perform a one-time + setup of your master image by doing the following: Set EFI_PROVIDER: Be sure that EFI_PROVIDER @@ -5797,6 +5837,8 @@ Install image: Install the image on the target system. + <Need some clarification here from Stefan, + partition layout, etc.> @@ -5853,14 +5895,17 @@ You need to customize TEST_POWERCONTROL_CMD - and _ARGS for your own - setup. + and + TEST_POWERCONTROL_EXTRA_ARGS + for your own setup. The one requirement is that it accepts "on", "off", and "cycle" as the last argument. - When no command is defined, it uses classic reboot. + When no command is defined, it connects to the + device over SSH and uses the classic reboot command + to reboot the device. Classic reboot is fine as long as the machine actually reboots (i.e. the SSH test has not failed). @@ -5889,18 +5934,6 @@ Build Directory: TEST_IMAGE = "1" - - Next, also in the local.conf, set the - TEST_TARGET variable to - "simpleremote" if you want to run tests on real hardware or - set it to "qemu" if you want to run tests using QEMU. - file: - - TEST_TARGET = "simpleremote" - - or - - TEST_TARGET = "qemu" Next, build your image. If the image successfully builds, the tests will be @@ -6013,7 +6046,6 @@ Exporting tests is required if you want to be able to hand the test execution off to a scheduler. You can only export tests that are defined in - Tests exported are the ones defined in TEST_SUITES. -- cgit v1.2.3-54-g00ecf