UCM-iMX93: Yocto Linux: How-To Guide - Revision history

Igor at 15:21, 7 September 2025

2025-09-07T15:21:42Z

Igor at 13:09, 16 February 2025

2025-02-16T13:09:36Z

Igor at 14:19, 3 February 2025

2025-02-03T14:19:17Z

Igor at 14:11, 18 August 2024

2024-08-18T14:11:04Z

Igor at 10:33, 8 July 2024

2024-07-08T10:33:26Z

Show changes

Igor: /* Cellular Modem */

2024-02-14T13:23:05Z

‎Cellular Modem

Igor at 13:14, 19 December 2023

2023-12-19T13:14:24Z

Igor at 13:03, 30 November 2023

2023-11-30T13:03:06Z

Igor: /* Camera */

2023-10-22T11:24:20Z

‎Camera

Igor: /* GPIO */

2023-10-08T11:35:26Z

‎GPIO

@@ Line 565: / Line 565: @@
 {| class="wikitable" style="text-align:left;"
 |-
 | align="center" | '''Signal Name
-| align="center" | '''On SB-UCMIMX93'''
+| align="center" | '''Pin on SB-UCMIMX93'''
 |-
 | align="center" |GPIO_IO04
 | align="center" |P3-20
 |-
 | align="center" |GPIO_IO05
 | align="center" |P3-18
 |-
 | align="center" |GPIO_IO07
 | align="center" |P3-6
 |-
 | align="center" |GPIO_IO14
 | align="center" |P5-4
 |-
 | align="center" |GPIO_IO15
 | align="center" |P5-2
 |-
 | align="center" |GPIO_IO16
 | align="center" |P3-4
 |-
 |}
-==Example: controlling pin GPIO_IO16==
+Other signals that are reserved for peripheral controls can be reassigned to GPIOs in
-'''Exporting the pin in sysfs'''</br>
+ arch/arm64/boot/dts/compulab/ucm-imx93-pinctrl.dtsi
-Create a file system export entry:
-<pre>
+== Example: controlling pin GPIO_IO16==
-cd /sys/class/gpio/
+=== Checking the pin info===
-echo $((32+16)) > export
+ gpioinfo -c 0
-</pre>
+This lists all GPIO lines in `gpiochip0`, including GPIO_IO16 (line offset 16).
-Now pin GPIO_IO16 is assigned to sysfs. You can view the newly created entry in line 16 by running:
-<pre>gpioinfo 0</pre>
+=== Writing to a pin===
 =ADC=
 i.MX93 SoC features integrated 12 bit analog to digital converter.<br>
@@ Line 662: / Line 643: @@
 =Suspend / Resume=
 {{note|The operation below requires '''root''' access.}}
-*UCM-iMX93 features suspend mode, which allows to minimize power consumption.
+*Suspend mode allows minimizing the power consumption.
-*WiFi device currently doesn't support suspension so you should first run:
+*To enter suspend mode run:
   echo mem >/sys/power/state
-*To resume normal operation press shortly the '''ON/OFF''' button [[UCM-iMX93: Evaluation Kit: Hardware Guide#Connector_Locations | '''SW5''']].
+*To resume normal operation press shortly the power button [[UCM-iMX93: Evaluation Kit: Hardware Guide#Connector_Locations | '''SW5''']].
-*To enter temporary sleep run:
+*To enter suspend mode with RTC as wakeup source that wakes after 5 seconds run:
   rtcwake -s 5 -m mem -d /dev/rtc0
 =CPU temperature=

@@ Line 545: / Line 545: @@
   setenv fdtfile ucm-imx93-lpspi.dtb; boot
 SPI signals location:
@@ Line 563: / Line 557: @@
 On the module, run:
-  ./spidev_test -v -D /dev/spidev0.0 -p "hello"
+  spidev_test -v -D /dev/spidev0.0 -p "hello"
 You should see RX same as TX.

@@ Line 290: / Line 290: @@
 == Enable/Disable WiFi Interface ==
 * To enable WiFi interface:
-:<pre>nmcli radio wifi on</pre>
+ nmcli radio wifi on
 * To disable WiFi interface:
-:<pre>nmcli radio wifi off</pre>
+ nmcli radio wifi off
 == Network Scanning ==
 * Sample WiFi scanning:
-:<pre>nmcli dev wifi list</pre>
+ nmcli dev wifi list
 :The output will show the list of Access Points and Ad-Hoc cells in range.
@@ Line 309: / Line 309: @@
 == Creating Access Point ==
-In the following example:
+*Prepare routing:
-* Replace <SSID> and <PASSWORD> with desired access point parameters:
+<pre>
-:<pre>nmcli device wifi hotspot ssid <SSID> password <PASSWORD> con-name HotspotCon</pre>
+iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
 * Disable wireless AP:
-:<pre>nmcli connection down HotspotCon</pre>
+ nmcli connection down HotspotCon
 * Enable wireless AP again:
-:<pre>nmcli connection up HotspotCon</pre>
+ nmcli connection up HotspotCon
 = Bluetooth =
@@ Line 659: / Line 668: @@
 =Suspend / Resume=
 {{note|The operation below requires '''root''' access.}}
+*UCM-iMX93 features suspend mode, which allows to minimize power consumption.
-UCM-iMX93 features suspend mode, which allows to minimize power consumption.
+*WiFi device currently doesn't support suspension so you should first run:
 <pre>
-echo mem >/sys/power/state
+ip link set mlan0 down
 </pre>
+*The following command should be used to enter suspend mode:
-To resume normal operation press shortly the '''ON/OFF''' button [[UCM-iMX93: Evaluation Kit: Hardware Guide#Connector_Locations | '''SW5''']].
+ echo mem >/sys/power/state
 =CPU temperature=

@@ Line 513: / Line 513: @@
 Loopback example:
-In linux kernel, get device tree that contains lpspi3 node configured with a spi device
+In order to enable SPI device, it needs to be added to the device tree in the following manner:
-  git cherry-pick d9b37fd95b7c
- make dtbs O=build
+Set up the kernel source repository by following the instructions in this guide: https://github.com/compulab-yokneam/meta-bsp-imx9/blob/mickledore-6.1.55-2.0/Documentation/linux_kernel_build.md
   ${CROSS_COMPILE}gcc ./tools/spi/spidev_test.c -o ./spidev_test

@@ Line 362: / Line 362: @@
 * Install the modem module into the mini-PCIe socket [[UCM-iMX93: Evaluation Kit: Hardware Guide#Connector_Locations | '''P18''']]
 * Connect a cellular antenna to the main antenna connector on the modem
 * Install an active SIM card into SIM socket [[UCM-iMX93: Evaluation Kit: Hardware Guide#Connector_Locations | '''P20''']]
 Run the following command to verify that the modem is detected correctly:

@@ Line 69: / Line 69: @@
 =Display=
 ==MIPI-DSI==
-The UCM-iMX93 evaluation kit includes the Startec KD050HDFIA 5" MIPI-DSI LCD panel.
+SB-UCMIMX93 supports direct connection with the Startec KD050HDFIA 5" MIPI-DSI LCD panel.
 Connect the MIPI-DSI display to connectors [[UCM-iMX93: Evaluation Kit: Hardware Guide#Connector_Locations | '''P11''' and '''P12''']] on the SB-UCMIMX93 carrier-board.
-The MIPI-DSI display is described in the following device tree include file (included in the default '''ucm-imx93.dtb''' device tree): ''arch/arm64/boot/dts/compulab/ucm-imx93-mipi.dtsi''
+The MIPI-DSI display requires the following device tree: '''ucm-imx93-mipi.dts'''.</br>
 <!--
 descriptors of hw device for the drivers
@@ Line 86: / Line 97: @@
   /sys/class/drm/card0/card0-DSI-1/
 This device node contains information about the display, such as its supported modes and its current configuration.
 ==Display Manager==

@@ Line 107: / Line 107: @@
 Connect the camera to connector [[UCM-iMX93: Evaluation Kit: Hardware Guide#Connector_Locations | '''P9''']] on the SB-UCMIMX93 carrier-board.
-The following device tree file should be used for camera operation: '''ucm-imx93-mipi-csi.dtb'''
+Use device tree file: '''ucm-imx93-mipi-csi.dtb'''
+<!--
 Verify that the '''mxc-isi-cap''' driver is registered correctly:
 <pre>
@@ Line 120: / Line 120: @@
 The camera device tree nodes are described in: ''arch/arm64/boot/dts/compulab/ucm-imx93.dtsi''.</br>
-<!--
 * camera interface: /soc@0/bus@42000000/i2c@42530000/mipi2@42
 * soc camera controller /soc@0/bus@42800000/camera/csi@4ae00000
@@ Line 354: / Line 354: @@
 <pre>
 [Device_Name]# quit
 </pre>
@@ Line 385: / Line 418: @@
 * Short pin P3-1 (UART5-RX) with P3-3 (UART5-TX) on SB-UCMIMX93 to create a loop-back.
 * Run the following commands:
-  # stty -F /dev/ttyLP4 115200
+  stty -F /dev/ttyLP4 1:0:1cb2:0:3:1c:7f:15:4:5:1:0:11:13:1a:0:12:f:17:16:0:0:0:0:0:0:0:0:0:0:0:0:0:0:0:0
-  # cat /dev/ttyLP4 &
+  cat /dev/ttyLP4 &
-  # echo hello > /dev/ttyLP4
+  echo hello > /dev/ttyLP4
 The "hello" string should appear on the terminal.
 <!--
@@ Line 529: / Line 562: @@
 These GPIOs belong to ''gpiochip0'' which numbering space starts at 32. Therefore it is required to add 32 to the GPIO number.</br>
 Other signals that are reserved for peripheral controls can be reassigned to function as GPIOs in ''arch/arm64/boot/dts/compulab/ucm-imx93-pinctrl.dtsi''.
 ==Example: controlling pin GPIO_IO16==
 '''Exporting the pin in sysfs'''</br>
@@ Line 634: / Line 668: @@
 </pre>
-<!--=Device Serial Number=
+= Device Serial Number=
-The product serial number is a unique identifier that is assigned to each device during manufacturing. It can be used to troubleshoot problems.
+Product information is stored in on-board EEPROM.<br>
+* To read the product serial number run:
-To read the product serial number, run:
+  cat /proc/device-tree/product-sn && echo
-  root@ucm-imx93:~# cat /proc/device-tree/serial-number
+* To read the product configuration part number run:
--->
+ cat /proc/device-tree/product-options && echo
 =See Also=

@@ Line 104: / Line 104: @@
 =Camera=
-The UCM-iMX93 evaluation kit supports the e-con e-CAM131_CUMI1335_MOD 13MP 4K camera module.</br>
+The UCM-iMX93 evaluation kit supports the e-con e-CAM131_CURB 13MP 4K camera module.</br>
 Connect the camera to connector [[UCM-iMX93: Evaluation Kit: Hardware Guide#Connector_Locations | '''P9''']] on the SB-UCMIMX93 carrier-board.