Advantech EIS-D210 User manual

Connect EIS-D210 device to your Azure
IoT services
Table of Contents
Introduction
Prerequisites
Prepare the Device
Integration with Azure IoT Explorer
Additional Links
Introduction
About this document
This document describes how to connect EIS-D210 to Azure IoT Hub using the Azure IoT Explorer
with certified device application and device models.
IoT Plug and Play certified device simplifies the process of building devices without custom device
code. Using Solution builders can integrated quickly using the certified IoT Plug and Play enabled
device based on Azure IoT Central as well as third-party solutions.
This getting started guide provides step by step instruction on getting the device provisioned to Azure
IoT Hub using Device Provisioning Service (DPS) and using Azure IoT Explorer to interact with
device's capabilities.
Prerequisites
You should have the following items ready before beginning the process:
Azure Account
Azure IoT Hub Instance

Azure IoT Hub Device Provisioning Service
Azure IoT Public Model Repository
Prepare the Device.
Hardware
Prepare EIS-D210 and connect with Power, HDMI, Ethernet.
Note: If you need any other information please reference the link.
https://advdownload.advantech.com/productfile/Downloadfile5/1-1XX2XSX/ARK-
1124_User_Manual_Ed.1-FINAL.pdf
Set up a DPS
1. Follow the commands to create a Resource Group、an Iot Hub and a Device Provisioning
Service
2. Get the connection string for the IoT hub and place it into a variable .
3. Link the IoT hub and the provisioning service
4. Get ID Scope
Copy the ID Scope key.
az group create --name my-sample-resource-group --location centralus
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location
az iot dps create --name my-test-dps --resource-group my-sample-resource-group --location ce
$hubConnectionString=$(az iot hub show-connection-string --name my-sample-hub --key primary
az iot dps linked-hub create --dps-name my-test-dps --resource-group my-sample-resource-grou

5. Create a device enrollment entry in the portal
Sign in to the Azure portal, select the All resources button on the left-hand menu and open
your Device Provisioning service.
Select the Manage enrollments tab, and then select the Add individual enrollment button
at the top.
In the Add Enrollment panel, enter the following information, and press the Save button.
Mechanism: Select Symmetric Key as the identity attestation Mechanism.
Auto-generate keys: Check this box.
Registration ID: Enter a registration ID to identify the enrollment. Use only lowercase
alphanumeric and dash ('-') characters. For example, symm-key-device.
IoT Hub Device ID: Enter a device identifier. For example, symm-key-device.
Copy the Primary Key and Registration ID

Software
1. Install Visual Studio. You can use the Visual Studio Community Free download if you meet the
licensing requirements. (Visual Studio 2015 is also supported.)
Be sure to include Desktop development with C++ and NuGet Package Manager from the
Visual Studio Installer.
2. Install git. Confirm git is in your PATH by typing git version from a command prompt.
3. Install CMake. Make sure it is in your PATH by typing cmake -version from a command prompt.
CMake will be used to create Visual Studio projects to build libraries and samples.
4. Clone the the SDK to your local machine using the refresh-preview branch
git clone --recursive --single-branch --branch refresh-preview [email protected]:ADVANTECH-Corp

The --recursive argument instructs git to clone other GitHub repos this SDK depends on.
Dependencies are listed here.
5. In the same azure-iot-sdk-c-pnp-SUSI-AllDevice folder, create a folder to contain the compiled
app.
mkdir cmake
cd cmake
6. In the cmake folder you just created, run CMake to build the entire folder of Device SDK including
the generated app code.
cmake ..
cmake --build . -- /m /p:Configuration=Release
7. Once the build has succeeded, you can test it by invoking the following command.
Integration with Azure IoT Explorer
Connect
Enter the connection string from Azure CLI and press Save. You will see a device symm-key-
device
az iot hub show-connection-string --name my-sample-hub --key primary --query connectionString -o tsv
Telemetry
Release\\PNP_SUSI.exe "EIS_D210" "1" {dps ID Scope} {dps Registration ID} {dps Primary Key}

Press the device name and choose the Telemetry Page. Press Start and wait a momnent. You will
see the telemetry data on the screen.
Property and Command
You can press the item in the green rectangle to show the properties.
You can press the item in the blue rectangle to start a command.
In the command using, you can type some number to try the GPIO interface.

Additional Links
Please refer to the below link for additional information for Plug and Play

Manage cloud device messaging with Azure-IoT-Explorer
Import the Plug and Play model
Configure to connect to IoT Hub
How to use IoT Explorer to interact with the device