rfeng/smod_atsc_app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

提交SMOD ATSC IMX APP版本 V122

Browse Source
This commit is contained in:
rfeng
2026-07-16 14:35:59 +08:00
commit 7601c270d5
485 changed files with 255032 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
atsc_app/sonytuner/atsc/sony_atsc3.h
Executable
+528
View File
@@ -0,0 +1,528 @@
/*------------------------------------------------------------------------------
Copyright 2018 Sony Semiconductor Solutions Corporation
Last Updated : 2018/09/28
Modification ID : 1ea04def104d657deb64f0d0b0cae6ef992a9dd8
------------------------------------------------------------------------------*/
/**
@file sony_atsc3.h
This file provides ATSC 3.0 related type definitions.
*/
/*----------------------------------------------------------------------------*/
#ifndef SONY_ATSC3_H
#define SONY_ATSC3_H
#include "../sony_common.h"
/*------------------------------------------------------------------------------
Defines
------------------------------------------------------------------------------*/
#define SONY_ATSC3_NUM_PLP_MAX 64 /**< Max number of PLPs */
/*------------------------------------------------------------------------------
Enumerations
------------------------------------------------------------------------------*/
/**
@brief System bandwidth signaled in bootstrap.
*/
typedef enum {
SONY_ATSC3_SYSTEM_BW_6_MHZ, /**< 6MHz */
SONY_ATSC3_SYSTEM_BW_7_MHZ, /**< 7MHz */
SONY_ATSC3_SYSTEM_BW_8_MHZ, /**< 8MHz */
SONY_ATSC3_SYSTEM_BW_OVER_8_MHZ /**< Greater than 8 MHz */
} sony_atsc3_system_bw_t;
/**
@brief Preamble pilot pattern signaled in bootstrap.
*/
typedef enum {
SONY_ATSC3_PREAMBLE_PILOT_3, /**< Dx = 3 */
SONY_ATSC3_PREAMBLE_PILOT_4, /**< Dx = 4 */
SONY_ATSC3_PREAMBLE_PILOT_6, /**< Dx = 6 */
SONY_ATSC3_PREAMBLE_PILOT_8, /**< Dx = 8 */
SONY_ATSC3_PREAMBLE_PILOT_12, /**< Dx = 12 */
SONY_ATSC3_PREAMBLE_PILOT_16, /**< Dx = 16 */
SONY_ATSC3_PREAMBLE_PILOT_24, /**< Dx = 24 */
SONY_ATSC3_PREAMBLE_PILOT_32, /**< Dx = 32 */
} sony_atsc3_preamble_pilot_t;
/**
@brief L1-Basic fec type signaled in bootstrap.
*/
typedef enum {
SONY_ATSC3_L1B_FEC_TYPE_MODE1, /**< Mode 1 */
SONY_ATSC3_L1B_FEC_TYPE_MODE2, /**< Mode 2 */
SONY_ATSC3_L1B_FEC_TYPE_MODE3, /**< Mode 3 */
SONY_ATSC3_L1B_FEC_TYPE_MODE4, /**< Mode 4 */
SONY_ATSC3_L1B_FEC_TYPE_MODE5, /**< Mode 5 */
SONY_ATSC3_L1B_FEC_TYPE_MODE6, /**< Mode 6 */
SONY_ATSC3_L1B_FEC_TYPE_MODE7, /**< Mode 7 */
SONY_ATSC3_L1B_FEC_TYPE_RESERVED /**< Reserved */
} sony_atsc3_l1b_fec_type_t;
/**
@brief Presence or absence of timing information, and precision indicator signaled in L1-Basic.
*/
typedef enum {
SONY_ATSC3_TIME_INFO_FLAG_NONE, /**< Time information is not included */
SONY_ATSC3_TIME_INFO_FLAG_MS, /**< ms precision */
SONY_ATSC3_TIME_INFO_FLAG_US, /**< us precision */
SONY_ATSC3_TIME_INFO_FLAG_NS /**< ns precision */
} sony_atsc3_time_info_flag_t;
/**
@brief PAPR (Peak to Average Power Ratio) reduction indicator signaled in L1-Basic.
*/
typedef enum {
SONY_ATSC3_PAPR_NONE, /**< No PAPR reduction used */
SONY_ATSC3_PAPR_TR, /**< Tone reservation only */
SONY_ATSC3_PAPR_ACE, /**< ACE (Active Constellation Extension) only */
SONY_ATSC3_PAPR_TR_ACE /**< Both TR and ACE */
} sony_atsc3_papr_t;
/**
@brief L1-Detail fec type signaled in L1-Basic.
*/
typedef enum {
SONY_ATSC3_L1D_FEC_TYPE_MODE1, /**< Mode 1 */
SONY_ATSC3_L1D_FEC_TYPE_MODE2, /**< Mode 2 */
SONY_ATSC3_L1D_FEC_TYPE_MODE3, /**< Mode 3 */
SONY_ATSC3_L1D_FEC_TYPE_MODE4, /**< Mode 4 */
SONY_ATSC3_L1D_FEC_TYPE_MODE5, /**< Mode 5 */
SONY_ATSC3_L1D_FEC_TYPE_MODE6, /**< Mode 6 */
SONY_ATSC3_L1D_FEC_TYPE_MODE7, /**< Mode 7 */
SONY_ATSC3_L1D_FEC_TYPE_RESERVED /**< Reserved */
} sony_atsc3_l1d_fec_type_t;
/**
@brief MISO (Multiple Input Single Output) option used in L1-Basic and L1-Detail.
*/
typedef enum {
SONY_ATSC3_MISO_NONE, /**< No MISO */
SONY_ATSC3_MISO_64, /**< MISO with 64 coefficients */
SONY_ATSC3_MISO_256, /**< MISO with 256 coefficients */
SONY_ATSC3_MISO_RESERVED /**< Reserved */
} sony_atsc3_miso_t;
/**
@brief FFT size indicator used in L1-Basic and L1-Detail.
*/
typedef enum {
SONY_ATSC3_FFT_SIZE_8K, /**< 8K */
SONY_ATSC3_FFT_SIZE_16K, /**< 16K */
SONY_ATSC3_FFT_SIZE_32K, /**< 32K */
SONY_ATSC3_FFT_SIZE_RESERVED /**< Reserved */
} sony_atsc3_fft_size_t;
/**
@brief Guard interval indicator used in L1-Basic and L1-Detail.
*/
typedef enum {
SONY_ATSC3_GI_RESERVED_0, /**< Reserved */
SONY_ATSC3_GI_1_192, /**< 1/192 */
SONY_ATSC3_GI_2_384, /**< 2/384 */
SONY_ATSC3_GI_3_512, /**< 3/512 */
SONY_ATSC3_GI_4_768, /**< 4/768 */
SONY_ATSC3_GI_5_1024, /**< 5/1024 */
SONY_ATSC3_GI_6_1536, /**< 6/1536 */
SONY_ATSC3_GI_7_2048, /**< 7/2048 */
SONY_ATSC3_GI_8_2432, /**< 8/2432 */
SONY_ATSC3_GI_9_3072, /**< 9/3072 */
SONY_ATSC3_GI_10_3648, /**< 10/3648 */
SONY_ATSC3_GI_11_4096, /**< 11/4096 */
SONY_ATSC3_GI_12_4864, /**< 12/4864 */
SONY_ATSC3_GI_RESERVED_13, /**< Reserved */
SONY_ATSC3_GI_RESERVED_14, /**< Reserved */
SONY_ATSC3_GI_RESERVED_15 /**< Reserved */
} sony_atsc3_gi_t;
/**
@brief Scattered pilot pattern indicator signaled in L1-Detail.
*/
typedef enum {
SONY_ATSC3_SP_3_2, /**< SP3_2 for SISO, MP3_2 for MISO */
SONY_ATSC3_SP_3_4, /**< SP3_4 for SISO, MP3_4 for MISO */
SONY_ATSC3_SP_4_2, /**< SP4_2 for SISO, MP4_2 for MISO */
SONY_ATSC3_SP_4_4, /**< SP4_4 for SISO, MP4_4 for MISO */
SONY_ATSC3_SP_6_2, /**< SP6_2 for SISO, MP6_2 for MISO */
SONY_ATSC3_SP_6_4, /**< SP6_4 for SISO, MP6_4 for MISO */
SONY_ATSC3_SP_8_2, /**< SP8_2 for SISO, MP8_2 for MISO */
SONY_ATSC3_SP_8_4, /**< SP8_4 for SISO, MP8_4 for MISO */
SONY_ATSC3_SP_12_2, /**< SP12_2 for SISO, MP12_2 for MISO */
SONY_ATSC3_SP_12_4, /**< SP12_4 for SISO, MP12_4 for MISO */
SONY_ATSC3_SP_16_2, /**< SP16_2 for SISO, MP16_2 for MISO */
SONY_ATSC3_SP_16_4, /**< SP16_4 for SISO, MP16_4 for MISO */
SONY_ATSC3_SP_24_2, /**< SP24_2 for SISO, MP24_2 for MISO */
SONY_ATSC3_SP_24_4, /**< SP24_4 for SISO, MP24_4 for MISO */
SONY_ATSC3_SP_32_2, /**< SP32_2 for SISO, MP32_2 for MISO */
SONY_ATSC3_SP_32_4, /**< SP32_4 for SISO, MP32_4 for MISO */
SONY_ATSC3_SP_RESERVED_16, /**< Reserved */
SONY_ATSC3_SP_RESERVED_17, /**< Reserved */
SONY_ATSC3_SP_RESERVED_18, /**< Reserved */
SONY_ATSC3_SP_RESERVED_19, /**< Reserved */
SONY_ATSC3_SP_RESERVED_20, /**< Reserved */
SONY_ATSC3_SP_RESERVED_21, /**< Reserved */
SONY_ATSC3_SP_RESERVED_22, /**< Reserved */
SONY_ATSC3_SP_RESERVED_23 /**< Reserved */
} sony_atsc3_sp_t;
/**
@brief PLP FEC type definition signaled in L1-Detail.
*/
typedef enum {
SONY_ATSC3_PLP_FEC_BCH_LDPC_16K, /**< BCH + 16K LDPC */
SONY_ATSC3_PLP_FEC_BCH_LDPC_64K, /**< BCH + 64K LDPC */
SONY_ATSC3_PLP_FEC_CRC_LDPC_16K, /**< CRC + 16K LDPC */
SONY_ATSC3_PLP_FEC_CRC_LDPC_64K, /**< CRC + 64K LDPC */
SONY_ATSC3_PLP_FEC_LDPC_16K, /**< 16K LDPC only */
SONY_ATSC3_PLP_FEC_LDPC_64K, /**< 64K LDPC only */
SONY_ATSC3_PLP_FEC_RESERVED_6, /**< Reserved */
SONY_ATSC3_PLP_FEC_RESERVED_7, /**< Reserved */
SONY_ATSC3_PLP_FEC_RESERVED_8, /**< Reserved */
SONY_ATSC3_PLP_FEC_RESERVED_9, /**< Reserved */
SONY_ATSC3_PLP_FEC_RESERVED_10, /**< Reserved */
SONY_ATSC3_PLP_FEC_RESERVED_11, /**< Reserved */
SONY_ATSC3_PLP_FEC_RESERVED_12, /**< Reserved */
SONY_ATSC3_PLP_FEC_RESERVED_13, /**< Reserved */
SONY_ATSC3_PLP_FEC_RESERVED_14, /**< Reserved */
SONY_ATSC3_PLP_FEC_RESERVED_15 /**< Reserved */
} sony_atsc3_plp_fec_t;
/**
@brief PLP modulation signaled in L1-Detail.
*/
typedef enum {
SONY_ATSC3_PLP_MOD_QPSK, /**< QPSK */
SONY_ATSC3_PLP_MOD_16QAM, /**< 16QAM-NUC */
SONY_ATSC3_PLP_MOD_64QAM, /**< 64QAM-NUC */
SONY_ATSC3_PLP_MOD_256QAM, /**< 256QAM-NUC */
SONY_ATSC3_PLP_MOD_1024QAM, /**< 1024QAM-NUC */
SONY_ATSC3_PLP_MOD_4096QAM, /**< 4096QAM-NUC */
SONY_ATSC3_PLP_MOD_RESERVED_6, /**< Reserved */
SONY_ATSC3_PLP_MOD_RESERVED_7, /**< Reserved */
SONY_ATSC3_PLP_MOD_RESERVED_8, /**< Reserved */
SONY_ATSC3_PLP_MOD_RESERVED_9, /**< Reserved */
SONY_ATSC3_PLP_MOD_RESERVED_10, /**< Reserved */
SONY_ATSC3_PLP_MOD_RESERVED_11, /**< Reserved */
SONY_ATSC3_PLP_MOD_RESERVED_12, /**< Reserved */
SONY_ATSC3_PLP_MOD_RESERVED_13, /**< Reserved */
SONY_ATSC3_PLP_MOD_RESERVED_14, /**< Reserved */
SONY_ATSC3_PLP_MOD_RESERVED_15 /**< Reserved */
} sony_atsc3_plp_mod_t;
/**
@brief PLP code rate signaled in L1-Detail.
*/
typedef enum {
SONY_ATSC3_PLP_COD_2_15, /**< 2/15 */
SONY_ATSC3_PLP_COD_3_15, /**< 3/15 */
SONY_ATSC3_PLP_COD_4_15, /**< 4/15 */
SONY_ATSC3_PLP_COD_5_15, /**< 5/15 */
SONY_ATSC3_PLP_COD_6_15, /**< 6/15 */
SONY_ATSC3_PLP_COD_7_15, /**< 7/15 */
SONY_ATSC3_PLP_COD_8_15, /**< 8/15 */
SONY_ATSC3_PLP_COD_9_15, /**< 9/15 */
SONY_ATSC3_PLP_COD_10_15, /**< 10/15 */
SONY_ATSC3_PLP_COD_11_15, /**< 11/15 */
SONY_ATSC3_PLP_COD_12_15, /**< 12/15 */
SONY_ATSC3_PLP_COD_13_15, /**< 13/15 */
SONY_ATSC3_PLP_COD_RESERVED_12, /**< Reserved */
SONY_ATSC3_PLP_COD_RESERVED_13, /**< Reserved */
SONY_ATSC3_PLP_COD_RESERVED_14, /**< Reserved */
SONY_ATSC3_PLP_COD_RESERVED_15 /**< Reserved */
} sony_atsc3_plp_cod_t;
/**
@brief PLP time interleaving mode signaled in L1-Detail.
*/
typedef enum {
SONY_ATSC3_PLP_TI_NONE, /**< No time interleaving mode */
SONY_ATSC3_PLP_TI_CTI, /**< Convolutional time interleaving */
SONY_ATSC3_PLP_TI_HTI, /**< Hybrid time interleaving */
SONY_ATSC3_PLP_TI_RESERVED /**< Reserved */
} sony_atsc3_plp_ti_t;
/**
@brief PLP channel bonding format signaled in L1-Detail.
*/
typedef enum {
SONY_ATSC3_PLP_CH_BOND_FMT_PLAIN, /**< Plain channel bonding */
SONY_ATSC3_PLP_CH_BOND_FMT_SNR, /**< SNR averaged channel bonding */
SONY_ATSC3_PLP_CH_BOND_FMT_RESERVED_2, /**< Reserved */
SONY_ATSC3_PLP_CH_BOND_FMT_RESERVED_3 /**< Reserved */
} sony_atsc3_plp_ch_bond_fmt_t;
/**
@brief Number of rows used in the CTI signaled in L1-Detail.
*/
typedef enum {
SONY_ATSC3_PLP_CTI_DEPTH_512, /**< 512 */
SONY_ATSC3_PLP_CTI_DEPTH_724, /**< 724 */
SONY_ATSC3_PLP_CTI_DEPTH_887_1254, /**< 887 (non-extended interleaving) or 1254 (extended interleaving) */
SONY_ATSC3_PLP_CTI_DEPTH_1024_1448, /**< 1024 (non-extended interleaving) or 1448 (extended interleaving) */
SONY_ATSC3_PLP_CTI_DEPTH_RESERVED_4, /**< Reserved */
SONY_ATSC3_PLP_CTI_DEPTH_RESERVED_5, /**< Reserved */
SONY_ATSC3_PLP_CTI_DEPTH_RESERVED_6, /**< Reserved */
SONY_ATSC3_PLP_CTI_DEPTH_RESERVED_7 /**< Reserved */
} sony_atsc3_plp_cti_depth_t;
/**
@brief Enhanced PLP's injection level signaled in L1-Detail.
*/
typedef enum {
SONY_ATSC3_PLP_LDM_INJ_LEVEL_0_0, /**< 0.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_0_5, /**< 0.5 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_1_0, /**< 1.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_1_5, /**< 1.5 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_2_0, /**< 2.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_2_5, /**< 2.5 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_3_0, /**< 3.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_3_5, /**< 3.5 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_4_0, /**< 4.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_4_5, /**< 4.5 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_5_0, /**< 5.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_6_0, /**< 6.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_7_0, /**< 7.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_8_0, /**< 8.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_9_0, /**< 9.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_10_0, /**< 10.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_11_0, /**< 11.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_12_0, /**< 12.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_13_0, /**< 13.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_14_0, /**< 14.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_15_0, /**< 15.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_16_0, /**< 16.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_17_0, /**< 17.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_18_0, /**< 18.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_19_0, /**< 19.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_20_0, /**< 20.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_21_0, /**< 21.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_22_0, /**< 22.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_23_0, /**< 23.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_24_0, /**< 24.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_25_0, /**< 25.0 dB */
SONY_ATSC3_PLP_LDM_INJ_LEVEL_RESERVED, /**< Reserved */
} sony_atsc3_plp_ldm_inj_level_t;
/*------------------------------------------------------------------------------
Structs
------------------------------------------------------------------------------*/
/**
@brief ATSC 3.0 bootstrap information.
*/
typedef struct sony_atsc3_bootstrap_t {
uint8_t bw_diff; /**< If 1, system bandwidth setting is different from signal. */
sony_atsc3_system_bw_t system_bw; /**< Signal system bandwidth. */
uint8_t ea_wake_up; /**< Emergency alert wake up field. (2bit) */
} sony_atsc3_bootstrap_t;
/**
@brief ATSC 3.0 parameters estimated by demodulator.
@note Several parameters can be found in bootstrap, L1 too.
But note that they may NOT be latest L1 data received by demod.
These parameters are currently used by demodulator circuit.
*/
typedef struct sony_atsc3_ofdm_t {
sony_atsc3_system_bw_t system_bw; /**< System bandwidth. (6 or 7 or 8) */
uint8_t bs_num_symbol; /**< Number of bootstrap symbol - 1 */
uint8_t num_subframe; /**< Number of subframe - 1 */
sony_atsc3_l1b_fec_type_t l1b_fec_type; /**< L1-Basic fec type */
sony_atsc3_papr_t papr; /**< PAPR reduction */
uint8_t pb_num_symbol; /**< Number of preamble symbol - 1 */
sony_atsc3_fft_size_t pb_fft_size; /**< Preamble FFT size */
sony_atsc3_preamble_pilot_t pb_pilot; /**< Preamble pilot pattern */
uint8_t pb_reduced_carriers; /**< Cred_coeff indicator for preamble (0 - 4) */
sony_atsc3_gi_t pb_gi; /**< Preamble guard interval */
sony_atsc3_fft_size_t sf0_fft_size; /**< Subframe #0 FFT size */
sony_atsc3_sp_t sf0_sp; /**< Subframe #0 scattered pilot pattern */
uint8_t sf0_reduced_carriers;/**< Cred_coeff indicator for subframe #0 (0 - 4) */
sony_atsc3_gi_t sf0_gi; /**< Subframe #0 guard interval */
uint8_t sf0_sp_boost; /**< Subframe #0 scattered pilot boost (0 - 4) */
uint8_t sf0_sbs_first; /**< Subframe #0 subframe boundary symbol first flag */
uint8_t sf0_sbs_last; /**< Subframe #0 subframe boundary symbol last flag */
uint16_t sf0_num_ofdm_symbol; /**< Subframe #0 number of data payload OFDM symbols - 1 */
} sony_atsc3_ofdm_t;
/**
@brief ATSC 3.0 L1-Basic information.
*/
typedef struct sony_atsc3_l1basic_t {
/* System and Frame Parameters */
uint8_t version; /**< L1-Basic structure version. (currently 0) */
uint8_t mimo_sp_enc; /**< MIMO pilot encoding scheme (0 or 1) */
uint8_t lls_flg; /**< Presence or absence of Low Level Signaling (LLS) */
sony_atsc3_time_info_flag_t time_info_flg; /**< Presence or absence, and precision of timing information */
uint8_t return_ch_flg; /**< Dedicated return channel (DRC) is present or not */
sony_atsc3_papr_t papr; /**< PAPR reduction */
uint8_t frame_length_mode; /**< Frame is time-aligned (0) or symbol-aligned (1) */
/* Valid if frame_length_mode == 0 (time-aligned frame) */
uint16_t frame_length; /**< Frame length (5ms unit) */
uint16_t excess_smp_per_sym; /**< Additional number of excess samples included in the guard interval */
/* Valid if frame_length_mode == 1 (symbol-aligned frame) */
uint16_t time_offset; /**< Number of sample periods */
uint8_t additional_smp; /**< Number of additional samples at the end of frames */
/* endif */
uint8_t num_subframe; /**< Number of subframe - 1 */
/* Parameters for L1-Detail */
uint8_t pb_num_symbol; /**< Number of preamble symbol - 1 */
uint8_t pb_reduced_carriers; /**< Cred_coeff indicator for preamble (0 - 4) */
uint8_t l1d_content_tag; /**< Incremented if L1-Detail content is modified */
uint16_t l1d_size; /**< L1-Detail information size (byte) */
sony_atsc3_l1d_fec_type_t l1d_fec_type; /**< L1-Detail fec type */
uint8_t l1d_add_parity_mode; /**< L1-Detail Additional parity mode (0 - 2) */
uint32_t l1d_total_cells; /**< The total size (specified in OFDM cells) of L1-Detail signaling */
/* Parameters for First Subframe */
uint8_t sf0_mimo; /**< Subframe #0 MIMO or not */
sony_atsc3_miso_t sf0_miso; /**< Subframe #0 MISO option */
sony_atsc3_fft_size_t sf0_fft_size; /**< Subframe #0 FFT size */
uint8_t sf0_reduced_carriers;/**< Cred_coeff indicator for subframe #0 (0 - 4) */
sony_atsc3_gi_t sf0_gi; /**< Subframe #0 guard interval */
uint16_t sf0_num_ofdm_symbol; /**< Subframe #0 number of data payload OFDM symbols - 1 */
sony_atsc3_sp_t sf0_sp; /**< Subframe #0 scattered pilot pattern */
uint8_t sf0_sp_boost; /**< Subframe #0 scattered pilot boost (0 - 4) */
uint8_t sf0_sbs_first; /**< Subframe #0 subframe boundary symbol first flag */
uint8_t sf0_sbs_last; /**< Subframe #0 subframe boundary symbol last flag */
/* Miscellaneous Parameters */
uint8_t reserved[6]; /**< Reserved for future use */
} sony_atsc3_l1basic_t;
/**
@brief ATSC 3.0 L1-Detail information raw data.
*/
typedef struct sony_atsc3_l1detail_raw_t {
uint16_t size; /**< L1-Detail information size (byte) */
uint8_t data[8191]; /**< Raw data buffer */
} sony_atsc3_l1detail_raw_t;
/**
@brief ATSC 3.0 L1-Detail common information.
*/
typedef struct sony_atsc3_l1detail_common_t {
uint8_t version; /**< L1-Detail structure version */
uint8_t num_rf; /**< Number of other frequencies in channel bonding (0 or 1) */
uint16_t bonded_bsid; /**< BSID of separate RF channel (valid if num_rf == 1) */
/* Valid if time_info_flg (sony_atsc3_l1base_t) != NONE */
uint32_t time_sec; /**< Time information (sec) */
uint16_t time_msec; /**< Time information (msec) */
/* Valid if time_info_flg (sony_atsc3_l1base_t) == US or NS */
uint16_t time_usec; /**< Time information (usec) */
/* Valid if time_info_flg (sony_atsc3_l1base_t) == NS */
uint16_t time_nsec; /**< Time information (nsec) */
uint16_t bsid; /**< BSID of the current channel */
uint16_t reserved_bitlen; /**< Size of reserved data (bit) */
} sony_atsc3_l1detail_common_t;
/**
@brief ATSC 3.0 L1-Detail subframe specific information.
*/
typedef struct sony_atsc3_l1detail_subframe_t {
uint8_t index; /**< Subframe index */
uint8_t mimo; /**< MIMO or not */
sony_atsc3_miso_t miso; /**< MISO option */
sony_atsc3_fft_size_t fft_size; /**< FFT size */
uint8_t reduced_carriers; /**< Cred_coeff indicator (0 - 4) */
sony_atsc3_gi_t gi; /**< Guard interval */
uint16_t num_ofdm_symbol; /**< Number of data payload OFDM symbols - 1 */
sony_atsc3_sp_t sp; /**< Scattered pilot pattern */
uint8_t sp_boost; /**< Scattered pilot boost (0 - 4) */
uint8_t sbs_first; /**< Subframe boundary symbol first flag */
uint8_t sbs_last; /**< Subframe boundary symbol last flag */
/* Valid if num_subframe (sony_atsc3_l1base_t) > 0 */
uint8_t subframe_mux; /**< Time-division multiplexed or concatenated in time */
uint8_t freq_interleaver; /**< Frequency interleaver is enabled or not */
/* Valid if sbs_first || sbs_last */
uint16_t sbs_null_cells; /**< Number of null cells */
uint8_t num_plp; /**< Number of PLPs in the current subframe */
} sony_atsc3_l1detail_subframe_t;
/**
@brief ATSC 3.0 L1-Detail PLP specific information.
*/
typedef struct sony_atsc3_l1detail_plp_t {
uint8_t id; /**< PIP ID (0 - 63) assigned uniquely in each RF channel */
uint8_t lls_flg; /**< Current PLP contains LLS information or not */
uint8_t layer; /**< Layer index of current PLP (0 (Core Layer) or 1 (Enhanced Layer)) */
uint32_t start; /**< First data cell index */
uint32_t size; /**< Number of data cells allocated to the current PLP */
uint8_t scrambler_type; /**< Choice of scrambler (only 0 in current version) */
sony_atsc3_plp_fec_t fec_type; /**< PLP FEC method */
sony_atsc3_plp_mod_t mod; /**< PLP modulation */
sony_atsc3_plp_cod_t cod; /**< PLP code rate */
sony_atsc3_plp_ti_t ti_mode; /**< PLP time interleaving mode */
/* Valid if ti_mode == SONY_ATSC3_PLP_TI_NONE */
uint16_t fec_block_start; /**< Start position of the first FEC Block */
/* Valid if ti_mode == SONY_ATSC3_PLP_TI_CTI */
uint32_t cti_fec_block_start; /**< Position for CTI. (See spec) */
/* Valid if num_rf (sony_atsc3_l1detail_common_t) > 0 */
uint8_t num_ch_bonded; /**< Number of other frequencies in channel bonding for this PLP (0 or 1)*/
/* Valid if num_ch_bonded > 0 */
sony_atsc3_plp_ch_bond_fmt_t ch_bonding_format; /**< Channel bonding format for the current PLP */
uint8_t bonded_rf_id_0; /**< Bonded RF ID #0 */
uint8_t bonded_rf_id_1; /**< Bonded RF ID #1 */
/* Valid if mimo (sony_atsc3_l1detail_subframe_t) == 1 */
uint8_t mimo_stream_combine; /**< Stream combining option is used or not */
uint8_t mimo_iq_interleave; /**< IQ polarization interleaving option is used or not */
uint8_t mimo_ph; /**< Phase hopping option is used nor not */
/* Valid if layer (sony_atsc3_l1detail_plp_t) == 0 */
uint8_t plp_type; /**< Current PLP is non-dispersed (0) or dispersed (1) */
/* Valid if plp_type == 1 */
uint16_t num_subslice; /**< Number of subslice - 1 (1 - 16383) */
uint32_t subslice_interval; /**< Subslice interval (data cell unit) */
/* Valid if ti_mode == SONY_ATSC3_PLP_TI_CTI or
(ti_mode == SONY_ATSC3_PLP_TI_HTI and mod == SONY_ATSC3_PLP_MOD_QPSK) */
uint8_t ti_ext_interleave; /**< Extended interleaving is used or not */
/* Valid if ti_mode == SONY_ATSC3_PLP_TI_CTI */
sony_atsc3_plp_cti_depth_t cti_depth; /**< Number of rows used in the Convolutional Time Interleaver */
uint16_t cti_start_row; /**< Position of the interleaver selector at the start of the subframe*/
/* Valid if ti_mode == SONY_ATSC3_PLP_TI_HTI */
uint8_t hti_inter_subframe; /**< HTI is used or not in this subframe */
uint8_t hti_num_ti_blocks; /**< Number of TI blocks - 1 (0 - 15) */
uint16_t hti_num_fec_block_max; /**< Maximum number of FEC Blocks - 1 */
uint16_t hti_num_fec_block[16]; /**< Number of FEC Blocks - 1 */
uint8_t hti_cell_interleave; /**< Cell Interleaver is used or not */
/* Valid if layer (sony_atsc3_l1detail_plp_t) != 0 */
sony_atsc3_plp_ldm_inj_level_t ldm_inj_level; /**< Enhanced PLP's injection level */
} sony_atsc3_l1detail_plp_t;
/**
@brief Minimum required PLP information got by ::sony_demod_atsc3_monitor_PLPList.
*/
typedef struct sony_atsc3_plp_list_entry_t {
uint8_t id; /**< PIP ID (0 - 63) assigned uniquely in each RF channel */
uint8_t lls_flg; /**< PLP contains LLS information or not */
uint8_t layer; /**< Layer index of current PLP (0 (Core Layer) or 1 (Enhanced Layer)) */
uint8_t chbond; /**< The PLP is channel bonded or not */
} sony_atsc3_plp_list_entry_t;
typedef struct sony_atsc3_plp_list_t {
uint8_t plpnum;
sony_atsc3_plp_list_entry_t plplist[SONY_ATSC3_NUM_PLP_MAX];
uint8_t actual_tun_plpnum;
} sony_atsc3_plp_list;
/**
@brief Quick PLP parameter monitor values for ::sony_demod_atsc3_monitor_FecModCod.
*/
typedef struct sony_atsc3_plp_fecmodcod_t {
uint8_t valid; /**< This PLP is valid or not */
sony_atsc3_plp_fec_t fec_type; /**< PLP FEC method */
sony_atsc3_plp_mod_t mod; /**< PLP modulation */
sony_atsc3_plp_cod_t cod; /**< PLP code rate */
} sony_atsc3_plp_fecmodcod_t;
#endif /* SONY_ATSC3_H */