mc27561-dragonfly · 2.6. sigfox module (itm-msfx-a-02) the midatronics sigfox modul itm-msfx-a-02...
TRANSCRIPT
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 1 of 32
MC27561-DRAGONFLY User’s Guide
All information contained in these materials, including products and product specifications, represents information on the product at the time of publication and is subject to change by Arrow Electronics without notice.
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 2 of 32
Revisions REVISION DATE DESCRIPTION STATUS AUTHOR REVISER
Ver. 1.0 10/11/2017 First release Final [email protected] Ver. 1.1 14/12/2017 Arduino Board Mgr
installation updated Final [email protected]
Ver. 1.2 15/01/2018 Errata corrige: Dimensions updated pag. 7
Final [email protected]
Ver 1.3 09/03/2018 Update json link Final [email protected] Ver 1.4 21/03/2019 Updated Company
Info Final [email protected]
Disclaimer
All rights reserved. No parts of this manual may be reproduced in any form without the express written permission of Arrow Electronics. Arrow Electronics makes no representations or warranties with respect to the contents hereof. In addition, information contained herein is subject to change without notice. Every precaution has been taken in the preparation of this manual. Nevertheless, Arrow Electronics assumes no responsibility for errors or omissions or any damages resulting from the use of the information contained in this publication. Arrow Electronics does not assume any liability arising out of the application or use of any of its products or designs. Products designed or distributed by Arrow Electronics are not intended for, or authorized to be used in, applications such as life support systems or for any other use in which the failure of the product could potentially result in personal injury, death or property damage.
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 3 of 32
Outline 1. INTRODUCTION ....................................................................................................................................... 5
1.1. DESCRIPTION ....................................................................................................................................... 5 1.2. KIT CONTENTS ..................................................................................................................................... 5 1.3. GETTING STARTED ............................................................................................................................... 5
2. SYSTEM OVERVIEW ................................................................................................................................ 6 2.1. BOARD LAYOUT .................................................................................................................................... 6 2.2. BLOCK DIAGRAM .................................................................................................................................. 6 2.3. BOARD SPECIFICATIONS ....................................................................................................................... 7 2.4. ATSAMD21J18A ULTRA LOW-POWER ARM ........................................................................................ 7 2.5. WI-FI MODULE ATWINC1500-MR210 ................................................................................................. 8 2.6. SIGFOX MODULE (ATAB8520E) .......................................................................................................... 8 2.7. DUSTY MODULE ................................................................................................................................. 9 2.8. 32KX8 BITS EEPROM (AT24C256C) ................................................................................................... 9
3. CONNECTORS ....................................................................................................................................... 10 3.1. J1 USB DEVICE ................................................................................................................................. 11 3.2. J2 DEBUGSWD CONNECTOR ........................................................................................................... 11 3.3. ARDUINO HEADERS ............................................................................................................................ 12 3.4. J7 DUSTY PRGM DESCRIPTION .......................................................................................................... 13 3.5. J8 ANTENNA CONNECTOR ................................................................................................................... 14 3.6. J9 POWER CONNECTOR ..................................................................................................................... 14 3.7. WP1 WP2 BATTERY CONNECTOR ....................................................................................................... 14 3.8. J11 WIFI POWER ............................................................................................................................... 14 3.9. J12 CONSOLE .................................................................................................................................... 15 3.10. WI-FI MODULE CONNECTION TO D21 ............................................................................................... 15 3.11. SIGFOX MODULE CONNECTION TO D21 ........................................................................................... 16 3.12. DUSTY MODULE CONNECTION TO D21 ........................................................................................... 16
4. USAGE .................................................................................................................................................... 17 4.1. POWER SUPPLY ................................................................................................................................. 17 4.2. PUSH BUTTONS AND LEDS ................................................................................................................. 18 4.3. I2C ADDRESS ................................................................................................................................. 19
5. BOARD LAYOUT .................................................................................................................................... 20 6. SOFTWARE DEVELOPMENT ................................................................................................................ 21 7. GETTING STARTED WITH ARDUINO IDE AND SKETCH PROJECTS .............................................. 22
7.1. TOOLS ............................................................................................................................................... 22 7.2. SETUP THE ENVIRONMENT .................................................................................................................. 22 7.3. RUN THE SOFTWARE .......................................................................................................................... 25 7.4. IMPORTING THE COMPONENTS LIBRARY .............................................................................................. 26 7.5. OFFICIAL GITHUB LIBRARY REPOSITORY .............................................................................................. 29
8. REFERENCES AND USEFUL LINKS .................................................................................................... 30 8.1. DATA SHEETS .................................................................................................................................... 30 8.2. TOOLS ..................................................................................... ERRORE. IL SEGNALIBRO NON È DEFINITO. 8.3. WEB SITES .............................................................................. ERRORE. IL SEGNALIBRO NON È DEFINITO.
9. TROUBLESHOOTING ............................................................................................................................ 32 9.1. DRIVER INSTALLATION PROBLEMS ....................................................................................................... 32
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 4 of 32
Illustrations FIGURE 1 BOARD LAYOUT .................................................................................................... 6 FIGURE 2 BLOCK DIAGRAM ................................................................................................... 6 FIGURE 3 CONNECTORS .................................................................................................... 10 FIGURE 4 USB INTERFACE ................................................................................................. 11 FIGURE 5 SWD CONNECTOR ............................................................................................... 11 FIGURE 6 ARDUINO ZERO PINOUT ......................................................................................... 12 FIGURE 7 DUSTY PRGM .................................................................................................... 13 FIGURE 8 BATTERY CONNECTOR .......................................................................................... 14 FIGURE 9 WI-FI POWER .................................................................................................... 15 FIGURE 10 CONSOLE CONNECTOR ......................................................................................... 15 FIGURE 11 POWER SUPPLY ................................................................................................. 17 FIGURE 12 PUSH BUTTON & LEDS ........................................................................................ 18 FIGURE 13 TOP TOPOLOGY ................................................................................................. 20 FIGURE 14 LAUNCH BOARD MANAGER .................................................................................... 22 FIGURE 15 ARDUINO ZERO CORE INSTALLATION ....................................................................... 23 FIGURE 16 SMARTEVERYTHING CORE MASTER ........................................................................... 24 FIGURE 17 SMARTEVERYTHING CORE INSTALLATION ................................................................... 24 FIGURE 18 ARDUINO IDE: VERIFY THE CODE ........................................................................... 25 FIGURE 19 ARDUINO IDE: UPLOAD THE CODE .......................................................................... 25 FIGURE 20 ARDUINO IDE: LAUNCH MANAGE LIBRARIES INTERFACE ................................................. 26 FIGURE 21 ARDUINO IDE: LIBRARY MANAGER ......................................................................... 27 FIGURE 22 GITHUB LIBRARIES REPOSITORY ............................................................................. 28 FIGURE 23 CORRECT USB DRIVER INSTALLATION ...................................................................... 32 Tables TABLE 1 BOARD SPECIFICATIONS ............................................................................................ 7 TABLE 2 BOARD CONNECTORS ............................................................................................. 10 TABLE 3 DEBUG CONNECTOR PIN ........................................................................................ 11 TABLE 4 ARDUINO PINS DESCRIPTION .................................................................................... 13 TABLE 5 DUST PORT DESCRIPTION ....................................................................................... 13 TABLE 6 CONSOLE CONNECTOR ............................................................................................ 15 TABLE 7 WI-FI CONNECTION TO D21 .................................................................................... 15 TABLE 8 SIGFOX CONNECTION TO D21 .................................................................................. 16 TABLE 9 DUSTY CONNECTION .............................................................................................. 16 TABLE 10 POWER SUPPLY................................................................................................... 17 TABLE 11 PUSH BUTTONS & LEDS ........................................................................................ 18 TABLE 12 I2C ADDRESSES ................................................................................................. 19
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 5 of 32
1. Introduction 1.1. Description
This document describes the DRAGONFLY board based on the ATSAMD21J1864 Ultra low-power microcontroller using the 32-bit ARM® Cortex®-M0+ processor. The board provides the following peripherals or modules:
• SIGFOX Module
• DUST Module
• Wi-Fi Module
• EEPROM
• Arduino Zero pinout Header
• Console USB
The DRAGONFLY Board is supported by the Arduino IDE for a fast and easy software development cycle (https://www.arduino.cc/en/Main/Software). The software can also be developed using the Atmel Studio IDE commonly preferred by professional software engineers. (https://www.microchip.com/mplab/avr-support)
1.2. Kit contents The following items are included in the box:
• 1x Dragonfly board
1.3. Getting started The Dragonfly board, developed by MIDATRONICS for Arrow Electronics, is a ready-to-use Internet of Things (IoT) hardware.
Please refer to software chapter to learn how to get started to develop your application using the Arduino IDE.
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 6 of 32
2. System overview 2.1. Board layout
The layout of the Dragonfly board is shown in the picture below.
Figure 1 Board Layout
2.2. Block diagram An overview of the functions of the Dragonfly board is shown in the figure below:
Figure 2 Block diagram
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 7 of 32
2.3. Board Specifications Characteristics Value
CPU Clock speed 48MHz Flash Memory 256Kb SRAM 32Kb Connector 1 Power Jack
1 USB 1 SIGFOX antenna 1 LiPo Battery 1 SWD Debugger Arduino compatible PinOut
Board supply voltage 5V – 24V CC Operating Voltage 3.3V (*) Temperature -40°C to +85°C Dimensions 80x54 mm RoHS status Compliant
Table 1 Board specifications
(*) All digital I/O refer to this power of level
2.4. ATSAMD21J18A Ultra low-power ARM Microchip® | SMART SAM D21 is a series of Ultra low-power microcontrollers using the 32-bit ARM® Cortex® -M0+ processor at a maximum of 48MHz.
The Size of the SAMD21 used in the Dragonfly has the following characteristics:
Memory • 256KB in-system self-programmable Flash • 8KB Flash Read-While-Write section • 32KB SRAM Main Memory • 8KB SRAM Low power Memory
Clock Frequency • 32.768kHz crystal oscillator (XOSC32K)
Arduino compliance • Digital i/o Pins : 20 • PWM Pins: all but 2 and 7 • USART: 2 (USB and TTL Digital) • Analog Input Pins: 6, 12-bit ADC • Analog Output Pins: 1, 10-bit DAC • External Interrupts: All pins except pin 4
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 8 of 32
More information can be found on the MICROCHIP SAMD21 Data Sheet (See the link in the chapter 8.0)
2.5. Wi-Fi Module ATWINC1500-MR210 The ATWINC1500-MR210PA is a low-power consumption 802.11 b/g/n IoT (Internet of Things) module which is specifically optimized for low power IoT applications.
The highly integrated module features a small form factor (21.5mm x 14.5mm x3.4mm), while fully integrating Power Amplifier, LNA, Switch, Power Management, and PCB antenna.
With seamless roaming capabilities and advanced security, it could be interoperable with various vendors’ 802.11b/g/n Access Points in wireless LAN. The module provides SPI and UART to interface to host controller.
2.6. SigFox Module (ITM-MSFX-A-02) The MIDATRONICS Sigfox Modul ITM-MSFX-A-02 uses the Microchip ATA8520E RF transceiver. The ATA8520E is a highly integrated, low-power RF transceiver with an integrated AVR microcontroller for applications using the wide area SIGFOX network.
The Microchip ATA8520E is partitioned into three sections: an RF front end, a digital baseband and the low-power 8-bit AVR microcontroller. The product is designed for the EU ISM frequency band in the range of 868.0MHz to 868.6MHz and 869.4MHz to 869.65MHz and for the US ISM frequency band in the range of 902.0MHz to 906.0MHz.
The external part count is kept to a minimum due to the very high level of integration in this device. By combining outstanding RF performance with highly sophisticated baseband signal processing, robust wireless communication can be easily achieved. The transmit path uses a closed loop fractional-N modulator.
The SPI interface enables external control and device configuration.
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 9 of 32
2.7. DUSTY Module Dusty PCB Ant and Dusty U.FL Ant Conn are the world’s first wireless Internet of Things (IoT) modules with either integrated PCB antenna or U.FL Antenna Connector that utilize SmartMesh IP™ from Analog Devices.
The Dragonfly board embeds either the Dusty PCB Ant with an integrated PCB Antenna or the Dusty U.FL Ant Conn with an U.FL Antenna Connector. A serial peripheral interface is provided for external control and configuration.
An FTDI standard connector is present on the board to use the SmartMesh IP™ console command. More detail are given in the References and Useful Links chapter.
All the board will be released with the latest SmartMesh IP™ FW version, a connector is present on the board for an eventual FW upgrade (NOTE: this procedure requires a subscription to the MyAnalog page)
2.8. 32Kx8 Bits EEProm (AT24C256C) The Microchip® AT24C256C provides 262,144-bits of Serial Electrically Erasable and Programmable Read-Only Memory (EEPROM) organized as 32,768 words of 8 bits each.
The device’s cascading feature allows up to eight devices to share a common 2-wire bus. The device is optimized for use in many industrial and commercial applications where low-power and low-voltage operations are essential.
The device operates from 1.7V to 5.5V.
EEPROM address: the EEPROM is mapped to the following I2C address 0x57.
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 10 of 32
3. Connectors This chapter gives you an overview of the Dragonfly connectivity.
ID Connector J1 USB J2 DEBUG SWD
J3,J4,J5,J6 Arduino header J7 DUSTY PRGM J8 SigFox Ant. Connector J9 External POWER
WP1 +3V, Batteries (2x 1.5V AA) WP2 = GND J11 Enable Wi-Fi J12 Console
Table 2 Board connectors
Connectors’ placement is depicted in the figure below.
Figure 3 Connectors
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 11 of 32
3.1. J1 USB device The board is equipped with an USB (J1) Full-Speed (12 Mbps) device port on J1 connector. The Dragonfly can be powered through this interface.
Figure 4 USB interface
3.2. J2 DEBUGSWD Connector The Dragonfly board features an on-board SWD Connector (J2) that can be used to program and debug the microcontroller.
Figure 5 SWD connector
Name Conn. Pin Description Driven by +3.3V J2 1 +3.3V SWDIO J2 2 SWDIO D21 Port PA31 GND J2 3 GND
SWCLK J2 4 SWCLK D21 Port PA30 GND J2 5 GND TX J2 6 TX PA10
Not used J2 7 Not used RX J2 8 RX PA11
Not used J2 9 Not used RESETN J2 10 RESETN
Table 3 DEBUG connector pin
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 12 of 32
3.3. Arduino Headers The connectors J3, J4, J5, and J6 provide the user with a standard Arduino shield slot as listed below.
Figure 6 Arduino Zero pinout
Conn. Pin Description Arduino pin label Driven by
J5 1 Digital I/O D8 / PWM ~8 D21 Port PA06 J5 2 Digital I/O D9 / PWM ~9 D21 Port PA07 J5 3 Digital I/O D10 / PWM SS ~10 D21 Port PA18 J5 4 Digital I/O D11 / PWM MOSI ~11 D21 Port PA16 J5 5 Digital I/O D12 / PWM MISO ~12 D21 Port PA19 J5 6 Digital I/O D13 / PWM SCK ~13 D21 Port PA17 J5 7 Ground pin GND J5 8 Analogue Reference (used by ADC) AREF D21 Port PA03 J5 9 I2C Interface SDA SDA D21 Port PA22 J5 10 I2C Interface SCL SCL D21 Port PA23 J3 1 Digital I/O ATN ATN D21 Port PB06 J3 2 IOREF J3 3 Reset RESET J3 4 3.3V J3 5 5V J3 6 Ground pin GND J3 7 Ground pin GND J3 8 External Power Supply Input VIN J4 1 Analog I/O A0 A0 D21 Port PA02 J4 2 AnalogI/O A1 A1 D21 Port PB08 J4 3 Analog I/OA2 A2 D21 Port PB09 J4 4 Analog I/OA3 A3 D21 Port PA04 J4 5 Analog I/OA4 A4 D21 Port PA05 J4 6 Analog I/OA5 A5 D21 Port PB02 J6 1 Digital I/O D0 / Serial1 (RX) RX<-0 D21 Port PA11 J6 2 Digital I/O D1 / Serial1 (TX) TX->1 D21 Port PA10 J6 3 Digital I/O D2 / PWM ~2 D21 Port PA14 J6 4 Digital I/O D3 / PWM ~3 D21 Port PA09
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 13 of 32
J6 5 Digital I/O D4 / PWM ~4 D21 Port PA08 J6 6 Digital I/O D5 / PWM ~5 D21 Port PA15 J6 7 Digital I/O D6 / PWM ~6 D21 Port PA20 J6 8 Digital I/O D7 / PWM ~7 D21 Port PA21
Table 4 Arduino pins description
3.4. J7 Dusty PRGM description The Dragonfly board is equipped with a Dusty module. The Dusty module can be configured using the PRGM connector (not provided with the board) on the back side.
The procedure requires an external HW and is described on the Analog Devices Web pages.
Figure 7 Dusty PRGM
ID Description Driven by 1 IPCS SSN DUST Port 23 2 FLASH P ENN DUST Port 32 3 IPCS SCK DUST Port 22 4 IPCS MOSI DUST Port 20 5 IPCS MISO DUST Port 18 6 DUST RESET D21 Port PB22 7 Power V3.3V 8 Ground GND 9 UART C0 TX DUST Port 15 10 UART C0 RX DUST Port 16
Table 5 DUST port description
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 14 of 32
3.5. J8 Antenna connector The Dragonfly board is equipped with an antenna connector for SigFox best connectivity.
3.6. J9 Power connector The Dragonfly board is equipped with a power connector for external power with rage between 5V to 24 V DC.
3.7. WP1 WP2 battery connector The Dragonfly board can be powered with battery 3Vdc by connecting V+ to WP1 and Ground to WP2.
Figure 8 Battery connector
3.8. J11 WiFi Power This is a bridge jumper to enable Wi-Fi Module. The module is factory-enabled; to disable it, it is necessary to remove the R72 resistance.
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 15 of 32
Figure 9 Wi-Fi Power
3.9. J12 Console The Dragonfly board is equipped with a Console connector that provide an FTDI standard connector to use the SmartMesh IP™ console command.
Figure 10 Console connector
ID Description Driven by 1 Ground GND 2 Not used 3 Not used 4 UART C1 RX DUST Port 29 5 UART C1 TX DUST Port 28 6 Not used
Table 6 Console connector
3.10. Wi-Fi module connection to D21 Wi-Fi module
port ID Description Driven by
17 WIFI SPI MISO D21 Port PB12 15 WIFI SPI MOSI D21 Port PB14 18 WIFI SPI SCK D21 Port PB15 16 Wi-Fi SPI SSN D21 Port PB11 13 WIFI IQRN D21 Port PB30 11 WIFI WAKE D21 Port PB31 22 WIFI CHIP EN D21 Port PB00 4 WIFI RESET D21 Port PB01
Table 7 Wi-Fi connection to D21
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 16 of 32
3.11. SigFox module connection to D21 SigFox module
port ID Description Driven by
18 SCK D21 Port PB15 20 MISO D21 Port PB12 19 MOSI D21 Port PB14 21 NSS D21 Port PB13 9 NRESET D21 Port PB05 24 OWRON D21 Port PB07 25 EVENT D21 Port PB10
Table 8 SigFox connection to D21
3.12. DUSTY module connection to D21 Dusty module
port ID Description Driven by
35 UART RX D21 Port PB16 38 UART TX D21 Port PB17 5 RESETN D21 Port PB22 39 TIMEN D21 Port PB04
Table 9 Dusty connection
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 17 of 32
4. Usage This chapter describes how to connect, configure and interact with the DragonFly board.
4.1. Power supply The board can be powered by three different power supply sources:
• External power supply • Micro USB connector • AA Batteries
Figure 11 Power supply
Name Nominal Description Range WP1 3 V 2x 1.5V AA Batteries 3V WP2 GND J9 5V – 24 V External Power Supply 5V to 24V J1 5V USB Port 5V
Table 10 Power supply
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 18 of 32
4.2. Push buttons and LEDs A basic user interface is provided through on-board buttons and LEDs.
PORT COLOR DESCRIPTION MCU Port PB 1 Push button RESET LED 1 Yellow User LED PA 17 LED 2 Yellow RX PB 03 LED 3 Yellow TX PA 27 LED 4 Green Power On
Table 11 Push buttons & LEDs
Figure 12 Push button & LEDs
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 19 of 32
4.3. I2C ADDRESS
The following table lists the I2C address of each component.
All of them are 7-bits addresses (need to shift to left by 1 + bits R/W)
COMPONENT DESCRIPTION ADDRESS AT24C256C EEPROM 0x57
Table 12 I2C addresses
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 20 of 32
5. Board layout The top and bottom board layouts (component placement and overlay) are provided for reference purposes.
Figure 13 Top topology
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 21 of 32
6. Software Development The following chapters provide an overview about how a user can develop their own software and use the Dragonfly board. There are two main ways to develop a software, load it and debug it on the card:
• Using the Arduino IDE and Sketch Projects
• Using the Atmel Studio and Standard C/C++ language
When developing a software running on a microcontroller, it is important to have some tools to easily debug the code and to fix what does not work as expected. It is possible to use an external debugger like the Atmel-ICE . (https://www.microchip.com/DevelopmentTools/ProductDetails/ATATMEL-ICE)
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 22 of 32
7. Getting Started with Arduino IDE and Sketch Projects 7.1. Tools
The following tools are needed: • Arduino IDE (Release 1.6.4 or newer)
• USB cable
7.2. Setup the Environment Download and install the Arduino IDE from the Arduino web site (See the link in chapter 8.). The first time you run the Arduino IDE, it is necessary to load the Arduino Zero & SmartEverything Core. Click on the Tools -> Boards ->Boards Manager… menu entry
Figure 14 Launch Board Manager
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 23 of 32
The two installation steps shall be done as follows:
1) Select from “Type” combo Arduino and choose Arduino SAMD Boards in order to install the core of the Arduino Zero.
Figure 15 Arduino Zero Core Installation
2) Insert the following URL:
https://raw.githubusercontent.com/ioteamit/smarteverything-core/master/package_arrow_index.json
in the Additional URL for board manager through setup panel as shown in the figure below
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 24 of 32
Figure 16 SmartEverything core master
3) Select from “Type” combo Partner and choose the ARROW Boards in order to install the core of the SmartEverything.
Figure 17 SmartEverything Core Installation
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 25 of 32
The installation procedure will automatically install all the necessary USB drives. Once the installation is completed, you can connect the Board and start coding.
If the Driver installation process does not complete successfully, follow the steps described in chapter 9.
7.3. Run the software Verify the code
Figure 18 Arduino IDE: Verify the code
Load the software on the connected board.
Figure 19 Arduino IDE: Upload the code
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 26 of 32
7.4. Importing the components Library In order to use the Wi-Fi, SigFox and Dust, specific libraries is required. To include these libraries use the menu Sketch - Include Library - Manage Libraries.
Figure 20 Arduino IDE: Launch Manage Libraries interface
Once the Library Manager is started, you can filter the available libraries writing:
• Wifi101 • LTC5800 • atab8520 • extEEPROM
in the right top text box and then you can select the necessary library.
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 27 of 32
Figure 21 Arduino IDE: Library Manager
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 28 of 32
Another way to install the supported components Library is to go to the GitHub repository and download the zip file.
Figure 22 GitHub libraries repository
Once it is downloaded, go to the “include Library” menu and use the “Add .ZIP Library…” item.
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 29 of 32
7.5. Official GitHub library repository Here is the official repository where the zip file can be downloaded from:
• SigFox - github.com/ioteamit/ioteam-atab8520-library
• Dusty - github.com/ioteamit/dusty_LTC5800_library
• EEPROM - github.com/PaoloP74/extEEPROM
The Wi-Fi library is available from Arduino library manager. For any reference follow the link below:
• Wi-Fi - www.arduino.cc/en/Reference/WiFi101
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 30 of 32
8. References and Useful Links 8.1. Data sheets
MICROCHIP SAMD21 Family | Low-power ARM® Cortex®-M0+ D21 http://ww1.microchip.com/downloads/en/DeviceDoc/SAMD21-Family-DataSheet-DS40001882D.pdf Crypto Authentication Chip (MICROCHIP ATECC508A) http://ww1.microchip.com/downloads/en/DeviceDoc/20005927A.pdf Dynaflex 868MHz Antenna (915/2) MIDATRONICS Sigfox Module (ITM-MSFX-A-02) https://midatronics.com/assets/pdf/MIDATRONICS%20-%20ITM-MSFX-A-02%20Sigfox%20Module%20User%20Guide%201.2.pdf
DUSTY module:
LTC5800 Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/5800iprfa.pdf Dust Manager CLI commands https://www.analog.com/media/en/reference-design-documentation/design-notes/SmartMesh_IP_Embedded_Manager_API_Guide.pdf DustCloud https://dustcloud.atlassian.net/wiki/ My Analog https://my.analog.com/ Dusty FW Upgrade https://www.analog.com/en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/dc9010b.html
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 31 of 32
Wi-Fi ATWINC1500-MR210 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-42376-SmartConnect-WINC1500-MR210PA_Datasheet.pdf E2Prom MICROCHIP (AT24C256C) http://ww1.microchip.com/downloads/en/DeviceDoc/AT24C256C-I2C-Compatible-Serial-EEPROM-256-Kbit-20006042A.pdf
8.2. Tools • Arduino IDE -https://www.arduino.cc/en/Main/Software
• Atmel Studio -https://www.microchip.com/mplab/avr-support
8.3. Web Sites • ARROW Electronics -www.arrow.com
• MIDATRONICS S.r.l. -www.midatronics.com
• Arduino -www.arduino.cc
• Microchip -www.microchip.com
• SigFox -www.sigfox.com
• Analog Devices -www.analog.com
Document MC27561 Dragonfly – User’s Guide
21/03/2019
Doc: MC27561-DragonFly User’s Guide, Rev 1.4 32 of 32
9. Troubleshooting
9.1. Driver installation problems It can happen that the installation of the driver does not automatically complete successfully. The driver to manage the COM Port is not installed properly and the device is reported as an Unknown Device.
If this happens in Windows 7, it is necessary to install the driver manually.
The correct drivers can be found on the following directory:
C:\Users\<login name>\AppData\Local\Arduino15\packages\Arrow\hardware\samd\<installed Rel>\drivers.
Figure 23 Correct USB Driver installation