Release Notes for MPLAB® IDE v7.40

May 15, 2006

Table of Contents

1      PC Operating System Support List

2      Reference Documents

3      Minimum Required Configuration

4      Installing/Uninstalling MPLAB IDE - Microchip Website

5      Installing/Uninstalling MPLAB IDE - CD-ROM

6      Network Administrator Information

7      Multiple Installations of MPLAB IDE v7.xx and later

8      What's New/Updated in v7.40

9      Known Problems

10     Third Party Support

11     Customer Support

12     License Agreements

1         PC Operating System Support List

This tool has been tested under the following PC operating systems:

Windows® 98 SE*, Windows ME*, Windows NT 4.0 SP6a Workstations (NOT Servers), Windows 2000 SP4, Windows XP SP2

* These OS's do not support Unicode editor.

Tools associated with MPLAB IDE may not support the same operating systems as MPLAB IDE. See individual tool readme's for more information.

IMPORTANT NOTICE: Beginning with the MPLAB IDE release this fall, MPLAB IDE and its related components (except those listed below) will not longer be tested on Windows 98, Windows ME, or Windows NT.  MPLAB IDE and its related components may continue to work under these operating systems, but their operation will not longer be verified through testing.

·         Microchip will continue to support Visual ProCMD and PM3CMD on Windows 98.

2         Reference Documents

The following documents may be found on our website or MPLAB IDE CD-ROM:

·         MPLAB IDE User's Guide (DS51519)

·         MPLAB IDE Quick Start Guide (DS51281)

·         MPLAB IDE Quick Chart (DS51410)

On-line help (Help>Topics) is also available for this tool:

·         System>MPLAB IDE - hlpMPLABIDE.chm

·         System>Editor - hlpMPLABEditor.chm

3         Minimum Required Configuration

The following minimum configuration is required to run MPLAB IDE:

·         PC-compatible Pentium®-class system

·         Supported Windows operating system (see section 1)

·         128 MB memory (512 MB recommended)

·         200 MB of hard disk space

·         Internet Explorer 5.0 or greater for installation and on-line Help

4         Installing/Uninstalling MPLAB IDE - Microchip Website

4.1        Installing MPLAB IDE

For some Windows OS’s, you will need administrative access in order to install software on your PC.

·         Go to the Microchip website using the IE browser. Locate the MPLAB IDE page and click the software link to launch the installation wizard.

·         In the wizard, select either a complete (all tools) or custom installation. Follow other wizard steps to complete the installation setup and then begin the download installation of MPLAB Tools.

·         Error 1311: If you receive this error while attempting to install, go to your Windows Temporary Internet files folder, delete all files, and then attempt to download again. For example, in Microsoft Internet Explorer, select Tools>Internet Options. On the General tab, under "Temporary Internet files", click "Delete Files".

·         For general installation program problems, consult http://consumer.installshield.com/

NOTE: Microsoft recommends reinstalling the service pack after ANY software or device driver is installed on an NT system. Refer to http://support.microsoft.com/default.aspx?scid=kb;en-us;196269 for additional information.

4.2        Changing/Uninstalling MPLAB IDE

·         Select Start>Programs>Microchip>MPLAB IDE v7.xx>Setup MPLAB Tools.

·         When the dialog box appears, select either "Modify", "Repair" or "Remove" and then click "Next".
NOTE: You will need to be connected to the internet if you modify or repair MPLAB IDE.

·         After an uninstall (Remove), the installation directory can be deleted.

5         Installing/Uninstalling MPLAB IDE - CD-ROM

5.1        Installing MPLAB IDE

For some Windows OS’s, you will need administrative access in order to install software on your PC.

·         Place the CD-ROM into the drive. Follow the MPLAB Tools dialogs to set up and then install MPLAB IDE. If no MPLAB Tools install wizard appears, use Windows Explorer to find and execute this file by double-clicking on the executable file "setup.exe".

·         For general installation program problems, consult http://customer.installshield.com.

NOTE: Microsoft recommends reinstalling the service pack after ANY software or device driver is installed on an NT system. Refer to http://support.microsoft.com/default.aspx?scid=kb;en-us;196269 for additional information.

5.2        Changing/Uninstalling MPLAB IDE

·         Select Start>Programs>Microchip>MPLAB IDE v7.xx>Setup MPLAB Tools.

·         When the dialog box appears, select either "Modify", "Repair" or "Remove" and then click "Next".

·         After an uninstall (Remove), the installation directory can be deleted.

6         Network Administrator Information

Note to network administrators on installing MPLAB IDE v7.30 and later in a secure environment:

"MPLAB_X_YY.MST" file is a Windows installer transform file, located in the full zipped installation of MPLAB IDE vX.YY. This file can be used by domain administrators with Microsoft Active Directory and group policies to assign the application for software deployment in a security environment (local machines do not have admin rights). Microsoft Active Directory can be used to assign the application to local workstations. It has not been tested for "assigning/publishing to users." If this is a first time install, you may need to install the isscript10.msi first. Apply the transform file to the ‘MPLAB_X_YY.MSI’ installation file in the group policy object (GPO). All of the files in the MPLAB IDE vX.YY full download zip must be located on a shared network directory.

7         Multiple Installations of MPLAB IDE v7.xx and later

Multiple versions of MPLAB IDE v7.xx may be INSTALLED on the same PC.

NOTE: You still may not RUN multiple versions of MPLAB IDE at the same time, i.e., only one version will be registered on the PC.

If necessary, you may switch between installed MPLAB IDE versions (i.e., change which one is registered) by following these steps:

To switch between v7.00 through v7.10:

·         Open a Command Prompt window (Start>Programs>Accessories>Command Prompt).

·         Find the installation directory of the v7.xx that you want to run.

·         In the MPLAB IDE Common directory, execute "mpswitch.exe -l" to determine the installed v7.xx versions of MPLAB IDE on your system. The version marked with an asterisk is the active version.

·         Execute "mpswitch.exe <version>", where <version> is the v7.xx to which you wish to switch. For example, to switch from MPLAB IDE 7.01 to MPLAB IDE 7.00:
C:> mpswitch.exe 7.00

To switch between v7.11 and v7.20 (and later versions):

·         Double-click on the icon of the version you wish to run.

8         What's New/Updated in v7.40

·         Find in Files - Search through files located anywhere on your system without leaving the MPLAB editor.

·         User Defined Window Sets - Customize your window arrangements and toolbars to maximize productivity at each stage of your design cycle.

·         Code Folding - Collapse/expand C functions for more manageable source code.

·         Code Browsing - Reduce the time spent searching through code: variable and function definitions are summoned from any reference.

·         DCMI Plug-in Appegia - Control application variables dynamically; view data graphically using up to four configurable graph windows

·         MPLAB C30 Compiler optimization control - Set complex speed and code size optimizations with new graphical dialog.

·         MPLAB SIM Logic Analyzer Busses - Group monitored channels as busses to be graphed on the logic analyzer display.

·         Run to main() - Execute initialization code then halt the system for instant debug control at the beginning of user C code .

·         README files now in HTML - Navigate easily through hotlinks for information in the READMEs.

·         PM3 retain EE data - Re-flash devices without erasing EE data.

·         New device support - See the README files for details on new device support for the various MPLAB components.

9         Known Problems

The following is a list of known problems. For information on common problems, error messages and limitations, please see Troubleshooting in the online help file for MPLAB IDE (hlpMPLABIDE.chm).

9.1        General Issues

"Access Denied" message when trying to open a workspace. Make sure the workspace and related files have not been set to read-only, i.e., right-click on a file, select "Properties", and check that "Read-only" is NOT selected.

"File not found" error on Windows NT systems, usually from an import or project manager build. This is a Windows NT v4.0 issue, not an MPLAB IDE issue. Update Windows NT v4.0 with service pack or set registry flag HK_CU\Network\DeferFlags = 1. For more information, see: http://support.microsoft.com/default.aspx?scid=kb;en-us;169138

Once the program is installed and you attempt to run it, you might  receive an error stating that a dll file failed to register. This is caused when Windows does not allow the MPLAB IDE installation to register the file for some reason. You will need to select Start>Programs>Microchip>MPLAB IDE vx.xx>Setup MPLAB Tools and run Repair to install and register the file.

If you use MPASM assembler to assemble a single file (i.e., you do not use the assembler with MPLINK object linker), you will get a COD file which has a 62 character length restriction for file and path names. To solve this problem either (1) Use MPLINK linker with MPASM assembler to create a COFF file, which has no character length restriction, or (2) Shorten your file name or move your file into a directory closer to the root directory (shorten the  path name), and try assembling your file or project again.

Some language (build) tools may have problems if you use spaces, illegal characters or long file names for the file or project name. Consult the language tool documentation for details.

If your language tools do not work correctly after installing this version of MPLAB IDE, go to our website or third party website to get the latest version of your language tool. If you have purchased the tool, contact your sales rep for an upgrade.

When using a System Display Font Size of Large Fonts (125% normal), and selecting an Italic font, some characters may display truncated on the top-right border of the source editor.

Several of the Editor fonts are Symbol based and are not suitable for use with the Editor. The Symbol fonts are included in the selection list to allow users to select the Terminal font.

The Editor allows files to be saved in UNICODE format on these UNICODE enabled operating systems: Windows NT 4.0 SP6a Workstations (NOT Servers), Windows 2000 SP2, Windows XP. Those files stored in UNICODE format will NOT compile with the present language tools, and you can not use them to debug.

9.2        System Service Requests (SSRs)

SSR 21029: While most Win NT users have been able to use the MPLAB IDE, a limited number of Win NT users have reported being unable to run MPLAB IDE. Microchip Development Tools has determined that one cause of this problem is that Windows Desktop Update is not installed on the user's PC. See the Microsoft web site for more information about the Windows Desktop Update. Another cause of the problem for Win NT users may be due to a registration problem; the work-around: run register.bat in the dll subdirectory of the MPLAB IDE installation directory.

SSR 23550: While in Animate mode, if you select File>Exit, MPLAB IDE will crash.

SSR 24945: MPLAB IDE fails to save the individual .ASM file options in a project; it reverts to the project 'Build Options'.

SSR 25806: [COFF] dsPIC disassembly listing shows address rather than Wreg number.

SSR 26249: The Build Option, Build tab, "Include Path" does not recognize multiple paths if a space is placed after the semicolon.

SSR 26635: Project Wizard: Save Workspace As dialog defaults to Core folder instead of project folder.

SSR 27644: When using ELF debug files, 'static const' local variable displays "Restricted Memory".

SSR 27730: C18 with full optimisations and procedural abstraction set to 2 selecting optimisation "debug" still have pa=2 on the cmd line

SSR 27761: For dual processor PC's, attempting to program with MPLAB ICD 2 after having done an Add file in Subversion results in an IDE application error.

SSR 27778: Subversion: Selecting the Help button from the SVN Commit Everything dialog has no effect.

SSR 27853: Building PICC 9.50PL1 project with global verbose option causes MPLAB IDE to freeze.

SSR 28053: Trying to select a document from the MPLAB IDE Document Select dialog opens the browser but there is no content.  Work around is to have a browser window open prior to using the MPLAB IDE Document Select dialog.

SSR 28233: Find in files:List of past search is not maintained in the drop down list.

SSR 28374: Stimulus controller starts behaving erratically after executing about 922000 instruction cycles when multiple SCL processes are running cuncurrently.

SSR 28391: Logic Analyzer is currently only cycle based.

SSR 28440: For PIC18F4450/2450 devices, all USB SFR's are missing from the SFR window.  These variables may be accessed using their address in the file register window or the watch window.

SSR 28459: The PADCFG1 register is missing from the SFR list for PIC24F devices.

10    Third Party Support

10.1    Language Tools

MPLAB IDE supports language tools from many different vendors.

Some vendors provide plug-in support for their language tools. Among these are:

·         B Knudsen Data (http://www.bknd.com)

·         CC5X

·         CC8E

·         Byte Craft (http://www.bytecraft.com)

·         Assembler & C Compiler

·         CCS (http://www.ccsinfo.com)

·         C Compiler for PIC12/14/16/18

·         HI-TECH (http://www.htsoft.com)

·         PICC Toolsuite

·         PICC Lite Toolsuite

·         PICC18 Toolsuite

·         IAR Systems (http://www.iar.com)

·         IAR Systems Midrange

·         IAR Systems PIC18 Toolsuite

·         microEngineering (http://www.melabs.com)

·         PicBasic Pro Toolsuite

·         PicBasic Toolsuite

Other vendors use a generic interface which is tailored through the use of MTC and INI files. These files are available in:

C:\Program Files\Microchip\MPLAB IDE\Core\LegacyLanguageSuites

More recent tailoring files are usually available through the language tool vendor.

10.2    RTOS

MPLAB IDE supports the following real-time operating systems (RTOSs) as plug-ins:

·         CMX (http://www.cmx.com)

·         Scheduler

·         Tiny+

View RTOS information from Tools>RTOS Viewer.

10.3    Version Control

MPLAB IDE supports the following version control programs under projects:

·         Microsoft Visual Source Safe (http://msdn.microsoft.com/vstudio/previous/ssafe)

·         PVCS (http://www.serena.com/Products/professional/vm/home.asp)

·         CVS (http://www.nongnu.org/cvs/)

·         Subversion (http://subversion.tigris.org)

11    Customer Support

11.1    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, online discussion groups, 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

11.2    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.

The Development Systems product group categories are:

·         Compilers - The latest information on Microchip C compilers and other language tools. These include the MPLAB C18 and MPLAB C30 C compilers; MPASM and MPLAB ASM30 assemblers; MPLINK and MPLAB LINK30 object linkers; and MPLIB and MPLAB LIB30 object librarians.

·         Emulators - The latest information on Microchip in-circuit emulators. This includes the MPLAB ICE 2000 and MPLAB ICE 4000.

·         In-Circuit Debuggers - The latest information on the Microchip in-circuit debugger, MPLAB ICD 2.

·         MPLAB IDE - The latest information on Microchip MPLAB IDE, the Windows® Integrated Development Environment for development systems tools. This list is focused on the MPLAB IDE, MPLAB IDE Project Manager, MPLAB Editor and MPLAB SIM simulator, as well as general editing and debugging features.

·         Programmers - The latest information on Microchip programmers. These include the MPLAB PM3 and PRO MATE® II device programmers and the PICSTART® Plus and PICkit 1 development programmers.

11.3    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

12    License Agreements

12.1    Copyright notice for strlcpy() and strlcat()

Copyright (c) 1998 Todd C. Miller Todd.Miller@courtesan.com
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1.       Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2.       Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

3.       The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

12.2    Copyright notice for Henry Spencer's implementation of regex

Copyright (c) 1992 Henry Spencer.
Copyright (c) 1992, 1993
The Regents of the University of California.  All rights reserved.

This code is derived from software contributed to Berkeley by Henry Spencer of the University of Toronto.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1.       Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2.       Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

3.       All advertising materials mentioning features or use of this software must display the following acknowledgement:

4.       This product includes software developed by the University of California, Berkeley and its contributors.

5.       Neither the name of the University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

@(#)regex.h      8.2 (Berkeley) 1/3/94