tq_uvc.h

浏览该文件的文档.

#ifndef LINUX_LIBV2_SOURCE_USB_CAMERA_TQ_UVC_H_
#define LINUX_LIBV2_SOURCE_USB_CAMERA_TQ_UVC_H_

// Copyright 2024 广东省天嵌嵌入式技术股份有限公司

#include <libhardware.h>

#ifdef __cplusplus
#define UVC_API extern "C"
#else
#define UVC_API
#endif
    UVC_API int tq_uvc_init(char *dev_name, int width, int high, int fps, void **buff);
    /*
 * 描述：初始化摄像头
 * 参数：char *dev_name//设备文件名
        int width//宽
        int high//高
        int fps//帧率
        void** buff
 * 返回值：成功：设备文件
 *        失败：-1：打开设备文件失败
 *        失败：-2：设置数据流参数失败
 *        失败：-3：设置视频的制式和帧格式
 *        失败：-4：内存申请失败
 *        失败：-5：查询申请到的内存失败
 *        失败：-6：将空闲的内存加入可捕获视频的队列失败
 *        失败：-7：打开视频流失败
 *        失败：-99：参数错误
 */

    UVC_API int tq_uvc_check(char *dev);
    /*
 * 描述：检测摄像头是否存在
 * 参数：index用于检测第几个摄像头，从0开始,对应video0~x
 *返回值：存在返回0，不存在返回-1 参数错误返回-99
 *
*/

    UVC_API int tq_uvc_args(int fd, int *width, int *high);
    /*
 * 描述：获取设备可支持的图像尺寸
 * 参数：int fd//设备文件(uvc_init的返回值),int width(用于存放设备当前分辨率的宽),int high(用于存放设备当前分辨率的高)
 * 返回值：成功：0
 *        失败：-1：获取失败
 *        失败：-98：未初始化
 *        失败：-99：参数错误
*/

    UVC_API int tq_uvc_format(int fd, struct uvc_struct_format **);
    /*
 * 描述：获取设备可支持的格式
 * 参数：int fd//设备文件(uvc_init的返回值),struct uvc_format**(用于存放设备可支持的格式)
 * 返回值：成功：int（可支持设备格式的数量）
 *        失败：-98：未初始化
 *        失败：-99：参数错误
*/

    UVC_API struct uvc_struct_Attributes tq_uvc_Attributes(int fd);
    /*
 * 描述：查询设备属性
 * 参数：int fd//设备文件(uvc_init的返回值)
 * 返回值：成功：uvc_Attributes结构体
 *             uvc_Attributes.driverName[16]//驱动模块的名字
 *             uvc_Attributes.cardName[32]//设备名字
 *             uvc_Attributes.bus_info[32]//总线信息
 *             uvc_Attributes.verison[10]//内核版本
 *        失败：查询失败,结构体uvc_Attributes所有值均为error(-1)
 *        失败：未初始化,结构体uvc_Attributes所有值均为error(-98)
 *        失败：参数错误,结构体uvc_Attributes所有值均为error(-99)
 */

    UVC_API int tq_uvc_capturing(int fd);
    /*
 * 描述：将已经捕获好视频的内存拉出已捕获视频的队列
 * 参数：int fd//设备文件(uvc_init的返回值)
 * 返回值：int 索引值:成功：大于0
 *                  失败：-1
 *                  失败：-98：未初始化
 *                  失败：-99：参数错误
 */

    UVC_API int tq_uvc_release(int fd, int index);
    /*
 * 描述：将空闲的内存加入可捕获视频的队列
 * 参数：int fd//设备文件(uvc_init的返回值)
 *      int index//索引值(uvc_capturing的返回值)
 * 返回值：int 成功：0
 *            失败：-1
 *            失败：-98：未初始化
 *            失败：-99：参数错误
*/

    UVC_API int tq_uvc_close(int fd, void **buff);
/*
 * 描述：关闭摄像头
 * 参数：int fd//设备文件(uvc_init的返回值),void **buff(与初始化函数uvc_init调用同一个)
 * 返回值：成功：0
 *        失败：-1 关闭失败
 *        失败：-2：查询申请到的内存失败
 *        失败：-98：未初始化
 *        失败：-99：参数错误
*/

#endif