System Interface, Operating System. More...

#include <stdio.h>
#include <techtype.h>
#include <dbgfuncs.h>
#include "stbhwos.h"
#include "stbheap.h"
#include "hbbtv_sif_types.h"

Functions
void *	HBBTV_OSAlloc (U32BIT size)
	Allocates the specified number of bytes. More...

void	HBBTV_OSFree (void *ptr)
	Releases previously allocated memory. More...

void *	HBBTV_OSCreateMutex (void)
	Creates a new mutex. More...

void	HBBTV_OSDeleteMutex (void *mutex)
	Deletes an exisiting mutex. More...

void	HBBTV_OSMutexLock (void *mutex)
	Locks the specified mutex. More...

void	HBBTV_OSMutexUnlock (void *mutex)
	Unlocks the specified mutex. More...

void *	HBBTV_OSCreateCountSemaphore (U32BIT value)
	Creates a new counting semaphore, with the count set to value. More...

void	HBBTV_OSDeleteSemaphore (void *semaphore)
	Deletes an exisiting semaphore. More...

void	HBBTV_OSSemaphoreWait (void *semaphore)
	Waits for specified semaphore to be cleared. More...

BOOLEAN	HBBTV_OSSemaphoreWaitTimeout (void *semaphore, U16BIT timeout)
	Waits a specified timeout period for a specified semaphore to be cleared. More...

void	HBBTV_OSSemaphoreSignal (void *semaphore)
	Clears specified semaphore. More...

void *	HBBTV_OSCreateTask (void(function)(void ), void param, U32BIT stack, U8BIT priority, U8BIT name)
	Creates a new task. More...

void	HBBTV_OSDestroyTask (void *task_id)
	Destroys the specified task. More...

void	HBBTV_OSTaskDelay (U16BIT time)
	Suspends current task for given period. More...

U32BIT	HBBTV_OSGetClockMilliseconds (void)
	Returns the number of milliseconds since the system booted. More...

U32BIT	HBBTV_OSGetTimeNow (void)
	Returns the current time. More...

void *	HBBTV_OSCreateQueue (U16BIT msg_size, U16BIT msg_max)
	Creates a new message queue. More...

void	HBBTV_OSDeleteQueue (void *queue)
	Deletes the specified message queue. More...

BOOLEAN	HBBTV_OSReadQueue (void queue, void msg, U16BIT msg_size, U16BIT timeout)
	Reads a message from specified queue. More...

BOOLEAN	HBBTV_OSWriteQueue (void queue, void msg, U16BIT msg_size, U16BIT timeout)
	Writes a message to specified queue. More...

Detailed Description

System Interface, Operating System.

Date: January 2014

Author: Sergio Panseri

Function Documentation

void* HBBTV_OSAlloc ( U32BIT size )

Allocates the specified number of bytes.

Parameters

size	Required size of new memory block.

Returns: Pointer to memory location.

void* HBBTV_OSCreateCountSemaphore ( U32BIT value )

Creates a new counting semaphore, with the count set to value.

Parameters

value Initial value of count

Returns: New semaphore handle

void* HBBTV_OSCreateMutex ( void )

Creates a new mutex.

Returns: New mutex handle

void* HBBTV_OSCreateQueue	(	U16BIT	msg_size,
		U16BIT	msg_max
	)

Creates a new message queue.

Parameters

msg_size	Size of each message in queue
msg_max	Maximum number of messages in queue

Returns: New queue handle

void* HBBTV_OSCreateTask	(	void()(void )	function,
		void *	param,
		U32BIT	stack,
		U8BIT	priority,
		U8BIT *	name
	)

Creates a new task.

Parameters

function	Pointer to callback function
param	Parameter of above function
stack	Size of stack required in bytes
priority	0 - 15 (15 is highest)
name	Name to assign to task

Returns: New task handle

void HBBTV_OSDeleteMutex ( void * mutex )

Deletes an exisiting mutex.

Parameters

mutex Mutex handle

void HBBTV_OSDeleteQueue ( void * queue )

Deletes the specified message queue.

Parameters

queue Queue handle

void HBBTV_OSDeleteSemaphore ( void * semaphore )

Deletes an exisiting semaphore.

Parameters

semaphore Semaphore handle

void HBBTV_OSDestroyTask ( void * task_id )

Destroys the specified task.

Parameters

task_id Task handle

void HBBTV_OSFree ( void * ptr )

Releases previously allocated memory.

Parameters

ptr	Pointer to the memory block to be freed

U32BIT HBBTV_OSGetClockMilliseconds ( void )

Returns the number of milliseconds since the system booted.

Returns: Time in milliseconds

U32BIT HBBTV_OSGetTimeNow ( void )

Returns the current time.

Returns: Current time expressed in number of seconds passed since midnight (UTC) 1 January 1970

void HBBTV_OSMutexLock ( void * mutex )

Locks the specified mutex.

Parameters

mutex Mutex handle

void HBBTV_OSMutexUnlock ( void * mutex )

Unlocks the specified mutex.

Parameters

mutex Mutex handle

BOOLEAN HBBTV_OSReadQueue	(	void *	queue,
		void *	msg,
		U16BIT	msg_size,
		U16BIT	timeout
	)

Reads a message from specified queue.

Parameters

queue	Queue handle
msg	Pointer to the buffer where the received message will be copied
msg_size	Size of message
timeout	Timeout value (ms)

Returns: TRUE if message arrived, FALSE if timed out.

void HBBTV_OSSemaphoreSignal ( void * semaphore )

Clears specified semaphore.

Parameters

semaphore Semaphore handle

void HBBTV_OSSemaphoreWait ( void * semaphore )

Waits for specified semaphore to be cleared.

Parameters

semaphore Semaphore handle

BOOLEAN HBBTV_OSSemaphoreWaitTimeout	(	void *	semaphore,
		U16BIT	timeout
	)

Waits a specified timeout period for a specified semaphore to be cleared.

Parameters

semaphore	Semaphore handle
timeout	The timeout in milliseconds, HBBTV_OS_TIMEOUT_NOW or HBBTV_OS_TIMEOUT_NEVER

Returns: TRUE if the semaphore was obtained, FALSE otherwise.

void HBBTV_OSTaskDelay ( U16BIT time )

Suspends current task for given period.

Parameters

time	Number of milliseconds the task will be suspended

BOOLEAN HBBTV_OSWriteQueue	(	void *	queue,
		void *	msg,
		U16BIT	msg_size,
		U16BIT	timeout
	)

Writes a message to specified queue.

Parameters

queue	Queue handle
msg	Pointer to the message to be written
msg_size	Size of message
timeout	Timeout value (ms)

Returns: TRUE if message arrived, FALSE if timed out.

Functions

Detailed Description

Function Documentation