================== == INTRODUCTION == ================== The XMC Peripheral Library (XMC Lib) consists of low-level drivers for the XMC product family peripherals. It addition the Cortex Microcontroller Software Interface Standard (CMSIS) is included. CMSIS provides a hardware abstraction layer for the Cortex-M processor series. XMC Lib is built on top of CMSIS and MISRA-C 2004 compliant. The following tool chains are supported: - GNU GCC for ARM (gcc) - MDK-ARM Microcontroller Development Kit v5 (armcc) - IAR Embedded Workbench for ARM (iccarm) - TASKING VX-toolset for ARM v5.(carm) The following 32-Bit Industrial Microcontrollers based on ARM Cortex are supported: - XMC4800 series - XMC4700 series - XMC4500 series - XMC4400 series - XMC4300 series - XMC4200 series - XMC4100 series - XMC1400 series - XMC1300 series - XMC1200 series - XMC1100 series ============== == CONTENTS == ============== Readme.txt License.txt XMClib/ doc/ examples/ /inc /src CMSIS/ Include/ Infineon/ SVD/ XMC1100_series/ XMC1200_series/ XMC1300_series/ XMC1400_series/ XMC4100_series/ XMC4200_series/ XMC4300_series/ XMC4400_series/ XMC4500_series/ XMC4700_series/ XMC4800_series/ Lib/ Newlib Now let's explain the purpose of each directory: - XMClib: The XMC Peripheral Library - XMClib/doc: Holds complete documentation - XMClib/examples: Contains examples using the XMClib for the supported devices and tool chains. - XMClib/inc: Include files per peripheral - XMClib/src: Implementation files per peripheral - CMSIS: The Cortex Microcontroller Software Interface Standard abstraction layer - CMSIS/Include: Hardware Abstraction Layer (HAL) for Cortex-M processor registers with standardized definitions for the SysTick, NVIC, System Control Block registers, MPU registers, FPU registers, and core access functions - CMSIS/Infineon: Includes System View Description files (SVD) for use with debuggers, device header files with the register description, system files and startup files defined by CMSIS - CMSIS/Lib: Precompiled CMSIS DSP libraries for XMC4 (ARM Cortex M4F) and XMC1 (ARM Cortex M0) families. - Newlib: stubs for system calls. Only relevant for GNU GCC for ARM =========== == USAGE == =========== Several examples for the supported tool chains are provided that can serve as starting point. To start a project from scratch follow the steps: 1. Copy the CMSIS, XMClib and Newlib folders into your project. 3. Add the following folders into the include paths of your project: - ${ProjName}/XMCLib/inc - ${ProjName}/CMSIS/Include - ${ProjName}/CMSIS/Infineon/XMC4400_series/Include 4. Select the device for which your compiling defining a preprocessor symbol, i.e. XMC4500_F144x1024 5. Include into your source the header files of the peripherals you want to use, i.e. #include <xmc_vadc.h> 6. Configure the peripheral and make use of the APIs described in the documentation. ====================== == REVISION HISTORY == ====================== XMC Peripheral Library v2.1.4p1 (06-04-2016) -------------------------------------------- - Updated CMSIS component to v4.5.0p1. See release notes in CMSIS/Readme.txt XMC Peripheral Library v2.1.6 (29-04-2016) -------------------------------------------- - Updated CMSIS component to v4.5.0p2. See release notes in CMSIS/Readme.txt - See changelog section in the documentation files for individual peripheral driver changes - Added Newlib folder - Following examples has been updated: - XMC4500/EBU/EBU_SDRAM - Fix CAS latency corrected to 3 - Change writing/reading of variables from 16bit to 32bit - XMC4500/ETH/HTTPSERVER_RAW - Stability and speed improvements - XMC4500/ETH/HTTPSERVER_NETCONN - Stability and speed improvements - XMC4800/ETH/HTTPSERVER_RAW - Stability and speed improvements - XMC4800/ETH/HTTPSERVER_NETCONN - Stability and speed improvements XMC Peripheral Library v2.1.6p1 (17-05-2016) -------------------------------------------- - Updated of XMC4300 header file (v1.0.4) in CMSIS folder to solve issues with wrong base address of some peripheral modules. XMC Peripheral Library v2.1.6p2 (14-07-2016) -------------------------------------------- - Updated CMSIS component to v4.5.0p3. See release notes in CMSIS/Readme.txt XMC Peripheral Library v2.1.8 (30-08-2016) -------------------------------------------- - Updated CMSIS component to v4.5.0p4. See release notes in CMSIS/Readme.txt - See changelog section in the documentation files for individual peripheral driver changes - Added USBH driver - Added USBH and USBD driver examples XMC Peripheral Library v2.1.12 (21-04-2017) -------------------------------------------- - Updated CMSIS component to v5.0.0. See release notes in CMSIS/Readme.txt - See changelog section in the documentation files for individual peripheral driver changes - Several examples added XMC Peripheral Library v2.1.14 (30-06-2017) -------------------------------------------- - See changelog section in the documentation files for individual peripheral driver changes - Updated CMSIS component to v5.0.0p1. - Changes device header and system files to add support for ARM Compiler 6 (armclang) - Examples added XMC Peripheral Library v2.1.16 (09-08-2017) -------------------------------------------- - See changelog section in the documentation files for individual peripheral driver changes - Examples added