hi_mpi_vi_send_pipe_raw

Applicability

Product

Supported

Atlas 350 Accelerator Card

Atlas A3 training product / Atlas A3 inference product

Atlas A2 training product / Atlas A2 inference product

Atlas 200I/500 A2 inference product

Atlas inference product

Atlas training product

Function Description

Sends RAW data through a VI pipe.

Prototype

hi_s32 hi_mpi_vi_send_pipe_raw(hi_u32 pipe_num, hi_vi_pipe pipe_id[], const hi_video_frame_info *frame_info[], hi_s32 milli_sec)

Parameters

Parameter

Input/Output

Description

pipe_num

Input

Number of pipes.

When the working mode is linear mode, its value is 1. When the working mode is WDR mode, the value must be the same as the number of pipes of the WDR. The specific mode is specified in WDR attributes by calling hi_mpi_vi_set_dev_attr.

pipe_id

Input

Pipe ID array. The number of elements in the array must be the same as the value of pipe_num.

frame_info

Input

Raw data information.

milli_sec

Input

Timeout parameter.
  • -1: blocking mode
  • 0: non-blocking mode
  • > 0: specific timeout interval, in ms.

Returns

Restrictions

  • Before calling this API, call the hi_mpi_vi_create_pipe API to create a pipe and then call the hi_mpi_vi_start_pipe API to start the pipe. When calling the hi_mpi_vi_create_pipe API to create a pipe, ensure that isp_bypass of the pipe attribute is HI_FALSE.
  • Before sending RAW data, set the data source of the pipe to HI_VI_PIPE_FRAME_SOURCE_USER by calling hi_mpi_vi_set_pipe_frame_source. In this case, the data from the sensor is not sent to the ISP BE for processing, and the ISP BE processes only the frame data sent by the user.
  • In WDR mode, the sequence of storing the raw data of each pipe in frame_info must be the same as that when the hi_mpi_vi_set_dev_bind_pipe interface is bound to the pipe. This ensures that the sequence of the long and short exposure frames is correct and the attributes (such as the width, height, pixel format, and compression) of the raw data of each pipe are correct. The value must be the same as that when the hi_mpi_vi_create_pipe interface is created.
  • When RAW data is sent by calling this API, the RAW data must meet the following requirements:
    • The transmitted RAW frame information must be the valid frame information obtained by calling the hi_mpi_vi_pipe_get_buffer interface.
    • The pixel format and image size of the RAW data must be the same as those configured when a pipe is created by calling hi_mpi_vi_create_pipe.
    • field of the RAW data must be set to HI_VIDEO_FIELD_FRAME.
    • video_format of the RAW data must be set to HI_VIDEO_FORMAT_LINEAR.
    • The compress_mode of RAW data can only be HI_COMPRESS_MODE_NONE, HI_COMPRESS_MODE_LINE, or HI_COMPRESS_MODE_FRAME.
    • The dynamic_range of the RAW data must be set to HI_DYNAMIC_RANGE_SDR8.

See Also

For details about the API call sequence, see Video Data Obtaining.