mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-12 05:48:40 +00:00
![Mauro Carvalho Chehab](/assets/img/avatar_default.png)
Fix existing issues at the kernel-doc markups and add them to the vidtv.rst file. Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
165 lines
3.8 KiB
C
165 lines
3.8 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Vidtv serves as a reference DVB driver and helps validate the existing APIs
|
|
* in the media subsystem. It can also aid developers working on userspace
|
|
* applications.
|
|
*
|
|
* This file contains a generic encoder type that can provide data for a stream
|
|
*
|
|
* Copyright (C) 2020 Daniel W. S. Almeida
|
|
*/
|
|
|
|
#ifndef VIDTV_ENCODER_H
|
|
#define VIDTV_ENCODER_H
|
|
|
|
#include <linux/types.h>
|
|
|
|
enum vidtv_encoder_id {
|
|
/* add IDs here when implementing new encoders */
|
|
S302M,
|
|
};
|
|
|
|
struct vidtv_access_unit {
|
|
u32 num_samples;
|
|
u64 pts;
|
|
u64 dts;
|
|
u32 nbytes;
|
|
u32 offset;
|
|
struct vidtv_access_unit *next;
|
|
};
|
|
|
|
/* Some musical notes, used by a tone generator. Values are in Hz */
|
|
enum musical_notes {
|
|
NOTE_SILENT = 0,
|
|
|
|
NOTE_C_2 = 65,
|
|
NOTE_CS_2 = 69,
|
|
NOTE_D_2 = 73,
|
|
NOTE_DS_2 = 78,
|
|
NOTE_E_2 = 82,
|
|
NOTE_F_2 = 87,
|
|
NOTE_FS_2 = 93,
|
|
NOTE_G_2 = 98,
|
|
NOTE_GS_2 = 104,
|
|
NOTE_A_2 = 110,
|
|
NOTE_AS_2 = 117,
|
|
NOTE_B_2 = 123,
|
|
NOTE_C_3 = 131,
|
|
NOTE_CS_3 = 139,
|
|
NOTE_D_3 = 147,
|
|
NOTE_DS_3 = 156,
|
|
NOTE_E_3 = 165,
|
|
NOTE_F_3 = 175,
|
|
NOTE_FS_3 = 185,
|
|
NOTE_G_3 = 196,
|
|
NOTE_GS_3 = 208,
|
|
NOTE_A_3 = 220,
|
|
NOTE_AS_3 = 233,
|
|
NOTE_B_3 = 247,
|
|
NOTE_C_4 = 262,
|
|
NOTE_CS_4 = 277,
|
|
NOTE_D_4 = 294,
|
|
NOTE_DS_4 = 311,
|
|
NOTE_E_4 = 330,
|
|
NOTE_F_4 = 349,
|
|
NOTE_FS_4 = 370,
|
|
NOTE_G_4 = 392,
|
|
NOTE_GS_4 = 415,
|
|
NOTE_A_4 = 440,
|
|
NOTE_AS_4 = 466,
|
|
NOTE_B_4 = 494,
|
|
NOTE_C_5 = 523,
|
|
NOTE_CS_5 = 554,
|
|
NOTE_D_5 = 587,
|
|
NOTE_DS_5 = 622,
|
|
NOTE_E_5 = 659,
|
|
NOTE_F_5 = 698,
|
|
NOTE_FS_5 = 740,
|
|
NOTE_G_5 = 784,
|
|
NOTE_GS_5 = 831,
|
|
NOTE_A_5 = 880,
|
|
NOTE_AS_5 = 932,
|
|
NOTE_B_5 = 988,
|
|
NOTE_C_6 = 1047,
|
|
NOTE_CS_6 = 1109,
|
|
NOTE_D_6 = 1175,
|
|
NOTE_DS_6 = 1245,
|
|
NOTE_E_6 = 1319,
|
|
NOTE_F_6 = 1397,
|
|
NOTE_FS_6 = 1480,
|
|
NOTE_G_6 = 1568,
|
|
NOTE_GS_6 = 1661,
|
|
NOTE_A_6 = 1760,
|
|
NOTE_AS_6 = 1865,
|
|
NOTE_B_6 = 1976,
|
|
NOTE_C_7 = 2093
|
|
};
|
|
|
|
/**
|
|
* struct vidtv_encoder - A generic encoder type.
|
|
* @id: So we can cast to a concrete implementation when needed.
|
|
* @name: Usually the same as the stream name.
|
|
* @encoder_buf: The encoder internal buffer for the access units.
|
|
* @encoder_buf_sz: The encoder buffer size, in bytes
|
|
* @encoder_buf_offset: Our byte position in the encoder buffer.
|
|
* @sample_count: How many samples we have encoded in total.
|
|
* @access_units: encoder payload units, used for clock references
|
|
* @src_buf: The source of raw data to be encoded, encoder might set a
|
|
* default if null.
|
|
* @src_buf_sz: size of @src_buf.
|
|
* @src_buf_offset: Our position in the source buffer.
|
|
* @is_video_encoder: Whether this a video encoder (as opposed to audio)
|
|
* @ctx: Encoder-specific state.
|
|
* @stream_id: Examples: Audio streams (0xc0-0xdf), Video streams
|
|
* (0xe0-0xef).
|
|
* @es_pid: The TS PID to use for the elementary stream in this encoder.
|
|
* @encode: Prepare enough AUs for the given amount of time.
|
|
* @clear: Clear the encoder output.
|
|
* @sync: Attempt to synchronize with this encoder.
|
|
* @sampling_rate_hz: The sampling rate (or fps, if video) used.
|
|
* @last_sample_cb: Called when the encoder runs out of data.This is
|
|
* so the source can read data in a
|
|
* piecemeal fashion instead of having to
|
|
* provide it all at once.
|
|
* @destroy: Destroy this encoder, freeing allocated resources.
|
|
* @next: Next in the chain
|
|
*/
|
|
struct vidtv_encoder {
|
|
enum vidtv_encoder_id id;
|
|
char *name;
|
|
|
|
u8 *encoder_buf;
|
|
u32 encoder_buf_sz;
|
|
u32 encoder_buf_offset;
|
|
|
|
u64 sample_count;
|
|
|
|
struct vidtv_access_unit *access_units;
|
|
|
|
void *src_buf;
|
|
u32 src_buf_sz;
|
|
u32 src_buf_offset;
|
|
|
|
bool is_video_encoder;
|
|
void *ctx;
|
|
|
|
__be16 stream_id;
|
|
|
|
__be16 es_pid;
|
|
|
|
void *(*encode)(struct vidtv_encoder *e);
|
|
|
|
u32 (*clear)(struct vidtv_encoder *e);
|
|
|
|
struct vidtv_encoder *sync;
|
|
|
|
u32 sampling_rate_hz;
|
|
|
|
void (*last_sample_cb)(u32 sample_no);
|
|
|
|
void (*destroy)(struct vidtv_encoder *e);
|
|
|
|
struct vidtv_encoder *next;
|
|
};
|
|
|
|
#endif /* VIDTV_ENCODER_H */
|