Registration Over Wire#

Registration over wire (ROW) is a factory workflow in which an Amazon manufacturing tool provisions a Sidewalk device and completes its registration through a wired connection. In the current workflow, the tool can run provisioning and registration together. Unlike the usual on-device certificate-generation flow, the factory computer must have network access because the tool also creates the cloud device record and exchanges registration messages with Amazon Sidewalk services.

The Silicon Labs ROW application implements the device-side APIs used by Amazon's tool and connects the tool's registration handshake to the provisioning flow without Secure Vault integration.

Factory sequence#

The ROW application is too large to run from RAM. The factory sequence therefore uses flash temporarily:

  1. Build ROW application and flash the image to the device.

  2. Connect the device to a factory computer using UART or RTT.

  3. Configure the Amazon manufacturing tool with the product identity, HSM and signing settings, credentials, and audit log location.

  4. Run the tool to provision the device and register it over wire. This process creates or updates the cloud device record and completes the register handshake.

  5. Erase the temporary ROW image and flash the product application. The production device does not run ROW as its end application.

This is a two-image process: ROW must be flashed and run first, then erased and replaced with the end application. Plan the extra flash and erase operations into the line process. The factory computer must remain online while running the Amazon tool.

Amazon manufacturing tool#

The binary identifies itself as sid-mfg-tool. Its top-level commands include configure and device onboard. The exact tool and supported command options may change between releases; use --help with the binary distributed for your manufacturing release.

Configure the tool#

Run the interactive setup once for the factory environment:

./sid-mfg-tool configure

The tool's setup covers product identity, credentials, HSM settings, and audit log configuration. The CLI help says these settings are used from config.toml and secrets.toml. Protect those files as production secrets. Use configure --show to review current settings with secrets masked.

See the readme provided by Amazon for the configuration parameters.

Provision and register one device#

For a single command that performs onboarding end to end, use device onboard:

./sid-mfg-tool device onboard \
  --transport uart \
  --address /dev/ttyUSB0 \
  --dsn <unique-device-serial-number>

For RTT, set --transport rtt and pass the J-Link probe serial number as --address:

./sid-mfg-tool device onboard \
  --transport rtt \
  --address <jlink-probe-serial-number> \
  --dsn <unique-device-serial-number>

The CLI defaults to the transport set during configuration, or UART if none is configured. Flags: --address and --dsn are required for device onboard. The Device Serial Number (DSN) must be unique for each run.