Google Git
Sign in
fuchsia / fuchsia / refs/heads/releases/canary / . / src / developer / ffx / tests / target
tree: 18fcbc4b36d581cccdd0b5c0b3e48ca839fa057e [path history] [tgz]
  1. src/
  2. BUILD.gn
  3. README.md
src/developer/ffx/tests/target/README.md

ffx_target_test

This directory contains self-contained & hermetic e2e tests for targets running in emulators. Most importantly it offers coverage of ffx target flash to catch flashing issues early.

These tests rely on various components from build outputs:

  • Gigaboot (UEFI Bootloader & Fastboot Implementation)
  • Zircon
  • SSH & Overnet support (nominally core.x64 build flavor)

Running Locally

There are not many requirements to run this test locally.

  • Build architecture is x64 and includes SSH and overnet (e.g. fx set core.x64)
    • core.x64 on emulators is known not to work with this test as it does not support flashing
  • ffx host tests are included in the build (fx set <...> --with //src/developer/ffx:tests)
  • TAP/TUN is configured correctly and a running emulator is not using it
    • sudo ip tuntap add dev qemu mode tap user $USER && sudo ip link set qemu up

After ensuring all requirements are met, run fx test ffx_target_test.

Debugging

To run a system image in QEMU with flashing support:

Build a disk image using make-fuchsia-vol, then rename the EFI partition to fuchsia-esp.

DISK=$FUCHSIA_DIR/out/disk.img
# Create 25GB disk image if it doesn't already exist:
[[ -e $DISK ]] || truncate -s 25G $DISK
# NOTE: If using core.x64-fxfs add --use-fxfs
$FUCHSIA_DIR/out/default/host_x64/make-fuchsia-vol --fuchsia-build-dir $FUCHSIA_DIR/out/default --bootloader $FUCHSIA_DIR/out/default/kernel.efi_x64/fuchsia-efi.efi $DISK
CGPT=$FUCHSIA_DIR/prebuilt/tools/cgpt/linux-x64/cgpt
# Normalize partition names
$CGPT add -i `$CGPT find -t efi -n $DISK` -l fuchsia-esp $DISK
$CGPT add -i `$CGPT find -t DE30CC86-1F4A-4A31-93C4-66F147D33E05 -n $DISK` -l zircon-a $DISK
$CGPT add -i `$CGPT find -t 23CC04DF-C278-4CE7-8471-897D1A4BCDF7 -n $DISK` -l zircon-b $DISK
$CGPT add -i `$CGPT find -t A0E5CF57-2DEF-46BE-A80C-A2067C37CD49 -n $DISK` -l zircon-r $DISK

Then use fx qemu to start the emulator using the disk:

fx qemu -a x64 -N --uefi --disktype=nvme --no-build -D $DISK

In the bootloader, press f at the prompt to interrupt auto-boot and instead enable fastboot.

Once fastboot is enabled it'll show up in ffx.

For example, flash a product bundle:

# List targets to find the serial.
# Usually fuchsia-5254-0063-5e7a, but change it in subsequent commands.
ffx target list
ffx --target fuchsia-5254-0063-5e7a target flash -b $FUCHSIA_DIR/out/default/obj/build/images/fuchsia/product_bundle/

To kill the emulator (if not able to gracefully shutdown via ffx target off):

pkill -HUP qemu

Infra Diagnosis

Other than stdout and stderr the task outputs contain three important log files: ffx.log, ffx.daemon.log, and emulator.serial.log

Issues typically happen between host & target. Check emulator.serial.log first.