MIPI CSI-2 카메라

camera.mipi 프로바이더는 Modalix ISP 뒤에 있는 이미지 센서를 보고합니다. media 및 video4linux uevent가 발생하면 다시 스캔합니다. 탐지는 장치 노드를 읽기 전용으로 열고 쿼리 ioctl만 실행합니다. 형식이나 링크를 설정하지 않으며 스트리밍도 하지 않습니다.

simaai-v4l2-vid 드라이버의 각 /dev/mediaN는 MEDIA_IOC_G_TOPOLOGY로 읽으며, 그래프의 각 MEDIA_ENT_F_CAM_SENSOR 엔티티가 하나의 카메라입니다. 다른 드라이버의 미디어 장치(예: uvcvideo)는 무시됩니다.

식별 정보

id는 camera:<sensor entity name>이며, 예를 들어 camera:imx477 5-001a는 센서 드라이버, I2C 버스 및 주소로 구성됩니다. libcamera도 같은 이름을 사용하므로 CameraInput이 받는 이름이기도 합니다. 예를 들어 두 미디어 장치에 같은 이름의 센서가 있으면 id가 겹치게 되므로, 이 경우 두 미디어 장치를 모두 명시하는 오류와 함께 스캔이 실패합니다.

필드

필드	포함 조건	의미
type, id	항상	camera 및 위의 식별자
backend	항상	mipi
model	이름에 포함된 경우	엔티티 이름의 첫 단어, 예: imx477
availability	항상	{"state": "unknown", "reason": ...}: 미디어 컨트롤러에는 읽기 전용 소유권 상태가 없음
camera_name	항상	CameraInput에 전달할 센서 엔티티 이름
media_device	항상	/dev/mediaN (라우팅 전용이며 식별자가 아님)
bus_info	보고된 경우	MEDIA_IOC_DEVICE_INFO에서 얻은 미디어 장치 버스, 예: platform:csi2video@1
isp	항상	{"state": "available", "device_path", "device_paths", "sizing"}, 또는 {"state": "unavailable", "reason"} (이때 modes: [])
modes_error	isp는 사용할 수 있지만 모드를 나열할 수 없는 경우	modes가 []인 이유: 센서의 크기를 나열할 수 없었거나 너무 많음
csi_receiver	링크된 경우	센서의 소스 패드가 연결된 엔티티, 예: csidev-40c3000.csi
sensor_timing	읽을 수 있는 경우	센서의 /dev/v4l-subdevN에서 읽은 pixel_rate(픽셀/초), hblank_min, vblank_min, width, height
max_fps	sensor_timing이 있는 경우	pixel_rate / ((width + hblank_min) * (height + vblank_min)), 소수점 둘째 자리까지

sensor_timing은 센서의 서브디바이스 인터페이스(이름은 /sys/dev/char/<major>:<minor>로 확인)에서 가져옵니다. 연결된 소스 패드의 활성 형식 (VIDIOC_SUBDEV_G_FMT), 현재 V4L2_CID_PIXEL_RATE, 그리고 V4L2_CID_HBLANK 및 V4L2_CID_VBLANK의 최솟값입니다. 이 중 하나라도 없으면 생략됩니다.

ISP 출력 노드는 이름이 isp_v4l2-vid-cap-out이고 카드가 arm-isp-out인 video4linux 항목입니다. 여러 개가 있으면 모두가 공유하는 모드만 보고됩니다.

sizing은 ISP 출력 크기의 출처를 나타내며, 플랫폼 버전이 아니라 ISP가 나열하는 크기로 판단합니다. 구성된 센서에 맞춰 런타임에 크기를 정하는 ISP(Platform 3.0)는 구성되기 전까지 0x0을 나열합니다. 어느 ISP 노드든 0x0 크기를 나열하면 sizing은 runtime입니다. 그렇지 않으면(Platform 2.1.x) 크기는 드라이버에 내장된 표이며 sizing은 fixed입니다.

모드

모드는 ISP 출력 형식과 이산 크기이며, 이는 CameraInput가 캡처할 수 있는 것입니다. 각 모드에는 format(FourCC), width, height 및 isp_output: true가 있습니다. 모드는 ISP가 해당 크기의 간격을 보고하는 경우에만 USB 카메라와 같은 형식의 frame_intervals를 포함합니다. DevKit의 ISP는 간격을 보고하지 않으므로 모드에 프레임 레이트가 없습니다. max_fps 및 sensor_timing이 센서의 한계를 나타냅니다.

sizing: "runtime"이면 ISP는 현재 구성된 크기(대기 중에는 0x0)만 나열하므로 그 크기는 사용하지 않습니다. 이때 모드는 모든 ISP 노드가 나열하는 형식과, 센서 서브디바이스가 모든 미디어 버스 코드에 대해 보고하는 이산 프레임 크기(VIDIOC_SUBDEV_ENUM_MBUS_CODE, VIDIOC_SUBDEV_ENUM_FRAME_SIZE)의 조합입니다. 각 모드에는 format, width, height, sensor_mode: true, isp_input이 있으며, 센서가 해당 크기의 간격을 보고하면 (VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL) frame_intervals도 포함합니다. 범위로 표시된 크기는 건너뜁니다. 센서의 크기를 나열할 수 없으면 해당 카메라는 modes: []를 가지며 modes_error가 그 이유를 나타냅니다. isp는 여전히 ISP를 보고합니다. Sentinel은 카메라당 형식-크기 조합을 최대 1,024개까지 게시합니다. 이보다 큰 조합은 무제한 카탈로그를 할당하는 대신 같은 방식으로 보고됩니다.

센서가 해당 크기를 12비트 Bayer 미디어 버스 코드(MEDIA_BUS_FMT_S{BGGR,GBRG,GRBG,RGGB}12_1X12)로 나열하고, 너비가 64의 배수이며, 높이가 짝수이고, 크기가 최대 4096x3072이면 isp_input은 true입니다. SiMa의 libcamera 핸들러는 센서를 12비트 RAW로 구성하고, ISP의 RAW DMA는 32바이트 라인 스트라이드(64픽셀의 배수인 12비트 라인)를 필요로 하며, ISP에는 스케일러가 없으므로 이러한 모드는 자체 크기 그대로 출력됩니다. libcamera는 이 한도를 충족하지 않는 크기를 줄입니다(IMX477의 4056x3040은 Platform 3.0에서 4032x3040으로 스트리밍됨).

고정 ISP의 각 모드에는 available과, 그 값이 false이면 reason도 있어 보드가 해당 정확한 출력에 맞게 설정되었는지를 나타냅니다. NV12가 아닌 센서 모드도 사용할 수 없는 것으로 판정됩니다. isp_input: true인 NV12 sensor_mode는 사용할 수 있습니다. 그 밖의 모드는 그보다 크거나 같은 isp_input 모드가 없으면 사용할 수 없으며, 그런 모드가 있으면 판정이 없습니다. libcamera가 그 더 큰 모드를 잘라 이 크기로 만들 수 있지만, Sentinel의 읽기 전용 탐지는 카메라를 구성하거나 스트리밍하지 않고는 이를 확인할 수 없기 때문입니다. Platform 3.0의 IMX477에서는 이에 따라 1280x990, 1920x1080, 2048x1080, 3840x2160, 3968x3040, 4032x3040은 사용할 수 있고, 너비가 4056인 두 크기는 사용할 수 없으며, 1332x990, 2028x1080, 2028x1520은 판정되지 않습니다. 전체 규칙은 카탈로그에 있습니다.

오류

코드	발생 조건
io.permission_denied	미디어 장치를 열 수 없거나(EACCES, EPERM) /dev 목록을 가져올 수 없음(EACCES)
io.open	미디어 장치의 그 밖의 열기 또는 쿼리 실패
peripherals.discovery_failed	이름 없는 센서 엔티티, 또는 이름이 같은 두 센서(id가 충돌함)

스캔 중에 사라진 장치는 건너뜁니다. ISP 실패로 스캔이 실패하지는 않으며, 대신 isp를 사용 불가 상태로 만들고 그 이유를 함께 표시합니다. 크기를 나열할 수 없는 센서에는 대신 modes_error가 있습니다.

예시

Modalix DevKit의 IMX477이며, 모드는 축약되어 있습니다(전체 9개: 세 가지 형식, 세 가지 크기). 그래프와 ISP 크기는 DevKit에서 옮겨 적은 것입니다. 센서 타이밍 값은 DevKit이 보고하는 값과 같지만 테스트로만 검증되었습니다.

{"type": "camera", "id": "camera:imx477 5-001a", "model": "imx477",
 "availability": {"state": "unknown", "reason": "The media controller does not expose a reliable read-only ownership state; discovery does not acquire, configure, or stream from the camera."},
 "modes": [{"format": "AR24", "width": 1920, "height": 1080, "isp_output": true},
           {"format": "AR24", "width": 2048, "height": 1080, "isp_output": true}],
 "backend": "mipi", "camera_name": "imx477 5-001a", "media_device": "/dev/media0",
 "bus_info": "platform:csi2video@1",
 "isp": {"state": "available", "device_path": "/dev/video1", "device_paths": ["/dev/video1"],
         "sizing": "fixed"},
 "csi_receiver": "csidev-40c3000.csi",
 "sensor_timing": {"pixel_rate": 840000000, "hblank_min": 9332, "vblank_min": 48,
                   "width": 1920, "height": 1080},
 "max_fps": 66.18}