1.. zephyr:board:: vmu_rt1170
2
3Overview
4********
5
6The VMU RT1170 features an i.MX RT1176 dual core MCU with the
7Cortex-M7 core at 1 GHz and a Cortex-M4 at 400 MHz.
8The i.MX RT1176 MCU offers support over a wide temperature range
9and is qualified for consumer, industrial and automotive markets.
10The VMU RT1170 is the default VMU for CogniPilot's Cerebri, a
11Zephyr RTOS based Autopilot.
12
13Hardware
14********
15
16- MIMXRT1176DVMAA MCU
17
18  - 1GHz Cortex-M7 & 400Mhz Cortex-M4
19  - 2MB SRAM with 512KB of TCM for Cortex-M7 and 256KB of TCM for Cortex-M4
20
21- Memory
22
23  - 512 Mbit Octal Flash
24  - TF socket for SD card
25
26- Ethernet
27
28  - 2 wire 100BASE-T1
29
30- USB
31
32  - USB 2.0 connector
33
34- Power
35
36  - Redundant dual picoflex power ports
37
38- Debug
39
40  - 10 pin debug and shell adapter board to 20 Pin JTAG debugger and USB-C shell
41
42- Sensor
43
44  - BMI088 6-axis IMU
45  - BMM150 Magnetometer
46  - Dual BMP388 Barometer
47  - Dual ICM-42688 6-axis IMU
48  - IST8310 3-axis Magnetometer
49  - U-blox NEO-M8N GNSS module
50
51- UART JST-GH connectors
52
53- I2C JST-GH connectors
54
55- CAN bus JST-GH connectors
56
57- RC IN
58
59  - RC input connector for SBUS compatible RC receivers
60
61For more information about the MIMXRT1176 SoC and VMU RT1170 board, see
62these references:
63
64- `VMU RT1170 Schematics`_
65- `i.MX RT1170 Datasheet`_
66- `i.MX RT1170 Reference Manual`_
67
68Supported Features
69==================
70
71VMU-RT1170 is a "Vehicle Management Unit" based on the general i.MX RT1170
72family of processors. The VMU RT1170 board configuration supports the
73following hardware features:
74
75+-----------+------------+-------------------------------------+
76| Interface | Controller | Driver/Component                    |
77+===========+============+=====================================+
78| NVIC      | on-chip    | nested vector interrupt controller  |
79+-----------+------------+-------------------------------------+
80| SYSTICK   | on-chip    | systick                             |
81+-----------+------------+-------------------------------------+
82| GPIO      | on-chip    | gpio                                |
83+-----------+------------+-------------------------------------+
84| COUNTER   | on-chip    | counter                             |
85+-----------+------------+-------------------------------------+
86| CAN       | on-chip    | flexcan                             |
87+-----------+------------+-------------------------------------+
88| SPI       | on-chip    | spi                                 |
89+-----------+------------+-------------------------------------+
90| I2C       | on-chip    | i2c                                 |
91+-----------+------------+-------------------------------------+
92| PWM       | on-chip    | flexpwm, qtmr                       |
93+-----------+------------+-------------------------------------+
94| ADC       | on-chip    | adc                                 |
95+-----------+------------+-------------------------------------+
96| UART      | on-chip    | serial port-polling;                |
97|           |            | serial port-interrupt               |
98+-----------+------------+-------------------------------------+
99| DMA       | on-chip    | dma                                 |
100+-----------+------------+-------------------------------------+
101| GPT       | on-chip    | gpt                                 |
102+-----------+------------+-------------------------------------+
103| WATCHDOG  | on-chip    | watchdog                            |
104+-----------+------------+-------------------------------------+
105| ENET      | on-chip    | ethernet                            |
106+-----------+------------+-------------------------------------+
107| SAI       | on-chip    | i2s                                 |
108+-----------+------------+-------------------------------------+
109| USB       | on-chip    | USB Device                          |
110+-----------+------------+-------------------------------------+
111| HWINFO    | on-chip    | Unique device serial number         |
112+-----------+------------+-------------------------------------+
113| DISPLAY   | on-chip    | display                             |
114+-----------+------------+-------------------------------------+
115| ACMP      | on-chip    | sensor                              |
116+-----------+------------+-------------------------------------+
117| CAAM RNG  | on-chip    | entropy                             |
118+-----------+------------+-------------------------------------+
119| FLEXSPI   | on-chip    | flash programming                   |
120+-----------+------------+-------------------------------------+
121
122The default configuration can be found in
123:zephyr_file:`boards/nxp/vmu_rt1170/vmu_rt1170_mimxrt1176_cm7_defconfig`
124
125Other hardware features are not currently supported by the port.
126
127Connections and I/Os
128====================
129
130The MIMXRT1170 SoC has six pairs of pinmux/gpio controllers.
131
132+-----------------+--------------------------------+----------------------------+
133| Name            | Function                       | Usage                      |
134+-----------------+--------------------------------+----------------------------+
135| GPIO_AD_00      | FLEXCAN2_TX                    | CAN2_TX                    |
136+-----------------+--------------------------------+----------------------------+
137| GPIO_AD_01      | FLEXCAN2_RX                    | CAN2_RX                    |
138+-----------------+--------------------------------+----------------------------+
139| GPIO_AD_02      | LPUART8_TXD                    | UART8_TX_TELEM2            |
140+-----------------+--------------------------------+----------------------------+
141| GPIO_AD_03      | LPUART8_RXD                    | UART8_RX_TELEM2            |
142+-----------------+--------------------------------+----------------------------+
143| GPIO_AD_04      | LPUART8_CTS_B                  | UART8_CTS_TELEM2           |
144+-----------------+--------------------------------+----------------------------+
145| GPIO_AD_05      | LPUART8_RTS_B                  | UART8_RTS_TELEM2           |
146+-----------------+--------------------------------+----------------------------+
147| GPIO_AD_06      | FLEXCAN1_TX                    | CAN1_TX                    |
148+-----------------+--------------------------------+----------------------------+
149| GPIO_AD_07      | FLEXCAN1_RX                    | CAN1_RX                    |
150+-----------------+--------------------------------+----------------------------+
151| GPIO_AD_08      | LPI2C1_SCL                     | I2C1_SCL_GPS1              |
152+-----------------+--------------------------------+----------------------------+
153| GPIO_AD_09      | LPI2C1_SDA                     | I2C1_SDA_GPS1              |
154+-----------------+--------------------------------+----------------------------+
155| GPIO_AD_10      | LPADC1_CH2A                    | SCALED_VDD_3V3_SENSORS1    |
156+-----------------+--------------------------------+----------------------------+
157| GPIO_AD_11      | LPADC1_CH2B                    | SCALED_VDD_3V3_SENSORS2    |
158+-----------------+--------------------------------+----------------------------+
159| GPIO_AD_12      | LPADC1_CH3A                    | SCALED_VDD_3V3_SENSORS3    |
160+-----------------+--------------------------------+----------------------------+
161| GPIO_AD_13      | LPADC1_CH3B                    | SCALED_V5                  |
162+-----------------+--------------------------------+----------------------------+
163| GPIO_AD_14      | LPADC1_CH4A                    | ADC_6V6                    |
164+-----------------+--------------------------------+----------------------------+
165| GPIO_AD_15      | LPUART10_TXD                   | UART10_TX_TELEM3           |
166+-----------------+--------------------------------+----------------------------+
167| GPIO_AD_16      | LPADC1_CH5A                    | ADC_3V3                    |
168+-----------------+--------------------------------+----------------------------+
169| GPIO_AD_17      | LPADC1_CHB                     | SCALED_VDD_3V3_SENSORS4    |
170+-----------------+--------------------------------+----------------------------+
171| GPIO_AD_18      | LPI2C2_SCL                     | I2C2_SCL_GPS2              |
172+-----------------+--------------------------------+----------------------------+
173| GPIO_AD_19      | LPI2C2_SDA                     | I2C2_SDA_GPS2              |
174+-----------------+--------------------------------+----------------------------+
175| GPIO_AD_20      | GPIO3_IO19                     | SPI1_DRDY1_SENSOR1         |
176+-----------------+--------------------------------+----------------------------+
177| GPIO_AD_21      | GPIO3_IO20                     | SPI3_DRDY1_SENSOR3         |
178+-----------------+--------------------------------+----------------------------+
179| GPIO_AD_22      | LPADC2_CH2A                    | HW_VER_SENSE               |
180+-----------------+--------------------------------+----------------------------+
181| GPIO_AD_23      | LPADC2_CH2B                    | HW_REV_SENSE               |
182+-----------------+--------------------------------+----------------------------+
183| GPIO_AD_24      | LPSPI2_SCK                     | SPI2_SCK_SENSOR2           |
184+-----------------+--------------------------------+----------------------------+
185| GPIO_AD_25      | LPSPI2_PCS0                    | SPI2_nCS0_SENSOR2          |
186+-----------------+--------------------------------+----------------------------+
187| GPIO_AD_26      | LPSPI2_SOUT                    | SPI2_MOSI_SENSOR2          |
188+-----------------+--------------------------------+----------------------------+
189| GPIO_AD_27      | LPSPI2_SIN                     | SPI2_MISO_SENSOR2          |
190+-----------------+--------------------------------+----------------------------+
191| GPIO_AD_28      | LPUART5_TXD                    | UART5_TX_GPS2              |
192+-----------------+--------------------------------+----------------------------+
193| GPIO_AD_29      | LPUART5_RXD                    | UART5_RX_GPS2              |
194+-----------------+--------------------------------+----------------------------+
195| GPIO_AD_30      | LPUART3_TXD                    | UART3_TX_GPS1              |
196+-----------------+--------------------------------+----------------------------+
197| GPIO_AD_31      | LPUART3_RXD                    | UART3_RX_GPS1              |
198+-----------------+--------------------------------+----------------------------+
199| GPIO_AD_32      | USDHC1_CD_B                    | USDHC1_CD                  |
200+-----------------+--------------------------------+----------------------------+
201| GPIO_AD_33      | LPUART10_RXD                   | UART10_RX_TELEM3           |
202+-----------------+--------------------------------+----------------------------+
203| GPIO_AD_34      | LPUART10_CTS_B                 | UART10_CTS_TELEM3          |
204+-----------------+--------------------------------+----------------------------+
205| GPIO_AD_35      | LPUART10_RTS_B                 | UART10_RTS_TELEM3          |
206+-----------------+--------------------------------+----------------------------+
207| GPIO_DISP_B1_00 | ENET_1G_RX_EN                  | ETH_CRS_DV                 |
208+-----------------+--------------------------------+----------------------------+
209| GPIO_DISP_B1_01 | ENET_1G_RX_ER                  | ETH_RX_ER                  |
210+-----------------+--------------------------------+----------------------------+
211| GPIO_DISP_B1_02 | LPUART1_TXD                    | UART1_TX_DEBUG             |
212+-----------------+--------------------------------+----------------------------+
213| GPIO_DISP_B1_03 | LPUART1_RXD                    | UART1_RX_DEBUG             |
214+-----------------+--------------------------------+----------------------------+
215| GPIO_DISP_B1_04 | LPUART4_RXD                    | UART4_RX_TELEM1            |
216+-----------------+--------------------------------+----------------------------+
217| GPIO_DISP_B1_05 | LPUART4_CTS_B                  | UART4_CTS_TELEM1           |
218+-----------------+--------------------------------+----------------------------+
219| GPIO_DISP_B1_06 | LPUART4_TXD                    | UART4_TX_TELEM1            |
220+-----------------+--------------------------------+----------------------------+
221| GPIO_DISP_B1_07 | LPUART4_RTS_B                  | UART4_RTS_TELEM1           |
222+-----------------+--------------------------------+----------------------------+
223| GPIO_DISP_B1_08 | ENET_1G_TDATA1                 | ETH_TXD1                   |
224+-----------------+--------------------------------+----------------------------+
225| GPIO_DISP_B1_09 | ENET_1G_TDATA0                 | ETH_TXD0                   |
226+-----------------+--------------------------------+----------------------------+
227| GPIO_DISP_B1_10 | ENET_1G_TX_EN                  | ETH_TX_EN                  |
228+-----------------+--------------------------------+----------------------------+
229| GPIO_DISP_B1_11 | ENET_1G_REF_CLK                | ETH_REF_CLK                |
230+-----------------+--------------------------------+----------------------------+
231| GPIO_DISP_B2_00 | GPIO5_IO01                     | nLED_RED                   |
232+-----------------+--------------------------------+----------------------------+
233| GPIO_DISP_B2_01 | GPIO5_IO02                     | nLED_GREEN                 |
234+-----------------+--------------------------------+----------------------------+
235| GPIO_DISP_B2_02 | ARM_TRACE0                     | TRACED0                    |
236+-----------------+--------------------------------+----------------------------+
237| GPIO_DISP_B2_03 | ARM_TRACE1                     | TRACED1                    |
238+-----------------+--------------------------------+----------------------------+
239| GPIO_DISP_B2_04 | ARM_TRACE2                     | TRACED2                    |
240+-----------------+--------------------------------+----------------------------+
241| GPIO_DISP_B2_05 | ARM_TRACE3                     | TRACED3                    |
242+-----------------+--------------------------------+----------------------------+
243| GPIO_DISP_B2_06 | ARM_TRACE_CLK                  | TRACECLK                   |
244+-----------------+--------------------------------+----------------------------+
245| GPIO_DISP_B2_07 | ARM_TRACE_SWO                  | TRACESWO                   |
246+-----------------+--------------------------------+----------------------------+
247| GPIO_DISP_B2_08 | GPIO5_IO09                     | ETH_POWER_EN               |
248+-----------------+--------------------------------+----------------------------+
249| GPIO_DISP_B2_09 | GPIO5_IO10                     | ETH_PHY_nINT               |
250+-----------------+--------------------------------+----------------------------+
251| GPIO_DISP_B2_10 | LPI2C3_SCL                     | I2C3_SCL_FMU               |
252+-----------------+--------------------------------+----------------------------+
253| GPIO_DISP_B2_11 | LPI2C3_SDA                     | I2C3_SDA_FMU               |
254+-----------------+--------------------------------+----------------------------+
255| GPIO_DISP_B2_12 | LPSPI4_SCK                     | SPI4_SCK_SENSOR4           |
256+-----------------+--------------------------------+----------------------------+
257| GPIO_DISP_B2_13 | LPSPI4_SIN                     | SPI4_MISO_SENSOR4          |
258+-----------------+--------------------------------+----------------------------+
259| GPIO_DISP_B2_14 | LPSPI4_SOUT                    | SPI4_MOSI_SENSOR4          |
260+-----------------+--------------------------------+----------------------------+
261| GPIO_DISP_B2_15 | LPSPI4_PCS0                    | SPI4_nCS0_SENSOR4          |
262+-----------------+--------------------------------+----------------------------+
263| GPIO_EMC_B1_00  | FLEXPWM4_PWM0_A + FLEXIO1_IO00 | FMU_CH11                   |
264+-----------------+--------------------------------+----------------------------+
265| GPIO_EMC_B1_01  | GPIO1_IO01                     | VDD_3V3_SD_CARD_EN         |
266+-----------------+--------------------------------+----------------------------+
267| GPIO_EMC_B1_02  | FLEXPWM4_PWM1_A + FLEXIO1_IO02 | FMU_CH12                   |
268+-----------------+--------------------------------+----------------------------+
269| GPIO_EMC_B1_03  | GPIO1_IO03                     | FMU_nSAFETY_SWITCH_LED_OUT |
270+-----------------+--------------------------------+----------------------------+
271| GPIO_EMC_B1_04  | GPIO1_IO04                     | NFC_GPIO                   |
272+-----------------+--------------------------------+----------------------------+
273| GPIO_EMC_B1_05  | GPIO1_IO05                     | SPI6_DRDY1_EXTERNAL1       |
274+-----------------+--------------------------------+----------------------------+
275| GPIO_EMC_B1_06  | FLEXPWM2_PWM0_A + FLEXIO1_IO06 | FMU_CH4                    |
276+-----------------+--------------------------------+----------------------------+
277| GPIO_EMC_B1_07  | GPIO1_IO07                     | SPI6_DRDY2_EXTERNAL1       |
278+-----------------+--------------------------------+----------------------------+
279| GPIO_EMC_B1_08  | FLEXPWM2_PWM1_A + FLEXIO1_IO08 | FMU_CH5                    |
280+-----------------+--------------------------------+----------------------------+
281| GPIO_EMC_B1_09  | GPT5_CAPTURE1                  | FMU_PPM_INPUT              |
282+-----------------+--------------------------------+----------------------------+
283| GPIO_EMC_B1_10  | FLEXPWM2_PWM2_A + FLEXIO1_IO10 | FMU_CH6                    |
284+-----------------+--------------------------------+----------------------------+
285| GPIO_EMC_B1_11  | GPIO1_IO11                     | SPI6_nRESET_EXTERNAL1      |
286+-----------------+--------------------------------+----------------------------+
287| GPIO_EMC_B1_12  | GPIO1_IO12                     | VDD_5V_HIPOWER_nOC         |
288+-----------------+--------------------------------+----------------------------+
289| GPIO_EMC_B1_13  | GPIO1_IO13                     | nLED_BLUE                  |
290+-----------------+--------------------------------+----------------------------+
291| GPIO_EMC_B1_14  | GPIO1_IO14                     | VDD_3V3_SENSORS3_EN        |
292+-----------------+--------------------------------+----------------------------+
293| GPIO_EMC_B1_15  | GPIO1_IO15                     | VDD_5V_PERIPH_nOC          |
294+-----------------+--------------------------------+----------------------------+
295| GPIO_EMC_B1_16  | GPIO1_IO16                     | SPI4_DRDY1_SENSOR4         |
296+-----------------+--------------------------------+----------------------------+
297| GPIO_EMC_B1_17  | GPIO1_IO17                     | nARMED                     |
298+-----------------+--------------------------------+----------------------------+
299| GPIO_EMC_B1_18  | TMR2_TIMER0                    | SPIX_SYNC                  |
300+-----------------+--------------------------------+----------------------------+
301| GPIO_EMC_B1_19  | FLEXPWM2_PWM3_A + FLEXIO1_IO19 | FMU_CH7                    |
302+-----------------+--------------------------------+----------------------------+
303| GPIO_EMC_B1_20  | TMR4_TIMER0                    | FMU_CAP1                   |
304+-----------------+--------------------------------+----------------------------+
305| GPIO_EMC_B1_21  | FLEXPWM3_PWM3_A + FLEXIO1_IO21 | FMU_CH10                   |
306+-----------------+--------------------------------+----------------------------+
307| GPIO_EMC_B1_22  | GPIO1_IO22                     | VDD_3V3_SENSORS2_EN        |
308+-----------------+--------------------------------+----------------------------+
309| GPIO_EMC_B1_23  | FLEXPWM1_PWM0_A                | FMU_CH1                    |
310+-----------------+--------------------------------+----------------------------+
311| GPIO_EMC_B1_24  | GPIO1_IO24                     | FMU_SAFETY_SWITCH_IN       |
312+-----------------+--------------------------------+----------------------------+
313| GPIO_EMC_B1_25  | FLEXPWM1_PWM1_A + FLEXIO1_IO25 | FMU_CH2                    |
314+-----------------+--------------------------------+----------------------------+
315| GPIO_EMC_B1_26  | GPIO1_IO26                     | HW_VER_REV_DRIVE           |
316+-----------------+--------------------------------+----------------------------+
317| GPIO_EMC_B1_27  | FLEXPWM1_PWM2_A + FLEXIO1_IO27 | FMU_CH3                    |
318+-----------------+--------------------------------+----------------------------+
319| GPIO_EMC_B1_28  | GPIO1_IO28                     | nPOWER_IN_A                |
320+-----------------+--------------------------------+----------------------------+
321| GPIO_EMC_B1_29  | FLEXPWM3_PWM0_A + FLEXIO1_IO29 | FMU_CH8                    |
322+-----------------+--------------------------------+----------------------------+
323| GPIO_EMC_B1_30  | GPIO1_IO30                     | nPOWER_IN_B                |
324+-----------------+--------------------------------+----------------------------+
325| GPIO_EMC_B1_31  | FLEXPWM3_PWM1_A + FLEXIO1_IO31 | FMU_CH9                    |
326+-----------------+--------------------------------+----------------------------+
327| GPIO_EMC_B1_32  | GPIO2_IO00                     | nPOWER_IN_C                |
328+-----------------+--------------------------------+----------------------------+
329| GPIO_EMC_B1_33  | GPIO2_IO01                     | VDD_3V3_SENSORS1_EN        |
330+-----------------+--------------------------------+----------------------------+
331| GPIO_EMC_B1_34  | GPIO2_IO02                     | VDD_5V_PERIPH_nEN          |
332+-----------------+--------------------------------+----------------------------+
333| GPIO_EMC_B1_35  | GPIO2_IO03                     | I2C2_DRDY1                 |
334+-----------------+--------------------------------+----------------------------+
335| GPIO_EMC_B1_36  | GPIO2_IO04                     | VDD_3V3_SENSORS4_EN        |
336+-----------------+--------------------------------+----------------------------+
337| GPIO_EMC_B1_37  | GPIO2_IO05                     | VDD_5V_HIPOWER_nEN         |
338+-----------------+--------------------------------+----------------------------+
339| GPIO_EMC_B1_38  | GPIO2_IO06                     | VDD_3V3_SPEKTRUM_POWER_EN  |
340+-----------------+--------------------------------+----------------------------+
341| GPIO_EMC_B1_39  | GPIO2_IO07                     | SPI2_DRDY1_SENSOR2         |
342+-----------------+--------------------------------+----------------------------+
343| GPIO_EMC_B1_40  | LPUART6_TXD                    | UART6_TX_TO_IO__RC_INPUT   |
344+-----------------+--------------------------------+----------------------------+
345| GPIO_EMC_B1_41  | LPUART6_RXD                    | UART6_RX_FROM_IO__NC       |
346+-----------------+--------------------------------+----------------------------+
347| GPIO_EMC_B2_00  | LPSPI1_SCK                     | SPI1_SCK_SENSOR1           |
348+-----------------+--------------------------------+----------------------------+
349| GPIO_EMC_B2_01  | LPSPI1_PCS0                    | SPI1_nCS0_SENSOR1          |
350+-----------------+--------------------------------+----------------------------+
351| GPIO_EMC_B2_02  | LPSPI1_SOUT                    | SPI1_MOSI_SENSOR1          |
352+-----------------+--------------------------------+----------------------------+
353| GPIO_EMC_B2_03  | LPSPI1_SIN                     | SPI1_MISO_SENSOR1          |
354+-----------------+--------------------------------+----------------------------+
355| GPIO_EMC_B2_04  | LPSPI3_SCK                     | SPI3_SCK_SENSOR3           |
356+-----------------+--------------------------------+----------------------------+
357| GPIO_EMC_B2_05  | LPSPI3_PCS0                    | SPI3_nCS0_SENSOR3          |
358+-----------------+--------------------------------+----------------------------+
359| GPIO_EMC_B2_06  | LPSPI3_SOUT                    | SPI3_MOSI_SENSOR3          |
360+-----------------+--------------------------------+----------------------------+
361| GPIO_EMC_B2_07  | LPSPI3_SIN                     | SPI3_MISO_SENSOR3          |
362+-----------------+--------------------------------+----------------------------+
363| GPIO_EMC_B2_08  | LPSPI3_PCS1                    | SPI3_nCS1_SENSOR3          |
364+-----------------+--------------------------------+----------------------------+
365| GPIO_EMC_B2_09  | TMR1_TIMER0                    | BUZZER_1                   |
366+-----------------+--------------------------------+----------------------------+
367| GPIO_EMC_B2_10  | FLEXSPI2_A_SCLK                | FLEXSPI2_SCK_FRAM          |
368+-----------------+--------------------------------+----------------------------+
369| GPIO_EMC_B2_11  | FLEXSPI2_A_SS0_B               | FLEXSPI2_nCS0_FRAM         |
370+-----------------+--------------------------------+----------------------------+
371| GPIO_EMC_B2_12  | GPIO2_IO22                     | GPIO_EMC_B2_12             |
372+-----------------+--------------------------------+----------------------------+
373| GPIO_EMC_B2_13  | FLEXSPI2_A_DATA0               | FLEXSPI2_DATA0_FRAM        |
374+-----------------+--------------------------------+----------------------------+
375| GPIO_EMC_B2_14  | FLEXSPI2_A_DATA1               | FLEXSPI2_DATA1_FRAM        |
376+-----------------+--------------------------------+----------------------------+
377| GPIO_EMC_B2_15  | ENET_1G_RDATA0                 | ETH_RXD0                   |
378+-----------------+--------------------------------+----------------------------+
379| GPIO_EMC_B2_16  | ENET_1G_RDATA1                 | ETH_RXD1                   |
380+-----------------+--------------------------------+----------------------------+
381| GPIO_EMC_B2_17  | TMR3_TIMER0                    | HEATER                     |
382+-----------------+--------------------------------+----------------------------+
383| GPIO_EMC_B2_18  | GPIO2_IO28                     | SPI3_DRDY2_SENSOR3         |
384+-----------------+--------------------------------+----------------------------+
385| GPIO_EMC_B2_19  | ENET_1G_MDC                    | ETH_MDC                    |
386+-----------------+--------------------------------+----------------------------+
387| GPIO_EMC_B2_20  | ENET_1G_MDIO                   | ETH_MDIO                   |
388+-----------------+--------------------------------+----------------------------+
389| GPIO_LPSR_00    | FLEXCAN3_TX                    | CAN3_TX                    |
390+-----------------+--------------------------------+----------------------------+
391| GPIO_LPSR_01    | FLEXCAN3_RX                    | CAN3_RX                    |
392+-----------------+--------------------------------+----------------------------+
393| GPIO_LPSR_02    | SRC_BOOT_MODE00                | BT_MODE0                   |
394+-----------------+--------------------------------+----------------------------+
395| GPIO_LPSR_03    | SRC_BOOT_MODE01                | BT_MODE1                   |
396+-----------------+--------------------------------+----------------------------+
397| GPIO_LPSR_04    | LPUART11_TXD                   | UART11_TX_EXTERNAL2        |
398+-----------------+--------------------------------+----------------------------+
399| GPIO_LPSR_05    | LPUART11_RXD                   | UART11_RX_EXTERNAL2        |
400+-----------------+--------------------------------+----------------------------+
401| GPIO_LPSR_06    | LPI2C6_SDA                     | I2C6_SDA_EXTERNAL2         |
402+-----------------+--------------------------------+----------------------------+
403| GPIO_LPSR_07    | LPI2C6_SCL                     | I2C6_SCL_EXTERNAL2         |
404+-----------------+--------------------------------+----------------------------+
405| GPIO_LPSR_08    | LPSPI6_PCS1                    | SPI6_nCS1_EXTERNAL1        |
406+-----------------+--------------------------------+----------------------------+
407| GPIO_LPSR_09    | LPSPI6_PCS0                    | SPI6_nCS0                  |
408+-----------------+--------------------------------+----------------------------+
409| GPIO_LPSR_10    | LPSPI6_SCK                     | SPI6_SCK_EXTERNAL1         |
410+-----------------+--------------------------------+----------------------------+
411| GPIO_LPSR_11    | LPSPI6_SOUT                    | SPI6_MOSI_EXTERNAL1        |
412+-----------------+--------------------------------+----------------------------+
413| GPIO_LPSR_12    | LPSPI6_SIN                     | SPI6_MISO_EXTERNAL1        |
414+-----------------+--------------------------------+----------------------------+
415| GPIO_LPSR_13    | JTAG_MOD                       | NC_JTAG_MOD_PD             |
416+-----------------+--------------------------------+----------------------------+
417| GPIO_LPSR_14    | SWD_CLK                        | FMU_SWCLK                  |
418+-----------------+--------------------------------+----------------------------+
419| GPIO_LPSR_15    | SWD_DIO                        | FMU_SWDIO                  |
420+-----------------+--------------------------------+----------------------------+
421| GPIO_SD_B1_00   | USDHC1_CMD                     | USDHC1_CMD                 |
422+-----------------+--------------------------------+----------------------------+
423| GPIO_SD_B1_01   | USDHC1_CLK                     | USDHC1_CLK                 |
424+-----------------+--------------------------------+----------------------------+
425| GPIO_SD_B1_02   | USDHC1_DATA0                   | USDHC1_DATA0               |
426+-----------------+--------------------------------+----------------------------+
427| GPIO_SD_B1_03   | USDHC1_DATA1                   | USDHC1_DATA1               |
428+-----------------+--------------------------------+----------------------------+
429| GPIO_SD_B1_04   | USDHC1_DATA2                   | USDHC1_DATA2               |
430+-----------------+--------------------------------+----------------------------+
431| GPIO_SD_B1_05   | USDHC1_DATA3                   | USDHC1_DATA3               |
432+-----------------+--------------------------------+----------------------------+
433| GPIO_SD_B2_00   | FLEXSPI1_B_DATA3               | FLEXSPI1_DATA7_HYPERFLASH  |
434+-----------------+--------------------------------+----------------------------+
435| GPIO_SD_B2_01   | FLEXSPI1_B_DATA2               | FLEXSPI1_DATA6_HYPERFLASH  |
436+-----------------+--------------------------------+----------------------------+
437| GPIO_SD_B2_02   | FLEXSPI1_B_DATA1               | FLEXSPI1_DATA5_HYPERFLASH  |
438+-----------------+--------------------------------+----------------------------+
439| GPIO_SD_B2_03   | FLEXSPI1_B_DATA0               | FLEXSPI1_DATA4_HYPERFLASH  |
440+-----------------+--------------------------------+----------------------------+
441| GPIO_SD_B2_04   | FLEXSPI1_B_SCLK                | FLEXSPI1_nSCK_HYPERFLASH   |
442+-----------------+--------------------------------+----------------------------+
443| GPIO_SD_B2_05   | FLEXSPI1_A_DQS                 | FLEXSPI1_DQS_HYPERFLASH    |
444+-----------------+--------------------------------+----------------------------+
445| GPIO_SD_B2_06   | FLEXSPI1_A_SS0_B               | FLEXSPI1_nCS0_HYPERFLASH   |
446+-----------------+--------------------------------+----------------------------+
447| GPIO_SD_B2_07   | FLEXSPI1_A_SCLK                | FLEXSPI1_SCK_HYPERFLASH    |
448+-----------------+--------------------------------+----------------------------+
449| GPIO_SD_B2_08   | FLEXSPI1_A_DATA0               | FLEXSPI1_DATA0_HYPERFLASH  |
450+-----------------+--------------------------------+----------------------------+
451| GPIO_SD_B2_09   | FLEXSPI1_A_DATA0               | FLEXSPI1_DATA1_HYPERFLASH  |
452+-----------------+--------------------------------+----------------------------+
453| GPIO_SD_B2_10   | FLEXSPI1_A_DATA2               | FLEXSPI1_DATA2_HYPERFLASH  |
454+-----------------+--------------------------------+----------------------------+
455| GPIO_SD_B2_11   | FLEXSPI1_A_DATA3               | FLEXSPI1_DATA3_HYPERFLASH  |
456+-----------------+--------------------------------+----------------------------+
457| USB1_DN         | USB_OG1_DN                     | USB_D_N                    |
458+-----------------+--------------------------------+----------------------------+
459| USB1_DP         | USB_OTG1_DP                    | USB_D_P                    |
460+-----------------+--------------------------------+----------------------------+
461| USB1_VBUS       | USB_OTG1_VBUS                  | VBUS                       |
462+-----------------+--------------------------------+----------------------------+
463
464Serial Port
465===========
466
467The MIMXRT1170 SoC has 12 UARTs.
468
469Programming and Debugging
470*************************
471
472Build and flash applications as usual (see :ref:`build_an_application` and
473:ref:`application_run` for more details).
474
475Configuring a Debug Probe
476=========================
477
478A debug probe is used for both flashing and debugging the board.
479
480Using J-Link
481------------
482
483Install the :ref:`jlink-debug-host-tools` and make sure they are in your search
484path.
485
486Connect the J-Link debugger through the debug adapter board.
487
488Configuring a Console
489=====================
490
491Use the USB-C from the debug adapter board to access the console with
492the following settings for your serial terminal of choice (screen, minicom, putty,
493etc.):
494
495- Speed: 115200
496- Data: 8 bits
497- Parity: None
498- Stop bits: 1
499
500Flashing
501========
502
503Here is an example for the :zephyr:code-sample:`hello_world` application.
504
505.. zephyr-app-commands::
506   :zephyr-app: samples/hello_world
507   :board: vmu_rt1170
508   :goals: flash
509
510You should see the following message in the terminal:
511
512.. code-block:: console
513
514   ***** Booting Zephyr OS v3.4.0-xxxx-xxxxxxxxxxxxx *****
515   Hello World! vmu_rt1170
516
517Debugging
518=========
519
520Here is an example for the :zephyr:code-sample:`hello_world` application.
521
522.. zephyr-app-commands::
523   :zephyr-app: samples/hello_world
524   :board: vmu_rt1170
525   :goals: debug
526
527Open a serial terminal, step through the application in your debugger, and you
528should see the following message in the terminal:
529
530.. code-block:: console
531
532   ***** Booting Zephyr OS v3.4.0-xxxx-xxxxxxxxxxxxx *****
533   Hello World! vmu_rt1170
534
535.. _VMU RT1170 Schematics:
536   https://github.com/CogniPilot/NXP-VMU_RT117x-HW
537
538.. _i.MX RT1170 Datasheet:
539   https://www.nxp.com/docs/en/data-sheet/IMXRT1170CEC.pdf
540
541.. _i.MX RT1170 Reference Manual:
542   https://www.nxp.com/webapp/Download?colCode=IMXRT1170RM
543