{"id":22555481,"url":"https://github.com/eclipse-cdt-cloud/vscode-peripheral-inspector","last_synced_at":"2025-12-11T21:56:07.790Z","repository":{"id":65709249,"uuid":"455220374","full_name":"eclipse-cdt-cloud/vscode-peripheral-inspector","owner":"eclipse-cdt-cloud","description":"vscode peripheral inspector","archived":false,"fork":false,"pushed_at":"2025-03-31T12:58:55.000Z","size":505,"stargazers_count":4,"open_issues_count":2,"forks_count":5,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-03-31T14:03:48.297Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://open-vsx.org/extension/eclipse-cdt/peripheral-inspector","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eclipse-cdt-cloud.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2022-02-03T15:32:42.000Z","updated_at":"2025-03-31T12:58:59.000Z","dependencies_parsed_at":"2023-10-14T16:35:33.827Z","dependency_job_id":"12839a9c-1c74-481c-b142-e641c8ca0376","html_url":"https://github.com/eclipse-cdt-cloud/vscode-peripheral-inspector","commit_stats":null,"previous_names":["eclipse-cdt-cloud/vscode-svd-viewer","eclipse-cdt-cloud/vscode-peripheral-inspector"],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fvscode-peripheral-inspector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fvscode-peripheral-inspector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fvscode-peripheral-inspector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse-cdt-cloud%2Fvscode-peripheral-inspector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eclipse-cdt-cloud","download_url":"https://codeload.github.com/eclipse-cdt-cloud/vscode-peripheral-inspector/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248094567,"owners_count":21046768,"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":[],"created_at":"2024-12-07T19:07:59.725Z","updated_at":"2025-12-11T21:56:07.784Z","avatar_url":"https://github.com/eclipse-cdt-cloud.png","language":"TypeScript","readme":"# Peripheral Inspector\n\nThis standalone SVD Viewer extension is extracted from [cortex-debug](https://github.com/Marus/cortex-debug) and allows\nyou to view and change on-chip peripheral settings.\n\n## Usage\n\nThe **Peripheral Inspector** displays information about peripheral registers.\n\n![Peripheral Inspector](./media/peripheral-inspector.png)\n\nDepending on the context, the following icons may be visible:\n\n| Icon | Use it to |\n|------|-----------|\n| ![Collapse](./media/CollapseAll.png) | Collapse currently viewed peripherals |\n| ![Search](./media/Search.png) | Open search bar to find specific properties |\n| ![Refresh](./media/Reload.png) | Refresh the current view |\n| ![Export](./media/Export.png) | Export peripheral registers |\n| ![Edit](./media/Edit.png) | Update the register value |\n\n## Specifying SVD Files\n\nThe SVD Viewer extension uses [System View Description](http://www.keil.com/pack/doc/CMSIS/SVD/html/index.html) (SVD) files to display information about the selected part, including the Cortex Peripherals view.\n\nChoose one of the following methods to specify your SVD file in your `launch.json` configuration(s):\n\n### Use the CMSIS pack asset service\n\nSet the `definitionPath` configuration variable to a qualified pack reference in the form `\u003cvendor\u003e::\u003cdevice family pack\u003e@\u003cversion\u003e` e.g.:\n\n```json\n{\n    ...\n    \"definitionPath\": \"NXP::K32L3A60_DFP@15.0.0\"\n    ...\n}\n```\n\nIf the pack supports multiple devices and/or processors, you will be prompted to select these. Alternatively, set them in your configuration using the optional `deviceName` and `processorName` variables:\n\n```json\n{\n    ...\n    \"definitionPath\": \"NXP::K32L3A60_DFP@15.0.0\",\n    \"deviceName\": \"K32L3A60VPJ1A\",\n    \"processorName\": \"cm4\"\n    ...\n}\n```\n\n**TIP:** The pack reference and device name can be automatically derived if you use the [Arm Device Manager extension in VS Code](https://marketplace.visualstudio.com/items?itemName=Arm.device-manager) using these commands:\n\n```json\n{\n    ...\n    \"definitionPath\": \"${command:device-manager.getDevicePack}\",\n    \"deviceName\": \"${command:device-manager.getDeviceName}\"\n    ...\n}\n```\n\n### Install a Cortex Debug Support Pack\n\nFind a [Cortex Debug Support Pack](https://marketplace.visualstudio.com/search?term=Cortex-Debug%3A%20Device%20Support%20Pack\u0026target=VSCode\u0026category=All%20categories\u0026sortBy=Relevance) for your device and install it. You can then specify just the `deviceName` variable in your launch configuration:\n\n```json\n{\n    ...\n    \"deviceName\": \"STM32F439BI\"\n    ...\n}\n```\n\n### Specify the path to your SVD file\n\nYou can obtain an SVD file from a [CMSIS pack](https://developer.arm.com/tools-and-software/embedded/cmsis/cmsis-packs) or from your device manufacturer. For example use [these instructions](https://community.st.com/s/question/0D50X00009XkWDkSAN/how-does-st-manage-svd-files) for ST devices.\n\nOther vendors may ship SVD files when you install their software or device packs or you could write your own custom SVD file.\n\nOnce you have the SVD file, specify the location of it in your `launch.json` using the `definitionPath` variable:\n\n```json\n{\n    ...\n    \"definitionPath\": \"${workspaceFolder}/STM32F103.svd\"\n    ...\n}\n```\n\n### Extending Peripheral Inspector\n\nIt is possible to extend the Peripheral Inspector with new file extension providers in your VSCode extension. This method will provide reading new file formats and load the peripherals information into the Peripheral Inspector.\n\n```json\n{\n    ...\n    \"definitionPath\": \"${workspaceFolder}/STM32F103.\u003ccustomFileExtension\u003e\"\n    ...\n}\n```\n\nFor more details about the implementation, please check the [Extending Peripheral Inspector](./docs/extending-peripheral-inspector.md) document.\n\n## Settings\n\nAll variable key names used to extract data from debug launch configurations can be modified. This allows variable name clashes to be avoided as well as the need to duplicate configuration entries.\n\nThe following list outlines the setting names and default values:\n\n- `peripheral-inspector.definitionPathConfig` - Debug configuration key to use to get the SVD path (default `definitionPath`)\n- `peripheral-inspector.deviceConfig` - Debug configuration key to use to get the device name (default: `deviceName`)\n- `peripheral-inspector.processorConfig` - Debug configuration key to use to get the processor name (default: `processorName`)\n- `peripheral-inspector.packAssetUrl` - Base URL for CMSIS pack assets (default: `https://pack-content.cmsis.io`)\n- `peripheral-inspector.svdAddrGapThreshold`- If the gap between registers is less than this threshold (multiple of 8), combine into a single read from device. -1 means never combine registers and is very slow (default: `0`, means combine but no gaps)\n\nAdditionally the following settings can be used to customize the Peripheral Inspector:\n\n- `peripheral-inspector.saveLayout`- Save layout of peripheral view between sessions (default: `true`)\n- `peripheral-inspector.ignorePeripherals` - List of peripheral names to ignore. They will not show up in the tree view and no values are read from the target system. The user can add variables by using the context menu (**Workspace only**) in the tree view, or by setting them manually in the **User** and **Workspace** preferences.\n\n## Contributing\n\nWe welcome contributions on [GitHub](https://github.com/eclipse-cdt-cloud/vscode-peripheral-inspector).\nCheck our [contribution guidelines](./CONTRIBUTING.md) for more info.\nThis open-source project is part of [Eclipse CDT Cloud](https://eclipse.dev/cdt-cloud/).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipse-cdt-cloud%2Fvscode-peripheral-inspector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feclipse-cdt-cloud%2Fvscode-peripheral-inspector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipse-cdt-cloud%2Fvscode-peripheral-inspector/lists"}