1.. zephyr:board:: frdm_mcxc444
2
3Overview
4********
5
6FRDM-MCXC444 is a compact and scalable development board for rapid
7prototyping of MCX C444 MCU. It offers industry standard headers
8for easy access to the MCU's I/Os, integrated open-standard serial
9interfaces and on-board MCU-Link debugger.
10The MCXC is a general purpose ultra-low-power MCU family,
11providing additional memory, communications and analog peripheral.
12
13Hardware
14********
15
16- MCXC444VLH Arm Cortex-M0+ microcontroller running at 48 MHz
17- 64LQFP package
18- 256 KB flash
19- 32 KB SRAM
20- USB FS 2.0
21- 2x low-power UART, 1x UART, 2x I2C, 2x SPI
22- FXLS8974CF accelerometer
23- Tri-color LED
24- On-board MCU-Link debugger with CMSIS-DAP
25- Arduino Header, mikroBUS, Pmod
26
27For more information about the MCXC444 SoC and FRDM-MCXC444 board, see
28these references:
29
30- `MCX C14x/24x/44x Website`_
31- `MCX C44x Datasheet`_
32- `MCX C44x Reference Manual`_
33- `FRDM-MCXC444 Website`_
34- `FRDM-MCXC444 User Manual`_
35- `FRDM-MCXC444 Design Files`_
36
37Supported Features
38==================
39
40The ``frdm_mcxc444`` board target supports the following hardware features:
41
42+-----------+------------+-------------------------------------+
43| Interface | Controller | Driver/Component                    |
44+===========+============+=====================================+
45| NVIC      | on-chip    | nested vector interrupt controller  |
46+-----------+------------+-------------------------------------+
47| SYSTICK   | on-chip    | systick                             |
48+-----------+------------+-------------------------------------+
49| PINMUX    | on-chip    | pinmux                              |
50+-----------+------------+-------------------------------------+
51| GPIO      | on-chip    | gpio                                |
52+-----------+------------+-------------------------------------+
53| UART      | on-chip    | serial port-polling;                |
54|           |            | serial port-interrupt               |
55+-----------+------------+-------------------------------------+
56| FLASH     | on-chip    | soc flash                           |
57+-----------+------------+-------------------------------------+
58| ADC       | on-chip    | adc                                 |
59+-----------+------------+-------------------------------------+
60| I2C       | on-chip    | i2c                                 |
61+-----------+------------+-------------------------------------+
62| LPTMR     | on-chip    | counter                             |
63+-----------+------------+-------------------------------------+
64| PIT       | on-chip    | counter                             |
65+-----------+------------+-------------------------------------+
66| PWM       | on-chip    | pwm                                 |
67+-----------+------------+-------------------------------------+
68| RTC       | on-chip    | counter                             |
69+-----------+------------+-------------------------------------+
70| USB       | on-chip    | USB device                          |
71+-----------+------------+-------------------------------------+
72
73
74Targets available
75==================
76
77The default configuration can be found in
78:zephyr_file:`boards/nxp/frdm_mcxc444/frdm_mcxc444_defconfig`
79
80Other hardware features are not currently supported by the port.
81
82Connections and IOs
83===================
84
85The MCXC444 SoC has five pairs of pinmux/gpio controllers (PORTA/GPIOA,
86PORTB/GPIOB, PORTC/GPIOC, PORTD/GPIOD, and PORTE/GPIOE) for the FRDM-MCXC444 board.
87
88+-------+-------------+---------------------------+
89| Name  | Function    | Usage                     |
90+=======+=============+===========================+
91| PTE20 | ADC         | ADC0 channel 1            |
92+-------+-------------+---------------------------+
93| PTE31 | GPIO        | Red LED                   |
94+-------+-------------+---------------------------+
95| PTD5  | GPIO        | Green LED                 |
96+-------+-------------+---------------------------+
97| PTE29 | GPIO        | Blue LED                  |
98+-------+-------------+---------------------------+
99| PTA1  | LPUART0_RX  | UART Console              |
100+-------+-------------+---------------------------+
101| PTA2  | LPUART0_TX  | UART Console              |
102+-------+-------------+---------------------------+
103| PTA20 | RESET       | RESET Button SW1          |
104+-------+-------------+---------------------------+
105| PTC3  | GPIO        | User button SW2           |
106+-------+-------------+---------------------------+
107| PTA4  | GPIO        | User button SW3           |
108+-------+-------------+---------------------------+
109| PTE25 | I2C0_SDA    | I2C accelerometer         |
110+-------+-------------+---------------------------+
111| PTE24 | I2C0_SCL    | I2C accelerometer         |
112+-------+-------------+---------------------------+
113
114System Clock
115============
116
117The MCXC444 SoC is configured to use HIRC running at 48 MHz as a system clock source.
118
119Serial Port
120===========
121
122The MCXC444 LPUART0 is used for the console.
123
124Programming and Debugging
125*************************
126
127Build and flash applications as usual (see :ref:`build_an_application` and
128:ref:`application_run` for more details).
129
130Configuring a Debug Probe
131=========================
132
133A debug probe is used for both flashing and debugging the board. This board is
134configured by default to use the MCU-Link CMSIS-DAP Onboard Debug Probe.
135
136Using LinkServer
137----------------
138
139Linkserver is the default runner for this board, and supports the factory
140default MCU-Link firmware. Follow the instructions in
141:ref:`mcu-link-cmsis-onboard-debug-probe` to reprogram the default MCU-Link
142firmware. This only needs to be done if the default onboard debug circuit
143firmware was changed. To put the board in ``DFU mode`` to program the firmware,
144short jumper JP2.
145
146Using J-Link
147------------
148
149There are two options. The onboard debug circuit can be updated with Segger
150J-Link firmware by following the instructions in
151:ref:`mcu-link-jlink-onboard-debug-probe`.
152To be able to program the firmware, you need to put the board in ``DFU mode``
153by shortening the jumper JP1.
154The second option is to attach a :ref:`jlink-external-debug-probe` to the
15510-pin SWD connector (J10) of the board. Additionally, the jumper JP4 must
156be shortened.
157For both options use the ``-r jlink`` option with west to use the jlink runner.
158
159.. code-block:: console
160
161   west flash -r jlink
162
163Configuring a Console
164=====================
165
166Connect a USB cable from your PC to J13, and use the serial terminal of your choice
167(minicom, putty, etc.) with the following settings:
168
169- Speed: 115200
170- Data: 8 bits
171- Parity: None
172- Stop bits: 1
173
174Flashing
175========
176
177Here is an example for the :zephyr:code-sample:`hello_world` application.
178
179.. zephyr-app-commands::
180   :zephyr-app: samples/hello_world
181   :board: frdm_mcxc444
182   :goals: flash
183
184Open a serial terminal, reset the board (press the SW1 button), and you should
185see the following message in the terminal:
186
187.. code-block:: console
188
189   *** Booting Zephyr OS build v3.6.0-4475-gfa5bd8bb098e ***
190   Hello World! frdm_mcxc444/mcxc444
191
192Debugging
193=========
194
195Here is an example for the :zephyr:code-sample:`hello_world` application.
196
197.. zephyr-app-commands::
198   :zephyr-app: samples/hello_world
199   :board: frdm_mcxc444
200   :goals: debug
201
202Open a serial terminal, step through the application in your debugger, and you
203should see the following message in the terminal:
204
205.. code-block:: console
206
207   *** Booting Zephyr OS build v3.6.0-4475-gfa5bd8bb098e ***
208   Hello World! frdm_mcxc444/mcxc444
209
210.. include:: ../../common/board-footer.rst
211   :start-after: nxp-board-footer
212
213.. _MCX C14x/24x/44x Website:
214   https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/mcx-arm-cortex-m/mcx-c-series-microcontrollers/mcx-c14x-24x-44x-mcus-with-arm-cortex-m0-plus-entry-level-mcus-with-usb-segment-lcd-and-classical-peripherals:MCX-C14x-24x-44x
215
216.. _MCX C44x Datasheet:
217   https://www.nxp.com/docs/en/data-sheet/MCXC44XP64M48SF6.pdf
218
219.. _MCX C44x Reference Manual:
220   https://www.nxp.com/webapp/Download?colCode=MCXC44XP64M48RM
221
222.. _FRDM-MCXC444 Website:
223   https://www.nxp.com/design/design-center/development-boards-and-designs/general-purpose-mcus/frdm-development-board-for-mcx-c444-mcus:FRDM-MCXC444
224
225.. _FRDM-MCXC444 User Manual:
226   https://www.nxp.com/webapp/Download?colCode=UM12120
227
228.. _FRDM-MCXC444 Design Files:
229   https://www.nxp.com/webapp/Download?colCode=FRDM-MCXC444-DESIGNFILES
230