boards: arm: add LPCXpresso55S16 board definition (e7da82ce) · Commits · Wenxi XU / zephyr

boards/arm/lpcxpresso55s16/CMakeLists.txt

0 → 100644

+11 −0

Original line number	Diff line number	Diff line
		#
		# Copyright (c) 2020 Henrik Brix Andersen <henrik@brixandersen.dk>
		#
		# SPDX-License-Identifier: Apache-2.0
		#

		if(CONFIG_PINMUX_MCUX_LPC)
		zephyr_library()
		zephyr_library_include_directories(${ZEPHYR_BASE}/drivers)
		zephyr_library_sources(pinmux.c)
		endif()

boards/arm/lpcxpresso55s16/Kconfig.board

0 → 100644

+9 −0

Original line number	Diff line number	Diff line
		# LPCXpresso55S16 board

		# Copyright (c) 2020 Henrik Brix Andersen <henrik@brixandersen.dk>
		# SPDX-License-Identifier: Apache-2.0

		config BOARD_LPCXPRESSO55S16
		bool "NXP LPCXPRESSO-55S16"
		depends on SOC_SERIES_LPC55XXX
		select SOC_PART_NUMBER_LPC55S16JBD100

boards/arm/lpcxpresso55s16/Kconfig.defconfig

0 → 100644

+31 −0

Original line number	Diff line number	Diff line
		# LPCXpresso55S16 board

		# Copyright (c) 2020 Henrik Brix Andersen <henrik@brixandersen.dk>
		# SPDX-License-Identifier: Apache-2.0

		if BOARD_LPCXPRESSO55S16

		config BOARD
		default "lpcxpresso55S16"

		if PINMUX_MCUX_LPC

		config PINMUX_MCUX_LPC_PORT0
		default y

		config PINMUX_MCUX_LPC_PORT1
		default y

		endif # PINMUX_MCUX_LPC

		if GPIO_MCUX_LPC

		config GPIO_MCUX_LPC_PORT0
		default y

		config GPIO_MCUX_LPC_PORT1
		default y

		endif # GPIO_MCUX_LPC

		endif # BOARD_LPCXPRESSO55S16

boards/arm/lpcxpresso55s16/board.cmake

0 → 100644

+12 −0

Original line number	Diff line number	Diff line
		#
		# Copyright (c) 2020 Henrik Brix Andersen <henrik@brixandersen.dk>
		#
		# SPDX-License-Identifier: Apache-2.0
		#

		board_set_debugger_ifnset(jlink)
		board_set_flasher_ifnset(jlink)

		board_runner_args(jlink "--device=LPC55S16")

		include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)

boards/arm/lpcxpresso55s16/doc/index.rst

0 → 100644

+202 −0

Original line number	Diff line number	Diff line
		.. _lpcxpresso55s16:

		NXP LPCXpresso55S16
		###################

		Overview
		********

		The LPCXpresso55S16 board provides the ideal platform for evaluation
		of the LPC55S1x/LPC551x 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.

		.. image:: ./lpcxpresso55S16.jpg
		:width: 720px
		:align: center
		:alt: LPCXpresso55S16

		Hardware
		********

		- LPC55S16 Arm® Cortex®-M33 microcontroller running at up to 150 MHz
		- 256 KB flash and 96 KB SRAM on-chip
		- LPC-Link2 debug high speed USB probe with VCOM port
		- I2C and SPI USB bridging to the LPC device via LPC-Link2 probe
		- MikroElektronika Click expansion option
		- LPCXpresso expansion connectors compatible with Arduino UNO
		- PMod compatible expansion / host connector
		- Reset, ISP, wake, and user buttons for easy testing of software functionality
		- Tri-color LED
		- Full-speed USB device / host port
		- High-speed USB device / host port
		- UART header for external serial to USB cable
		- CAN Transceiver
		- Stereo audio codec with in/out line
		- NXP FXOS8700CQ accelerometer

		For more information about the LPC55S16 SoC and LPCXPresso55S16 board, see:

		- `LPC55S16 SoC Website`_
		- `LPC55S16 Datasheet`_
		- `LPC55S16 User Manual`_
		- `LPCXpresso55S16 Website`_
		- `LPCXpresso55S16 User Manual`_
		- `LPCXpresso55S16 Development Board Design Files`_

		Supported Features
		==================

		The lpcxpresso55s16 board configuration supports the following
		hardware features:

		+-----------+------------+-------------------------------------+
		\| Interface \| Controller \| Driver/Component \|
		+===========+============+=====================================+
		\| NVIC \| on-chip \| nested vector interrupt controller \|
		+-----------+------------+-------------------------------------+
		\| SYSTICK \| on-chip \| systick \|
		+-----------+------------+-------------------------------------+
		\| IOCON \| on-chip \| pinmux \|
		+-----------+------------+-------------------------------------+
		\| GPIO \| on-chip \| gpio \|
		+-----------+------------+-------------------------------------+
		\| USART \| on-chip \| serial port \|
		+-----------+------------+-------------------------------------+

		Other hardware features are not currently enabled.

		Currently available targets for this board are:

		- lpcxpresso55s16_ns non-secure (NS) address space

		Connections and IOs
		===================

		The LPC55S16 SoC has IOCON registers, which can be used to configure
		the functionality of a pin.

		+---------+-----------------+----------------------------+
		\| Name \| Function \| Usage \|
		+=========+=================+============================+
		\| PIO0_5 \| GPIO \| ISP SW4 \|
		+---------+-----------------+----------------------------+
		\| PIO0_29 \| USART \| USART RX \|
		+---------+-----------------+----------------------------+
		\| PIO0_30 \| USART \| USART TX \|
		+---------+-----------------+----------------------------+
		\| PIO1_4 \| GPIO \| RED LED \|
		+---------+-----------------+----------------------------+
		\| PIO1_6 \| GPIO \| BLUE_LED \|
		+---------+-----------------+----------------------------+
		\| PIO1_7 \| GPIO \| GREEN LED \|
		+---------+-----------------+----------------------------+
		\| PIO1_9 \| GPIO \| USR SW3 \|
		+---------+-----------------+----------------------------+
		\| PIO1_18 \| GPIO \| Wakeup SW1 \|
		+---------+-----------------+----------------------------+

		System Clock
		============

		The LPC55S16 SoC is configured to use the internal FRO at 96MHz as a
		source for the system clock. Other sources for the system clock are
		provided in the SOC, depending on your system requirements.

		Serial Port
		===========

		The LPC55S16 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
		*************************

		Build and flash applications as usual (see :ref:`build_an_application`
		and :ref:`application_run` for more details).

		Configuring a Debug Probe
		=========================

		A debug probe is used for both flashing and debugging the board. This
		board is configured by default to use the LPC-Link2 CMSIS-DAP Onboard
		Debug Probe, however the :ref:`pyocd-debug-host-tools` does not yet
		support the LPC55S16 so you must reconfigure the board for one of the
		J-Link debug probe instead.

		First install the :ref:`jlink-debug-host-tools` and make sure they are
		in your search path.

		Then follow the instructions in
		:ref:`lpclink2-jlink-onboard-debug-probe` to program the J-Link
		firmware. Please make sure you have the latest firmware for this
		board.

		Configuring a Console
		=====================

		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:

		- Speed: 115200
		- Data: 8 bits
		- Parity: None
		- Stop bits: 1

		Flashing
		========

		Here is an example for the :ref:`hello_world` application.

		.. zephyr-app-commands::
		:zephyr-app: samples/hello_world
		:board: lpcxpresso55s16_ns
		: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! lpcxpresso55s16_ns

		Debugging
		=========

		Here is an example for the :ref:`hello_world` application.

		.. zephyr-app-commands::
		:zephyr-app: samples/hello_world
		:board: lpcxpresso55s16
		: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! lpcxpresso55s16

		.. _LPC55S16 SoC Website:
		https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/lpc5500-cortex-m33/lpc551x-s1x-baseline-arm-cortex-m33-based-microcontroller-family:LPC551X-S1X

		.. _LPC55S16 Datasheet:
		https://www.nxp.com/docs/en/nxp/data-sheets/LPC55S1x_PDS.pdf

		.. _LPC55S16 User Manual:
		https://www.nxp.com/docs/en/nxp/user-guides/UM11295.pdf

		.. _LPCxpresso55S16 Website:
		https://www.nxp.com/design/development-boards/lpcxpresso-boards/lpcxpresso55s16-development-board:LPC55S16-EVK

		.. _LPCXpresso55S16 User Manual:
		https://www.nxp.com/docs/en/user-guide/UMLPCXPRESSO55S16.pdf

		.. _LPCXpresso55S16 Development Board Design Files:
		https://www.nxp.com/downloads/en/design-support/LPCXPRESSSO55S16-DESIGN-FILES.zip

Admin message