NvSciSync Functions for Specific Imaging Components

This topic provides an overview of NvSciSync functions supported for NvMedia imaging components (2D, ICP, and so on).

NvSciSync supports a group of functions for several imaging components, such as NvMedia2D and NvMediaICP. The groups of functions have parallel names. For example, NvMedia XX RegisterNvSciSyncObj() registers an NvSciSync object with a component, where XX is 2D for NvMedia2D, ICP for NvMediaICP, etc.

NvSciSync supports the following functions for each component, with a few exceptions detailed below:

• Query a component's NvSciSyncObj attributes for waiting or signaling.

  Call NvMediaXXFillNvSciSyncAttrList() to query the NvSciSync attributes of component XX. The function sets (fills) the attributes in memory provided by the caller. NvSciSync objects allocated with such NvSciSyncAttrList objects are only accepted by component XX functions.

• Register and unregister an NvSciSync object.

  Call NvMedia XX RegisterNvSciSyncObj() to register NvSciSyncObj objects with component XX. You must register every NvSciSyncObj that component XX is to use.

  During teardown, call NvMediaXXUnRegisterNvSciSyncObj() to unregister the registered NvSciSyncObj objects with component XX.

• Set an NvSciSyncObj object for SOF usage with the component.

  Call NvMedia XX SetNvSciSyncObjforSOF() to tell component XX to use a particular NvSciSyncObj for signaling start of frame (SOF). You must call this function before you call any of the component's main image processing functions.

• Set an NvSciSyncObj for EOF usage with the component.

  Call NvMedia XX SetNvSciSyncObjforEOF() to tell component XX to use a particular NvSciSyncObj for signaling end of frame (EOF). You must call this function before you call any of the component's main image processing functions.

• Wait for an NvSciSyncFence.

  Call NvMediaXXInsertPreNvSciSyncFence() to tell component XX to wait on an NvSciSyncFence before actually starting image processing. You must call this function before you call any of the component's main image processing functions.

• Get an NvSciSyncFence SOF.

  Call NvMediaXXGetSOFNvSciSyncFence() to get an NvSciSyncFence from component XX whose expiry indicates that the last submitted image processing request has started. You must call this function only after you call the component's main image processing functions.

• Get an NvSciSyncFence EOF.

  Call NvMediaXXGetEOFNvSciSyncFence() to get an NvSciSyncFence from component XX whose expiry indicates that the last submitted image processing request has completed. You must call this function only after you call the component's main image processing functions.

The functions are implemented for each of the following NvMedia imaging components.

Not every function is implemented for every imaging component. The following table shows functions implemented for each supported component. For SIPL APIs, refer to the NVIDIA DRIVE OS API Reference Guide.