1 .. SPDX-License-Identifier: GPL-2.0
2
3 .. include:: <isonum.txt>
4
5 NPCM video driver
6 =================
7
8 This driver is used to control the Video Captu
9 and Encoding Compression Engine (ECE) present
10 capture a frame from digital video input and c
11 the ECE can compress the frame data into HEXTI
12
13 Driver-specific Controls
14 ------------------------
15
16 V4L2_CID_NPCM_CAPTURE_MODE
17 ~~~~~~~~~~~~~~~~~~~~~~~~~~
18
19 The VCD engine supports two modes:
20
21 - COMPLETE mode:
22
23 Capture the next complete frame into memory.
24
25 - DIFF mode:
26
27 Compare the incoming frame with the frame st
28 differentiated frame in memory.
29
30 Application can use ``V4L2_CID_NPCM_CAPTURE_MO
31 with different control values (enum v4l2_npcm_
32
33 - ``V4L2_NPCM_CAPTURE_MODE_COMPLETE``: will se
34 - ``V4L2_NPCM_CAPTURE_MODE_DIFF``: will set VC
35
36 V4L2_CID_NPCM_RECT_COUNT
37 ~~~~~~~~~~~~~~~~~~~~~~~~
38
39 If using V4L2_PIX_FMT_HEXTILE format, VCD will
40 will compress the data into HEXTILE rectangles
41 buffer with the layout defined in Remote Frame
42 ::
43
44 (RFC 6143, https://www.rfc-editor.o
45
46 +--------------+--------------+----
47 | No. of bytes | Type [Value] | Des
48 +--------------+--------------+----
49 | 2 | U16 | x-p
50 | 2 | U16 | y-p
51 | 2 | U16 | wid
52 | 2 | U16 | hei
53 | 4 | S32 | enc
54 +--------------+--------------+----
55 | HEXTILE rectangle dat
56 +----------------------------------
57
58 Application can get the video buffer through V
59 calling ``V4L2_CID_NPCM_RECT_COUNT`` control t
60 rectangles in this buffer.
61
62 References
63 ----------
64 include/uapi/linux/npcm-video.h
65
66 **Copyright** |copy| 2022 Nuvoton Technologies
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.