---
name: "pyocd-gdbserver"
section: "1"
platform: "linux"
package: "python3-pyocd"
version: "0.36.0-2.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pyocd-gdbserver"
---

# pyocd-gdbserver(1)

ARM Cortex-M programming tool

## NAME

pyocd-gdbserver - ARM Cortex-M programming tool

## DESCRIPTION

**pyocd-gdbserver** is an ARM Cortex-M programming tool

### Summary

pyOCD is an Open Source python based library for programming and debugging ARM Cortex-M microcontrollers using CMSIS-DAP.

Includes support for flashing new binaries, resetting the device, halt, step, resume read/write memory and set/remove breakpoints.

### Support

Firmware files included in the upstream source are NOT included in the Debian package due to a lack of source code. Target files can be downloaded separately from  \<https://github.com/mbedmicro/pyOCD/tree/master/binaries\>

Available targets for use with --target option: lpc824, kinetis, w7500, kv11z7, lpc4088qsb, kv10z7, k20d50m, ncs36510, kl28z, kl25z, k82f25615, k28f15, maxwsnenv, max32600mbed, k22fa12, lpc4088, lpc4330, ke18f16, kl46z, stm32f103rc, kl82z7, lpc54114, kl43z4, kl26z, lpc11xx\_32, lpc800, rtl8195am, kl05z, lpc1768, kw41z4, lpc4088dm, stm32f051, cortex\_m, lpc11u24, kl02z, kw01z4, k64f, k22f, ke15z7, nrf51, nrf52, kl27z4, kw40z4, k66f18

### Usage

- **usage: pyocd-gdbserver \[-h\] \[--version\] \[-p PORT\_NUMBER\] \[-T TELNET\_PORT\] \[--allow-remote\] \[-b BOARD\_ID\] \[-l\] \[--list-targets\]**

  \[--json\] \[-d LEVEL\] \[-t TARGET\] \[-n\] \[-r\] \[-C VECTOR\_CATCH\] \[-s\] \[-f FREQUENCY\] \[-o\] \[-bh\] \[-ce \| -se\] \[-u\] \[-hp\] \[-fp\] \[-S\] \[-G\] \[-c CMD \[CMD ...\]\] \[-da DAPARG \[DAPARG ...\]\]

PyOCD GDB Server

- **optional arguments:**

  - **-h, --help**

    show this help message and exit

  - **--version**

    show program's version number and exit

  - **-p** *PORT\_NUMBER,* **--port** *PORT\_NUMBER*

    Write the port number that GDB server will open.

  - **-T** *TELNET\_PORT,* **--telnet-port** *TELNET\_PORT*

    Specify the telnet port for semihosting.

  - **--allow-remote**

    Allow remote TCP/IP connections (default is no).

  - **-b** *BOARD\_ID,* **--board** *BOARD\_ID*

    Connect to board by board id. Use -l to list all connected boards.

  - **-l, --list**

    List all connected boards.

  - **--list-targets**

    List all available targets.

  - **--json**

    Output lists in JSON format. Only applies to --list and --list-targets.

  - **-d** *LEVEL,* **--debug** *LEVEL*

    Set the level of system logging output. Supported choices are: debug, info, warning, critical, error

  - **-t** *TARGET,* **--target** *TARGET*

    Override target to debug. -n, --nobreak         Disable halt at hardfault handler. (Deprecated)

  - **-r, --reset-break**

    Halt the target when reset. (Deprecated)

  - **-C VECTOR\_CATCH, --vector-catch VECTOR\_CATCH Enable vector catch sources, one letter per enabled source in any order, or 'all' or 'none'. (h=hard**

    fault, b=bus fault, m=mem fault, i=irq err, s=state err, c=check err, p=nocp, r=reset, a=all, n=none). (Default is hard fault.)

  - **-s, --step-int**

    Allow single stepping to step into interrupts.

  - **-f** *FREQUENCY,* **--frequency** *FREQUENCY*

    Set the SWD clock frequency in Hz.

  - **-o, --persist**

    Keep GDB server running even after remote has detached.

  - **-b***h,* **--soft-bkpt-as-hard**

    Replace software breakpoints with hardware breakpoints.

  - **-c***e,* **--chip\_erase**

    Use chip erase when programming.

  - **-s***e,* **--sector\_erase**

    Use sector erase when programming.

  - **-u, --unlock**

    Unlock the device.

  - **-h***p,* **--hide\_progress**

    Don't display programming progress.

  - **-f***p,* **--fast\_program**

    Use only the CRC of each page to determine if it already has the same data.

  - **-S, --semihosting**

    Enable semihosting.

  - **-G, --gdb-syscall**

    Use GDB syscalls for semihosting file I/O.

  \-c CMD \[CMD ...\], --command CMD \[CMD ...\]    Run command (OpenOCD compatibility).

  \-da DAPARG \[DAPARG ...\], --daparg DAPARG \[DAPARG ...\]   Send setting to DAPAccess layer.

## COPYRIGHT

2006-2013 ARM Limited