Azure Sphere Hardware Definition Tools

This extension makes it easier to validate, create and maintain Hardware Definition files used for Azure Sphere IoT applications.

Installation

Before installing the extension, make sure to have Node.js 14.17+ installed and added to your PATH.

Features

• Hardware Definition Validation
• Pin Mapping Suggestion
• Pin Mapping Generation
• Header Files Generation
• Hardware Definition Files Porting

Diagnostics generated on pin mapping conflicts in hardware definition and application manifest files

The extension provides diagnostics for errors or potential mistakes made in hardware definition files, such as missing imports, duplicate peripheral names, conflicting pin mappings which configure the same pin block differently, and more.

When an app_manifest file with partner applications is detected, you'll get notified about errors (such as peripherals using the same pin across applications) without having to deploy your code to a development board.

Pin mapping suggestion for hardware definition files

When adding Pin Mappings under a Hardware Definition's Peripherals, you can move the cursor behind the Mapping property and press CTRL + SPACE to get suggestions for all available pins that haven't been reserved yet.

Command to generate pin mappings

Add pin mappings automatically by using the Add pin mappings for Hardware Definition File tool from a hardware definition file.

Command to port hardware definition files to different underlying hardware

If you've written a hardware definition file for a given dev board/layout and would like to support another one, you can automatically port your existing hardware definition instead of rewriting it from scratch. You can do so by using the Port to another Hardware Definition tool.

C Header file generation on hardware definition changes

When saving hardware definition files, C header files will be automatically generated through the Azure Sphere CLI.

Acknowledgments

This extension is developed by a team of UCL (University College London) students including Omar Beyhum, Dorin Botan, Denoy Hossain, Tsung-Han Tsai, and Jiachen Weng in collaboration with Microsoft.

Contributions

This extension is open source and maintained under the Azure Sphere Hardware Definition Tools GitHub repository. Suggestions and contributions are more than welcome.