メインコンテンツまでスキップ

USBカメラ

camera.v4l2プロバイダーがV4L2を通じて検出するUSB Video Class（UVC）カメラです。 video4linuxのueventが発生するたびに再スキャンします。

プロバイダーは/sys/class/video4linuxを走査し、USBの祖先を持つノードのみを残すため、 プラットフォームノードやISPノードが開かれることはありません。 各候補はO_RDONLY | O_NONBLOCKで開かれ、照会用のioctl（VIDIOC_QUERYCAP、 VIDIOC_ENUM_FMT、VIDIOC_ENUM_FRAMESIZES、VIDIOC_ENUM_FRAMEINTERVALS）のみを受け取ります。 メタデータ専用、出力専用、およびメモリ間（memory-to-memory）のノードはVIDIOC_QUERYCAPの後で除外されるため、 メタデータノードを持つUVCカメラは1回だけ表示されます。

識別情報​

idはcamera:v4l2:<16 hex digits>で、 identity.stable_key（sysfs:<USB topology>:interface=<bInterfaceNumber>:index=<node index>）のFNV-1aハッシュです。 同じポートへの再接続や/dev/videoNの番号の振り直しがあっても変わりません。 異なるポートに接続すると別のカメラとして扱われ、 異なるポートに接続された同一のカメラにはそれぞれ異なるidが付きます。

フィールド​

フィールド出現条件意味
type常にcamera
id常に上記を参照
backend常にv4l2（USBカメラ）
model判明している場合USBのproduct文字列。ない場合はドライバーのカード名
device_path常に/dev/videoN。ルーティング専用で、識別には使用しません
by_id_pathudevリンクがある場合device_pathに解決される/dev/v4l/by-id/...リンク
identity常にstable_key、topology、interface、node_index、およびUSBデバイスが報告する場合はvendor_id、product_id、serial、manufacturer、speed（カーネルが出力するとおりのMb/s単位のsysfs速度。例："480"）
availability常に{"state": "unknown", "reason": ...}：検出処理はストリームを開かないため、カメラが使用中かどうかを判別できません
modes常にカメラが出力できる内容。下記を参照

モード​

フォーマットとフレームサイズごとに1つのモードがあり、フォーマット順、次にサイズ順に並べられます。 同じフォーマットのシングルプレーナーとマルチプレーナーの一覧は統合されます。

フィールド出現条件意味
format常にV4L2 FourCC。例：MJPG、YUYV、NV12
format_descriptionドライバーが提供する場合VIDIOC_ENUM_FMTの説明。例：Motion-JPEG
width、height離散サイズの場合フレームサイズ
size_rangeステップ単位または連続サイズの場合type（stepwiseまたはcontinuous）、min_width、min_height、max_width、max_height、step_width、step_height
frame_intervals常にプローブした各サイズ（width、height）について、デバイスが通知するすべての間隔：{"type": "discrete", "numerator", "denominator"}または{"type": "stepwise" or "continuous", "minimum", "maximum", "step"}

サイズ範囲は、その最小サイズと最大サイズでプローブされます。 フレーム間隔のないサイズにはモードがありません。Sentinelはモードがサポートされているかどうかを示しません。 それはカメラを使用するアプリケーションが判断します。

制限とエラー​

エラーが発生するとプロバイダーのスキャンが失敗し、その内容はカタログの errorsで報告されます：

  • io.permission_denied：ノードまたはsysfsからEACCESが返された場合、またはEPERMが ノードを開く際に返された場合。
  • io.open：その他のドライバーまたはsysfsのエラー、1024エントリを超えるリスト、 1つのデバイスに対する4096回を超える列挙クエリ、 不正な形式のサイズまたは間隔。
  • peripherals.discovery_failed：インターフェース番号または ノードインデックスを持たないUSBカメラ。

スキャン中に取り外されたカメラは、スキャンを失敗させずに結果から除外されます。 遅くとも、その取り外しによって発生する再スキャンの時点で除外されます。

例​

{"type": "camera", "id": "camera:v4l2:295faa7ac0d61654", "backend": "v4l2",
 "model": "HD Pro Webcam C920", "device_path": "/dev/video97",
 "by_id_path": "/dev/v4l/by-id/usb-046d_HD_Pro_Webcam_C920_A1B2-video-index0",
 "identity": {"stable_key": "sysfs:devices/pci0000:00/usb1/1-2.3:interface=00:index=0",
              "topology": "devices/pci0000:00/usb1/1-2.3", "interface": "00",
              "node_index": "0", "vendor_id": "046d", "product_id": "082d",
              "serial": "A1B2", "manufacturer": "Logitech", "speed": "480"},
 "availability": {"state": "unknown", "reason": "V4L2 does not expose a reliable read-only ownership state; discovery does not acquire, configure, or stream from the camera."},
 "modes": [{"format": "MJPG", "format_description": "Motion-JPEG",
            "width": 1920, "height": 1080,
            "frame_intervals": [{"width": 1920, "height": 1080, "intervals": [
              {"type": "discrete", "numerator": 1, "denominator": 30}]}]}]}