{"id":16221587,"url":"https://github.com/rahix/atdf2svd","last_synced_at":"2025-04-07T13:09:29.311Z","repository":{"id":38312471,"uuid":"185458485","full_name":"Rahix/atdf2svd","owner":"Rahix","description":"Converter from Atmel's atdf format to CMSIS SVD","archived":false,"fork":false,"pushed_at":"2025-03-01T04:32:05.000Z","size":451,"stargazers_count":19,"open_issues_count":6,"forks_count":11,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-31T12:06:56.976Z","etag":null,"topics":["atdf","avr","avr-rust","cmsis-svd","microcontroller","rust"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Rahix.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-07T18:37:26.000Z","updated_at":"2025-02-19T14:56:01.000Z","dependencies_parsed_at":"2024-08-01T08:15:12.618Z","dependency_job_id":"4f145e23-2782-4623-8036-2f2d379dd938","html_url":"https://github.com/Rahix/atdf2svd","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahix%2Fatdf2svd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahix%2Fatdf2svd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahix%2Fatdf2svd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahix%2Fatdf2svd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rahix","download_url":"https://codeload.github.com/Rahix/atdf2svd/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247657281,"owners_count":20974345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atdf","avr","avr-rust","cmsis-svd","microcontroller","rust"],"created_at":"2024-10-10T12:09:00.293Z","updated_at":"2025-04-07T13:09:29.289Z","avatar_url":"https://github.com/Rahix.png","language":"Rust","readme":"atdf2svd [![crates.io page](https://img.shields.io/crates/v/atdf2svd.svg)](https://crates.io/crates/atdf2svd) [![CI](https://github.com/Rahix/atdf2svd/actions/workflows/ci.yml/badge.svg)](https://github.com/Rahix/atdf2svd/actions/workflows/ci.yml)\n========\nA converter tool that converts Atmel's *atdf* files into *svd*.  The primary usecase for this is to then use the *svd* files with `svd2rust` to create safe abstractions for register access.\n\n## Usage\n```\nUSAGE:\n    atdf2svd \u003catdf_path\u003e [svd_path]\n```\n\n## Installation\nInstall *atdf2svd* using\n\n```shell-session\n$ cargo install -f atdf2svd\n```\n\n## Notes\n### Automatic Changes\nThere are two \"post-processors\" running after the conversion ([`patch.rs`](src/atdf/patch.rs)):\n- `signals_to_port_fields`: Patches the registers for all `PORTx` peripherals to contain fields for each existing pin.  Pin IDs are taken from the `\u003csignals /\u003e` tag of the port instance.\n- `remove_unsafe_cpu_regs`: Removes the `SREG`(Status Register) and `SP`(Stack Pointer) registers as they should not be safely accessible.\n\n### Manual Changes\nUnfortunately, the provided *atdf* files are often not completely correct or contain undescriptive names.  One big issue is that enumerated values are often just named `VAL_0xXX`.  I recommend patching the generated *svd* files using the patch tool written by the [stm32-rs](https://github.com/stm32-rs/stm32-rs#device-and-peripheral-yaml-format) project.\n\n## License\n`atdf2svd` is licensed under the `GPL v3` license.  See [LICENSE](LICENSE) or \u003chttps://www.gnu.org/licenses/gpl-3.0.en.html\u003e for more info.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahix%2Fatdf2svd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frahix%2Fatdf2svd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahix%2Fatdf2svd/lists"}