git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/CORTEX_EFM32_Gecko_Starter_Kit_Simplicity_Studio/Source/SilLabs_Code/Device/ReadMe-CMSIS.txt

   1 ================ CMSIS Peripheral Support Library ============================\r
   2 \r
   3 This archive contains header file and peripheral support libraries for\r
   4 Silicon Labs EFM32 and EZR32 series of microcontrollers and System-On-Chip\r
   5 devices.\r
   6 \r
   7 ================ About CMSIS =================================================\r
   8 \r
   9 The library and header files are based on CMSIS, the Cortex Microcontroller\r
  10 Software Interface Standard, as defined by ARM Ltd.\r
  11 \r
  12 For more information about the CMSIS standard in itself see\r
  13     http://www.onarm.com/cmsis\r
  14     http://www.arm.com/cmsis\r
  15 \r
  16 In short, CMSIS tries to provide a common interface for programming devices\r
  17 having one of the Cortex-M core architectures, making code sharing and reuse\r
  18 easier.\r
  19 \r
  20 ================ Development Environments ====================================\r
  21 \r
  22 You will need a development environment which supports Silicon Labs EFM32/EZR32\r
  23 devices. Currently this can be one of either\r
  24 \r
  25 Atollic TrueStudio for ARM\r
  26   http://www.atollic.com\r
  27 \r
  28 CooCox CoIDE\r
  29   http://www.coocox.com\r
  30 \r
  31 Hitex HiTop IDE\r
  32   http://www.hitex.com\r
  33 \r
  34 IAR Embedded Workbench for ARM\r
  35   http://www.iar.com\r
  36 \r
  37 Keil uVision "MDK-ARM"\r
  38   http://www.keil.com\r
  39 \r
  40 Mentor Graphics CodeBench (previously Codesourcery Sourcery G++)\r
  41   http://www.mentor.com\r
  42 \r
  43 Rowley CrossWorks for ARM\r
  44   http://www.rowley.co.uk\r
  45 \r
  46 The version required depends on the family of products you are developing\r
  47 for, check with the vendor for compliance for a particular device.\r
  48 \r
  49 It is possible to develop with other tools, but these vendors provide good,\r
  50 integrated development environments for Silicon Labs EFM32/EZR32 devices.\r
  51 \r
  52 This library uses C99-types, requires the presence of <stdint.h> and can use\r
  53 other functionality standardized in C99. If your compiler has a C99 compliance\r
  54 toggle, you should enable it for your projects.\r
  55 \r
  56 ================ File structure ==============================================\r
  57 \r
  58 Short getting started guide:\r
  59 \r
  60 The quickest way to start is to base your work on one of the simple example\r
  61 projects for the Silicon Labs EFM32/EZR32 Development or Starter Kits. These\r
  62 should be easy to port and change to adopt to your needs.\r
  63 \r
  64 The board support packages for the various Silicon Labs EFM32/EZR32 kits comes\r
  65 with a "blink" example, that serves as a good starting point for new projects.\r
  66 \r
  67 Please note that you _will_ need to change the "Debugger" and "Flash/Download"\r
  68 configuration settings to fit your environment. See your IDE's manual for\r
  69 details. You might also need to change the limits of the linker file to adopt\r
  70 to your part's SRAM and flash size limits.\r
  71 \r
  72 Support for Silicon Labs EFM32/EZR32 devices family is located in the directory\r
  73   Device/SiliconLabs/<FAMILY>,\r
  74 where family could be one of EFM32G, EFM32TG, EFM32GG, EFM32LG, EZR32WG or\r
  75 others.\r
  76 \r
  77 The most convenient way to start a project, is to define the device target\r
  78 in your compiler options, e.g. add a -DEFM32G890F128 to your compile options\r
  79 if you are targetting an EFM32G890F128 part.\r
  80 \r
  81 Include the file "em_device.h" wherever you need register and bit field\r
  82 definitions for the peripherals or the MCUs/RF transceivers, after setting\r
  83 the correct include path to point to your "family".\r
  84 \r
  85 Gecko/Draco peripheral registers follow the CMSIS convention of defining a\r
  86 structure which hold "volatile" peripheral registers. Again, take a look\r
  87 at the examples for usage.\r
  88 \r
  89 ================ Licenses ====================================================\r
  90 \r
  91 See the top of each file for software license. The complete CMSIS folder and\r
  92 libraries is copyrighted by ARM Ltd. See the file\r
  93   CMSIS/CMSIS END USER LICENSE AGREEMENT.pdf\r
  94 for ARM's CMSIS license.\r
  95 \r
  96 ================ Software updates ============================================\r
  97 \r
  98 Silicon Labs continually works to provide updated and improved example code,\r
  99 header files and other software of use for our customers. Please check\r
 100 \r
 101 http://www.silabs.com/support/pages/document-library.aspx?p=MCUs--32-bit\r
 102 \r
 103 for the latest releases.\r
 104 \r
 105 If you download and install the "Simplicity Studio" package, you can easily\r
 106 keep up to date with the latest Silicon Labs EFM32/EZR32 software deliveries,\r
 107 datasheets, app.notes, erratas and more.\r
 108 \r
 109 (C) Copyright Silicon Laboratories, Inc. 2015.\r
 110 \r