IMX93 TEVS Camera Usage Guide
  • 08 Oct 2024
  • 2 Minutes to read
  • Dark
    Light
  • PDF

IMX93 TEVS Camera Usage Guide

  • Dark
    Light
  • PDF

Article summary

Introduction

This article guides you how to get started using TechNexion camera modules on EDM-IMX93 and AXON-IMX93 Board.

Background knowledge needed

You must have the background knowledge to modify the kernel configuration, rebuild, and replace the kernel and the device tree source (DTS).

EDM-WB for example

This article will using EDM-WB baseboard for example. The operation of AXON-WB baseboard is almost the same.

Supported Camera Modules

Camera Series

Products

TEVS

TEVS-AR0144-C
TEVS-AR0145-M
TEVS-AR0234-C
TEVS-AR0521-C
TEVS-AR0522-C
TEVS-AR0522-M
TEVS-AR0821-C
TEVS-AR1335-C

VLS3

VLS3-AR0144-C
VLS3-AR0145-M
VLS3-AR0234-C
VLS3-AR0521-C
VLS3-AR0522-C
VLS3-AR0522-M
VLS3-AR0821-C
VLS3-AR1335-C

Supported EDM Boards

SoM

Board

EDM-IMX93

EDM-WB

AXON-IMX93

AXON-WB


Overview


Connect debug console, power and camera to board

  1. Prepare DC 5V/12V power cable to plug in. If using vizionlink must have DC 12V/minimum 3A power adapter by barrel jack connector.
    (Note:  EDM-WB 5V powered by USB Type C)
    image.png

  2. Prepare UART cable connect to debug console of EDM-WB.

  3. There is a MIPI-CSI-2 connector we refer to CSI1. These are 70-pin board-to-board connectors from Hirose. Below is a picture of TEVS camera with CSI1 connector shown.
    edm-wb.jpg


Prepare Yocto demo image for testing TechNexion camera

The demo image contains the required device tree blobs and camera drivers to enable TechNexion cameras.
Prebuilt demo images can be available for download via TechNexion's server.

Image Download Link:
Supported Release List

You can find the prebuilt images page in Release Notes, take YP4.2 2024Q3 for example :
image.png

Flash image to e.MMC or SD Card.

  • Using 'uuu' to flash
    UUU

boot mode

Ensure the boot mode is configured as serial download mode.

  • Using u-boot's 'ums' Command to Write Flash Storage over USB-OTG
    UMS

u-boot

The board must also boot from either e.MMC with a version of U-boot that has the ums command enabled.


Build Yocto

Supported TechNexion Linux kernel branch for TechNexion camera modules.

Linux Kernel

branch

6.1.55

tn-imx_6.1.55_2.2.0-stable

Fetch Yocto source
Build Yocto (EDM-IMX93)
Build Yocto (AXON-IMX93)


Instructions for testing camera

Specify camera DTBO in u-boot

Auto detect camera

If you are using TEVS cameras, you can skip this section because it have auto detect camera function in u-boot.

  1. Connect debug console cable to baseboard.

  2. Power on board , and enter u-boot prompt mode.
    (keep hit enter when the "Hit any key to stop autoboot : " is shown.)

  3. Specify camera dtb via 'dtoverlay' u-boot environment variable.
    for TEVS cameras:

    u-boot=> setenv dtoverlay tevs

    for VLS3 cameras:

    u-boot=> setenv dtoverlay vls
  4. Continue boot process.

    u-boot=> saveenv
    u-boot=> boot

LCD display

Don't forget the append LCD overlay if the baseboard has LCD connections.

Start camera video stream via gstreamer

We can check whether camera have been link via v4l2 control command:

$ v4l2-ctl --list-device

Get the device number of camera capture device. As example we have camera on CSI1, that we can see /dev/video0 specify the capture device.

FSL Capture Media Device (platform:42800000.bus:camera):
        /dev/media0

mxc-isi-cap (platform:4ae40000.isi:cap_devic):
        /dev/video0

Specify the capture device you just get and start gstreamer to get video stream on screen:

$ gst-launch-1.0 v4l2src device=/dev/video0 ! video/x-raw, width=<res_w>,height=<res_h> ! videoconvert ! waylandsink sync=false

videoconvert

It not necessary to use or using videoconvert. Because IMX93 have ISI to convert format.


Trouble shooting

Ensure camera device tree blob overlay(DTBO) is specified correctly in u-boot.
For TEVS cameras:

u-boot=> printenv dtoverlay
dtoverlay=tevs

For VLS cameras:

u-boot=> printenv dtoverlay
dtoverlay=vls

We can check whether camera have been initialized correctly.
For TEVS cameras:

$ dmesg -t | grep tevs
tevs 1-0048: tevs_probe() device node: tevs@48
tevs 1-0048: Version:24.9.0.1
tevs 1-0048: Product:TEVS-AR0144, HeaderVer:3, MIPI_Rate:800
tevs 1-0048: probe success
mx8-img-md: Registered sensor subdevice: tevs 1-0048 (1)
mx8-img-md: created link [tevs 1-0048] => [mxc-mipi-csi2.0]

Ensure camera device tree blob(DTB) is specified correctly.

$ dmesg -t | grep -i model
Machine model: TechNexion EDM-IMX93 and WB baseboard


Was this article helpful?