tree: 8eca8b0fcc905646a30cabe6048f1bb86440412c [search]
  1. common/
  2. core/
  3. drivers-only/
  4. helpers/
  5. utils/
  6. wlancfg/
  7. wlanix/
  8. BUILD.gn
  9. README.md
src/connectivity/wlan/tests/README.md

Fuchsia WLAN Testing

Test SuiteScopeEnvironmentGuide
Crate Unit TestsAlgorithms, frame parsers, crypto handshakes, and state machines in lib/*, wlancfg, wlanix, wlandevicemonitorHost or hermetic component sandbox../lib/README.md
WLAN CoreCore stack components without policy layerHardware testbedcore/README.md
WLAN PolicyPolicy behaviors, auto-connect, network selection, roamingHardware testbedwlancfg/
WLANIXAndroid WiFi HAL implementation for StarnixHardware testbedwlanix/README.md
E2E AutomationExecuting and debugging test suitesLocal / remote testbedsE2E Skill

End-to-End Testing

WLAN end-to-end tests are host-driven Lacewing tests and require the device under test to be flashed with the corresponding testing product bundle (for-testing-wlan-core.<board>, for-testing-wlan-platform.<board>, or for-testing-wlan-wlanix.<board>).

For DUT-only tests, add the host test target and run it like any other Fuchsia test via fx test:

fx add-host-test //src/connectivity/wlan/tests/core:phy_existence_test
fx test --build --e2e --output //src/connectivity/wlan/tests/core:phy_existence_test

For tests that require an Access Point (reachable over SSH directly or via port forwarding), pass the Access Point SSH parameters after --:

fx add-host-test //src/connectivity/wlan/tests/core:connect_to_ap_test
fx test --build --e2e --output //src/connectivity/wlan/tests/core:connect_to_ap_test -- \
  --ap-ip <IP address> --ap-ssh-port <port>
  • Passing --ap-ip generates an OpenWrtAP controller configuration by default.
  • --ap-ssh-port defaults to 22 if omitted.
  • --ap-ssh-key <path> can be passed to specify a custom SSH private key for the Access Point (if omitted, mobly_driver searches ~/.ssh/openwrt_testing_rsa and ~/.ssh/testing_rsa).

Filtering Individual Test Cases

To run a subset of test cases within a test suite, pass --test_cases after --:

fx test --build --e2e --output //src/connectivity/wlan/tests/core:connect_to_ap_test -- \
  --ap-ip <IP address> --ap-ssh-port <port> \
  --test_cases 're:.*SecurityOpen.*'