Family evaluation board for radio modules (50 pages)
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.
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...
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.
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.
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.
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...
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.
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-...
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.
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.
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.
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...
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.
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 >...
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.
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 >...
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...
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.
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.
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"...
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.
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".
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.
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".
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.
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 >...
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).
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.
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.
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.
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".
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.
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.
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.
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.
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.
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 ....... . .
Need help?
Do you have a question about the Calypso IoT Design Kit and is the answer not in the manual?
Questions and answers