Args:
    unique_id: Whole or partial probe serial/unique ID to select a specific
        probe. Omit when exactly one probe is attached. Defaults to the
        ``PYOCD_PROBE_UID`` environment variable if unset.
    target: Target type override, e.g. "stm32f407vg" or "nrf52833". Takes
        precedence over a board config. Omit to use the selected board's
        target (when ``board_id`` is given), else the ``PYOCD_TARGET``
        environment variable, else pyOCD auto-detection.
    board_id: Load facts from ``boards/<board_id>.yaml`` through the shared
        board-config loader — pyOCD target, recover policy, silicon id, baud.
        Lets a custom ST/nRF board connect by id with no hand-passed target;
        call ``get_board_info`` to see the loaded facts. Defaults to the
        ``PYOCD_BOARD_ID`` environment variable.
    board_config: Path to an extra board-config file outside the tracked
        ``boards/`` directory, for a custom board. Defaults to the
        ``PYOCD_BOARD_CONFIG`` environment variable.

Reports the ``boards/<board>.yaml`` definition active for this session —
pyOCD target, MCU and probe family, recover policy, silicon-id expectation,
default UART baud, and the smoke-test read address. Returns a notice when
``connect`` was called without a ``board_id`` (raw-target mode), where these
facts were not loaded.

Args:
    halt_after: If True, halt at the reset vector (reset-and-halt).
        If False, reset and let the target run.

Args:
    address: Memory address, hex (0x...) or decimal.
    word_size: Transfer size in bits: 8, 16, or 32.

Returns the bytes as a space-separated hex string.

Args:
    address: Memory address, hex (0x...) or decimal.
    value: Value to write, hex (0x...) or decimal.
    word_size: Transfer size in bits: 8, 16, or 32.

Args:
    path: Optional explicit artifact path. When omitted, resolve the default
        flash artifact for the connected session's loaded board config.
        Returns the resolved path in the success text.
    halt_after_reset: If True, leave the target halted after flashing.
        If False, reset and let it run.

Defaults come from the connected board config only for baudrate and
serial-port selection heuristics. ``expected_text=None`` means no explicit
text expectation: any observed UART output counts as a match.
Set ``port`` to override serial resolution explicitly. Set ``reset_on_open``
to trigger a target reset immediately after the UART port opens so early
boot text is captured deterministically.

The tool uses the same board-aware serial-port resolution as ``read_serial``.
It never executes host commands and only writes bytes to the resolved UART
transport for the active connected session. Set ``port`` to override serial
resolution explicitly. Set ``append_newline`` when the target firmware
expects line-oriented UART input.

This is a destructive action. When ``confirm`` is false the tool refuses
without touching hardware. Boards whose tracked config has no supported
``recover_mode`` fail deterministically instead of pretending success.