Create a Microsoft IoT Central application

As a builder, you use the Microsoft IoT Central UI to define your Microsoft IoT Central application. This quickstart shows you how to:

  • Create a Microsoft IoT Central application that contains a sample device template and simulated devices.
  • View the features of the Refrigerated Vending Machine device template in your application.
  • View the telemetry and analytics from your simulated Refrigerator devices.

In this quickstart, you view a simulated Refrigerator device from a device template. The simulated device:

  • Sends telemetry, such as temperature and pressure, to your application.
  • Reports device property values, such as a motion alert, to your application.
  • Has device settings, such as fan speed, that you can set in the application.

When you create a simulated device from a device template in a Microsoft IoT Central application, the simulated device enables you to test your application before you connect a real device.

If you don't have an Azure subscription, create a Pay-As-You-Go subscription before you begin. You will not be charged when you create a Microsoft IoT Central free 30-day trial application.

Create the application

To complete this quickstart, you need to create a Microsoft IoT Central application from the Sample Contoso application template.

Navigate to the Microsoft IoT Central Application Manager page. Then enter the email address and password you use to access your Azure subscription:

Enter your organization account

To start creating a new Microsoft IoT Central application, choose New Application:

Microsoft IoT Central Application Manager page

To create a new Microsoft IoT Central application:

  1. Choose a friendly application name, such as Contoso IoT. Microsoft IoT Central generates a unique URL prefix for you. You can change this URL prefix to something more memorable.
  2. Choose an Azure Active Directory and Azure subscription to use. For more information about directories and subscriptions, see Create a Microsoft IoT Central application.
  3. Create a new resource group with a name of your choice. For example, contoso-rg.
  4. Choose the region geographically closest to you.
  5. Choose the Sample Contoso application template.
  6. Choose the Free 30 Day Trial Application payment plan.
  7. Then choose Create.

Microsoft IoT Central Create Application page

When your application is ready, the Homepage of your application displays. Builder mode is off, ready for you to view the application as an operator. The application URL is the URL you specified in the previous step:

Application Builder page

Use the left navigation menu to access the different areas of your new Microsoft IoT Central application:

Left navigation menu

To view the device templates and devices in your application, choose Device Explorer on the left navigation menu. The sample application includes the Refrigerated Vending Machine device template. There are three simulated devices already created from this device template:

Device explorer

View the device template and devices

Use the following steps to view a refrigerator device that was created from the Refrigerated Vending Machine device template. A device template defines:

  • Measurements, such as temperature telemetry, sent from a device.
  • Settings, such as fan speed, that enable you to control the device.
  • Properties, such as serial number, that store information about the device.
  • Rules that enable you to automate actions based on the behavior of the device.
  • A customizable dashboard that displays information about the device.

You can create both simulated and real devices from a device template.

Builder mode

Make sure builder mode is switched off and that you are viewing the application as an operator. To toggle builder mode on and off, choose Builder Mode in the left navigation menu. To navigate to the refrigerator device, choose Refrigerator 1:

Switch off builder mode

Measurements

The Measurements page for the Refrigerator 1 device displays. You can see the list of measurements sent from the simulated device. The page also displays a customizable chart of the visible measurements:

Measurements page

You can toggle the visibility of individual elements and customize the chart. The current chart shows telemetry from a simulated device. If you switch builder mode on, you can add new measurements to the device template.

Note

You may need to wait for a short while before the simulated data appears on the chart.

Settings

Choose Settings. On the Settings page, you can control the device. For example, you can update the fan speed on the refrigerator:

Settings

A setting shows as synced when a device acknowledges the change.

Properties

Choose Properties. On the Properties page, you can:

  • Maintain information about your device, such as the customer name.
  • View property values reported by the device, such as a motion alert.

Properties

Dashboard

Choose Dashboard. The dashboard is a customizable view of information about your device such as measurements, properties, and KPIs:

Dashboard

View analytics

The previous section showed you how to view information about an individual device. You can use device sets and analytics to view consolidated information from multiple devices.

A device set uses a query to dynamically select a set of devices that match a criteria. For example, the Machines in Seattle device set selects refrigerator devices whose location is Seattle. To view the Machines in Seattle device set, choose Device Sets in the left navigation menu, and then choose Machines in Seattle:

Machines in Seattle device set

You can view analytics data for the devices in a device set on the Analytics page:

Analytics for machines in Seattle

Next steps

In this quickstart, you created a pre-populated Microsoft IoT Central application that contains a Refrigerated Vending Machine device template and simulated devices. See Define a new device template in your application to learn more, as a builder, about how to define your own device templates.