怎樣使用V4L2最常用的控制命令

Linux視頻設(shè)備驅(qū)動(dòng)常用控制命令使用說(shuō)明

設(shè)置視頻設(shè)備屬性通過(guò)ioctl來(lái)進(jìn)行設(shè)置，ioctl有三個(gè)參數(shù)，分別是fd， cmd，和parameter，表示設(shè)備描述符，控制命令和控制命令參數(shù)。

1. 控制命令VIDIOC_QUERYCAP

功能：查詢?cè)O(shè)備驅(qū)動(dòng)的功能 ;

參數(shù)說(shuō)明：參數(shù)類型為V4L2的能力描述類型struct v4l2_capability;

struct v4l2_capability {

__u8 driver［16］; /* i.e. “bttv” */ //驅(qū)動(dòng)名稱，

__u8 card［32］; /* i.e. “Hauppauge WinTV” */ //

__u8 bus_info［32］; /* “PCI：” + pci_name（pci_dev） */ //PCI總線信息

__u32 version; /* should use KERNEL_VERSION（） */

__u32 capabilities; /* Device capabilities */ //設(shè)備能力

__u32 reserved［4］;

};

返回值說(shuō)明：執(zhí)行成功時(shí)，函數(shù)返回值為 0;

函數(shù)執(zhí)行成功后，struct v4l2_capability 結(jié)構(gòu)體變量中的返回當(dāng)前視頻設(shè)備所支持的功能;

例如支持視頻捕獲功能V4L2_CAP_VIDEO_CAPTURE、 V4L2_CAP_STREAMING等。

使用舉例：

-------------------------------------------------------------------------------------------------------

struct v4l2_capability cap;

iret = ioctl（fd_usbcam， VIDIOC_QUERYCAP， &cap）;

if（iret 《 0）{

printf（“get vidieo capability error，error code： %d \n”， errno）;

return ;

}

------------------------------------------------------------------------------------------------------

執(zhí)行完VIDIOC_QUERYCAP命令后，cap變量中包含了該視頻設(shè)備的能力信息，程序中通過(guò)檢查cap中的設(shè)備能力信息來(lái)判斷設(shè)備是否支持某項(xiàng)功能。

2. 控制命令 VIDIOC_ENUM_FMT

功能：獲取當(dāng)前視頻設(shè)備支持的視頻格式。

參數(shù)說(shuō)明：參數(shù)類型為V4L2的視頻格式描述符類型 struct v4l2_fmtdesc

struct v4l2_fmtdesc {

__u32 index; /* Format number */

enum v4l2_buf_type type; /* buffer type */

__u32 flags;

__u8 description［32］; /* Description string */

__u32 pixelformat; /* Format fourcc */

__u32 reserved［4］;

};

返回值說(shuō)明：執(zhí)行成功時(shí)，函數(shù)返回值為 0;

struct v4l2_fmtdesc 結(jié)構(gòu)體中的 .pixelformat和 .description 成員返回當(dāng)前視頻設(shè)備所支持的視頻格式;

使用舉例：

-------------------------------------------------------------------------------------------------

struct v4l2_fmtdesc fmt;

memset（&fmt， 0， sizeof（fmt））;

fmt.index = 0;

fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

while （（ret = ioctl（dev， VIDIOC_ENUM_FMT， &fmt）） == 0）

{

fmt.index++;

printf（“{ pixelformat = ‘’%c%c%c%c‘’， description = ‘’%s‘’ }\n”，

fmt.pixelformat & 0xFF，（fmt.pixelformat 》》 8） & 0xFF，（fmt.pixelformat 》》 16） & 0xFF，

（fmt.pixelformat 》》 24） & 0xFF， fmt.description）;

}

-------------------------------------------------------------------------------------------------------

3. 控制命令VIDIOC_S_FMT

功能：設(shè)置視頻設(shè)備的視頻數(shù)據(jù)格式，例如設(shè)置視頻圖像數(shù)據(jù)的長(zhǎng)、寬，圖像格式（JPEG、YUYV格式）;

參數(shù)說(shuō)明：參數(shù)類型為V4L2的視頻數(shù)據(jù)格式類型 struct v4l2_format;

struct v4l2_format {

enum v4l2_buf_type type; //數(shù)據(jù)流類型，必須永遠(yuǎn)是V4L2_BUF_TYPE_VIDEO_CAPTURE

union {

struct v4l2_pix_format pix; /* V4L2_BUF_TYPE_VIDEO_CAPTURE */

struct v4l2_window win; /* V4L2_BUF_TYPE_VIDEO_OVERLAY */

struct v4l2_vbi_format vbi; /* V4L2_BUF_TYPE_VBI_CAPTURE */

struct v4l2_sliced_vbi_format sliced; /* V4L2_BUF_TYPE_SLICED_VBI_CAPTURE */

__u8 raw_data［200］; /* user-defined */

} fmt;

};

struct v4l2_pix_format {

__u32 width; // 寬，必須是16的倍數(shù)

__u32 height; // 高，必須是16的倍數(shù)

__u32 pixelformat; // 視頻數(shù)據(jù)存儲(chǔ)類型，例如是YUV4：2：2還是RGB

enum v4l2_field field;

__u32 bytesperline;

__u32 sizeimage;

enum v4l2_colorspace colorspace;

__u32 priv;

};

返回值說(shuō)明：執(zhí)行成功時(shí)，函數(shù)返回值為 0;

使用舉例：

----------------------------------------------------------------------------------------------------------

struct v4l2_format tv4l2_format;

tv4l2_format.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

tv4l2_format.fmt.pix.width = img_width;

tv4l2_format.fmt.pix.height = img_height;

tv4l2_format.fmt.pix.pixelformat = V4L2_PIX_FMT_YUYV;

tv4l2_format.fmt.pix.field = V4L2_FIELD_INTERLACED;

iret = ioctl（fd_usbcam， VIDIOC_S_FMT， &tv4l2_format）;

-----------------------------------------------------------------------------------------------------------

注意：如果該視頻設(shè)備驅(qū)動(dòng)不支持你所設(shè)定的圖像格式，視頻驅(qū)動(dòng)會(huì)重新修改struct v4l2_format結(jié)構(gòu)體變量的值為該視頻設(shè)備所支持的圖像格式，所以在程序設(shè)計(jì)中，設(shè)定完所

有的視頻格式后，要獲取實(shí)際的視頻格式，要重新讀取 struct v4l2_format結(jié)構(gòu)體變量。

使用VIDIOC_G_FMT設(shè)置視頻設(shè)備的視頻數(shù)據(jù)格式，VIDIOC_TRY_FMT驗(yàn)證視頻設(shè)備的視頻數(shù)據(jù)格式。

4. 控制命令VIDIOC_REQBUFS

功能：請(qǐng)求V4L2驅(qū)動(dòng)分配視頻緩沖區(qū)（申請(qǐng)V4L2視頻驅(qū)動(dòng)分配內(nèi)存），V4L2是視頻設(shè)備的驅(qū)動(dòng)層，位于內(nèi)核空間，所以通過(guò)VIDIOC_REQBUFS控制命令字申請(qǐng)的內(nèi)存位于內(nèi)核空間，應(yīng)

用程序不能直接訪問(wèn)，需要通過(guò)調(diào)用mmap內(nèi)存映射函數(shù)把內(nèi)核空間內(nèi)存映射到用戶空間后，應(yīng)用程序通過(guò)訪問(wèn)用戶空間地址來(lái)訪問(wèn)內(nèi)核空間。

參數(shù)說(shuō)明：參數(shù)類型為V4L2的申請(qǐng)緩沖區(qū)數(shù)據(jù)結(jié)構(gòu)體類型struct v4l2_requestbuffers;

struct v4l2_requestbuffers {

u32 count; //緩存數(shù)量，也就是說(shuō)在緩存隊(duì)列里保持多少?gòu)堈掌?/p>

enum v4l2_buf_type type; //數(shù)據(jù)流類型，必須永遠(yuǎn)是V4L2_BUF_TYPE_VIDEO_CAPTURE

enum v4l2_memory memory; //V4L2_MEMORY_MMAP或V4L2_MEMORY_USERPTR

u32 reserved［2］;

};

返回值說(shuō)明：執(zhí)行成功時(shí)，函數(shù)返回值為 0，V4L2驅(qū)動(dòng)層分配好了視頻緩沖區(qū);

使用舉例：

-----------------------------------------------------------------------------------------------------

struct v4l2_requestbuffers tV4L2_reqbuf;

memset（&tV4L2_reqbuf， 0， sizeof（struct v4l2_requestbuffers ））;

tV4L2_reqbuf.count = 1; //申請(qǐng)緩沖區(qū)的個(gè)數(shù)

tV4L2_reqbuf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

tV4L2_reqbuf.memory = V4L2_MEMORY_MMAP; //mmap方式

iret = ioctl（fd_usbcam， VIDIOC_REQBUFS， &tV4L2_reqbuf）;

-----------------------------------------------------------------------------------------------------

注意：VIDIOC_REQBUFS會(huì)修改tV4L2_reqbuf的count值，tV4L2_reqbuf的count值返回實(shí)際申請(qǐng)成功的視頻緩沖區(qū)數(shù)目;

5. 控制命令VIDIOC_QUERYBUF

功能：查詢已經(jīng)分配的V4L2的視頻緩沖區(qū)的相關(guān)信息，包括視頻緩沖區(qū)的使用狀態(tài)、在內(nèi)核空間的偏移地址、緩沖區(qū)長(zhǎng)度等。在應(yīng)用程序設(shè)計(jì)中通過(guò)調(diào) VIDIOC_QUERYBUF來(lái)獲取內(nèi)

核空間的視頻緩沖區(qū)信息，然后調(diào)用函數(shù)mmap把內(nèi)核空間地址映射到用戶空間，這樣應(yīng)用程序才能夠訪問(wèn)位于內(nèi)核空間的視頻緩沖區(qū)。

參數(shù)說(shuō)明：參數(shù)類型為V4L2緩沖區(qū)數(shù)據(jù)結(jié)構(gòu)類型 struct v4l2_buffer;

struct v4l2_buffer {

__u32 index;

enum v4l2_buf_type type;

__u32 bytesused;

__u32 flags;

enum v4l2_field field;

struct timeval timestamp;

struct v4l2_timecode timecode;

__u32 sequence;

/* memory location */

enum v4l2_memory memory;

union {

__u32 offset;

unsigned long userptr;

} m;

__u32 length;

__u32 input;

__u32 reserved;

};

返回值說(shuō)明：執(zhí)行成功時(shí)，函數(shù)返回值為 0;

struct v4l2_buffer結(jié)構(gòu)體變量中保存了指令的緩沖區(qū)的相關(guān)信息;一般情況下，應(yīng)用程序中調(diào)用VIDIOC_QUERYBUF取得了內(nèi)核緩沖區(qū)信息后，緊接著調(diào)用mmap函數(shù)把內(nèi)核空間地址

映射到用戶空間，方便用戶空間應(yīng)用程序的訪問(wèn)。

使用舉例：

-------------------------------------------------------------------------------------------------------

struct v4l2_buffer tV4L2buf;

memset（&tV4L2buf， 0， sizeof（struct v4l2_buffer））;

tV4L2buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

tV4L2buf.memory = V4L2_MEMORY_MMAP;

tV4L2buf.index = i; // 要獲取內(nèi)核視頻緩沖區(qū)的信息編號(hào)

iret = ioctl（fd_usbcam， VIDIOC_QUERYBUF， &tV4L2buf）;

// 把內(nèi)核空間緩沖區(qū)映射到用戶空間緩沖區(qū)

AppBufLength = tV4L2buf.length;

AppBufStartAddr = mmap（ NULL， /* start anywhere */

tV4L2buf.length，

PROT_READ | PROT_WRITE， /* access privilege */

MAP_SHARED， /* recommended */

fd_usbcam，

tV4L2buf.m.offset）;

-------------------------------------------------------------------------------------------------------

上述代碼在通過(guò)調(diào)用VIDIOC_QUERYBUF取得內(nèi)核空間的緩沖區(qū)信息后，接著調(diào)用mmap函數(shù)把內(nèi)核空間緩沖區(qū)映射到用戶空間;

6. 控制命令VIDIOC_QBUF

功能：投放一個(gè)空的視頻緩沖區(qū)到視頻緩沖區(qū)輸入隊(duì)列中 ;

參數(shù)說(shuō)明：參數(shù)類型為V4L2緩沖區(qū)數(shù)據(jù)結(jié)構(gòu)類型 struct v4l2_buffer;

返回值說(shuō)明：執(zhí)行成功時(shí)，函數(shù)返回值為 0;

函數(shù)執(zhí)行成功后，指令（指定）的視頻緩沖區(qū)進(jìn)入視頻輸入隊(duì)列，在啟動(dòng)視頻設(shè)備拍攝圖像時(shí)，相應(yīng)的視頻數(shù)據(jù)被保存到視頻輸入隊(duì)列相應(yīng)的視頻緩沖區(qū)中。

使用舉例：

-------------------------------------------------------------------------------------------------------

struct v4l2_buffer tV4L2buf;

memset（&tV4L2buf， 0， sizeof（struct v4l2_buffer））;

tV4L2buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

tV4L2buf.memory = V4L2_MEMORY_MMAP;

tV4L2buf.index = i; //指令（指定）要投放到視頻輸入隊(duì)列中的內(nèi)核空間視頻緩沖區(qū)的編號(hào);

iret = ioctl（fd_usbcam， VIDIOC_QBUF， &tV4L2buf）;

-------------------------------------------------------------------------------------------------------

7. 控制命令VIDIOC_DQBUF

功能：從視頻緩沖區(qū)的輸出隊(duì)列中取得一個(gè)已經(jīng)保存有一幀視頻數(shù)據(jù)的視頻緩沖區(qū);

參數(shù)說(shuō)明：參數(shù)類型為V4L2緩沖區(qū)數(shù)據(jù)結(jié)構(gòu)類型 struct v4l2_buffer;

返回值說(shuō)明：執(zhí)行成功時(shí)，函數(shù)返回值為 0;函數(shù)執(zhí)行成功后，相應(yīng)的內(nèi)核視頻緩沖區(qū)中保存有當(dāng)前拍攝到的視頻數(shù)據(jù)，應(yīng)用程序可以通過(guò)訪問(wèn)用戶空間來(lái)讀取該視頻數(shù)據(jù)。（前面

已經(jīng)通過(guò)調(diào)用函數(shù) mmap做了用戶空間和內(nèi)核空間的內(nèi)存映射）。

使用舉例：

----------------------------------------------------------------------------------------------------------

struct v4l2_buffer tV4L2buf;

memset（&tV4L2buf， 0， sizeof（struct v4l2_buffer））;

tV4L2buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

tV4L2buf.memory = V4L2_MEMORY_MMAP;

iret = ioctl（fd_usbcam， VIDIOC_DQBUF， &tV4L2buf）;

-------------------------------------------------------------------------------------------------

說(shuō)明： VIDIOC_DQBUF命令結(jié)果，使從隊(duì)列刪除的緩沖幀信息傳給了此tVL2buf。

V4L2_buffer結(jié)構(gòu)體的作用就相當(dāng)于申請(qǐng)的緩沖幀的代理，找緩沖幀的都要先問(wèn)問(wèn)它，通過(guò)它來(lái)聯(lián)系緩沖幀，起了中間橋梁的作用。

8. 控制命令VIDIOC_STREAMON

功能：啟動(dòng)視頻采集命令，應(yīng)用程序調(diào)用VIDIOC_STREAMON啟動(dòng)視頻采集命令后，視頻設(shè)備驅(qū)動(dòng)程序開(kāi)始采集視頻數(shù)據(jù)，并把采集到的視頻數(shù)據(jù)保存到視頻驅(qū)動(dòng)的視頻緩沖區(qū)中。

參數(shù)說(shuō)明：參數(shù)類型為V4L2的視頻緩沖區(qū)類型 enum v4l2_buf_type ;

enum v4l2_buf_type {

V4L2_BUF_TYPE_VIDEO_CAPTURE = 1，

V4L2_BUF_TYPE_VIDEO_OUTPUT = 2，

V4L2_BUF_TYPE_VIDEO_OVERLAY = 3，

V4L2_BUF_TYPE_VBI_CAPTURE = 4，

V4L2_BUF_TYPE_VBI_OUTPUT = 5，

V4L2_BUF_TYPE_SLICED_VBI_CAPTURE = 6，

V4L2_BUF_TYPE_SLICED_VBI_OUTPUT = 7，

#if 1

/* Experimental */

V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY = 8，

#endif

V4L2_BUF_TYPE_PRIVATE = 0x80，

};

返回值說(shuō)明：執(zhí)行成功時(shí)，函數(shù)返回值為 0;函數(shù)執(zhí)行成功后，視頻設(shè)備驅(qū)動(dòng)程序開(kāi)始采集視頻數(shù)據(jù)，此時(shí)應(yīng)用程序一般通過(guò)調(diào)用select函數(shù)來(lái)判斷一幀視頻數(shù)據(jù)是否采集完成，

當(dāng)視頻設(shè)備驅(qū)動(dòng)完成一幀視頻數(shù)據(jù)采集并保存到視頻緩沖區(qū)中時(shí)，select函數(shù)返回，應(yīng)用程序接著可以讀取視頻數(shù)據(jù);否則select函數(shù)阻塞直到視頻數(shù)據(jù)采集完成。 Select函數(shù)的

使用請(qǐng)讀者參考相關(guān)資料。

使用舉例：

----------------------------------------------------------------------------------------------------------

enum v4l2_buf_type v4l2type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

fd_set fds ;

struct timeval tv;

iret = ioctl（fd_usbcam， VIDIOC_STREAMON， &v4l2type）;

FD_ZERO（&fds）;

FD_SET（fd_usbcam， &fds）;

tv.tv_sec = 2; /* Timeout. */

tv.tv_usec = 0;

iret = select（fd_usbcam+ 1， &fds， NULL， NULL， &tv）;

----------------------------------------------------------------------------------------------------------

9. 控制命令VIDIOC_STREAMOFF

功能：停止視頻采集命令，應(yīng)用程序調(diào)用VIDIOC_ STREAMOFF停止視頻采集命令后，視頻設(shè)備驅(qū)動(dòng)程序不在采集視頻數(shù)據(jù)。

參數(shù)說(shuō)明：參數(shù)類型為V4L2的視頻緩沖區(qū)類型 enum v4l2_buf_type;

返回值說(shuō)明：執(zhí)行成功時(shí)，函數(shù)返回值為 0;函數(shù)執(zhí)行成功后，視頻設(shè)備停止采集視頻數(shù)據(jù)。

使用舉例：

----------------------------------------------------------------------------------------------------------

enum v4l2_buf_type v4l2type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

iret = ioctl（fd_usbcam， VIDIOC_STREAMOFF， &v4l2type）;

-----------------------------------------------------------------------------------------------------------

10. 控制命令VIDIOC_QUERYSTD

功能：在亞洲，一般使用PAL（720X576）制式的攝像頭，而歐洲一般使用NTSC（720X480），使用VIDIOC_QUERYSTD來(lái)檢測(cè)：

參數(shù)說(shuō)明：

返回值說(shuō)明：

typedef __u64 v4l2_std_id;

使用舉例：

-----------------------------------------------------------------------------------------------------------

v4l2_std_id std;

do{

ret= ioctl（fd， VIDIOC_QUERYSTD， &std）;

} while（ret== -1 && errno== EAGAIN）;

switch（std） {

caseV4L2_STD_NTSC：

//……

caseV4L2_STD_PAL：

//……

}

-----------------------------------------------------------------------------------------------------------

以上就是Linux 視頻設(shè)備驅(qū)動(dòng)V4L2最常用的控制命令使用說(shuō)明，通過(guò)使用以上控制命令，可以完成一幅視頻數(shù)據(jù)的采集過(guò)程。

V4L2更多的控制命令使用說(shuō)明請(qǐng)參考：http://v4l2spec.bytesex.org/spec/book1.htm

下面是damo程序（經(jīng)過(guò)實(shí)際驗(yàn)證，修改了網(wǎng)上的例程的錯(cuò)誤）

-----------------------------------------------------------------------------------------------------------

#include

#define CAMERA_DEVICE “/dev/video0”

#define CAPTURE_FILE “frame.jpg”

#define VIDEO_WIDTH 640

#define VIDEO_HEIGHT 480

#define VIDEO_FORMAT V4L2_PIX_FMT_YUYV

#define BUFFER_COUNT 4

typedef struct VideoBuffer {

void *start;

size_t length;

} VideoBuffer;

VideoBuffer framebuf［BUFFER_COUNT］; //修改了錯(cuò)誤，2012-5.21

int main（）

{

int i， ret;

// 打開(kāi)設(shè)備

int fd;

fd = open（CAMERA_DEVICE， O_RDWR， 0）;

if （fd 《 0） {

printf（“Open %s failed\n”， CAMERA_DEVICE）;

return -1;

}

// 獲取驅(qū)動(dòng)信息

struct v4l2_capability cap;

ret = ioctl（fd， VIDIOC_QUERYCAP， &cap）;

if （ret 《 0） {

printf（“VIDIOC_QUERYCAP failed （%d）\n”， ret）;

return ret;

}

// Print capability infomations

printf（“Capability Informations：\n”）;

printf（“ driver： %s\n”， cap.driver）;

printf（“ card： %s\n”， cap.card）;

printf（“ bus_info： %s\n”， cap.bus_info）;

printf（“ version： %08X\n”， cap.version）;

printf（“ capabilities： %08X\n”， cap.capabilities）;

// 設(shè)置視頻格式

struct v4l2_format fmt;

memset（&fmt， 0， sizeof（fmt））;

fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

fmt.fmt.pix.width = VIDEO_WIDTH;

fmt.fmt.pix.height = VIDEO_HEIGHT;

fmt.fmt.pix.pixelformat = V4L2_PIX_FMT_YUYV;

fmt.fmt.pix.field = V4L2_FIELD_INTERLACED;

ret = ioctl（fd， VIDIOC_S_FMT， &fmt）;

if （ret 《 0） {

printf（“VIDIOC_S_FMT failed （%d）\n”， ret）;

return ret;

}

// 獲取視頻格式

ret = ioctl（fd， VIDIOC_G_FMT， &fmt）;

if （ret 《 0） {

printf（“VIDIOC_G_FMT failed （%d）\n”， ret）;

return ret;

}

// Print Stream Format

printf（“Stream Format Informations：\n”）;

printf（“ type： %d\n”， fmt.type）;

printf（“ width： %d\n”， fmt.fmt.pix.width）;

printf（“ height： %d\n”， fmt.fmt.pix.height）;

char fmtstr［8］;

memset（fmtstr， 0， 8）;

memcpy（fmtstr， &fmt.fmt.pix.pixelformat， 4）;

printf（“ pixelformat： %s\n”， fmtstr）;

printf（“ field： %d\n”， fmt.fmt.pix.field）;

printf（“ bytesperline： %d\n”， fmt.fmt.pix.bytesperline）;

printf（“ sizeimage： %d\n”， fmt.fmt.pix.sizeimage）;

printf（“ colorspace： %d\n”， fmt.fmt.pix.colorspace）;

printf（“ priv： %d\n”， fmt.fmt.pix.priv）;

printf（“ raw_date： %s\n”， fmt.fmt.raw_data）;

// 請(qǐng)求分配內(nèi)存

struct v4l2_requestbuffers reqbuf;

reqbuf.count = BUFFER_COUNT;

reqbuf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

reqbuf.memory = V4L2_MEMORY_MMAP;

ret = ioctl（fd ， VIDIOC_REQBUFS， &reqbuf）;

if（ret 《 0） {

printf（“VIDIOC_REQBUFS failed （%d）\n”， ret）;

return ret;

}

// 獲取空間

VideoBuffer* buffers = calloc（ reqbuf.count， sizeof（*buffers））;

struct v4l2_buffer buf;

for （i = 0; i 《 reqbuf.count; i++）

{

buf.index = i;

buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

buf.memory = V4L2_MEMORY_MMAP;

ret = ioctl（fd ， VIDIOC_QUERYBUF， &buf）;

if（ret 《 0） {

printf（“VIDIOC_QUERYBUF （%d） failed （%d）\n”， i， ret）;

return ret;

}

// mmap buffer

framebuf［i］.length = buf.length;

framebuf［i］.start = （char *） mmap（0， buf.length， PROT_READ|PROT_WRITE， MAP_SHARED， fd， buf.m.offset）;

if （framebuf［i］.start == MAP_FAILED） {

printf（“mmap （%d） failed： %s\n”， i， strerror（errno））;

return -1;

}

// Queen buffer

ret = ioctl（fd ， VIDIOC_QBUF， &buf）;

if （ret 《 0） {

printf（“VIDIOC_QBUF （%d） failed （%d）\n”， i， ret）;

return -1;

}

printf（“Frame buffer %d： address=0x%x， length=%d\n”， i，（unsigned int）framebuf［i］.start， framebuf［i］.length）;

}

// 開(kāi)始錄制

enum v4l2_buf_type type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

ret = ioctl（fd， VIDIOC_STREAMON， &type）;

if （ret 《 0） {

printf（“VIDIOC_STREAMON failed （%d）\n”， ret）;

return ret;

}

// Get frame

ret = ioctl（fd， VIDIOC_DQBUF， &buf）;

if （ret 《 0） {

printf（“VIDIOC_DQBUF failed （%d）\n”， ret）;

return ret;

}

// Process the frame

FILE *fp = fopen（CAPTURE_FILE， “wb”）;

if （fp 《 0） {

printf（“open frame data file failed\n”）;

return -1;

}

fwrite（framebuf［buf.index］.start， 1， buf.length， fp）;

fclose（fp）;

printf（“Capture one frame saved in %s\n”， CAPTURE_FILE）;

// Re-queen buffer

ret = ioctl（fd， VIDIOC_QBUF， &buf）;

if （ret 《 0） {

printf（“VIDIOC_QBUF failed （%d）\n”， ret）;

return ret;

}

// Release the resource

for （i=0; i《 4; i++）

{

munmap（framebuf［i］.start， framebuf［i］.length）;

}

close（fd）;

printf（“Camera test Done.\n”）;

return 0;

}

-----------------------------------------------------------------------------------------------------------

附件：

void *mmap（void *start， size_t length， int prot， int flags， int fd， off_t offset）;

int munmap（void *start， size_t length）;

參數(shù)說(shuō)明：

——start：映射區(qū)的開(kāi)始地址。

——length：映射區(qū)的長(zhǎng)度。

——prot：期望的內(nèi)存保護(hù)標(biāo)志，不能與文件的打開(kāi)模式?jīng)_突。是以下的某個(gè)值，可以通過(guò)or運(yùn)算合理地組合在一起

—PROT_EXEC //頁(yè)內(nèi)容可以被執(zhí)行

—PROT_READ //頁(yè)內(nèi)容可以被讀取

—PROT_WRITE //頁(yè)可以被寫(xiě)入

—PROT_NONE //頁(yè)不可訪問(wèn)

——flags：指定映射對(duì)象的類型，映射選項(xiàng)和映射頁(yè)是否可以共享。它的值可以是一個(gè)或者多個(gè)以下位的組合體

—MAP_FIXED //使用指定的映射起始地址，如果由start和len參數(shù)指定的內(nèi)存區(qū)重疊于現(xiàn)存的映射空間，重疊部分將會(huì)被丟棄。如果指定的起始地址不可用，操作將會(huì)失

敗。并且起始地址必須落在頁(yè)的邊界上。

—MAP_SHARED //與其它所有映射這個(gè)對(duì)象的進(jìn)程共享映射空間。對(duì)共享區(qū)的寫(xiě)入，相當(dāng)于輸出到文件。直到msync（）或者munmap（）被調(diào)用，文件實(shí)際上不會(huì)被更新。

—MAP_PRIVATE //建立一個(gè)寫(xiě)入時(shí)拷貝的私有映射。內(nèi)存區(qū)域的寫(xiě)入不會(huì)影響到原文件。這個(gè)標(biāo)志和以上標(biāo)志是互斥的，只能使用其中一個(gè)。

—MAP_DENYWRITE //這個(gè)標(biāo)志被忽略。

—MAP_EXECUTABLE //同上

—MAP_NORESERVE //不要為這個(gè)映射保留交換空間。當(dāng)交換空間被保留，對(duì)映射區(qū)修改的可能會(huì)得到保證。當(dāng)交換空間不被保留，同時(shí)內(nèi)存不足，對(duì)映射區(qū)的修改會(huì)引起

段違例信號(hào)。

—MAP_LOCKED //鎖定映射區(qū)的頁(yè)面，從而防止頁(yè)面被交換出內(nèi)存。

—MAP_GROWSDOWN //用于堆棧，告訴內(nèi)核VM系統(tǒng)，映射區(qū)可以向下擴(kuò)展。

—MAP_ANONYMOUS //匿名映射，映射區(qū)不與任何文件關(guān)聯(lián)。

—MAP_ANON //MAP_ANONYMOUS的別稱，不再被使用。

—MAP_FILE //兼容標(biāo)志，被忽略。

—MAP_32BIT //將映射區(qū)放在進(jìn)程地址空間的低2GB，MAP_FIXED指定時(shí)會(huì)被忽略。當(dāng)前這個(gè)標(biāo)志只在x86-64平臺(tái)上得到支持。

—MAP_POPULATE //為文件映射通過(guò)預(yù)讀的方式準(zhǔn)備好頁(yè)表。隨后對(duì)映射區(qū)的訪問(wèn)不會(huì)被頁(yè)違例阻塞。

—MAP_NONBLOCK //僅和MAP_POPULATE一起使用時(shí)才有意義。不執(zhí)行預(yù)讀，只為已存在于內(nèi)存中的頁(yè)面建立頁(yè)表入口。

——fd：有效的文件描述詞。如果MAP_ANONYMOUS被設(shè)定，為了兼容問(wèn)題，其值應(yīng)為-1。

——offset：被映射對(duì)象內(nèi)容的起點(diǎn)。

返回值：

成功執(zhí)行時(shí)，mmap（）返回被映射區(qū)的指針，munmap（）返回0。

失敗時(shí)，mmap（）返回MAP_FAILED［其值為（void *）-1］，munmap返回-1。errno被設(shè)為以下的某個(gè)值。

閱讀全文

V4L2(4159) V4L2(4159)
內(nèi)核驅(qū)動(dòng)(2884) 內(nèi)核驅(qū)動(dòng)(2884)
控制命令(2326) 控制命令(2326)

評(píng)論

搜索歷史

怎樣使用V4L2最常用的控制命令

評(píng)論