prplos/.gitlab/scripts
Petr Štetiar accd15a3eb ci: testbed,cdrouter: add opt-in obuspa debug logging
Currently the testbed and cdrouter jobs need an opt-in way to raise
OBUSPA logging when debugging intermittent USP and MTP issues such as
PPW-1897, PPW-1837 and PCF-2565. The normal CI path should keep the DUT
at firmware defaults and avoid editing /etc/init.d/obuspa unless a debug
run asks for extra logging.

So lets add DUT_OBUSPA_VERBOSE_LEVEL and DUT_OBUSPA_PROTOCOL_TRACE as
empty-by-default CI variables. The CI templates call the OBUSPA debug
helper only when either variable is non-empty, so normal runs leave the
DUT unchanged.

DUT_OBUSPA_VERBOSE_LEVEL configures runtime verbosity and the persisted
-v init-script argument. DUT_OBUSPA_PROTOCOL_TRACE configures runtime
prototrace and the persisted -p init-script argument for later OBUSPA
restarts. Invalid values fail before SSH so typoed CI variables do not
partially mutate the DUT.

DUT_OBUSPA_VERBOSE_LEVEL=3 enables the info-level OBUSPA logging useful
for USP controller and MTP debugging. DUT_OBUSPA_PROTOCOL_TRACE=1
enables protocol-level tracing when the CI run needs message-level
visibility.

Assisted-by: codex:gpt-5.5:xhigh
References: PPW-1897, PPW-1837, PCF-2565
Signed-off-by: Petr Štetiar <petr.stetiar@prplfoundation.org>
2026-05-22 13:33:05 +00:00
..
build.d ci: build: enable exception tracing on arm64 targets 2025-07-31 10:36:01 +00:00
dut-init ci: testbed,cdrouter: add opt-in obuspa debug logging 2026-05-22 13:33:05 +00:00
prplMesh scripts: prplmesh: bump easymesh certification test revision 2026-03-06 15:31:11 +01:00
cdrouter-package-convert.py ci: scripts: add CDRouter .gz to YAML package converter 2026-04-21 16:00:15 +01:00
cdrouter-pretty-failures.awk
helpers.sh ci: testbed,cdrouter: improve error visibility with colored logging 2025-11-07 06:00:20 +00:00
prpl-jira.py
README.md
requirements.txt
testbed-cdrouter.py ci: cdrouter: validate package manifests before DUT bringup 2026-04-21 16:00:15 +01:00
testbed-device.py ci: testbed: fix UnicodeDecodeError in console log dump 2026-04-21 16:00:15 +01:00

Content

This directory contains files used mainly during testing on the GitLab CI.

requirements.txt

This requirements.txt file is used for specifying what Python packages are required to run the scripts in this directory. Usually used with pip install -f requirements.txt command.

prpl-jira.py

This helper Python script creates new or updates existing Jira ticket when something goes wrong during GitLab CI testing process. Currently only supports reporting of build test failures.

Needs Python version 3.6+ due to use of f-strings feature.

testbed-device.py

This helper Python scripts allows managing of device under test (DUT) via labgrid framework.