RS232. • RS485. • USBI2C. • USBSPI. • USBUART. • RN2483 – LoRa. • RN2903 – Lora 2. • GPSNano. • RFid. • WiFi Plus. • WiFly. • RN4020 – BLE 2.
MPLAB Code Configurator | Microchip Technology
MPLAB® Code Configurator MikroElektronika Click Library v1.1.3 Release Notes What is the MPLAB® Code Configurator's MikroElektronika ClickLibrary The MikroElektronika Click library provides software drivers for many of the Click development boards provided by MikroElektronika. System Requirements · MPLAB® X IDE v5.45 or later · XC8 compiler v2.31 or later · XC16 compiler v1.61 or later · XC32 compiler v2.50 or later · MCC plugin v4.0.2 or later · PIC10/PIC12/PIC16/PIC18 MCUs device library v1.81.7 or later · PIC24/dsPIC33/PIC32MM MCUs device library v1.170.0 or later · Foundation Services Library v0.2.2 or later The Foundation Services library must be downloaded and installed along with this library. · LIN Library v2.2 or later The LIN Library must be downloaded and installed along with this library. · TCP/IP Lite Stack v2.2.13 or later The TCP/IP Lite Stack Library must be downloaded and installed along with this library. Installing the MPLAB® Code Configurator MikroElektronika Click Library Basic steps for installing MPLAB® Code Configurator plugin and libraries: To install the MPLAB® Code Configurator Plugin: 1. In the MPLAB® X IDE, select Plugins from the Tools menu. 2. Select the Available Plugins tab. 3. Check the box for the MPLAB® Code Configurator, and click on Install . To install the MCC MikroElektronika Click Library v1.1.3: 1. Download mikroEClickLibrary_v1.1.3.jar from the Microchip website. 2. In the MPLAB® X IDE, select Options from the Tools menu (Preferences menu on MAC). 3. Select Plugins tab 4. Click on Install Library 5. Add mikroEClickLibrary_v1.1.3.jar 6. Restart MPLAB® X IDE To load different peripheral library version: © 2021 Microchip Technology Inc. and its subsidiaries Release Note mikroEClickLibrary-1.1.3-page 1 1. Open Embedded > MPLAB® Code Configurator v4 from the Tools menu. 2. In the Versions tab under MikroElektronika Click Library, find the multiple library version (loaded version is indicated by the green check). 3. Right-click on the required version of the library and select Mark for load. 4. Click on Load Selected Libraries button to load the library. Running the Examples Examples are provided in each click module. To use these examples, make sure you include the example header into your main file, and then call the example function provided. Many of these examples use printf. If the Xpress Evaluation Board is used, note that it has a CDC device implementation and will enumerate as a COM port on your machine. Follow the steps below in order to enable printf commands to write to the COM port. 1. UART Pins on Xpress Evaluation Board The Xpress Evaluation board, which uses the PIC16F18855, is capable of writing to the serial port as long as the following settings are configured: Figure 1. Setting the EUSART's RX and TX pins to RC1 and RC0 respectively Figure 2. Redirecting STDIO to USART in the Hardware Settings tab of the EUSART module 2. I2C and SPI Pins on Xpress Evaluation Board Figure 3. Setting the I2C Pins © 2021 Microchip Technology Inc. and its subsidiaries Release Note mikroEClickLibrary-1.1.3-page 2 Figure 4. Setting the SPI Pins 3. Analog Pin on Xpress Evaluation Board Figure 5. Setting the Analog Pins What's New? · 1.1.3 Removed support for AVR devices. · 1.1.2 Compatibility update with MCC Plugin v4.0.2 and MCC Core v5.0.2 Fixed XC8 build failures on 8-bit devices · 1.1.1 Extended the below listed MikroElektronika clicks support to AVR, PIC24/dsPIC, and PIC32MM devices · OLED C, Thumbstick, Accel 3, Weather, EEPROM 2, LCD mini, Heart rate, 8x8 G, and 7seg Bug fixes and improvements Repairs and Enhancements None. © 2021 Microchip Technology Inc. and its subsidiaries Release Note mikroEClickLibrary-1.1.3-page 3 Known Issues # ID Description 1 MCC_CLICK-239 Clicks using ADC: Code generation failure after reload 2 MCCV3XX-8601 WiFly Click Not Working with Xpress Eval Board 3 MCC_CLICK-482 USB I2C click build failure 4 MCC_CLICK-487 GPS3 and Nano GPS clicks - Hardcoded INTCON register Device(s) Affected All All All PIC18FxxK42, PIC18FxxK83, PIC18FxxQ43, PIC18FxxQ83/84, PIC18FxxQ40/41 FAQ For frequently asked questions, please refer to the FAQ post on the MCC Forum (http://www.microchip.com/forums/ f293.aspx) Supported Clicks · ACCEL3 · Air Quality · Alcohol · Altitude · CO · Compass 2 · Current · Diff Pressure · Gyro · Hydrogen · HDC1000 · LPG · Methane · Noise · Ozone · Weather · Counter · EEPROM · EEPROM 2 · EEPROM 3 · FLASH 2 · RTCC 5 · Thumb stick · Touchpad · ADC · ADC2 · ADC3 · Ammeter · DAC · DAC3 · DigiPot · Relay · 4-20 mA R · 4-20 mA T · ETH · Expand · MCP2003B · RS232 · RS485 · USBI2C · USBSPI · USBUART · RN2483 LoRa · RN2903 Lora 2 · GPSNano · RFid · WiFi Plus · WiFly · RN4020 BLE 2 · RN41 Bluetooth · GPS 3 · GSM · GSM 2 · MCP25625 · CANSPI · Proximity 2 · nRFC · LED8X8G · Thermo 5 · Fan · eInk · LCD Mini · OLED C · LED 7 Seg · AC Current · Stereo Amp · SRAM · Audio Amp · 7x10R · Line Follower · MIC24045 · RTC 6 · BT Audio · Light Ranger Supported Devices and Families The MCC MikroElektronika Click Library v1.1.3 supports the following families: · 8 bit Families Devices supported by latest pic10-pic12-pic16-pic18 MCU library · 16 bit Families 16-bit devices supported by latest pic24-dspic33-pic32mm library · 32 bit Families © 2021 Microchip Technology Inc. and its subsidiaries Release Note mikroEClickLibrary-1.1.3-page 4 PIC32MM family of devices supported by latest pic24-dspic33-pic32mm library © 2021 Microchip Technology Inc. and its subsidiaries Release Note mikroEClickLibrary-1.1.3-page 5 Table of Contents What is the MPLAB® Code Configurator's MikroElektronika ClickLibrary......................................................1 1. System Requirements.................................................................................................................. 1 2. Installing the MPLAB® Code Configurator MikroElektronika Click Library................................... 1 3. Running the Examples................................................................................................................. 2 4. What's New?................................................................................................................................ 3 5. Repairs and Enhancements......................................................................................................... 3 6. Known Issues............................................................................................................................... 4 7. FAQ.............................................................................................................................................. 4 8. Supported Clicks.......................................................................................................................... 4 9. Supported Devices and Families..................................................................................................4 The Microchip Website...................................................................................................................................7 Product Change Notification Service..............................................................................................................7 Customer Support.......................................................................................................................................... 7 Microchip Devices Code Protection Feature.................................................................................................. 7 Legal Notice................................................................................................................................................... 8 Trademarks.................................................................................................................................................... 8 Quality Management System......................................................................................................................... 9 Worldwide Sales and Service.......................................................................................................................10 © 2021 Microchip Technology Inc. and its subsidiaries Release Note mikroEClickLibrary-1.1.3-page 6 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. © 2021 Microchip Technology Inc. and its subsidiaries Release Note mikroEClickLibrary-1.1.3-page 7 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, TimeSource, tinyAVR, UNI/O, Vectron, and XMEGA are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. AgileSwitch, 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, 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, Augmented Switching, BlueSky, BodyCom, CodeGuard, CryptoAuthentication, CryptoAutomotive, CryptoCompanion, CryptoController, dsPICDEM, dsPICDEM.net, Dynamic Average Matching, DAM, ECAN, Espresso T1S, EtherGREEN, IdealBridge, In-Circuit Serial Programming, ICSP, INICnet, Intelligent Paralleling, Inter-Chip Connectivity, JitterBlocker, maxCrypto, maxView, 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, RTAX, RTG4, SAM-ICE, Serial Quad I/O, simpleMAP, SimpliPHY, SmartBuffer, SMART-I.S., storClad, SQI, SuperSwitcher, SuperSwitcher II, Switchtec, SynchroPHY, Total Endurance, TSHARC, USBCheck, VariSense, VectorBlox, VeriPHY, ViewSpan, WiperLock, XpressConnect, 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. © 2021, Microchip Technology Incorporated, Printed in the U.S.A., All Rights Reserved. ISBN: © 2021 Microchip Technology Inc. and its subsidiaries Release Note mikroEClickLibrary-1.1.3-page 8 Quality Management System For information regarding Microchip's Quality Management Systems, please visit www.microchip.com/quality. © 2021 Microchip Technology Inc. and its subsidiaries Release Note mikroEClickLibrary-1.1.3-page 9 AMERICAS Corporate Office 2355 West Chandler Blvd. Chandler, AZ 85224-6199 Tel: 480-792-7200 Fax: 480-792-7277 Technical Support: www.microchip.com/support Web Address: www.microchip.com Atlanta Duluth, GA Tel: 678-957-9614 Fax: 678-957-1455 Austin, TX Tel: 512-257-3370 Boston Westborough, MA Tel: 774-760-0087 Fax: 774-760-0088 Chicago Itasca, IL Tel: 630-285-0071 Fax: 630-285-0075 Dallas Addison, TX Tel: 972-818-7423 Fax: 972-818-2924 Detroit Novi, MI Tel: 248-848-4000 Houston, TX Tel: 281-894-5983 Indianapolis Noblesville, IN Tel: 317-773-8323 Fax: 317-773-5453 Tel: 317-536-2380 Los Angeles Mission Viejo, CA Tel: 949-462-9523 Fax: 949-462-9608 Tel: 951-273-7800 Raleigh, NC Tel: 919-844-7510 New York, NY Tel: 631-435-6000 San Jose, CA Tel: 408-735-9110 Tel: 408-436-4270 Canada - Toronto Tel: 905-695-1980 Fax: 905-695-2078 Worldwide Sales and Service ASIA/PACIFIC Australia - Sydney Tel: 61-2-9868-6733 China - Beijing Tel: 86-10-8569-7000 China - Chengdu Tel: 86-28-8665-5511 China - Chongqing Tel: 86-23-8980-9588 China - Dongguan Tel: 86-769-8702-9880 China - Guangzhou Tel: 86-20-8755-8029 China - Hangzhou Tel: 86-571-8792-8115 China - Hong Kong SAR Tel: 852-2943-5100 China - Nanjing Tel: 86-25-8473-2460 China - Qingdao Tel: 86-532-8502-7355 China - Shanghai Tel: 86-21-3326-8000 China - Shenyang Tel: 86-24-2334-2829 China - Shenzhen Tel: 86-755-8864-2200 China - Suzhou Tel: 86-186-6233-1526 China - Wuhan Tel: 86-27-5980-5300 China - Xian Tel: 86-29-8833-7252 China - Xiamen Tel: 86-592-2388138 China - Zhuhai Tel: 86-756-3210040 ASIA/PACIFIC India - Bangalore Tel: 91-80-3090-4444 India - New Delhi Tel: 91-11-4160-8631 India - Pune Tel: 91-20-4121-0141 Japan - Osaka Tel: 81-6-6152-7160 Japan - Tokyo Tel: 81-3-6880- 3770 Korea - Daegu Tel: 82-53-744-4301 Korea - Seoul Tel: 82-2-554-7200 Malaysia - Kuala Lumpur Tel: 60-3-7651-7906 Malaysia - Penang Tel: 60-4-227-8870 Philippines - Manila Tel: 63-2-634-9065 Singapore Tel: 65-6334-8870 Taiwan - Hsin Chu Tel: 886-3-577-8366 Taiwan - Kaohsiung Tel: 886-7-213-7830 Taiwan - Taipei Tel: 886-2-2508-8600 Thailand - Bangkok Tel: 66-2-694-1351 Vietnam - Ho Chi Minh Tel: 84-28-5448-2100 EUROPE Austria - Wels Tel: 43-7242-2244-39 Fax: 43-7242-2244-393 Denmark - Copenhagen Tel: 45-4485-5910 Fax: 45-4485-2829 Finland - Espoo Tel: 358-9-4520-820 France - Paris Tel: 33-1-69-53-63-20 Fax: 33-1-69-30-90-79 Germany - Garching Tel: 49-8931-9700 Germany - Haan Tel: 49-2129-3766400 Germany - Heilbronn Tel: 49-7131-72400 Germany - Karlsruhe Tel: 49-721-625370 Germany - Munich Tel: 49-89-627-144-0 Fax: 49-89-627-144-44 Germany - Rosenheim Tel: 49-8031-354-560 Israel - Ra'anana Tel: 972-9-744-7705 Italy - Milan Tel: 39-0331-742611 Fax: 39-0331-466781 Italy - Padova Tel: 39-049-7625286 Netherlands - Drunen Tel: 31-416-690399 Fax: 31-416-690340 Norway - Trondheim Tel: 47-72884388 Poland - Warsaw Tel: 48-22-3325737 Romania - Bucharest Tel: 40-21-407-87-50 Spain - Madrid Tel: 34-91-708-08-90 Fax: 34-91-708-08-91 Sweden - Gothenberg Tel: 46-31-704-60-40 Sweden - Stockholm Tel: 46-8-5090-4654 UK - Wokingham Tel: 44-118-921-5800 Fax: 44-118-921-5820 © 2021 Microchip Technology Inc. and its subsidiaries Release Note mikroEClickLibrary-1.1.3-page 10Antenna House PDF Output Library 7.0.1621