testing-debugging.md

Testing and Debugging

CrossPoint runs on real hardware, so debugging usually combines local build checks and on-device logs.

Local checks

Make sure clang-format 21+ is installed and available in PATH before running the formatting step. If needed, see Getting Started.

./bin/clang-format-fix
pio check --fail-on-defect low --fail-on-defect medium --fail-on-defect high
pio run

Flash and monitor

Flash firmware:

pio run --target upload

Open serial monitor:

pio device monitor

Optional enhanced monitor:

python3 -m pip install pyserial colorama matplotlib
python3 scripts/debugging_monitor.py

Useful bug report contents

• Firmware version and build environment
• Exact steps to reproduce
• Expected vs actual behavior
• Serial logs from boot through failure
• Whether issue reproduces after clearing .crosspoint/ cache on SD card

Common troubleshooting references

• User Guide troubleshooting section
• Webserver troubleshooting