56529d2944
- migrated /README are removed from /boards - there are a lot of READMEs that should be further converted to rst. At the moment they are moved to Documentation/platforms and included in rst files
237 lines
9.7 KiB
Plaintext
237 lines
9.7 KiB
Plaintext
README
|
|
======
|
|
|
|
This port is for the FRDM-K28F development board that features the
|
|
MK28FN2M0VMI15 MCU. The features of the FRDM-K28F board are:
|
|
|
|
o Kinetis MK28FN2M0VMI15 MCU (ARM Cortex-M4 at150 MHz, 1 MB SRAM, 2 MB flash,
|
|
HS and FS USB, 169 MAPBGA package).
|
|
o Kinetis K20 MCU (K20DX128VFM5) based OpenSDA circuit.
|
|
o Dual-role high-speed and full-speed USB interface with the micro-B USB
|
|
connector via the high-speed switch.
|
|
o One 256 Mbit (32 MB) on-board QuadSPI memory at 1.8 V.
|
|
o One 128 Mbit (16 MB) on-board mobile SDRAM memory at 3.3 V.
|
|
o Multiple independent voltage domains: VDD_CORE, VDD, VBAT, and VDDIO_E.
|
|
o FlexIO socket which enables you to connect an optional TFT Proto 5"
|
|
CAPACITIVE from MikroElektronika (5" display board with capacitive touch).
|
|
o Easy access to the MCU input/output through Arduino R3-compatible I/O
|
|
connectors to connect external add-on boards.
|
|
o Flexible power supply option—OpenSDA v2.2 USB, Kinetis K28 USB, or an
|
|
external source.
|
|
o FXOS8700CQ—6-axis sensor with accelerometer and magnetometer.
|
|
o RGB LED.
|
|
o Two mechanical push-buttons for user input and one for the reset.
|
|
o Programmable OpenSDA v2.2 debug circuit supporting the DAP-Link interface
|
|
software which provides:
|
|
|
|
- Mass-Storage Device (MSD) flash programming interface.
|
|
- CMSIS-DAP debug interface over a driverless USB HID connection providing
|
|
run-control debugging and compatibility with the IDE tools.
|
|
- Virtual serial port interface.
|
|
- Open-source CMSIS-DAP software project.
|
|
|
|
Contents
|
|
========
|
|
|
|
o STATUS
|
|
o Serial Console
|
|
o LEDs and Buttons
|
|
o Configurations
|
|
|
|
STATUS
|
|
======
|
|
|
|
2018-05-05: The basic NSH port appears to be fully functional. I do see
|
|
one anomaly: There is a significant, long start up delay. This delay
|
|
seems to be variable from immediate to several seconds. I have not
|
|
studied the cause, but there are the symptoms:
|
|
|
|
This debug on, I see this output after a reset:
|
|
|
|
__start: Reset status: 00:00
|
|
|
|
NuttShell (NSH) NuttX-7.24
|
|
nsh> help
|
|
help usage: help [-v] [<cmd>]
|
|
|
|
[ cmp false mkdir rm true
|
|
? dirname free mh rmdir uname
|
|
basename dd help mount set umount
|
|
break df hexdump mv source unset
|
|
cat echo kill mw sleep usleep
|
|
cd exec ls ps test xd
|
|
cp exit mb pwd time
|
|
|
|
Builtin Apps:
|
|
nsh>
|
|
|
|
The delay occurs between the reset and the __start debug output. __start
|
|
is the reset handler so this is very early in the logic. On a reset, it
|
|
vectors to __start. That particular debug message is output after most
|
|
low-level initialization has occurred. So the delay is something within
|
|
the initialization sequence at the beginning of __start. My suspicion is
|
|
the delays associated with the clock configuration.
|
|
|
|
Serial Console
|
|
==============
|
|
|
|
----- --------------- -------------------------------
|
|
GPIO LPUART FUNCTION BOARD CONFIGURATION
|
|
----- --------------- -------------------------------
|
|
PTA1 LPUART0_RX PTA1 GPIO0
|
|
PTA15 LPUART0_RX PTA15 FXIO0_D21
|
|
PTB14 LPUART0_RX PTB14
|
|
PTB16 LPUART0_RX PTB16 SDRAM_D17
|
|
PTC25 LPUART0_RX PTC25 LPUART0_RX_TGTMCU
|
|
PTD6 LPUART0_RX PTD6 Arduino_D17_ADC0_SE7b
|
|
PTA2 LPUART0_TX PTA2 INT
|
|
PTA14 LPUART0_TX PTA14 FXIO0_D20
|
|
PTB15 LPUART0_TX N/C
|
|
PTB17 LPUART0_TX PTB17 SDRAM_D16
|
|
PTC24 LPUART0_TX PTC24 LPUART0_TX_TGTMCU
|
|
PTD7 LPUART0_TX PTD7 SDRAM_CKE
|
|
PTA3 LPUART0_RTS PTA3
|
|
PTA17 LPUART0_RTS PTA17 FXIO0_D23
|
|
PTB2 LPUART0_RTS PTB2 Arduino_D19_ADC0_SE12/I2C0_SCL/SDRAM_WE
|
|
PTB12 LPUART0_RTS PTB12 Arduino_D5_FTM1_CH0/FTM0_CH4
|
|
PTC27 LPUART0_RTS PTC27 FXOS8700CQ_RESET
|
|
PTD4 LPUART0_RTS PTD4 SDRAM_A10
|
|
PTA0 LPUART0_CTS PTA0 K28F_SWD_CLK
|
|
PTA16 LPUART0_CTS PTA16 FXIO0_D22
|
|
PTB3 LPUART0_CTS PTB3 Arduino_D18_ADC0_SE13/I2C0_SDA/SDRAM_CS0
|
|
PTB13 LPUART0_CTS PTB13 Arduino_D6_FTM1_CH1/FTM0_CH5
|
|
PTC26 LPUART0_CTS PTC26 FXOS8700CQ_INT
|
|
PTD5 LPUART0_CTS PTD5 SDRAM_A9
|
|
----- --------------- -------------------------------
|
|
PTD8 LPUART1_RX PTD8 FXIO0_D24
|
|
PTC3 LPUART1_RX PTC3 CLKOUT
|
|
PTE1 LPUART1_RX PTE1 QSPIA0_SCLK
|
|
PTC4 LPUART1_TX PTC4 SDRAM_A19
|
|
PTD9 LPUART1_TX PTD9 FXIO0_D25
|
|
PTE0 LPUART1_TX PTE0 QSPIA0_DATA3
|
|
PTD10 LPUART1_RTS PTD10 FXIO0_D26
|
|
PTC1 LPUART1_RTS PTC1 SDRAM_A21
|
|
PTE3 LPUART1_RTS PTE3 QSPIA0_DATA2
|
|
PTC2 LPUART1_CTS PTC1 SDRAM_A21
|
|
PTD11 LPUART1_CTS PTD11 FXIO0_D27
|
|
PTE2 LPUART1_CTS PTE2 QSPIA0_DATA0
|
|
----- --------------- -------------------------------
|
|
PTA25 LPUART2_RX PTA25 SDHC0_D0/Arduino_D0_LPUART2_RX
|
|
PTD2 LPUART2_RX PTD2 SDRAM_A12
|
|
PTE13 LPUART2_RX N/C
|
|
PTE17 LPUART2_RX N/C
|
|
PTA24 LPUART2_TX PTA24 SDHC0_D1/Arduino_D1_LPUART2_TX
|
|
PTD3 LPUART2_TX PTD3 SDRAM_A11
|
|
PTE12 LPUART2_TX PTE12 I2S0_TX_BCLK
|
|
PTE16 LPUART2_TX N/C
|
|
PTD0 LPUART2_RTS PTD0 Button_LLWU_P12
|
|
PTA27 LPUART2_RTS PTA27 SDHC0_CMD
|
|
PTE19 LPUART2_RTS N/C
|
|
PTA26 LPUART2_CTS PTA26 SDHC0_DCLK
|
|
PTD1 LPUART2_CTS PTD1 Arduino_D16_ADC0_SE5b
|
|
PTE18 LPUART2_CTS N/C
|
|
----- --------------- -------------------------------
|
|
PTA29 LPUART3_RX PTA29 SDHC0_D2
|
|
PTB10 LPUART3_RX PTB10 SDRAM_D19
|
|
PTC16 LPUART3_RX PTC16 SDRAM_DQM2
|
|
PTE5 LPUART3_RX PTE5 QSPIA0_SS0/USB0_SOF_OUT
|
|
PTA28 LPUART3_TX PTA28 SDHC0_D3
|
|
PTB11 LPUART3_TX PTB11 SDRAM_D18
|
|
PTC17 LPUART3_TX PTC17 SDRAM_DQM3
|
|
PTE4 LPUART3_TX PTE4 QSPIA0_DATA1
|
|
PTB8 LPUART3_RTS PTB8 SDRAM_D21
|
|
PTA31 LPUART3_RTS PTA31
|
|
PTC18 LPUART3_RTS PTC18 Arduino_D7
|
|
PTE7 LPUART3_RTS PTE7 I2S0_RXD0/LEDRGB_GREEN
|
|
PTA30 LPUART3_CTS PTA30
|
|
PTB9 LPUART3_CTS PTB9 SDRAM_D20
|
|
PTC19 LPUART3_CTS PTC19 Arduino_D8
|
|
PTE6 LPUART3_CTS PTE6 I2S0_MCK/LEDRGB_RED
|
|
----- --------------- -------------------------------
|
|
PTA21 LPUART4_RX PTA21 TE/FXIO0_D9
|
|
PTC14 LPUART4_RX PTC14 SDRAM_D25
|
|
PTE21 LPUART4_RX N/C
|
|
PTA20 LPUART4_TX PTA20 RD/FXIO0_D8
|
|
PTC15 LPUART4_TX PTC15 SDRAM_D24
|
|
PTE20 LPUART4_TX N/C
|
|
PTA23 LPUART4_RTS PTA23 WR/FXIO0_D7
|
|
PTC12 LPUART4_RTS PTC12 SDRAM_D27
|
|
PTE23 LPUART4_RTS N/C
|
|
PTA22 LPUART4_CTS PTA22 CS/FXIO0_D6
|
|
PTC13 LPUART4_CTS PTC13 SDRAM_D26
|
|
PTE22 LPUART4_CTS N/C
|
|
----- --------------- -------------------------------
|
|
|
|
Arduino RS-232 Shield
|
|
---------------------
|
|
|
|
----- --------------- -------------------------------
|
|
GPIO LPUART FUNCTION BOARD CONFIGURATION
|
|
----- --------------- -------------------------------
|
|
PTA25 LPUART2_RX PTA25 SDHC0_D0/Arduino_D0_LPUART2_RX
|
|
PTA24 LPUART2_TX PTA24 SDHC0_D1/Arduino_D1_LPUART2_TX
|
|
----- --------------- -------------------------------
|
|
|
|
Note: PTA24 and PTA25 are shared between Micro SD Card circuit and
|
|
Arduino connectors. Remove R106 and R107 or R94 and R11 as necessary to
|
|
prevent contention.
|
|
|
|
Virtual serial port
|
|
-------------------
|
|
|
|
A serial port connection is available between the OpenSDA v2.2 MCU and
|
|
pins PTC24 and PTC25 of the K28 MCU:
|
|
|
|
----- --------------- -------------------------------
|
|
GPIO LPUART FUNCTION BOARD CONFIGURATION
|
|
----- --------------- -------------------------------
|
|
PTC25 LPUART0_RX PTC25 LPUART0_RX_TGTMCU
|
|
PTC24 LPUART0_TX PTC24 LPUART0_TX_TGTMCU
|
|
----- --------------- -------------------------------
|
|
|
|
Default Console
|
|
---------------
|
|
|
|
Unless otherwise noted, LPUART0 (the virtual serial port) is the console
|
|
used in all Freedom-K28F configurations.
|
|
|
|
RGB LED
|
|
-------
|
|
An RGB LED is connected through GPIO as shown below:
|
|
|
|
LED K28
|
|
------ -------------------------------------------------------
|
|
RED PTE6
|
|
GREEN PTE7
|
|
BLUE PTE8
|
|
|
|
If CONFIG_ARCH_LEDs is defined, then NuttX will control the LED on board
|
|
the Freedom K28. Usage of these LEDs is defined in include/board.h and
|
|
src/k28_leds.c. The following definitions describe how NuttX controls the
|
|
LEDs:
|
|
|
|
SYMBOL Meaning LED state
|
|
RED GREEN BLUE
|
|
------------------- ----------------------- -----------------
|
|
LED_STARTED NuttX has been started OFF OFF OFF
|
|
LED_HEAPALLOCATE Heap has been allocated OFF OFF ON
|
|
LED_IRQSENABLED Interrupts enabled OFF OFF ON
|
|
LED_STACKCREATED Idle stack created OFF ON OFF
|
|
LED_INIRQ In an interrupt (no change)
|
|
LED_SIGNAL In a signal handler (no change)
|
|
LED_ASSERTION An assertion failed (no change)
|
|
LED_PANIC The system has crashed FLASH OFF OFF
|
|
LED_IDLE K28 is in sleep mode (Optional, not used)
|
|
|
|
Buttons
|
|
-------
|
|
Two push button switches, SW2 and SW3, are available on the FRDM-K28F
|
|
board. SW2 is connected to PTA4 and SW3 is connected to PTD0.
|
|
Beside the general purpose IO function, both SW2 and SW3 can be used
|
|
as a low-leakage wakeup (LLWU) source.
|
|
|
|
Switch GPIO Function
|
|
--------- ---------------------------------------------------------------
|
|
SW2 PTA4/NMI_B
|
|
SW3 PTD0/LLWU_P12
|