boards/nxp/s32k148_evb/doc/index.rst
.. zephyr:board:: s32k148_evb
Overview
NXP S32K148-Q176_ is a low-cost evaluation and development board for general-purpose industrial
and automotive applications.
The S32K148-Q176 is based on the 32-bit Arm Cortex-M4F NXP S32K148_ microcontroller.
The onboard OpenSDA serial and debug adapter, running a mass storage device (MSD) bootloader
and a collection of OpenSDA Applications, offers options for serial communication,
flash programming, and run-control debugging.
It is a bridge between a USB host and the embedded target processor.
Hardware
NXP S32K148
Interfaces
More information about the hardware and design resources can be found at
NXP S32K148-Q176_ website.
.. zephyr:board-supported-hw::
.. note:: Before using the Ethernet interface, please take note of the following:
LSF24D at U16, R553 needs to be depopulated.This board has 5 GPIO ports named from gpioa to gpioe.
Pin control can be further configured from your application overlay by adding
children nodes with the desired pinmux configuration to the singleton node
pinctrl. Supported properties are described in
:zephyr_file:dts/bindings/pinctrl/nxp,port-pinctrl.yaml.
The NXP S32K148-Q176 board has one user RGB LED that can be used either as a GPIO LED or as a PWM LED.
.. table:: RGB LED as GPIO LED
+-----------------+------------------+----------------+-------+
| Devicetree node | Devicetree alias | Label | Pin |
+=================+==================+================+=======+
| led1_red | led0 | LED1_RGB_RED | PTE21 |
+-----------------+------------------+----------------+-------+
| led1_green | led1 | LED1_RGB_GREEN | PTE22 |
+-----------------+------------------+----------------+-------+
| led1_blue | led2 | LED1_RGB_BLUE | PTE23 |
+-----------------+------------------+----------------+-------+
.. table:: RGB LED as PWM LED
+-----------------+--------------------------+--------------------+------------------+
| Devicetree node | Devicetree alias | Label | Pin |
+=================+==========================+====================+==================+
| led1_red_pwm | pwm-led0 / red-pwm-led | LED1_RGB_RED_PWM | PTE21 / FTM4_CH1 |
+-----------------+--------------------------+--------------------+------------------+
| led1_green_pwm | pwm-led1 / green-pwm-led | LED1_RGB_GREEN_PWM | PTE22 / FTM4_CH2 |
+-----------------+--------------------------+--------------------+------------------+
| led1_blue_pwm | pwm-led2 / blue-pwm-led | LED1_RGB_BLUE_PWM | PTE23 / FTM4_CH3 |
+-----------------+--------------------------+--------------------+------------------+
The user can control the LEDs in any way. An output of 0 illuminates the LED.
The NXP S32K148-Q176 board has two user buttons:
+-----------------+-------+-------+ | Devicetree node | Label | Pin | +=================+=======+=======+ | sw0 / button_3 | SW3 | PTC12 | +-----------------+-------+-------+ | sw1 / button_4 | SW4 | PTC13 | +-----------------+-------+-------+
The serial console is provided via lpuart1 on the OpenSDA adapter.
+------+--------------+ | Pin | Pin Function | +======+==============+ | PTC7 | LPUART1_TX | +------+--------------+ | PTC6 | LPUART1_RX | +------+--------------+
The Arm Cortex-M4F core is configured to run at 80 MHz (RUN mode).
Programming and Debugging
.. zephyr:board-supported-runners::
Applications for the s32k148_evb board can be built in the usual way as
documented in :ref:build_an_application.
This board configuration supports SEGGER J-Link_ West runner for flashing and
debugging applications. Follow the steps described in :ref:jlink-debug-host-tools,
to setup the flash and debug host tools for this runner.
Run the west flash command to flash the application using SEGGER J-Link.
Run the west debug command to start a GDB session using SEGGER J-Link.
We will use OpenSDA as a USB-to-serial adapter for the serial console.
Use the following settings with your serial terminal of choice (minicom, putty, etc.):
.. include:: ../../common/board-footer.rst.inc
References
.. target-notes::
.. _NXP S32K148-Q176: https://www.nxp.com/design/design-center/development-boards-and-designs/automotive-development-platforms/s32k-mcu-platforms/s32k148-q176-evaluation-board-for-automotive-general-purpose:S32K148EVB
.. _SEGGER J-Link: https://wiki.segger.com/S32Kxxx