riot-ci/RIOT
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

boards/efm32: update documentation

Browse Source 
* Alignment of documentation between boards
* Updated links
* Table updates
* Line length
* Space between units
* Updated peripheral mapping
This commit is contained in:
Bas Stottelaar 2020-11-03 13:18:19 +01:00
parent 4ec2090f69
commit de342fa0c4
8 changed files with 349 additions and 261 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
boards/common/slwstk6000b/doc.txt
View File

@ -100,7 +100,7 @@ to get familiar with the different clocks.
| HFXO | No | 38.4 MHz | | | HFXO | No | 38.4 MHz | |
| LFRCO | Yes | 32.768 kHz | | | LFRCO | Yes | 32.768 kHz | |
| LFXO | No | 32.768 kHz | | | LFXO | No | 32.768 kHz | |
| ULFRCO | No | 1.000 kHz | Not very reliable as a time source | | ULFRCO | No | 1 kHz | Not very reliable as a time source |
The sources can be used to clock following branches: The sources can be used to clock following branches:

66
boards/ikea-tradfri/doc.txt
View File

@ -18,8 +18,8 @@ More information about the module can be found on this
| Family | ARM Cortex-M4F | | Family | ARM Cortex-M4F |
| Vendor | Silicon Labs | | Vendor | Silicon Labs |
| Vendor Family | EFR32 Mighty Gecko 1P | | Vendor Family | EFR32 Mighty Gecko 1P |
| RAM | 32.0KiB (1.0KiB reserved) | | RAM | 32.0 KiB (1.0 KiB reserved) |
| Flash | 256.0KiB | | Flash | 256.0 KiB |
| EEPROM | no | | EEPROM | no |
| Frequency | up to 38.4 MHz | | Frequency | up to 38.4 MHz |
| FPU | yes | | FPU | yes |
@ -30,7 +30,7 @@ More information about the module can be found on this
| UARTs | 2x USART, 1x LEUART | | UARTs | 2x USART, 1x LEUART |
| SPIs | 2x USART | | SPIs | 2x USART |
| I2Cs | 1x | | I2Cs | 1x |
| Vcc | 1.85V - 3.8V | | Vcc | 1.85 V - 3.8 V |
| Datasheet | [Datasheet](https://www.silabs.com/documents/public/data-sheets/efr32mg1-datasheet.pdf) | | Datasheet | [Datasheet](https://www.silabs.com/documents/public/data-sheets/efr32mg1-datasheet.pdf) |
| Manual | [Manual](https://www.silabs.com/documents/public/reference-manuals/efr32xg1-rm.pdf) | | Manual | [Manual](https://www.silabs.com/documents/public/reference-manuals/efr32xg1-rm.pdf) |
@ -66,8 +66,9 @@ Pin 1 is on the top-left side with only 6 contacts.
| RTC | — | RTCC | | 1 Hz interval. Either RTC or RTT (see below) | | RTC | — | RTCC | | 1 Hz interval. Either RTC or RTT (see below) |
| SPI | 0 | USART1 | MOSI: PD15, MISO: PD14, CLK: PD13 | | | SPI | 0 | USART1 | MOSI: PD15, MISO: PD14, CLK: PD13 | |
| Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) | | Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) |
| | 1 | LETIMER0 | | |
| UART | 0 | USART0 | RX: PB15, TX: PB14 | Default STDIO output | | UART | 0 | USART0 | RX: PB15, TX: PB14 | Default STDIO output |
| LEUART | 0 | LEUART0 | RX: PB15, TX: PB14 | Alternate to using UART | | | 1 | LEUART0 | RX: PB15, TX: PB14 | Baud rate limited (see below) |
### User interface ### User interface
| Peripheral | Mapped to | Pin | Comments | | Peripheral | Mapped to | Pin | Comments |
@ -94,7 +95,6 @@ Pin 1 is on the top-left side with only 6 contacts.
## Board configuration ## Board configuration
### UART selection ### UART selection
By default the UART peripheral is used for the TX/RX pins, however the pinout By default the UART peripheral is used for the TX/RX pins, however the pinout
is compatible with LEUART also. You can switch from UART to LEUART by compiling is compatible with LEUART also. You can switch from UART to LEUART by compiling
with `EFM32_USE_LEUART=1`. with `EFM32_USE_LEUART=1`.
@ -112,7 +112,7 @@ to get familiar with the different clocks.
| HFRCO | Yes | 19 MHz | Enabled during startup, changeable | | HFRCO | Yes | 19 MHz | Enabled during startup, changeable |
| HFXO | No | 38.4 MHz | | | HFXO | No | 38.4 MHz | |
| LFRCO | Yes | 32.768 kHz | | | LFRCO | Yes | 32.768 kHz | |
| ULFRCO | No | 1.000 kHz | Not very reliable as a time source | | ULFRCO | No | 1 kHz | Not very reliable as a time source |
The sources can be used to clock following branches: The sources can be used to clock following branches:
@ -138,6 +138,56 @@ the speeds above, ensure to pass `EFM32_HFXO_FREQ=freq_in_hz` and
You can override the branch's clock source by adding `CLOCK_LFA=source` to You can override the branch's clock source by adding `CLOCK_LFA=source` to
your compiler defines, e.g. `CLOCK_LFA=cmuSelect_LFRCO`. your compiler defines, e.g. `CLOCK_LFA=cmuSelect_LFRCO`.
### Low-power peripherals
The low-power UART is capable of providing an UART peripheral using a low-speed
clock. When the LFB clock source is the LFRCO or LFXO, it can still be used in
EM2. However, this limits the baud rate to 9600 baud. If a higher baud rate is
desired, set the clock source to CORELEDIV2.
**Note:** peripheral mappings in your board definitions will not be affected by
this setting. Ensure you do not refer to any low-power peripherals.
### RTC or RTT
RIOT-OS has support for *Real-Time Tickers* and *Real-Time Clocks*.
However, this board MCU family has support for a 32-bit *Real-Time Clock and
Calendar*, which can be configured in ticker mode **or** calendar mode.
Therefore, only one of both peripherals can be enabled at the same time.
Configured at 1 Hz interval, the RTCC will overflow each 136 years.
### Hardware crypto
This MCU is equipped with a hardware-accelerated crypto peripheral that can
speed up AES128, AES256, SHA1, SHA256 and several other cryptographic
computations.
A peripheral driver interface is proposed, but not yet implemented.
### Usage of EMLIB
This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers.
While some overhead is to be expected, it ensures proper setup of devices,
provides chip errata and simplifies development. The exact overhead depends on
the application and peripheral usage, but the largest overhead is expected
during peripheral setup. A lot of read/write/get/set methods are implemented as
inline methods or macros (which have no overhead).
Another advantage of EMLIB are the included assertions. These assertions ensure
that peripherals are used properly. To enable this, pass `DEBUG_EFM` to your
compiler.
### Pin locations
The EFM32 platform supports peripherals to be mapped to different pins
(predefined locations). The definitions in `periph_conf.h` mostly consist of a
location number and the actual pins. The actual pins are required to configure
the pins via GPIO driver, while the location is used to map the peripheral to
these pins.
In other words, these definitions must match. Refer to the data sheet for more
information.
This MCU has extended pin mapping support. Each pin of a peripheral can be
connected separately to one of the predefined pins for that peripheral.
## Flashing the device ## Flashing the device
To flash, [SEGGER JLink](https://www.segger.com/jlink-software.html) is To flash, [SEGGER JLink](https://www.segger.com/jlink-software.html) is
required. required.
@ -167,8 +217,8 @@ make emulate
``` ```
## Supported Toolchains ## Supported Toolchains
For using the IKEA TRåDFRI module we strongly recommend the usage of the For using the Silicon Labs STK3600 starter kit we strongly recommend
[GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm) the usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm)
toolchain. toolchain.
## License information ## License information

34
boards/slstk3401a/doc.txt
View File

@ -15,26 +15,27 @@ actively measure the power consumption of your hardware and code, in real-time.
### MCU ### MCU
| MCU | EFM32PG1B200F256GM48 | | MCU | EFM32PG1B200F256GM48 |
|---------------|--------------------------------------------------------------------------------------------------| |-----------------|--------------------------------------------------------------------------------------------------|
| Family | ARM Cortex-M4F | | Family | ARM Cortex-M4F |
| Vendor | Silicon Labs | | Vendor | Silicon Labs |
| Vendor Family | EFM32 Pearl Gecko 1B | | Vendor Family | EFM32 Pearl Gecko 1B |
| RAM | 32.0KB | | RAM | 32.0 KiB |
| Flash | 256.0KB | | Flash | 256.0 KiB |
| EEPROM | no | | EEPROM | no |
| Frequency | up to 40 MHz | | Frequency | up to 40 MHz |
| FPU | yes | | FPU | yes |
| MPU | yes | | MPU | yes |
| DMA | 8 channels | | DMA | 8 channels |
| Timers | 2x 16-bit, 1x 16-bit (low power) | | Timers | 2x 16-bit + 1x 16-bit (low power) |
| ADCs | 12-bit ADC | | ADCs | 12-bit ADC |
| UARTs | 2x USART, 1x LEUART | | UARTs | 2x USART, 1x LEUART |
| SPIs | 2x USART | | SPIs | 2x USART |
| I2Cs | 2x | | I2Cs | 1x |
| Vcc | 1.85V - 3.8V | | Vcc | 1.85 V - 3.8 V |
| Datasheet | [Datasheet](https://www.silabs.com/Support%20Documents/TechnicalDocs/EFM32PG1-DataSheet.pdf) | | Datasheet | [Datasheet](https://www.silabs.com/documents/public/data-sheets/efm32pg1-datasheet.pdf) |
| Manual | [Manual](https://www.silabs.com/Support%20Documents/TechnicalDocs/EFM32PG1-ReferenceManual.pdf) | | Manual | [Manual](https://www.silabs.com/documents/public/reference-manuals/efm32pg1-rm.pdf) |
| Board Manual | [Board Manual](https://www.silabs.com/documents/public/user-guides/ug154-stk3401-user-guide.pdf) | | Board Manual | [Board Manual](https://www.silabs.com/documents/public/user-guides/ug154-stk3401-user-guide.pdf) |
| Board Schematic | Can be downloaded using Silicon Labs' Simplicity Studio |
### Pinout ### Pinout
This is the pinout of the expansion header on the right side of the board. This is the pinout of the expansion header on the right side of the board.
@ -67,9 +68,9 @@ PIN 1 is the bottom-left contact when the header faces you horizontally.
| RTC | — | RTCC | | 1 Hz interval. Either RTC or RTT (see below) | | RTC | — | RTCC | | 1 Hz interval. Either RTC or RTT (see below) |
| SPI | 0 | USART1 | MOSI: PC6, MISO: PC7, CLK: PC8 | | | SPI | 0 | USART1 | MOSI: PC6, MISO: PC7, CLK: PC8 | |
| Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) | | Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) |
| | 1 | LETIMER0 | | |
| UART | 0 | USART0 | RX: PA1, TX: PA0 | Default STDIO output | | UART | 0 | USART0 | RX: PA1, TX: PA0 | Default STDIO output |
| | 1 | USART1 | RX: PC6, TX: PC7 | | | | 1 | LEUART0 | RX: PD11, TX: PD10 | Baud rate limited (see below) |
| | 2 | LEUART0 | RX: PD11, TX: PD10 | Baud rate limited (see below) |
### User interface ### User interface
| Peripheral | Mapped to | Pin | Comments | | Peripheral | Mapped to | Pin | Comments |
@ -138,8 +139,7 @@ symbols (`-gdwarf-2` for GCC).
### Clock selection ### Clock selection
There are several clock sources that are available for the different There are several clock sources that are available for the different
peripherals. You are advised to read [AN0004.1] peripherals. You are advised to read [AN0004.0](https://www.silabs.com/documents/public/application-notes/an0004.0-efm32-cmu.pdf)
(https://www.silabs.com/documents/public/application-notes/an0004.1-efm32-cmu.pdf)
to get familiar with the different clocks. to get familiar with the different clocks.
| Source | Internal | Speed | Comments | | Source | Internal | Speed | Comments |
@ -148,7 +148,7 @@ to get familiar with the different clocks.
| HFXO | No | 40 MHz | | | HFXO | No | 40 MHz | |
| LFRCO | Yes | 32.768 kHz | | | LFRCO | Yes | 32.768 kHz | |
| LFXO | No | 32.768 kHz | | | LFXO | No | 32.768 kHz | |
| ULFRCO | No | 1.000 kHz | Not very reliable as a time source | | ULFRCO | No | 1 kHz | Not very reliable as a time source |
The sources can be used to clock following branches: The sources can be used to clock following branches:
@ -193,11 +193,11 @@ Therefore, only one of both peripherals can be enabled at the same time.
Configured at 1 Hz interval, the RTCC will overflow each 136 years. Configured at 1 Hz interval, the RTCC will overflow each 136 years.
### Hardware crypto ### Hardware crypto
This MCU is equipped with a hardware accelerated crypto peripheral that can This MCU is equipped with a hardware-accelerated crypto peripheral that can
speed up AES128, AES256, SHA1, SHA256 and several other cryptographic speed up AES128, AES256, SHA1, SHA256 and several other cryptographic
computations. computations.
A peripheral driver interface for RIOT-OS is proposed, but not yet implemented. A peripheral driver interface is proposed, but not yet implemented.
### Usage of EMLIB ### Usage of EMLIB
This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers. This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers.
@ -253,8 +253,8 @@ make emulate
``` ```
## Supported Toolchains ## Supported Toolchains
For using the Silicon Labs SLSTK3401A starter kit we strongly recommend the For using the Silicon Labs SLSTK3401A starter kit we strongly recommend
usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm) the usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm)
toolchain. toolchain.
## License information ## License information

35
boards/slstk3402a/doc.txt
View File

@ -15,26 +15,27 @@ actively measure the power consumption of your hardware and code, in real-time.
### MCU ### MCU
| MCU | EFM32PG12B500F1024GL125 | | MCU | EFM32PG12B500F1024GL125 |
|---------------|--------------------------------------------------------------------------------------------------| |-----------------|--------------------------------------------------------------------------------------------------|
| Family | ARM Cortex-M4F | | Family | ARM Cortex-M4F |
| Vendor | Silicon Labs | | Vendor | Silicon Labs |
| Vendor Family | EFM32 Pearl Gecko 12B | | Vendor Family | EFM32 Pearl Gecko 12B |
| RAM | 256.0KB | | RAM | 256.0 KiB |
| Flash | 1024.0KB | | Flash | 1024.0 KiB |
| EEPROM | no | | EEPROM | no |
| Frequency | up to 40 MHz | | Frequency | up to 40 MHz |
| FPU | yes | | FPU | yes |
| MPU | yes | | MPU | yes |
| DMA | 8 channels | | DMA | 8 channels |
| Timers | 2x 32-bit, 2x 16-bit, 1x 16-bit (low power) | | Timers | 2x 16-bit + 1x 16-bit (low power) |
| ADCs | 12-bit ADC | | ADCs | 12-bit ADC |
| UARTs | 4x USART, 1x LEUART | | UARTs | 2x USART, 1x LEUART |
| SPIs | 4x USART | | SPIs | 2x USART |
| I2Cs | 2x | | I2Cs | 1x |
| Vcc | 1.85V - 3.8V | | Vcc | 1.85 V - 3.8 V |
| Datasheet | [Datasheet](https://www.silabs.com/documents/public/data-sheets/efm32pg12-datasheet.pdf) | | Datasheet | [Datasheet](https://www.silabs.com/documents/public/data-sheets/efm32pg12-datasheet.pdf) |
| Manual | [Manual](https://www.silabs.com/documents/public/reference-manuals/efm32pg12-rm.pdf) | | Manual | [Manual](https://www.silabs.com/documents/public/reference-manuals/efm32pg12-rm.pdf) |
| Board Manual | [Board Manual](https://www.silabs.com/documents/public/user-guides/ug257-stk3402-usersguide.pdf) | | Board Manual | [Board Manual](https://www.silabs.com/documents/public/user-guides/ug257-stk3402-usersguide.pdf) |
| Board Schematic | Can be downloaded using Silicon Labs' Simplicity Studio |
### Pinout ### Pinout
This is the pinout of the expansion header on the right side of the board. This is the pinout of the expansion header on the right side of the board.
@ -68,9 +69,10 @@ PIN 1 is the bottom-left contact when the header faces you horizontally.
| RTC | — | RTCC | | 1 Hz interval. Either RTC or RTT (see below) | | RTC | — | RTCC | | 1 Hz interval. Either RTC or RTT (see below) |
| SPI | 0 | USART1 | MOSI: PC6, MISO: PC7, CLK: PC8 | | | SPI | 0 | USART1 | MOSI: PC6, MISO: PC7, CLK: PC8 | |
| Timer | 0 | WTIMER0 + WTIMER1 | | WTIMER0 is used as prescaler (must be adjecent) | | Timer | 0 | WTIMER0 + WTIMER1 | | WTIMER0 is used as prescaler (must be adjecent) |
| Timer | 1 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) |
| | 2 | LETIMER0 | | |
| UART | 0 | USART0 | RX: PA1, TX: PA0 | Default STDIO output | | UART | 0 | USART0 | RX: PA1, TX: PA0 | Default STDIO output |
| | 1 | USART1 | RX: PC6, TX: PC7 | | | | 1 | LEUART0 | RX: PD11, TX: PD10 | Baud rate limited (see below) |
| | 2 | LEUART0 | RX: PD11, TX: PD10 | Baud rate limited (see below) |
### User interface ### User interface
| Peripheral | Mapped to | Pin | Comments | | Peripheral | Mapped to | Pin | Comments |
@ -140,8 +142,7 @@ symbols (`-gdwarf-2` for GCC).
### Clock selection ### Clock selection
There are several clock sources that are available for the different There are several clock sources that are available for the different
peripherals. You are advised to read [AN0004.1] peripherals. You are advised to read [AN0004.0](https://www.silabs.com/documents/public/application-notes/an0004.0-efm32-cmu.pdf)
(https://www.silabs.com/documents/public/application-notes/an0004.1-efm32-cmu.pdf)
to get familiar with the different clocks. to get familiar with the different clocks.
| Source | Internal | Speed | Comments | | Source | Internal | Speed | Comments |
@ -150,7 +151,7 @@ to get familiar with the different clocks.
| HFXO | No | 40 MHz | | | HFXO | No | 40 MHz | |
| LFRCO | Yes | 32.768 kHz | | | LFRCO | Yes | 32.768 kHz | |
| LFXO | No | 32.768 kHz | | | LFXO | No | 32.768 kHz | |
| ULFRCO | No | 1.000 kHz | Not very reliable as a time source | | ULFRCO | No | 1 kHz | Not very reliable as a time source |
The sources can be used to clock following branches: The sources can be used to clock following branches:
@ -195,11 +196,11 @@ Therefore, only one of both peripherals can be enabled at the same time.
Configured at 1 Hz interval, the RTCC will overflow each 136 years. Configured at 1 Hz interval, the RTCC will overflow each 136 years.
### Hardware crypto ### Hardware crypto
This MCU is equipped with a hardware accelerated crypto peripheral that can This MCU is equipped with a hardware-accelerated crypto peripheral that can
speed up AES128, AES256, SHA1, SHA256 and several other cryptographic speed up AES128, AES256, SHA1, SHA256 and several other cryptographic
computations. computations.
A peripheral driver interface for RIOT-OS is proposed, but not yet implemented. A peripheral driver interface is proposed, but not yet implemented.
### Usage of EMLIB ### Usage of EMLIB
This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers. This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers.
@ -255,8 +256,8 @@ make emulate
``` ```
## Supported Toolchains ## Supported Toolchains
For using the Silicon Labs SLSTK3402A starter kit we strongly recommend the For using the Silicon Labs SLSTK3402A starter kit we strongly recommend
usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm) the usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm)
toolchain. toolchain.
## License information ## License information

46
boards/sltb001a/doc.txt
View File

@ -15,12 +15,12 @@ actively measure the power consumption of your hardware and code, in real-time.
### MCU ### MCU
| MCU | EFR32MG1P132F256GM48 | | MCU | EFR32MG1P132F256GM48 |
|-----------------|-----------------------------------------------------------------------------------------| |-----------------|------------------------------------------------------------------------------------------------|
| Family | ARM Cortex-M4F | | Family | ARM Cortex-M4F |
| Vendor | Silicon Labs | | Vendor | Silicon Labs |
| Vendor Family | EFR32 Mighty Gecko 1P | | Vendor Family | EFR32 Mighty Gecko 1P |
| RAM | 32.0KB (1.0KB reserved) | | RAM | 31.0 KiB |
| Flash | 256.0KB | | Flash | 256.0 KiB |
| EEPROM | no | | EEPROM | no |
| Frequency | up to 38.4 MHz | | Frequency | up to 38.4 MHz |
| FPU | yes | | FPU | yes |
@ -28,14 +28,14 @@ actively measure the power consumption of your hardware and code, in real-time.
| DMA | 12 channels | | DMA | 12 channels |
| Timers | 2x 16-bit + 1x 16-bit (low power) | | Timers | 2x 16-bit + 1x 16-bit (low power) |
| ADCs | 12-bit ADC | | ADCs | 12-bit ADC |
| UARTs | 2x USART, 1x LEUART | | UARTs | 3x UART, 2x USART, 1x LEUART |
| SPIs | 2x USART | | SPIs | 2x USART |
| I2Cs | 1x | | I2Cs | 1x |
| Vcc | 1.85V - 3.8V | | Vcc | 1.85 V - 3.8 V |
| Datasheet | [Datasheet](https://www.silabs.com/documents/public/data-sheets/efr32mg1-datasheet.pdf) | | Datasheet | [Datasheet](https://www.silabs.com/documents/public/data-sheets/efr32mg1-datasheet.pdf) |
| Manual | [Manual](https://www.silabs.com/documents/public/reference-manuals/efr32xg1-rm.pdf) | | Manual | [Manual](https://www.silabs.com/documents/public/reference-manuals/efr32xg1-rm.pdf) |
| Board Manual | [Board Manual](http://www.silabs.com/Support%20Documents/TechnicalDocs/UG250.pdf) | | Board Manual | [Board Manual](https://www.silabs.com/documents/public/user-guides/ug250-tb001-user-guide.pdf) |
| Board Schematic | [Board Schematic](http://www.silabs.com/Support%20Documents/TechnicalDocs/UG250.pdf) | | Board Schematic | Can be downloaded using Silicon Labs' Simplicity Studio |
### Pinout ### Pinout
This is the pinout of the expansion pins on the front side of the board. PIN 1 This is the pinout of the expansion pins on the front side of the board. PIN 1
@ -56,7 +56,6 @@ is the top-left contact, marked on the silkscreen.
**Note**: not all starter kits by Silicon Labs share the same pinout! **Note**: not all starter kits by Silicon Labs share the same pinout!
### Peripheral mapping ### Peripheral mapping
| Peripheral | Number | Hardware | Pins | Comments | | Peripheral | Number | Hardware | Pins | Comments |
|------------|---------|-----------------|--------------------------------|----------------------------------------------------------| |------------|---------|-----------------|--------------------------------|----------------------------------------------------------|
@ -67,9 +66,9 @@ is the top-left contact, marked on the silkscreen.
| RTC | — | RTCC | | 1 Hz interval. Either RTC or RTT (see below) | | RTC | — | RTCC | | 1 Hz interval. Either RTC or RTT (see below) |
| SPI | 0 | USART1 | MOSI: PC6, MISO: PC7, CLK: PC8 | | | SPI | 0 | USART1 | MOSI: PC6, MISO: PC7, CLK: PC8 | |
| Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) | | Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) |
| | 1 | LETIMER0 | | |
| UART | 0 | USART0 | RX: PA1, TX: PA0 | Default STDIO output | | UART | 0 | USART0 | RX: PA1, TX: PA0 | Default STDIO output |
| | 1 | USART1 | RX: PC6, TX: PC7 | | | | 1 | LEUART0 | RX: PD11, TX: PD10 | Baud rate limited (see below) |
| | 2 | LEUART0 | RX: PD11, TX: PD10 | Baud rate limited (see below) |
### User interface ### User interface
| Peripheral | Mapped to | Pin | Comments | | Peripheral | Mapped to | Pin | Comments |
@ -109,8 +108,8 @@ adding `DISABLE_MODULE=silabs_pic` to the `make` command.
## Board configuration ## Board configuration
### Board controller ### Board controller
The starter kit is equipped with a Board Controller. This controller provides a The starter kit is equipped with a Board Controller. This controller provides
virtual serial port. a virtual serial port.
**Note:** the board controller *always* configures the virtual serial port at **Note:** the board controller *always* configures the virtual serial port at
115200 baud with 8 bits, no parity and one stop bit. This also means that it 115200 baud with 8 bits, no parity and one stop bit. This also means that it
@ -118,8 +117,7 @@ expects data from the MCU with the same settings.
### Clock selection ### Clock selection
There are several clock sources that are available for the different There are several clock sources that are available for the different
peripherals. You are advised to read [AN0004.1] peripherals. You are advised to read [AN0004.0](https://www.silabs.com/documents/public/application-notes/an0004.0-efm32-cmu.pdf)
(https://www.silabs.com/documents/public/application-notes/an0004.1-efm32-cmu.pdf)
to get familiar with the different clocks. to get familiar with the different clocks.
| Source | Internal | Speed | Comments | | Source | Internal | Speed | Comments |
@ -128,7 +126,7 @@ to get familiar with the different clocks.
| HFXO | No | 38.4 MHz | | | HFXO | No | 38.4 MHz | |
| LFRCO | Yes | 32.768 kHz | | | LFRCO | Yes | 32.768 kHz | |
| LFXO | No | 32.768 kHz | | | LFXO | No | 32.768 kHz | |
| ULFRCO | No | 1.000 kHz | Not very reliable as a time source | | ULFRCO | No | 1 kHz | Not very reliable as a time source |
The sources can be used to clock following branches: The sources can be used to clock following branches:
@ -140,7 +138,7 @@ The sources can be used to clock following branches:
| LFE | LFRCO, LFXO | Real-time Clock and Calendar | | LFE | LFRCO, LFXO | Real-time Clock and Calendar |
CORELEDIV2 is a source that depends on the clock source that powers the core. CORELEDIV2 is a source that depends on the clock source that powers the core.
It is divided by 2 or 4 to not exceed maximum clock frequencies (emlib takes It is divided by 2 or 4 to not exceed maximum clock frequencies (EMLIB takes
care of this). care of this).
The frequencies mentioned in the tables above are specific for this starter The frequencies mentioned in the tables above are specific for this starter
@ -173,21 +171,21 @@ Therefore, only one of both peripherals can be enabled at the same time.
Configured at 1 Hz interval, the RTCC will overflow each 136 years. Configured at 1 Hz interval, the RTCC will overflow each 136 years.
### Hardware crypto ### Hardware crypto
This MCU is equipped with a hardware accelerated crypto peripheral that can This MCU is equipped with a hardware-accelerated crypto peripheral that can
speed up AES128, AES256, SHA1, SHA256 and several other cryptographic speed up AES128, AES256, SHA1, SHA256 and several other cryptographic
computations. computations.
A peripheral driver interface for RIOT-OS is proposed, but not yet implemented. A peripheral driver interface is proposed, but not yet implemented.
### Usage of emlib ### Usage of EMLIB
This port makes uses of emlib by Silicon Labs to abstract peripheral registers. This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers.
While some overhead is to be expected, it ensures proper setup of devices, While some overhead is to be expected, it ensures proper setup of devices,
provides chip errata and simplifies development. The exact overhead depends on provides chip errata and simplifies development. The exact overhead depends on
the application and peripheral usage, but the largest overhead is expected the application and peripheral usage, but the largest overhead is expected
during peripheral setup. A lot of read/write/get/set methods are implemented as during peripheral setup. A lot of read/write/get/set methods are implemented as
inline methods or macros (which have no overhead). inline methods or macros (which have no overhead).
Another advantage of emlib are the included assertions. These assertions ensure Another advantage of EMLIB are the included assertions. These assertions ensure
that peripherals are used properly. To enable this, pass `DEBUG_EFM` to your that peripherals are used properly. To enable this, pass `DEBUG_EFM` to your
compiler. compiler.
@ -233,10 +231,10 @@ make emulate
``` ```
## Supported Toolchains ## Supported Toolchains
For using the Silicon Labs SLTB001A starter kit we strongly recommend the usage For using the Silicon Labs SLTB001A starter kit we strongly recommend
of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm) the usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm)
toolchain. toolchain.
## License information ## License information
* Silicon Labs' emlib: zlib-style license (permits distribution of source). * Silicon Labs' EMLIB: zlib-style license (permits distribution of source).
*/ */

145
boards/stk3200/doc.txt
View File

@ -1,41 +1,45 @@
/** /**
@defgroup boards_stk3200 Silicon Labs STK3200 starter kit * @defgroup boards_stk3200 Silicon Labs STK3200 starter kit
@ingroup boards * @ingroup boards
@brief Support for Silicon Labs STK3200 starter kit * @brief Support for Silicon Labs STK3200 starter kit
## Overview ## Overview
Silicon Labs EFM32 Zero Gecko Starter Kit is equipped with the EFM32 microcontroller. It is specifically designed for low-power applications, having energy-saving peripherals, different energy modes and short wake-up times. Silicon Labs EFM32 Zero Gecko Starter Kit is equipped with the EFM32
microcontroller. It is specifically designed for low-power applications, having
energy-saving peripherals, different energy modes and short wake-up times.
The starter kit is equipped with an Advanced Energy Monitor. This allows you to actively measure the power consumption of your hardware and code, in real-time. The starter kit is equipped with an Advanced Energy Monitor. This allows you to
actively measure the power consumption of your hardware and code, in real-time.
## Hardware ## Hardware
### MCU ### MCU
| MCU | EFM32ZG222F32 | | MCU | EFM32ZG222F32 |
|-----------------|------------------------------------------------------| |-----------------|--------------------------------------------------------------------------------------------|
| Family | ARM Cortex-M0PLUS | | Family | ARM Cortex-M0PLUS |
| Vendor | Silicon Labs | | Vendor | Silicon Labs |
| Vendor Family | EFM32 Zero Gecko | | Vendor Family | EFM32 Zero Gecko |
| RAM | 4.0KB | | RAM | 4.0 KiB |
| Flash | 32.0KB | | Flash | 32.0 KiB |
| EEPROM | no | | EEPROM | no |
| Frequency | up to 24 MHz | | Frequency | up to 24 MHz |
| FPU | no | | FPU | no |
| MPU | no | | MPU | no |
| DMA | 12 channels | | DMA | 12 channels |
| Timers | 2x 16-bit + 1x 16-bit (low power) | | Timers | 2x 16-bit |
| ADCs | 12-bit ADC | | ADCs | 12-bit ADC |
| UARTs | 2x USART, 1x LEUART | | UARTs | 2x USART, 1x LEUART |
| SPIs | 2x SPI | | SPIs | 2x USART |
| I2Cs | 1x | | I2Cs | 1x |
| Vcc | 1.98V - 3.8V | | Vcc | 1.98 V - 3.8 V |
| Datasheet | [Datasheet](https://www.silabs.com/Support%20Documents/TechnicalDocs/EFM32ZG222.pdf) | | Datasheet | [Datasheet](https://www.silabs.com/documents/public/data-sheets/efm32zg-datasheet.pdf) |
| Manual | [Manual](https://www.silabs.com/Support%20Documents/TechnicalDocs/EFM32ZG-RM.pdf) | | Manual | [Manual](https://www.silabs.com/documents/public/reference-manuals/EFM32ZG-RM.pdf) |
| Board Manual | [Board Manual](https://www.silabs.com/Support%20Documents/TechnicalDocs/efm32zg-stk3200-ug.pdf) | | Board Manual | [Board Manual](https://www.silabs.com/documents/public/user-guides/efm32zg-stk3200-ug.pdf) |
| Board Schematic | [Board Schematic](https://www.silabs.com/Support%20Documents/TechnicalDocs/BRD2010A_B01.pdf) | | Board Schematic | Can be downloaded using Silicon Labs' Simplicity Studio |
### Pinout ### Pinout
This is the pinout of the expansion header on the right side of the board. PIN 1 is the bottom-left contact when the header faces you horizontally. This is the pinout of the expansion header on the right side of the board.
PIN 1 is the bottom-left contact when the header faces you horizontally.
| | PIN | PIN | | | | PIN | PIN | |
|------|-----|-----|------| |------|-----|-----|------|
@ -56,7 +60,7 @@ This is the pinout of the expansion header on the right side of the board. PIN 1
### Peripheral mapping ### Peripheral mapping
| Peripheral | Number | Hardware | Pins | Comments | | Peripheral | Number | Hardware | Pins | Comments |
|------------|---------|-----------------|---------------------------------|-----------------------------------------------------------| |------------|---------|-----------------|---------------------------------|----------------------------------------------------------|
| ADC | 0 | ADC0 | CHAN0: internal temperature | Ports are fixed, 14/16-bit resolution not supported | | ADC | 0 | ADC0 | CHAN0: internal temperature | Ports are fixed, 14/16-bit resolution not supported |
| I2C | 0 | I2C0 | SDA: PE12, SCL: PE13 | `I2C_SPEED_LOW` and `I2C_SPEED_HIGH` clock speed deviate | | I2C | 0 | I2C0 | SDA: PE12, SCL: PE13 | `I2C_SPEED_LOW` and `I2C_SPEED_HIGH` clock speed deviate |
| HWCRYPTO | — | — | | AES128/AES256 only | | HWCRYPTO | — | — | | AES128/AES256 only |
@ -65,19 +69,18 @@ This is the pinout of the expansion header on the right side of the board. PIN 1
| SPI | 0 | USART1 | MOSI: PD7, MISO: PD6, CLK: PC15 | | | SPI | 0 | USART1 | MOSI: PD7, MISO: PD6, CLK: PC15 | |
| Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) | | Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) |
| UART | 0 | LEUART0 | RX: PD5, TX: PD4 | STDIO Output, Baud rate limited (see below) | | UART | 0 | LEUART0 | RX: PD5, TX: PD4 | STDIO Output, Baud rate limited (see below) |
| | 1 | USART1 | RX: PD6, TX: PD7 | |
### User interface ### User interface
| Peripheral | Mapped to | Pin | Comments | | Peripheral | Mapped to | Pin | Comments |
|------------|-----------|------|------------| |------------|-----------|------|------------|
| Button | PB0 | PC8 | | | Button | PB0_PIN | PC8 | |
| | PB1 | PC9 | | | | PB1_PIN | PC9 | |
| LED | LED0 | PC10 | Yellow LED | | LED | LED0_PIN | PC10 | Yellow LED |
| | LED1 | PC11 | Yellow LED | | | LED1_PIN | PC11 | Yellow LED |
## Implementation Status ## Implementation Status
| Device | ID | Supported | Comments | | Device | ID | Supported | Comments |
|-------------------------------|-------------------------------------|-----------|----------------------------------------------------------------| |------------------|-------------|-----------|----------------------------------------------------------------|
| MCU | EFM32ZG | yes | Power modes supported | | MCU | EFM32ZG | yes | Power modes supported |
| Low-level driver | ADC | yes | | | Low-level driver | ADC | yes | |
| | Flash | yes | | | | Flash | yes | |
@ -90,33 +93,41 @@ This is the pinout of the expansion header on the right side of the board. PIN 1
| | Timer | yes | | | | Timer | yes | |
| | UART | yes | USART is shared with SPI. LEUART baud rate limited (see below) | | | UART | yes | USART is shared with SPI. LEUART baud rate limited (see below) |
| | USB | no | | | | USB | no | |
| LCD driver | LS013B7DH03 | yes | Sharp Low Power Memory LCD | | LCD driver | LS013B7DH03 | yes | Sharp Low Power Memory LCD via the U8g2 package |
## Board configuration ## Board configuration
### Board controller ### Board controller
The starter kit is equipped with a Board Controller. This controller provides a virtual serial port. The board controller is enabled via a GPIO pin. The starter kit is equipped with a Board Controller. This controller provides a
virtual serial port. The board controller is enabled via a GPIO pin.
By default, this pin is enabled. You can disable the board controller module by passing `DISABLE_MODULE=silabs_bc` to the `make` command. By default, this pin is enabled. You can disable the board controller module by
passing `DISABLE_MODULE=silabs_bc` to the `make` command.
**Note:** to use the virtual serial port, ensure you have the latest board controller firmware installed. **Note:** to use the virtual serial port, ensure you have the latest board
controller firmware installed.
**Note:** the board controller *always* configures the virtual serial port at 115200 baud with 8 bits, no parity and one stop bit. This also means that it expects data from the MCU with the same settings. **Note:** the board controller *always* configures the virtual serial port at
115200 baud with 8 bits, no parity and one stop bit. This also means that it
expects data from the MCU with the same settings.
The low power LCD is also used by the board controller when the `DISP_SELECTED` pin is low. This pin is not initialized by the board, so you have to ensure this pin is initialized by your application if you want to control the low power LCD. The low power LCD is also used by the board controller when the `DISP_SELECTED`
pin is low. This pin is not initialized by the board, so you have to ensure
this pin is initialized by your application if you want to control the low
power LCD.
### Clock selection ### Clock selection
There are several clock sources that are available for the different peripherals. You are advised to read [AN0004](https://www.silabs.com/Support%20Documents/TechnicalDocs/AN0004.pdf) to get familiar with the different clocks. There are several clock sources that are available for the different
peripherals. You are advised to read [AN0004.0](https://www.silabs.com/documents/public/application-notes/an0004.0-efm32-cmu.pdf)
to get familiar with the different clocks.
| Source | Internal | Speed | Comments | | Source | Internal | Speed | Comments |
|---------|----------|----------------------------------|------------------------------------| |--------|----------|------------|------------------------------------|
| HFRCO | Yes | 14 MHz | Enabled during startup, changeable | | HFRCO | Yes | 14 MHz | Enabled during startup, changeable |
| HFXO | No | 24 MHz | | | HFXO | No | 24 MHz | |
| LFRCO | Yes | 32.768 kHz | | | LFRCO | Yes | 32.768 kHz | |
| LFXO | No | 32.768 kHz | | | LFXO | No | 32.768 kHz | |
| ULFRCO | No | 1.000 kHz | Not very reliable as a time source | | ULFRCO | No | 1 kHz | Not very reliable as a time source |
The sources can be used to clock following branches: The sources can be used to clock following branches:
@ -126,43 +137,71 @@ The sources can be used to clock following branches:
| LFA | LFRCO, LFXO | Low-power timers | | LFA | LFRCO, LFXO | Low-power timers |
| LFB | LFRCO, LFXO, CORELEDIV2 | Low-power UART | | LFB | LFRCO, LFXO, CORELEDIV2 | Low-power UART |
CORELEDIV2 is a source that depends on the clock source that powers the core. It is divided by 2 or 4 to not exceed maximum clock frequencies (emlib takes care of this). CORELEDIV2 is a source that depends on the clock source that powers the core.
It is divided by 2 or 4 to not exceed maximum clock frequencies (EMLIB takes
care of this).
The frequencies mentioned in the tables above are specific for this starter kit. The frequencies mentioned in the tables above are specific for this starter
kit.
It is important that the clock speeds are known to the code, for proper calculations of speeds and baud rates. If the HFXO or LFXO are different from the speeds above, ensure to pass `EFM32_HFXO_FREQ=freq_in_hz` and `EFM32_LFXO_FREQ=freq_in_hz` to your compiler. It is important that the clock speeds are known to the code, for proper
calculations of speeds and baud rates. If the HFXO or LFXO are different from
the speeds above, ensure to pass `EFM32_HFXO_FREQ=freq_in_hz` and
`EFM32_LFXO_FREQ=freq_in_hz` to your compiler.
You can override the branch's clock source by adding `CLOCK_LFA=source` to your compiler defines, e.g. `CLOCK_LFA=cmuSelect_LFRCO`. You can override the branch's clock source by adding `CLOCK_LFA=source` to your
compiler defines, e.g. `CLOCK_LFA=cmuSelect_LFRCO`.
### Low-power peripherals ### Low-power peripherals
The low-power UART is capable of providing an UART peripheral using a low-speed clock. When the LFB clock source is the LFRCO or LFXO, it can still be used in EM2. However, this limits the baud rate to 9600 baud. If a higher baud rate is desired, set the clock source to CORELEDIV2. The low-power UART is capable of providing an UART peripheral using a low-speed
clock. When the LFB clock source is the LFRCO or LFXO, it can still be used in
EM2. However, this limits the baud rate to 9600 baud. If a higher baud rate is
desired, set the clock source to CORELEDIV2.
**Note:** peripheral mappings in your board definitions will not be affected by this setting. Ensure you do not refer to any low-power peripherals. **Note:** peripheral mappings in your board definitions will not be affected by
this setting. Ensure you do not refer to any low-power peripherals.
### RTC or RTT ### RTC or RTT
RIOT-OS has support for *Real-Time Tickers* and *Real-Time Clocks*. RIOT-OS has support for *Real-Time Tickers* and *Real-Time Clocks*.
However, this board MCU family has support for a 24-bit *Real-Time Counter* only, which is a ticker only. A compatibility layer for ticker-to-calendar is available, but this includes extra code size to convert from timestamps to time structures and visa versa. However, this board MCU family has support for a 24-bit *Real-Time Counter*
only, which is a ticker only. A compatibility layer for ticker-to-calendar is
available, but this includes extra code size to convert from timestamps to time
structures and visa versa.
Configured at 1 Hz interval, the RTC will overflow each 194 days. When using the ticker-to-calendar mode, this interval is extended artificially. Configured at 1 Hz interval, the RTC will overflow each 194 days. When using
the ticker-to-calendar mode, this interval is extended artificially.
### Hardware crypto ### Hardware crypto
This MCUs has support for hardware accelerated AES128. This MCUs has support for hardware-accelerated AES128.
A peripheral driver interface for RIOT-OS is proposed, but not yet implemented. A peripheral driver interface is proposed, but not yet implemented.
### Usage of emlib ### Usage of EMLIB
This port makes uses of emlib by Silicon Labs to abstract peripheral registers. While some overhead is to be expected, it ensures proper setup of devices, provides chip errata and simplifies development. The exact overhead depends on the application and peripheral usage, but the largest overhead is expected during peripheral setup. A lot of read/write/get/set methods are implemented as inline methods or macros (which have no overhead). This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers.
While some overhead is to be expected, it ensures proper setup of devices,
provides chip errata and simplifies development. The exact overhead depends on
the application and peripheral usage, but the largest overhead is expected
during peripheral setup. A lot of read/write/get/set methods are implemented as
inline methods or macros (which have no overhead).
Another advantage of emlib are the included assertions. These assertions ensure that peripherals are used properly. To enable this, pass `DEBUG_EFM` to your compiler. Another advantage of EMLIB are the included assertions. These assertions ensure
that peripherals are used properly. To enable this, pass `DEBUG_EFM` to your
compiler.
### Pin locations ### Pin locations
The EFM32 platform supports peripherals to be mapped to different pins (predefined locations). The definitions in `periph_conf.h` mostly consist of a location number and the actual pins. The actual pins are required to configure the pins via GPIO driver, while the location is used to map the peripheral to these pins. The EFM32 platform supports peripherals to be mapped to different pins
(predefined locations). The definitions in `periph_conf.h` mostly consist of a
location number and the actual pins. The actual pins are required to configure
the pins via GPIO driver, while the location is used to map the peripheral to
these pins.
In other words, these definitions must match. Refer to the data sheet for more information. In other words, these definitions must match. Refer to the data sheet for more
information.
## Flashing the device ## Flashing the device
To flash, [SEGGER JLink](https://www.segger.com/jlink-software.html) is required. To flash, [SEGGER JLink](https://www.segger.com/jlink-software.html) is
required.
Flashing is supported by RIOT-OS using the command below: Flashing is supported by RIOT-OS using the command below:
@ -189,8 +228,10 @@ make emulate
``` ```
## Supported Toolchains ## Supported Toolchains
For using the Silicon Labs STK3200 starter kit we strongly recommend the usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm) toolchain. For using the Silicon Labs STK3200 starter kit we strongly recommend
the usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm)
toolchain.
## License information ## License information
* Silicon Labs' emlib: zlib-style license (permits distribution of source). * Silicon Labs' EMLIB: zlib-style license (permits distribution of source).
*/ */

35
boards/stk3600/doc.txt
View File

@ -15,27 +15,27 @@ actively measure the power consumption of your hardware and code, in real-time.
### MCU ### MCU
| MCU | EFM32LG990F256 | | MCU | EFM32LG990F256 |
|-----------------|-------------------------------------------------------------------------------------------------| |-----------------|--------------------------------------------------------------------------------------------|
| Family | ARM Cortex-M3 | | Family | ARM Cortex-M3 |
| Vendor | Silicon Labs | | Vendor | Silicon Labs |
| Vendor Family | EFM32 Leoppard Gecko | | Vendor Family | EFM32 Leoppard Gecko |
| RAM | 32.0KB | | RAM | 32.0 KiB |
| Flash | 256.0KB | | Flash | 256.0 KiB |
| EEPROM | no | | EEPROM | no |
| Frequency | up to 48 MHz | | Frequency | up to 48 MHz |
| FPU | no | | FPU | no |
| MPU | yes | | MPU | yes |
| DMA | 12 channels | | DMA | 12 channels |
| Timers | 3x 16-bit, 1x 16-bit (low power) | | Timers | 3x 16-bit + 1x 16-bit (low power) |
| ADCs, DACs | 12-bit ADC, 12-bit DAC | | ADCs, DACs | 12-bit ADC, 12-bit DAC |
| UARTs | 2x UART, 3x USART, 2x LEUART | | UARTs | 2x UART, 3x USART, 2x LEUART |
| SPIs | 3x USART | | SPIs | 3x USART |
| I2Cs | 2x | | I2Cs | 2x |
| Vcc | 1.98V - 3.8V | | Vcc | 1.98 V - 3.8 V |
| Datasheet | [Datasheet](https://www.silabs.com/Support%20Documents/TechnicalDocs/EFM32LG990.pdf) | | Datasheet | [Datasheet](https://www.silabs.com/documents/public/data-sheets/efm32lg-datasheet.pdf) |
| Manual | [Manual](https://www.silabs.com/Support%20Documents/TechnicalDocs/EFM32LG-RM.pdf) | | Manual | [Manual](https://www.silabs.com/documents/public/reference-manuals/EFM32LG-RM.pdf) |
| Board Manual | [Board Manual](https://www.silabs.com/Support%20Documents/TechnicalDocs/efm32lg-stk3600-ug.pdf) | | Board Manual | [Board Manual](https://www.silabs.com/documents/public/user-guides/efm32lg-stk3600-ug.pdf) |
| Board Schematic | [Board Schematic](https://www.silabs.com/Support%20Documents/TechnicalDocs/BRD2201A_A02.pdf) | | Board Schematic | Can be downloaded using Silicon Labs' Simplicity Studio |
### Pinout ### Pinout
This is the pinout of the expansion header on the right side of the board. This is the pinout of the expansion header on the right side of the board.
@ -72,9 +72,9 @@ PIN 1 is the bottom-left contact when the header faces you horizontally.
| SPI | 0 | USART1 | MOSI: PD0, MISO: PD1, CLK: PD2 | | | SPI | 0 | USART1 | MOSI: PD0, MISO: PD1, CLK: PD2 | |
| | 1 | USART2 | MOSI: NC, MISO: PC3, CLK: PC4 | | | | 1 | USART2 | MOSI: NC, MISO: PC3, CLK: PC4 | |
| Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) | | Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) |
| | 1 | LETIMER0 | | |
| UART | 0 | UART0 | RX: PE1, TX: PE0 | STDIO output | | UART | 0 | UART0 | RX: PE1, TX: PE0 | STDIO output |
| | 1 | USART1 | RX: PD1, TX: PD0 | | | | 1 | LEUART0 | RX: PD5, TX: PD4 | Baud rate limited (see below) |
| | 2 | LEUART0 | RX: PD5, TX: PD4 | Baud rate limited (see below) |
### User interface ### User interface
| Peripheral | Mapped to | Pin | Comments | | Peripheral | Mapped to | Pin | Comments |
@ -137,8 +137,7 @@ symbols (`-gdwarf-2` for GCC).
### Clock selection ### Clock selection
There are several clock sources that are available for the different There are several clock sources that are available for the different
peripherals. You are advised to read [AN0004.0] peripherals. You are advised to read [AN0004.0](https://www.silabs.com/documents/public/application-notes/an0004.0-efm32-cmu.pdf)
(https://www.silabs.com/documents/public/application-notes/an0004.0-efm32-cmu.pdf)
to get familiar with the different clocks. to get familiar with the different clocks.
| Source | Internal | Speed | Comments | | Source | Internal | Speed | Comments |
@ -147,7 +146,7 @@ to get familiar with the different clocks.
| HFXO | No | 48 MHz | | | HFXO | No | 48 MHz | |
| LFRCO | Yes | 32.768 kHz | | | LFRCO | Yes | 32.768 kHz | |
| LFXO | No | 32.768 kHz | | | LFXO | No | 32.768 kHz | |
| ULFRCO | No | 1.000 kHz | Not very reliable as a time source | | ULFRCO | No | 1 kHz | Not very reliable as a time source |
The sources can be used to clock following branches: The sources can be used to clock following branches:
@ -193,9 +192,9 @@ Configured at 1 Hz interval, the RTC will overflow each 194 days. When using
the ticker-to-calendar mode, this interval is extended artificially. the ticker-to-calendar mode, this interval is extended artificially.
### Hardware crypto ### Hardware crypto
This MCUs has support for hardware accelerated AES128 and AES256. This MCUs has support for hardware-accelerated AES128 and AES256.
A peripheral driver interface for RIOT-OS is proposed, but not yet implemented. A peripheral driver interface is proposed, but not yet implemented.
### Usage of EMLIB ### Usage of EMLIB
This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers. This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers.
@ -248,8 +247,8 @@ make emulate
``` ```
## Supported Toolchains ## Supported Toolchains
For using the Silicon Labs STK3600 starter kit we strongly recommend the usage For using the Silicon Labs STK3600 starter kit we strongly recommend
of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm) the usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm)
toolchain. toolchain.
## License information ## License information

35
boards/stk3700/doc.txt
View File

@ -15,27 +15,27 @@ actively measure the power consumption of your hardware and code, in real-time.
### MCU ### MCU
| MCU | EFM32GG990F1024 | | MCU | EFM32GG990F1024 |
|-----------------|---------------------------------------------------------------------------------------------------------------| |-----------------|--------------------------------------------------------------------------------------------|
| Family | ARM Cortex-M3 | | Family | ARM Cortex-M3 |
| Vendor | Silicon Labs | | Vendor | Silicon Labs |
| Vendor Family | EFM32 Giant Gecko | | Vendor Family | EFM32 Giant Gecko |
| RAM | 128.0KB | | RAM | 128.0 KiB |
| Flash | 1024.0KB | | Flash | 1024.0 KiB |
| EEPROM | no | | EEPROM | no |
| Frequency | up to 48 MHz | | Frequency | up to 48 MHz |
| FPU | no | | FPU | no |
| MPU | yes | | MPU | yes |
| DMA | 12 channels | | DMA | 12 channels |
| Timers | 3x 16-bit, 1x 16-bit (low power) | | Timers | 3x 16-bit + 1x 16-bit (low power) |
| ADCs, DACs | 12-bit ADC, 12-bit DAC | | ADCs, DACs | 12-bit ADC, 12-bit DAC |
| UARTs | 2x UART, 3x USART, 2x LEUART | | UARTs | 2x UART, 3x USART, 2x LEUART |
| SPIs | 3x USART | | SPIs | 3x USART |
| I2Cs | 2x | | I2Cs | 2x |
| Vcc | 1.98V - 3.8V | | Vcc | 1.98 V - 3.8 V |
| Datasheet | [Datasheet](https://www.silabs.com/Support%20Documents/TechnicalDocs/EFM32GG990.pdf) | | Datasheet | [Datasheet](https://www.silabs.com/documents/public/data-sheets/efm32gg-datasheet.pdf) |
| Manual | [Manual](https://www.silabs.com/Support%20Documents/TechnicalDocs/EFM32GG-RM.pdf) | | Manual | [Manual](https://www.silabs.com/documents/public/reference-manuals/EFM32GG-RM.pdf) |
| Board Manual | [Board Manual](https://www.silabs.com/Support%20Documents/TechnicalDocs/efm32gg-stk3700-ug.pdf) | | Board Manual | [Board Manual](https://www.silabs.com/documents/public/user-guides/efm32gg-stk3700-ug.pdf) |
| Board Schematic | [Board Schematic](https://www.silabs.com/documents/public/schematic-files/EFM32GG-BRD2200A-A03-schematic.pdf) | | Board Schematic | Can be downloaded using Silicon Labs' Simplicity Studio |
### Pinout ### Pinout
This is the pinout of the expansion header on the right side of the board. This is the pinout of the expansion header on the right side of the board.
@ -72,9 +72,9 @@ PIN 1 is the bottom-left contact when the header faces you horizontally.
| SPI | 0 | USART1 | MOSI: PD0, MISO: PD1, CLK: PD2 | | | SPI | 0 | USART1 | MOSI: PD0, MISO: PD1, CLK: PD2 | |
| | 1 | USART2 | MOSI: NC, MISO: PC3, CLK: PC4 | | | | 1 | USART2 | MOSI: NC, MISO: PC3, CLK: PC4 | |
| Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) | | Timer | 0 | TIMER0 + TIMER1 | | TIMER0 is used as prescaler (must be adjecent) |
| | 1 | LETIMER0 | | |
| UART | 0 | UART0 | RX: PE1, TX: PE0 | STDIO output | | UART | 0 | UART0 | RX: PE1, TX: PE0 | STDIO output |
| | 1 | USART1 | RX: PD1, TX: PD0 | | | | 1 | LEUART0 | RX: PD5, TX: PD4 | Baud rate limited (see below) |
| | 2 | LEUART0 | RX: PD5, TX: PD4 | Baud rate limited (see below) |
### User interface ### User interface
| Peripheral | Mapped to | Pin | Comments | | Peripheral | Mapped to | Pin | Comments |
@ -137,8 +137,7 @@ symbols (`-gdwarf-2` for GCC).
### Clock selection ### Clock selection
There are several clock sources that are available for the different There are several clock sources that are available for the different
peripherals. You are advised to read [AN0004.0] peripherals. You are advised to read [AN0004.0](https://www.silabs.com/documents/public/application-notes/an0004.0-efm32-cmu.pdf)
(https://www.silabs.com/documents/public/application-notes/an0004.0-efm32-cmu.pdf)
to get familiar with the different clocks. to get familiar with the different clocks.
| Source | Internal | Speed | Comments | | Source | Internal | Speed | Comments |
@ -147,7 +146,7 @@ to get familiar with the different clocks.
| HFXO | No | 48 MHz | | | HFXO | No | 48 MHz | |
| LFRCO | Yes | 32.768 kHz | | | LFRCO | Yes | 32.768 kHz | |
| LFXO | No | 32.768 kHz | | | LFXO | No | 32.768 kHz | |
| ULFRCO | No | 1.000 kHz | Not very reliable as a time source | | ULFRCO | No | 1 kHz | Not very reliable as a time source |
The sources can be used to clock following branches: The sources can be used to clock following branches:
@ -193,9 +192,9 @@ Configured at 1 Hz interval, the RTC will overflow each 194 days. When using
the ticker-to-calendar mode, this interval is extended artificially. the ticker-to-calendar mode, this interval is extended artificially.
### Hardware crypto ### Hardware crypto
This MCUs has support for hardware accelerated AES128 and AES256. This MCUs has support for hardware-accelerated AES128 and AES256.
A peripheral driver interface for RIOT-OS is proposed, but not yet implemented. A peripheral driver interface is proposed, but not yet implemented.
### Usage of EMLIB ### Usage of EMLIB
This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers. This port makes uses of EMLIB by Silicon Labs to abstract peripheral registers.
@ -248,8 +247,8 @@ make emulate
``` ```
## Supported Toolchains ## Supported Toolchains
For using the Silicon Labs STK3700 starter kit we strongly recommend the usage For using the Silicon Labs STK3700 starter kit we strongly recommend
of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm) the usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm)
toolchain. toolchain.
## License information ## License information