Renesas DA16200 PMOD User manual

User Manual
DA16200 Getting Started with
Azure® IoT
UM-WI-058
Abstract
The focus of this document is to introduce a door-lock example for Azure® IoT. This is a reference
design which includes the Azure® IoT Application. This reference design provides the user an
experience using the Azure® IoT Android/iOS Application.

User Manual
Revision 1.0
27-May-2022
CFR0012
2 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
Contents
Abstract................................................................................................................................................ 1
Contents............................................................................................................................................... 2
Figures.................................................................................................................................................. 3
Tables ................................................................................................................................................... 4
1Terms and Definitions................................................................................................................... 5
2References..................................................................................................................................... 5
3Demonstration Environment........................................................................................................ 6
3.1 Demonstration Prerequisites................................................................................................. 6
4Azure IoT Hub Setup..................................................................................................................... 7
4.1 Azure Account and Portal.....................................................................................................7
4.2 Azure Services...................................................................................................................... 7
4.3 Azure Service Configuration for IoT......................................................................................8
4.3.1 Creating a Resource Group................................................................................... 8
4.3.2 Create IoT Hub.................................................................................................... 11
4.3.3 Create Devices.................................................................................................... 16
5Symbols Configuration in Eclipse for the DA16200 SDK........................................................ 19
6Configuring the Azure IoT Hub and the DA16200.................................................................... 22
7Verify the Connection Between Azure IoT Hub and DA16200.............................................. 25
8Testing the DA16200 Door-Lock................................................................................................ 28
8.1 Open Door........................................................................................................................... 28
8.2 Close Door..........................................................................................................................30
8.3 OTA Update........................................................................................................................32
8.4 Mobile App UI...................................................................................................................... 33
9OTA Update.................................................................................................................................. 34
9.1 Create a Storage Account................................................................................................... 34
9.2 Create a Container.............................................................................................................. 38
9.3 Upload a DA16200 Image File............................................................................................ 40
9.4 Add the OTA URL to the Device Twin ................................................................................ 42
9.5 Execute OTA Update.......................................................................................................... 47
Appendix A Using the Azure IoT Hub Device Provisioning Service............................................ 48
A.1 Create the Azure IoT Hub Device Provisioning Service..................................................... 48
A.2 Manage Enrollments...........................................................................................................52
A.3 Configure the REGISTRATION ID Parameters in the DA16200 SDK................................ 53
Revision History................................................................................................................................ 56

User Manual
Revision 1.0
27-May-2022
CFR0012
3 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
Figures
Figure 1: Architecture of Azure for IoT.................................................................................................. 6
Figure 2: Azure Portal Services............................................................................................................. 7
Figure 3: Azure IoT Service Configuration............................................................................................ 8
Figure 4: Create a Resource................................................................................................................. 8
Figure 5: Resource Group..................................................................................................................... 9
Figure 6: New Resource Group............................................................................................................. 9
Figure 7: Adding Data for Resource Group......................................................................................... 10
Figure 8: Create Resource Group....................................................................................................... 10
Figure 9: Go to Resource Group......................................................................................................... 11
Figure 10: Created Resource Group................................................................................................... 11
Figure 11: Create Resources.............................................................................................................. 12
Figure 12: IoT Hub............................................................................................................................... 12
Figure 13: Create in IoT Hub............................................................................................................... 13
Figure 14: Next Networking................................................................................................................. 13
Figure 15: Next Management.............................................................................................................. 14
Figure 16: IoT Hub Management Menu .............................................................................................. 14
Figure 17: Created IoT Hub Configuration.......................................................................................... 15
Figure 18: Completed IoT Hub Deployment........................................................................................ 15
Figure 19: Generated IoT Hub Web Page........................................................................................... 16
Figure 20: Devices............................................................................................................................... 16
Figure 21: Add Devices....................................................................................................................... 17
Figure 22: Save Devices ..................................................................................................................... 17
Figure 23: Device Registered in the Azure IoT Server........................................................................ 18
Figure 24: da16200_azure SDK Properties ........................................................................................ 19
Figure 25: Paths and Symbols............................................................................................................ 20
Figure 26: Apply Symbols.................................................................................................................... 20
Figure 27: Azure IoT Hub Device ID ................................................................................................... 22
Figure 28: Azure IoT Hub Device Primary Key ................................................................................... 22
Figure 29: Azure IoT Hub Hostname................................................................................................... 23
Figure 30: Azure IoT Hub Connection-String...................................................................................... 23
Figure 31: Azure IoT Hub.................................................................................................................... 26
Figure 32: Azure IoT Hub Device ID ................................................................................................... 26
Figure 33: Azure IoT Hub Device Twin ............................................................................................... 27
Figure 34: Items in Azure Device Twin................................................................................................ 27
Figure 35: Block Diagram for Opening a Door.................................................................................... 28
Figure 36: Open Door in the App ........................................................................................................ 29
Figure 37: Device Twin When Door Is Open....................................................................................... 29
Figure 38: Block Diagram for Closing a Door...................................................................................... 30
Figure 39: Close the Door in the App.................................................................................................. 30
Figure 40: Device Twin When Door Is Closed .................................................................................... 31
Figure 41: Block Diagram for OTA Update.......................................................................................... 32
Figure 42: OTA Update Operation ...................................................................................................... 32
Figure 43: Android Application Screenshots....................................................................................... 33
Figure 44: Storage Accounts............................................................................................................... 34
Figure 45: Create Storage Account..................................................................................................... 35
Figure 46: Configure Storage Account................................................................................................ 35
Figure 47: Storage Account Validation Done...................................................................................... 36
Figure 48: Storage Account Deployment Done................................................................................... 36
Figure 49: Created Storage Account................................................................................................... 37
Figure 50: Containers in Storage Account .......................................................................................... 38
Figure 51: Add Container .................................................................................................................... 38
Figure 52: Container Details................................................................................................................ 39
Figure 53: Created Container.............................................................................................................. 39
Figure 54: Container for Uploading the Image.................................................................................... 40
Figure 55: Upload Image..................................................................................................................... 40
Figure 56: Navigate to the Image........................................................................................................ 41
Figure 57: Uploaded Image................................................................................................................. 41

User Manual
Revision 1.0
27-May-2022
CFR0012
4 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
Figure 58: Copy Image URL................................................................................................................ 42
Figure 59: Add Device Configuration .................................................................................................. 42
Figure 60: Name and Label Section.................................................................................................... 43
Figure 61: Create Configuration.......................................................................................................... 44
Figure 62: Target Devices Section...................................................................................................... 45
Figure 63: Review + Create Section.................................................................................................... 46
Figure 64: Created Device Twin Configuration ................................................................................... 46
Figure 65: OTA Process of Android Mobile App ................................................................................. 47
Figure 66: DA16200 Device (EVK) OTA Process............................................................................... 47
Figure 67: Azure IoT Hub Device Provisioning Service...................................................................... 48
Figure 68: Create DPS........................................................................................................................ 48
Figure 69: Configure the Resource group, Name and Region............................................................ 49
Figure 70: Create Button..................................................................................................................... 49
Figure 71: Go to Resource.................................................................................................................. 50
Figure 72: Linked IoT Hubs................................................................................................................. 50
Figure 73: Add Link to the Azure IoT Hub........................................................................................... 51
Figure 74: Configure the Link.............................................................................................................. 51
Figure 75: IoT Hub Linked to the DPS ................................................................................................ 52
Figure 76: Manage Enrollments.......................................................................................................... 52
Figure 77: Add Enrollment................................................................................................................... 53
Figure 78: Individual Enrollments........................................................................................................ 53
Figure 79: DPS Registration ID........................................................................................................... 54
Figure 80: Primary Key of the DPS Registration ID............................................................................ 54
Figure 81: ID Scope of the DPS.......................................................................................................... 55
Figure 82: DPS Device is Registered.................................................................................................. 55
Tables
Table 1: Feature Option Map............................................................................................................... 21
Table 2: DPM Thread Feature............................................................................................................. 21
Table 3: Sleep 2 Mode Feature........................................................................................................... 21
Table 4: DPS Feature.......................................................................................................................... 21

User Manual
Revision 1.0
27-May-2022
CFR0012
5 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
1 Terms and Definitions
AP Access Point
ADB Android Debug Bridge
API Application Programming Interface
Azure Microsoft Web Services
CFG CONFIGURE
CMD COMMAND
DPM Dynamic Power Management
DTIM Delivery Traffic Indication Map
EVB Evaluation Board
IoT Internet of Things
MCU Micro-Controller Unit
OTA Over-The-Air
RTC Real-Time Clock
SDK Software Development Kit
TIM Traffic Indication MAP
TSL Transport Layer Security
NVRAM Non-Volatile Random Access Memory
DPS Device Provisioning Service
2 References
[1] UM-WI-056-DA16200_DA16600_FreeRTOS_Getting_Started_Guide
[2] UM-WI-042-DA16200_Provisioning_the_Mobile_App

User Manual
Revision 1.0
27-May-2022
CFR0012
6 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
3 Demonstration Environment
This example will demonstrate how to use a mobile application to control a door-lock application
running on a DA16200 via an Internet connection and the Microsoft Azure IoT server.
Figure 1: Architecture of Azure for IoT
3.1 Demonstration Prerequisites
●EVK: DA16200, DA16200MOD
●Router: Connection to internet
●Mobile device: Android application
●Azure account: Free account

User Manual
Revision 1.0
27-May-2022
CFR0012
7 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
4 Azure IoT Hub Setup
A Microsoft Azure account is required to test the door-lock example. If an account is not available, a
free account can be created and used for this demonstration. This section provides instructions on
how to configure Azure IoT Hub to connect to the DA16200 IoT device.
4.1 Azure Account and Portal
To create an Azure account, do the following:
1. Go to the https://azure.microsoft.com/.
2. Create an Azure account and sign in.
3. Go to Microsoft Azure Portal to use Azure services. (https://azure.microsoft.com/en-
us/features/azure-portal/)
4.2 Azure Services
The Azure Portal provides a list of Azure services as shown in Figure 2.
Figure 2: Azure Portal Services

User Manual
Revision 1.0
27-May-2022
CFR0012
8 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
4.3 Azure Service Configuration for IoT
Azure offers a variety of services of which three are required to connect a device to the Azure IoT
server as shown in Figure 3.
●Resource groups
●IoT Hub
●Devices
Figure 3: Azure IoT Service Configuration
4.3.1 Creating a Resource Group
A resource group must be created to register an IoT Hub resource.
1. In Azure services, click Create a resource.
Figure 4: Create a Resource

User Manual
Revision 1.0
27-May-2022
CFR0012
9 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
2. Search and click Resource group.
Figure 5: Resource Group
3. Click Create to create a new resource group.
Figure 6: New Resource Group

User Manual
Revision 1.0
27-May-2022
CFR0012
10 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
4. Add the resource group name and select the region, and then click Review + create to accept
the configuration.
Figure 7: Adding Data for Resource Group
5. Click Create.
Figure 8: Create Resource Group

User Manual
Revision 1.0
27-May-2022
CFR0012
11 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
6. Click Go to resource group.
Figure 9: Go to Resource Group
The resource group is completed.
Figure 10: Created Resource Group
4.3.2 Create IoT Hub
IoT Hub includes Azure IoT devices and the devices are connected to the DA16200 devices. To
create IoT devices, IoT Hub should be created.

User Manual
Revision 1.0
27-May-2022
CFR0012
12 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
To create IoT Hub:
1. In the created resource group, click Create resources.
Figure 11: Create Resources
2. In Create a resource menu, search and click IoT Hub.
Figure 12: IoT Hub

User Manual
Revision 1.0
27-May-2022
CFR0012
13 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
3. In IoT Hub menu, click Create.
Figure 13: Create in IoT Hub
4. In the Basics menu, add the IoT hub name and select a region, and then click Next:
Networking.
Figure 14: Next Networking

User Manual
Revision 1.0
27-May-2022
CFR0012
14 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
5. In IoT Hub Networking menu, click Next: Management.
Figure 15: Next Management
6. In the IoT Hub Management menu, select Pricing and scale tier, and then click
Review+create.
Figure 16: IoT Hub Management Menu

User Manual
Revision 1.0
27-May-2022
CFR0012
15 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
7. Once the IoT hub configuration is created, click Create.
Figure 17: Created IoT Hub Configuration
8. After IoT hub deployment is completed, click Go to resource.
Figure 18: Completed IoT Hub Deployment

User Manual
Revision 1.0
27-May-2022
CFR0012
16 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
The generated IoT hub web page appears.
Figure 19: Generated IoT Hub Web Page
4.3.3 Create Devices
The Azure IoT Hub devices should be created for connection of DA16200 devices.
To create devices:
1. In the created IoT Hub, click Devices.
Figure 20: Devices
2. In Devices menu, click Add Device.

User Manual
Revision 1.0
27-May-2022
CFR0012
17 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
Figure 21: Add Devices
3. Add the desired Device ID, and then click Save.
Figure 22: Save Devices
4. The device to be used is registered in the Azure IoT server.

User Manual
Revision 1.0
27-May-2022
CFR0012
18 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
Figure 23: Device Registered in the Azure IoT Server

User Manual
Revision 1.0
27-May-2022
CFR0012
19 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
5 Symbols Configuration in Eclipse for the DA16200 SDK
The DA16200 firmware image is created using the Eclipse IDE and the DA16200 SDK. For
instruction on how to set up Eclipse IDE and the DA16200 SDK, see Section 5 of Ref [1].
To build the DA16200 SDK image for Azure IoT, several symbols must be defined in Eclipse.
●__SUPPORT_AZURE_IOT_ (mandatory)
●SUPPORT_DPM_THREAD
●ENABLE_AZURE_SLEEP_2_MODE
●ENABLE_AZURE_DPS_EXAMPLE
To configure symbols in Eclipse for the DA16200 SDK:
1. In Eclipse, open da16200_azure SDK and click Properties.
Figure 24: da16200_azure SDK Properties

User Manual
Revision 1.0
27-May-2022
CFR0012
20 of 58
© 2022 Renesas Electronics
UM-WI-058
DA16200 Getting Started with Azure® IoT
2. Go to Paths and Symbols > GNU C >Symbols.
Figure 25: Paths and Symbols
3. To build an image, select the Symbols that user wants, and then click Apply and Close.
Figure 26: Apply Symbols