PYOCD-GDBSERVER(1)

📦
version 0.45.0 · 4 versions
, in ubuntu resolute, ubuntu stonking

💖 pyocd-gdbserver — the manual page bestie 💖

okay so real quick, the manual name is pyocd-gdbserver and this is version 0.12.0. yes we're doing this. sit down, grab a snack 🍓

✨ Name ✨

pyocd-gdbserver — an ARM Cortex-M programming tool 🦋

🌸 Description 🌸

pyocd-gdbserver is an ARM Cortex-M programming tool. that's it, that's the whole description, she's brief and she knows it 💅

🎀 Summary 🎀

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

It includes support for flashing new binaries, resetting the device, halt, step, resume, read/write memory and set/remove breakpoints. like… the whole toolkit? iconic.

🫶 Support 🫶

⚠️ listen bestie: the firmware files included in the upstream source are NOT included in the Debian package, due to a lack of source code. it's giving legal sadness 😭

Target files can be downloaded separately from <https://github.com/mbedmicro/pyOCD/tree/master/binaries>

Available targets for use with the --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

that's 43 targets btw. we counted. we love a thorough list 🌈

🧚 Usage 🧚

here's the whole invocation vibe, verbatim, do not touch:

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. the classic. the moment. 💅
  • --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). lowkey careful with this one bestie, default is a no for a reason 🙈
  • -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.
  • -bh, --soft-bkpt-as-hard — Replace software breakpoints with hardware breakpoints.
  • -ce, --chip_erase — Use chip erase when programming.
  • -se, --sector_erase — Use sector erase when programming.
  • -u, --unlock — Unlock the device.
  • -hp, --hide_progress — Don't display programming progress.
  • -fp, --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.

2006-2013 ARM Limited

okay that's the whole page bestie, you ate it, go flash something 💖✨

this was pyocd-gdbserver from the pyocd-gdbserver() manual, version 0.12.0 — and the date slot in that footer is literally just empty quotes, so like… timeless, I guess 🦋 periodt 💅

📦 where this page comes from