linuxOS_D21X/doc/topics/sdk/dvp/dvp_interface.html
2025-01-23 16:35:08 +08:00

314 lines
45 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh-cn" lang="zh-cn" data-whc_version="27.0">
<head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><meta name="description" content="ioctl 接口 用户态通过 /dev/videoX 节点的 ioctl() 接口与内核态 V4L2 框架、DVP 驱动进行交互。主要功能有: 获取、设置格式 申请、释放 Buf QBuf、DQBuf 导出 dma-buf 文件描述符 启动、停止 Stream 定义在 include/uapi/linux/videodev2.h # define VIDIOC_QUERYCAP _IOR( ..."/><meta name="DC.rights.owner" content="(C) 版权 2025"/><meta name="copyright" content="(C) 版权 2025"/><meta name="generator" content="DITA-OT"/><meta name="DC.type" content="concept"/><meta name="DC.relation" content="../../../topics/sdk/dvp/dvp_design.html"/><meta name="DC.relation" content="../../../topics/sdk/dvp/dvp_data_struct.html"/><meta name="DC.relation" content="../../../topics/sdk/dvp/dvp_demo.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.date.modified" content="2024-01-15"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="dvp_interface_design"/><meta name="DC.language" content="zh-CN"/><title>接口设计</title><!-- Generated with build number 2024112209. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="dvp_interface_design-d4445e5316"/><meta name="wh-source-relpath" content="topics/sdk/dvp/dvp_interface.dita"/><meta name="wh-out-relpath" content="topics/sdk/dvp/dvp_interface.html"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/commons.css?buildId=2024112209"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/topic.css?buildId=2024112209"/>
<script src="../../../webhelp/app/options/properties.js?buildId=20250123154945"></script>
<script src="../../../webhelp/app/localization/strings.js?buildId=2024112209"></script>
<script src="../../../webhelp/app/search/index/keywords.js?buildId=20250123154945"></script>
<script defer="defer" src="../../../webhelp/app/commons.js?buildId=2024112209"></script>
<script defer="defer" src="../../../webhelp/app/topic.js?buildId=2024112209"></script>
<link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-styles-web.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/notes.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-common.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-images.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/footnote.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-web-watermark.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/topic-body-list.css?buildId=2024112209"/></head>
<body id="dvp_interface_design" class="wh_topic_page frmBody">
<a href="#wh_topic_body" class="sr-only sr-only-focusable">
跳转到主要内容
</a>
<header class="navbar navbar-default wh_header">
<div class="container-fluid">
<div class="wh_header_flex_container navbar-nav navbar-expand-md navbar-dark">
<div class="wh_logo_and_publication_title_container">
<div class="wh_logo_and_publication_title">
<a href="http://www.artinchip.com" class=" wh_logo d-none d-sm-block "><img src="../../../company-logo-white.png" alt=" Linux SDK 使用指南 SDK 指南文件 "/></a>
<div class=" wh_publication_title "><a href="../../../index.html"><span class="booktitle"> <span class="ph mainbooktitle">Linux SDK 使用指南</span> <span class="ph booktitlealt">SDK 指南文件</span> </span></a></div>
</div>
</div>
<div class="wh_top_menu_and_indexterms_link collapse navbar-collapse" id="wh_top_menu_and_indexterms_link">
</div>
</div>
</div>
</header>
<div class=" wh_search_input navbar-form wh_topic_page_search search " role="form">
<form id="searchForm" method="get" role="search" action="../../../search.html"><div><input type="search" placeholder="搜索 " class="wh_search_textfield" id="textToSearch" name="searchQuery" aria-label="搜索查询" required="required"/><button type="submit" class="wh_search_button" aria-label="搜索"><span class="search_input_text">搜索</span></button></div></form>
</div>
<div class="container-fluid" id="wh_topic_container">
<div class="row">
<nav class="wh_tools d-print-none navbar-expand-md" aria-label="Tools">
<div data-tooltip-position="bottom" class=" wh_breadcrumb "><ol class="d-print-none"><li><span class="home"><a href="../../../index.html"><span>主页</span></a></span></li><li><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html">高级应用</a><div class="wh-tooltip"><p class="shortdesc">系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。</p></div></div></div></li><li><div class="topicref" data-id="concept_mcc_32s_nbc"><div class="title"><a href="../../../topics/chapter-title/chapter-multi-media-sdk.html">多媒体</a><div class="wh-tooltip"><p class="shortdesc">GE、VE、Display、DVP、MPP、MPP 播放器等多媒体模块的介绍和使用说明。</p></div></div></div></li><li><div class="topicref" data-id="concept_h4d_fwt_tzb"><div class="title"><a href="../../../topics/sdk/dvp/dvp_user_guide.html">DVP 使用指南</a></div></div></li><li><div class="topicref" data-id="dvp_design_intro"><div class="title"><a href="../../../topics/sdk/dvp/dvp_design.html">设计说明</a></div></div></li><li class="active"><div class="topicref" data-id="dvp_interface_design"><div class="title"><a href="../../../topics/sdk/dvp/dvp_interface.html">接口设计</a></div></div></li></ol></div>
<div class="wh_right_tools">
<button class="wh_hide_highlight" aria-label="切换搜索突出显示" title="切换搜索突出显示"></button>
<button class="webhelp_expand_collapse_sections" data-next-state="collapsed" aria-label="折叠截面" title="折叠截面"></button>
<div class=" wh_navigation_links "><span id="topic_navigation_links" class="navheader">
<span class="navprev"><a class="- topic/link link" href="../../../topics/sdk/dvp/dvp_data_struct.html" title="数据结构设计" aria-label="上一主题: 数据结构设计" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/dvp/dvp_demo.html" title="APP Demo" aria-label="下一主题: APP Demo" rel="next"></a></span> </span></div>
<div class=" wh_print_link print d-none d-md-inline-block "><button onClick="window.print()" title="打印此页" aria-label="打印此页"></button></div>
<button type="button" id="wh_toc_button" class="custom-toggler navbar-toggler collapsed wh_toggle_button navbar-light" aria-expanded="false" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc">
<span class="navbar-toggler-icon"></span>
</button>
</div>
</nav>
</div>
<div class="wh_content_area">
<div class="row">
<nav id="wh_publication_toc" class="col-lg-3 col-md-3 col-sm-12 d-md-block d-none d-print-none" aria-label="Table of Contents Container">
<div id="wh_publication_toc_content">
<div class=" wh_publication_toc " data-tooltip-position="right"><span class="expand-button-action-labels"><span id="button-expand-action" role="button" aria-label="Expand"></span><span id="button-collapse-action" role="button" aria-label="Collapse"></span><span id="button-pending-action" role="button" aria-label="Pending"></span></span><ul role="tree" aria-label="Table of Contents"><li role="treeitem"><div data-tocid="revinfo_linux-d4445e1079" class="topicref" data-id="revinfo_linux" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/revinfo/revinfo_linux.html" id="revinfo_linux-d4445e1079-link">修订记录</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1096" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1096-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/sdk-compile.html" id="id-d4445e1096-link">SDK 编译</a><div class="wh-tooltip"><p class="shortdesc">介绍不同编译环境下 SDK 的详细编译流程。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="tocId-d4445e1240" class="topicref" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action tocId-d4445e1240-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/lb_usage_commands.html" id="tocId-d4445e1240-link">使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_rcx_czh_pzb-d4445e1360" class="topicref" data-id="concept_rcx_czh_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_rcx_czh_pzb-d4445e1360-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-app.html" id="concept_rcx_czh_pzb-d4445e1360-link">应用场景</a><div class="wh-tooltip"><p class="shortdesc">描述了 SDK 在不同应用场景中的配置和使用包括系统更新、OTA、安全方案等。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1678" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1678-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/peripheral-intro.html" id="id-d4445e1678-link">外设移植</a><div class="wh-tooltip"><p class="shortdesc"><span class="ph">触摸屏、显示器、WIFI 模块、按键</span>等外设的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1964" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1964-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/chapter-bringup.html" id="id-d4445e1964-link">BringUp</a><div class="wh-tooltip"><p class="shortdesc">在硬件上电后快速初始化系统,为操作系统的启动准备好必要的硬件环境。</p></div></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d4445e2153" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d4445e2153-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html" id="id-d4445e2153-link">高级应用</a><div class="wh-tooltip"><p class="shortdesc">系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="uBoot-d4445e2170" class="topicref" data-id="uBoot" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action uBoot-d4445e2170-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/boot/uboot-module.html" id="uBoot-d4445e2170-link">U-Boot</a><div class="wh-tooltip"><p class="shortdesc">启动支持的基本功能以及运行时的基本硬件环境。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_mtx_tk3_pzb-d4445e3028" class="topicref" data-id="concept_mtx_tk3_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_mtx_tk3_pzb-d4445e3028-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/linux/chapter_linux.html" id="concept_mtx_tk3_pzb-d4445e3028-link">Linux</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-system-d4445e3198" class="topicref" data-id="chapter-system" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-system-d4445e3198-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-system.html" id="chapter-system-d4445e3198-link">系统</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-memory-d4445e4054" class="topicref" data-id="chapter-memory" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-memory-d4445e4054-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-memory-sdk.html" id="chapter-memory-d4445e4054-link">存储</a><div class="wh-tooltip"><p class="shortdesc">SDMC、SPI NAND、SPI NOR 等存储模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="concept_mcc_32s_nbc-d4445e4438" class="topicref" data-id="concept_mcc_32s_nbc" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action concept_mcc_32s_nbc-d4445e4438-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-multi-media-sdk.html" id="concept_mcc_32s_nbc-d4445e4438-link">多媒体</a><div class="wh-tooltip"><p class="shortdesc">GE、VE、Display、DVP、MPP、MPP 播放器等多媒体模块的介绍和使用说明。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="ge-d4445e4455" class="topicref" data-id="ge" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action ge-d4445e4455-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ge/ge_user_guide.html" id="ge-d4445e4455-link">GE 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="ve-d4445e4637" class="topicref" data-id="ve" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action ve-d4445e4637-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ve/ve-user-guide.html" id="ve-d4445e4637-link">VE 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e4777" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e4777-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_user_guide.html" id="id-d4445e4777-link">Display 使用指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="concept_h4d_fwt_tzb-d4445e5218" class="topicref" data-id="concept_h4d_fwt_tzb" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action concept_h4d_fwt_tzb-d4445e5218-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_user_guide.html" id="concept_h4d_fwt_tzb-d4445e5218-link">DVP 使用指南</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="dvp_configuration-d4445e5232" class="topicref" data-id="dvp_configuration" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_config.html" id="dvp_configuration-d4445e5232-link">DVP 配置</a></div></div></li><li role="treeitem"><div data-tocid="dvp_debug_guide-d4445e5246" class="topicref" data-id="dvp_debug_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_debug.html" id="dvp_debug_guide-d4445e5246-link">调试指南</a></div></div></li><li role="treeitem"><div data-tocid="dvp_test_guide-d4445e5260" class="topicref" data-id="dvp_test_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_test.html" id="dvp_test_guide-d4445e5260-link">测试指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="dvp_design_intro-d4445e5274" class="topicref" data-id="dvp_design_intro" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action dvp_design_intro-d4445e5274-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_design.html" id="dvp_design_intro-d4445e5274-link">设计说明</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="dvp_key_procedures-d4445e5288" class="topicref" data-id="dvp_key_procedures" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_key_procedure.html" id="dvp_key_procedures-d4445e5288-link">关键流程设计</a></div></div></li><li role="treeitem"><div data-tocid="dvp_data_structure-d4445e5302" class="topicref" data-id="dvp_data_structure" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_data_struct.html" id="dvp_data_structure-d4445e5302-link">数据结构设计</a></div></div></li><li role="treeitem" class="active"><div data-tocid="dvp_interface_design-d4445e5316" class="topicref" data-id="dvp_interface_design" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_interface.html" id="dvp_interface_design-d4445e5316-link">接口设计</a></div></div></li><li role="treeitem"><div data-tocid="dvp-demo-d4445e5330" class="topicref" data-id="dvp-demo" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_demo.html" id="dvp-demo-d4445e5330-link">APP Demo</a></div></div></li></ul></li><li role="treeitem"><div data-tocid="dvp_common_issues-d4445e5344" class="topicref" data-id="dvp_common_issues" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_faq.html" id="dvp_common_issues-d4445e5344-link">常见问题</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="mpp-d4445e5358" class="topicref" data-id="mpp" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action mpp-d4445e5358-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mpp/mpp_user_guide.html" id="mpp-d4445e5358-link">MPP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="mpp_0-d4445e5498" class="topicref" data-id="mpp_0" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action mpp_0-d4445e5498-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mpp/mpp_player_user_guide.html" id="mpp_0-d4445e5498-link">MPP 播放器使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="gstreamer-d4445e5582" class="topicref" data-id="gstreamer" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action gstreamer-d4445e5582-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gstreamer/gstreamer-user-guide.html" id="gstreamer-d4445e5582-link">Gstreamer 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="i2s-d4445e5680" class="topicref" data-id="i2s" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action i2s-d4445e5680-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_user_guide.html" id="i2s-d4445e5680-link">I2S 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="audio_codec_user_guide-d4445e5806" class="topicref" data-id="audio_codec_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action audio_codec_user_guide-d4445e5806-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/audio_codec/audio-codec-user-guide.html" id="audio_codec_user_guide-d4445e5806-link">Audio Codec 使用指南</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_nww_hzh_pzb-d4445e5947" class="topicref" data-id="concept_nww_hzh_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_nww_hzh_pzb-d4445e5947-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-interface-sdk.html" id="concept_nww_hzh_pzb-d4445e5947-link">接口</a><div class="wh-tooltip"><p class="shortdesc">CAN、CIR、GPAI、GPIO、I2C、PSADC、PWM 等接口模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-safety-d4445e7944" class="topicref" data-id="chapter-safety" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-safety-d4445e7944-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-safety-sdk.html" id="chapter-safety-d4445e7944-link">安全</a><div class="wh-tooltip"><p class="shortdesc">SPI ENC、CE、eFuse 等安全模块的介绍和使用说明。</p></div></div></div></li></ul></li></ul></div>
</div>
</nav>
<div class="col-lg-7 col-md-9 col-sm-12" id="wh_topic_body">
<button id="wh_close_publication_toc_button" class="close-toc-button d-none" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<button id="wh_close_topic_toc_button" class="close-toc-button d-none" aria-label="Toggle topic table of content" aria-controls="wh_topic_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<div class=" wh_topic_content body "><main role="main"><article class="- topic/topic concept/concept topic concept" role="article" aria-labelledby="ariaid-title1">
<span class="edit-link" style="font-size:12px; opacity:0.6; text-align:right; vertical-align:middle"><a target="_blank" title="Edit this document" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/dvp/dvp_interface.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">接口设计</h1>
<div class="date inPage">15 Jan 2024</div><div style="color: gray;">
Read time: 5 minute(s)
</div>
<div class="- topic/body concept/conbody body conbody">
<section class="- topic/section section" id="dvp_interface_design__section_ccl_zch_d1c" data-ofbid="dvp_interface_design__section_ccl_zch_d1c"><h2 class="- topic/title title sectiontitle">ioctl 接口</h2>
<p class="- topic/p p" data-ofbid="d62488e38__20250123155203">用户态通过 /dev/videoX 节点的 ioctl() 接口与内核态 V4L2 框架、DVP 驱动进行交互。主要功能有:</p>
<ul class="- topic/ul ul" id="dvp_interface_design__ul_dcl_zch_d1c" data-ofbid="dvp_interface_design__ul_dcl_zch_d1c">
<li class="- topic/li li" data-ofbid="d62488e43__20250123155203">
<p class="- topic/p p" data-ofbid="d62488e45__20250123155203">获取、设置格式</p>
</li>
<li class="- topic/li li" data-ofbid="d62488e49__20250123155203">
<p class="- topic/p p" data-ofbid="d62488e51__20250123155203">申请、释放 Buf</p>
</li>
<li class="- topic/li li" data-ofbid="d62488e55__20250123155203">
<p class="- topic/p p" data-ofbid="d62488e57__20250123155203">QBuf、DQBuf</p>
</li>
<li class="- topic/li li" data-ofbid="d62488e61__20250123155203">
<p class="- topic/p p" data-ofbid="d62488e63__20250123155203">导出 dma-buf 文件描述符</p>
</li>
<li class="- topic/li li" data-ofbid="d62488e67__20250123155203">
<p class="- topic/p p" data-ofbid="d62488e69__20250123155203">启动、停止 Stream</p>
</li>
</ul>
<div class="- topic/p p" data-ofbid="d62488e74__20250123155203">定义在<span class="+ topic/ph sw-d/filepath ph filepath">include/uapi/linux/videodev2.h</span><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="dvp_interface_design__codeblock_yzc_rdh_d1c" data-ofbid="dvp_interface_design__codeblock_yzc_rdh_d1c"><code>#<span class="hl-directive">define</span> VIDIOC_QUERYCAP _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">0</span>, <strong class="hl-keyword">struct</strong> v4l2_capability)
#<span class="hl-directive">define</span> VIDIOC_ENUM_FMT _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">2</span>, <strong class="hl-keyword">struct</strong> v4l2_fmtdesc)
#<span class="hl-directive">define</span> VIDIOC_G_FMT _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">4</span>, <strong class="hl-keyword">struct</strong> v4l2_format)
#<span class="hl-directive">define</span> VIDIOC_S_FMT _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">5</span>, <strong class="hl-keyword">struct</strong> v4l2_format)
#<span class="hl-directive">define</span> VIDIOC_REQBUFS _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">8</span>, <strong class="hl-keyword">struct</strong> v4l2_requestbuffers)
#<span class="hl-directive">define</span> VIDIOC_QUERYBUF _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">9</span>, <strong class="hl-keyword">struct</strong> v4l2_buffer)
#<span class="hl-directive">define</span> VIDIOC_G_FBUF _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">10</span>, <strong class="hl-keyword">struct</strong> v4l2_framebuffer)
#<span class="hl-directive">define</span> VIDIOC_S_FBUF _IOW(<span class="hl-string">'V'</span>, <span class="hl-number">11</span>, <strong class="hl-keyword">struct</strong> v4l2_framebuffer)
#<span class="hl-directive">define</span> VIDIOC_OVERLAY _IOW(<span class="hl-string">'V'</span>, <span class="hl-number">14</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> VIDIOC_QBUF _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">15</span>, <strong class="hl-keyword">struct</strong> v4l2_buffer)
#<span class="hl-directive">define</span> VIDIOC_EXPBUF _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">16</span>, <strong class="hl-keyword">struct</strong> v4l2_exportbuffer)
#<span class="hl-directive">define</span> VIDIOC_DQBUF _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">17</span>, <strong class="hl-keyword">struct</strong> v4l2_buffer)
#<span class="hl-directive">define</span> VIDIOC_STREAMON _IOW(<span class="hl-string">'V'</span>, <span class="hl-number">18</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> VIDIOC_STREAMOFF _IOW(<span class="hl-string">'V'</span>, <span class="hl-number">19</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> VIDIOC_G_PARM _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">21</span>, <strong class="hl-keyword">struct</strong> v4l2_streamparm)
#<span class="hl-directive">define</span> VIDIOC_S_PARM _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">22</span>, <strong class="hl-keyword">struct</strong> v4l2_streamparm)
#<span class="hl-directive">define</span> VIDIOC_G_STD _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">23</span>, v4l2_std_id)
#<span class="hl-directive">define</span> VIDIOC_S_STD _IOW(<span class="hl-string">'V'</span>, <span class="hl-number">24</span>, v4l2_std_id)
#<span class="hl-directive">define</span> VIDIOC_ENUMSTD _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">25</span>, <strong class="hl-keyword">struct</strong> v4l2_standard)
#<span class="hl-directive">define</span> VIDIOC_ENUMINPUT _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">26</span>, <strong class="hl-keyword">struct</strong> v4l2_input)
#<span class="hl-directive">define</span> VIDIOC_G_CTRL _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">27</span>, <strong class="hl-keyword">struct</strong> v4l2_control)
#<span class="hl-directive">define</span> VIDIOC_S_CTRL _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">28</span>, <strong class="hl-keyword">struct</strong> v4l2_control)
#<span class="hl-directive">define</span> VIDIOC_QUERYCTRL _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">36</span>, <strong class="hl-keyword">struct</strong> v4l2_queryctrl)
#<span class="hl-directive">define</span> VIDIOC_QUERYMENU _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">37</span>, <strong class="hl-keyword">struct</strong> v4l2_querymenu)
#<span class="hl-directive">define</span> VIDIOC_G_INPUT _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">38</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> VIDIOC_S_INPUT _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">39</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> VIDIOC_G_OUTPUT _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">46</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> VIDIOC_S_OUTPUT _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">47</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> VIDIOC_ENUMOUTPUT _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">48</span>, <strong class="hl-keyword">struct</strong> v4l2_output)
#<span class="hl-directive">define</span> VIDIOC_G_FREQUENCY _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">56</span>, <strong class="hl-keyword">struct</strong> v4l2_frequency)
#<span class="hl-directive">define</span> VIDIOC_S_FREQUENCY _IOW(<span class="hl-string">'V'</span>, <span class="hl-number">57</span>, <strong class="hl-keyword">struct</strong> v4l2_frequency)
#<span class="hl-directive">define</span> VIDIOC_CROPCAP _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">58</span>, <strong class="hl-keyword">struct</strong> v4l2_cropcap)
#<span class="hl-directive">define</span> VIDIOC_G_CROP _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">59</span>, <strong class="hl-keyword">struct</strong> v4l2_crop)
#<span class="hl-directive">define</span> VIDIOC_S_CROP _IOW(<span class="hl-string">'V'</span>, <span class="hl-number">60</span>, <strong class="hl-keyword">struct</strong> v4l2_crop)
#<span class="hl-directive">define</span> VIDIOC_G_JPEGCOMP _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">61</span>, <strong class="hl-keyword">struct</strong> v4l2_jpegcompression)
#<span class="hl-directive">define</span> VIDIOC_S_JPEGCOMP _IOW(<span class="hl-string">'V'</span>, <span class="hl-number">62</span>, <strong class="hl-keyword">struct</strong> v4l2_jpegcompression)
#<span class="hl-directive">define</span> VIDIOC_QUERYSTD _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">63</span>, v4l2_std_id)
#<span class="hl-directive">define</span> VIDIOC_TRY_FMT _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">64</span>, <strong class="hl-keyword">struct</strong> v4l2_format)
#<span class="hl-directive">define</span> VIDIOC_G_PRIORITY _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">67</span>, __u32) <em class="hl-comment">/* enum v4l2_priority */</em>
#<span class="hl-directive">define</span> VIDIOC_S_PRIORITY _IOW(<span class="hl-string">'V'</span>, <span class="hl-number">68</span>, __u32) <em class="hl-comment">/* enum v4l2_priority */</em>
#<span class="hl-directive">define</span> VIDIOC_G_SLICED_VBI_CAP _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">69</span>, <strong class="hl-keyword">struct</strong> v4l2_sliced_vbi_cap)
#<span class="hl-directive">define</span> VIDIOC_LOG_STATUS _IO(<span class="hl-string">'V'</span>, <span class="hl-number">70</span>)
#<span class="hl-directive">define</span> VIDIOC_G_EXT_CTRLS _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">71</span>, <strong class="hl-keyword">struct</strong> v4l2_ext_controls)
#<span class="hl-directive">define</span> VIDIOC_S_EXT_CTRLS _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">72</span>, <strong class="hl-keyword">struct</strong> v4l2_ext_controls)
#<span class="hl-directive">define</span> VIDIOC_TRY_EXT_CTRLS _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">73</span>, <strong class="hl-keyword">struct</strong> v4l2_ext_controls)
#<span class="hl-directive">define</span> VIDIOC_ENUM_FRAMESIZES _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">74</span>, <strong class="hl-keyword">struct</strong> v4l2_frmsizeenum)
#<span class="hl-directive">define</span> VIDIOC_ENUM_FRAMEINTERVALS _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">75</span>, <strong class="hl-keyword">struct</strong> v4l2_frmivalenum)
#<span class="hl-directive">define</span> VIDIOC_G_ENC_INDEX _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">76</span>, <strong class="hl-keyword">struct</strong> v4l2_enc_idx)
#<span class="hl-directive">define</span> VIDIOC_ENCODER_CMD _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">77</span>, <strong class="hl-keyword">struct</strong> v4l2_encoder_cmd)
#<span class="hl-directive">define</span> VIDIOC_TRY_ENCODER_CMD _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">78</span>, <strong class="hl-keyword">struct</strong> v4l2_encoder_cmd)</code></pre></div>
</section>
<section class="- topic/section section" id="dvp_interface_design__section_fcl_zch_d1c" data-ofbid="dvp_interface_design__section_fcl_zch_d1c"><h2 class="- topic/title title sectiontitle">V4l2 subdev 的外部接口</h2>
<div class="- topic/p p" data-ofbid="d62488e88__20250123155203">用户态通过/dev/v4l-subdevX 节点的 ioctl()接口与内核态 V4L2 框架、DVP 驱动、Sensor 驱动进行交互。主要功能有:<ul class="- topic/ul ul" id="dvp_interface_design__ul_gcl_zch_d1c" data-ofbid="dvp_interface_design__ul_gcl_zch_d1c">
<li class="- topic/li li" data-ofbid="d62488e92__20250123155203">
<p class="- topic/p p" data-ofbid="d62488e94__20250123155203">获取、设置格式</p>
</li>
<li class="- topic/li li" data-ofbid="d62488e98__20250123155203">
<p class="- topic/p p" data-ofbid="d62488e100__20250123155203">获取、设置帧间隔</p>
</li>
<li class="- topic/li li" data-ofbid="d62488e104__20250123155203">
<p class="- topic/p p" data-ofbid="d62488e106__20250123155203">枚举支持的 MBUS 类型</p>
</li>
<li class="- topic/li li" data-ofbid="d62488e110__20250123155203">
<p class="- topic/p p" data-ofbid="d62488e112__20250123155203">枚举支持的分辨率</p>
</li>
<li class="- topic/li li" data-ofbid="d62488e116__20250123155203">
<p class="- topic/p p" data-ofbid="d62488e118__20250123155203">获取、设置区域裁剪</p>
</li>
</ul></div>
<div class="- topic/p p" data-ofbid="d62488e123__20250123155203">定义在
<span class="+ topic/ph sw-d/filepath ph filepath">include/uapi/linux/v4l2-subdev.h</span><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="dvp_interface_design__codeblock_srn_sdh_d1c" data-ofbid="dvp_interface_design__codeblock_srn_sdh_d1c"><code>#<span class="hl-directive">define</span> VIDIOC_SUBDEV_G_FMT _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">4</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_format)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_S_FMT _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">5</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_format)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_G_FRAME_INTERVAL _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">21</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_frame_interval)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_S_FRAME_INTERVAL _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">22</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_frame_interval)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_ENUM_MBUS_CODE _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">2</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_mbus_code_enum)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_ENUM_FRAME_SIZE _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">74</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_frame_size_enum)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">75</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_frame_interval_enum)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_G_CROP _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">59</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_crop)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_S_CROP _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">60</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_crop)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_G_SELECTION _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">61</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_selection)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_S_SELECTION _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">62</span>, <strong class="hl-keyword">struct</strong> v4l2_subdev_selection)
<em class="hl-comment">/* The following ioctls are identical to the ioctls in videodev2.h */</em>
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_G_STD _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">23</span>, v4l2_std_id)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_S_STD _IOW(<span class="hl-string">'V'</span>, <span class="hl-number">24</span>, v4l2_std_id)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_ENUMSTD _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">25</span>, <strong class="hl-keyword">struct</strong> v4l2_standard)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_G_EDID _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">40</span>, <strong class="hl-keyword">struct</strong> v4l2_edid)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_S_EDID _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">41</span>, <strong class="hl-keyword">struct</strong> v4l2_edid)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_QUERYSTD _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">63</span>, v4l2_std_id)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_S_DV_TIMINGS _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">87</span>, <strong class="hl-keyword">struct</strong> v4l2_dv_timings)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_G_DV_TIMINGS _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">88</span>, <strong class="hl-keyword">struct</strong> v4l2_dv_timings)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_ENUM_DV_TIMINGS _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">98</span>, <strong class="hl-keyword">struct</strong> v4l2_enum_dv_timings)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_QUERY_DV_TIMINGS _IOR(<span class="hl-string">'V'</span>, <span class="hl-number">99</span>, <strong class="hl-keyword">struct</strong> v4l2_dv_timings)
#<span class="hl-directive">define</span> VIDIOC_SUBDEV_DV_TIMINGS_CAP _IOWR(<span class="hl-string">'V'</span>, <span class="hl-number">100</span>, <strong class="hl-keyword">struct</strong> v4l2_dv_timings_cap)</code></pre></div>
</section>
</div>
</article></main></div>
</div>
<nav role="navigation" id="wh_topic_toc" aria-label="On this page" class="col-lg-2 d-none d-lg-block navbar d-print-none">
<div id="wh_topic_toc_content">
<div class=" wh_topic_toc "><div class="wh_topic_label">在本页上</div><ul><li class="section-item"><div class="section-title"><a href="#dvp_interface_design__section_ccl_zch_d1c" data-tocid="dvp_interface_design__section_ccl_zch_d1c">ioctl 接口</a></div></li><li class="section-item"><div class="section-title"><a href="#dvp_interface_design__section_fcl_zch_d1c" data-tocid="dvp_interface_design__section_fcl_zch_d1c">V4l2 subdev 的外部接口</a></div></li></ul></div>
</div>
</nav>
</div>
</div>
</div>
<footer class="navbar navbar-default wh_footer">
<div class=" footer-container mx-auto ">
<title>footer def</title>
<style><!--
.p1 {
font-family: FangZhengShuSong, Times, serif;
}
.p2 {
font-family: Arial, Helvetica, sans-serif;
}
.p3 {
font-family: "Lucida Console", "Courier New", monospace;
}
--></style>
<div class="webhelp.fragment.footer">
<p class="p1">Copyright © 2019-2024 广东匠芯创科技有限公司. All rights reserved.</p>
</div><div>
<div class="generation_time">
Update Time: 2025-01-23
</div>
</div>
</div>
</footer>
<button id="go2top" class="d-print-none" title="返回顶部">
<span class="oxy-icon oxy-icon-up"></span>
</button>
<div id="modal_img_large" class="modal">
<span class="close oxy-icon oxy-icon-remove"></span>
<div id="modal_img_container"></div>
<div id="caption"></div>
</div>
<script src="${pd}/publishing/publishing-styles-AIC-template/js/custom.js" defer="defer"></script>
</body>
</html>