76 lines
2.9 KiB
Plaintext
76 lines
2.9 KiB
Plaintext
================ EFM32 Peripheral Library ===================================
|
|
|
|
This directory, "efm32lib", contains the Energy Micro Peripheral Support
|
|
library for the EFM32 series of microcontrollers.
|
|
|
|
The "efm32lib" SW is designed to support EFM32 Gecko rev B and later versions.
|
|
The following known caveats exists for rev A devices:
|
|
|
|
- CMU: HFRCO band tuning values are not correctly set for rev A.
|
|
- EMU: Errata "Peripheral clocks not gated in EM2/EM3 with debug session
|
|
active" has not been implemented with SW workaround for rev A.
|
|
|
|
Some design guidelines for this library:
|
|
|
|
* Follow the guidelines established by ARM's and Energy Micro's adaptation
|
|
of the CMSIS (see below) standard
|
|
|
|
* Be usable as a starting point for developing richer, more target specific
|
|
functionality (i.e. copy and modify further)
|
|
|
|
* Ability to be used as a standalone software component, used by other drivers
|
|
that should cover "the most common cases"
|
|
|
|
* Readability of the code and usability preferred before optimization for speed
|
|
and size or covering a particular "narrow" purpose
|
|
|
|
* As little "cross-dependency" between modules as possible, to enable users to
|
|
pick and choose what they want
|
|
|
|
================ About CMSIS ================================================
|
|
|
|
These APIs are based on EFM32_CMSIS, the Cortex Microcontroller Software
|
|
Interface Standard support headers, as supplied by Energy Micro AS.
|
|
|
|
As a result of this, the library requires basic C99-support. You might have
|
|
to enable C99 support in your compiler. Comments are in doxygen compatible
|
|
format.
|
|
|
|
The EFM32_CMSIS library contains all peripheral module registers and bit field
|
|
descriptors.
|
|
|
|
To download EFM32_CMSIS, go to
|
|
http://www.energymicro.com/downloads
|
|
|
|
For more information about CMSIS see
|
|
http://www.onarm.com
|
|
http://www.arm.com/products/CPUs/CMSIS.html
|
|
|
|
The requirements for using CMSIS also apply to this package.
|
|
|
|
================ File structure ==============================================
|
|
|
|
inc/ - header files
|
|
src/ - source files
|
|
|
|
================ Licenses ====================================================
|
|
|
|
See the top of each file for SW license. Basically you are free to use the
|
|
Energy Micro code for any project using EFM32 devices. Parts of the CMSIS
|
|
library is copyrighted by ARM Inc. See "License.doc" for ARM's CMSIS license.
|
|
|
|
================ Software updates ============================================
|
|
|
|
Energy Micro continually works to provide updated and improved efm32lib,
|
|
example code and other software of use for EFM32 customers. Please check the
|
|
download section of Energy Micro's web site at
|
|
|
|
http://www.energymicro.com/downloads
|
|
|
|
for the latest releases, news and updates. If you download and install the
|
|
Simplicity Studio application, you will be notified about updates when
|
|
available.
|
|
|
|
|
|
(C) Copyright Energy Micro AS, 2011
|