Connect WizFi360-EVB-Pico to Azure IoT Cloud!

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.

• WizFi360-EVB-Pico-AZURE-C

1. Environment Preparation

Before 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.

• Raspberry Pi documentation
• Getting started with Raspberry Pi Pico

If you have any troubles following Raspberry Pi guide, then check below link, where author explains every installation step for environment preparation.

• Raspberry Pi Pico : C/C++ SDK and Toolchain Setup in Windows 10

Or, refer to my previous post – 'Let's use the Raspberry Pico Ethernet Example! - Development environment configuration'

• Let's use the Raspberry Pico Ethernet Example! - Development environment configuration

2. H/W Preparation

WizFi360-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

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 Preparation

The following serial terminal program is required for example test, download and install from below link.

• Tera Term

4. Preparation of Azure IoT Cloud

Login to Azure Portal.

If you have no account, create one.

Azure IoT Cloud is paid cloud platform, but you can create a free account

• Build in the cloud with an Azure 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.

• iothub_ll_telemetry_sample
• iothub_ll_c2d_sample
• iothub_ll_client_x509_sample
• prov_dev_client_ll_sample

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=";

6. Example Build & Upload

① 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.

7. Running Example

① 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.