Skip to content

Repository files navigation

PyAvrOCD

License: MIT PyPI version PyPI Downloads PyPI Python Version Static Badge Pylint badge Pytest badge Coverage badge Release workflow Commits since latest GitHub Issues or Pull Requests GitHub Issues or Pull Requests GitHub Downloads (all assets, all releases) Hit Counter

PyAvrOCD is a GDB server for 8-bit AVR MCUs (see list of supported MCUs and supported boards), communicating with Microchip's EDBG-based debug probes, e.g., MPLAB Snap. So, is it simply another open-source GDB server for AVR MCUs? No! It is a cross-platform AVR GDB server. This means that it was easily possible to integrate it into Arduino IDE 2 and PlatformIO board packages, bringing AVR debugging to these IDEs. Additionally, PyAvrOCD excels in minimizing flash wear and protects single-stepping against interrupts.

Interested in giving PyAvrOCD a try? You are welcome to install it. Want to learn more about it? Read the docs. Any feedback, be it bug reports, crazy ideas, or praise, is welcome.

What has been done so far, and what to expect in the future

Meanwhile, PyAvrOCD covers all debugWIRE, JTAG (Megas), and UPDI MCUs. I am unsure whether it makes sense to extend its coverage to Xmegas.

I made some leeway into integrating PyAvrOCD more tightly with PlatformIO and with the Arduino Maker Workshop VSCode extension. There is the idea of basing everything on more recent versions of the GCC toolchain because it will probably solve a number of problems on the debugging front. My attempt at using the GCC 15.1 toolchain was abruptly stopped when I discovered that the compiler produces buggy debug information concerning local variables, whereas the old compiler works without a flaw at that point. I guess more research and/or debugging is necessary before GCC 15.1 is a viable solution.

Finally, I am committed to fixing some of the more obvious bugs in the AVR part of the GDB debugger.

About

A cross-platform GDB server for AVR MCUs integrated into the Arduino IDE 2

Topics

Resources

Code of conduct

Contributing

Stars

20 stars

Watchers

4 watching

Forks

Releases

Used by

Contributors

Languages