search
HomeDatabaseMysql Tutorialv4l2 编程接口(一) — ioctl
v4l2 编程接口(一) — ioctl
WBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWB
WBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWB
Jun 07, 2016 pm 03:32 PM
appinterfacedataprogrammingObtainvideo

在应用程序获取视频数据的流程中，都是通过 ioctl 命令与驱动程序进行交互，常见的 ioctl 命令有： [cpp] view plaincopyprint? VIDIOC_QUERYCAP /*获取设备支持的操作*/ VIDIOC_G_FMT /*获取设置支持的视频式*/ VIDIOC_S_FMT /*设置捕获视频的式*/ VIDIOC_R

在应用程序获取视频数据的流程中，都是通过 ioctl 命令与驱动程序进行交互，常见的 ioctl 命令有：

[cpp] view plaincopyprint?

  1. VIDIOC_QUERYCAP     /* 获取设备支持的操作 */  
  2. VIDIOC_G_FMT        /* 获取设置支持的视频格式 */  
  3. VIDIOC_S_FMT        /* 设置捕获视频的格式 */  
  4. VIDIOC_REQBUFS      /* 向驱动提出申请内存的请求 */  
  5. VIDIOC_QUERYBUF     /* 向驱动查询申请到的内存 */  
  6. VIDIOC_QBUF         /* 将空闲的内存加入可捕获视频的队列 */  
  7. VIDIOC_DQBUF        /* 将已经捕获好视频的内存拉出已捕获视频的队列 */  
  8. VIDIOC_STREAMON     /* 打开视频流 */  
  9. VIDIOC_STREAMOFF    /* 关闭视频流 */  
  10. VIDIOC_QUERYCTRL    /* 查询驱动是否支持该命令 */  
  11. VIDIOC_G_CTRL       /* 获取当前命令值 */  
  12. VIDIOC_S_CTRL       /* 设置新的命令值 */  
  13. VIDIOC_G_TUNER      /* 获取调谐器信息 */  
  14. VIDIOC_S_TUNER      /* 设置调谐器信息 */  
  15. VIDIOC_G_FREQUENCY  /* 获取调谐器频率 */  
  16. VIDIOC_S_FREQUENCY  /* 设置调谐器频率 */   
VIDIOC_QUERYCAP     /* 获取设备支持的操作 */
VIDIOC_G_FMT        /* 获取设置支持的视频格式 */
VIDIOC_S_FMT        /* 设置捕获视频的格式 */
VIDIOC_REQBUFS      /* 向驱动提出申请内存的请求 */
VIDIOC_QUERYBUF     /* 向驱动查询申请到的内存 */
VIDIOC_QBUF         /* 将空闲的内存加入可捕获视频的队列 */
VIDIOC_DQBUF        /* 将已经捕获好视频的内存拉出已捕获视频的队列 */
VIDIOC_STREAMON     /* 打开视频流 */
VIDIOC_STREAMOFF    /* 关闭视频流 */
VIDIOC_QUERYCTRL    /* 查询驱动是否支持该命令 */
VIDIOC_G_CTRL       /* 获取当前命令值 */
VIDIOC_S_CTRL       /* 设置新的命令值 */
VIDIOC_G_TUNER      /* 获取调谐器信息 */
VIDIOC_S_TUNER      /* 设置调谐器信息 */
VIDIOC_G_FREQUENCY  /* 获取调谐器频率 */
VIDIOC_S_FREQUENCY  /* 设置调谐器频率 */
1、struct v4l2_capability 与 VIDIOC_QUERYCAP
VIDIOC_QUERYCAP 命令通过结构 v4l2_capability 获取设备支持的操作模式：

[cpp] view plaincopyprint?

  1. struct v4l2_capability {  
  2.     __u8    driver[16];     /* i.e. "bttv" */  
  3.     __u8    card[32];       /* i.e. "Hauppauge WinTV" */  
  4.     __u8    bus_info[32];   /* "PCI:" + pci_name(pci_dev) */  
  5.     __u32   version;        /* should use KERNEL_VERSION() */  
  6.     __u32   capabilities;   /* Device capabilities */  
  7.     __u32   reserved[4];  
  8. };  
struct v4l2_capability {
	__u8	driver[16];     /* i.e. "bttv" */
	__u8	card[32];       /* i.e. "Hauppauge WinTV" */
	__u8	bus_info[32];   /* "PCI:" + pci_name(pci_dev) */
	__u32   version;        /* should use KERNEL_VERSION() */
	__u32	capabilities;   /* Device capabilities */
	__u32	reserved[4];
};
其中域 capabilities 代表设备支持的操作模式，常见的值有 V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_STREAMING 表示是一个视频捕捉设备并且具有数据流控制模式；另外 driver 域需要和 struct video_device 中的 name 匹配。
2、struct v4l2_format 与 VIDIOC_G_FMT、VIDIOC_S_FMT、VIDIOC_TRY_FMT

通常用 VIDIOC_S_FMT 命令通过结构 v4l2_format 初始化捕获视频的格式，如果要改变格式则用 VIDIOC_TRY_FMT 命令：

[cpp] view plaincopyprint?

  1. struct v4l2_format {  
  2.     enum v4l2_buf_type type;  
  3.     union {  
  4.         struct v4l2_pix_format         pix;     /* V4L2_BUF_TYPE_VIDEO_CAPTURE */  
  5.         struct v4l2_window             win;     /* V4L2_BUF_TYPE_VIDEO_OVERLAY */  
  6.         struct v4l2_vbi_format         vbi;     /* V4L2_BUF_TYPE_VBI_CAPTURE */  
  7.         struct v4l2_sliced_vbi_format  sliced;  /* V4L2_BUF_TYPE_SLICED_VBI_CAPTURE */  
  8.         __u8   raw_data[200];                   /* user-defined */  
  9.     } fmt;  
  10. };  
  11. 其中  
  12. enum v4l2_buf_type {  
  13.     V4L2_BUF_TYPE_VIDEO_CAPTURE        = 1,  
  14.     V4L2_BUF_TYPE_VIDEO_OUTPUT         = 2,  
  15.     V4L2_BUF_TYPE_VIDEO_OVERLAY        = 3,  
  16.     ...  
  17.     V4L2_BUF_TYPE_PRIVATE              = 0x80,  
  18. };  
  19.   
  20. struct v4l2_pix_format {  
  21.     __u32                   width;  
  22.     __u32                   height;  
  23.     __u32                   pixelformat;  
  24.     enum v4l2_field         field;  
  25.     __u32                   bytesperline;   /* for padding, zero if unused */  
  26.     __u32                   sizeimage;  
  27.     enum v4l2_colorspace    colorspace;  
  28.     __u32                   priv;           /* private data, depends on pixelformat */  
  29. };  
struct v4l2_format {
	enum v4l2_buf_type type;
	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;
};
其中
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_PRIVATE              = 0x80,
};

struct v4l2_pix_format {
	__u32                   width;
	__u32                   height;
	__u32                   pixelformat;
	enum v4l2_field         field;
	__u32                   bytesperline;   /* for padding, zero if unused */
	__u32                   sizeimage;
	enum v4l2_colorspace    colorspace;
	__u32                   priv;           /* private data, depends on pixelformat */
};
常见的捕获模式为 V4L2_BUF_TYPE_VIDEO_CAPTURE 即视频捕捉模式，在此模式下 fmt 联合体采用域 v4l2_pix_format：其中 width 为视频的宽、height 为视频的高、pixelformat 为视频数据格式（常见的值有 V4L2_PIX_FMT_YUV422P | V4L2_PIX_FMT_RGB565）、bytesperline 为一行图像占用的字节数、sizeimage 则为图像占用的总字节数、colorspace 指定设备的颜色空间。
3、struct v4l2_requestbuffers 与 VIDIOC_REQBUFS

VIDIOC_REQBUFS 命令通过结构 v4l2_requestbuffers 请求驱动申请一片连续的内存用于缓存视频信息：

[cpp] view plaincopyprint?

  1. struct v4l2_requestbuffers {  
  2.     __u32                   count;  
  3.     enum v4l2_buf_type      type;  
  4.     enum v4l2_memory        memory;  
  5.     __u32                   reserved[2];  
  6. };  
  7. 其中  
  8. enum v4l2_memory {  
  9.     V4L2_MEMORY_MMAP             = 1,  
  10.     V4L2_MEMORY_USERPTR          = 2,  
  11.     V4L2_MEMORY_OVERLAY          = 3,  
  12. };  
struct v4l2_requestbuffers {
	__u32                   count;
	enum v4l2_buf_type      type;
	enum v4l2_memory        memory;
	__u32                   reserved[2];
};
其中
enum v4l2_memory {
	V4L2_MEMORY_MMAP             = 1,
	V4L2_MEMORY_USERPTR          = 2,
	V4L2_MEMORY_OVERLAY          = 3,
};
count 指定根据图像占用空间大小申请的缓存区个数，type 为视频捕获模式，memory 为内存区的使用方式。

4、struct v4l2_buffer与 VIDIOC_QUERYBUF

VIDIOC_QUERYBUF 命令通过结构 v4l2_buffer 查询驱动申请的内存区信息：

[cpp] view plaincopyprint?

  1. struct v4l2_buffer {  
  2.     __u32                   index;  
  3.     enum v4l2_buf_type      type;  
  4.     __u32                   bytesused;  
  5.     __u32                   flags;  
  6.     enum v4l2_field         field;  
  7.     struct timeval          timestamp;  
  8.     struct v4l2_timecode    timecode;  
  9.     __u32                   sequence;  
  10.   
  11.     /* memory location */  
  12.     enum v4l2_memory        memory;  
  13.     union {  
  14.             __u32           offset;  
  15.             unsigned long   userptr;  
  16.     } m;  
  17.     __u32                   length;  
  18.     __u32                   input;  
  19.     __u32                   reserved;  
  20. };  
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;
};
index 为缓存编号，type 为视频捕获模式，bytesused 为缓存已使用空间大小，flags 为缓存当前状态（常见值有 V4L2_BUF_FLAG_MAPPED | V4L2_BUF_FLAG_QUEUED | V4L2_BUF_FLAG_DONE，分别代表当前缓存已经映射、缓存可以采集数据、缓存可以提取数据），timestamp 为时间戳，sequence为缓存序号，memory 为缓存使用方式，offset 为当前缓存与内存区起始地址的偏移，length 为缓存大小，reserved 一般用于传递物理地址值。
另外 VIDIOC_QBUF 和 VIDIOC_DQBUF 命令都采用结构 v4l2_buffer 与驱动通信：VIDIOC_QBUF 命令向驱动传递应用程序已经处理完的缓存，即将缓存加入空闲可捕获视频的队列，传递的主要参数为 index；VIDIOC_DQBUF 命令向驱动获取已经存放有视频数据的缓存，v4l2_buffer 的各个域几乎都会被更新，但主要的参数也是 index，应用程序会根据 index 确定可用数据的起始地址和范围。

5、enum v4l2_buf_type 与 VIDIOC_STREAMON、VIDIOC_STREAMOFF

这两个命令使用的只是一个整形数据，即 v4l2_buf_type，一般只要指定其值为 V4L2_BUF_TYPE_VIDEO_CAPTURE 即可。

6、struct v4l2_queryctrl 与 VIDIOC_QUERYCTRL

VIDIOC_QUERYCTRL 命令通过结构 v4l2_queryctrl 查询驱动是否支持该 id 代表的命令，并返回该命令的各种参数：

[cpp] view plaincopyprint?

  1. struct v4l2_queryctrl {  
  2.     __u32                id;            /* 命令编号 */  
  3.     enum v4l2_ctrl_type  type;          /* 命令值的类型 */  
  4.     __u8                 name[32];      /* 命令名称*/  
  5.     __s32                minimum;       /* 最小的命令值 */  
  6.     __s32                maximum;       /* 最大的命令值 */  
  7.     __s32                step;          /* 命令值变化的步长 */  
  8.     __s32                default_value; /* 默认的命令值 */  
  9.     __u32                flags;         /* 命令的标志 */  
  10.     __u32                reserved[2];   /* 命令值的位图表示 */  
  11. };  
  12. 其中  
  13. enum v4l2_ctrl_type {  
  14.     V4L2_CTRL_TYPE_INTEGER       = 1,   /* 整形 */  
  15.     V4L2_CTRL_TYPE_BOOLEAN       = 2,   /* 真值 */  
  16.     V4L2_CTRL_TYPE_MENU          = 3,   /* 菜单 */  
  17.     V4L2_CTRL_TYPE_BUTTON        = 4,   /* 无值 */  
  18.     V4L2_CTRL_TYPE_INTEGER64     = 5,   /* 后面三种不常用 */  
  19.     V4L2_CTRL_TYPE_CTRL_CLASS    = 6,  
  20.     V4L2_CTRL_TYPE_STRING        = 7,  
  21. };  
  22. 命令的标志取值如下：  
  23. /*  Control flags  */  
  24. #define V4L2_CTRL_FLAG_DISABLED     0x0001   
  25. #define V4L2_CTRL_FLAG_GRABBED      0x0002   
  26. #define V4L2_CTRL_FLAG_READ_ONLY    0x0004   
  27. #define V4L2_CTRL_FLAG_UPDATE       0x0008   
  28. #define V4L2_CTRL_FLAG_INACTIVE     0x0010   
  29. #define V4L2_CTRL_FLAG_SLIDER       0x0020   
  30. #define V4L2_CTRL_FLAG_WRITE_ONLY   0x0040   
  31.   
  32. /*  Query flag, to be ORed with the control ID */  
  33. #define V4L2_CTRL_FLAG_NEXT_CTRL    0x80000000   
struct v4l2_queryctrl {
	__u32                id;            /* 命令编号 */
	enum v4l2_ctrl_type  type;          /* 命令值的类型 */
	__u8                 name[32];	    /* 命令名称*/
	__s32                minimum;       /* 最小的命令值 */
	__s32                maximum;       /* 最大的命令值 */
	__s32                step;          /* 命令值变化的步长 */
	__s32                default_value; /* 默认的命令值 */
	__u32                flags;         /* 命令的标志 */
	__u32                reserved[2];   /* 命令值的位图表示 */
};
其中
enum v4l2_ctrl_type {
	V4L2_CTRL_TYPE_INTEGER	     = 1,   /* 整形 */
	V4L2_CTRL_TYPE_BOOLEAN	     = 2,   /* 真值 */
	V4L2_CTRL_TYPE_MENU          = 3,   /* 菜单 */
	V4L2_CTRL_TYPE_BUTTON	     = 4,   /* 无值 */
	V4L2_CTRL_TYPE_INTEGER64     = 5,   /* 后面三种不常用 */
	V4L2_CTRL_TYPE_CTRL_CLASS    = 6,
	V4L2_CTRL_TYPE_STRING        = 7,
};
命令的标志取值如下：
/*  Control flags  */
#define V4L2_CTRL_FLAG_DISABLED		0x0001
#define V4L2_CTRL_FLAG_GRABBED		0x0002
#define V4L2_CTRL_FLAG_READ_ONLY 	0x0004
#define V4L2_CTRL_FLAG_UPDATE 		0x0008
#define V4L2_CTRL_FLAG_INACTIVE 	0x0010
#define V4L2_CTRL_FLAG_SLIDER 		0x0020
#define V4L2_CTRL_FLAG_WRITE_ONLY 	0x0040

/*  Query flag, to be ORed with the control ID */
#define V4L2_CTRL_FLAG_NEXT_CTRL	0x80000000

id 是命令的编号，常见的命令有两种：一种以 V4L2_CID_BASE 为起始值，是公用命令；一种以 V4L2_CID_PRIVATE_BASE 为起始值，是私有命令。在一般的应用中命令值可见如下：

[cpp] view plaincopyprint?

  1. V4L2_CID_CONTRAST               (V4L2_CID_BASE+1)            /* 对比度调节 */  
  2. V4L2_CID_SATURATION             (V4L2_CID_BASE+2)            /* 饱和度调节 */  
  3. V4L2_CID_AUDIO_VOLUME           (V4L2_CID_BASE+5)            /* 音量调节 */  
  4. V4L2_CID_AUDIO_MUTE             (V4L2_CID_BASE+9)            /* 静音设置 */  
  5. V4L2_CID_DO_WHITE_BALANCE       (V4L2_CID_BASE+13)           /* 白平衡调节 */  
  6. V4L2_CID_GAMMA                  (V4L2_CID_BASE+16)           /* 伽马值调节 */  
  7. V4L2_CID_EXPOSURE               (V4L2_CID_BASE+17)           /* 曝光度调节 */  
  8.   
  9. V4L2_CID_PRIVATE_ATXX_FLASH     (V4L2_CID_PRIVATE_BASE + 2)  /* 闪光灯控制 */  
  10. V4L2_CID_PRIVATE_ATXX_FRAME     (V4L2_CID_PRIVATE_BASE + 12) /* 帧率调节 */   
V4L2_CID_CONTRAST               (V4L2_CID_BASE+1)            /* 对比度调节 */
V4L2_CID_SATURATION             (V4L2_CID_BASE+2)            /* 饱和度调节 */
V4L2_CID_AUDIO_VOLUME           (V4L2_CID_BASE+5)            /* 音量调节 */
V4L2_CID_AUDIO_MUTE             (V4L2_CID_BASE+9)            /* 静音设置 */
V4L2_CID_DO_WHITE_BALANCE       (V4L2_CID_BASE+13)           /* 白平衡调节 */
V4L2_CID_GAMMA                  (V4L2_CID_BASE+16)           /* 伽马值调节 */
V4L2_CID_EXPOSURE               (V4L2_CID_BASE+17)           /* 曝光度调节 */

V4L2_CID_PRIVATE_ATXX_FLASH     (V4L2_CID_PRIVATE_BASE + 2)  /* 闪光灯控制 */
V4L2_CID_PRIVATE_ATXX_FRAME     (V4L2_CID_PRIVATE_BASE + 12) /* 帧率调节 */

 type 为命令值的类型（总共有7中类型的值），name 是命令的名称，reserved 则是命令值的位图表示，驱动会将所有的命令值都以 bit 的形式写到 64 位的域中，上层应用查询时可以根据位图判断命令支持的值。

7、struct v4l2_control 与 VIDIOC_G_CTRL、VIDIOC_S_CTRL

VIDIOC_S_CTRL 或 VIDIOC_G_CTRL 命令通过结构 v4l2_control 设置或者获取 id 命令的值：

[cpp] view plaincopyprint?

  1. struct v4l2_control {  
  2.     __u32            id;  
  3.     __s32            value;  
  4. };  
struct v4l2_control {
	__u32		     id;
	__s32		     value;
};

这个结构只有 2 个域，id 是命令编号，value 则是命令的值。

8、struct v4l2_tuner 与 VIDIOC_G_TUNER、VIDIOC_S_TUNER

VIDIOC_S_TUNER 或 VIDIOC_G_TUNER 命令通过结构 v4l2_tuner 设置调谐器的信息：

[cpp] view plaincopyprint?

  1. struct v4l2_tuner {  
  2.     __u32                   index;           /* 调谐器编号，由应用程序设置 */  
  3.     __u8                    name[32];        /* 调谐器名称 */  
  4.     enum v4l2_tuner_type    type;            /* 调谐器类型 */  
  5.     __u32                   capability;      /* 调谐器支持的操作 */  
  6.     __u32                   rangelow;        /* 最低频率值，单位为62.5Hz或者62.5KHz */  
  7.     __u32                   rangehigh;       /* 最高频率值 */  
  8.     __u32                   rxsubchans;      /* 接收的音频信号类型 */  
  9.     __u32                   audmode;         /* 当前音频播放形式 */  
  10.     __s32                   signal;          /* 信号强度 */  
  11.     __s32                   afc;             /* 自动频率控制 */  
  12.     __u32                   reserved[4];     /* 保留备用 */  
  13. };  
  14. 其中  
  15. enum v4l2_tuner_type {  
  16.     V4L2_TUNER_RADIO             = 1,        /* 调频收音机 */  
  17.     V4L2_TUNER_ANALOG_TV         = 2,        /* 模拟电视高频头 */  
  18.     V4L2_TUNER_DIGITAL_TV        = 3,        /* 数字电视高频头 */  
  19. };  
struct v4l2_tuner {
	__u32                   index;           /* 调谐器编号，由应用程序设置 */
	__u8                    name[32];        /* 调谐器名称 */
	enum v4l2_tuner_type    type;            /* 调谐器类型 */
	__u32                   capability;      /* 调谐器支持的操作 */
	__u32                   rangelow;        /* 最低频率值，单位为62.5Hz或者62.5KHz */
	__u32                   rangehigh;       /* 最高频率值 */
	__u32                   rxsubchans;      /* 接收的音频信号类型 */
	__u32                   audmode;         /* 当前音频播放形式 */
	__s32                   signal;          /* 信号强度 */
	__s32                   afc;             /* 自动频率控制 */
	__u32                   reserved[4];     /* 保留备用 */
};
其中
enum v4l2_tuner_type {
	V4L2_TUNER_RADIO             = 1,        /* 调频收音机 */
	V4L2_TUNER_ANALOG_TV         = 2,        /* 模拟电视高频头 */
	V4L2_TUNER_DIGITAL_TV        = 3,        /* 数字电视高频头 */
};
其中域 type 有三种类型；capability 域一般为 V4L2_TUNER_CAP_LOW，表明频率调节的步长是62.5Hz，如果没有这个标志位则步长为62.5KHz；rangelow 与 rangehigh 是调谐器可以调频率的最高值和最低值，但都以步长为单位表示；rxsubchans 表示调谐器接收的音频信号类型，常见值有 V4L2_TUNER_SUB_MONO | V4L2_TUNER_SUB_STEREO  即单声道与立体声；audmode 表示以何种方式播放声音，常见值有 V4L2_TUNER_MODE_MONO | V4L2_TUNER_MODE_STEREO，即以单声道还是立体声的方式播放；signal 为当前信号强度，一般取值范围为 0 - 65535。
9、struct v4l2_frequency 与 VIDIOC_G_FREQUENCY、VIDIOC_S_FREQUENCY

VIDIOC_S_FREQUENCY 或 VIDIOC_G_FREQUENCY 命令通过结构 v4l2_frequency 设置或获取当前频率值：

[cpp] view plaincopyprint?

  1. struct v4l2_frequency {  
  2.     __u32                 tuner;          /* 调谐器编号 */  
  3.     enum v4l2_tuner_type  type;           /* 调谐器类型 */  
  4.     __u32                 frequency;      /* 调谐器频率 */  
  5.     __u32                 reserved[8];  
  6. };  
struct v4l2_frequency {
	__u32                 tuner;          /* 调谐器编号 */
	enum v4l2_tuner_type  type;           /* 调谐器类型 */
	__u32                 frequency;      /* 调谐器频率 */
	__u32                 reserved[8];
};
注意：frequency 的值是以62.5Hz 或者 62.5KHZ 为单位的。

附：_IO、_IOR、_IOW、_IOWR 宏的使用说明

驱动程序中 ioctl  函数传递的变量 cmd 是应用程序向驱动程序请求处理的命令。cmd 除了用于区别不同命令的数值，还可包含有助于处理的几种信息。cmd 的大小为 32 bit，共分 4 个域：

bit29 ~ bit31： 3bit  为 “读写” 区，作用是区分是读命令还是写命令。
bit16 ~ bit28：13bit 为 "数据大小" 区，表示 ioctl 中的 arg 变量传递的数据大小；有时候为 14bit 即将 bit29 覆盖。
bit8 ~ bit15：   8bit  为 “魔数"(也称为"幻数")区，这个值用以与其它设备驱动程序的 ioctl 命令进行区别。
bit0 ~ bit7：     8bit  为 "序号" 区，是区分命令的命令顺序序号。

魔数（magic number）
魔数范围为 0~255 。通常，用英文字符 'A' ~ 'Z' 或者 'a' ~ 'z' 来表示。设备驱动程序从传递进来的命令获取魔数，然后与自身处理的魔数想比较，如果相同则处理，不同则不处理。魔数是拒绝误使用的初步辅助参数。设备驱动程序可以通过宏 _IOC_TYPE (cmd) 来获取魔数。不同的设备驱动程序最好设置不同的魔数，但并不是要求绝对，也是可以使用其他设备驱动程序已用过的魔数。

基数（序号）
基数用于区别各种命令。通常，从 0开始递增，相同设备驱动程序上可以重复使用该值。例如，读和写命令中使用了相同的基数，设备驱动程序也能分辨出来，原因在于设备驱动程序区分命令时使用 switch ，且直接使用命令变量 cmd 值。创建命令的宏生成的值由多个域组合而成，所以即使是相同的基数，也会判断为不同的命令。设备驱动程序想要从命令中获取该基数，就使用宏 _IOC_NR (cmd)。

下面我们看一下上述宏在内核中的原型：

[cpp] view plaincopyprint?

  1. /* 
  2.  * Our DIR and SIZE overlap in order to simulteneously provide 
  3.  * a non-zero _IOC_NONE (for binary compatibility) and 
  4.  * 14 bits of size as on i386. Here's the layout: 
  5.  * 
  6.  *   0xE0000000   DIR            3bit 
  7.  *   0x80000000   DIR = WRITE    bit31 
  8.  *   0x40000000   DIR = READ     bit30 
  9.  *   0x20000000   DIR = NONE     bit29 
  10.  *   0x3FFF0000   SIZE (overlaps NONE bit)  13bit 
  11.  *   0x0000FF00   TYPE           8bit 
  12.  *   0x000000FF   NR (CMD)       8bit 
  13.  */  
  14. /* 各个域的长度 */  
  15. #define _IOC_NRBITS      8   
  16. #define _IOC_TYPEBITS    8   
  17. #define _IOC_SIZEBITS   13  /* Actually 14, see below. */   
  18. #define _IOC_DIRBITS     3   
  19. /* 各个域的掩码 */  
  20. #define _IOC_NRMASK      ((1   
  21. #define _IOC_TYPEMASK    ((1   
  22. #define _IOC_SIZEMASK    ((1   
  23. #define _IOC_XSIZEMASK   ((1   
  24. #define _IOC_DIRMASK     ((1   
  25. /* 各个域的偏移 */  
  26. #define _IOC_NRSHIFT     0   
  27. #define _IOC_TYPESHIFT   (_IOC_NRSHIFT + _IOC_NRBITS)       /* 8 */   
  28. #define _IOC_SIZESHIFT   (_IOC_TYPESHIFT + _IOC_TYPEBITS)   /* 16 */   
  29. #define _IOC_DIRSHIFT    (_IOC_SIZESHIFT + _IOC_SIZEBITS)   /* 29 */   
  30. /* 读写域的值 */  
  31. #define _IOC_NONE        1U   
  32. #define _IOC_READ        2U   
  33. #define _IOC_WRITE       4U   
  34.   
  35. #define _IOC(dir,type,nr,size) \   
  36.         (((dir)  /* 读写方向左移 29bit */  
  37.          ((type) /* 幻数左移 8bit */  
  38.          ((nr)   /* 命令序号 */  
  39.          ((size) /* 参数大小左移 16bit */  
  40. /* 宏原型，这里将会根据传递的数据类型取其长度 */  
  41. #define _IO(type,nr)        _IOC(_IOC_NONE,(type),(nr),0)   
  42. #define _IOR(type,nr,size)  _IOC(_IOC_READ,(type),(nr),sizeof(size))   
  43. #define _IOW(type,nr,size)  _IOC(_IOC_WRITE,(type),(nr),sizeof(size))   
  44. #define _IOWR(type,nr,size) _IOC(_IOC_READ|_IOC_WRITE,(type),(nr),sizeof(size))   
  45. /* 获取各个域的值 */  
  46. #define _IOC_DIR(nr)        (((nr) >> _IOC_DIRSHIFT) & _IOC_DIRMASK)   
  47. #define _IOC_TYPE(nr)       (((nr) >> _IOC_TYPESHIFT) & _IOC_TYPEMASK)   
  48. #define _IOC_NR(nr)         (((nr) >> _IOC_NRSHIFT) & _IOC_NRMASK)   
  49. #define _IOC_SIZE(nr)       (((nr) >> _IOC_SIZESHIFT) & _IOC_SIZEMASK)   
/*
 * Our DIR and SIZE overlap in order to simulteneously provide
 * a non-zero _IOC_NONE (for binary compatibility) and
 * 14 bits of size as on i386. Here's the layout:
 *
 *   0xE0000000   DIR            3bit
 *   0x80000000   DIR = WRITE    bit31
 *   0x40000000   DIR = READ     bit30
 *   0x20000000   DIR = NONE     bit29
 *   0x3FFF0000   SIZE (overlaps NONE bit)  13bit
 *   0x0000FF00   TYPE           8bit
 *   0x000000FF   NR (CMD)       8bit
 */
/* 各个域的长度 */
#define _IOC_NRBITS      8
#define _IOC_TYPEBITS    8
#define _IOC_SIZEBITS   13	/* Actually 14, see below. */
#define _IOC_DIRBITS     3
/* 各个域的掩码 */
#define _IOC_NRMASK      ((1 > _IOC_DIRSHIFT) & _IOC_DIRMASK)
#define _IOC_TYPE(nr)       (((nr) >> _IOC_TYPESHIFT) & _IOC_TYPEMASK)
#define _IOC_NR(nr)         (((nr) >> _IOC_NRSHIFT) & _IOC_NRMASK)
#define _IOC_SIZE(nr)       (((nr) >> _IOC_SIZESHIFT) & _IOC_SIZEMASK)
这里特别说明一下 _IO 宏，该宏没有可传递的变量，只用于发送命令。这是因为变量需要可变数据，只作为命令（比如 reset）使用时，没有必要判断设备上的数据，因此设备驱动程序没有必要执行文件相关的处理。在 v4l2 中使用示例如下：

[cpp] view plaincopyprint?

  1. #define VIDIOC_QUERYCAP      _IOR('V',  0, struct v4l2_capability)   
  2. #define VIDIOC_RESERVED       _IO('V',  1)   
  3. #define VIDIOC_S_FMT        _IOWR('V',  5, struct v4l2_format)   
  4. #define VIDIOC_STREAMON      _IOW('V', 18, int)   
#define VIDIOC_QUERYCAP      _IOR('V',  0, struct v4l2_capability)
#define VIDIOC_RESERVED       _IO('V',  1)
#define VIDIOC_S_FMT        _IOWR('V',  5, struct v4l2_format)
#define VIDIOC_STREAMON      _IOW('V', 18, int)
v4l2 中对上述宏命令的处理在 video_ioctl2 函数中：

[cpp] view plaincopyprint?

  1. static unsigned long cmd_input_size(unsigned int cmd)  
  2. {  
  3. #define CMDINSIZE(cmd, type, field)                 \   
  4.     case VIDIOC_##cmd:                  \  
  5.         return offsetof(struct v4l2_##type, field) +    \  /* 域的偏移 */  
  6.             sizeof(((struct v4l2_##type *)0)->field);      /* 域的长度 */  
  7.   
  8.     switch (cmd) {  
  9.         CMDINSIZE(ENUM_FMT,     fmtdesc,    type);  
  10.         CMDINSIZE(G_FMT,        format,     type);  
  11.         ...  
  12.         CMDINSIZE(ENUM_FRAMESIZES,  frmsizeenum,    pixel_format);  
  13.         CMDINSIZE(ENUM_FRAMEINTERVALS,  frmivalenum,    height);  
  14.     default:  
  15.         return _IOC_SIZE(cmd);  /* 剩下的是需要全部拷贝的命令 */  
  16.     }  
  17. }  
  18.   
  19. long video_ioctl2(struct file *file, unsigned int cmd, unsigned long arg)  
  20. {  
  21.     char    sbuf[128];          /* 在栈中分配128个字节空间用来储存命令的参数 */  
  22.     void    *mbuf = NULL;  
  23.     void    *parg = NULL;       /* 参数存放的首地址 */  
  24.     long    err  = -EINVAL;  
  25.     int     is_ext_ctrl;  
  26.     size_t  ctrls_size = 0;  
  27.     void __user *user_ptr = NULL;  
  28.   
  29.     ...  
  30.     /* 判断是否包含读写命令,如果是则将用户空间的参数值拷贝到内核 */  
  31.     if (_IOC_DIR(cmd) != _IOC_NONE) {  
  32.         /* 判断参数大小是否超过128字节 */  
  33.         if (_IOC_SIZE(cmd) sizeof(sbuf)) {  
  34.             parg = sbuf;  
  35.         } else {  
  36.             /* 如果超过128字节则从堆中申请 */  
  37.             mbuf = kmalloc(_IOC_SIZE(cmd), GFP_KERNEL);  
  38.             if (NULL == mbuf)  
  39.                 return -ENOMEM;  
  40.             parg = mbuf;  
  41.         }  
  42.   
  43.         err = -EFAULT;  
  44.         /* 如果包含写命令 */  
  45.         if (_IOC_DIR(cmd) & _IOC_WRITE) {  
  46.             /* 计算需要拷贝的有效数据长度,有的命令不需要全部拷贝 */  
  47.             unsigned long n = cmd_input_size(cmd);  
  48.             /* 从用户空间拷贝参数值 */  
  49.             if (copy_from_user(parg, (void __user *)arg, n))  
  50.                 goto out;  
  51.   
  52.             /* 将剩下的空间清零 */  
  53.             if (n 
  54.                 memset((u8 *)parg + n, 0, _IOC_SIZE(cmd) - n);  
  55.         } else {  
  56.             /* 如果是只读命令则将整个buffer清零 */  
  57.             memset(parg, 0, _IOC_SIZE(cmd));  
  58.         }  
  59.     }  
  60.   
  61.     ...  
  62.     /* 调用 v4l2_ioctl_ops 的成员函数处理命令 */  
  63.     err = __video_do_ioctl(file, cmd, parg);  
  64.     if (err == -ENOIOCTLCMD)  
  65.         err = -EINVAL;  
  66.     ...  
  67.     if (err 
  68.         goto out;  
  69.   
  70. out_ext_ctrl:  
  71.     /* 如果包含读命令则将参数值拷贝到用户空间 */  
  72.     switch (_IOC_DIR(cmd)) {  
  73.     case _IOC_READ:  
  74.     case (_IOC_WRITE | _IOC_READ):  
  75.         if (copy_to_user((void __user *)arg, parg, _IOC_SIZE(cmd)))  
  76.             err = -EFAULT;  
  77.         break;  
  78.     }  
  79.   
  80. out:  
  81.     kfree(mbuf);  
  82.     return err;  
  83. }  
  84. EXPORT_SYMBOL(video_ioctl2);  
static unsigned long cmd_input_size(unsigned int cmd)
{
#define CMDINSIZE(cmd, type, field) 				\
	case VIDIOC_##cmd: 					\
		return offsetof(struct v4l2_##type, field) + 	\  /* 域的偏移 */
			sizeof(((struct v4l2_##type *)0)->field);      /* 域的长度 */

	switch (cmd) {
		CMDINSIZE(ENUM_FMT,		fmtdesc,	type);
		CMDINSIZE(G_FMT,		format,		type);
		...
		CMDINSIZE(ENUM_FRAMESIZES,	frmsizeenum,	pixel_format);
		CMDINSIZE(ENUM_FRAMEINTERVALS,	frmivalenum,	height);
	default:
		return _IOC_SIZE(cmd);  /* 剩下的是需要全部拷贝的命令 */
	}
}

long video_ioctl2(struct file *file, unsigned int cmd, unsigned long arg)
{
	char	sbuf[128];          /* 在栈中分配128个字节空间用来储存命令的参数 */
	void    *mbuf = NULL;
	void	*parg = NULL;       /* 参数存放的首地址 */
	long	err  = -EINVAL;
	int     is_ext_ctrl;
	size_t  ctrls_size = 0;
	void __user *user_ptr = NULL;

	...
	/* 判断是否包含读写命令,如果是则将用户空间的参数值拷贝到内核 */
	if (_IOC_DIR(cmd) != _IOC_NONE) {
		/* 判断参数大小是否超过128字节 */
		if (_IOC_SIZE(cmd)
Statement
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
Related Article
计算机编程中常见的if语句是什么计算机编程中常见的if语句是什么Jan 29, 2023 pm 04:31 PM

计算机编程中常见的if语句是条件判断语句。if语句是一种选择分支结构，它是依据明确的条件选择选择执行路径，而不是严格按照顺序执行，在编程实际运用中要根据程序流程选择适合的分支语句，它是依照条件的结果改变执行的程序；if语句的简单语法“if(条件表达式){// 要执行的代码;}”。

Python编程：详解命名元组（namedtuple）的使用要点Python编程：详解命名元组（namedtuple）的使用要点Apr 11, 2023 pm 09:22 PM

前言本文继续来介绍Python集合模块，这次主要简明扼要的介绍其内的命名元组，即namedtuple的使用。闲话少叙，我们开始——记得点赞、关注和转发哦~ ^_^创建命名元组Python集合中的命名元组类namedTuples为元组中的每个位置赋予意义，并增强代码的可读性和描述性。它们可以在任何使用常规元组的地方使用，且增加了通过名称而不是位置索引方式访问字段的能力。其来自Python内置模块collections。其使用的常规语法方式为：import collections XxNamedT

如何在Go中进行图像处理？如何在Go中进行图像处理？May 11, 2023 pm 04:45 PM

作为一门高效的编程语言，Go在图像处理领域也有着不错的表现。虽然Go本身的标准库中没有提供专门的图像处理相关的API，但是有一些优秀的第三方库可以供我们使用，比如GoCV、ImageMagick和GraphicsMagick等。本文将重点介绍使用GoCV进行图像处理的方法。GoCV是一个高度依赖于OpenCV的Go语言绑定库，其

PHP8.0中的邮件库PHP8.0中的邮件库May 14, 2023 am 08:49 AM

最近，PHP8.0发布了一个新的邮件库，使得在PHP中发送和接收电子邮件变得更加容易。这个库具有强大的功能，包括构建电子邮件，发送电子邮件，解析电子邮件，获取附件和解决电子邮件获得卡住的问题。在很多项目中，我们都需要使用电子邮件来进行通信和一些必备的业务操作。而PHP8.0中的邮件库可以让我们轻松地实现这一点。接下来，我们将探索这个新的邮件库，并了解如何在我

PHP8.0中的DOMDocumentPHP8.0中的DOMDocumentMay 14, 2023 am 08:18 AM

随着PHP8.0的发布，DOMDocument作为PHP内置的XML解析库，也有了新的变化和增强。DOMDocument在PHP中的重要性不言而喻，尤其在处理XML文档方面，它的功能十分强大，而且使用起来也十分简单。本文将介绍PHP8.0中DOMDocument的新特性和应用。一、DOMDocument概述DOM(DocumentObjectModel)

学Python，还不知道main函数吗学Python，还不知道main函数吗Apr 12, 2023 pm 02:58 PM

Python 中的 main 函数充当程序的执行点，在 Python 编程中定义 main 函数是启动程序执行的必要条件，不过它仅在程序直接运行时才执行，而在作为模块导入时不会执行。要了解有关 Python main 函数的更多信息，我们将从如下几点逐步学习：什么是 Python 函数Python 中 main 函数的功能是什么一个基本的 Python main() 是怎样的Python 执行模式Let’s get started什么是 Python 函数相信很多小伙伴对函数都不陌生了，函数是可

PHP8.0中的Symbol类型PHP8.0中的Symbol类型May 14, 2023 am 08:39 AM

PHP8.0是PHP语言的最新版本，自发布以来已经引发了广泛的关注和争议。其中，最引人瞩目的新特性之一就是Symbol类型。Symbol类型是PHP8.0中新增的一种数据类型，它类似于JavaScript中的Symbol类型，可用于表示独一无二的值。这意味着，两个Symbol类型的值即使完全相同，它们也是不相等的。Symbol类型的使用可以避免在不同的代码段

为拯救童年回忆，开发者决定采用古法编程：用Flash高清重制了一款游戏为拯救童年回忆，开发者决定采用古法编程：用Flash高清重制了一款游戏Apr 11, 2023 pm 10:16 PM

两年多前，Adobe 发布了一则引人关注的公告 —— 将在 2020 年 12 月 31 日终止支持 Flash，宣告了一个时代的结束。一晃两年过去了，Adobe 早已从官方网站中删除了 Flash Player 早期版本的所有存档，并阻止基于 Flash 的内容运行。微软也已经终止对 Adobe Flash Player 的支持，并禁止其在任何 Microsoft 浏览器上运行。Adobe Flash Player 组件于 2021 年 7 月通过 Windows 更新永久删除。当 Flash

See all articles

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

AI Hentai Generator

AI Hentai Generator

Generate AI Hentai for free.

Show More

Hot Article

R.E.P.O. Energy Crystals Explained and What They Do (Yellow Crystal)
2 weeks agoBy尊渡假赌尊渡假赌尊渡假赌
Repo: How To Revive Teammates
4 weeks agoBy尊渡假赌尊渡假赌尊渡假赌
Hello Kitty Island Adventure: How To Get Giant Seeds
3 weeks agoBy尊渡假赌尊渡假赌尊渡假赌
How Long Does It Take To Beat Split Fiction?
3 weeks agoByDDD
R.E.P.O. Save File Location: Where Is It & How to Protect It?
3 weeks agoByDDD
Show More

Hot Tools

SublimeText3 Chinese version

SublimeText3 Chinese version

Chinese version, very easy to use

SublimeText3 Mac version

SublimeText3 Mac version

God-level code editing software (SublimeText3)

MantisBT

MantisBT

Mantis is an easy-to-deploy web-based defect tracking tool designed to aid in product defect tracking. It requires PHP, MySQL and a web server. Check out our demo and hosting services.

Dreamweaver CS6

Dreamweaver CS6

Visual web development tools

DVWA

DVWA

Damn Vulnerable Web App (DVWA) is a PHP/MySQL web application that is very vulnerable. Its main goals are to be an aid for security professionals to test their skills and tools in a legal environment, to help web developers better understand the process of securing web applications, and to help teachers/students teach/learn in a classroom environment Web application security. The goal of DVWA is to practice some of the most common web vulnerabilities through a simple and straightforward interface, with varying degrees of difficulty. Please note that this software

Show More

Hot Topics

Where is the login entrance for gmail email?
7317
9
Java Tutorial
1625
14
CakePHP Tutorial
1349
46
Laravel Tutorial
1261
25
PHP Tutorial
1209
29
Show More