QAVF Camera共享如何配置虚拟化设备

virtio-video-camera虚拟设备为在hypervisor VMs中运行的guest实现了VirtIO-Video Camera功能。

命令

vdev virtio-video-camera [num_cameras number] [sensor_unit SENSOR_UNIT_X...]
        [dynamic_configuration true | false] [blit_enabled true | false]
        [camera_format format] [guest_format format] [guest_num_buffers number]

选项

num_cameras number

设置支持VirtIO-Video消息中使用的流的最大流ID值，由number确定。由于流ID是从零开始的，所以最大支持值为num_cameras – 1。number的值必须介于1和16之间（包括1和16）。

sensor_unit SENSOR_UNIT_X…

指定与给定流ID相关联的Sensor Framework sensor单元。单位应以逗号分隔的列表形式给出，类似于以下示例：

sensor_unit SENSOR_UNIT_1, SENSOR_UNIT_2, SENSOR_UNIT_3

每个逗号分隔的条目应具有SENSOR_UNIT_X的形式，其中X是介于1和64之间（包括1和64）的值。条目的数量应等于num_cameras的值。在初始化时将执行进一步验证，以确保所有值都被现有的Sensor Framework配置支持。

dynamic_configuration true | false

指定是否允许guest动态更新给定Camera的配置。Sensor Framework一次只允许一个guest这样做。

当此选项设置为true时，guest允许执行动态配置，但QNX host上的其他应用程序不能执行动态配置。
当此选项设置为false时，guest无法动态更新配置，而QNX host上的另一个应用程序允许更新配置。在这种情况下，如果guest请求与当前配置不同的相机配置，则请求将失败。

blit_enabled true | false

指定camera-sharing vdev是否使用屏幕位块复制（screen blit）直接从Camera复制帧到GPU共享vdev的缓冲区中。

当需要由guest上的GPU显示Camera缓冲区时，这种直接复制可以优化性能。
当blit_enabled设置为true时，camera-sharing框架需要virtio-gpu vdev和屏幕图形子系统(Screen Graphics Subsystem)。有关更多信息，请参阅“图形共享”章节。
如果blit_enabled为false，则不适用这些依赖关系。

camera_format format

设置在QNX host上从Camera请求的数据格式，由format确定。目前，format可以是NV12（对应于CAMERA_FRAMETYPE_NV12）或CBYCRY（对应于CAMERA_FRAMETYPE_CBYCRY）。

guest_format format

确定通过screen_blit()传递给guest的Camera数据帧使用的格式。目前，format的唯一可用值是RGB8888（对应于CAMERA_FRAMETYPE_RGB8888）。如果blit_enabled为false，则忽略此选项。

guest_num_buffers number

确定由guest用于Camera的数据缓冲区数量，由number指定。number参数的值可以介于1和64之间（包括1和64）。如果blit_enabled为false，则忽略此选项。

除了这些选项外，还可以指定对所有vdev支持的选项，例如intr和loc。有关更多信息，请参阅QNX Hypervisor用户指南中的“常见vdev选项”部分。

描述

（ARM和x86）virtio-video-camera vdev为在hypervisor中运行的guest提供Camera功能。它通过将接收到的guest驱动程序通过VirtIO-Video消息标准转发给host上的Camera library，并向guest报告Camera操作的结果来实现此功能。

vdev的配置将VirtIO-Video协议中的特定Camera流实例与Sensor Framework中的特定Camera关联起来。配置选项是针对使用vdev的驱动程序实例而设定的。