#svd #device-tree #generate

no-std bin+lib svd-generator

Converts device information from flattened device tree into an SVD description

11 releases (6 breaking)

0.7.0 Oct 17, 2024
0.6.0 Apr 28, 2024
0.5.0 Apr 17, 2024
0.4.2 Mar 22, 2024

#244 in Embedded development

Download history 25/week @ 2024-07-25 1/week @ 2024-08-01 1/week @ 2024-09-19 2/week @ 2024-09-26 2/week @ 2024-10-03 194/week @ 2024-10-17 2/week @ 2024-10-24

199 downloads per month

MIT license

1.5MB
37K SLoC

svd-generator

Conversion tool for parsing device information from flattened device tree files, and generating a CMSIS-SVD description.

Building

Build using a standard Rust workflow:

$ cargo build [--release]

Running

svd-generator produces a CLI binary, you can run with:

# Using `cargo-run`
$ cargo run -- -f <flatted-device-tree.dtb> [-o <output.svd>]

# Running directly using the binary file
$ svd-generator -f <flattened-device-tree.dtb> [-o <output.svd>]

The default output file is out.svd.

For help information:

$ svd-generator -h

Adding known peripherals

Only known peripherals will have SVD entries added.

This is because register definitions are not included in device tree files.

Register definitions are typically parsed from vendor provided manuals, firmware/kernel source code, and/or hardware definitions (VHDL, Verilog, etc.).

Currenty, there are a limited number of supported peripherals. They can be used as examples for adding new peripherals.

Peripheral definitions go in the svd/peripheral directory as a module.

For example, the Synsopsys DesignWare APB I2C peripheral definition: dw_apb_i2c.

New peripherals should follow to convential Rust module naming pattern:

  • peripheral module: src/svd/peripheral/<peripheral-model-name>.rs
  • peripheral sub-modules: src/svd/peripheral/<peripheral-model-name>/
  • peripheral registers submodule: src/svd/peripheral/<peripheral-model-name>/registers.rs
  • peripheral register definitions: src/svd/peripheral/<peripheral-model-name>/registers/{<reg0-name>.rs, <reg1-name>.rs}

Defining peripherals in this way should allow for a large degree of reusability among different SoCs/boards.

New entries should also be added to the Compatible enum: tree/compatible.

WIP

Currently, only binary-encoded flattened device tree (.dtb) is supported.

Work is ongoing to support source-encoded device tree (.dts).

Dependencies

~4–13MB
~150K SLoC