svd-vector-gen 0.1.5

A tool to process Microcontroller SVD files(e.g. STM32) and generate vector tables and linker scripts.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

# **SVD Vector and Linker Script Generator**


This tool scans the current directory for ARM Cortex-M compatible SVD files and automatically generates:

1. **Vector Table File (`vector_<mcu>.txt`)**:
    - Contains the vector table for the specified microcontroller with system exceptions and interrupt handlers.
    - **Format**: A `static VECTOR_TABLE` Rust array with `Option<unsafe fn()>` entries for each vector, including system handlers and IRQs.

2. **Device-Specific Linker Script (`device_<mcu>.x`)**:
    - Defines `PROVIDE` entries for all interrupts as:
      ```text
      PROVIDE(<IRQ_NAME> = default_handler);
      ```
      This facilitates linking during firmware development.

---

## **Usage**


1. **Install the tool using Cargo**:
   ```bash
   cargo install svd-vector-gen



2. **Run the tool**:

    - Ensure that the directory contains valid SVD files.

    - For STM32 microcontrollers, you can obtain SVD files by installing [STM32CubeCLT](https://www.st.com/en/development-tools/stm32cubeclt.html).

    
   ```bash

   svd-vector-gen


## **Example**


For `STM32F303X.svd`:


1. **Generated Files**:

   - `vector_STM32F303X.txt`: Contains the vector table.

   - `device_STM32F303X.x`: Contains the linker script:

     ```text

     PROVIDE(WWDG = default_handler);
     PROVIDE(PVD = default_handler);
     PROVIDE(TAMPER = default_handler);
     ...

     ```