{"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":[{"wrong":"from freertos_gdb import FreeRTOS","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,"search_vec":"'1.0.4':21 'cadenc':34 'close':27 'current':19 'debug':42 'esp':31 'esp-idf':30 'esp32':43 'espressif':24 'event':14 'freerto':1,7,41 'gdb':2,18,40 'group':15 'idf':32 'infrequ':38 'inspect':6 'kernel':8 'low':36 'modul':4 'object':9 'part':22 'python':3 'queue':11 'releas':33 'semaphor':12 'task':10 'tie':28 'timer':13 'toolchain':26 'updat':39 'version':20 'within':17","created_at":"2026-04-27T16:59:29.161008+00:00","updated_at":"2026-04-27T16:59:29.161008+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\n  File \"/tmp/tmpc89oa60a/venv/lib/python3.12/site-packages/freertos_gdb/__init__.py\", line 4, in <module>\n    from . import common\n  File \"/tmp/tmpc89oa60a/venv/lib/python3.12/site-packages/freertos_gdb/common.py\", line 5, in "},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.0.4","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/espressif/freertos-gdb","docs":null,"changelog":null,"pypi":"https://pypi.org/project/freertos-gdb/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops","observability"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}