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_demod_atsc3.h
Executable
+244
View File
@@ -0,0 +1,244 @@
/*------------------------------------------------------------------------------
Copyright 2018-2019 Sony Semiconductor Solutions Corporation
Last Updated : 2019/10/04
Modification ID : ae1245fdaf66401838902e7214d8494b0f5e5a76
------------------------------------------------------------------------------*/
/**
@file sony_demod_atsc3.h
This file provides the demodulator control interface specific to ATSC 3.0.
*/
/*----------------------------------------------------------------------------*/
#ifndef SONY_DEMOD_ATSC3_H
#define SONY_DEMOD_ATSC3_H
#include "../sony_common.h"
#include "../sony_demod.h"
#ifdef SONY_DEMOD_SUPPORT_ATSC3_CHBOND
#include "sony_demod_atsc3_chbond.h"
#endif
/*------------------------------------------------------------------------------
Structs
------------------------------------------------------------------------------*/
/**
@brief The tune parameters for a ATSC 3.0 signal
*/
typedef struct sony_atsc3_tune_param_t {
/**
@brief Center frequency in kHz of the ATSC 3.0 channel.
*/
uint32_t centerFreqKHz;
/**
@brief Bandwidth of the ATSC 3.0 channel.
*/
sony_dtv_bandwidth_t bandwidth;
/**
@brief Number of valid PLP ID in plpID[].
*/
uint8_t plpIDNum;
/**
@brief PLP IDs to select in acquisition.
*/
uint8_t plpID[4];
#ifdef SONY_DEMOD_SUPPORT_ATSC3_CHBOND
/**
@brief PLP bonding option for each PLPs.
Used only then the demod is configured as ATSC 3.0 channel bonding main/sub IC.
For main IC, the user should arrange PLP IDs on following constraints.
* plpBond[0] must be SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_ENABLE or SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_FROM_MAIN
* SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_FROM_SUB PLP cannot be located prior to
SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_ENABLE or SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_FROM_MAIN PLPs
on plpID[] and plpBond[].
For example, following is invalid.
plpBond[0] = SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_ENABLE
plpBond[1] = SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_ENABLE
plpBond[2] = SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_FROM_SUB
plpBond[3] = SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_FROM_MAIN
The user should change PLP ID selection order like as follows.
plpBond[0] = SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_ENABLE
plpBond[1] = SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_ENABLE
plpBond[2] = SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_FROM_MAIN
plpBond[3] = SONY_DEMOD_ATSC3_CHBOND_PLP_BOND_FROM_SUB
*/
sony_demod_atsc3_chbond_plp_bond_t plpBond[4];
#endif
} sony_atsc3_tune_param_t;
/*------------------------------------------------------------------------------
Functions
------------------------------------------------------------------------------*/
/**
@brief Enable acquisition on the demodulator for ATSC 3.0 channels. Called from
the integration layer ::sony_integ_atsc3_Tune API.
@param pDemod The demodulator instance
@param pTuneParam The tune parameters.
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_Tune (sony_demod_t * pDemod,
sony_atsc3_tune_param_t * pTuneParam);
/**
@brief Enable acquisition on the demodulator for ATSC 3.0 channels in EAS mode.
Called from the integration layer ::sony_integ_atsc3_EASTune API.
@param pDemod The demodulator instance
@param pTuneParam The tune parameters.
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_EASTune (sony_demod_t * pDemod,
sony_atsc3_tune_param_t * pTuneParam);
/**
@brief Put the demodulator into ::SONY_DEMOD_STATE_SLEEP state. Can be called
from Active, Shutdown or Sleep states. Called from the integration layer
::sony_integ_Sleep API.
@param pDemod The demodulator instance
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_Sleep (sony_demod_t * pDemod);
/**
@brief Completes the demodulator acquisition setup only the case for ATSC 3.0 EAS tune.
Must be called after system specific demod and RF tunes.
Called from the integration layer ::sony_integ_atsc3_EASTune API.
@param pDemod The demodulator instance
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_EASTuneEnd (sony_demod_t * pDemod);
/**
@brief Check ATSC 3.0 demodulator lock status.
@note This API is for checking lock status in tuning stage.
After tuning (while receiving the signal),
please use sony_demod_atsc3_monitor_SyncStat instead
to check current lock status.
@param pDemod The demodulator instance
@param pLock Demod lock state
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_CheckDemodLock (sony_demod_t * pDemod,
sony_demod_lock_result_t * pLock);
/**
@brief Check ATSC 3.0 ALP lock status.
@note This API is for checking lock status in tuning stage.
After tuning (while receiving the signal),
please use sony_demod_atsc3_monitor_SyncStat instead
to check current lock status.
@param pDemod The demodulator instance
@param pLock TS lock state
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_CheckALPLock (sony_demod_t * pDemod,
sony_demod_lock_result_t * pLock,
uint8_t *p_syncState,
uint8_t *p_alpLockAll);
/**
@brief Setup the PLP configuration of the demodulator.
@param pDemod The demodulator instance.
@param plpIDNum Number of valid PLP ID in plpID[]. (1 - 4)
@param plpID The pointer of PLP ID 4 length array to set.
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_SetPLPConfig (sony_demod_t * pDemod,
uint8_t plpIDNum,
uint8_t plpID[4]);
/**
@brief Clear BER, SNR history data for averaged BER, SNR, SQI monitors.
@note This function may be useful if the user would like to calculate
averaged BER, SNR, SQI without using old BER, SNR data.
Please check document and example code for recommended setting and sequence.
@param pDemod The demodulator instance
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_ClearBERSNRHistory (sony_demod_t * pDemod);
/**
@brief Clear GPIO EAS latch data for GPIO EAS latch mode.
Clear GPIO EAS latch data.
Please check ::SONY_DEMOD_CONFIG_ATSC3_GPIO_EAS_PN_STATE
and ::SONY_DEMOD_CONFIG_ATSC3_GPIO_EAS_PN_TRANS too.
To output EAS state from GPIO, please check ::sony_demod_GPIOSetConfig.
@param pDemod The demodulator instance
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_ClearGPIOEASLatch (sony_demod_t * pDemod);
/**
@brief Spectrum inversion and continuous wave auto detection.
@note Auto spectrum inversion and CW detection are enabled/disabled by ::sony_demod_SetConfig.
(::SONY_DEMOD_CONFIG_ATSC3_AUTO_SPECTRUM_INV, ::SONY_DEMOD_CONFIG_ATSC3_CW_DETECTION)
@param pDemod The demodulator instance
@param pContinueWait Lock wait flag (When this flag = 1, continue waiting Lock)
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_AutoDetectSeq_UnlockCase (sony_demod_t * pDemod, uint8_t * pContinueWait);
/**
@brief Setup continuous wave tracking.
@note This API has effect only when CW detection is enabled by ::sony_demod_SetConfig.
(::SONY_DEMOD_CONFIG_ATSC3_CW_DETECTION)
@param pDemod The demodulator instance
@param pCompleted CW Tracking setting completed flag (When this flag = 1, CW tracking setting is completed)
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_AutoDetectSeq_SetCWTracking (sony_demod_t * pDemod, uint8_t * pCompleted);
/**
@brief Initialize spectrum inversion and continuous wave auto detection related registers.
@param pDemod The demodulator instance
@return SONY_RESULT_OK if successful.
*/
sony_result_t sony_demod_atsc3_AutoDetectSeq_Init (sony_demod_t * pDemod);
#endif /* SONY_DEMOD_ATSC3_H */