Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:CMSIS-SVD

From ReverseEngineering.wiki
Format
On this wiki Facts · Code · Notes · Topics

CMSIS System View Description: an XML file per microcontroller listing its peripherals, base addresses, registers and bit fields; the standard source of memory-mapped register names when reversing Cortex-M firmware, loadable into Ghidra with SVD-Loader.

Overview

A CMSIS-SVD file (.svd) is an XML description of a chip's device, CPU, peripherals, registers and fields, published by the silicon vendor in its CMSIS device pack (Keil packs, vendor SDKs) and collected in community repositories. It holds names and addresses, not code, so it is the fastest way to turn *(volatile uint32_t*)0x40011004 = x in a disassembly into USART1->CR1.

Structure

Unverified: element names below come from the CMSIS-SVD specification as remembered, not read in a source for this page. Root <device> has <name>, <version>, <addressUnitBits>, <width>, a <cpu> element and <peripherals>. Each <peripheral> has <name>, <baseAddress>, optional derivedFrom="OtherPeripheral" (copies the registers of another, common for UART1/UART2), <addressBlock> (offset, size, usage) and <interrupt> entries (name, value). Registers sit in <registers> as <register> (name, addressOffset, size, access, resetValue) with <fields> of <field> (name, bitOffset, bitWidth), plus <cluster> for repeated groups. Absolute register address = peripheral baseAddress + register addressOffset.

Loading into a disassembler

Tool:SVD-Loader for Ghidra creates memory blocks and structures from an SVD file. Other tools exist for IDA and Binary Ninja. Unverified: names of the IDA/Binary Ninja plugins.

Sources

The SVD parser library cmsis-svd (posborne/cmsis-svd, Apache-2.0 per the SVD-Loader README) collects over 650 SVD files; Keil packs carry the vendor originals. Check each file's license before redistributing it.

Code & repositories

  • https://github.com/ARM-software/CMSIS_6 @ d4a772e65df07a79ffe69c169a72d9bde4e5e7a6 · license: Apache-2.0
    CMSIS core headers (core_cm*.h) with SCB, NVIC, SysTick, MPU register layouts and base addresses.
    Tested on: source read, not run: read · checked 2026-10-18; last activity 2026-10-08
  • https://github.com/leveldown-security/SVD-Loader-Ghidra @ 4b21fa54a1f516e25e959939f6e1251263c74725 · license: GPL-3.0-only (declared by the contributor for the files used; GitHub reports GPL-3.0 for the repository)
    Ghidra script that loads a CMSIS-SVD file as memory map and structures (GPLv3; bundled parser Apache-2.0).
    Tested on: source read, not run: read · checked 2026-10-18; last activity 2024-02-01

See also

Platform:ARM Cortex-M