Software apps and online services | ||||||
 |
| |||||
| ||||||
In this document I will provide instructions how to connect latest Wiznet product – WizFi360-EVB-Pico to Azure IoT Cloud.
I will use WizFi360-EVB-Pico-AZURE-C provided by WIZnet.
1. Environment PreparationBefore starting, it is necessary to setup your environment for WizFi360-EVB-Pico. It is same as development environment for Raspberry Pi Pico.
In this guide I used Windows 10, Visual Studio Code and C/C++ based environment. For environment preparation I referred to Getting started with Raspberry Pi Pico guide on Raspberry Pi documentation website.
If you have any troubles following Raspberry Pi guide, then check below link, where author explains every installation step for environment preparation.
Or, refer to my previous post – 'Let's use the Raspberry Pico Ethernet Example! - Development environment configuration'
2. H/W PreparationWizFi360-EVB-Pico is a development board that is built on high-performance, low-price MCU RP2040 and adds Wi-Fi connectivity using WizFi360.
More details can be found at below link:
WizFi360-EVB-Pico is pin compatible to Raspberry Pi Pico. But keep in mind that pins GPIO4 ~ GPIO7 / GPIO20 are used for UART communication / reset between RP2040 and WizFi360.
Follow the steps below to firmware upload and run.
① Connect WizFi360-EVB-Pico to desktop or laptop using 5 pin micro USB cable.
3. S/W PreparationThe following serial terminal program is required for example test, download and install from below link.
4. Preparation of Azure IoT CloudLogin to Azure Portal.
If you have no account, create one.
Azure IoT Cloud is paid cloud platform, but you can create a free account
WIZnet provides 4 samples applications, based on sample application Azure IoT Cloud settings shall be set accordingly.
// The application you wish to use should be uncommented
//
#define APP_TELEMETRY
//#define APP_C2D
//#define APP_CLI_X509
//#define APP_PROV_X509
(...)
//-----------------------------------------------------------------------------------
// CALL Main Funcion - WizFi360 Azure IoT example funcion
// Select one application.
//-----------------------------------------------------------------------------------
#ifdef APP_TELEMETRY
iothub_ll_telemetry_sample();
#endif // APP_TELEMETRY
#ifdef APP_C2D
iothub_ll_c2d_sample();
#endif // APP_C2D
#ifdef APP_CLI_X509
iothub_ll_client_x509_sample();
#endif // APP_CLI_X509
#ifdef APP_PROV_X509
prov_dev_client_ll_sample();
#endif // APP_PROV_X509
//-----------------------------------------------------------------------------------In this guide, I will proceed with 'iothub_II_telemetry_sample' to connect with Azure IoT Cloud.
① Create IoT Hub
Fill project details and select your subscription on the 'Basics' tab.
For 'Networking', 'Management', 'Tags' and other items it is OK to leave default settings.
Select 'Review + Create' to review your choices. Click 'Create' button at the bottom to complete IoT Hub creation.
② Add IoT Device
Click 'Devices' in menu on the left of created IoT Hub and 'Add device'
For 'iothub_II_telemetry_sample' device settings will be made as shown on below picture. For other sample applications these settings may vary.
Please refer to guide document in corresponding sample application to find appropriate Azure IoT Cloud.
5. Example Settings① Setup Wi-Fi configuration
Setup the Wi-Fi network informations in 'socket_startup.c' in 'WizFi360-EVB-Pico-AZURE-C/examples/' directory.
/* Wi-Fi configuration */
#define SSID "ssid"
#define PASSWORD "password"
#define SECURITY_TYPE ARM_WIFI_SECURITY_WPA2② Select sample application
As I will be connection using 'iothub_II_telemetry_sample', I will use application in 'WizFi360-EVB-Pico-AZURE-C/examples/iot_demo.c' as shown below.
// The application you wish to use should be uncommented
//
#define APP_TELEMETRY
//#define APP_C2D
//#define APP_CLI_X509
//#define APP_PROV_X509③ Enter connection string
You can find connection string by clicking on corresponding IoT device.
Paste IoT Hub connection string to 'WizFi360-EVB-Pico-AZURE-C/examples/sample_certs.c'.
const char pico_az_connectionString[] = "HostName=my-rp2040-hub.azure-devices.net;DeviceId=my-rp2040-device-telemetry;SharedAccessKey=Zp2...xQ=";① Build
After all required changes are done, press F7 or click ‘Build’ button in status bar of Visual Studio Code.
When build is complete, you can find generated 'azure_mqtt_demo.uf2' file in 'WizFi360-EVB-Pico-AZURE-C/build/examples/'
② Upload
Press BOOTSEL button on WizFi360-EVB-Pico on power-up, you should see RPI-RP2 drive. Simply drag and drop 'main.uf2' file.
① Connect to the serial COM port of WizFi360-EVB-Pico with Tera Term.
② If example is running normally, in terminal you should be able to see Wi-Fi and Azure IoT Cloud connection steps and transmitted messages.
③ Azure IoT explorer can be used to check transmitted messages.
Comments