Edit

Share via

Quickstart - Use your smartphone as a device to send telemetry to an IoT Central application

  • Article

In this quickstart, you create an Azure IoT Central application and connect your first device. To get you started quickly, you install an app on your smartphone to act as the device. The app sends telemetry, reports properties, and responds to commands:

Overview of quickstart scenario connecting a smartphone app to IoT Central.

In this quickstart, you:

  • Create an IoT Central application.
  • Register a new device in the application.
  • Connect a device to the application and view the telemetry it sends.
  • Control the device from your application.

Prerequisites

  • An Azure account with an active subscription. Create an account for free.

    You should have at least Contributor access in your Azure subscription. If you created the subscription yourself, you're automatically an administrator with sufficient access. To learn more, see What is Azure role-based access control?.

  • An Android or iOS smartphone on which you're able to install a free app from one of the official app stores.

Create an application

IoT Central provides various industry-focused application templates to help you get started. This quickstart uses the Custom application template to create an application from scratch:

  1. Navigate to the Create IoT Central Application page in the Azure portal. If prompted, sign in with your Azure account.

  2. Enter the following information:

    Field Description
    Subscription The Azure subscription you want to use.
    Resource group The resource group you want to use. You can create a new resource group or use an existing one.
    Resource name A valid Azure resource name such as my-contoso-app.
    Application URL A URL subdomain for your application such as my-contoso-app. The URL for an IoT Central application looks like https://my-contoso-app.azureiotcentral.com.
    Template Custom application
    Region The Azure region you want to use.
    Pricing plan Standard 2

  3. Select Review + create. Then select Create.

When the app is ready, you can navigate to it from the Azure portal:

Screenshot that shows the IoT Central application resource in the Azure portal. The application URL is highlighted.

To learn more, see Create an Azure IoT Central application.

Register a device

To connect a device to your IoT Central application, you need some connection information. An easy way to get this connection information is to register your device.

To register your device:

  1. In IoT Central, navigate to the Devices page and select Add a device:

    Screenshot that shows create a device in IoT Central.

  2. On the Create a new device page, accept the defaults, and then select Create.

  3. In the list of devices, click on the device name:

    A screenshot that shows the highlighted device name that you can select.

  4. On the device page, select Connect and then QR Code:

    Screenshot that shows the QR code you can use to connect the smartphone app.

Keep this page open. In the next section, you scan this QR code using the smartphone app to connect it to IoT Central.

Tip

The QR code contains the information, such as the registered device ID, that your device needs to establish a connection to your IoT Central application. It saves you from the need to enter the connection information manually.

Connect your device

To get you started quickly, this article uses the IoT Plug and Play smartphone app as an IoT device. The app sends telemetry collected from the smartphone's sensors, responds to commands invoked from IoT Central, and reports property values to IoT Central.

Install the app on your smartphone from one of the app stores:

Get the app for your Android phone on Google Play. Download the app for your phone from the App Store.

To connect the IoT Plug and Play app to your Iot Central application:

  1. Open the IoT PnP app on your smartphone.

  2. On the welcome page, select Scan QR code. Point the smartphone's camera at the QR code. Then wait for a few seconds while the connection is established.

  3. On the telemetry page in the app, you can see the data the app is sending to IoT Central. On the logs page, you can see the device connecting and several initialization messages.

To view the telemetry from the smartphone app in IoT Central:

  1. In IoT Central, navigate to the Devices page.

  2. In the list of devices, click on the device name, then select Overview:

    Screenshot of the overview page with telemetry plots.

Tip

The smartphone app only sends data when the screen is on.

Control your device

To send a command from IoT Central to your device, select the Commands view for your device. The smartphone app can respond to three commands:

Screenshot that shows the three commands the smartphone app responds to.

To make the light on your smartphone flash, use the LightOn command. Set the duration to three seconds, the pulse interval to five seconds, and the number of pulses to two. Select Run to send the command to the smartphone app. The light on your smartphone app flashes twice.

To see the acknowledgment from the smartphone app, select command history.

Clean up resources

If you don't plan to complete any further IoT Central quickstarts or tutorials, you can delete your IoT Central application:

  1. In your IoT Central application, navigate to Application > Management.
  2. Select Delete and then confirm your action.

Next step

In this quickstart, you created an IoT Central application and connected device that sends telemetry. Then you used a smartphone app as the IoT device that connects to IoT Central. Here's the suggested next step to continue learning about IoT Central:

Add a rule to your IoT Central application