PSoC Designer Release Notes Version 5.4 PSoC Designer Release Notes Version 5.4 Release Date: 17 May 2013 Thank you for your interest in PSoC® Designer™. PSoC Designer is a complete Integrated Development Environment (IDE) for designing with PSoC 1 devices. This is the production release of PSoC Designer 5.4. This document describes new features and changes since the previous release. Contents New Features, User Modules, and Device Support ...................................................................................... 2 New Ease of Use Features ....................................................................................................................... 2 Support for CY8C24x93 Devices (Beta) ................................................................................................... 2 Support for New PRoC UI Devices (Beta) ................................................................................................ 3 Support for New enCore VI Devices (Beta) .............................................................................................. 3 Support for CapSense Devices ................................................................................................................ 3 New User Modules ................................................................................................................................... 3 Updated User Modules ............................................................................................................................. 4 Supported Tool Chains ................................................................................................................................. 4 ImageCraft Compiler (Standard and Pro versions) .................................................................................. 4 User Module Changes .................................................................................................................................. 4 PSoC Designer Compatibility Matrix ............................................................................................................. 6 Open Source ................................................................................................................................................. 7 Internet Explorer 9 Installation ...................................................................................................................... 7 Installation ..................................................................................................................................................... 7 Minimum and Recommended Requirements ........................................................................................... 7 Update Instructions ................................................................................................................................... 8 Installation Notes ...................................................................................................................................... 8 Note to HI-TECH Compiler Users ............................................................................................................. 9 Known Problems and Limitations for PSoC Designer 5.4 ............................................................................ 9 Further Reading .......................................................................................................................................... 10 Customer Filed Defects Fixed ..................................................................................................................... 11 For More Information Regarding PSoC Development Tools ...................................................................... 12 May 16, 2013 -1- PSoC Designer Release Notes Version 5.4 New Features, User Modules, and Device Support The following section details the new features released with PSoC Designer. The parenthesis in each title represents the maturity of the respective content. New Ease of Use Features The following new features are now available in Designer and make it easier to learn and easier to use. New Feature Description Auto-Complete As you type, the PSoC Designer code editor provides logical code elements that you can select from a dropdown menu. These elements include variables, user-defined functions, user module APIs and reserved words. With this new feature, you’ll spend less time typing and fixing typos. This new tool allows you to find the example code you need in the ever-expanding set of example projects. You can filter on project type, keyword, user module or the development kit used. PSoC Designer now supports customerdesigned user modules, including both the generated firmware and any front-end GUI. This guide walks you through all the steps needed to create your own user module. PSoC Designer now officially supports Windows 8. Example Project Browser User Module Creation Guide Windows 8 Support Support for CY8C24x93 Devices (Beta) This release provides beta level support for the CY8C24x93 device family. May 16, 2013 Marketing Part Number Package Flash SRAM CY8C24093-24LKXI 16-QFN 8K 1K CY8C24193-24LQXI 32-QFN 8K 1K CY8C24293-24LQXI 32-QFN 16K 2K CY8C24393-24LQXI 48-QFN 16K 2K CY8C24493-24LTXI 48-QFN 32K 2K CY8C24693-24LQXI 48-QFN 32K 2K -2- PSoC Designer Release Notes Version 5.4 Support for New PRoC UI Devices (Beta) This release provides beta level support for the following new PRoC UI Devices. These devices will support new user modules and silicon capabilities. Marketing Part Number Package Flash SRAM CYRF89435-68LTXC 68-QFN 32K 2K CYRF89135-68LTXC 40-QFN 32K 2K Support for New enCore VI Devices (Beta) This release provides beta level support for the following new device. This new device family provides support for new features including Cypress’ award-winning TrueTouch technology. To enable development using this new device family, please contact Prakhar Goyal at [email protected]. Marketing Part Number Package Flash SRAM CY7C69356-48LTXC 48-QFN 32K 2K Support for CapSense Devices This release provides beta level support for the following new CapSense device. Marketing Part Number Package Flash SRAM CY8C20065-24LKXI 16-QFN 8K 1K New User Modules The following new user modules are now available in Beta: User Module Name Description SmartSense2X Eliminates the need for tuning in your dualchannel CapSense solutions. Now available for CY8C28xxx devices. Dual-channel SmartSense plus high immunity to AC mains noise, other EMI, and power supply noise. For the CY8C22x45 device family. Dual-channel SmartSense plus high immunity to AC mains noise, other EMI, and power supply noise. For the CY8C28xxx device family. Analog comparator for the new CY8C24x93 family devices. SmartSense2X_EMC SmartSense2X_EMC CMP May 16, 2013 -3- PSoC Designer Release Notes Version 5.4 User Module Name Description IDAC Programmable current source. Exclusively for the new CY8C24x93 family devices. PWM8SW 8 bit software PWM. Exclusively for the new CY8C24x93 family devices. ScanSAR SAR ADC that automatically scans a userdefined set of input pins with a selectable conversion trigger. Updated User Modules The following user modules have undergone significant upgrades: User Module Name Description Thermistor Provides the hardware interface and software APIs to measure temperature with compensation via lookup table or the Steinhart-Hart equation. BootloaderUSBFSe This new version of the user module is even more streamlined and easy to use. Added the ability to update the USB configuration via the bootloading operation. Supported Tool Chains ImageCraft Compiler (Standard and Pro versions) One of the following compilers is required for PSoC Designer 5.4. ICCV7 for M8C STD version 7.05.00 ICCV8 for M8C PRO version 8.05.00 User Module Changes This section details the user modules that were updated in this release. For detailed listing and descriptions of the user module changes, see the version history tables in individual user module datasheets. Here is a complete list of all user modules that were updated: User Module Name (Device Family) Version ADCINC (for CY8C20xx6 devices) 3.00 BootLdrI2C (for CY8C20xx6 devices) 3.00 May 16, 2013 -4- PSoC Designer Release Notes Version 5.4 CSD (for CY8C20xx6 devices) 2.20 EzI2Cs (for CY8C20xx6 devices) 1.50 I2CHW (for CY8C20xx6 devices) 2.20 CSD2X (for CY8C2xx45 devices) 3.10 PWMDB16L 1.10 PWMDB8L 1.10 RTC 1.10 SPIMVL 1.10 SPISVL 1.10 SPIM (for enCore devices) 1.30 I2CHW 1.60 SPIM 3.00.b SPIS 2.5.d CYFISNP 2.00.c ADC10 1.30 ADC8 1.1.b ADCINC 1.20.c ADCINC12 5.3.b ADCINC14 1.4.b ADCINCVR 4.00.b AMuxN 3.00 BootLdrI2C 3.00 BootLdrUSBFSe 3.00 BPF2 6.00.b BPF4 2.10.b COMP 2.20 CSA_EMC 1.50 CSD 1.90 CSD2X 2.10 CSDADC 1.50 CSDPLUS 1.20 DelSig 1.50 DELSIG11 3.2.b May 16, 2013 -5- PSoC Designer Release Notes Version 5.4 DELSIG8 3.2.b DelSigMulti 1.30 DelSigPlus 1.10 DigInv 1.60 DUALADC 2.30.b DUALADC8 1.20.b ELPF2 1.20.b ELPF4 1.20.b EzI2Cs 2.00 FanController 1.00.b FlashTemp 2.40 I2CHW 2.00 I2Cm 2.00 LPF2 4.10 LPF4 2.10.b SAADC 1.10 SLCD 2.10.b SmartSense 1.60 SmartSense2X 1.10 SmartSense_EMC 1.30 SmartSense_EMCplus 1.20 SMBusSlave 2.00 SwitchCapConfig 1.10 Thermistor 2.00 TRIADC 2.20.b TRIADC8 1.10.b USBFS 2.10 TMG 3.20 TST 4.20 PSoC Designer Compatibility Matrix PSoC Designer provides backwards compatibility for projects created between PSoC Designer 4.4 and PSoC Designer 5.4 through the project update mechanisms. The following table shows the project compatibility matrix: Designer May 16, 2013 4.2 4.3 4.4 5.0 5.1 5.2 5.3 5.4 -6- PSoC Designer Release Notes Version 5.4 Release 4.2 4.3 4.4 5.0 5.1 5.2 5.3 5.4 Yes - Yes Yes - Yes Yes Yes - No No Yes Yes - No No Yes Yes Yes - No No Yes Yes Yes Yes - No No Yes Yes Yes Yes Yes No No Yes Yes Yes Yes Yes Yes “Yes” = Projects can open or be updated to. “No” = Project is not supported. “-“ = Not applicable. Open Source Portions of this software package are licensed under free and/or open source licenses. Such free and/or open source software is subject to the applicable license agreement and not the Cypress license agreement covering this software package. The applicable license terms will accompany each source code package. You may obtain the source code of such free and/or open source software at no charge from this web site: www.cypress.com/go/opensource. Internet Explorer 9 Installation After installing PSoC Designer, if users update or install Internet Explorer 9 an issue may arise with the SVG Viewer that will require a reinstall of the SVG Viewer. PSoC Designer has implemented a runtime check that will warn users if this error is found. To eliminate this error please perform the following actions. 1) Navigate to the following web page and download the latest SVG viewer: http://www.adobe.com/svg/viewer/install/ 2) Run this installer and follow the installation instructions. Once the SVG viewer has been reinstalled you will not receive the runtime message and PSoC Designer will function properly. Users with Internet Explorer 9 installed prior to the PSoC Designer installation will not need to reinstall SVG viewer. The CyInstaller will update the SVG viewer during installation. Installation Minimum and Recommended Requirements Hardware/Operation System Requirements Processor Speed MB of RAM MB of Free Hard Drive Space Screen Resolution CD/DVD Drive USB Windows® XP (SP2 or higher), Vista, Windows 7 or Windows 8 May 16, 2013 Minimum 2 GHz 2 GB 1.3 GB 1024x768 Not Req. Full Speed Recommended 2 GHz Dual Core 3 GB 1.3 GB 1280x1024 2.0 Hi-Speed -7- PSoC Designer Release Notes Version 5.4 Software Prerequisites ** Minimum Recommended 7 2.0 SP1 6 3.1 3.16 9+ Microsoft Internet Explorer .NET Framework Adobe Reader (for viewing PDF Documentation) Windows Installer PSoC Programmer * CD/DVD drive is only required for installation with no web access. ** Software Prerequisites – In order to install and run the PSoC Designer, you may also need to install additional software. The Cypress Installer guides you through the process if the additional programs are not already installed. Update Instructions As part of the installation process, the Cypress Update Manager utility is also installed and located on the Start menu. You can use this utility to update all programs you have installed when updates for them become available. Follow the instructions provided with the tool, as needed. Installation Notes Cypress uses a Live Update feature to simplify the installation process and to decrease download size. This process consists of a set of wizards that walk you through the installation. You can install PSoC Designer and its various prerequisites from the web, but if you have issues with installing behind a firewall or on a machine with no internet connection, an ISO file is provided on the web for creation of your own CD. There are slight differences in the process, based on the medium used to install the software. In order to install PSoC Designer, you need to first install PSoC Programmer. The CDs provide the necessary prerequisites and the wizards to guide you through installing the appropriate software. The Web installation requires you to download and install the executables separately. The following sections contain more specific installation details. Note Do NOT connect your Cypress Programmers (Miniprog1, Miniprog3, etc) until all software installation is complete AND the PSoC Designer application is open. How to Install PSoC Designer from the Web: 1. Download PSoCDesignerSetup.exe from the Cypress website a. It can be found at www.cypress.com/go/psocdesigner 2. PSoCDesignerSetup.exe will install CyInstaller for PSoC Designer. 3. CyInstaller will do a pre-requisite test, leading the user through the install process for missing prerequisites such as PSoC Programmer. 4. When the pre-requisite tests are passed, CyInstaller provides the user with the option to do a “Typical”, “Complete” or “Custom” install. a. Typical or Complete Install: Will install the latest available PSoC Designer release. b. Custom Install: Will show the user all releases of PSoC Designer and install the selected release (for now there is just one). 5. Once the PSoC Designer release is downloaded, CyInstaller displays the EULA and other applicable licenses. 6. Once the install is complete, CyInstaller displays the finish screen with options to view the “Release Notes” and “Add Desktop Shortcut”. May 16, 2013 -8- PSoC Designer Release Notes Version 5.4 How to Install Using an ISO Image (Two Methods): 1. Create a CDROM using the ISO image: a. Drag the ISO image onto the CD/DVD drive containing the CD/DVD. Right click on the CD/DVD drive and select “Burn” to create a CD/DVD for PSoC Designer installations. b. Download MagicISO (http://www.magiciso.com/download.htm) and follow the tutorial to create a CD/DVD from ISO http://www.magiciso.com/tutorials/miso-burnwin.htm. Note – To burn a CD with MagicISO, you need to pay $30 for the full version. There are also Freeware versions and tools that allow you to mount the ISO file without burning a CD. This is described in step 2. c. The installer, cyautorun.exe, launches once the CD/DVD is inserted in the CD/DVD drive. If not, double click cyautorun. 2. Install directly from an ISO image: a. Download MagicISO (http://www.magiciso.com/download.htm) or other Virtual Drive creators (these are typically freeware) and create a virtual drive. Mount the ISO image on the drive from the “Mount” option in MagicISO. - For help on mounting and unmounting ISO images see http://www.magiciso.com/tutorials/tutorials.htm. b. When you have mounted the ISO file, the installer should start. - if it does not start, double click on cyautorun. c. An alternative to using Virtual Drive creators is to download winrar (http://www.rarlab.com/download.htm) and open the ISO file in it. Then, extract and run “cyautorun.exe”. 3. cyautorun.exe prompts you to install PSoC Designer. Then follow steps 3-6 from the Web Installation instructions. System Level Design Users: Customers who wish to continue developing system level projects will need to install PSoC Designer 5.0 SP6. System level development has been removed from PSoC Designer. PSoC Designer 5.0 SP6 will be provided on the PSoC Designer web page or PSoC Designer archives page for any users interested in maintaining System Level projects, though creating new projects is no longer recommended. PSoC Designer 5.0 SP6 and PSoC Designer 5.4 will coexist on the same machine allowing customers to continue developing System Level designs and continue designing new chip level designs with PSoC Designer. Note to HI-TECH Compiler Users The HI-TECH compiler is no longer supported by PSoC Designer. At your own risk, you may perform the following instructions if you wish to enable your existing HITECH PRO license. You must manually update the psoc.ini file to add device support before you can compile projects that use the new devices. The HI-TECH psoc.ini file is found in the HI-Tech installation folder. The default location of the psoc.ini is here: C:\Program Files\HI-TECH Software\HCPSOC\PRO\9.61\dat\psoc.ini The default location of the replacement psoc.ini file that adds support for the new devices is here: C:\Program Files\Cypress\PSoC Designer\5.4\Common\CypressSemiDeviceEditor\Devices\psoc.ini Known Problems and Limitations for PSoC Designer 5.4 The Known Problems and Solutions (KPS) are included in a separate file. Please download it from the PSoC Designer download page found here: www.cypress.com/go/psocdesigner May 16, 2013 -9- PSoC Designer Release Notes Version 5.4 Further Reading Documentation for PSoC Designer is provided with on-line Help, which you can open from the Help menu or by pressing [F1]. There are numerous other documents under the Help->Documentation menu, including: IDE User Guide PSoC Designer Release Notes Updating the boot.tpl file (update of BOOT.pdf) Project Update help (Version Update.pdf) ICE User Guide C Language Compiler User Guide Math Libraries User Guide ImageCraft Release Notes Assembly Language Users Guide Hi-Tech to ImageCraft Migration guide User Module and device datasheets May 16, 2013 - 10 - PSoC Designer Release Notes Version 5.4 Customer Filed Defects Fixed The following table lists the customer filed defects that were fixed in this release: CY ID Category 142135 Defect Fix and Impact User Modules A RAM Paging Issue in the SmartSense User Modules (UM) caused the raw count to become stuck when variables are declared in page 1. “RAM_SETPAGE_CUR 0” has been added to the beginning of the InitializeSensorBaseline API. Raw count is no longer stuck. 142143 User Modules If any flash write operation is done after using the FlashTemp UM and if the FlashTemp UM is used to get the temperature again, the temperature values returned are incorrect. FLS_PR1 register set to 0 in the FlashTemp_Start API before using the TableRead function for devices that have more than one bank of Flash. Issue fixed. 143913 User Modules The first scan of the CSD2X UM exceeds the maximum raw count value. After the first scan, the raw counts are correct. Initialized the counter reset bit of the CSD0_CR0 register. Issue fixed. 144950 User Modules After calling CSD2X_Start() or CSD_ScanSensor() the firmware may not work. PARAMETER_SETTING is added for DecimatorLeftPlacementIndex and DecimatorRightPlacementIndex parameters in the *.plc files. Issue fixed. 145092 User Modules EzI2Cs not working correctly in CY8C20xx5 devices. EzI2Cs_CY8C20xx7 is defined as 0 in EzI2Cs.h. For CY8C20xx5 projects, this has been updated to 1. Issue fixed. 146371 Bootloading I2C bootloading fails when we place the ADC10 UM or with any user module which has interrupt associated with it. Bootloader variables that are used by both the Bootloader and the Application were locked in fixed place at the end of RAM page 0. Issue fixed. 146872 Device Catalog Device catalog incorrectly displays the CY8C27143PXI device as having an SMP block. Device catalog data corrected. 147437 TrueTouch Issue decoding double click gestures in TMG. Double click timing corrected. 147607 TrueTouch Issue decoding clicks in TMG. Click radius computation corrected. May 16, 2013 - 11 - PSoC Designer Release Notes Version 5.4 CY ID Category 148229 User Modules CSD wizard is not getting populated when a function pin named FN_0_0 is changed to FN0. Additional pin name verification has been added to fix this issue. 148603 Bootloading Overlapping SSC RAM area (F8FF) with user data in projects with Bootloader UMs Fixed issue that SSC area overlapping with user data. Defect Fix and Impact Corrected generation of custom.lkp files in all Bootloader UMs. 149037 Cloning Problems cloning projects with custom folders. Issue fixed. 149239 Device Catalog Some part numbers miscategorized. Issue fixed. 149910 Documentation PWD UM timing does not match the data sheet. Data sheet corrected. 150475 User Modules When CMOD is configured as P0_1, Designer incorrectly connects CMOD to GND. This bug affects the CSD user module. Corrected the connection between Cmod and GND in the Precharge function. 150896 User Modules “LCD_Start” and “LCD_Init” both have the same description in the data sheet. Clarified the usage of each API in the user module data sheet. 150988 Data Sheet CSD User Module Datasheet for the CY8C21X12 device erroneously claims that the UM allows for selection of reference source. Corrected data sheet to note that the reference source is fixed. 151084 Engine PDCLI commands do not work with a 64 bit OS. Issue fixed. For More Information Regarding PSoC Development Tools For more information regarding PSoC Designer functionality and releases please review the user guide and release notes on the PSoC Designer web page: www.cypess.com/go/psocdesigner For more information regarding PSoC Programmer, supported hardware and COM layer please go to the PSoC Programmer web page: www.cypress.com/go/psocprogrammer For more information regarding Cypress’s new and exciting PSoC3 and PSoC5 products and the PSoC Creator development environment please go to the PSoC Creator web page: May 16, 2013 - 12 - PSoC Designer Release Notes Version 5.4 www.cypress.com/go/psoccreator For a list of PSoC Designer-related trainings, please see http://www.cypress.com/?rID=40543 May 16, 2013 - 13 - PSoC Designer Release Notes Version 5.4 Cypress Semiconductor 198 Champion Ct. San Jose, CA 95134-1709 USA Tel: 408.943.2600 Fax: 408.943.4730 Application Support Hotline: 425.787.4814 www.cypress.com © Cypress Semiconductor Corporation, 2013. The information contained herein is subject to change without notice. Cypress Semiconductor Corporation assumes no responsibility for the use of any circuitry other than circuitry embodied in a Cypress product. Nor does it convey or imply any license under patent or other rights. Cypress products are not warranted nor intended to be used for medical, life support, life saving, critical control or safety applications, unless pursuant to an express written agreement with Cypress. Furthermore, Cypress does not authorize its products for use as critical components in life-support systems where a malfunction or failure may reasonably be expected to result in significant injury to the user. The inclusion of Cypress products in life-support systems application implies that the manufacturer assumes all risk of such use and in doing so indemnifies Cypress against all charges. PSoC® is a registered trademark, and Programmable System-on-Chip™ and PSoC Designer™ are trademarks of Cypress Semiconductor Corporation. All other trademarks or registered trademarks referenced herein are property of the respective corporations. This Source Code (software and/or firmware) is owned by Cypress Semiconductor Corporation (Cypress) and is protected by and subject to worldwide patent protection (United States and foreign), United States copyright laws and international treaty provisions. Cypress hereby grants to licensee a personal, non-exclusive, non-transferable license to copy, use, modify, create derivative works of, and compile the Cypress Source Code and derivative works for the sole purpose of creating custom software and or firmware in support of licensee product to be used only in conjunction with a Cypress integrated circuit as specified in the applicable agreement. Any reproduction, modification, translation, compilation, or representation of this Source Code except as specified above is prohibited without the express written permission of Cypress. Disclaimer: CYPRESS MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Cypress reserves the right to make changes without further notice to the materials described herein. Cypress does not assume any liability arising out of the application or use of any product or circuit described herein. Cypress does not authorize its products for use as critical components in life-support systems where a malfunction or failure may reasonably be expected to result in significant injury to the user. The inclusion of Cypress’ product in a life-support systems application implies that the manufacturer assumes all risk of such use and in doing so indemnifies Cypress against all charges. Use may be limited by and subject to the applicable Cypress software license agreement. May 16, 2013 - 14 -