Renesas DA16200 PMOD User manual

User Manual
DA16200 DA16600 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.4
Jan. 26, 2024
CFR0012
2 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Contents
Abstract................................................................................................................................................ 1
Contents............................................................................................................................................... 2
Figures.................................................................................................................................................. 4
1Terms and Definitions................................................................................................................... 6
2References..................................................................................................................................... 6
3Azure IoT Hub................................................................................................................................ 7
3.1 Azure Services...................................................................................................................... 7
3.2 Azure IoT Hub Setup............................................................................................................. 7
3.2.1 Create Azure Account............................................................................................ 7
3.2.2 Create Resource Group......................................................................................... 8
3.2.3 Create IoT Hub ....................................................................................................11
3.2.4 Register Devices..................................................................................................15
3.3 Configure Azure IoT Hub .................................................................................................... 17
3.4 Verify Connection Between Azure IoT Hub and DA16200/DA16600.................................20
4Door Lock Reference Application ............................................................................................. 25
4.1 Reference Application in DA16200/DA16600.....................................................................25
4.1.1 Open Door ........................................................................................................... 26
4.1.2 Close Door...........................................................................................................28
4.2 Reference Application in Host MCU ................................................................................... 30
4.2.1 Download Package for Door Lock Reference Application in Host MCU............. 30
4.2.2 Hardware Connections between DA16200/DA16600 and Host MCU ................ 31
4.2.3 Programming Firmware Images for DA16200/DA16600..................................... 35
4.2.4 Configure Components for Testing......................................................................36
4.2.5 Test without Host MCU........................................................................................38
4.2.6 Test with Host MCU............................................................................................. 38
4.3 Mobile App Demo................................................................................................................ 44
4.3.1 Open Door ........................................................................................................... 45
4.3.2 Close Door........................................................................................................... 48
5OTA Update.................................................................................................................................. 51
5.1 Create Storage Account...................................................................................................... 51
5.2 Create Container................................................................................................................. 53
5.3 Upload Firmware Image File...............................................................................................55
5.4 Add OTA URL to Device Twin ............................................................................................ 58
5.5 OTA Update of MCU Firmware........................................................................................... 63
Appendix A Azure IoT Hub Device Provisioning Service.............................................................. 65
A.1 Create Azure IoT Hub .........................................................................................................65
A.2 Manage Enrollments...........................................................................................................69
A.3 Configure Registration ID Parameters in DA16200/DA16600 SDK ................................... 70
Appendix B Azure IoT AT Command List ....................................................................................... 73
B.1 Operating Modes................................................................................................................. 73
B.1.1 Setting Mode........................................................................................................73
B.1.2 Provisioning Mode ............................................................................................... 73
B.1.3 Communication Mode.......................................................................................... 74

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
3 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
B.2 How to Report Topic and Update Device Twin...................................................................74
B.2.1 Configure Device Twin Topic............................................................................... 74
B.3 AT Command List ............................................................................................................... 75
B.3.1 Basic Set..............................................................................................................75
B.3.2 TLS Certificate.....................................................................................................76
B.3.3 PIN MUX.............................................................................................................. 76
B.3.4 Configure Data as Topics.................................................................................... 77
B.3.5 Command –MCU to DA16200/DA16600............................................................ 78
B.3.6 Command –DA16200/DA16600 to MCU............................................................ 78
B.3.7 DA16200/DA16600 Status –DA16200/DA16600 to MCU.................................. 78
Appendix C Troubleshooting ........................................................................................................... 80
C.1 Operational Issue................................................................................................................80
Revision History ................................................................................................................................ 81

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
4 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Figures
Figure 1: Azure Services....................................................................................................................... 7
Figure 2: Azure IoT Service Configuration ............................................................................................ 7
Figure 3: Create a Resource................................................................................................................. 8
Figure 4: Resource Group..................................................................................................................... 8
Figure 5: New Resource Group............................................................................................................. 9
Figure 6: Adding Data for Resource Group........................................................................................... 9
Figure 7: Create Resource Group.......................................................................................................10
Figure 8: Go to Resource Group.........................................................................................................10
Figure 9: Created Resource Group.....................................................................................................11
Figure 10: Create Resources .............................................................................................................. 11
Figure 11: Select IoT Hub....................................................................................................................12
Figure 12: Create IoT Hub................................................................................................................... 12
Figure 13: Next Networking................................................................................................................. 13
Figure 14: Next Management..............................................................................................................13
Figure 15: IoT Hub Management ........................................................................................................ 14
Figure 16: Review IoT Hub Configuration ........................................................................................... 14
Figure 17: Completed IoT Hub Deployment........................................................................................15
Figure 18: Generated IoT Hub Web Page...........................................................................................15
Figure 19: Add Devices....................................................................................................................... 16
Figure 20: Add Devices (Continued) ................................................................................................... 16
Figure 21: Save Devices ..................................................................................................................... 17
Figure 22: Device Registered in Azure IoT Server.............................................................................. 17
Figure 23: Device ID Registered in Azure IoT Hub............................................................................. 18
Figure 24: Primary Key with Device ID................................................................................................ 18
Figure 25: Hostname in Azure IoT Hub............................................................................................... 19
Figure 26: Connection String for Azure IoT Hub................................................................................. 19
Figure 27: Azure IoT Hub.................................................................................................................... 22
Figure 28: Select Device ID.................................................................................................................23
Figure 29: Device Twin in Azure IoT Hub............................................................................................ 23
Figure 30: Items in Azure Device Twin................................................................................................24
Figure 31: Structure of Azure IoT........................................................................................................25
Figure 32: Open Azure IoT on Mobile Device..................................................................................... 26
Figure 33: Azure IoT on Mobile Device...............................................................................................26
Figure 34: Message Flows of Opening Door....................................................................................... 27
Figure 35: Opening Door on Mobile App............................................................................................. 27
Figure 36: Device Twin When Door Is Open....................................................................................... 28
Figure 37: Message Flows of Closing Door ........................................................................................ 28
Figure 38: Closing Door on Mobile App ..............................................................................................29
Figure 39: Device Twin When Door Is Closed ....................................................................................29
Figure 40: Azure IoT Using Firmware Images for AT Commands and Host MCU ............................. 30
Figure 41: Hardware Configuration ..................................................................................................... 31
Figure 42: Default UART HW Connection...........................................................................................32
Figure 43: Sample Example of UART1 Connection............................................................................33
Figure 44: HW Connection for Waking up DA16200/DA16600...........................................................33
Figure 45: Default Pin Configuration for Waking Up Host MCU.......................................................... 34
Figure 46: Another Pin Configuration for Waking up Host MCU......................................................... 34
Figure 47: Factory Reset Button on DA16200 EVB............................................................................ 35
Figure 48: Factory Reset Button on DA16600 EVB............................................................................ 35
Figure 49: e2studio Project File ...........................................................................................................39
Figure 50: FSP Configuration..............................................................................................................39
Figure 51: Thingname/Primarykey/Hostname/IotHub Connection String ........................................... 40
Figure 52: Build Project....................................................................................................................... 40
Figure 53: Debug Configurations ........................................................................................................41
Figure 54: Set Debug Configurations..................................................................................................41
Figure 55: Message Flow of Opening Door.........................................................................................45
Figure 56: Operation of Opening Door in App..................................................................................... 45
Figure 57: Device Twin When Door is Opened................................................................................... 46

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
5 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Figure 58: Message Flows of Closing Door ........................................................................................ 48
Figure 59: Operation of Closing Door in App ...................................................................................... 48
Figure 60: Device Twin When Door is Closed..................................................................................... 49
Figure 61: Storage Accounts...............................................................................................................51
Figure 62: Create Storage Account..................................................................................................... 51
Figure 63: Configure Storage Account................................................................................................52
Figure 64: Storage Account Validation Done......................................................................................52
Figure 65: Storage Account Deployment Done...................................................................................53
Figure 66: Created Storage Account................................................................................................... 53
Figure 67: Containers in Storage Account ..........................................................................................54
Figure 68: Add Container .................................................................................................................... 54
Figure 69: Container Details................................................................................................................55
Figure 70: Created Container.............................................................................................................. 55
Figure 71: Container for Uploading Images ........................................................................................56
Figure 72: Upload Image..................................................................................................................... 56
Figure 73: Navigate to Image.............................................................................................................. 57
Figure 74: Uploaded Image................................................................................................................. 57
Figure 75: Copy Container URL..........................................................................................................58
Figure 76: Add Device Configuration .................................................................................................. 58
Figure 77: Name and Label Section....................................................................................................59
Figure 78: Create Configuration..........................................................................................................60
Figure 79: Target Devices Section......................................................................................................61
Figure 80: Review + Create Section.................................................................................................... 61
Figure 81: Created Device Twin Configuration ...................................................................................62
Figure 82: OTA Update Operation ...................................................................................................... 62
Figure 83: Message Flows of OTA Update ......................................................................................... 63
Figure 84: OTA Process in DA16200/DA16600.................................................................................. 63
Figure 85: Block Diagram of MCU OTA.............................................................................................. 64
Figure 86: Azure IoT Hub Device Provisioning Service ......................................................................65
Figure 87: Create DPS........................................................................................................................ 65
Figure 88: Configure Resource Group, Name, and Region................................................................ 66
Figure 89: Create Button..................................................................................................................... 66
Figure 90: Go to Resource.................................................................................................................. 67
Figure 91: Linked IoT Hubs.................................................................................................................67
Figure 92: Add Link to Azure IoT Hub.................................................................................................68
Figure 93: Configure Link.................................................................................................................... 68
Figure 94: IoT Hub Linked to DPS ...................................................................................................... 69
Figure 95: Manage Enrollments .......................................................................................................... 69
Figure 96: Add Enrollment................................................................................................................... 70
Figure 97: Individual Enrollments........................................................................................................70
Figure 98: DPS Registration ID........................................................................................................... 71
Figure 99: Primary Key of DPS Registration ID ..................................................................................71
Figure 100: ID Scope of DPS.............................................................................................................. 72
Figure 101: Registered DPS Device ................................................................................................... 72
Figure 102: Setting Mode.................................................................................................................... 73
Figure 103: Provisioning Mode............................................................................................................ 74
Figure 104: Communication Mode ......................................................................................................74
Figure 105: Communication from MCU to Phone ...............................................................................75

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
6 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 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, User Manual, Renesas
Electronics
[2] UM-WI-042, DA16200 DA16600 Provisioning Mobile App, User Manual, Renesas Electronics

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
7 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
3 Azure IoT Hub
A Microsoft Azure account is required to run the door lock reference application. This section
provides how to configure Azure IoT Hub for communicating with the DA16200/DA16600 IoT device.
3.1 Azure Services
The Azure Portal provides various services including IoT as shown in Figure 1.
Figure 1: Azure Services
3.2 Azure IoT Hub Setup
To connect a device to the Azure IoT server, the following components are required. This section
describes how to set up requirements before using Azure IoT Hub.
●Azure account
●Resource groups
●IoT Hub
●Devices
Figure 2: Azure IoT Service Configuration
3.2.1 Create Azure Account
To create an Azure account, follow the steps below:

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
8 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
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).
3.2.2 Create Resource Group
To register an IoT Hub resource, a resource group should be created.
1. In Azure services, click Create a resource.
Figure 3: Create a Resource
2. Search and click Resource group.
Figure 4: Resource Group
3. Click Create to create a new resource group.

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
9 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Figure 5: New Resource Group
4. Add a resource group name and select a region, and then click Review + create to accept the
configuration.
Figure 6: Adding Data for Resource Group
5. Click Create.

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
10 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Figure 7: Create Resource Group
6. Click Go to resource group.
Figure 8: Go to Resource Group
The newly created resource group is displayed.

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
11 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Figure 9: Created Resource Group
3.2.3 Create IoT Hub
Azure IoT Hub is a managed service that acts as a central message hub for communication between
IoT applications and IoT devices that are connected to the DA16200/DA16600. IoT Hub should be
created before creating IoT devices.
To create IoT Hub:
1. In the created resource group, click Create resources.
Figure 10: Create Resources
2. In Create a resource menu, search and click IoT Hub.

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
12 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Figure 11: Select IoT Hub
3. In IoT Hub menu, click Create.
Figure 12: Create IoT Hub
4. In the Basics menu, add the IoT hub name and select a region, and then click Next:
Networking.

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
13 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Figure 13: Next Networking
5. In IoT Hub Networking menu, click Next: Management.
Figure 14: Next Management
6. In the IoT Hub Management menu, select Pricing and scale tier, and then click
Review+create.

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
14 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Figure 15: IoT Hub Management
7. Review the items displayed in the Review + Create menu, and click Create.
Figure 16: Review IoT Hub Configuration

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
15 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
8. After IoT hub deployment is completed, click Go to resource.
Figure 17: Completed IoT Hub Deployment
The generated IoT hub web page appears.
Figure 18: Generated IoT Hub Web Page
3.2.4 Register Devices
IoT devices should be added to Azure IoT Hub.
To add devices:
1. In the created IoT Hub, click Devices.

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
16 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Figure 19: Add Devices
2. In Devices menu, click Add Device.
Figure 20: Add Devices (Continued)

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
17 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
3. Add the desired Device ID, and then click Save.
Figure 21: Save Devices
4. The device is registered in the Azure IoT server.
Figure 22: Device Registered in Azure IoT Server
3.3 Configure Azure IoT Hub
The Azure IoT Hub requires several parameters to be configured. These parameters are used for
connecting DA16200/DA16600 device and must be set in the parameter of DA16200/DA16600. The
Azure IoT Hub and DA16200/DA16600 need to be connected for data communication.
Configure parameters of Azure IoT Hub:
●Device ID: ID registered in Azure IoT Hub

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
18 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
Figure 23: Device ID Registered in Azure IoT Hub
●Device-Primary-Key: Primary key with device ID registered in Azure IoT Hub
Figure 24: Primary Key with Device ID

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
19 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
●Hostname: Azure IoT Hub address
Figure 25: Hostname in Azure IoT Hub
●IOT-HUB-Connection-String: Connection string to communicate with Azure IoT Hub
Figure 26: Connection String for Azure IoT Hub
There are two ways to configure these parameters in the DA16200/DA16600:
●Set the default values in the SDK:
Edit the above settings in app_thing_manager.h, and then compile (for instruction on how to
compile the DA16200/DA16600 SDK, see Ref. [1]) and download the firmware image.
#define APP_USER_MYHING_NAME "da16XXX-device-1" //Device ID
#define APP_USER_MY_DEV_PRIMARY_KEY "kzsauVFTNfZpO1xJHrgXFDjxZ6t9Jbfmd4PgMvx/ixo=”
#define APP_USER_MY_HOST_NAME "da16XXX-iothub.azure-devices.net"
#define APP_USER_MY_IOTHUB_CONN_STRIN "HostName= da16XXX-iothub.azure-
devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=a5UBDdFQJ92jVMhVjwJRzY/LR/GfnrEu289Aa806nUw="
●Program the values in the DA16200/DA16600 NVRAM:
In the DA16200/DA16600 debug console, enter factory mode and set the 4 NVRAM parameters
as shown below.

User Manual
Revision 1.4
Jan. 26, 2024
CFR0012
20 of 83
© 2024 Renesas Electronics
UM-WI-058
DA16200 DA16600 Getting Started with Azure® IoT
[/DA16200 or /DA16600] # nvram
Command-List is changed, "NVRAM"
[/DA16200 or /DA16600/NVRAM] # setenv APP_THINGNAME da16XXX-device-1
[/DA16200 or /DA16600/NVRAM] # getenv
…….
APP_THINGNAME (STR,17) ....... da16XXX-device-1
[/DA16200 or /DA16600] # nvram
Command-List is changed, "NVRAM"
[/DA16200 or /DA16600/NVRAM] # setenv APP_DEV_PRIMARY_KEY kzsauVFTNfZpO1xJHrgXFDjxZ6t9Jbfmd4PgMvx/ixo=
[/DA16200 or /DA16600/NVRAM] # getenv
………
APP_THINGNAME (STR,17) ....... da16XXX-device-1
APP_DEV_PRIMARY_KEY (STR,45) . kzsauVFTNfZpO1xJHrgXFDjxZ6t9Jbfmd4PgMvx/ixo=
[/DA16200 or /DA16600] # nvram
Command-List is changed, "NVRAM"
[/DA16200 or /DA16600/NVRAM] # setenv APP_HOSTNAME da16XXX-iothub.azure-devices.net
[/DA16200 or /DA16600/NVRAM] # getenv
…….
APP_THINGNAME (STR,17) ....... da16XXX-device-1
APP_DEV_PRIMARY_KEY (STR,45) . kzsauVFTNfZpO1xJHrgXFDjxZ6t9Jbfmd4PgMvx/ixo=
APP_HOSTNAME (STR,43) ........ da16XXX-iothub.azure-devices.net
[/DA16200 or /DA16600/NVRAM] # nvram
Command-List is changed, "NVRAM"
[/DA16200 or /DA16600/NVRAM] # setenv APP_IOTHUB_CONN_STRING
Typing data: (setenv value)
Cancel - CTRL+D, End of Input - CTRL+C or CTRL+Z
HostName= da16XXX-iothub.azure-
devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=Vmt7BP8BsSwNJRm1tSLJUClibls1ApXjpd67HqF91xQ=
[/DA16200 or /DA16600/NVRAM] # getenv
………
APP_THINGNAME (STR,17) ....... da16XXX-device-1
APP_DEV_PRIMARY_KEY (STR,45) . kzsauVFTNfZpO1xJHrgXFDjxZ6t9Jbfmd4PgMvx/ixo=
APP_HOSTNAME (STR,43) ........ da16XXX-iothub.azure-devices.net
APP_IOTHUB_CONN_STRING (STR,147) HostName= da16XXX-iothub.azure-
devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=Vmt7BP8BsSwNJRm1tSLJUClibls1ApXjpd67HqF91xQ=
3.4 Verify Connection Between Azure IoT Hub and DA16200/DA16600
When parameters listed above are configured and firmware is successfully downloaded, boot the
DA16200/DA16600 EVK and connect to the Azure IoT Hub. Once connected, the
DA16200/DA16600 EVK reports to the Azure IoT Hub and the Azure device twin is updated with the
reported items.
The log will appear in the debug console as shown below.
●Logs of the connection between the DA16200 EVK and Azure IoT Hub
Wakeup source is 0x4
[dpm_init_retmemory] DPM INIT CONFIGURATION(1)
******************************************************
* DA16200 SDK Information
* ---------------------------------------------------
*
* - CPU Type : Cortex-M4 (120MHz)
* - OS Type : FreeRTOS 10.4.3
* - Serial Flash : 4 MB
* - SDK Version : V3.2.2.1 Azure Doorlock Ref.
* - F/W Version : FRTOS-GEN01-01-507cc85bd-003442
* - F/W Build Time : May 7 2022 17:04:14
* - Boot Index : 0
*
******************************************************