freertos-gdb

library1.0.4pypypiunverified

Python module for inspecting FreeRTOS kernel objects (tasks, queues, semaphores, timers, event groups) from within GDB. Current version: 1.0.4. Part of Espressif's toolchain, closely tied to ESP-IDF. Release cadence is low, with infrequent updates.

devops observability

pip install freertos-gdb

github ↗package ↗

INSTALL

IMPORT

SIG · FREERTOS-GDB

freertos-gdb

devopspythonv1.0.4

Install

1.5s avg

Import

—

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.0.4 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 17.9MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.5s · import 0.000s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FreeRTOS

✓ from freertos_gdb import FreeRTOS

✗ from freertos_gdb import FreeRTOS

Import and instantiate FreeRTOS in GDB Python console to enable FreeRTOS-aware debugging commands.

# In GDB, after loading firmware: import freertos_gdb freertos_gdb.FreeRTOS() # Then use commands: info tasks, info queues, etc.

Debug

Known issues

breakingOnly works within GDB's Python interpreter (not standalone Python).

fix

Load your firmware binary in GDB, then run 'python import freertos_gdb; freertos_gdb.FreeRTOS()' from GDB prompt.

affects: all

gotchaRequires FreeRTOS kernel symbols to be present in the target firmware; otherwise commands will fail or show no output.

fix

Ensure your firmware is compiled with FreeRTOS debug symbols (e.g., CONFIG_FREERTOS_DEBUG in ESP-IDF).

affects: all

Upgrade

Version history

1.0.4latest on PyPI · released Feb 3, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

22 hits · last 30 days

node

OpenAI (training)

Amazon

Resources

githubhttps://github.com/espressif/freertos-gdb ↗

packagehttps://pypi.org/project/freertos-gdb/ ↗