summaryrefslogtreecommitdiff
path: root/nuttx/configs/olimex-efm32g880f128-stk/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'nuttx/configs/olimex-efm32g880f128-stk/README.txt')
-rw-r--r--nuttx/configs/olimex-efm32g880f128-stk/README.txt150
1 files changed, 150 insertions, 0 deletions
diff --git a/nuttx/configs/olimex-efm32g880f128-stk/README.txt b/nuttx/configs/olimex-efm32g880f128-stk/README.txt
new file mode 100644
index 000000000..887daa38e
--- /dev/null
+++ b/nuttx/configs/olimex-efm32g880f128-stk/README.txt
@@ -0,0 +1,150 @@
+README
+======
+
+ This README file discusses the port of NuttX to the Olimex EFM32G880F128-STK
+ development board. This board features:
+
+ • EFM32G880F128
+ - 32 bit Cortex-M3™
+ - 128KiB Program Flash, 16KiB Bytes RAM
+ - 85 GPIO, 8 Channel DMA
+ - 12 bit ADC 1Msps
+ - 3xUART/SPI, 2x low power UART
+ - I2C
+ - 3x 16bit TIMERS
+ - 3x2 CC-PWM
+ - SSC
+ - RTC
+ - WDT
+ - Up to 32MHz operation
+ • 32.768 kHz crystal
+ • 32 MHz crystal
+ • LCD custom display
+ • DEBUG connector with ARM 2x10 pin layout for programming/debugging
+ with ARM-JTAG-EW
+ • UEXT connector
+ • EXT extension connector
+ • RS232 connector and driver
+ • Power jack
+ • Lithium coin battery holder
+ • RESET circuit , RESET button
+ • Four user buttons
+ • Buzzer
+ • On-board voltage regulator 3.3V with up to 800mA current
+ • Power supply filtering capacitor
+ • Extension headers for some of the uC ports + RST and power supply
+
+LEDs
+====
+
+ The EFM32G880F128-STK has no user controllable LEDs.
+
+Serial Console
+==============
+
+ Pin Availability
+ ----------------
+ The EFM32G890F128 support the following options for serial output. NOTE
+ (1) that not all of these pins are available for use as a serial console,
+ however. And (2) not all pins made available by the board.
+
+ EFM32 PIN GPIO NOTES/CONFLICTS/AVAILABILITY
+ ------- -- ---- ----------------------------------------------
+ US0_RX #0 PE11 SEG7 (LCD)
+ US0_RX #1 PE6 COM2 (LCD)
+ US0_RX #2 PC10 **AVAILABLE at EXT-12**
+
+ US0_TX #0 PE10 SEG6 (LCD)
+ US0_TX #1 PE7 COM3 (LCD)
+ US0_TX #2 PC11 **AVAILABLE at EXT-13**
+ ------- -- ----
+ US1_RX #0 PC1 **AVAILABLE at EXT-5**
+ US1_RX #1 PD1 MISO1, Available at UEXT-7
+
+ US1_TX #0 PC0 **AVAILABLE at EXT-4**
+ US1_TX #1 PD0 MOSI1, Available at UEXT-8
+ ------- -- ----
+ US2_RX #0 PC3 **AVAILABLE at EXT-7**
+ US2_RX #1 PB4 SEG21 (LCD)
+
+ US2_TX #0 PC2 **AVAILABLE at EXT-6**
+ US2_TX #1 PB3 SEG20 (LCD)
+ ------- -- ----
+ U0_RX #0 PF7 SEG25 (LCD)
+ U0_RX #1 PE1 **AVAILABLE at EXT-19**
+ U0_RX #2 PA4 SEG18 (LCD)
+ U0_RX #3 PC15 DBG_SWV
+
+ U0_TX #0 PF6 SEG24 (LCD)
+ U0_TX #1 PE0 **AVAILABLE at EXT-18**
+ U0_TX #2 PA3 SEG17 (LCD)
+ U0_TX #3 PC14 **AVAILABLE at EXT-16**
+ ------- -- ----
+ LEU0_RX #0 PD5 LEU0_RX, Available at UEXT-4
+ LEU0_RX #1 PB14 HFXTAL_N
+ LEU0_RX #2 PE15 SEG11 (LCD)
+
+ LEU0_TX #0 PD4 LEU0_TX, Available at UEXT-3
+ LEU0_TX #1 PB13 HFXTAL_P
+ LEU0_TX #2 PE14 SEG10 (LCD)
+ ------- -- ----
+ LEU1_RX #0 PC7 LEU1_RX to DB-9 connector
+ LEU1_RX #1 PA6 SEG19 (LCD)
+
+ LEU1_TX #0 PC6 LEU1_TX to DB-9 connector
+ LEU1_TX #1 PA5 SEG18 (LCD)
+ ------- -- ----
+
+ RS-232 Driver/DB-9 Connector
+ ----------------------------
+ LEUART1 is available on through an RS232 driver on DB-9 connector.
+ Unfortunately, there is no LEUART serial driver available in NuttX as of
+ this writing.
+
+ Default Serial Console
+ ----------------------
+ UART0 is configured as the default serial console at 115200 8N1
+ on pins PE0 and PE1.
+
+Configurations
+==============
+ Each EFM32G880F128-STK configuration is maintained in a sub-director
+ and can be selected as follow:
+
+ cd tools
+ ./configure.sh olimex-efm32g880f128-stk/<subdir>
+ cd -
+ . ./setenv.sh
+
+ If this is a Windows native build, then configure.bat should be used
+ instead of configure.sh:
+
+ configure.bat olimex-efm32g880f128-stk\<subdir>
+
+ Where <subdir> is one of the following:
+
+ nsh:
+ ---
+ Configures the NuttShell (nsh) located at apps/examples/nsh. The
+ Configuration enables the serial interfaces on UART0. Support for
+ builtin applications is enabled, but in the base configuration no
+ builtin applications are selected (see NOTES below).
+
+ NOTES:
+
+ 1. This configuration uses the mconf-based configuration tool. To
+ change this configuration using that tool, you should:
+
+ a. Build and install the kconfig-mconf tool. See nuttx/README.txt
+ and misc/tools/
+
+ b. Execute 'make menuconfig' in nuttx/ in order to start the
+ reconfiguration process.
+
+ 2. By default, this configuration uses the CodeSourcery toolchain
+ for Windows and builds under Cygwin (or probably MSYS). That
+ can easily be reconfigured, of course.
+
+ CONFIG_HOST_WINDOWS=y : Builds under Windows
+ CONFIG_WINDOWS_CYGWIN=y : Using Cygwin
+ CONFIG_ARMV7M_TOOLCHAIN_CODESOURCERYW=y : CodeSourcery for Windows