202 lines
7.3 KiB
ReStructuredText
202 lines
7.3 KiB
ReStructuredText
.. _frdm_kl25z:
|
|
|
|
NXP FRDM-KL25Z
|
|
##############
|
|
|
|
Overview
|
|
********
|
|
|
|
The Freedom KL25Z is an ultra-low-cost development platform for
|
|
Kinetis |reg| L Series KL1x (KL14/15) and KL2x (KL24/25) MCUs built
|
|
on ARM |reg| Cortex |reg|-M0+ processor.
|
|
|
|
The FRDM-KL25Z features include easy access to MCU I/O, battery-ready,
|
|
low-power operation, a standard-based form factor with expansion board
|
|
options and a built-in debug interface for flash programming and run-control.
|
|
|
|
|
|
.. image:: frdm_kl25z.jpg
|
|
:width: 272px
|
|
:align: center
|
|
:alt: FRDM-KL25Z
|
|
|
|
Hardware
|
|
********
|
|
|
|
- MKL25Z128VLK4 MCU @ 48 MHz, 128 KB flash, 16 KB SRAM, USB OTG (FS), 80LQFP
|
|
- On board capacitive touch "slider", MMA8451Q accelerometer, and tri-color LED
|
|
- OpenSDA debug interface
|
|
|
|
For more information about the KL25Z SoC and FRDM-KL25Z board:
|
|
|
|
- `KL25Z Website`_
|
|
- `KL25Z Datasheet`_
|
|
- `KL25Z Reference Manual`_
|
|
- `FRDM-KL25Z Website`_
|
|
- `FRDM-KL25Z User Guide`_
|
|
- `FRDM-KL25Z Schematics`_
|
|
|
|
Supported Features
|
|
==================
|
|
|
|
The frdm_kl25z board configuration supports the following hardware features:
|
|
|
|
+-----------+------------+-------------------------------------+
|
|
| Interface | Controller | Driver/Component |
|
|
+===========+============+=====================================+
|
|
| NVIC | on-chip | nested vector interrupt controller |
|
|
+-----------+------------+-------------------------------------+
|
|
| SYSTICK | on-chip | systick |
|
|
+-----------+------------+-------------------------------------+
|
|
| PINMUX | on-chip | pinmux |
|
|
+-----------+------------+-------------------------------------+
|
|
| GPIO | on-chip | gpio |
|
|
+-----------+------------+-------------------------------------+
|
|
| UART | on-chip | serial port-polling; |
|
|
| | | serial port-interrupt |
|
|
+-----------+------------+-------------------------------------+
|
|
| I2C | on-chip | i2c |
|
|
+-----------+------------+-------------------------------------+
|
|
| SPI | on-chip | spi |
|
|
+-----------+------------+-------------------------------------+
|
|
| ADC | on-chip | adc |
|
|
+-----------+------------+-------------------------------------+
|
|
| FLASH | on-chip | soc flash |
|
|
+-----------+------------+-------------------------------------+
|
|
|
|
The default configuration can be found in the defconfig file:
|
|
|
|
``boards/arm/frdm_kl25z/frdm_kl25z_defconfig``
|
|
|
|
Other hardware features are not currently supported by the port.
|
|
|
|
Connections and IOs
|
|
===================
|
|
|
|
The KL25Z SoC has five pairs of pinmux/gpio controllers, and all are currently enabled
|
|
(PORTA/GPIOA, PORTB/GPIOB, PORTC/GPIOC, PORTD/GPIOD, and PORTE/GPIOE) for the FRDM-KL25Z board.
|
|
|
|
+-------+-------------+---------------------------+
|
|
| Name | Function | Usage |
|
|
+=======+=============+===========================+
|
|
| PTB2 | ADC | ADC0 channel 12 |
|
|
+-------+-------------+---------------------------+
|
|
| PTB18 | GPIO | Red LED |
|
|
+-------+-------------+---------------------------+
|
|
| PTB19 | GPIO | Green LED |
|
|
+-------+-------------+---------------------------+
|
|
| PTD1 | GPIO | Blue LED |
|
|
+-------+-------------+---------------------------+
|
|
| PTA1 | UART0_RX | UART Console |
|
|
+-------+-------------+---------------------------+
|
|
| PTA2 | UART0_TX | UART Console |
|
|
+-------+-------------+---------------------------+
|
|
| PTE24 | I2C0_SCL | I2C |
|
|
+-------+-------------+---------------------------+
|
|
| PTE25 | I2C0_SDA | I2C |
|
|
+-------+-------------+---------------------------+
|
|
| PTC4 | SPI0_PSC0 | SPI |
|
|
+-------+-------------+---------------------------+
|
|
| PTC5 | SPI0_SCK | SPI |
|
|
+-------+-------------+---------------------------+
|
|
| PTC6 | SPI0_MOSI | SPI |
|
|
+-------+-------------+---------------------------+
|
|
| PTC7 | SPI0_MISO | SPI |
|
|
+-------+-------------+---------------------------+
|
|
|
|
|
|
System Clock
|
|
============
|
|
|
|
The KL25Z SoC is configured to use the 8 MHz external oscillator on the board
|
|
with the on-chip FLL to generate a 48 MHz system clock.
|
|
|
|
Serial Port
|
|
===========
|
|
|
|
The KL25Z UART0 is used for the console.
|
|
|
|
Programming and Debugging
|
|
*************************
|
|
|
|
The FRDM-KL25Z includes the :ref:`nxp_opensda` serial and debug adapter built
|
|
into the board to provide debugging, flash programming, and serial
|
|
communication over USB.
|
|
|
|
To use the pyOCD tools with OpenSDA, follow the instructions in the
|
|
:ref:`nxp_opensda_pyocd` page using the `DAPLink FRDM-KL25Z Firmware`_. The
|
|
pyOCD tools are the default for this board, therefore it is not necessary to
|
|
set ``OPENSDA_FW=daplink`` explicitly when programming and debugging.
|
|
|
|
With these mechanisms, applications for the ``frdm_kl25z`` board
|
|
configuration can be built and flashed in the usual way (see
|
|
:ref:`build_an_application` and :ref:`application_run` for more
|
|
details).
|
|
|
|
To use the Segger J-Link tools with OpenSDA, follow the instructions
|
|
in the :ref:`nxp_opensda_jlink` page using the `Segger J-Link OpenSDA
|
|
V2.1 Firmware`_. The Segger J-Link tools are not the default for this
|
|
board, therefore it is necessary to set ``OPENSDA_FW=jlink``
|
|
explicitly in the environment before programming and debugging.
|
|
|
|
Flashing
|
|
========
|
|
|
|
This example uses the :ref:`hello_world` sample with the
|
|
:ref:`nxp_opensda_pyocd` tools.
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/hello_world
|
|
:board: frdm_kl25z
|
|
:goals: flash
|
|
|
|
Open a serial terminal (minicom, putty, etc.) with the following settings:
|
|
|
|
- Speed: 115200
|
|
- Data: 8 bits
|
|
- Parity: None
|
|
- Stop bits: 1
|
|
|
|
Reset the board and you should be able to see on the corresponding Serial Port
|
|
the following message:
|
|
|
|
.. code-block:: console
|
|
|
|
Hello World! arm
|
|
|
|
Debugging
|
|
=========
|
|
|
|
You can debug an application in the usual way. Here is an example for the
|
|
:ref:`hello_world` application.
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/hello_world
|
|
:board: frdm_kl25z
|
|
:maybe-skip-config:
|
|
:goals: debug
|
|
|
|
.. _FRDM-KL25Z Website:
|
|
http://www.nxp.com/products/software-and-tools/hardware-development-tools/freedom-development-boards/freedom-development-platform-for-kinetis-kl14-kl15-kl24-kl25-mcus:FRDM-KL25Z?tid=vanFRDM-KL25Z
|
|
|
|
.. _FRDM-KL25Z User Guide:
|
|
http://www.nxp.com/assets/documents/data/en/user-guides/FRDMKL25ZUM.zip
|
|
|
|
.. _FRDM-KL25Z Schematics:
|
|
http://www.nxp.com/assets/downloads/data/en/schematics/FRDM-KL25Z_SCH_REV_E.pdf
|
|
|
|
.. _KL25Z Website:
|
|
http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/kinetis-cortex-m-mcus/l-series-ultra-low-power-m0-plus/kinetis-kl2x-48-mhz-usb-ultra-low-power-microcontrollers-mcus-based-on-arm-cortex-m0-plus-core:KL2x?lang_cd=en
|
|
|
|
.. _KL25Z Datasheet:
|
|
http://www.nxp.com/assets/documents/data/en/data-sheets/KL25P80M48SF0.pdf
|
|
|
|
.. _KL25Z Reference Manual:
|
|
http://www.nxp.com/assets/documents/data/en/reference-manuals/KL25P80M48SF0RM.pdf
|
|
|
|
.. _DAPLink FRDM-KL25Z Firmware:
|
|
http://www.nxp.com/assets/downloads/data/en/ide-debug-compile-build-tools/OpenSDAv2.2_DAPLink_frdmkl25z_rev0242.zip
|
|
|
|
.. _Segger J-Link OpenSDA V2.1 Firmware:
|
|
https://www.segger.com/downloads/jlink/OpenSDA_V2_1.bin
|