MPLAB® Code Configurator AVR Iot Google Sensor Node Release Notes

MPLAB® Code Configurator AVR IoT Google Sensor Node Release Notes

Table of Contents

1. What is the Library...... 3

2. System Requirements...... 4

3. Related Hardware and Documentation Support...... 5

4. Installing the Library...... 7

5. Running the Example...... 8

6. What's New?...... 9

7. Repairs and Enhancements...... 10

8. Known Issues...... 11

9. FAQ...... 12

10. Supported Devices and Families...... 13

The Microchip Website...... 14

Product Change Notification Service...... 14

Customer Support...... 14

Microchip Devices Code Protection Feature...... 14

Legal Notice...... 15

Trademarks...... 15

Quality Management System...... 16

Worldwide Sales and Service...... 17

What is the Library

1. What is the Library

AVR-IoT Google Sensor Node is a secure, Wi-Fi connected solution for an IoT node. It enables developers to send and receive data between a sensor node and the Cloud platform. The AVR-IoT WG Development Board can be used as demonstration platform for this IoT solution.

System Requirements

2. System Requirements

• MPLAB® X IDE v5.40 or later • ATmega_DFP v2.2.108 or later (DFPs are available in MPLAB X → Tools → Packs) • MPLAB® Code Configurator Plugin v4.0.0 or later • MCC Core v5.0.0 or later (packaged with MCC) • Libraries: – MCC Foundation Services v0.2.2 or later – AVR8 MCU Library v2.4.0 or later – Crypto Authentication Library v2.0.1 – Message Queuing Telemetry Transport (MQTT) v2.0.1 – WINC15XX Library v1.1.1 • Compilers: – XC8 compiler v2.20 or later – AVR GCC compiler v5.4.0 or later

Related Hardware and Documentation Support

3. Related Hardware and Documentation Support

AVR IoT Google Sensor Node MCC Library is a compendium, which uses underlying libraries (AVR8 MCUs, MQTT, CryptoAuthLib, WINC and Foundation Services). The following libraries need to be installed to generate AVR IoT Google Sensor Node. The version information for each library is available in MCC → Versions[MCC] tab. Double click on the required version number to use that particular version of each library. Table 3-1. Library Dependencies

Library Description Version 1 AVR® MCUs The 8-bit AVR MCUs library enables to use 8-bit AVR 2.4.0 or later devices and its modules.

2 Crypto Authentication Library The Crypto Authentication Library (CryptoAuthLib) 2.0.1 configures the on-board ATECC608A chip that provides the security features of the AVR-IoT WA board to work.

3 Foundation Services The Foundation Services library provides basic 0.2.2 or later software drivers.

Related Hardware and Documentation Support

...... continued Library Description Version 4 Message Queuing Telemetry The MQTT library provides MQTT client 2.0.1 Transport (MQTT) implementation to connect to a MQTT server.

5 WINC15XX Library WINC15XX Library allows for quick and easy C code 1.1.1 generation of Microchip’s ATWINC15x0 SmartConnect module for Internet of Things (IoT) applications.

The stack is tested against following hardware plaform: • AVR-IoT WG Development Board Documentation support is also available here: • AVR-IoT WG Development Board (Documents and Software → Documents)

Installing the Library

4. Installing the Library

To install the MPLAB® Code Configurator Plugin: 1. In the MPLAB® X IDE click on Tools → Plugin 2. Click on Available Plugins tab 3. Check the box for the MPLAB® Code Configurator, and click on Install 4. Close and re-launch MPLABX after installation To install the AVR IoT Google Sensor Node Library: 1. Open the MPLAB Code Configurator webpage 2. Scroll to the bottom of the page and select the Current Downloads tabs 3. Download the AVR IoT Google Sensor Node library (avrIoTGoogleSensorNode-2.0.1.zip) 4. In the MPLAB® X IDE click on Tools → Options 5. Click on Plugins tab 6. Click on Install Library 7. Browse to the location where you saved the avrIoTGoogleSensorNode-2.0.1.zip, select and click Open to install the library

Running the Example

5. Running the Example

1. Create a new project in MPLAB® X IDE (for ex: ATmega4808)

2. Open MCC by clicking Tools→ Embedded→ MPLAB® Code Configurator or click on the MCC icon 3. Navigate to Versions[MCC] → MPLAB® Code Configurator (Plugin) → Libraries → Microchip Technology, Inc. → AVR-IoT Google Sensor Node. Check the version of AVR IoT Google Sensor Node to ensure selection of library version 2.0.1. If any other version is selected, double click on Library version 2.0.1. 4. In the Device Resources panel navigate to Internet of Things → Examples → AVR-IoT Google Sensor Node 5. Double click on AVR-IoT Sensor Node to add this to the Project Resources panel 6. In the Project Resources panel navigate to Internet of Things → Examples → AVR-IoT Google Sensor Node 7. Select AVR-IoT Google Sensor Node 8. Google IoT Core – Configure the Project ID, Project Region and Registry Id accordingly in Cloud Configuration. – The default values configured in there is to get the sensor node connected to Microchip’s Sandbox account.

9. Click on the tooltip for more information on each UI option. 10. Click Generate button 11. Connect the AVR-IoT WG Development Board to the computer using a standard micro-USB cable 12. Build the firmware and program the hardware. 13. Additional information is available in AVR IoT WG User Guide (Documentation and Software → Documents).

What's New?

6. What's New?

• v2.0.1 – Support added for MCC plugin v4.0.0 using MCC Core v5.0.0 Note: • AVR IoT Google Sensor Node v3.0.0 is incompatible with the versions of MCC plugin released prior to v4.0.0. • AVR IoT Google Sensor Node v3.0.0 is incompatible with the versions of MCC Core released prior to v5.0.0. • v2.0.0 – Application specific messages can be enabled/disabled through the macro “ENABLE_DEBUG_IOT_APP_MSGS” for printing to a connected terminal. *This does not affect DEBUG settings.*

Repairs and Enhancements

7. Repairs and Enhancements

v2.0.1

• Updated the library for MCC Plugin v4.0.0 compatibility

v2.0.0

• Improvements: – Added tooltips to the GUI – Improved Cloud interface added to application features allowing for easy swap between cloud platforms – APIs and structure in “cloud_service.h” refactored – API in “wifi_service.h” refactored – Optimized LED driver code size and created a simple interface to control the LEDs – Optimized the frequency at which the application queries WINC module for NTP time in order to maintain the system time • Bugfixes: – Updated interrupt priority levels to address issue of missing character intermittently during ‘drag and drop’ of the wifi.cfg file to the CURIOSITY drive – Enabled pull-up on the floating UART2 Rx pin to prevent reception of garbage data – Issues in Yellow and Green LED behavior resolved when connection loss occurred, which made it appear as if the board was still transmitting data to the cloud

Known Issues

8. Known Issues

• XC8 Compiler v2.20 or later with “Enable Debug Messages” option unchecked: Project compilation is successful using optimization level 1, 2 (free) and level s (pro). Optimization level 0 (free) and 3 (pro) is not supported • XC8 Compiler v2.20 or later with “Enable Debug Messages” option checked: Project compilation is successful using optimization level s (pro). Optimization level 0 (free), 1(free), 2 (free)and 3 (pro) is not supported • AVR GNU Toolchain v3.62 with either “Enable Debug Messages” option checked or unchecked: Project compilation is successful using optimization level 1, 2 (free) and level s (pro). Optimization level 0 (free) and 3 (pro) is not supported

FAQ

9. FAQ

For frequently asked questions, please refer to the FAQ post on the MCC Forum

Supported Devices and Families

10. Supported Devices and Families

Supported Devices: • ATmega4808

The Microchip Website

Microchip provides online support via our website at www.microchip.com/. This website is used to make files and information easily available to customers. Some of the content available includes: • Product Support – Data sheets and errata, application notes and sample programs, design resources, user’s guides and hardware support documents, latest software releases and archived software • General Technical Support – Frequently Asked Questions (FAQs), technical support requests, online discussion groups, Microchip design partner program member listing • Business of Microchip – Product selector and ordering guides, latest Microchip press releases, listing of seminars and events, listings of Microchip sales offices, distributors and factory representatives

Product Change Notification Service

Microchip’s product change notification service helps keep customers current on Microchip products. Subscribers will receive email notification whenever there are changes, updates, revisions or errata related to a specified product family or development tool of interest. To register, go to www.microchip.com/pcn and follow the registration instructions.

Customer Support

Users of Microchip products can receive assistance through several channels: • Distributor or Representative • Local Sales Office • Embedded Solutions Engineer (ESE) • Technical Support Customers should contact their distributor, representative or ESE for support. Local sales offices are also available to help customers. A listing of sales offices and locations is included in this document. Technical support is available through the website at: www.microchip.com/support

Microchip Devices Code Protection Feature

Note the following details of the code protection feature on Microchip devices: • Microchip products meet the specifications contained in their particular Microchip Data Sheet. • Microchip believes that its family of products is secure when used in the intended manner and under normal conditions. • There are dishonest and possibly illegal methods being used in attempts to breach the code protection features of the Microchip devices. We believe that these methods require using the Microchip products in a manner outside the operating specifications contained in Microchip’s Data Sheets. Attempts to breach these code protection features, most likely, cannot be accomplished without violating Microchip’s intellectual property rights. • Microchip is willing to work with any customer who is concerned about the integrity of its code. • Neither Microchip nor any other semiconductor manufacturer can guarantee the security of its code. Code protection does not mean that we are guaranteeing the product is “unbreakable.” Code protection is constantly evolving. We at Microchip are committed to continuously improving the code protection features of our products. Attempts to break Microchip’s code protection feature may be a violation of the Digital Millennium Copyright Act. If such acts allow unauthorized access to your software or other copyrighted work, you may have a right to sue for relief under that Act.

Legal Notice

Information contained in this publication is provided for the sole purpose of designing with and using Microchip products. Information regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. THIS INFORMATION IS PROVIDED BY MICROCHIP “AS IS”. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE OR WARRANTIES RELATED TO ITS CONDITION, QUALITY, OR PERFORMANCE. IN NO EVENT WILL MICROCHIP BE LIABLE FOR ANY INDIRECT, SPECIAL, PUNITIVE, INCIDENTAL OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND WHATSOEVER RELATED TO THE INFORMATION OR ITS USE, HOWEVER CAUSED, EVEN IF MICROCHIP HAS BEEN ADVISED OF THE POSSIBILITY OR THE DAMAGES ARE FORESEEABLE. TO THE FULLEST EXTENT ALLOWED BY LAW, MICROCHIP'S TOTAL LIABILITY ON ALL CLAIMS IN ANY WAY RELATED TO THE INFORMATION OR ITS USE WILL NOT EXCEED THE AMOUNT OF FEES, IF ANY, THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR THE INFORMATION. Use of Microchip devices in life support and/or safety applications is entirely at the buyer’s risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights unless otherwise stated.

Trademarks

The Microchip name and logo, the Microchip logo, Adaptec, AnyRate, AVR, AVR logo, AVR Freaks, BesTime, BitCloud, chipKIT, chipKIT logo, CryptoMemory, CryptoRF, dsPIC, FlashFlex, flexPWR, HELDO, IGLOO, JukeBlox, KeeLoq, Kleer, LANCheck, LinkMD, maXStylus, maXTouch, MediaLB, megaAVR, Microsemi, Microsemi logo, MOST, MOST logo, MPLAB, OptoLyzer, PackeTime, PIC, picoPower, PICSTART, PIC32 logo, PolarFire, Prochip Designer, QTouch, SAM-BA, SenGenuity, SpyNIC, SST, SST Logo, SuperFlash, Symmetricom, SyncServer, Tachyon, TempTrackr, TimeSource, tinyAVR, UNI/O, Vectron, and XMEGA are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. APT, ClockWorks, The Embedded Control Solutions Company, EtherSynch, FlashTec, Hyper Speed Control, HyperLight Load, IntelliMOS, Libero, motorBench, mTouch, Powermite 3, Precision Edge, ProASIC, ProASIC Plus, ProASIC Plus logo, Quiet-Wire, SmartFusion, SyncWorld, Temux, TimeCesium, TimeHub, TimePictra, TimeProvider, Vite, WinPath, and ZL are registered trademarks of Microchip Technology Incorporated in the U.S.A. Adjacent Key Suppression, AKS, Analog-for-the-Digital Age, Any Capacitor, AnyIn, AnyOut, BlueSky, BodyCom, CodeGuard, CryptoAuthentication, CryptoAutomotive, CryptoCompanion, CryptoController, dsPICDEM, dsPICDEM.net, Dynamic Average Matching, DAM, ECAN, EtherGREEN, In-Circuit Serial Programming, ICSP, INICnet, Inter-Chip Connectivity, JitterBlocker, KleerNet, KleerNet logo, memBrain, Mindi, MiWi, MPASM, MPF, MPLAB Certified logo, MPLIB, MPLINK, MultiTRAK, NetDetach, Omniscient Code Generation, PICDEM, PICDEM.net, PICkit, PICtail, PowerSmart, PureSilicon, QMatrix, REAL ICE, Ripple Blocker, SAM-ICE, Serial Quad I/O, SMART-I.S., SQI, SuperSwitcher, SuperSwitcher II, Total Endurance, TSHARC, USBCheck, VariSense, ViewSpan, WiperLock, Wireless DNA, and ZENA are trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. SQTP is a service mark of Microchip Technology Incorporated in the U.S.A. The Adaptec logo, Frequency on Demand, Silicon Storage Technology, and Symmcom are registered trademarks of Microchip Technology Inc. in other countries. GestIC is a registered trademark of Microchip Technology Germany II GmbH & Co. KG, a subsidiary of Microchip Technology Inc., in other countries. All other trademarks mentioned herein are property of their respective companies. © 2020, Microchip Technology Incorporated, Printed in the U.S.A., All Rights Reserved. ISBN:

Quality Management System

For information regarding Microchip’s Quality Management Systems, please visit www.microchip.com/quality.

AMERICAS ASIA/PACIFIC ASIA/PACIFIC EUROPE Corporate Office Australia - Sydney India - Bangalore Austria - Wels 2355 West Chandler Blvd. Tel: 61-2-9868-6733 Tel: 91-80-3090-4444 Tel: 43-7242-2244-39 Chandler, AZ 85224-6199 China - Beijing India - New Delhi Fax: 43-7242-2244-393 Tel: 480-792-7200 Tel: 86-10-8569-7000 Tel: 91-11-4160-8631 Denmark - Copenhagen Fax: 480-792-7277 China - Chengdu India - Pune Tel: 45-4485-5910 Technical Support: Tel: 86-28-8665-5511 Tel: 91-20-4121-0141 Fax: 45-4485-2829 www.microchip.com/support China - Chongqing Japan - Osaka Finland - Espoo Web Address: Tel: 86-23-8980-9588 Tel: 81-6-6152-7160 Tel: 358-9-4520-820 www.microchip.com China - Dongguan Japan - Tokyo France - Paris Atlanta Tel: 86-769-8702-9880 Tel: 81-3-6880- 3770 Tel: 33-1-69-53-63-20 Duluth, GA China - Guangzhou Korea - Daegu Fax: 33-1-69-30-90-79 Tel: 678-957-9614 Tel: 86-20-8755-8029 Tel: 82-53-744-4301 Germany - Garching Fax: 678-957-1455 China - Hangzhou Korea - Seoul Tel: 49-8931-9700 Austin, TX Tel: 86-571-8792-8115 Tel: 82-2-554-7200 Germany - Haan Tel: 512-257-3370 China - Hong Kong SAR Malaysia - Kuala Lumpur Tel: 49-2129-3766400 Boston Tel: 852-2943-5100 Tel: 60-3-7651-7906 Germany - Heilbronn Westborough, MA China - Nanjing Malaysia - Penang Tel: 49-7131-72400 Tel: 774-760-0087 Tel: 86-25-8473-2460 Tel: 60-4-227-8870 Germany - Karlsruhe Fax: 774-760-0088 China - Qingdao Philippines - Manila Tel: 49-721-625370 Chicago Tel: 86-532-8502-7355 Tel: 63-2-634-9065 Germany - Munich Itasca, IL China - Shanghai Singapore Tel: 49-89-627-144-0 Tel: 630-285-0071 Tel: 86-21-3326-8000 Tel: 65-6334-8870 Fax: 49-89-627-144-44 Fax: 630-285-0075 China - Shenyang Taiwan - Hsin Chu Germany - Rosenheim Dallas Tel: 86-24-2334-2829 Tel: 886-3-577-8366 Tel: 49-8031-354-560 Addison, TX China - Shenzhen Taiwan - Kaohsiung Israel - Ra’anana Tel: 972-818-7423 Tel: 86-755-8864-2200 Tel: 886-7-213-7830 Tel: 972-9-744-7705 Fax: 972-818-2924 China - Suzhou Taiwan - Taipei Italy - Milan Detroit Tel: 86-186-6233-1526 Tel: 886-2-2508-8600 Tel: 39-0331-742611 Novi, MI China - Wuhan Thailand - Bangkok Fax: 39-0331-466781 Tel: 248-848-4000 Tel: 86-27-5980-5300 Tel: 66-2-694-1351 Italy - Padova Houston, TX China - Xian Vietnam - Ho Chi Minh Tel: 39-049-7625286 Tel: 281-894-5983 Tel: 86-29-8833-7252 Tel: 84-28-5448-2100 Netherlands - Drunen Indianapolis China - Xiamen Tel: 31-416-690399 Noblesville, IN Tel: 86-592-2388138 Fax: 31-416-690340 Tel: 317-773-8323 China - Zhuhai Norway - Trondheim Fax: 317-773-5453 Tel: 86-756-3210040 Tel: 47-72884388 Tel: 317-536-2380 Poland - Warsaw Los Angeles Tel: 48-22-3325737 Mission Viejo, CA Romania - Bucharest Tel: 949-462-9523 Tel: 40-21-407-87-50 Fax: 949-462-9608 Spain - Madrid Tel: 951-273-7800 Tel: 34-91-708-08-90 Raleigh, NC Fax: 34-91-708-08-91 Tel: 919-844-7510 Sweden - Gothenberg New York, NY Tel: 46-31-704-60-40 Tel: 631-435-6000 Sweden - Stockholm San Jose, CA Tel: 46-8-5090-4654 Tel: 408-735-9110 UK - Wokingham Tel: 408-436-4270 Tel: 44-118-921-5800 Canada - Toronto Fax: 44-118-921-5820 Tel: 905-695-1980 Fax: 905-695-2078