CMSIS-SVD 开源项目使用教程
1. 项目的目录结构及介绍
CMSIS-SVD(Cortex Microcontroller Software Interface Standard System View Description)项目的主要目的是提供一个标准化的方式来描述微控制器设备的内部结构。以下是该项目的目录结构及其介绍:
cmsis-svd/
├── LICENSE
├── README.md
├── python
│ ├── setup.py
│ └── svd
│ ├── __init__.py
│ └── parser.py
├── schema
│ └── SVDSchema.xsd
└── svd
├── Atmel
├── Freescale
├── NXP
├── ST
└── ...
- LICENSE: 项目许可证文件,通常包含项目的使用条款和条件。
- README.md: 项目说明文件,提供项目的基本信息、安装和使用指南。
- python: 包含用于解析和处理SVD文件的Python脚本。
- setup.py: Python包的安装脚本。
- svd: Python模块,包含解析SVD文件的代码。
- schema: 包含SVD文件的XML Schema定义(SVDSchema.xsd),用于验证SVD文件的结构。
- svd: 包含各种厂商的SVD文件,每个厂商的文件夹中包含该厂商的微控制器设备的SVD描述文件。
2. 项目的启动文件介绍
CMSIS-SVD项目本身是一个数据和工具集合,没有传统意义上的“启动文件”。项目的主要入口点是Python脚本,用于解析和处理SVD文件。以下是主要的启动文件:
- python/setup.py: 这是Python包的安装脚本,用于安装项目所需的Python依赖和模块。
- python/svd/parser.py: 这是主要的解析器脚本,用于解析SVD文件并提取其中的信息。
3. 项目的配置文件介绍
CMSIS-SVD项目的配置文件主要是SVD文件本身,这些文件遵循XML格式,并根据schema/SVDSchema.xsd
进行定义。每个SVD文件描述了一个特定的微控制器设备的内部结构,包括寄存器、外设和内存映射等信息。
以下是一个典型的SVD文件的结构示例:
<device schemaVersion="1.1" xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="SVDSchema.xsd">
<name>STM32F407VG</name>
<version>1.0</version>
<description>STM32F407VG microcontroller</description>
<cpu>
<name>CM4</name>
<revision>r0p1</revision>
<endian>little</endian>
<mpuPresent>true</mpuPresent>
<fpuPresent>true</fpuPresent>
<nvicPrioBits>4</nvicPrioBits>
<vendorSystickConfig>false</vendorSystickConfig>
</cpu>
<peripherals>
<peripheral>
<name>GPIOA</name>
<baseAddress>0x40020000</baseAddress>
<registers>
<register>
<name>MODER</name>
<description>GPIO port mode register</description>
<addressOffset>0x00</addressOffset>
<size>32</size>
<access>read-write</access>
<resetValue>0x00000000</resetValue>
<fields>
<field>
<name>MODER0</name>
<description>Port x configuration bits (y = 0..15)</description>
<bitOffset>0</bitOffset>
<bitWidth>2</bitWidth>
</field>
</fields>
</register>
</registers>
</peripheral>
</peripherals>
</device>
每个SVD文件包含以下主要部分:
- device: 定义设备的名称、版本和描述。
- cpu: 描述设备的CPU信息,如名称、修订版本、端序等。
- peripherals: 列出设备的所有外设,每个外设包含其名称、基地址和寄存器列表。