Auto-detects the STM32CubeIDE installation path and all bundled toolchains:

• Base IDE directory and detected version

• stm32cubeide executable and console launcher

• headless-build script

• STM32_Programmer_CLI executable

• ST-LINK_gdbserver executable

• OpenOCD executable

• GNU ARM toolchain (arm-none-eabi-gcc, gdb, size, objcopy)

Checks the real-time operational status of STM32CubeIDE on the host system:

• Whether the IDE GUI is currently running

• PIDs, memory usage, and runtime of STM32 processes

• Open STM32CubeIDE windows and dialog titles

• Connected debug probes (ST-LINK, DFU, COM ports)

Scans for all connected STM32 hardware interfaces and debug probes:

• ST-LINK probes with serial numbers and firmware versions

• STM32 devices in DFU (USB bootloader) mode

• J-Link adapters

• Available serial / UART COM ports

Connects to the physical STM32 microcontroller and retrieves hardware device info:

• Device ID (e.g. 0x423 for STM32F401, 0x410 for STM32F103)

• Device name and core architecture

• Flash memory size

• Connection status

Opens/launches the STM32CubeIDE desktop application.

Args: workspace_path: Optional path to open a specific Eclipse workspace directory. project_path: Optional path to open a specific STM32 project. file_to_open: Optional path to a specific source file (e.g. main.c) to edit. clean: If True, passes -clean to refresh Eclipse OSGi bundles.

Closes running STM32CubeIDE instances.

Args: force: If True, forcefully terminates the processes. Otherwise closes gracefully.

Brings the STM32CubeIDE main window to the foreground and restores it if minimized.

Lists all open STM32CubeIDE windows, dialogs, coordinates, and window titles.

Sends Eclipse keyboard shortcuts directly to the STM32CubeIDE window.

Supported actions:

• 'build': Build active project (Ctrl+B / Cmd+B)

• 'debug': Start debug session (F11)

• 'run': Run target (Ctrl+F11)

• 'step_into': Debug step into (F5)

• 'step_over': Debug step over (F6)

• 'step_return': Debug step return (F7)

• 'resume': Debug resume execution (F8)

• 'terminate': Stop/terminate debug (Ctrl+F2)

• 'save_all': Save all open files (Ctrl+Shift+S)

• 'open_resource': Open resource dialog (Ctrl+Shift+R)

• 'quick_access': Focus Quick Access bar (Ctrl+3)

Captures a screenshot of the STM32CubeIDE window or desktop. Returns dimensions, base64 PNG data, and optionally saves to local file.

Recursively scans a workspace or root directory and discovers all STM32 projects. Returns project names, paths, detected target MCUs, and whether .ioc files exist.

Scaffolds a new, ready-to-build STM32 project:

• .project: Eclipse CDT project definition

• .ioc: STM32CubeMX configuration file

• Core/Src/main.c: Standard embedded main entry point with LED blink loop

• Core/Inc/main.h: Embedded header file

• STM32_FLASH.ld: Linker script for Flash & RAM section mappings

• Makefile: Standalone GNU ARM build script

Imports an existing STM32Cube project into an Eclipse workspace headlessly.

Args: workspace_path: Path to the target workspace folder. project_dir: Path to the project root folder containing .project.

Removes a project from the headless Eclipse workspace.

Parses an STM32CubeMX .ioc file and returns:

• MCU Target name & Family (e.g. STM32F4, STM32G4)

• CPU core type (Cortex-M4, Cortex-M7, etc.)

• System clock frequency in Hz

• Configured GPIO pins, labels, and modes

• Enabled IPs (USART, SPI, I2C, CAN, ADC, FreeRTOS, etc.)

Updates or inserts a configuration property in an STM32CubeMX .ioc file (e.g. key='RCC.SYSCLKFreq_VALUE', value='84000000').

Executes a headless build of a project in an STM32CubeIDE workspace using headless-build.

Args: workspace_path: Path to the Eclipse workspace folder. project_name: Specific project name to build (or None for all projects). configuration: Build configuration ('Debug' or 'Release'). clean_first: If True, performs a clean build (-cleanBuild). no_indexer: Disables Eclipse indexer during build for speed.

Cleans build artifacts for a project or workspace headlessly.

Inspects built binaries (.elf, .hex, .bin, .map) in the project output directory. Uses arm-none-eabi-size to analyze text, data, bss sections, and calculates total Flash and RAM usage.

Flashes firmware (.elf, .hex, or .bin) onto the target STM32 microcontroller.

Args: file_path: Path to compiled binary (.elf, .hex, .bin). address: Flash start address (required for raw .bin files, e.g. '0x08000000'). verify: Verify flash write after programming. reset: Reset target MCU after programming. port: Debug interface ('SWD', 'JTAG', 'URT', 'USB1'). freq_khz: Debug probe clock frequency in kHz. start_run: Start firmware execution immediately.

Erases target flash memory.

Args: mode: 'all' for full chip mass erase, or 'sectors' with start_address and end_address. start_address: Start address (e.g. '0x08000000') for sector erase. end_address: End address (e.g. '0x08004000') for sector erase. port: Connection port ('SWD', 'JTAG', 'URT').

Triggers a target MCU reset via debug probe.

Args: hard_reset: If True, pulses the hardware NRST pin (-hardRst). Otherwise software system reset. port: Connection port ('SWD', 'JTAG').

Reads 32-bit words from target memory address (registers, RAM, or Flash).

Args: address: Target memory hex address (e.g. '0x08000000' or '0x40020000'). size: Number of 32-bit words to read. port: Connection interface ('SWD', 'JTAG').

Writes a 32-bit word directly to a target memory address or peripheral register.

Args: address: Target address (e.g. '0x20000000'). value: Hex value to write (e.g. '0x12345678'). port: Connection interface ('SWD', 'JTAG').

Reads device option bytes (Read Out Protection RDP, Brownout Reset BOR, Watchdog, Boot).

Modifies hardware option bytes (e.g. options=['RDP=0xAA', 'BOR_LEV=0']).

Reads flash memory contents from the target MCU and dumps them to a local file.

Starts the bundled ST-LINK_gdbserver as a background process listening on specified TCP port.

Args: port: GDB TCP port (default: 61234). probe_index: ST-Link probe index to bind. verify: Verify flash write during GDB load. persistent: Keep server active between disconnects (-p).

Starts OpenOCD with specified configuration scripts.

Stops all running ST-LINK_gdbserver or OpenOCD processes.

Executes an automated GDB batch session against target MCU using arm-none-eabi-gdb.

Args: commands: List of GDB commands (e.g. ['monitor reset halt', 'info registers', 'bt']). elf_file: Optional path to compiled .elf file with debug symbols. remote_port: Port of active GDB server (connects to localhost:). timeout_sec: Maximum execution timeout in seconds.

Lists all available UART / COM serial ports on the host system with hardware descriptions.

Listens and captures incoming serial output from target UART (e.g. printf output or RTOS telemetry).

Args: port: Port name (e.g. 'COM3' or '/dev/ttyUSB0'). baudrate: Baud rate (default: 115200). timeout_sec: Listening window in seconds. max_bytes: Maximum bytes to read.

Sends data or AT/terminal commands to target MCU over serial port.

Args: port: Port name (e.g. 'COM3' or '/dev/ttyUSB0'). data: String to send. baudrate: Baud rate (default: 115200). append_newline: If True, appends CRLF (\r\n).