Skip to content

Use · Service channels

Inspect service channels

Read published protobuf messages through a declared bridge subscription. The management console shows board status, resources, logs and activity; it does not render service-defined plots or forms. Use typed service commands for request/reply operations.

01 · Discover a published port

After deploying and registering a release, open ./micros shell -d NAME:

ports
read board.pin-monitor samples
follow board.pin-monitor samples --seconds 15

Use the actual service and port returned by ports. The package contains the published port's schema and its matching bridge subscription. No presentation metadata is required. Discovery comes from the exact confirmed release, not a local recipe or a stale observation.

02 · Capture bounded evidence

From the SDK checkout, with operator access already configured:

build/python/bin/python -m micros_tooling.diagnostics.collect \
  --device NAME --service board.pin-monitor --port samples \
  --seconds 15 --output build/capture.jsonl

Captures include device/base/graph identity, decoded messages, explicit gaps and an end record. Readers share one device drain with separate cursors. A boot or application change ends the capture. Lost samples and read errors must remain in any interpretation; a published message alone does not prove a physical effect.

03 · Current boundary

Remote capture currently requires an ESP32 base advertising ipc_stream: 1, a running publisher and bridge, and a registered release containing channel metadata. Other targets do not yet implement this management adapter. This is a current implementation gap, not the intended cross-platform feature contract.

Previously built releases need rebuilding and registration to expose the new channel metadata. Custom service-view metadata and endpoints are no longer supported. See Connect services for channel ownership and bindings.