Devices Under Test

The DUTs are the targets of this project. The hardware on which we want to test to verify its functionality.

Currently the complete integration with the phone-harness and CI-tron has been tested with the following devices:

Other devices might or might not work, and might require adding support to different parts of the stack.

Adding a new device

Warning

Follow these steps at your own risk. Some of these steps require you to do things like soldering and interacting with low-level software. The device can easily become bricked.

Install platform firmware

For phone DUTs, it is necessary to install Tauchgang as platform firmware. Unfortunately, until it is possible to manually configure it to boot to fastboot, you will have build tauchgang yourself with the following diff:

diff --git i/board/qualcomm/qcom-phone.env w/board/qualcomm/qcom-phone.env
index fac2ddde758..a6be687027d 100644
--- i/board/qualcomm/qcom-phone.env
+++ w/board/qualcomm/qcom-phone.env
@@ -17,7 +17,7 @@ serial_gadget=setenv stdin serial,button-kbd,usbacm; setenv
stdout serial,vidcon
# bootretry will run this command over and over, if we fail once
# then bail out to the boot menu instead (with a pause to read
# the error message)
-bootcmd=bootefi bootmgr; pause; run menucmd
+bootcmd=run fastboot

# When entering the menu (either from button press or failed boot)
# remap bootcmd so it will re-open the menu and we won't get stuck

Alternatively, builds for the Pixel 3a and OnePlus 6 and 6T are available in postmarketOS nextcloud (select the images with the -fastboot suffix).

Preparing a phone harness for your device

Once your device has the necessary software, you need to get it ready to be controlled by our PDU. For that, follow the instruction in the phone-harness docs.

After that is ready, you can come back and continue reading.

Test phone harness integration

From your laptop connect to the harness through serial. Test:

  • Powering on and off the device using the POWER ON and POWER OFF controls.

  • Getting U-boot logs through the harness

  • After booting the device with the harness, a new USB device should appear in your computer. Check that fastboot devices detects a fastboot device.

  • Test if booting some kernel with fastboot boot works.