MX9 UART: Difference between revisions

From Variscite Wiki
(Add Debian_Platform_Customization for Yocto Debian)
No edit summary
Line 7: Line 7:
--> {{PageHeader|{{#var:HARDWARE_NAME}} UART}} {{DocImage|category1=Yocto|category2={{#var:HARDWARE_NAME}}}} __toc__
--> {{PageHeader|{{#var:HARDWARE_NAME}} UART}} {{DocImage|category1=Yocto|category2={{#var:HARDWARE_NAME}}}} __toc__


= {{#var:HARDWARE_NAME}} UART Overview =
= UART Overview =


The {{#var:HARDWARE_NAME}} exposes up to seven LPUART interfaces, some of which are multiplexed with other peripherals.
== UART Overview - VAR-SOM-MX93==
 
The VAR-SOM-MX93 and DART-MX93 expose up to seven LPUART interfaces, some of which are multiplexed with other peripherals.


{| class="wikitable"  
{| class="wikitable"  
Line 16: Line 18:
! Device Node
! Device Node
! Device Tree
! Device Tree
! Note
! VAR-SOM-MX93 / Symphony Board
! DART-MX93 / DT8MCustomBoard
|-
|-
| UART0
| UART0
| /dev/ttyLP0
| /dev/ttyLP0
| lpuart1
| lpuart1
| Connected to Symphony board serial console
| Symphony board serial console
| DT8MCustomboard serial console
|-
|-
| UART2
| UART2
| /dev/ttyLP2
| /dev/ttyLP2
| lpuart3
| lpuart3
| Disabled by default, see datasheet
| Disabled by default, see datasheet
| Disabled by default, see datasheet
|-
|-
Line 31: Line 36:
| /dev/ttyLP3
| /dev/ttyLP3
| lpuart4
| lpuart4
| Disabled by default, see datasheet
| Disabled by default, see datasheet
| Disabled by default, see datasheet
|-
|-
Line 36: Line 42:
| /dev/ttyLP4
| /dev/ttyLP4
| lpuart5
| lpuart5
| 1.8V Signal level, used on SOM for Bluetooth interface and can be accessible only if the [{{#var:META_VARISCITE_GIT_HTTP}}/blob/{{#var:META_VARISCITE_BRANCH}}/recipes-connectivity/bcm43xx-utils/bcm43xx-utils/imx93-var-som/variscite-bt variscite-bt] Systemd service is disabled or SOM without "WBD" and "WB"
| 1.8V Signal level, used on SOM for Bluetooth interface and can be accessible only if the [{{#var:META_VARISCITE_GIT_HTTP}}/blob/{{#var:META_VARISCITE_BRANCH}}/recipes-connectivity/bcm43xx-utils/bcm43xx-utils/imx93-var-som/variscite-bt variscite-bt] Systemd service is disabled or SOM without "WBD" and "WB"
| 1.8V Signal level, used on SOM for Bluetooth interface and can be accessible only if the [{{#var:META_VARISCITE_GIT_HTTP}}/blob/{{#var:META_VARISCITE_BRANCH}}/recipes-connectivity/bcm43xx-utils/bcm43xx-utils/imx93-var-som/variscite-bt variscite-bt] Systemd service is disabled or SOM without "WBD" and "WB"
|-
|-
Line 42: Line 49:
| lpuart6
| lpuart6
| Connected to Symphony board J18.7 and J18.9
| Connected to Symphony board J18.7 and J18.9
| Connected to DT8MCustomboard J12.4 and J12.6
|-
|-
| UART6
| UART6
Line 47: Line 55:
| lpuart7
| lpuart7
| Connected to Symphony board J18.3 and J18.5
| Connected to Symphony board J18.3 and J18.5
| Connected to DT8MCustomboard J12.11 and J12.13
|-
|-
| UART7
| UART7
| /dev/ttyLP7
| /dev/ttyLP7
| lpuart8
| lpuart8
| Disabled by default, see datasheet
| Disabled by default, see datasheet
| Disabled by default, see datasheet
|}
|}


= Testing UART5 =
= Testing UART5 =
The following demonstrates how to test UART5 on the VAR-SOM-MX93 Symphony board. The same process applies to the DT8MCustomboard following the table above.


Short J18.7 and J18.9 pins and run the following commands:
Short J18.7 and J18.9 pins and run the following commands:
Line 64: Line 76:


For each invocation of echo command the "hello" string should appear on the terminal.
For each invocation of echo command the "hello" string should appear on the terminal.


= Testing UART6 =
= Testing UART6 =
The following demonstrates how to test UART6 on the VAR-SOM-MX93 / Symphony board. The same process applies to the DT8MCustomboard following the table above.


Short J18.3 and J18.5 pins and run the following commands:
Short J18.3 and J18.5 pins and run the following commands:
Line 78: Line 93:
= Disabling UART5 =
= Disabling UART5 =


To disable UART5 edit arch/arm64/boot/dts/freescale/{{#var:DEFAULT_DTS}} under kernel source directory and modify
To disable UART5 edit arch/arm64/boot/dts/freescale/{{#var:DEFAULT_DTS}} or arch/arm64/boot/dts/freescale/imx93-var-dart-dt8mcustomboard.dts under kernel source directory and modify


<pre>
<pre>

Revision as of 19:19, 10 May 2024

Warning: This page is designed to be used with a 'release' URL parameter.

This page is using the default release mx93-yocto-kirkstone-5.15.71_2.2.0-v1.0.
To view this page for a specific Variscite SoM and software release, please follow these steps:

  1. Visit variwiki.com
  2. Select your SoM
  3. Select the software release
VAR-SOM-MX93 UART

UART Overview

UART Overview - VAR-SOM-MX93

The VAR-SOM-MX93 and DART-MX93 expose up to seven LPUART interfaces, some of which are multiplexed with other peripherals.

Serial Port Device Node Device Tree VAR-SOM-MX93 / Symphony Board DART-MX93 / DT8MCustomBoard
UART0 /dev/ttyLP0 lpuart1 Symphony board serial console DT8MCustomboard serial console
UART2 /dev/ttyLP2 lpuart3 Disabled by default, see datasheet Disabled by default, see datasheet
UART3 /dev/ttyLP3 lpuart4 Disabled by default, see datasheet Disabled by default, see datasheet
UART4 /dev/ttyLP4 lpuart5 1.8V Signal level, used on SOM for Bluetooth interface and can be accessible only if the variscite-bt Systemd service is disabled or SOM without "WBD" and "WB" 1.8V Signal level, used on SOM for Bluetooth interface and can be accessible only if the variscite-bt Systemd service is disabled or SOM without "WBD" and "WB"
UART5 /dev/ttyLP5 lpuart6 Connected to Symphony board J18.7 and J18.9 Connected to DT8MCustomboard J12.4 and J12.6
UART6 /dev/ttyLP6 lpuart7 Connected to Symphony board J18.3 and J18.5 Connected to DT8MCustomboard J12.11 and J12.13
UART7 /dev/ttyLP7 lpuart8 Disabled by default, see datasheet Disabled by default, see datasheet

Testing UART5

The following demonstrates how to test UART5 on the VAR-SOM-MX93 Symphony board. The same process applies to the DT8MCustomboard following the table above.

Short J18.7 and J18.9 pins and run the following commands:

# stty -F /dev/ttyLP5 -echo -onlcr 115200
# cat /dev/ttyLP5 &
# echo hello > /dev/ttyLP5

For each invocation of echo command the "hello" string should appear on the terminal.


Testing UART6

The following demonstrates how to test UART6 on the VAR-SOM-MX93 / Symphony board. The same process applies to the DT8MCustomboard following the table above.

Short J18.3 and J18.5 pins and run the following commands:

# stty -F /dev/ttyLP6 -echo -onlcr 115200
# cat /dev/ttyLP6 &
# echo hello > /dev/ttyLP6

For each invocation of echo command the "hello" string should appear on the terminal.

Disabling UART5

To disable UART5 edit arch/arm64/boot/dts/freescale/imx93-var-som-symphony.dts or arch/arm64/boot/dts/freescale/imx93-var-dart-dt8mcustomboard.dts under kernel source directory and modify

&lpuart6 {
        ...
        status = "okay";
};

to

&lpuart6 {
        ...
        status = "disabled";
};

Other UARTs can be disabled in a similar manner by referencing the table above.

Configuring RS485 Half-Duplex

The i.MX93 supports controlling an rs485 transceiver driver enable using RTS_B. For more details, please refer to 63.3.4.4 Transceiver driver enable using RTS_B of the i.MX 93 Applications Processor Reference Manual.

RS485 is enabled in software by:

  1. Enabling the RTS pin in the device tree.
  2. Enabling RS485 in the serial driver.

The example below demonstrates how to do this on the VAR-SOM-MX93 using /dev/ttyLP6 on J18.3 (TX), J18.4 (RX) and J17.8 (RTS).

First, disable the ov5640_mipi0 which uses the RTS pin:

&ov5640_mipi0 {
	status = "disabled";
};

Then, configure the RTS pinmux in pinctrl_uart7:

 	pinctrl_uart7: uart7grp {
		fsl,pins = <
			...
			MX93_PAD_GPIO_IO11__LPUART7_RTS_B		0x31e
			...
		>;
	};

After booting the updated device tree, use the following python script to test RS485:

import sys
import serial
import serial.rs485
import time

def configure_rs485(port, data):
    try:
        # Open the serial port
        ser = serial.Serial(port, baudrate=9600)

        # Configure RS485
        ser.rs485_mode = serial.rs485.RS485Settings(
            delay_before_tx=0,
            delay_before_rx=0,
            rts_level_for_tx=False,  # RTS is low during transmission
            rts_level_for_rx=True,   # RTS is high during reception
            loopback=False
        )

        # Write data to the port three times with a delay of 10ms between each
        for _ in range(3):
            ser.write(data.encode())
            time.sleep(0.01)  # 10ms delay

        # Close the serial port
        ser.close()

        print("Data sent successfully.")

    except Exception as e:
        print(f"Error: {str(e)}")

if __name__ == "__main__":
    if len(sys.argv) != 3:
        print("Usage: python3 rs485.py <port> <data>")
    else:
        port = sys.argv[1]
        data = sys.argv[2]
        configure_rs485(port, data)

Finally, install pyserial and run the script:

root@imx93-var-som:~# pip3 install pyserial
root@imx93-var-som:~# python3 rs485.py /dev/ttyLP6 "hello"

The following image was captured on a logic analyzer using this example:

Rs485-mx93.png