Kria™ KV260 Vision AI Starter Kit
Smart Camera Tutorial

Debugging

Debugging

Debugging Tips

  • Use the following command to load the firmware. If you do not, many drivers (including the MIPI and VCU) will not load, and when you run the application, you will have errors.

    xmutil      loadapp kv260-smartcam

  • The smartcam application has an option --usb to choose the USB media devices. You can list the media devices by

    ls /dev/media*

  • When you give the wrong media index, the application will give errors (for example):

    • ERROR: Device x is not ready.

    • ERROR: MIPI device x is not ready.

    • ERROR: Device x is not USB cam.

  • When you give a width/height not supported by the device, the application shows this error:

    Error: USB camera doesn’t support resolution xxx

    All supported resolution:

    Choose from the supported resolutions.

Platform Peripheral Debug Tips

Monitor

Click here to view the details.

Use certified cables for DP and HDMI. The recommended specifications are listed for HDMI 2.0 and or higher and DP 1.2. If the cables are faulty, they could cause distortions or disable the display.

Modetest is a test tool that is part of the libdrm suite of test tools.

Note: The following print is an example from a 4k monitor. Use this for reference only.

Status of Monitor

modetest -M xlnx

This command reads the monitors EDID information to ensure the monitor is connected:

Connectors:
id      encoder status          name            size (mm)       modes   encoders
43      42      connected       DP-1            610x350         43      42

Display Modes Supported by Your Display

modetest -M xlnx

The following modes are supported by your display.

  modes:
        name refresh (Hz) hdisp hss hse htot vdisp vss vse vtot)
  3840x2160 30.00 3840 4016 4104 4400 2160 2168 2178 2250 297000 flags: phsync, pvsync; type: driver
  3840x2160 30.00 3840 4016 4104 4400 2160 2168 2178 2250 297000 flags: phsync, pvsync; type: driver
  ...
  ...

Ensure display is capable of supporting user requested resolution and refresh rates to the application.

Current Mode

modetest -M xlnx

CRTC indicates the current mode that is set.

CRTCs:
id      fb      pos     size
41      47      (0,0)   (3840x2160)
  3840x2160 30.00 3840 4016 4104 4400 2160 2168 2178 2250 297000 flags: phsync, pvsync; type: driver
  props:

Test to Determine if the Display is OK

modetest -M xlnx -s 43:1920x1080-60@AR24

This command sets a mode, SMPTE color bars appear on the display.

SMPTE color bars

I2S Audio

Click here to view the details. #### Determine the Enumeration for an I2S Audio Card
cat /proc/asound/cards

 2 [xlnxi2ssndcard0]: xlnx-i2s-snd-ca - xlnx-i2s-snd-card-0
                      xlnx-i2s-snd-card-0

In the previous example, the enumeration of I2S audio card is 2.

Determine Capture and Playback Device Number

cat /proc/asound/devices
 80: [ 2- 0]: digital audio playback
 89: [ 2- 1]: digital audio capture

In this example, [2- X]: the 2- is the card and the X is the device.

Sample Record and Playback

  1. dnf install alsa-utils.aarch64

  2. Ensure an active source is connected at the Pmod LINE IN.

Sample Record

aplay -D hw:2,0 -fS24_LE -r 48000 -c 2  -d 30 -t raw file.raw

Sample Playback

arecord -D hw:2,1  -fS24_LE -r 48000 -c 2  -d 30 -t raw file.raw

Sample Pass-through

arecord -D hw:2,1 -f S24_LE -r 48000 -c 2 -t raw | aplay -D hw:2,0 -c 2 -f S24_LE -r 48000 -t raw

Detect USB 3.0

Click here to view the details.
lsusb

Bus 002 Device 003: ID 046d:085e Logitech, Inc. USB5744
Bus 002 Device 002: ID 0424:5744 Standard Microsystems Corp. USB5744
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub

Obtain Media device information

Click here to view the details.
ls /dev/media*

Lists all media enumerations:

media-ctl -d /dev/mediaX -p

Where the X in media is the enumerated value. This command prints the device topology and helps you identify the media device.

Example for capture path of ar1335 sensor.

media-ctl -d /dev/media1 -p

Media controller API version 5.4.0

Media device information
------------------------
driver          xilinx-video
model           Xilinx Video Composite Device
serial
bus info
hw revision     0x0
driver version  5.4.0

Device topology
- entity 1: isp_vcap_csi output 0 (1 pad, 1 link)
            type Node subtype V4L flags 0
            device node name /dev/video2
        pad0: Sink
                <- "80000000.csiss":0 [ENABLED]

- entity 5: 80000000.csiss (2 pads, 2 links)
            type V4L2 subdev subtype Unknown flags 0
            device node name /dev/v4l-subdev0
        pad0: Source
                [fmt:VYYUYY8_1X24/1920x1080 field:none colorspace:srgb]
                -> "isp_vcap_csi output 0":0 [ENABLED]
        pad1: Sink
                [fmt:VYYUYY8_1X24/1920x1080 field:none colorspace:srgb]
                <- "ap1302.4-003c":2 [ENABLED]

- entity 8: ap1302.4-003c (3 pads, 2 links)
            type V4L2 subdev subtype Unknown flags 0
            device node name /dev/v4l-subdev2
        pad0: Sink
                [fmt:SGRBG10_1X10/4208x3120 field:none colorspace:srgb
                 crop.bounds:(0,0)/4208x3120
                 crop:(0,0)/4208x3120]
                <- "ar1335 0":0 [ENABLED,IMMUTABLE]
        pad1: Sink
                [fmt:SGRBG10_1X10/4208x3120 field:none colorspace:srgb
                 crop.bounds:(0,0)/4208x3120
                 crop:(0,0)/4208x3120]
        pad2: Source
                [fmt:UYVY8_1X16/4208x3120 field:none colorspace:srgb
                 crop.bounds:(0,0)/4208x3120
                 crop:(0,0)/4208x3120]
                -> "80000000.csiss":1 [ENABLED]

- entity 12: ar1335 0 (1 pad, 1 link)
             type V4L2 subdev subtype Sensor flags 0
             device node name /dev/v4l-subdev1
        pad0: Source
                [fmt:SGRBG10_1X10/4208x3120 field:none colorspace:srgb]
                -> "ap1302.4-003c":0 [ENABLED,IMMUTABLE]