# Magewell Pro Capture 系列采集卡

# 快速使用指南 for Linux

版权所有 2011–2016 南京美乐威电子科技有限公司 保留所有权利。

最后更新时间 2016–04–19

## 1 简介

美乐威 ProCapture 系列采集卡可应用于各种类型高标清音视频信号的采集，目前已经全面支持 PCI-E 2.0 标准.

全系产品采用模块化设计，能快速满足特殊定制需求，提供统一的驱动及 SDK ，较前一代产品，在功能、性能、

易用性及兼容性方面都得到了全面的提升.

## 2 产品安装

- 关闭计算机电源;

- 将Pro Capture采集卡插入到计算机PCI Express插槽中(注:Pro Capture系列采集卡PCI-E接口目前有2种:x1与x4.

  x1卡可以插入主板PCI Express x1,x4,x8或x16插槽, x4卡可以插入主板PCI Express x4,x8或x16插槽,另外Pro

  Capture Mini卡只能挺插入主板的Mini PCI-E槽);

- 开启计算机电源，启动操作系统;

## 3 驱动安装

### 3.1 驱动安装简介

本节主要介绍如何在 linux 系统环境下安装 Pro Capture 系列采集卡的驱动程序.

### 3.2 驱动安装

- 下载驱动程序安装包 ProCaptureForLinux_XXXX.tar.gz。其中 XXXX 表示下载驱动的版本号。

- 输入命令：tar -zxvf ProCaptureForLinux_XXXX.tar.gz 将驱动解压到当前目录。

- 解压后包括如下目录和文件：

  - bin：bin 目录中包含了一些常用工具软件，通过这些软件可以方便的获得采集卡当前各类状态信息。

  - scripts： scripts 目录中包含了安装、卸载、修复驱动的脚本及系统配置文件。

  - src：src 目录中包含了驱动程序的源码。

  - install.sh：执行该文件即可调用 scripts 目录的中的脚本自动安装驱动程序。

- 安装内核开发包：安装驱动之前，必须先安装内核开发包，否则安装驱动将失败。

  - Ubuntu：sudo apt-get install linux-headers-`uname -r`

  - Fedora、CentOS、RHEL: sudo yum install kernel-devel

- 执行当前目录下 install.sh 文件，安装驱动。如果驱动安装成功，将会出现如下提示信息

- 验证 mwcap-info 是否正确安装

  - mwcap-info 是随驱动程序同时安装的命令行工具，通过该软件可以获取采集卡当前状态信息，并且该

  工具提供了可供脚本使用的选项。

  - 输入命令 mwcap-info -h 如果工具安装成功，则会打印出帮助信息。

- 验证采集卡是否被正确驱动

  - 输入命令 mwcap-info -l 输入该命令后，如果设备被正常驱动，将列出当前机器上所有 Pro Capture

  采集卡

  - 输入命令 gst-launch–1.0 v4l2src device=/dev/video0 ! video/x-raw,width=720,height=576,

  format=RGBx,framerate=30/1 ! videoconvert ! autovideosink

  如果驱动工作正常，则能够正常的显示音视频画面。

## 4 工具软件

本节主要介绍如何使用 Linux 平台下常用的工具软件

Pro Capture 系列视频采集卡采用模块化设计，采集卡上每一个采集通道均可以看成一个独立的视频采集设备。

本文中所有的“视频采集设备”均表示采集卡上的一个采集通道，“视频采集卡”表示整块采集卡。

一个视频采集设备有两种表示方法

- 1 用一个 V4L2 设备文件表示一个视频采集设备(eg. /dev/video0)。

- 2 用设备 ID（Board-ID:Channel-ID，eg. 0:0）的方式表示一个视频采集设备。其中 Board-ID 表示设

  备所在采集卡拨码开关的数值，Channel-ID 表示该设备在采集卡上的索引。当一台 PC 上存在两块拨码开

  关一样的采集卡时，此方法表示的视频采集设备不唯一。

### 4.1 mwcap-info

> mwcap-info 是 Linux 平台下的一个命令行工具，通过这个软件可以查询当前 PC 上工作的所有 Pro Capture

> 视频采集设备，并且可以查询每一个设备的设备硬件信息、输入源信息、HDMI 信息帧以及设备文件名称。

> mwcap-info 命令行参数如下：

> 参数 | 注释
> --- | ---
> -h | 显示帮助信息。
> -l | 列表显示所有的视频采集设备。
> -q | 该选项参数表示视频采集设备，列表显示指定设备的信息。
> -i or --info-all | 该选项参数表示视频采集设备, 显示指定设备的所有属性信息，包括输入源信息，设备硬件信息以及 HDMI 信息帧信息。
> --info-device | 该选项参数表示视频采集设备, 显示指定设备的硬件信息。
> --info-input-all | 该选项参数表示视频采集设备, 显示指定设备的所有输入源信息。
> --info-input-video | 该选项参数表示视频采集设备, 显示指定设备的视频输入源信息。
> --info-input-audio | 该选项参数表示视频采集设备, 显示指定设备的音频输入源信息。
> --info-input-specific | 该选项参数表示视频采集设备, 显示指定设备的与接口相关的信息。
> -v | 该选项参数为设备 ID, 显示设备对应的 V4L2 设备文件名称，该选项可以嵌入在脚本中使用。
> -a or --alsa-name | 该选项参数表示视频采集设备, 显示设备对应的 ALSA 设备文件名称，该选项可以嵌入在脚本中使用。
> --alsa-name-mplayer | 该选项参数表示视频采集设备, 显示设备对应 mplayer 格式的 ALSA 设备文件名称，该选项可以嵌入在脚本中使用。
> --alsa-name-pa | 该选项参数表示视频采集设备, 显示设备对应的 Paulse Audio 设备文件名称，该选项可以嵌入在脚本中使用。
> -c | 该选项参数为一个设备 ID, 显示拥有此 ID 设备的数量，该选项可以嵌入在脚本中使用。

- Example：

  - 列表显示所有视频采集设备的信息。

    $ mwcap-info -l

  - 列表显示指定视频采集设备的信息。

    $ mwcap-info -q /dev/video0

    -- or --

    $ mwcap-info -q 0:0

  - 显示指定设备的所有属性信息，包括输入源信息，设备硬件信息以及。

    $ mwcap-info -i /dev/video0

    -- or --

    $ mwcap-info --info-all 0:0

  - 显示指定设备的硬件信息。

    $ mwcap-info --info-device /dev/video0

    -- or --

    $ mwcap-info --info-device 0:0

  - 显示所有的输入源信息。

    $ mwcap-info --info-input-all /dev/video0

    -- or --

    $ mwcap-info --info-input-all 0:0

  - 显示视频的输入源信息。

    $ mwcap-info --info-input-video /dev/video

    -- or --

    $ mwcap-info --info-input-video 0:0

  - 显示音频输入源信息。

    $ mwcap-info --info-input-audio /dev/video0

    -- or --

    $ mwcap-info --info-input-audio 0:0

  - 显示与接口相关输入源信息。

    $ mwcap-info --info-input-specific /dev/video0

    -- or --

    $ mwcap-info --info-input-specific 0:0

  - 显示指定设备的 V4L2 设备文件名称, 该选项可以嵌入脚本中使用。

    $ mwcap-info -v 0:0

    $ gst-launch–1.0 v4l2src device=`mwcap-info -v 0:0` ! video/x-raw,width=720,height=576,

    format=RGBx,framerate=30/1 ! videoconvert ! autovideosink

  - 显示指定设备的 ALSA 设备文件名称, 该选项可以嵌入脚本中使用。

    $ mwcap-info -a /dev/video0

    -- or --

    $ mwcap-info --alsa-name 0:0

    $ gst-launch–1.0 alsasrc device=`mwcap-info –alsa-name 0:0` ! ‘audio/x-raw,format=S16LE,rate=44100,channels=2’ ! autoaudiosink

  - 显示指定设备 Mplayer 格式的 ALSA 设备文件名称, 该选项可以嵌入脚本中使用。

    $ mwcap-info --alsa-name-mplayer /dev/video0

    -- or --

    $ mwcap-info --alsa-name-mplayer 0:0

    $ mplayer tv:// -tv driver=v4l2:device=/dev/video0:width=1280:height=720:outfmt=yuy2:

    alsa:adevice=`mwcap-info --alsa-name-mplayer /dev/video0`:forceaudio

  - 显示指定设备的 Pulse Audio 设备文件名称。

    $ mwcap-info --alsa-name-pa /dev/video0

    -- or --

    $ mwcap-info --alsa-name-pa 0:0

  - 显示拥有指定设备 ID 的设备数量

    $ mwcap-info -c 0:0