stbota.c File Reference

API interfacing the midware with loader library. More...

#include <stdio.h>
#include <techtype.h>
#include <dbgfuncs.h>
#include "stbhwc.h"
#include "stbhwos.h"
#include "stbhwupg.h"
#include "stbdpc.h"
#include "stbheap.h"
#include "stberc.h"
#include "stbota.h"
#include "stbsitab.h"
#include "dsm_control.h"
#include "dsm_client.h"

Macros
#define	OTA_DBG(X)
#define	OTA_NVM_TASK_STACK   1024
#define	OTA_NVM_TASK_PRIORITY   6
#define	DSMCC_TASK_PRIORITY   6
#define	MAX_NVM_MSGS   30

Typedefs
typedef struct s_nvm_msg	S_NVM_MSG
typedef struct s_upg_mod	S_UPG_MOD

Enumerations
enum	E_MSG_TYPE {   MSG_INIT, MSG_START, MSG_SAVE, MSG_STOP,   MSG_DONE, MSG_ERROR, MSG_ABORT, MSG_QUIT }

Functions
BOOLEAN	STB_OTAStartLoader (U8BIT path, U16BIT onet_id, U16BIT tran_id, U16BIT serv_id, U16BIT download_pid, F_SSU_VERSION_CALLBACK version_cb)
	Starts the over-the-air download process. More...
void	STB_OTAStopLoader (void)
	Stops the download, if still in progress, but should also be called when the update process has completed (unless the update results in a system reboot). More...
U8BIT	STB_OTAGetProgress (void)
	Returns the SSU download progress as a percentage. More...
void	STB_OTAContinueDownload (BOOLEAN status)
	This function should be called to unblock the download process. This can be used to in the case where an update may not be mandatory to allow a user to reject an update. More...

Detailed Description

API interfacing the midware with loader library.

Date

01/10/2009

Author

Sergio Panseri

Function Documentation

void STB_OTAContinueDownload

(

BOOLEAN

status

)

This function should be called to unblock the download process. This can be used to in the case where an update may not be mandatory to allow a user to reject an update.

Parameters

status

TRUE if the download should continue, FALSE otherwise

U8BIT STB_OTAGetProgress

(

void

)

Returns the SSU download progress as a percentage.

Returns

Download progress as a percentage

BOOLEAN STB_OTAStartLoader	(	U8BIT	path,
		U16BIT	onet_id,
		U16BIT	tran_id,
		U16BIT	serv_id,
		U16BIT	download_pid,
		F_SSU_VERSION_CALLBACK	version_cb
	)

Starts the over-the-air download process.

Parameters

onet_id	original network ID of the transport containing the DSM-CC carousel
tran_id	transport ID of the transport containing the DSM-CC carousel
serv_id	service ID of the DSM-CC carousel, or DVB_INVALID_ID if the PID is given
download_pid	PID containing the download, or DVB_INVALID_ID if the service ID is given
version_cb	callback function that will be called when version info becomes available. If the callback is NULL then the update will always be accepted

Returns

TRUE if the update process is started, FALSE otherwise

void STB_OTAStopLoader

(

void

)

Stops the download, if still in progress, but should also be called when the update process has completed (unless the update results in a system reboot).

Stops the download process.