1. What is Microchip Application Libraries?

Microchip Application Libraries is a collection of Microchip firmware libraries and demo projects. Not all firmware libraries and demo projects from Microchip are distributed in this package; rather, this package includes a few specific libraries that tend to be used together.

By distributing libraries that are used often together, Microchip can provide example projects that integrate the use of multiple libraries.

Some example projects that use multiple libraries are:

Graphics MultiApp Demo

PIC18F Starter Kit 1

PIC24F Starter Kit 1

PIC24H Starter Kit 1

TCPIP MDD Demo App

USB Host – Printer – Print Screen Demo

USB Host – Printer – Simple Full Sheet Demo

USB Host – Printer – Simple POS Demo

The Microchip Applications Libraries is currently being distributed mainly in the source code form to provide the maximum flexibility for end designers to customize firmware to fit his/her applications.

2. Installing/Uninstalling

To obtain the latest version of the Microchip Application Libraries, you can download it from the Microchip web site at www.microchip.com/MAL.

Once the installation package is downloaded, first unzip (if zipped) the downloaded zip file and run the installer.

If installing over an existing Microchip Application Libraries folder location, files that will be overwritten are back-up to the folder named ‘rollbackBackupDirectory’.

One or more third party libraries maybe required to run PC programs, this includes but not be limited to Java Runtime Environment (JRE), Qt framework, and/or .NET framework.

For Java programs (.jar extension), the jar files must be associated with the JRE in order to run.

MPLAB X demo projects are currently classified as beta. No MPLAB 8 projects are supported in the Mac and Linux distributions, even though you may see MPLAB 8 projects in the install. OS specific executables are installed in all distributions.

Some users may need to install multiple instances of the distribution; this can be done simply by selecting a different installation path and shortcut menu folder.

When upgrading from a previous version, it is recommended that users install the newer installation to a different installation path, and then consult each individual library release notes for changes that may impact application project. This method is safer than just overwriting the previous installation.

Microchip Application Libraries can be uninstalled by either running the uninstaller or simply delete the root installed folder. Either ways, users should make sure to back-up any modified files.

3. What’s new/changed in v2011-07-14

This release includes beta support for MPLAB X projects. The projects were tested with MPLAB X beta 6. Most demo projects have both MPLAB 8 and X projects but not all may have MPLAB X projects. Use MPLAB X project import wizard to convert MPLAB 8 project.

MPLAB X projects utilize the Built Configuration feature extensively. For each demo, it can run on many different hardware setups, select the appropriate build configuration setting for the supported hardware.

For a full list of changes, read each individual library’s release notes after installation. This section provides only a summary of key changes:

Key Summary:

Library	Current Version	Previous Version	PIC Family Supported
Library	Current Version	Previous Version	PIC16F (8-bit)	PIC18F (8-bit)	PIC24F (16-bit)	PIC24H (16-bit)	dsPIC (16-bit)	PIC32 (32-bit)
MCHPFSUSB Framework	2.9a	2.9		x	x		x	x
Graphics Library	3.01	3.00			x	x	x	x
Memory Disk Drive (MDD)	1.3.2	1.3		x	x	x	x	x
TCP/IP Stack	5.36.2	5.36		x	x	x	x	x
mTouchCap Library	1.31	1.31	x	x	x			x
Smart Card Library	1.02.2	1.02		x	x	x	x	x
MiWi™ DE	4.2.2	4.2		x	x	x	x	x
Accessory Framework for Android™	1.0.1	1.0.0			x			x

3.1 MCHPFSUSB Framework

Updated in v2.9a

Fixed issue in cross platform HID boot loader for non-increasing address hex files.

Updated in v2.9

Device

Bug fixes and enhancements
Added PHDC device class demo

Host/OTG/Dual Role

Bug fixes and enhancements
Android OpenAccessory host mode demo

PC Utilities

Cross platform HID boot loader program
Cross platform custom HID example application

New Product Support: dsPIC33EP & PIC24EP families

For more information about the specific changes in this revision, please refer to the Revision History section of the MCHPFSUSB Library Help file available in the library download.

3.2 Graphics Library

Update in v3.01

Updated External Memory Programmer driver package, now supports 32/64-bit for both Serial and USB.
Bug fixes
Documentation updates

Updated in v3.00

Streamlined driver layer architecture
New hardware support for Epson S1D13517 controller and PIC32 Low-Cost Controllerless Graphics PICtail
Added VGA and WVGA board support
New Touch driver architecture and added AR1020 driver support
Ported External Memory Programmer to java
Added USB and optimized transfer performance to External Memory Programmer
Added PIC24F_DA (210) specific demo
Added Epson S1D13517 specific demo
Added Run-length Encoding support
Added 24bpp support
Updated Graphics Resource Converter with many new features
Bug fixes
New Product Support: dsPIC33EP & PIC24EP families

For more information about the specific changes in this revision, please refer to the detailed release notes in the Graphics Library Help file available in the library download.

3.3 MDD Library

Updated in v1.3.2

Modified SD-SPI.c, MDD_SDSPI_AsyncWriteTasks() so pre-erase command only gets used for multi-block write scenarios.

Updated in v1.3.0

Long file name support

3.4 TCP/IP Stack

Updated in v5.36.2

Removed Google PowerMeter related demos. Google, Inc. has deprecated Google PowerMeter and has expressed the intent to remove access to it on September 16, 2011. To obtain Microchip Technology's Google PowerMeter reference implementation, you can download the June 2011 Microchip Application Libraries archived release from www.microchip.com/mal.
Fixed MPLAB X projects
Bug fixes in SNMP demo
Removed the SPI2CON register freeze-on-halt bit macro from the SPIFlash, RAM, and EEPROM driver files to provide compatibility with C32 v2.00.
Documentation Updates

Updated in v5.36

Bug fixes
New Product Support: dsPIC33EP & PIC24EP families

For more information about the specific changes in this revision, please refer to the detailed release notes in the TCPIP Stack Help file available in the library download.

3.5 mTouchCap Library

CTMU mTouch Library support for new devices
PIC16F CVD Framework addition
PIC32MX CVD differential measurement addition
Bug fixes

3.6 Smart Card Library

Bug fixes

3.7 MiWi™ DE

Updates in v4.2.2

Add support for MRF24J40MC OEM module

Updates in v4.2

Add support for MiWi PRO protocol that supports large networks up to 65 hops
Add initial support for MPLAB X Beta 6
Provide demo source code for Microchip Wireless Development Kit
Provide testing interface for MiWi PRO protocol
Bug fixes.

3.8 Accessory Framework for Android™

Documentation update.

4. Known MPLAB X beta 6 compatibility issues

This section describes known issues related to the MPLAB X beta 6.

- In the project properties dialog box, the C30 linker option (pic30-ld), the ‘Allow overlapped sections’ checkbox is indicating the opposite of actual behavior.

- When importing a PIC18 MPLAB 8 project with the large data model option selected, that option may not get imported and is set back to the default of small code model.

- C30 v3.30 ELF library may not link successfully for some projects. The ELF library is the only option that can be used with MPLAB X beta 6. Use C30 v3.30b instead.

5. Customer Support

The Microchip Web Site

Microchip provides online support via our web site at http://www.microchip.com. This web site is used as a means to make files and information easily available to customers. Accessible by using your favorite Internet browser, the web site contains the following information:

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 (http://support.microchip.com), online discussion groups/forums (http://forum.microchip.com), Microchip consultant 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

Development Systems Customer Change Notification Service

Microchip's customer notification service helps keep customers current on Microchip products. Subscribers will receive e-mail notification whenever there are changes, updates, revisions or errata related to a specified product family or development tool of interest.

To register, access the Microchip web site at www.microchip.com, click on Customer Change Notification and follow the registration instructions.

Additional Support

Users of Microchip products can receive assistance through several channels:

Distributor or Representative
Local Sales Office
Field Application Engineer (FAE)
Technical Support

Customers should contact their distributor, representative or field application engineer (FAE) for support. Local sales offices are also available to help customers. A listing of sales offices and locations is available on our website.

Technical support is available through the web site at: http://support.microchip.com

Training

Regional Training Centers: http://www.microchip.com/rtc
MASTERs Conference: http://www.microchip.com/masters
Webseminars: http://techtrain.microchip.com/webseminars/QuickList.aspx

Appendix A: List of all PIC demo projects and folder paths

Android Accessories\Basic Communication Demo - Host mode

Combo\Google Map

Graphics\AppNotes

Graphics\Common

Graphics\External Memory

Graphics\Image Decoders

Graphics\JPEG

Graphics\Multi-App

Graphics\Object Layer

Graphics\Object Layer Palette

Graphics\PIC24F_DA

Graphics\Primitive Layer

Graphics\S1D13517

Graphics\SSD1926

MDD File System-SD Card

MDD File System-SD Data Logger

MiWi DE Demo\8-bit Wireless Development Kit - 2.4 GHz IEEE 802.15.4\8-bit WDK Demo

MiWi DE Demo\8-bit Wireless Development Kit - 2.4 GHz IEEE 802.15.4\Tutorial3 - RFD Device

MiWi DE Demo\8-bit Wireless Development Kit - 2.4 GHz IEEE 802.15.4\Tutorial4 - Chat Window Demo

MiWi DE Demo\8-bit Wireless Development Kit - 2.4 GHz IEEE 802.15.4\Tutorial5 - Ping Pong Demo

MiWi DE Demo\Basic Demos\Feature Demo

MiWi DE Demo\Basic Demos\Simple Example

MiWi DE Demo\MiWi PRO Test Interface

mTouchCapDemos\PIC16F_CVD_Demos\Cap Touch CSM-CVD Eval Board 04-02091 Rev D1\code - no cover

mTouchCapDemos\PIC16F_CVD_Demos\Cap Touch CSM-CVD Eval Board 04-02091 Rev D1\code - with cover

mTouchCapDemos\PIC16F_CVD_Demos\Cap Touch CVD Eval Board 233-04-2028 Rev B\code - no cover

mTouchCapDemos\PIC16F_CVD_Demos\Cap Touch CVD Eval Board 233-04-2028 Rev B\code - with cover

mTouchCapDemos\PIC16F_CVD_Demos\PIC12F1822 Example - 4 sensors\code - no cover

mTouchCapDemos\PIC16F_CVD_Demos\PIC16F617 Example - 4 Sensors\code - no cover

mTouchCapDemos\PIC16F_CVD_Demos\PIC16F1936 Example - 4 sensors\code - 2mm cover

mTouchCapDemos\PIC16F_CVD_Demos\PIC16F1936 Example - 4 sensors\code - metal over capacitive (3.5V)

mTouchCapDemos\PIC16F_CVD_Demos\PIC16F1936 Example - 4 sensors\code - no cover

mTouchCapDemos\PIC18FDemos\mTouchCap_2ChSlider

mTouchCapDemos\PIC18FDemos\mTouchCap_4ChSlider

mTouchCapDemos\PIC18FDemos\mTouchCap_Combo

mTouchCapDemos\PIC18FDemos\mTouchCap_DirectKey

mTouchCapDemos\PIC18FDemos\mTouchCap_GUI

mTouchCapDemos\PIC18FDemos\mTouchCap_MatrixKey

mTouchCapDemos\PIC24FDemos\mTouchCap_2ChSlider

mTouchCapDemos\PIC24FDemos\mTouchCap_4ChSlider

mTouchCapDemos\PIC24FDemos\mTouchCap_AN1317

mTouchCapDemos\PIC24FDemos\mTouchCap_Combo

mTouchCapDemos\PIC24FDemos\mTouchCap_DA210Graphics

mTouchCapDemos\PIC24FDemos\mTouchCap_DirectKey

mTouchCapDemos\PIC24FDemos\mTouchCap_Gesture

mTouchCapDemos\PIC24FDemos\mTouchCap_GUI

mTouchCapDemos\PIC24FDemos\mTouchCap_Low Power

mTouchCapDemos\PIC24FDemos\mTouchCap_MatrixKey

mTouchCapDemos\PIC24FDemos\mTouchCap_Proximity

mTouchCapDemos\PIC32MX_Demos\mTouchCap_2Ch_SliderDemo

mTouchCapDemos\PIC32MX_Demos\mTouchCap_4Ch_SliderDemo

mTouchCapDemos\PIC32MX_Demos\mTouchCap_DirectKeyDemo

mTouchCapDemos\PIC32MX_Demos\mTouchCap_MatrixKeyDemo

PIC18F Starter Kit 1

PIC24F Starter Kit 1

PIC24H Starter Kit 1\External_Sensor_Demo

PIC24H Starter Kit 1\MPLAB_Starter_Kit_for_PIC24H_Demo

Smart Card Demo

TCPIP\Demo App

TCPIP\Demo App MDD

TCPIP\Energy Monitoring

TCPIP\Internet Bootloader

TCPIP\Internet Radio

TCPIP\WebVend

TCPIP\WiFi Console

TCPIP\WiFi EZConfig

USB\Device - Audio - Microphone

USB\Device - Audio - MIDI

USB\Device - Audio - Speaker

USB\Device - Bootloaders

USB\Device - CCID - Smart Card Reader

USB\Device - CDC - Basic Demo

USB\Device - CDC - Serial Emulator

USB\Device - Composite - HID + MSD

USB\Device - Composite - MSD + CDC

USB\Device - Composite - WinUSB + MSD

USB\Device - HID - Custom Demos

USB\Device - HID - Digitizers

USB\Device - HID - Joystick

USB\Device - HID - Keyboard

USB\Device - HID - Mouse

USB\Device - HID - Uninterruptible Power Supply

USB\Device - LibUSB - Generic Driver Demo

USB\Device - Mass Storage - Internal Flash

USB\Device - Mass Storage - SD Card data logger

USB\Device - Mass Storage - SD Card reader

USB\Device - MCHPUSB - Generic Driver Demo

USB\Device - PHDC - Weighing Scale

USB\Device - WinUSB - Generic Driver Demo

USB\Device - WinUSB - High Bandwidth Demo

USB\Dual Role - MSD host + HID device

USB\Host - Bootloaders

USB\Host - CDC - Serial Demo

USB\Host - Charger - Simple Charger

USB\Host - Composite - HID + MSD

USB\Host - Composite - MSD + CDC

USB\Host - HID - Keyboard

USB\Host - HID - Mouse

USB\Host - Mass Storage - Simple Demo

USB\Host - Mass Storage - Thumb Drive Data Logger

USB\Host - MCHPUSB - Generic Driver Demo

USB\Host - Printer - Print Screen Demo

USB\Host - Printer - Simple Full Sheet Demo

USB\Host - Printer - Simple POS Demo

USB\Low Pin Count Development Board

USB\OTG - MCHPUSB - Generic Driver Demo

Trademarks:

The Microchip name and logo, the Microchip logo, MPLAB, and PIC are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries.

Android is a trademark of Google Inc