admin-guide/media/mgb4.rst

1 .. SPDX-License-Identifier: GPL-2.0
7 ---------------
13 There are two types of parameters - global / PCI card related, found under
23     | 0 - No module present
24     | 1 - FPDL3
25     | 2 - GMSL (one serializer, two daisy chained deserializers)
26     | 3 - GMSL (one serializer, two deserializers)
27     | 4 - GMSL (two deserializers with two daisy chain outputs)
35     | 1 - FPDL3
36     | 2 - GMSL
44         PRODUCT-REVISION-SERIES-SERIAL
48 Common FPDL3/GMSL input parameters
52     Input number ID, zero based.
57     | 0 - single
58     | 1 - dual (default)
63     | 0 - OLDI/JEIDA
64     | 1 - SPWG/VESA (default)
71     A value of 0 is equivalent to the V4L2_IN_ST_NO_SYNC flag of the V4L2
74     | 0 - unlocked
75     | 1 - locked
78     Video stream status. A stream is detected if the link is locked, the input
81     A value of 0 is equivalent to the V4L2_IN_ST_NO_SIGNAL flag of the V4L2
84     | 0 - not detected
85     | 1 - detected
90     The value is identical to what VIDIOC_QUERY_DV_TIMINGS returns in the width
96     The value is identical to what VIDIOC_QUERY_DV_TIMINGS returns in the height
102     The value is equivalent to the flags returned by VIDIOC_QUERY_DV_TIMINGS in
105     | 0 - active low
106     | 1 - active high
107     | 2 - not available
112     The value is equivalent to the flags returned by VIDIOC_QUERY_DV_TIMINGS in
115     | 0 - active low
116     | 1 - active high
117     | 2 - not available
122     the correct frame ordering. This value indicates, how many "empty" pixels
129     the correct frame ordering. This value indicates, how many "empty" pixels
131     internal HSYNC pulse. The value must be greater than 1 and smaller than
135     Input pixel clock frequency in kHz.
137     The value is identical to what VIDIOC_QUERY_DV_TIMINGS returns in
146     The value is identical to what VIDIOC_QUERY_DV_TIMINGS returns in
152     The value is identical to what VIDIOC_QUERY_DV_TIMINGS returns in
159     The value is identical to what VIDIOC_QUERY_DV_TIMINGS returns in
166     The value is identical to what VIDIOC_QUERY_DV_TIMINGS returns in
173     The value is identical to what VIDIOC_QUERY_DV_TIMINGS returns in
180     The value is identical to what VIDIOC_QUERY_DV_TIMINGS returns in
184     PLL frequency range of the OLDI input clock generator. The PLL frequency is
189     | 0 - PLL < 50MHz (default)
190     | 1 - PLL >= 50MHz
192     *Note: This parameter can not be changed while the input v4l2 device is
203     input and the v4l2 output devices are disabled. If set to 2 or 3, the source
207     | 0 - input 0
208     | 1 - input 1
209     | 2 - v4l2 output 0
210     | 3 - v4l2 output 1
212     *Note: This parameter can not be changed while ANY of the input/output v4l2
217     proper value must be set before the start of streaming. The default width
225     proper value must be set before the start of streaming. The default height
234     a frame rate perfectly matching the value required by the connected display.
243     | 0 - active low (default)
244     | 1 - active high
249     | 0 - active low (default)
250     | 1 - active high
255     | 0 - active low
256     | 1 - active high (default)
259     Output pixel clock frequency. Allowed values are between 25000-190000(kHz)
260     and there is a non-linear stepping between two consecutive allowed
262     value and sets it. When reading this property, you get the exact
269     Width of the HSYNC signal in pixels. The default value is 40.
272     Width of the VSYNC signal in video lines. The default value is 20.
276     valid pixel in the video line (marked by DE=1). The default value is 50.
280     line (marked by DE=1) and assertion of the HSYNC signal. The default value
285     line with the first valid pixel (marked by DE=1). The default value is 31.
289     by DE=1) and assertion of the VSYNC signal. The default value is 30.
291 FPDL3 specific input parameters
295     Number of deserializer input lines.
297     | 0 - auto (default)
298     | 1 - single
299     | 2 - dual
307     | 0 - auto (default)
308     | 1 - single
309     | 2 - dual
311 GMSL specific input parameters
317     | 0 - 12Gb/s (default)
318     | 1 - 6Gb/s
319     | 2 - 3Gb/s
320     | 3 - 1.5Gb/s
323     The GMSL multi-stream contains up to four video streams. This parameter
324     selects which stream is captured by the video input. The value is the
325     zero-based index of the stream. The default stream id is 0.
327     *Note: This parameter can not be changed while the input v4l2 device is
333     | 0 - disabled
334     | 1 - enabled (default)
337 --------------
340  - mgb4-fw.X - FPGA firmware.
341  - mgb4-data.X - Factory settings, e.g. card serial number.
343 The *mgb4-fw* partition is writable and is used for FW updates, *mgb4-data* is
344 read-only. The *X* attached to the partition name represents the card number.
346 also have a third partition named *mgb4-flash* available in the system. This
351 --------------
359 	| bit 1 - trigger 1 pending
360 	| bit 2 - trigger 2 pending
361 	| bit 5 - trigger 1 level
362 	| bit 6 - trigger 2 level
376 buffer mode - the values do not represent valid data in such case.*