dvb/inc/app.h

Go to the documentation of this file.

/*******************************************************************************
 * Copyright © 2014 The DTVKit Open Software Foundation Ltd (www.dtvkit.org)
 * Copyright © 2004 Ocean Blue Software Ltd
 *
 * This file is part of a DTVKit Software Component
 * You are permitted to copy, modify or distribute this file subject to the terms
 * of the DTVKit 1.0 Licence which can be found in licence.txt or at www.dtvkit.org
 * 
 * THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
 * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
 * 
 * If you or your organisation is not a member of DTVKit then you have access
 * to this source code outside of the terms of the licence agreement
 * and you are expected to delete this and any associated files immediately.
 * Further information on DTVKit, membership and terms can be found at www.dtvkit.org
 *******************************************************************************/
#ifndef _APP_H
#define _APP_H

//---CONSTANT DEFINITIONS---------------------------------------------------------------------------
// application events
#define EV_SERVICE_NOT_RUNNING         0x0001
#define EV_SERVICE_AUDIO_PID_UPDATE    0x0002
#define EV_SERVICE_VIDEO_PID_UPDATE    0x0003
#define EV_SERVICE_SUBTITLE_UPDATE     0x0004
#define EV_SERVICE_SCRAMBLE_CHANGE     0x0005
#define EV_SERVICE_ANALOG_LOCKED       0x0006
#define EV_INDICATION_STATUS           0x0007
#define EV_SERVICE_ANALOG_STARTED      0x0008
#define EV_SERVICE_RUNNING             0x0009
#define EV_SERVICE_EIT_NOW_UPDATE      0x000a
#define EV_SERVICE_EIT_SCHED_UPDATE    0x000b
#define EV_SERVICE_ECM_PID_UPDATE      0x000c
#define EV_PVR_RECORDING_FAILED        0x000d
#define EV_SERVICE_VIDEO_CODEC_CHANGED 0x000e
#define EV_SERVICE_AUDIO_CODEC_CHANGED 0x000f
#define EV_SERVICE_CHANGED             0x0010
#define EV_SERVICE_STREAMS_CHANGED     0x0011
#define EV_SERVICE_SI_PID_UPDATE       0x0012
#define EV_TIME_CHANGED                0x0013
#define EV_CIPLUS_TUNE_COMPLETED       0x0014
#define EV_SERVICE_DELETED             0x0015
#define EV_TIMER_TRIGGERED             0x0016

#define APP_EVENT_SERVICE_NOT_RUNNING           EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_NOT_RUNNING)
#define APP_EVENT_SERVICE_AUDIO_PID_UPDATE      EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_AUDIO_PID_UPDATE)
#define APP_EVENT_SERVICE_VIDEO_PID_UPDATE      EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_VIDEO_PID_UPDATE)
#define APP_EVENT_SERVICE_SUBTITLE_UPDATE       EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_SUBTITLE_UPDATE)
#define APP_EVENT_SERVICE_SCRAMBLE_CHANGE       EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_SCRAMBLE_CHANGE)
#define APP_EVENT_SERVICE_ANALOG_LOCKED         EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_ANALOG_LOCKED)
#define APP_EVENT_SERVICE_ANALOG_STARTED        EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_ANALOG_STARTED)
#define APP_EVENT_INDICATION_STATUS             EVENT_CODE(EV_CLASS_APPLICATION, EV_INDICATION_STATUS)
#define APP_EVENT_SERVICE_RUNNING               EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_RUNNING)
#define APP_EVENT_SERVICE_EIT_NOW_UPDATE        EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_EIT_NOW_UPDATE)
#define APP_EVENT_SERVICE_EIT_SCHED_UPDATE      EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_EIT_SCHED_UPDATE)
#define APP_EVENT_SERVICE_ECM_PID_UPDATE        EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_ECM_PID_UPDATE)
#define APP_EVENT_PVR_RECORDING_FAILED          EVENT_CODE(EV_CLASS_APPLICATION, EV_PVR_RECORDING_FAILED)
#define APP_EVENT_SERVICE_VIDEO_CODEC_CHANGED   EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_VIDEO_CODEC_CHANGED)
#define APP_EVENT_SERVICE_AUDIO_CODEC_CHANGED   EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_AUDIO_CODEC_CHANGED)
#define APP_EVENT_SERVICE_CHANGED               EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_CHANGED)
#define APP_EVENT_SERVICE_STREAMS_CHANGED       EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_STREAMS_CHANGED)
#define APP_EVENT_SERVICE_SI_PID_UPDATE         EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_SI_PID_UPDATE)
#define APP_EVENT_TIME_CHANGED                  EVENT_CODE(EV_CLASS_APPLICATION, EV_TIME_CHANGED)
#define APP_EVENT_CIPLUS_TUNE_COMPLETED         EVENT_CODE(EV_CLASS_APPLICATION, EV_CIPLUS_TUNE_COMPLETED)
#define APP_EVENT_SERVICE_DELETED               EVENT_CODE(EV_CLASS_APPLICATION, EV_SERVICE_DELETED)
#define APP_EVENT_TIMER_TRIGGERED               EVENT_CODE(EV_CLASS_APPLICATION, EV_TIMER_TRIGGERED)

#define DISK_NAME_LEN               40    /* Max length for the name of a disk */

//---TYPEDEFS-STRUCTS-ENUMERATIONS------------------------------------------------------------------
typedef enum
{
   ACB_GET_SUBTITLE_PREF,
   ACB_GET_AD_PREF,
   ACB_GET_UI_LANG_PREF,
   ACB_NUM_INFO_TYPES
} E_ACB_INFO_TYPE;

typedef struct
{
   BOOLEAN pref;
} S_ACB_SUBTITLE_PREF;

typedef struct
{
   BOOLEAN pref;
} S_ACB_AD_PREF;

typedef struct
{
   E_ACB_INFO_TYPE type;
   union
   {
      S_ACB_SUBTITLE_PREF subtitle;
      S_ACB_AD_PREF ad;
      U8BIT ui_lang_id;
   } u;
} S_ACB_UI_INFO;

/*!**************************************************************************
 * @brief   Callback function implemented in the UI. This function is called
 *          by the DVB module to query values defined in the UI (e.g. user
 *          preferences)
 * @param   S_ACB_UI_INFO (IN/OUT) pointer to the structure that contains
 *          the type of request and other fields to exchange information
 *          between the DVB and the UI. These fields can be input or output
 *          values depending on the query type.
 * @return  TRUE if the information is returned, FALSE otherwise
 ****************************************************************************/
typedef BOOLEAN (*ACB_INFO_CALLBACK)(S_ACB_UI_INFO *info);

//---DEFINE THE GLOBAL VARIABLES--------------------------------------------------------------------

//---FUNCTION PROTOTYPES----------------------------------------------------------------------------
BOOLEAN APP_InitialiseDVB(void (*event_handler)(U32BIT event, void *event_data, U32BIT data_size));

void APP_TerminateDVB(void);

// version string/Number retrieval
U8BIT* App_GetVersionString(void);
U32BIT App_GetVersionNumber(void);

void APP_RegisterUIInfoCallback(ACB_INFO_CALLBACK ui_info_callback);

#endif //  _APP_H
//**************************************************************************************************
// End of File
//**************************************************************************************************