/* SPDX-License-Identifier: GPL-2.0 */ /* * Copyright (C) STMicroelectronics SA 2015 * Authors: Yannick Fertre <[email protected]> * Hugues Fruchet <[email protected]> */ #ifndef HVA_H #define HVA_H #include <media/v4l2-ctrls.h> #include <media/v4l2-device.h> #include <media/videobuf2-v4l2.h> #include <media/v4l2-mem2mem.h> #define fh_to_ctx(f) … #define hva_to_dev(h) … #define ctx_to_dev(c) … #define ctx_to_hdev(c) … #define HVA_NAME … #define HVA_PREFIX … extern const struct hva_enc nv12h264enc; extern const struct hva_enc nv21h264enc; /** * struct hva_frameinfo - information about hva frame * * @pixelformat: fourcc code for uncompressed video format * @width: width of frame * @height: height of frame * @aligned_width: width of frame (with encoder alignment constraint) * @aligned_height: height of frame (with encoder alignment constraint) * @size: maximum size in bytes required for data */ struct hva_frameinfo { … }; /** * struct hva_streaminfo - information about hva stream * * @streamformat: fourcc code of compressed video format (H.264...) * @width: width of stream * @height: height of stream * @profile: profile string * @level: level string */ struct hva_streaminfo { … }; /** * struct hva_controls - hva controls set * * @time_per_frame: time per frame in seconds * @bitrate_mode: bitrate mode (constant bitrate or variable bitrate) * @gop_size: groupe of picture size * @bitrate: bitrate (in bps) * @aspect: video aspect * @profile: H.264 profile * @level: H.264 level * @entropy_mode: H.264 entropy mode (CABAC or CVLC) * @cpb_size: coded picture buffer size (in kB) * @dct8x8: transform mode 8x8 enable * @qpmin: minimum quantizer * @qpmax: maximum quantizer * @vui_sar: pixel aspect ratio enable * @vui_sar_idc: pixel aspect ratio identifier * @sei_fp: sei frame packing arrangement enable * @sei_fp_type: sei frame packing arrangement type */ struct hva_controls { … }; /** * struct hva_frame - hva frame buffer (output) * * @vbuf: video buffer information for V4L2 * @list: V4L2 m2m list that the frame belongs to * @info: frame information (width, height, format, alignment...) * @paddr: physical address (for hardware) * @vaddr: virtual address (kernel can read/write) * @prepared: true if vaddr/paddr are resolved */ struct hva_frame { … }; /* * to_hva_frame() - cast struct vb2_v4l2_buffer * to struct hva_frame * */ #define to_hva_frame(vb) … /** * struct hva_stream - hva stream buffer (capture) * * @vbuf: video buffer information for V4L2 * @list: V4L2 m2m list that the frame belongs to * @paddr: physical address (for hardware) * @vaddr: virtual address (kernel can read/write) * @prepared: true if vaddr/paddr are resolved * @size: size of the buffer in bytes * @bytesused: number of bytes occupied by data in the buffer */ struct hva_stream { … }; /* * to_hva_stream() - cast struct vb2_v4l2_buffer * to struct hva_stream * */ #define to_hva_stream(vb) … #ifdef CONFIG_VIDEO_STI_HVA_DEBUGFS /** * struct hva_ctx_dbg - instance context debug info * * @debugfs_entry: debugfs entry * @is_valid_period: true if the sequence is valid for performance * @begin: start time of last HW task * @total_duration: total HW processing durations in 0.1ms * @cnt_duration: number of HW processings * @min_duration: minimum HW processing duration in 0.1ms * @max_duration: maximum HW processing duration in 0.1ms * @avg_duration: average HW processing duration in 0.1ms * @max_fps: maximum frames encoded per second (in 0.1Hz) * @total_period: total encoding periods in 0.1ms * @cnt_period: number of periods * @min_period: minimum encoding period in 0.1ms * @max_period: maximum encoding period in 0.1ms * @avg_period: average encoding period in 0.1ms * @total_stream_size: total number of encoded bytes * @avg_fps: average frames encoded per second (in 0.1Hz) * @window_duration: duration of the sampling window in 0.1ms * @cnt_window: number of samples in the window * @window_stream_size: number of encoded bytes upon the sampling window * @last_bitrate: bitrate upon the last sampling window * @min_bitrate: minimum bitrate in kbps * @max_bitrate: maximum bitrate in kbps * @avg_bitrate: average bitrate in kbps */ struct hva_ctx_dbg { … }; #endif struct hva_dev; struct hva_enc; /** * struct hva_ctx - context of hva instance * * @hva_dev: the device that this instance is associated with * @fh: V4L2 file handle * @ctrl_handler: V4L2 controls handler * @ctrls: hva controls set * @id: instance identifier * @aborting: true if current job aborted * @name: instance name (debug purpose) * @run_work: encode work * @lock: mutex used to lock access of this context * @flags: validity of streaminfo and frameinfo fields * @frame_num: frame number * @stream_num: stream number * @max_stream_size: maximum size in bytes required for stream data * @colorspace: colorspace identifier * @xfer_func: transfer function identifier * @ycbcr_enc: Y'CbCr encoding identifier * @quantization: quantization identifier * @streaminfo: stream properties * @frameinfo: frame properties * @enc: current encoder * @priv: private codec data for this instance, allocated * by encoder @open time * @hw_err: true if hardware error detected * @encoded_frames: number of encoded frames * @sys_errors: number of system errors (memory, resource, pm...) * @encode_errors: number of encoding errors (hw/driver errors) * @frame_errors: number of frame errors (format, size, header...) * @dbg: context debug info */ struct hva_ctx { … }; #define HVA_FLAG_STREAMINFO … #define HVA_FLAG_FRAMEINFO … #ifdef CONFIG_VIDEO_STI_HVA_DEBUGFS /** * struct hva_dev_dbg - device debug info * * @debugfs_entry: debugfs entry * @last_ctx: debug information about last running instance context */ struct hva_dev_dbg { … }; #endif #define HVA_MAX_INSTANCES … #define HVA_MAX_ENCODERS … #define HVA_MAX_FORMATS … /** * struct hva_dev - abstraction for hva entity * * @v4l2_dev: V4L2 device * @vdev: video device * @pdev: platform device * @dev: device * @lock: mutex used for critical sections & V4L2 ops * serialization * @m2m_dev: memory-to-memory V4L2 device information * @instances: opened instances * @nb_of_instances: number of opened instances * @instance_id: rolling counter identifying an instance (debug purpose) * @regs: register io memory access * @esram_addr: esram address * @esram_size: esram size * @clk: hva clock * @irq_its: status interruption * @irq_err: error interruption * @work_queue: work queue to handle the encode jobs * @protect_mutex: mutex used to lock access of hardware * @interrupt: completion interrupt * @ip_version: IP hardware version * @encoders: registered encoders * @nb_of_encoders: number of registered encoders * @pixelformats: supported uncompressed video formats * @nb_of_pixelformats: number of supported umcompressed video formats * @streamformats: supported compressed video formats * @nb_of_streamformats: number of supported compressed video formats * @sfl_reg: status fifo level register value * @sts_reg: status register value * @lmi_err_reg: local memory interface error register value * @emi_err_reg: external memory interface error register value * @hec_mif_err_reg: HEC memory interface error register value * @dbg: device debug info */ struct hva_dev { … }; /** * struct hva_enc - hva encoder * * @name: encoder name * @streamformat: fourcc code for compressed video format (H.264...) * @pixelformat: fourcc code for uncompressed video format * @max_width: maximum width of frame for this encoder * @max_height: maximum height of frame for this encoder * @open: open encoder * @close: close encoder * @encode: encode a frame (struct hva_frame) in a stream * (struct hva_stream) */ struct hva_enc { … }; #ifdef CONFIG_VIDEO_STI_HVA_DEBUGFS void hva_debugfs_create(struct hva_dev *hva); void hva_debugfs_remove(struct hva_dev *hva); void hva_dbg_ctx_create(struct hva_ctx *ctx); void hva_dbg_ctx_remove(struct hva_ctx *ctx); void hva_dbg_perf_begin(struct hva_ctx *ctx); void hva_dbg_perf_end(struct hva_ctx *ctx, struct hva_stream *stream); #endif #endif /* HVA_H */
Codebase Browser
linux