VAR-SOM-MX7 UART: Difference between revisions

From Variscite Wiki
(Created page with "{{PageHeader|VAR-SOM-MX7 - External UART}} {{DocImage|category1=VAR-SOM-MX7|category2=Yocto}} __toc__ = Test = By default, Variscite has configured UART2 (/dev/ttymxc1) in the...")
 
No edit summary
Line 1: Line 1:
{{PageHeader|VAR-SOM-MX7 - External UART}} {{DocImage|category1=VAR-SOM-MX7|category2=Yocto}} __toc__
<!-- Set release according to "release" parameter in URL and use RELEASE_SUMO_V1.0_DART-MX8M as default
= Test =
--> {{#vardefine:RELEASE_PARAM|{{#urlget:release|RELEASE_SUMO_V1.0_DART-MX8M}}}} <!--
By default, Variscite has configured UART2 (/dev/ttymxc1) in the device tree.<br>
--> {{#lst:Yocto_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
<br>
--> {{#lst:B2QT_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
To test:<br>
--> {{#lst:Android_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
Use minicom to connect.<br>
--> {{PageHeader|{{#var:HARDWARE_NAME}} UART}} {{DocImage|category1=Yocto|category2=Android}}[[Category:Debian]][[Category:{{#var:HARDWARE_NAME}}]] __toc__
Set the serial to ttymxc1.<br>
 
You can use a loopback or connect to another computer.<br>
= UART Overview =
The pins are coming out from the J5 connector.<br>
 
On '''VAR-SOM-MX7''', UARTS 1-3 are enabled by default.<br>
UART1 is connected to debug console.<br>
UART2 is connected to J5 header on VAR-MX7CustomBoard.<br>
UART3 is connected to Bluetooth module. On SoMs without WIFI/BT module UART3 is also connected to J13.
 
= UART naming under Linux =
The Linux devices cooresponding to UART1-UART3 are /dev/ttymxc0 - /dev/ttymxc2 respectively.
 
= Testing UART2 on VAR-SOM-MX7 =
Short J5.5 with J5.7 and J5.6 with J5.8, then run the following commands:
stty -F /dev/ttymxc1 -echo -onlcr 115200 crtscts
cat /dev/ttymxc1 &
echo hello > /dev/ttymxc1
For each time you run this echo command the "hello" string should appear on the terminal.
 
= Configuring RS485 Half-Duplex =
{{#lst:Yocto_Platform_Customization|RS485_HALF_DUPLEX}}

Revision as of 20:45, 14 July 2021

DART-MX8M UART

UART Overview

On VAR-SOM-MX7, UARTS 1-3 are enabled by default.
UART1 is connected to debug console.
UART2 is connected to J5 header on VAR-MX7CustomBoard.
UART3 is connected to Bluetooth module. On SoMs without WIFI/BT module UART3 is also connected to J13.

UART naming under Linux

The Linux devices cooresponding to UART1-UART3 are /dev/ttymxc0 - /dev/ttymxc2 respectively.

Testing UART2 on VAR-SOM-MX7

Short J5.5 with J5.7 and J5.6 with J5.8, then run the following commands:

stty -F /dev/ttymxc1 -echo -onlcr 115200 crtscts
cat /dev/ttymxc1 &
echo hello > /dev/ttymxc1

For each time you run this echo command the "hello" string should appear on the terminal.

Configuring RS485 Half-Duplex

Each UART can be configured for RS485 Half-Duplex mode by using a GPIO pin to drive the receive and transmit enable inputs. This can be configured in the device tree by making the following changes to the uart node and replacing X, Y & Z with the proper values:

&uartX {                                                          /* Add RS485 properties to uartX */
	pinctrl-names = "default";
	pinctrl-0 = <&pinctrl_uartX>, <&pinctrl_uartX_rs485>;     /* Add RS485 GPIO pinctrl */
	rts-gpios = <&gpioY Z GPIO_ACTIVE_LOW>;                   /* Add rts-gpios property */
	linux,rs485-enabled-at-boot-time;                         /* Enable RS485 at boot time to skip using TIOCSRS485 ioctl */
	status = "okay";
};

Next, configure the RS485 GPIO pin by adding pinctrl_uartX_rs485 to iomuxc. Replace X, GPIO_PIN_FUNCTION, and GPIO_PIN_SETTINGS with the proper values:

&iomuxc {
	pinctrl_uartX_rs485: uartXrs485 {
		fsl,pins = <
			GPIO_PIN_FUNCTION  GPIO_PIN_SETTINGS
		>;
	};
};

Note: For more information about configuring pins, please see i.MX Device Tree Pinmux Settings Guide


After making these changes, RS485 mode will be enabled by default and can be verified from the console by running the commands below. Replace N with the proper value, which is typically X-1 relative to the device tree node uartX:

# stty -F /dev/ttymxcN -echo -onlcr 115200
# echo hello > /dev/ttymxcN

The below logic analyzer capture shows the RS485 RX/TX enable line toggling when writing to the UART:

Rs485.png


Please refer to the Linux device tree bindings for more RS485 configuration options.