You are using staging server - a separate instance of the ESP Component Registry that allows you to try distribution tools and processes without affecting the real registry.
<!--
Copyright 2026 Morse Micro
SPDX-License-Identifier: Apache-2.0
-->
# porting_assistant
Self-test tool for bringing up a new platform. Runs a sequence of OSAL, HAL and
hardware tests (memory, timing, task creation, SDIO/SPI bus, chip ID, firmware/BCF
validation, throughput, BUSY pin) and reports the result of each. A known-good
platform should pass every step.
---
## Building
Set the target, layering in the board profile for your board/hat, then configure and
build. See [configs](../../configs/README.md) for the full `SDKCONFIG_DEFAULTS` usage.
Setting the Wi-Fi HaLow country code is required — in `menuconfig` it is under
`Wi-Fi HaLow Connection Manager → Country code to use for Wi-Fi HaLow`
(`CONFIG_HALOW_COUNTRY_CODE`).
For example, for a Seeed Studio XIAO ESP32-S3 paired with a XIAO Wi-Fi HaLow
(MM6108) hat:
SDKCONFIG_DEFAULTS="sdkconfig.defaults;managed_components/morsemicro__halow/configs/sdkconfig.defaults.seeed_xiao_esp32s3-seeed_xiao_mm6108" \
idf.py set-target esp32s3
idf.py menuconfig build # set the country code (required)
## Running
Flash and open the serial monitor to watch each test step and its result:
idf.py flash monitor
To create a project from this example, run:
idf.py create-project-from-example "morsemicro/halow=2.11.2-esp32-1.1:porting_assistant"