source: svn/trunk/zas_dstar/hal/os/src/os_prive.h

/****************************************************************************
 * Copyright (c) 2006 DST Technologies Inc.  All Rights Reserved.   
 *
 * Module:      OS LOCAL
 *
 * Description: OS APIs for Core internal use
 *              Informations in this file apply to all OSes in use.
 *
 * Notes:       This module contains local APIs for
 *              - Processes
 *              - NVM
 *              - Video memory mapping
 *              - PCI bus
 *              - IRQ
 ***************************************************************************/
#ifndef OS_PRIVATE_H_
#define OS_PRIVATE_H_

/*==========================
 * OS include
 *=========================*/
#include "dsthalcommon.h"
#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/sem.h>
#include <sys/mman.h>
#include <sys/signal.h>
#include <sys/wait.h>
#include <sys/shm.h>
#include <sys/msg.h>
#include <sys/ioctl.h>
#include <fcntl.h>
#include <stdlib.h>
#include <unistd.h>
#include <errno.h>
#include <stdlib.h>
#include <sys/time.h>
#include <sys/resource.h>
#include <pthread.h>
#include <sched.h> 

#define INVALID_KHANDLE     -1

#define DEBUG_OS                        1

/*==========================
 * Shared prototypes
 *=========================*/
DS_S32   Os_KmodGetHandle (DS_U32 ChipIndex);
void    Os_KmodReleaseHandle (DS_S32 Handle);
DS_U32  Os_PerformIoctl (DS_U32 Func, void *RetBuf);
key_t   Os_GetNameValue (DS_S8 *Name, DS_S8 NumVal);

#if !DEBUG_OS
        #define INFO_MSG(...)
        #define DBG_MSG(...)
#else
        #define INFO_MSG        printf
        #define DBG_MSG         printf
#endif


/*==========================
 * TASK Control Block
 *=========================*/
typedef enum tag_DS_TASK_STATUS
{
    DS_TSTAT_READY   = 0x0000,
    DS_TSTAT_PEND    = 0x0001,
    DS_TSTAT_DELAY   = 0x0002,
    DS_TSTAT_SUSPEND = 0x0004,
    DS_TSTAT_TIMEOUT = 0x0008,
    DS_TSTAT_INH_PRI = 0x0010,
    DS_TSTAT_DEAD    = 0x0080,
    DS_TSTAT_RDY_MSK = 0x008f
} DS_TASK_STATUS;
    
typedef struct tag_DS_TASK_T
{
        DS_U32    taskId;                       // task id (from pthread)
        int       pid;              // Process ID (from kernel)
        
        DS_U8     priority;                     // task priority
        DS_U8     status;                       // task status
        DS_U32    stacksize;            // task stack size
        char      name[256];            // task name max is 10 char!

        void      (*funcPtr)(DS_U32);
    DS_U32    arg;

        // First task control block in list of tasks waiting on this task (for deletion purposes)
        struct tag_DS_TASK_T *first_susp;
        
        // Next task control block in list of tasks waiting on object
        struct tag_DS_TASK_T *nxt_susp; 

        // Next task control block in list
        struct tag_DS_TASK_T *nxt_task;

        // the task waits this objects:
        DS_U32    *waiting; 
} DS_TASK_T;                                    // Task Debug DB


void link_susp_task(DS_TASK_T ** list_head, DS_TASK_T * new_entry);
void unlink_susp_task(DS_TASK_T **list_head, DS_TASK_T * entry);
int signal_for_my_task(DS_TASK_T **list_head, int pend_order);

DS_TASK_T *taskFind(DS_U32 taskId, int lock);

#endif  /* OS_PRIVATE_H_   */