Use peripherals in a high-level application

High-level applications can map peripherals for their exclusive use. To use one or more peripherals in a high-level application:

• Add the peripheral to the application manifest.
• Add an interrupt handler (if required) and other supporting code to the application.
• Add code to ensure that each peripheral will be in a known good state on start up.

All resources that a high-level app uses must be specified in the application manifest. In a high-level app, you can use either the name for the resource that is assigned to AppManifestValue in the hardware definition JSON file for the target chip or the high-level name assigned to the resource in the hardware definition header file. For example, to find the value to identify I2C on ISU0 on MT3620 hardware, look in the the mt3620.json file in the HardwareDefinitions folder that is installed in the Microsoft Azure Sphere SDK folder. This peripheral is defined as follows in the JSON file:

 {"Name": "MT3620_ISU0_I2C", "Type": "I2cMaster", "MainCoreHeaderValue": "(0)", "AppManifestValue": "ISU0", "Comment": "MT3620 ISU 0 configured as I2C"},

Note that the value assigned to AppManifestValue for the I2C peripheral is "ISU0", while the high-level name is "MT3620_ISU0_I2C".

Concurrently loaded applications cannot share resources; resource use is exclusive to a single application. The Azure Sphere OS performs several important tasks when it loads the application:

• Configures multiplexing, so that the pins associated with the peripheral are configured for the requested functionality.
• Sets up core mapping, which involves configuring firewalls so that the application has access to the registers associated with the requested peripherals.
• Checks the manifest and fails to load the application if it claims resources that have already been claimed by another app.

The remainder of this section provides details about using specific peripherals.