Jetson에서 장치와 CPU가 같은 surface를 보더라도 캐시 일관성을 맞추는 단계가 필요할 수 있다.
SyncForCpu는 그 방향의 동기화다.

환경과 호출 위치

samples/07_video_convert와 같은 NvBufSurface 기반 흐름에 넣는 함수다.
surface를 만든 소유자와 빌려 쓰는 사용자를 구분한다.
아래 코드는 독립 main이 아니므로 설명한 인수와 호출 시점을 준비해야 한다.
CPU의 행 단위 접근 예제는 NVBUF_MEM_SURFACE_ARRAY와 pitch-linear 배치를 전제로 하며 block-linear 버퍼를 같은 방식으로 읽지 않는다.

인수와 동작

지원 메모리 종류는 surface-array와 handle이다.
먼저 CPU 매핑을 완료한 상태에서 호출한다.
index와 plane은 읽으려는 범위를 지정하며 예제는 첫 프레임 전체 plane을 선택한다.

적용할 코드

int prepare_cpu_read(NvBufSurface *surface) {
    return NvBufSurfaceSyncForCpu(surface, 0, -1);
}

생산 장치 작업 완료 뒤 map하고 이 함수를 호출한 다음 mappedAddr를 읽는다.
캐시를 맞추는 것과 처리 중인 프레임의 소유권을 얻는 것은 별도 조건이다.

헤더와 링크

nvbufsurface.h를 포함한다.
JetPack 6에서는 구형 nvbuf_utils.h의 NvBufferCreate 계열과 혼용하지 않는다.
R36의 samples/07_video_convert Makefile과 Rules.mk를 기준으로 헤더 및 tegra 라이브러리 경로를 맞춘다.
필요한 링크 라이브러리는 nvbufsurface다.

cd /usr/src/jetson_multimedia_api/samples/07_video_convert
make -j2
./video_convert --help

주의할 점

지원하지 않는 메모리 종류에 무조건 호출하지 않는다.
디바이스 처리 완료를 기다리지 않고 캐시만 맞춰도 미완성 프레임을 읽을 수 있다.

기준은 Orin과 JetPack 6의 Jetson Linux R36.4이다.
설치된 nvidia-l4t-core와 Multimedia API 패키지 버전을 맞춘다.
다른 PC에서 컴파일되는 것과 Jetson에서 실제 장치가 동작하는 것은 별개다.

참고: NVIDIA R36.4 API 문서