Wurth Elektronik Calypso IoT Design Kit User Manual

For microsoft azure
Table of Contents

Advertisement

Quick Links

U
SER MANUAL
C
I
T
ALYPSO
O
DESIGN KIT FOR
M
A
ICROSOFT
ZURE
2610059035001
V
1.1
ERSION
O
18, 2024
CTOBER

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Calypso IoT Design Kit and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Wurth Elektronik Calypso IoT Design Kit

  • Page 1 SER MANUAL ALYPSO DESIGN KIT FOR ICROSOFT ZURE 2610059035001 ERSION 18, 2024 CTOBER...
  • Page 2 *************** MUST READ Check for firmware updates Before using the product, make sure you use the most recent firmware version, data sheet, and user manual. This is especially important for Wireless Connectivity products that were not purchased directly from Würth Elektronik eiSos. A firmware update on these respective products may be required.
  • Page 3: Revision History

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Revision history Manual version Notes Date Initial version June 2023 Fixed broken links. October 2024 Added chapter 7 . Order code 2610059035001 Version 1.1, October 2024 www.we-online.com/wcs...
  • Page 4 WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Abbreviations Abbreviation Name Description Application A way for two computer programs to communicate programming with each other. interface Device provisioning A service of Microsoft Azure service Hyper Text...
  • Page 5: Table Of Contents

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Contents 1 General description Introduction ........
  • Page 6: General Description

    User manual Calypso IoT design kit for Microsoft Azure 1 General description 1.1 Introduction The Würth Elektronik eiSos’s Calypso IoT design kit is an EV-Board set with pre-installed firmware that enables easy creation and evaluation of a secure end-to-end IoT solution us- ing Microsoft’s Azure IoT central.
  • Page 7: Block Diagram

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure 1.2 Block diagram Figure 2: Block diagram - Calypso IoT design kit 1.3 Contents Description Quantity Würth Elektronik Sensor FeatherWing Würth Elektronik Calypso WiFi FeatherWing Adafruit FeatherWing OLED Adafruit Feather M0 pre-flashed with firmware from Würth...
  • Page 8: Functional Description

    User manual Calypso IoT design kit for Microsoft Azure 2 Functional description The Calypso IoT design kit was created to simplify the development of an IoT application. The Internet of Things (IoT) can be broadly defined as an umbrella term for a range of technologies that enable devices to connect and interact with each other.
  • Page 9: Iot Application Stack

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 3: IoT application stack Data platform: This is the platform where the data is finally stored and presented for further analysis. Options here can range from a local database to a cloud server with redundancies.
  • Page 10: Remote Monitoring And Control Using The Design Kit

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 4: Components of a data platform User interface: This is the interface between human users and the digital world. Here the status of the observed environment is presented in a human-readable format. The user can take the necessary actions by interacting with this application 2.2 Remote Monitoring and Control using the design kit...
  • Page 11: System Design Using The Design Kit

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 5: System architecture 2.2.2 System design using the design kit Figure 6 illustrates the design that realizes the architecture described in chapter 2.2.1 . The sensor values of the WE Sensors FeatherWing are read by the Feather M0 express MCU and transferred to the IoT central cloud platform over WiFi where it is stored, visualized, and processed.
  • Page 12: Constituents Of The Iot Design Kit

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 6: System design 2.3 Constituents of the IoT design kit In this section, all the constituents of this design kit are described. 2.3.1 WE sensors FeatherWing The Würth Elektronik eiSos Sensor FeatherWing is a sensor development board fully compat-...
  • Page 13: We Calypso Wifi Featherwing

    Feathers with WiFi connectivity. The Calypso IoT design kit consists of the Calypso radio module that offers WiFi connectivity based on IEEE 802.11 b/g/n with a fully featured TCP/IP (IPv4 and IPv6) stack. With out-of- the-box support for commonly used network applications like SNTP, HTTP(S), and MQTT(S), Calypso offers an easy and secure solution to any IoT application.
  • Page 14: Adafruit Feather M0 Express

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure 2.3.3 Adafruit Feather M0 Express The Adafruit Feather M0 express is built around the ATSAMD21G18 ARM Cortex M0+ proces- sor, clocked at 48 MHz and at 3.3 V logic, the same one used in the new Arduino Zero. This chip has 256K of FLASH and 32K of RAM and comes with built-in USB so that it has USB-to- Serial program and debug capability built in with no need for an FTDI-like chip.
  • Page 15: Microsoft Azure Iot Central Platform

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure the display makes its own light, no backlight is required. This reduces the power required to run the OLED and is why the display has such high contrast. The three mini tactile buttons as well as the reset button along with the display add a miniature user interface to the Feather.
  • Page 16: Architecture Of Iot Central Platform

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 11: Architecture of IoT central platform. Source: https://learn.microsoft.com/en-us/azure/iot-central/core/concepts-architecture More information about the IoT central platform can be found under the link, https://learn.microsoft.com/en-us/azure/iot-central/ . Order code 2610059035001 Version 1.1, October 2024...
  • Page 17: Quick Start Guide

    User manual Calypso IoT design kit for Microsoft Azure 3 Quick start guide The Calypso IoT design kit comes pre-flashed and ready-to-use out-of-the-box. This chapter describes the steps to get the kit up and running in a few minutes. 3.1 Prerequisites The following items are necessary to go through this process.
  • Page 18: Create An Iot Central Application

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure This tool works only on Windows platform The design kit will always be delivered with the latest Firmware version (> v2.2.0). In case you use a Calypso FeatherWing which you received separately, make sure that the Calypso FeatherWing has a Firmware version >...
  • Page 19: Iot Central Application Parameters

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 14: IoT central application parameters On the Basics tab, complete the fields as follows: 1. Subscription:Select the subscription to use for the application. 2. Resource group: Select a resource group or create a new one. To create a new one, select Create new and fill in the name you want to use.
  • Page 20: Iot Central Application Url

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 15: IoT central application URL Click on the IoT central application URL to open the newly created IoT central platform. Figure 16: IoT central application homepage In the IoT central app open, "Permissions >...
  • Page 21: Create Certificates And The Device Configuration File

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 17: ID scope for the created IoT central application For more information on creating an IoT central application, please refer to the following link https://learn.microsoft.com/en-us/azure/iot-central/core/howto- create-iot-central-application 3.3 Create certificates and the device configuration file...
  • Page 22: Parameters To Configure The Device

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 18: Parameters to configure the device 1. SSID: Select the WiFi connection to be used by the device from the drop-down menu. This is the name of the WiFi access point that the device needs to connect to the internet.
  • Page 23: Device Certificate Options

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure 2. Click on "Create root certificate" to create a new root certificate. 3. {Optional} If a root certificate already exists, click on "Load root certificate". This opens a file browser. Browse to the correct location to choose the previously used root certificate.
  • Page 24: Certificate Generation Steps

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Device private key: This is the private key corresponding to the public key in the device certificate and is also uniquely linked to a device ID. Click on "Export Device Private key"...
  • Page 25: Upload The Root Certificate To Iot Central

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 23: Files exported 3.4 Upload the Root certificate to IoT central In this step, the device root certificate is uploaded and a policy is set to allow all devices with leaf certificates that are generated from this root, to be allowed to connect to the platform.
  • Page 26: Enrolment Group Options

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 25: Enrolment group options In the subsequent window, 1. Enter a name for the enrolment group. 2. Set the "Automatically connect devices in this group" to "On".
  • Page 27: Configure The Device

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 26: Upload device root certificate 1. Click on "Manage primary" in the "Certificates (X.509)" section of the enrolment group. 2. In the pop-up window, click on "Add certificate" and select the device root file gener- ated using the WE certificate generator.
  • Page 28: Double Press On Button C

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 27: Power-up the design kit After a short initialization process, the device waits for the user to start the configuration process. The following message appears on the display "Device not configured. To configure double press button C".
  • Page 29: Device In Access Point Mode

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 29: Device in access point mode Figure 30: Connect to the device in access point mode 2. On the PC, open a browser. 3. In the browser, navigate to http://calypso.net/azure.html.
  • Page 30: Select And Upload Files

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure 4. Click on the "Choose Files" button. This opens the file browser. Browse to the loca- tion where the configuration files were generated as described in section 3.3 . The files are stored under the path "working directory >...
  • Page 31: Reset The Device

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 33: Reset the device On restarting, the device goes through the following steps automatically, 1. Initialize the hardware. 2. Connect to the configured WiFi network. 3. Connect to the Microsoft Azure Device Provisioning Service (DPS).
  • Page 32: View The Device Default Dashboard

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure 3.6 View the device default dashboard To access the device on the IoT platform, navigate to "Devices -> All devices -> <Device ID>". Click on the device name to open the device page.
  • Page 33: Send Commands To Device

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 37: Overview of telemetry data 3.7 Send commands to device To send a command to change the mini neo-pixel LED on the device, click on the command tab on the device page.
  • Page 34: Update Device Property

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 38: Set the LED using the command 3.8 Update device property This device allows changing the frequency with which the sensor data is read and sent to the platform.
  • Page 35: Factory Reset

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 40: Set writable property 3.9 Factory reset In order to reset the device to factory state, press the "button C" once, then Press and hold "button C" till the following message is displayed on the screen, "Reset device to factory state".
  • Page 36: Software Description

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure 4 Software description Würth Elektronik eiSos provides a Software Development Kit (SDK) with examples to support all the FeatherWings created by Würth Elektronik eiSos. In this chapter, the salient features of the WE FeatherWing SDK are described.
  • Page 37: Software Architecture

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure Figure 41: Software architecture Board files: this layer provides abstraction at a board level and provides functions to configure and control individual FeatherWings from Würth Elektronik eiSos.
  • Page 38: Regulatory Compliance Information

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure 5 Regulatory compliance information Pursuant to Article 1 (2.) of the EU directive 2014/53/EU, Article 1 (2.) the directive does not apply to equipment listed in Annex I (4.): custom-built EV-Kits destined for professionals to be used solely at research and development facilities for such purposes.
  • Page 39: Important Notes

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure 6 Important notes The following conditions apply to all goods within the wireless connectivity and sensors product range of Würth Elektronik eiSos GmbH & Co. KG: General customer responsibility Some goods within the product range of Würth Elektronik eiSos GmbH &...
  • Page 40 WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure their application with WE components. As a user, you are solely responsible for: (1) selection of the appropriate WE components for the application, (2) design, validation and testing the application, and (3) assurance that the application meets the applicable standards and all other safety requirements and other applicable requirements.
  • Page 41: Legal Notice

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure sociated with other products, such as Directive 2011/65/EC of the European Parliament and of the Council of 8 June 2011 on the restriction of the use of hazardous substances and Directive 2002/96/EC on waste electrical and electronic equipment (WEEE). You take full responsibility for compliance with such standards that apply to the EVB.
  • Page 42: License Terms

    WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure 9 License terms These License terms will take effect upon the purchase and usage of the Würth Elektronik eiSos GmbH & Co. KG wireless connectivity products. You hereby agree that these license terms are applicable to the product and the incorporated software, firmware and source codes (collectively, "Software") made available by Würth Elektronik eiSos in any form, including but not limited to binary, executable or source code...
  • Page 43 WIRELESS CONNECTIVITY & SENSORS User manual Calypso IoT design kit for Microsoft Azure office. Severability clause If a provision of these license terms is or becomes invalid, unenforceable or null and void, this shall not affect the remaining provisions of the terms.
  • Page 44 List of Figures Calypso IoT design kit ....... . .
  • Page 45 Contact Würth Elektronik eiSos GmbH & Co. KG Division Wireless Connectivity & Sensors Max-Eyth-Straße 1 74638 Waldenburg Germany Tel.: +49 651 99355-0 Fax.: +49 651 99355-69 www.we-online.com/wireless-connectivity...

This manual is also suitable for:

2610059035001

Table of Contents