Zephyr Platform Customization: Difference between revisions

From Variscite Wiki
(Rename section ZEPHYR_4.0.0_V1.0_DART-MX8M-PLUS to mx8mp-zephyr-4.0.0-v1.0)
(Update Supported platforms VAR-SOM-MX93 conditional)
 
(7 intermediate revisions by the same user not shown)
Line 16: Line 16:
-->{{#ifeq: {{#var:HARDWARE_NAME}} | VAR-SOM-MX6    | / DART-MX6 / VAR-SOM-SOLO/DUAL }}<!--
-->{{#ifeq: {{#var:HARDWARE_NAME}} | VAR-SOM-MX6    | / DART-MX6 / VAR-SOM-SOLO/DUAL }}<!--
-->{{#ifeq: {{#var:HARDWARE_NAME}} | DART-6UL      | / VAR-SOM-6UL }}<!--
-->{{#ifeq: {{#var:HARDWARE_NAME}} | DART-6UL      | / VAR-SOM-6UL }}<!--
-->{{#ifeq: {{#var:HARDWARE_NAME}} | VAR-SOM-MX93  | {{#ifeq: {{#var:BOARD_FOLDER1}} | boards/dart_mx93 | / DART-MX93 }} }}
-->{{#ifeq: {{#var:HARDWARE_NAME}} | VAR-SOM-MX93  | / DART-MX93 }}
|-
|-
| SOM revision || {{#var:SUPPORTED_REV_SOM}}
| SOM revision || {{#var:SUPPORTED_REV_SOM}}
Line 31: Line 31:


== Sections ==
== Sections ==
=== Available dtbs ===
<section begin=DART-MX8M-PLUS_DTBS_SECTION/><!--
-->To allow Cortex M7 accessing shared resources without experiencing Linux kernel conflicts, a dedicated device tree must be loaded, containing '''m7''' label in the name, using the fdt_file environment variable in U-Boot.
This device tree disables some of the base device tree nodes in order to avoid conflicts between the main processor and Cortex M7.
{| class="wikitable"
|-
! scope="col" | File Name<br/>
! scope="col" | Description<br/>
|-
| style="padding: 5px;"| imx8mp-var-dart-dt8mcustomboard-'''m7'''.dtb
| style="padding: 5px;"| DART-MX8M-PLUS device tree blob for kernel >= 5.4.70 (Yocto Zeus) on DT8MCustomBoard 2.x
|-
| style="padding: 5px;"| imx8mp-var-dart-dt8mcustomboard-legacy-'''m7'''.dtb
| style="padding: 5px;"| DART-MX8M-PLUS device tree blob for kernel >= 5.4.70 (Yocto Zeus) on on DT8MCustomBoard 1.x
|-
| style="padding: 5px;"| imx8mp-var-som-symphony-'''m7'''.dtb
| style="padding: 5px;"| VAR-SOM-MX8M-PLUS device tree blob for kernels >= 5.4.70 (Yocto Zeus) on on Symphony-Board
|-
| style="padding: 5px;"| imx8mp-var-som-symphony-2nd-ov5640'''m7'''.dtb
| style="padding: 5px;"| VAR-SOM-MX8M-PLUS device tree blob for kernels >= 5.4.70 (Yocto Zeus) on on Symphony-Board with 2nd OV5640
|-
|}
<section end=DART-MX8M-PLUS_DTBS_SECTION/>


=== Default pins ===
=== Default pins ===
Line 128: Line 101:
* samples/basic/button<!--
* samples/basic/button<!--
--><section end=DART-MX8M-PLUS_DEMOS_SECTION/>
--><section end=DART-MX8M-PLUS_DEMOS_SECTION/>
=== JTAG ===
<section begin=DART-MX8M-PLUS_JTAG_SECTION/><!--
-->The VAR-SOM-MX8M-PLUS exposes JTAG interface via an optional 10-pin header, on the SOM top left side.<br>
The DART-MX8M-PLUS exports JTAG interface via an optional 10-pin header, on the DT8MCustomBoard top side.
Here is the pinout:
{| class="wikitable"
|-
! scope="col" | pin
! scope="col" | signal
! scope="col" | description
! scope="col" | pin
! scope="col" | signal
! scope="col" | description
|-
| '''1'''
| JTAG_VREF
| JTAG IO reference voltage,<br>connected to SOM_3V3_PER via 150 Ohm.
| '''2'''
| JTAG_TMS
| JTAG Mode Select signal
|-
| '''3'''
| GND
| Digital Ground
| '''4'''
| JTAG_TCK
| JTAG Clock signal,<br>include PD of 8.2K Ohm.
|-
| '''5'''
| GND
| Digital Ground
| '''6'''
| JTAG_TDO
| JTAG Data Out signal
|-
| '''7'''
| GND
| Digital Ground
| '''8'''
| JTAG_TDI
| JTAG Data In signal
|-
| '''9'''
| JTAG_TRST_B
| JTAG Reset signal,<br>active low signal
| '''10'''
| POR_B
| Programmer Reset,<br>used to put the SOC in reset state.
|-
|}
Please refer to SoM datasheet for further details.<!--
--><section end=DART-MX8M-PLUS_JTAG_SECTION/>


== Releases ==
== Releases ==
Line 205: Line 121:
-->{{#vardefine:DTBS_SECTION|DART-MX8M-PLUS_DTBS_SECTION}}<!--
-->{{#vardefine:DTBS_SECTION|DART-MX8M-PLUS_DTBS_SECTION}}<!--
-->{{#vardefine:JTAG_SECTION|DART-MX8M-PLUS_JTAG_SECTION}}<!--
-->{{#vardefine:JTAG_SECTION|DART-MX8M-PLUS_JTAG_SECTION}}<!--
-->{{#vardefine:RELEASE_DATE|03/03/2025}} <!--
-->{{#vardefine:RELEASE_DATE|02/26/2025}} <!--
-->{{#vardefine:SUPPORTED_REV_SOM|v1.1 and higher}} <!--
-->{{#vardefine:SUPPORTED_REV_SOM|v1.1 and higher}} <!--
-->{{#vardefine:SUPPORTED_REV_CARRIER|v1.4 and higher}} <!--
-->{{#vardefine:SUPPORTED_REV_CARRIER|v1.4 and higher}} <!--
Line 215: Line 131:
-->{{#vardefine:BOARD_SOM|1}}<!--
-->{{#vardefine:BOARD_SOM|1}}<!--
-->{{#vardefine:CORTEX_A_TYPE|a53}}<!--
-->{{#vardefine:CORTEX_A_TYPE|a53}}<!--
-->{{#vardefine:CORTEX_A_LOAD_ADDR|0xc0000000}}<!--
--><section end=mx8mp-zephyr-4.0.0-v1.0/><!--
--><section end=mx8mp-zephyr-4.0.0-v1.0/><!--
-->*HARDWARE_NAME = '''{{#var:HARDWARE_NAME}}'''
*RELEASE_NAME = '''{{#var:RELEASE_NAME}}'''
*RELEASE_LINK = '''{{#var:RELEASE_LINK}}'''
*SDK_PATH = '''{{#var:SDK_PATH}}'''
*SDK_GIT_URL = '''{{#var:SDK_GIT_URL}}'''
*SDK_GIT_BRANCH = '''{{#var:SDK_GIT_BRANCH}}'''
*ZEPHYR_VERSION = '''{{#var:ZEPHYR_VERSION}}'''
*BOARD_FOLDER = '''{{#var:BOARD_FOLDER}}'''
*DOCS_FOLDER = '''{{#var:DOCS_FOLDER}}'''
*PINS_SECTION = '''{{#var:PINS_SECTION}}'''
*DEMOS_SECTION = '''{{#var:DEMOS_SECTION}}'''
*DTBS_SECTION = '''{{#var:DTBS_SECTION}}'''
*JTAG_SECTION = '''{{#var:JTAG_SECTION}}'''
*NXP_REFERENCE_KIT = '''{{#var:NXP_REFERENCE_KIT}}'''
*YOCTO_RELEASE_TAG = '''{{#var:YOCTO_RELEASE_TAG}}'''
= DART-MX93 =
== Sections ==
=== Default pins ===
<section begin=DART-MX93_PINS_SECTION/><!--
-->Default pins used by the demos are:
{| class="wikitable"
!colspan="5"|DART-MX93
|-
! scope="col" | Function
! scope="col" | SoC balls
! scope="col" | SoM pins
! scope="col" | DT8MCB pins
! scope="col" | Notes
|-
| UART7 RX/TX
| M21 / M20
| J2.87 / J2.89
| J12.11 / J12.13
| Zephyr debug console
|-
| GPIO4_IO01
| AA10
| J1.11
| J12.14
| Output of the Blinky/Button demo
|-
| GPIO2_IO27
| W21
| J2.54
| J13.17
| Input of the Button demo
|-
|}
{| class="wikitable"
!colspan="5"|VAR-SOM-MX93
|-
! scope="col" | Function
! scope="col" | SoC balls
! scope="col" | SoM pins
! scope="col" | Symphony pins
! scope="col" | Notes
|-
| UART7 RX/TX
| M21 / M20
| J1.175 / J1.124
| J18.5 / J18.3
| Zephyr debug console
|-
| GPIO4_IO28
| U4
| J1.75
| J17.6
| Output of the Blinky/Button demo<br>Pin referenced to 1.8V
|-
| GPIO2_IO27
| W21
| J1.69
| J18.2
| Input of the Button demo
|-
|}<!--
--><section end=DART-MX93_PINS_SECTION/>
=== Available Demos ===
<section begin=DART-MX93_DEMOS_SECTION/><!--
-->* samples/hello_world
* samples/basic/blinky
* samples/basic/button<!--
--><section end=DART-MX93_DEMOS_SECTION/>
== Releases ==
=== mx93-zephyr-4.0.0-v1.0 ===
<section begin=mx93-zephyr-4.0.0-v1.0/><!--
-->{{#vardefine:OS|Zephyr}}<!--
-->{{#vardefine:HARDWARE_NAME|VAR-SOM-MX93}}<!--
-->{{#vardefine:HARDWARE_NAME1|DART-MX93}}<!--
-->{{#vardefine:RELEASE_NAME|mx93-zephyr-4.0.0-v1.0}}<!--
-->{{#vardefine:RELEASE_LINK|mx93-zephyr-4.0.0-v1.0}}<!--
-->{{#vardefine:SDK_PATH|~/zephyrproject/zephyr}}<!--
-->{{#vardefine:SDK_GIT_URL|https://github.com/varigit/zephyr}}<!--
-->{{#vardefine:SDK_GIT_BRANCH|v4.0-branch_var01}}<!--
-->{{#vardefine:ZEPHYR_VERSION|4.0.0}}<!--
-->{{#vardefine:BOARD_FOLDER|boards/variscite/imx93_var_dart}}<!--
-->{{#vardefine:DOCS_FOLDER|doc}}<!--
-->{{#vardefine:PINS_SECTION|DART-MX93_PINS_SECTION}}<!--
-->{{#vardefine:DEMOS_SECTION|DART-MX93_DEMOS_SECTION}}<!--
-->{{#vardefine:DTBS_SECTION|VAR-SOM-MX93_DART-MX93_DTBS_SECTION}}<!--
-->{{#vardefine:JTAG_SECTION|VAR-SOM-MX93_DART-MX93_JTAG_SECTION}}<!--
-->{{#vardefine:RELEASE_DATE|03/05/2025}} <!--
-->{{#vardefine:SUPPORTED_REV_SOM|v1.0 and higher}} <!--
-->{{#vardefine:SUPPORTED_REV_CARRIER|v1.2 and higher}} <!--
-->{{#vardefine:NXP_REFERENCE_KIT|EVK-MIMX93}}<!--
-->{{#vardefine:YOCTO_RELEASE_TAG|mx93-yocto-mickledore-6.1.36_2.1.0-v2.4}}<!--
-->{{#vardefine:BOARD_SDK|imx93_var_dart}}<!--
-->{{#vardefine:DDR_SUPPORT|0}}<!--
-->{{#vardefine:BOARD_DART|1}}<!--
-->{{#vardefine:BOARD_SOM|1}}<!--
-->{{#vardefine:CORTEX_A_TYPE|a55}}<!--
-->{{#vardefine:CORTEX_A_LOAD_ADDR|0xd0000000}}<!--
--><section end=mx93-zephyr-4.0.0-v1.0/><!--
-->*HARDWARE_NAME = '''{{#var:HARDWARE_NAME}}'''
-->*HARDWARE_NAME = '''{{#var:HARDWARE_NAME}}'''
*RELEASE_NAME = '''{{#var:RELEASE_NAME}}'''
*RELEASE_NAME = '''{{#var:RELEASE_NAME}}'''

Latest revision as of 20:35, 28 February 2025


DART-MX8M-PLUS

Sections

Default pins

Default pins used by the demos are:

DART-MX8M-PLUS
Function SoC balls SoM pins DT8MCB pins Notes
UART3 RX/TX AE6 / AJ4 J2.87 / J2.89 J12.11 / J12.13 Zephyr debug console
GPIO3_IO09 N24 J1.46 J41.3 Output of the Blinky/Button demo
Pin referenced to 1.8V
GPIO3_IO08 L24 J1.50 J41.5 Input of the Button demo
Pin referenced to 1.8V
VAR-SOM-MX8M-PLUS
Function SoC balls SoM pins Symphony pins Notes
UART4 RX/TX AH5 / AJ5 J1.115 / J1.171 J18.9 / J18.7 Zephyr debug console
GPIO3_IO14 R26 J1.79 J17.10 Output of the Blinky/Button demo
Pin referenced to 1.8V
GPIO3_IO06 R25 J1.84 J17.3 Input of the Button demo
Pin referenced to 1.8V

Available Demos

  • samples/hello_world
  • samples/basic/blinky
  • samples/basic/button

Releases

mx8mp-zephyr-4.0.0-v1.0

  *HARDWARE_NAME = DART-MX8M-PLUS
  • RELEASE_NAME = mx8mp-zephyr-4.0.0-v1.0
  • RELEASE_LINK = mx8mp-zephyr-4.0.0-v1.0
  • SDK_PATH = ~/zephyrproject/zephyr
  • SDK_GIT_URL = https://github.com/varigit/zephyr
  • SDK_GIT_BRANCH = v4.0-branch_var01
  • ZEPHYR_VERSION = 4.0.0
  • BOARD_FOLDER = boards/variscite/imx8mp_var
  • DOCS_FOLDER = doc
  • PINS_SECTION = DART-MX8M-PLUS_PINS_SECTION
  • DEMOS_SECTION = DART-MX8M-PLUS_DEMOS_SECTION
  • DTBS_SECTION = DART-MX8M-PLUS_DTBS_SECTION
  • JTAG_SECTION = DART-MX8M-PLUS_JTAG_SECTION
  • NXP_REFERENCE_KIT = EVK-MIMX8MP
  • YOCTO_RELEASE_TAG = mx8mp-yocto-scarthgap-6.6.23_2.0.0-v1.1


DART-MX93

Sections

Default pins

Default pins used by the demos are:

DART-MX93
Function SoC balls SoM pins DT8MCB pins Notes
UART7 RX/TX M21 / M20 J2.87 / J2.89 J12.11 / J12.13 Zephyr debug console
GPIO4_IO01 AA10 J1.11 J12.14 Output of the Blinky/Button demo
GPIO2_IO27 W21 J2.54 J13.17 Input of the Button demo
VAR-SOM-MX93
Function SoC balls SoM pins Symphony pins Notes
UART7 RX/TX M21 / M20 J1.175 / J1.124 J18.5 / J18.3 Zephyr debug console
GPIO4_IO28 U4 J1.75 J17.6 Output of the Blinky/Button demo
Pin referenced to 1.8V
GPIO2_IO27 W21 J1.69 J18.2 Input of the Button demo

Available Demos

  • samples/hello_world
  • samples/basic/blinky
  • samples/basic/button

Releases

mx93-zephyr-4.0.0-v1.0

  *HARDWARE_NAME = VAR-SOM-MX93
  • RELEASE_NAME = mx93-zephyr-4.0.0-v1.0
  • RELEASE_LINK = mx93-zephyr-4.0.0-v1.0
  • SDK_PATH = ~/zephyrproject/zephyr
  • SDK_GIT_URL = https://github.com/varigit/zephyr
  • SDK_GIT_BRANCH = v4.0-branch_var01
  • ZEPHYR_VERSION = 4.0.0
  • BOARD_FOLDER = boards/variscite/imx93_var_dart
  • DOCS_FOLDER = doc
  • PINS_SECTION = DART-MX93_PINS_SECTION
  • DEMOS_SECTION = DART-MX93_DEMOS_SECTION
  • DTBS_SECTION = VAR-SOM-MX93_DART-MX93_DTBS_SECTION
  • JTAG_SECTION = VAR-SOM-MX93_DART-MX93_JTAG_SECTION
  • NXP_REFERENCE_KIT = EVK-MIMX93
  • YOCTO_RELEASE_TAG = mx93-yocto-mickledore-6.1.36_2.1.0-v2.4