{"id":21360,"library":"freertos-gdb","title":"FreeRTOS GDB","description":"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.","status":"active","version":"1.0.4","language":"python","source_language":"en","source_url":"https://github.com/espressif/freertos-gdb","tags":["gdb","freeRTOS","debugging","esp32"],"install":[{"cmd":"pip install freertos-gdb","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Standard import to access FreeRTOS inspection commands.","symbol":"FreeRTOS","correct":"from freertos_gdb import FreeRTOS"}],"quickstart":{"code":"# In GDB, after loading firmware:\nimport freertos_gdb\nfreertos_gdb.FreeRTOS()\n# Then use commands: info tasks, info queues, etc.","lang":"python","description":"Import and instantiate FreeRTOS in GDB Python console to enable FreeRTOS-aware debugging commands."},"warnings":[{"fix":"Load your firmware binary in GDB, then run 'python import freertos_gdb; freertos_gdb.FreeRTOS()' from GDB prompt.","message":"Only works within GDB's Python interpreter (not standalone Python).","severity":"breaking","affected_versions":"all"},{"fix":"Ensure your firmware is compiled with FreeRTOS debug symbols (e.g., CONFIG_FREERTOS_DEBUG in ESP-IDF).","message":"Requires FreeRTOS kernel symbols to be present in the target firmware; otherwise commands will fail or show no output.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run the import inside GDB's Python interpreter after loading a firmware binary.","cause":"Trying to import the module outside GDB's Python environment.","error":"ModuleNotFoundError: No module named 'freertos_gdb'"},{"fix":"Check that your firmware includes FreeRTOS and is currently executing (halted with GDB).","cause":"The firmware does not have FreeRTOS kernel symbols or is not running.","error":"Failed to locate FreeRTOS kernel objects. Ensure the target is running FreeRTOS."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}