boards/nxp/lpcxpresso55s36/doc/index.rst
.. zephyr:board:: lpcxpresso55s36
Overview
The LPCXpresso55S36 board provides the ideal platform for evaluation of the LPC55S3x/LPC553x MCU family, based on the Arm® Cortex®-M33 architecture. Arduino® UNO compatible shield connectors are included, with additional expansion ports around the Arduino footprint, along with a PMod/host interface port and MikroElektronika Click module site.
Hardware
For more information about the LPC55S36 SoC and LPCXPresso55S36 board, see:
LPC55S36 SoC Website_LPC55S36 Datasheet_LPC55S36 User Manual_LPCXpresso55S36 Website_LPCXpresso55S36 User Manual_LPCXpresso55S36 Development Board Design Files_NXP considers the LPCXpresso55S36 as a superset board for the LPC55(S)3x
family of MCUs. This board is a focus for NXP's Full Platform Support for
Zephyr, to better enable the entire LPC55(S)3x family. NXP prioritizes enabling
this board with new support for Zephyr features. Another similar superset
board is the :zephyr:board:lpcxpresso55s69, and that board may have additional features
already supported, which can also be re-used on this lpcxpresso55s36 board.
.. zephyr:board-supported-hw::
The LPC55S36 SoC has IOCON registers, which can be used to configure the functionality of a pin.
+---------+-----------------+----------------------------+ | Name | Function | Usage | +=========+=================+============================+ | PIO0_17 | GPIO | USR SW3 | +---------+-----------------+----------------------------+ | PIO0_22 | GPIO | GREEN LED | +---------+-----------------+----------------------------+ | PIO0_28 | GPIO | RED LED | +---------+-----------------+----------------------------+ | PIO0_29 | USART | USART RX | +---------+-----------------+----------------------------+ | PIO0_30 | USART | USART TX | +---------+-----------------+----------------------------+ | PIO1_11 | GPIO | BLUE_LED | +---------+-----------------+----------------------------+ | PIO1_18 | GPIO | Wakeup SW1 | +---------+-----------------+----------------------------+ | PIO1_20 | FLEXPPWM0_PWM0_A| pwm | +---------+-----------------+----------------------------+ | PIO1_17 | FLEXPPWM0_PWM0_B| pwm | +---------+-----------------+----------------------------+ | PIO1_6 | FLEXPPWM0_PWM1_A| pwm | +---------+-----------------+----------------------------+ | PIO1_22 | FLEXPPWM0_PWM1_B| pwm | +---------+-----------------+----------------------------+ | PIO1_8 | FLEXPPWM0_PWM2_A| pwm | +---------+-----------------+----------------------------+ | PIO1_4 | FLEXPPWM0_PWM2_B| pwm | +---------+-----------------+----------------------------+ | PIO1_21 | FLEXPPWM1_PWM0_A| pwm | +---------+-----------------+----------------------------+ | PIO0_3 | FLEXPPWM1_PWM0_B| pwm | +---------+-----------------+----------------------------+ | PIO1_23 | FLEXPPWM1_PWM1_A| pwm | +---------+-----------------+----------------------------+ | PIO0_21 | FLEXPPWM1_PWM1_B| pwm | +---------+-----------------+----------------------------+ | PIO1_25 | FLEXPPWM1_PWM2_A| pwm | +---------+-----------------+----------------------------+ | PIO0_31 | FLEXPPWM1_PWM2_B| pwm | +---------+-----------------+----------------------------+ | PIO1_2 | CAN0_TXD | CAN TX | +---------+-----------------+----------------------------+ | PIO1_3 | CAN0_RXD | CAN RX | +---------+-----------------+----------------------------+ | PIO0_22 | USB0_VBUS | USBFS VBUS | +---------+-----------------+----------------------------+
The LPC55S36 SoC is configured to use PLL1 clocked from the external 24MHz crystal, running at 144MHz as a source for the system clock. When the flash controller is enabled, the core clock will be reduced to 96MHz. Other sources for the system clock are provided in the SOC, depending on your system requirements.
The LPC55S36 SoC has 8 FLEXCOMM interfaces for serial communication. One is configured as USART for the console and the remaining are not used.
Programming and Debugging
.. zephyr:board-supported-runners::
Build and flash applications as usual (see :ref:build_an_application
and :ref:application_run for more details).
LinkServer is the default runner for this board.
A debug probe is used for both flashing and debugging the board. This board is
configured by default to use the integrated :ref:mcu-link-onboard-debug-probe
in the CMSIS-DAP mode. To use this probe with Zephyr, you need to install the
:ref:linkserver-debug-host-tools and make sure they are in your search path.
Refer to the detailed overview about :ref:application_debugging for additional
information.
The integrated MCU-Link hardware can also be used as a J-Link probe with a
firmware update, as described in :ref:mcu-link-jlink-onboard-debug-probe.
The :ref:jlink-debug-host-tools should be available in this case.
Connect a USB cable from your PC to J1 (LINK2), and use the serial terminal of your choice (minicom, putty, etc.) with the following settings:
Here is an example for the :zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: lpcxpresso55s36 :goals: flash
Open a serial terminal, reset the board (press the RESET button), and you should see the following message in the terminal:
.. code-block:: console
***** Booting Zephyr OS v2.2.0 ***** Hello World! lpcxpresso55s36
Here is an example for the :zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: lpcxpresso55s36 :goals: debug
Open a serial terminal, step through the application in your debugger, and you should see the following message in the terminal:
.. code-block:: console
***** Booting Zephyr OS zephyr-v2.2.0 ***** Hello World! lpcxpresso55s36
.. include:: ../../common/board-footer.rst.inc
.. _LPC55S36 SoC Website: https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/lpc5500-cortex-m33/lpc553x-s3x-advanced-analog-armcortex-m33-based-mcu-family:LPC553x
.. _LPC55S36 Datasheet: https://www.nxp.com/docs/en/data-sheet/LPC553x.pdf
.. _LPC55S36 User Manual: https://www.nxp.com/docs/en/reference-manual/LPC553xRM.pdf
.. _LPCxpresso55S36 Website: https://www.nxp.com/design/development-boards/lpcxpresso-boards/development-board-for-the-lpc553x-family-of-mcus:LPCXpresso55S36
.. _LPCXpresso55S36 User Manual: https://www.nxp.com/docs/en/user-manual/LPCXpresso55S36UM.pdf
.. _LPCXpresso55S36 Development Board Design Files: https://www.nxp.com/webapp/Download?colCode=LPCXPRESSO5536_EVK-DESIGN-FILES