Introduction

...

Image Removed

...

Introduction

The Xilinx UHD SDI Rx Subsystem consists of UHD SDI Rx IP core, an SDI to native video bridge followed by a Native to AXI-4 S bridge. It is capable of detecting the SD, HD, 3GA, 3GB, 6G and 12G (upto 8 data streams) type SDI streams. The maximum resolution it supports is 4096x2160p60 in 12G mode. The SDI Rx IP allows the configuration of the modes to be detected at run time or a fixed mode. It also allows the Framer to be enabled. A video lock event is generated when the incoming SDI mode and transport stream is detected and is stable for a configurable number of video clocks as programmed in the Video Lockout Window. When the input video stream is stopped or the type changed, a video unlock event is generated. The IP gives out the CRC and EDH error status. When the bridges are enabled, then the AXI-4 Stream of YUV 422 10 bit per component and 2 pixels per clock is sent out.

Image Added

The SDI Rx Subsystem driver (xilinx-sdirxss.c) is based on the V4L2 framework.
It creates a subdev node(/dev/v4l-subdev*) which can be used to query and configure the UHD SDI Rx Subsystem IP.
The SDI Rx IP would be the first node in the video capture pipeline.
It exposes various V4L controls which can be used to configure the subsystem like auto detection of SDI modes, Framer enable, etc and query the status like CRC status, EDH errors, etc.
It also exposes certain V4L events like video unlock, bridge overflow/underflow, video source change, etc which can be used by application to trigger certain actions.
The general description of V4L2 framework is documented here, v4l2-framework.txt.

IP/Driver Features

IP feature	2018.1 on wards	2019.2	2020.1	2020.2
IP version	2.0
Supports AXI4-Stream, native video and native SDI user interfaces	Supports only AXI4-Stream output interface
Support for 2 pixel per sample	Yes
10-bit per color component	Yes		Added support for 12 bit
Supports YUV 4:2:2 and YUV 4:2:0 color space	Yes	Added support for YUV444 in IP. Driver doesn't support	Supports YUV 420 / 422 / 444 and RGB
HFR (High Frame Rate) Support 96/1.001, 96, 100, 120/1.001 and 120 Hz	NA		Not supported in driver	Supported
AXI4-Lite interface for register access to configure different subsystem options	Yes
Audio support	Separate driver
Standards compliance SMPTE ST 259: SD-SDI at 270 Mb/s. SMPTE RP 165: EDH for SD-SDI. SMPTE ST 292: HD-SDI at 1.485 Gb/s and 1.485/1.001 Gb/s. SMPTE ST 372: Dual Link HD-SDI. SMPTE ST 424: 3G-SDI with data mapped by any ST 425-x mapping at 2.97 Gb/s and 2.97/1.001 Gb/s. SMPTE ST 2081-1: 6G-SDI with data mapped by any ST 2081-x mapping at 5.94 Gb/s and 5.94/1.001 Gb/s. SMPTE ST 2082-1: 12G-SDI with data mapped by any ST 2082-x mapping at 11.88 Gb/s and 11.88/1.001 Gb/s. Dual link and quad link 6G-SDI and 12G-SDI are supported by instantiating two or four UHD-SDI Receiver subsystems. SMPTE ST 352: Payload ID packets are fully supported.	Yes*
HLG support	N.A			Supported

Other driver features supported are -

Detect SD, HD, 3GA/3GB, 6G, 12G (upto 8 Data Streams)
Auto detect multiple modes OR Fixed Mode detection
Framer enable/disable
Programmable Video Lock Window
EDH & CRC error counters
Video Lock, Unlock, Bridge Over/UnderFlow interrupts
Separate bits to control SDI to Native and Native to AXI4-S bridge
ST352 Payload
Mode and Transport type detection
- Fractional / Integral Frame rate
- Interlaced / Progressive Transport
- Family detection

Missing Features / Known Issues / Limitations in Driver

In case of a HD stream without payload, a progressive segmented frame (pSF) will be reported incorrectly as Interlaced as the driver relies on the IP's transport scan locked bit.
*Multiple instances capability not tested
*Tested with only 12G 8DS configuration
HD 1280x720p24 and HD 1280x720p23.98 - Incorrect colors are captured
In some 3GB 1080 modes, the colors in color bars are swapped.
Tested with Phabrix SDI generator and Omnitek Ultra4K
Doesn't support to YUV444 in 2019.2

Kernel Configuration

CONFIG_VIDEO_XILINX_SDIRXSS and CONFIG_VIDEO_XILINX should be enabled.

Device Tree Binding

The dts node should be defined with correct hardware configuration. How to define the node is documented in xlnx,sdirxss.txt

Test Procedure

The driver has been tested using the YAVTA tool.

Certain parameters like Framer enable, Video lockout window, etc can be configured using the YAVTA tool as follows -
For example, to list all the controls and current values

Code Block

theme	Midnight

yavta -l /dev/v4l-subdev0

#Below is sample output when video is not locked and not streaming
root@zcu106-zynqmp:~# yavta -l /dev/v4l-subdev0
Device /dev/v4l-subdev0 
#Below is sample output when video is not locked and not streaming
root@zcu106-zynqmp:~# yavta -l /dev/v4l-subdev0
Device /dev/v4l-subdev0 opened.
--- User Controls (class 0x00980001) ---
control 0x0098ca01opened.
--- User Controls (class 0x00980001) ---
control 0x0098ca01 `SDI Rx : Enable Framer' min 0 max 1 step 1 default 1 current 1.
control 0x0098ca02 `SDI Rx : Video Lock Window' min 0 max -1 step 1 default 12288 current 12288.
control 0x0098ca03 `SDI Rx : Enable FramerEDH Error Count Enable' min 0 max 165535 step 10 default 10 current 10.
control 0x0098ca020x0098ca04 `SDI Rx : VideoModes Locksearch WindowMask' min 0 max -163 step 10 default 1228863 current 1228863.
unable to get control 0x0098ca05: Invalid argument (22).
control 0x0098ca030x0098ca05 `SDI Rx : EDHMode ErrorDetect Count EnableStatus' min 0 max 655355 step 01 default 0 current 0n/a.
control 0x0098ca040x0098ca06 `SDI Rx : ModesCRC searchError Maskstatus' min 0 max 63-1 step 01 default 630 current 630.
unable to get control 0x0098ca050x0098ca07: Invalid argument (22).
control 0x0098ca050x0098ca07 `SDI Rx : ModeEDH DetectError StatusCount' min 0 max 565535 step 1 default 0 current n/a.
control 0x0098ca06unable to get control 0x0098ca08: Invalid argument (22).
control 0x0098ca08 `SDI Rx : CRCEDH Error statusStatus' min 0 max -1 step 1 default 0 current 0n/a.
unable to get control 0x0098ca070x0098ca09: Invalid argument (22).
control 0x0098ca070x0098ca09 `SDI Rx : EDHTS Erroris CountInterlaced' min 0 max 655351 step 1 default 0 current n/a.
unable to get control 0x0098ca080x0098ca0a: Invalid argument (22).
control 0x0098ca080x0098ca0a `SDI Rx : EDHActive StatusStreams' min 01 max -116 step 1 default 01 current n/a.
unable to get control 0x0098ca090x0098ca0b: Invalid argument (22).
control 0x0098ca090x0098ca0b `SDI Rx : TSIs is Interlaced3GB' min 0 max 1 step 1 default 0 current n/a.
unable11 controls found.
Unable to get control 0x0098ca0a: Invalid argument (22).
control 0x0098ca0a `SDI Rx : Active Streams' min 1 max 16 step 1 default 1 current n/a.
unable to get control 0x0098ca0b: Invalid argument (22).
control 0x0098ca0b `SDI Rx : Is 3GB' min 0 max 1 step 1 default 0 current n/a.
11 controls found.
Unable to get format: Inappropriate ioctl for device (25).

The SDI Rx subsystem locks on to the incoming video stream.
Using VIDIOC_SUBDEV_G_FMT ioctl, the width, height and field type (interlaced or progressive) can be determined.

The resolution info can be sent across to video capture application like YAVTA to capture the stream frames into the DDR using a simple design
SDI Rx SS ==> VDMA S2MM OR Framebuffer Write ==> Memory

...

Code Block

theme	Midnight

yavta -n 3 -c10 -f YUYV -s 1920x1080 --skip 7 -F /dev/video0

...

Debug capability

...

Some tips to help you debug are as below -

The SDI source connected to SDI Rx port and should be running.
The driver should have been loaded successfully during kernel bootup.

Running media-ctl should show resolution.

E.g. “media-ctl –d /dev/media0 –p”

Always check if the lock has occurred or not.
If the lock is occurred, is the current mode (SD, HD, 3GA, 3GB, 6G, 12GI or 12GF) same as source?
What is the ST352 payload in RX_ST352_DATA_DS1 register? Decode it to get resolution and size and color format.
- Refer to driver code how to decode.
Compact GT Reset - There are 2 signals connected to compact_gt which need to be toggled to have a clean reset of the GT.
1. The SI5324_LOL should be toggled to high and then made low. (Default low)
2. The fmc_init_done line should be toggled to low and then high (Default high).
3. Image RemovedImage Removed

FAQ

Q1 - While running yavta for resolution AxB with our source box, we see "Unable to start streaming: Invalid argument (22)." Why is this happening?

Ans - One possible reason is that the resolution that the SDI source is generating and what is being passed to yavta don't match.

Run media-ctl to find out the resolution currently being identified by the SDI Rx IP driver.

Read your SDI source documentation to know how to manipulate the resolutions.

Q2 - The frame rate reported by yavta is significantly lesser than expected.

Ans - Depending on your design and system load, there may be a case where there may be frame drops.

But double check the ST352 payload in SDI Rx to verify if the SDI source connected is correctly generating the required frame rate (fps).

You may have to refer to PG205 to decode the RX FAMILY to get the resolution and RX Frame Rate (in case of zero payload in 2017.3/4)

Family Detection

rx_t_familyTransport Video FormatActive Pixels0000SMPTE ST 2751920 x 10800001SMPTE ST 2961280 x 7200010SMPTE ST 2048-22048x10800011SMPTE ST 2951920 x 10801000NTSC720 x 4861001PAL720 x 5761111UnknownOthersReserved

Frame Rate

rx_t_rateFrame Rate0000None001023.98 Hz001124 Hz010047.95 Hz010125 Hz011029.97 Hz011130 Hz100048 Hz100150 Hz101059.94 Hz101160 HzOthersReserved

Q3 - After boot up, even though there is valid SDI source connected, the IP is unable to detect the source and video is not locked. Why could this happen?

Ans - Check if the IP's registers are not default values after kernel boots up. E.g. MODULE_CTRL register should be 0x3F30. If the registers are in default state, it may mean the clocking to the IP is not correct. Please check device tree to set the correct clock source.

Boards Supported

Driver has been tested on the following boards

ZCU106 1.0

Known Issues

AR68766 - SMPTE UHD-SDI RX Subsystem - Release Notes and Known Issues for the Vivado 2017.3 tool and later versions

Change log

format: Inappropriate ioctl for device (25).

The SDI Rx subsystem locks on to the incoming video stream.
Using VIDIOC_SUBDEV_G_FMT ioctl, the width, height and field type (interlaced or progressive) can be determined.

The resolution info can be sent across to video capture application like YAVTA to capture the stream frames into the DDR using a simple design
SDI Rx SS ==> VDMA S2MM OR Framebuffer Write ==> Memory

For example, to capture a 1920x1080 stream the following command is used

Code Block

theme	Midnight

yavta -n 3 -c10 -f YUYV -s 1920x1080 --skip 7 -F /dev/video0

The captured .bin files can then be viewed in yuvplayer.exe application.

Debug capability

The driver debug messages can be enabled by adding "#define DEBUG" at the top of the file.
All debug prints are sent to serial console and can be viewed in kernel dmesg buffer.

Some tips to help you debug are as below -

The SDI source connected to SDI Rx port and should be running.
The driver should have been loaded successfully during kernel bootup.

Running media-ctl should show resolution.

E.g. “media-ctl –d /dev/media0 –p”

Always check if the lock has occurred or not.
If the lock is occurred, is the current mode (SD, HD, 3GA, 3GB, 6G, 12GI or 12GF) same as source?
What is the ST352 payload in RX_ST352_DATA_DS1 register? Decode it to get resolution and size and color format.
- Refer to driver code how to decode.
Compact GT Reset - There are 2 signals connected to compact_gt which need to be toggled to have a clean reset of the GT.
1. The SI5324_LOL should be toggled to high and then made low. (Default low)
2. The fmc_init_done line should be toggled to low and then high (Default high).
3. Image AddedImage Added