How to connect using serial port

nRF Connect for VS Code

tags
nRF Connect for VS Code

To connect to a device using a serial connection:

  1. Connect the device to the same machine you are using to run the extension.
    The device appears as an entry in the Connected Device View.

    Important

    SEGGER J-Link compatibility is required for devices to show up in the Connected Devices View.

    • If you are working on Windows and your device does not show up in the View, but it does have the J-Link OB on-board debug probe, check if you have SEGGER USB Driver for J-Link installed (required for support of older Nordic Semiconductor devices in nRF Util, as per extension prerequisites).
    • Some devices, such as the BBC micro:bit, do not have J-Link by default. You can convert the onboard debug interface to a J-Link OB using the J-Link upgrade instructions.
  2. Expand the device entry.

  3. Click the Connect to Serial Port button to the right of the serial port entry to start a serial connection.

    Connect to Serial Port

    The extension prompts you for configuration settings for the given connection type.

  4. Select one of the following options for the connection from the Command Palette:

    Note

    Only customize the connection values if you have changed the default UART driver settings, to make sure both sets of values are matching.

  5. Optionally, if you chose Other in the previous step, select the custom baud rate, data bits, and stop bits for the connection.

After the connection is established, a new terminal entry is added in the Panel View, with its name corresponding to the name of your device if you renamed the device.

Tip

The extension saves the serial port connection settings for future use. Next time you connect, you can select the previous connection settings from the quick pick menu or change them using the Change port settings button.

Change port settings