FreeCalypso > hg > fc-magnetite
view src/g23m-aci/gdd_dio/gdd_sys.h @ 673:62a5285e014a
Lorekeeping: allow tpudrv-leonardo.lib on Leonardo/Tango
Back in 2015 the Mother's idea was to produce a FreeCalypso development
board that would be a clone of TI Leonardo, including the original
quadband RFFE; one major additional stipulation was that this board
needed to be able to run original unmodified TCS211-20070608 firmware
with all blobs intact, with only minimal binary patches to main.lib
and tpudrv.lib. The necessary patched libs were produced at that time
in the tcs211-patches repository.
That plan was changed and we produced FCDEV3B instead, with Openmoko's
triband RFFE instead of Leonardo quadband, but when FC Magnetite started
in 2016, a TPUDRV_blob= provision was still made, allowing the possibility
of patching OM's tpudrv.lib for a restored Leonardo RFFE.
Now in 2020 we have FC Tango which is essentially a verbatim clone of
Leonardo core, including the original quadband RFFE. We have also
deblobbed our firmware so much that we have absolutely no real need
for a blob version of tpudrv.lib - but I thought it would be neat to put
the ancient TPUDRV_blob= mechanism (classic config) to its originally
intended use, just for the heck of it.
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Fri, 29 May 2020 03:55:36 +0000 |
parents | 53929b40109c |
children |
line wrap: on
line source
/* +----------------------------------------------------------------------------- | Project : GSM-F&D (8411) | Modul : gdd_sys.h +----------------------------------------------------------------------------- | Copyright 2005 Texas Instruments Berlin, AG | All rights reserved. | | This file is confidential and a trade secret of Texas | Instruments Berlin, AG | The receipt of or possession of this file does not convey | any rights to reproduce or disclose its contents or to | manufacture, use, or sell anything it may describe, in | whole, or in part, without the specific written consent of | Texas Instruments Berlin, AG. +----------------------------------------------------------------------------- | Purpose : API for limited system functionality offered to application | domain libraries. +----------------------------------------------------------------------------- */ #ifndef GDD_SYS_H #define GDD_SYS_H /*==== DEFINITIONS ==========================================================*/ typedef int T_GDD_SEM; /*==== DYNAMIC MEMORY FUNCTIONS =============================================*/ /* +------------------------------------------------------------------------------ | Function : gdd_sys_mem_malloc +------------------------------------------------------------------------------ | Description : Allocate memory. | | Parameters : size - Size of memory required. | | Return : Pointer to first byte of allocated memory. | 0 if allocation failed. +------------------------------------------------------------------------------ */ void * gdd_sys_mem_malloc(int size); /* +------------------------------------------------------------------------------ | Function : gdd_sys_mem_free +------------------------------------------------------------------------------ | Description : Release memory which was previously allocated. | | Parameters : p - Pointer to memory to be deallocated +------------------------------------------------------------------------------ */ void gdd_sys_mem_free(void * p); /*==== SEMAPHORE FUNCTIONS ==================================================*/ /* +------------------------------------------------------------------------------ | Function : gdd_sys_sem_open +------------------------------------------------------------------------------ | Description : Opens a (counting) semaphore specified by its name. If the | semaphore does not exist, it will be created with the initial | count given. If the semaphore already exists the parameter count | will be ignored. | | Parameters : name - Some name to identify the semaphore | count - initial count (e.g. 1 for a binary sem.) | | Return : Returns handle to created semaphore, or -1 if an error occured. +------------------------------------------------------------------------------ */ T_GDD_SEM gdd_sys_sem_open(char * name, unsigned short count); /* +------------------------------------------------------------------------------ | Function : gdd_sys_sem_close +------------------------------------------------------------------------------ | Description : Closes a semaphore | | Parameters : sem - handle of semaphore | | Return : 0 = succees | 1 = error +------------------------------------------------------------------------------ */ int gdd_sys_sem_close(T_GDD_SEM sem); /* +------------------------------------------------------------------------------ | Function : gdd_sys_sem_down +------------------------------------------------------------------------------ | Description : This functions obtains the specified semaphore, i.e. | the counter is decremented, if it is greater than zero. | If the counter is equal to zero, than the calling task is | suspended until the counter is incremented by another task. | If the caller is a non-task thread the function returns | immediately regardless if the request can be satisfied or not. | In this case, -1 is returned if the counter was already zero. | | Parameters : sem - handle of semaphore | | Return : 0 = succees | 1 = error +------------------------------------------------------------------------------ */ int gdd_sys_sem_down(T_GDD_SEM sem); /* +------------------------------------------------------------------------------ | Function : gdd_sys_sem_down +------------------------------------------------------------------------------ | Description : Releases a semaphore, i.e. counter is incremented. | | Parameters : sem - handle of semaphore | | Return : 0 = succees | 1 = error +------------------------------------------------------------------------------ */ int gdd_sys_sem_up(T_GDD_SEM sem); /* +------------------------------------------------------------------------------ | Function : gdd_sys_sem_status +------------------------------------------------------------------------------ | Description : Query (obtain) the counter of a semaphore. | | Parameters : sem - handle of semaphore | count - output variable to pass back the counter | | Return : 0 = succees | 1 = error +------------------------------------------------------------------------------ */ int gdd_sys_sem_status(T_GDD_SEM sem, /*out*/ unsigned short * count); #endif /* GDD_SYS_H */