FSShell Description File System Shell Component FSShell.PEupd Dependencies Utility, FAT_FileSystem, FreeRTOS, RTC_I2C_DS1307, FSL_USB_Stack, RingBufferUInt8 License License : Open Source (LGPL) Copyright : (c) Copyright Erich Styger, 2012, all rights reserved. This an open source software implementing a shell using Processor Expert. Main purpose is for a file system, but useful as well without one. This is a free software and is opened for education, research and commercial developments under license policy of following terms: * This is a free software and there is NO WARRANTY. * No restriction on use. You can use, modify and redistribute it for personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY. * Redistributions of source code must retain the above copyright notice.

FreeRTOSTrace Description Implements FreeRTOS hook API for tracing. See this blog post. Component FreeRTOSTrace.PEupd Dependencies FreeRTOS, PercepioTrace License License : Open Source (LGPL) Copyright : (c) Copyright Erich Styger/Martin Bucher, 2012, all rights reserved. This an open source software implementation with Processor Expert. This is a free software and is opened for education, research and commercial developments under license policy of following terms: * This is a free software and there is NO WARRANTY. * No restriction on use. You can use, modify and redistribute it for personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY. * Redistributions of source code must retain the above copyright notice.

Step by step instructions for how to use Processor Expert inside CodeWarrior to create a bare board (no RTOS) application to use GPIO and Timers to blink LEDs on the TWR-K60N512 board, from scratch.

BootLoaderDisk Description File System for Bootloader Component BootLoaderDisk.PEupd Dependencies S19 License This component is based on the Freescale Application Note AN3748. The copyright notice of the original file is provided below: /****************************************************************************** * * (c) copyright Freescale Semiconductor 2008 * ALL RIGHTS RESERVED * * File Name: FAT16.c * * Purpose: This file is for a USB Mass-Storage Device bootloader. This file * mimics a FAT16 drive in order to enumerate as a disk drive * * Assembler: Codewarrior for Microcontrollers V6.2 * * Version: 1.0 * * * Author: Derek Snell * * Location: Indianapolis, IN. USA * * UPDATED HISTORY: * * REV YYYY.MM.DD AUTHOR DESCRIPTION OF CHANGE * --- ---------- ------ --------------------- * 1.0 2008.06.10 Derek Snell Initial version * * ******************************************************************************/ /* Freescale is not obligated to provide any support, upgrades or new */ /* releases of the Software. Freescale may make changes to the Software at */ /* any time, without any obligation to notify or provide updated versions of */ /* the Software to you. Freescale expressly disclaims any warranty for the */ /* Software. The Software is provided as is, without warranty of any kind, */ /* either express or implied, including, without limitation, the implied */ /* warranties of merchantability, fitness for a particular purpose, or */ /* non-infringement. You assume the entire risk arising out of the use or */ /* performance of the Software, or any systems you design using the software */ /* (if any). Nothing may be construed as a warranty or representation by */ /* Freescale that the Software or any derivative work developed with or */ /* incorporating the Software will be free from infringement of the */ /* intellectual property rights of third parties. In no event will Freescale */ /* be liable, whether in contract, tort, or otherwise, for any incidental, */ /* special, indirect, consequential or punitive damages, including, but not */ /* limited to, damages for any loss of use, loss of time, inconvenience, */ /* commercial loss, or lost profits, savings, or revenues to the full extent */ /* such may be disclaimed by law. The Software is not fault tolerant and is */ /* not designed, manufactured or intended by Freescale for incorporation */ /* into products intended for use or resale in on-line control equipment in */ /* hazardous, dangerous to life or potentially life-threatening environments */ /* requiring fail-safe performance, such as in the operation of nuclear */ /* facilities, aircraft navigation or communication systems, air traffic */ /* control, direct life support machines or weapons systems, in which the */ /* failure of products could lead directly to death, personal injury or */ /* severe physical or environmental damage (High Risk Activities). You */ /* specifically represent and warrant that you will not use the Software or */ /* any derivative work of the Software for High Risk Activities. */ /* Freescale and the Freescale logos are registered trademarks of Freescale */ /* Semiconductor Inc. */

Utility Description Different utility methods, mainly around strings Component Utility.PEupd Dependencies none License License : Open Source (LGPL) Copyright : (c) Copyright Erich Styger, 2012, all rights reserved. xatoi(): Copyright (C) 2010, ChaN, all right reserved. (see copyright notice and license at the function implementation). This an open source software implementing utility functions using Processor Expert. This is a free software and is opened for education, research and commercial developments under license policy of following terms: * This is a free software and there is NO WARRANTY. * No restriction on use. You can use, modify and redistribute it for personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY. * Redistributions of source code must retain the above copyright notice.

Using Microcontroller Driver Suite, learn how to add, configure, and remove a component, and how to generate code.

FatFsMemSDHC Description SD Card low level driver for FatFs using SDHC_LDD. Component FatFsMemSDHC.PEupd Dependencies Timeout License License : Open Source (LGPL) Copyright : (c) Copyright Erich Styger, 2012, all rights reserved. This an open source software implementing an SD card low level driver useful for the the ChaN FatFS, using Processor Expert. This is a free software and is opened for education, research and commercial developments under license policy of following terms: * This is a free software and there is NO WARRANTY. * No restriction on use. You can use, modify and redistribute it for personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY. * Redistributions of source code must retain the above copyright notice.

FAT_FileSystem Description Implements a wrapper for the FAT FS File System implemented by ChaN (see: http://elm-chan.org/fsw/ff/00index_e.html) Component FAT_FileSystem.PEupd Dependencies FreeRTOS, SD_Card License License : Open Source (LGPL) Copyright : (c) Copyright Erich Styger, 2012, all rights reserved. FatFS: Copyright (C) 2011, ChaN, all right reserved. (see copyright notice and license in the FatFS implementation). This an open source software implementing an interface to the ChaN FatFS using Processor Expert. This is a free software and is opened for education, research and commercial developments under license policy of following terms: * This is a free software and there is NO WARRANTY. * No restriction on use. You can use, modify and redistribute it for personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY. * Redistributions of source code must retain the above copyright notice.

GenericSWI2C Description Implements a software I2C driver using general purpose I/O pins (bit banging). The driver has been re-implemented using an existing Processor Expert component for the Freescale HCS08. Component GenericSWI2C.PEupd Dependencies Wait License (c) Copyright Freescale Semiconductor, 2010 http : www.freescale.com

Tacho Description Driver for a Tachometer. Component Tacho.PEupd Dependencies QuadCounter License License : Open Source (LGPL) Copyright : (c) Copyright Erich Styger, 2012, all rights reserved. This an open source software using Processor Expert. This is a free software and is opened for education, research and commercial developments under license policy of following terms: * This is a free software and there is NO WARRANTY. * No restriction on use. You can use, modify and redistribute it for personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY. * Redistributions of source code must retain the above copyright notice.

SPHY Description Simple PHY implementation for SMAC. Component SPHY.PEupd Dependencies MC13192, SSEC License (c) Copyright Freescale Semiconductor, 2012 Adoption as an Processor Expert component: Erich Styger

GFont Description Compnent providing multiple different graphical fonts (Helvetica style, Courier style) in different shapes (bold, normal). Component GFont.PEupd Dependencies none License License : Open Source (LGPL) Copyright : (c) Copyright Erich Styger, 2011, all rights reserved. This an open source software in the form of a Processor Expert Embedded Component. This is a free software and is opened for education, research and commercial developments under license policy of following terms: * This is a free software and there is NO WARRANTY. * No restriction on use. You can use, modify and redistribute it for personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY. * Redistributions of source code must retain the above copyright notice.

Wait Description Generic busy waiting. Component Wait.PEupd Dependencies uCOS_II, Watchdog License License : Open Source (LGPL) Copyright : (c) Copyright Erich Styger, 2012, all rights reserved. This an open source software implementing waiting routines using Processor Expert. This is a free software and is opened for education, research and commercial developments under license policy of following terms: * This is a free software and there is NO WARRANTY. * No restriction on use. You can use, modify and redistribute it for personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY. * Redistributions of source code must retain the above copyright notice.

The C project that doesn't use Processor Expert can be converted to Processor Expert. This is useful when the user finds out that he/she would like to use additional features of Processor Expert. WARNING! Note that in most cases this conversion involves necessary manual changes in the application code, because for example the register interrupt vectors table definitions created by the user often conflicts with Processor Expert definitions. Don't forget to backup the whole project before the conversion. Some files will have to be removed from the project. The conversion to Processor Expert is recommended to experienced users only. Steps: Select the command in the main menu File > New > Other and in the New Project Wizard select Processor Expert / Enable Processor Expert for Existing C Project Select the project you want to update. Select the derivative that will be included in PEx project (you should use the same derivative, but without the _4SDK suffix, that has been selected when the project was created without PEx). Select the target compiler (select for example the IAR ARM C Compiler if the C project has been created as IAR ARM C project) Confirm changes (renaming of main.c module and any other changes you want to apply) and click on the Finish button. Remove the duplicate main.c module – main_backup.c (copy content of the old main.c module into the new one created by PEx) and delete the file The project with PEx is created but there need to be done following changes: Remove the PinSettings component from project and add new PinSettings component from Components Library. This process adds missing fsl_clock_manager component to the project too. Press the button Generate Processor Expert Code and project should be generated without errors. Remove the duplicate main.c module – the main_backup.c file (copy content of the old main.c module into the new one created by PEx) and delete the old version of the file (main_backup.c) Processor Expert includes all IO maps and startup files. Therefore all IO maps and startup files from the original C project must be removed. Processor Expert generate linker file ProcessorExpert.xxx (e.g. file ProcessorExpert.icf for IAR ARM C Compiler). Therefore all linker command files from the original C project must be removed.

PercepioTrace Description Implements a wrapper to the Percepio SE FreeRTOS+Trace library. See this blog post. Component PercepioTrace.PEupd Dependencies FreeRTOSTrace, FreeRTOS v1.095 or later License (c) Copyright Percepio AB, 2012 http : www.percepio.se mail : info@percepio.com Processor Expert port: Erich Styger, 2012 * Terms of Use * This software is copyright Percepio AB. The recorder library is free for * use together with Percepio products. You may distribute the recorder library * in its original form, including modifications in trcPort.c and trcPort.h * given that these modification are clearly marked as your own modifications * and documented in the initial comment section of these source files. * This software is the intellectual property of Percepio AB and may not be * sold or in other ways commercially redistributed without explicit written * permission by Percepio AB.

The Processor Expert Driver Suite 10.4 Update 2 is available on the Freescale web and as Eclipse update. This update applies to the Driver Suite 10.4, or 3rd party IDE's with Processor Expert as Atollic TrueSTUDIO or Emprog Thunderbench. It is NOT applicable to CodeWarrior or Kinetis Design Studio: the upcoming KDS V2.0.0 release will include that update. This update features an improved new project wizard with device filtering support, alignment with the Kinetis SDK v1.0.0 and the upcoming SDK v1.1, and includes bug fixes (see release notes for details). The update is cummulative, so you can apply it to Driver Suite 10.4 with or without the Update 10.4.1. Release Notes: http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=PE_DRIVER_SUITE&fpsp=1&tab=Documentation_Tab Download from the web: http://www.freescale.com/webapp/sps/site/overview.jsp?code=PEXDRV_UPDATES_10_4 Then update Eclipse with Window > Install new softeare and use the downloaded archive. Eclipse Updater: Use the following update URL to download the update 10.4.2 (menu Help > Install New Software): http://freescale.com/lgfiles/updates/Eclipse/PExDrv10_4/com.freescale.pexdrv.updatesite Best regards, Erich

LED Description Driver for an LED. Component Led.PEupd Dependencies GenericBitIO License License : Open Source (LGPL) Copyright : (c) Copyright Erich Styger, 2012, all rights reserved. This an open source software implementing an LED driver using Processor Expert. This is a free software and is opened for education, research and commercial developments under license policy of following terms: * This is a free software and there is NO WARRANTY. * No restriction on use. You can use, modify and redistribute it for personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY. * Redistributions of source code must retain the above copyright notice.

The C project that doesn't use Processor Expert can be converted to Processor Expert. This is useful when the user finds out that he/she would like to use additional features of Processor Expert. WARNING! Note that in most cases this conversion involves necessary manual changes in the application code, because for example the register interrupt vectors table definitions created by the user often conflicts with Processor Expert definitions. Don't forget to backup the whole project before the conversion. Some files will have to be removed from the project. The conversion to Processor Expert is recommended to experienced users only. Steps: Select the command in the main menu File > New > Other and in the New Project Wizard select Processor Expert / Enable Processor Expert for Existing C Project Select the project you want to update. Select the derivative that will be included in PEx project (you should use the same derivative with the _4SDK suffix that has been selected when the project was created without PEx). Select the target compiler (select the GNU C Compiler by default but if you have not installed any other compiler in the Kinetis Design Studio) Confirm changes (renaming of main.c module and any other changes you want to apply) and click on the Finish button. The project with PEx is created but there need to be done following changes: Go to project Properties to the Procesor Expert > Kinetis SDK Specific and fill the SDK path. Use browse button and select a path to the Kinetis SDK folder or fill the ${KSDK_PATH} which is default system variable. This variable points to the default Kinetis SDK folder. After this project still shows some errors. Remove the PinSettings component from project and add new PinSettings component from Components Library. This process adds missing fsl_clock_manager component to the project too. Press the button Generate Processor Expert Code and project should be generated without errors. Remove the duplicate main.c module – the main_backup.c file (copy content of the old main.c module into the new one created by PEx) and delete the old version of the file (main_backup.c) Remove all IO maps files from the original project. The KDS bareboard project have all these files included in the Includes folder by default (core_......h files and IO map files). Remove all startup files from the original project. The KDS bareboard project have all these files (startup_xxxxxx.S and system_xxxxxx.c files) included in the Project_Settings/Startup_Code  folder. Remove linker file xxxxxxxxxxxx_flash.ld from the original project. Use the Processor Expert.ld linker file that is generated by Processor Expert. In the context menu of the project select Properties and in the Properties window go the C/C++ Build > Settings > Tool Settings, select the Cross ARM C++ Linker / General and select the ProcessorExpert.ld file instead of MK......_flash.ld (see the following screenshot).

Note: the full USB 4.0 stack can be downloaded from the FSL website and contains Processor Expert components for many classes, not just the CDC class. So think of this as a useful tutorial. You can find it here: USB Stack Product Summary Page. Once installed, the default location for the components is C:\Freescale\Freescale USB Stack v4.0.1\ProcessorExpert. FSL_USB_Stack Description Wrapper for the Freescale USB Stack using the USB Stack v4.0.0. This wrapper currently only supports the CDC class and has been tested with the Kinetis K40/K60, TWR-MCF52259 , TWR-S08MM128, TWR-MCF51MM256, plus the MCF51JM128 and S08JM60 on the DEMOJM board. An article on this can be found here. Component FSL_USB_Stack.PEupd Dependencies RingBufferUInt8 License (c) Copyright Freescale, all rights reserved, 2012 Ported as Processor Expert component: Erich Styger http: www.freescale.com Copyright notice from Freescale: /****************************************************************************** * * Freescale Semiconductor Inc. * (c) Copyright 2004-2010 Freescale Semiconductor, Inc. * ALL RIGHTS RESERVED. * ****************************************************************************** * * THIS SOFTWARE IS PROVIDED BY FREESCALE "AS IS" AND ANY EXPRESSED 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 FREESCALE OR ITS 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. * **************************************************************************//*!

S19 Description S19 File Parser Component S19.PEupd Dependencies none License This component is based on the Freescale Application Note AN3748. The copyright notice of the original file is provided below: /****************************************************************************** * * (c) copyright Freescale Semiconductor 2008 * ALL RIGHTS RESERVED * * File Name: ParseS19.c * * Purpose: This file is for a USB Mass-Storage Device bootloader. This file * has functions to read S19 file sent over USB, and parse s-records * to program to flash. * * Assembler: Codewarrior for Microcontrollers V6.2 * * Version: 1.0 * * * Author: Derek Snell * * Location: Indianapolis, IN. USA * * UPDATED HISTORY: * * REV YYYY.MM.DD AUTHOR DESCRIPTION OF CHANGE * --- ---------- ------ --------------------- * 1.0 2008.06.10 Derek Snell Initial version * * ******************************************************************************/ /* Freescale is not obligated to provide any support, upgrades or new */ /* releases of the Software. Freescale may make changes to the Software at */ /* any time, without any obligation to notify or provide updated versions of */ /* the Software to you. Freescale expressly disclaims any warranty for the */ /* Software. The Software is provided as is, without warranty of any kind, */ /* either express or implied, including, without limitation, the implied */ /* warranties of merchantability, fitness for a particular purpose, or */ /* non-infringement. You assume the entire risk arising out of the use or */ /* performance of the Software, or any systems you design using the software */ /* (if any). Nothing may be construed as a warranty or representation by */ /* Freescale that the Software or any derivative work developed with or */ /* incorporating the Software will be free from infringement of the */ /* intellectual property rights of third parties. In no event will Freescale */ /* be liable, whether in contract, tort, or otherwise, for any incidental, */ /* special, indirect, consequential or punitive damages, including, but not */ /* limited to, damages for any loss of use, loss of time, inconvenience, */ /* commercial loss, or lost profits, savings, or revenues to the full extent */ /* such may be disclaimed by law. The Software is not fault tolerant and is */ /* not designed, manufactured or intended by Freescale for incorporation */ /* into products intended for use or resale in on-line control equipment in */ /* hazardous, dangerous to life or potentially life-threatening environments */ /* requiring fail-safe performance, such as in the operation of nuclear */ /* facilities, aircraft navigation or communication systems, air traffic */ /* control, direct life support machines or weapons systems, in which the */ /* failure of products could lead directly to death, personal injury or */ /* severe physical or environmental damage (High Risk Activities). You */ /* specifically represent and warrant that you will not use the Software or */ /* any derivative work of the Software for High Risk Activities. */ /* Freescale and the Freescale logos are registered trademarks of Freescale */ /* Semiconductor Inc. */ /*****************************************************************************/