/* SPDX-License-Identifier: LGPL-2.1-only OR BSD-3-Clause */
/******************************************************************************
 *
 * This file is provided under a dual license.  When you use or
 * distribute this software, you may choose to be licensed under
 * version 2.1 of the GNU Lesser General Public License
 * ("LGPLv2.1 License") or BSD License.
 *
 * LGPLv2.1 License
 *
 * Copyright(C) 2019 MediaTek Inc.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of version 2.1 of the GNU Lesser General Public
 * License as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html for more
 * details.
 *
 * BSD LICENSE
 *
 * Copyright(C) 2019 MediaTek Inc.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 *  * Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *  * Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *  * Neither the name of the copyright holder nor the names of its
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *****************************************************************************/

/*----------------------------------------------------------------------------*/
/*! @file c_hbbtv.h
 *  $RCSfile: $
 *  $Revision: #1 $
 *  $Date: 2015/06/01 $
 *  $Author: xingju.wang $
 *
 *  @par Description: This header file declares HBBTV exported APIs.
 */
/*----------------------------------------------------------------------------*/
#ifndef _C_OPERA_HBBTV_SI_LOADER_H_
#define _C_OPERA_HBBTV_SI_LOADER_H_

/*-----------------------------------------------------------------------------
                    include files
-----------------------------------------------------------------------------*/
#include "u_common.h"
#include "u_handle.h"
#include "u_opera_hbbtv.h"
#include "u_opera_hbbtv_si_loader.h"
#include "x_opera_hbbtv_si_loader.h"

/*-----------------------------------------------------------------------------
                    macros, defines, typedefs, enums
-----------------------------------------------------------------------------*/

/*-----------------------------------------------------------------------------
                    functions declarations
-----------------------------------------------------------------------------*/

/*-----------------------------------------------------------------------------
 * Name: c_opera_hbbtv_sil_load
 *
 * Description: This function load HBBTV SI tables (for Comp)
 *
 * Inputs: --
 *
 * Outputs: ph_loader     handle of si loader
 *
 * Returns:
 *        OPERA_HBBTVR_OK            The routine is successful.
 *        OPERA_HBBTVR_FAIL          The routine is fail.
 *        OPERA_HBBTVR_INV_ARG   Indicates at least one argument is invalid
 * ----------------------------------------------------------------------------*/

extern INT32 c_opera_hbbtv_sil_load(
        HANDLE_T*                         ph_loader,
        HANDLE_T                          h_svctx,
        UINT16                            ui2_svl_id,
        UINT16                            ui2_svl_rec_id,
        x_opera_hbbtv_sil_nfy_fct         pf_load_nfy,
        VOID*                             pv_tag);

/*-----------------------------------------------------------------------------
 * Name: c_opera_hbbtv_sil_ait_event
 *
 * Description: This function notify ait event to opera(for Comp)
 *
 * Inputs: --
 *
 * Outputs: --
 *
 * Returns:
 *        OPERA_HBBTVR_OK            The routine is successful.
 *        OPERA_HBBTVR_FAIL          The routine is fail.
 *        OPERA_HBBTVR_INV_ARG   Indicates at least one argument is invalid
 * ----------------------------------------------------------------------------*/


extern INT32 c_opera_hbbtv_sil_ait_event(
    HANDLE_T                      h_loader,
    OPERA_HBBTV_SI_LOADER_EVENT_T e_event);

/*-----------------------------------------------------------------------------
 * Name: c_opera_hbbtv_get_si_loader
 *
 * Description: This function get SI loader handle(for Opera)
 *
 * Inputs: --
 *
 * Outputs: --
 *
 * Returns:
 *        OPERA_HBBTVR_OK            The routine is successful.
 *        OPERA_HBBTVR_FAIL          The routine is fail.
 *        OPERA_HBBTVR_INV_ARG   Indicates at least one argument is invalid
 * ----------------------------------------------------------------------------*/

extern INT32 c_opera_hbbtv_get_si_loader(HANDLE_T* ph_si_loader);

/*-----------------------------------------------------------------------------
 * Name: c_opera_hbbtv_sil_unload
 *
 * Description: This function unload HBBTV SI tables (for Comp)
 *
 * Inputs: --
 *
 * Outputs: --
 *
 * Returns:
 *        OPERA_HBBTVR_OK            The routine is successful.
 *        OPERA_HBBTVR_FAIL          The routine is fail.
 *        OPERA_HBBTVR_INV_ARG   Indicates at least one argument is invalid
 * ----------------------------------------------------------------------------*/

extern INT32 c_opera_hbbtv_sil_unload(HANDLE_T h_loader);

/*-----------------------------------------------------------------------------
 * Name: c_opera_hbbtv_sil_start_parse_temi
 *
 * Description: This function start parsing temi descriptor in dmx (for Opera)
 *
 * Inputs: --
 *
 * Outputs: --
 *
 * Returns:
 *        OPERA_HBBTVR_OK            The routine is successful.
 *        OPERA_HBBTVR_FAIL          The routine is fail.
 *        OPERA_HBBTVR_INV_ARG   Indicates at least one argument is invalid
 * ----------------------------------------------------------------------------*/

extern INT32 c_opera_hbbtv_sil_start_parse_temi(HANDLE_T h_loader,
                                                             UINT8    ui1_tag,
                                                             UINT8    ui1_timeline_id);

/*-----------------------------------------------------------------------------
 * Name: c_opera_hbbtv_sil_get_temi_descriptor
 *
 * Description: This function get temi info(for Opera)
 *
 * Inputs: --
 *
 * Outputs: --
 *
 * Returns:
 *        OPERA_HBBTVR_OK            The routine is successful.
 *        OPERA_HBBTVR_FAIL          The routine is fail.
 *        OPERA_HBBTVR_INV_ARG   Indicates at least one argument is invalid
 * ----------------------------------------------------------------------------*/

extern INT32 c_opera_hbbtv_sil_get_temi_descriptor(HANDLE_T h_loader,
                                                                UINT8    ui1_tag,
                                                                UINT8    ui1_timeline_id,
                                                                OPERA_HBBTV_MTDMX_TEMI_INFO_T *pt_temi_info);

/*-----------------------------------------------------------------------------
 * Name: c_opera_hbbtv_sil_stop_parse_temi
 *
 * Description: This function stop parsing temi descriptor in dmx(for Opera)
 *
 * Inputs: --
 *
 * Outputs: --
 *
 * Returns:
 *        OPERA_HBBTVR_OK            The routine is successful.
 *        OPERA_HBBTVR_FAIL          The routine is fail.
 *        OPERA_HBBTVR_INV_ARG   Indicates at least one argument is invalid
 * ----------------------------------------------------------------------------*/

extern INT32 c_opera_hbbtv_sil_stop_parse_temi(HANDLE_T h_loader,
                                                            UINT8    ui1_tag,
                                                            UINT8    ui1_timeline_id);

/*-----------------------------------------------------------------------------
 * Name: c_opera_hbbtv_sil_get
 *
 * Description: This function unload get SI tables Info(for Opera)
 *
 * Inputs: --
 *
 * Outputs: --
 *
 * Returns:
 *        OPERA_HBBTVR_OK            The routine is successful.
 *        OPERA_HBBTVR_FAIL          The routine is fail.
 *        OPERA_HBBTVR_INV_ARG   Indicates at least one argument is invalid
 * ----------------------------------------------------------------------------*/
extern INT32 c_opera_hbbtv_sil_get(
        HANDLE_T                    h_loader,
        OPERA_HBBTV_SIL_GET_TYPE    e_get_type,
        VOID*                       pv_input,
        VOID*                       pv_output,
        SIZE_T*                     pz_len);


#endif




