From fe2d94f1041623a33fbdc0e4061aa6c694cc2743 Mon Sep 17 00:00:00 2001 From: Adam Hott Date: Wed, 1 May 2024 07:27:03 +0100 Subject: [PATCH] Update embedded rust debugging section of tooling.md --- src/intro/tooling.md | 86 +++++++++++++++++++++++++++++--------------- 1 file changed, 57 insertions(+), 29 deletions(-) diff --git a/src/intro/tooling.md b/src/intro/tooling.md index 88adc2d1..68f3674c 100644 --- a/src/intro/tooling.md +++ b/src/intro/tooling.md @@ -53,32 +53,60 @@ QEMU is an emulator. In this case we use the variant that can fully emulate ARM systems. We use QEMU to run embedded programs on the host. Thanks to this you can follow some parts of this book even if you don't have any hardware with you! -## GDB - -A debugger is a very important component of embedded development as you may not -always have the luxury to log stuff to the host console. In some cases, you may -not even have LEDs to blink on your hardware! - -In general, LLDB works as well as GDB when it comes to debugging but we haven't -found an LLDB counterpart to GDB's `load` command, which uploads the program to -the target hardware, so currently we recommend that you use GDB. - -## OpenOCD - -GDB isn't able to communicate directly with the ST-Link debugging hardware on -your STM32F3DISCOVERY development board. It needs a translator and the Open -On-Chip Debugger, OpenOCD, is that translator. OpenOCD is a program that runs -on your laptop/PC and translates between GDB's TCP/IP based remote debug -protocol and ST-Link's USB based protocol. - -OpenOCD also performs other important work as part of its translation for the -debugging of the ARM Cortex-M based microcontroller on your STM32F3DISCOVERY -development board: -* It knows how to interact with the memory mapped registers used by the ARM - CoreSight debug peripheral. It is these CoreSight registers that allow for: - * Breakpoint/Watchpoint manipulation - * Reading and writing of the CPU registers - * Detecting when the CPU has been halted for a debug event - * Continuing CPU execution after a debug event has been encountered - * etc. -* It also knows how to erase and write to the microcontroller's FLASH +# Tooling for Embedded Rust Debugging + +## Overview + +Debugging embedded systems in Rust requires specialized tools including software to manage the debugging process, debuggers to inspect and control program execution, and hardware probes to facilitate interaction between the host and the embedded device. This document outlines essential software tools like Probe-rs and OpenOCD, which simplify and support the debugging process, alongside prominent debuggers such as GDB and the Probe-rs Visual Studio Code extension. Additionally, it covers key hardware probes such as Rusty-probe, ST-Link, J-Link, and MCU-Link, which are integral for effective debugging and programming of embedded devices. + +## Software that drives debugging tools + +### Probe-rs + +Probe-rs is a modern, Rust-focused software designed to work with debuggers in embedded systems. Unlike OpenOCD, Probe-rs is built with simplicity in mind and aims to reduce the configuration burden often found in other debugging solutions. It supports various probes and targets, providing a high-level interface for interacting with embedded hardware. Probe-rs integrates directly with Rust tooling,and integrates with Visual Studio Code through its extension, allowing developers to streamline their debugging workflow. + + +### OpenOCD (Open On-Chip Debugger) + +OpenOCD is an open-source software tool used for debugging, testing, and programming embedded systems. It provides an interface between the host system and embedded hardware, supporting various transport layers like JTAG and SWD (Serial Wire Debug). OpenOCD integrates with GDB, which is a debugger. OpenOCD is widely supported, with extensive documentation and a large community, but may require complex configuration, especially for custom embedded setups. + +## Debuggers + +A debugger allows developers to inspect and control the execution of a program in order to identify and correct errors or bugs. It provides functionalities such as setting breakpoints, stepping through code line by line, and examining the values of variables and memory states. Debuggers are essential for thorough software development and maintenance, enabling developers to ensure that their code behaves as intended under various conditions. + +Debuggers know how to: + * Interact with the memory mapped registers. + * Set Breakpoints/Watchpoints. + * Read and write to the memory mapped registers. + * Detect when the MCU has been halted for a debug event. + * Continue MCU execution after a debug event has been encountered. + * Erase and write to the microcontroller's FLASH. + +### Probe-rs Visual Studio Code Extension + +Probe-rs has a Visual Studio Code extension, providing a seamless debugging experience without extensive setup. Through this connection, developers can use Rust-specific features like pretty printing and detailed error messages, ensuring that their debugging process aligns with the Rust ecosystem. + +### GDB (GNU Debugger) + +GDB is a versatile debugging tool that allows developers to examine the state of programs while they run or after they crash. For embedded Rust, GDB connects to the target system via OpenOCD or other debugging servers to interact with the embedded code. GDB is highly configurable and supports features like remote debugging, variable inspection, and conditional breakpoints. It can be used on a variety of platforms, and has extensive support for Rust-specific debugging needs, such as pretty printing and integration with IDEs. + + +## Probes + +A hardware probe is a device used in the development and debugging of embedded systems to facilitate communication between a host computer and the target embedded device. It typically supports protocols like JTAG or SWD, enabling it to program, debug, and analyze the microcontroller or microprocessor on the embedded system. Hardware probes are crucial for developers to set breakpoints, step through code, and inspect memory and processor registers, effectively allowing them to diagnose and fix issues in real-time. + +### Rusty-probe + +Rusty-probe is an open-sourced USB-based hardware debugging probe designed to work with probe-rs. The combination of Rusty-Probe and probe-rs provides an easy-to-use, cost-effective solution for developers working with embedded Rust applications. + +### ST-Link + +The ST-Link is a popular debugging and programming probe developed by STMicroelectronics primarily for their STM32 and STM8 microcontroller series. It supports both debugging and programming via JTAG or SWD (Serial Wire Debug) interfaces. ST-Link is widely used due to its direct support from STMicroelectronics' extensive range of development boards and its integration into major IDEs, making it a convenient choice for developers working with STM microcontrollers. + +### J-Link + +J-Link, developed by SEGGER Microcontroller, is a robust and versatile debugger supporting a wide range of CPU cores and devices beyond just ARM, such as RISC-V. Known for its high performance and reliability, J-Link supports various communication interfaces, including JTAG, SWD, and fine-pitch JTAG interfaces. It is favored for its advanced features like unlimited breakpoints in flash memory and its compatibility with a multitude of development environments. + +### MCU-Link + +MCU-Link is a debugging probe that also functions as a programmer, provided by NXP Semiconductors. It supports a variety of ARM Cortex microcontrollers and interfaces seamlessly with development tools like MCUXpresso IDE. MCU-Link is particularly notable for its versatility and affordability, making it an accessible option for hobbyists, educators, and professional developers alike. \ No newline at end of file