FreeCalypso > hg > freecalypso-sw
annotate gsm-fw/g23m-aci/gdd_dio/gdd_sys.h @ 1023:cd6002e3aefb
doc/Freerunner-Howto: apparently some people still use SHR, so mention it too
| author | Mychaela Falconia <falcon@ivan.Harhan.ORG> | 
|---|---|
| date | Tue, 03 May 2016 13:48:39 +0000 | 
| parents | eedbf248bac0 | 
| children | 
| rev | line source | 
|---|---|
| 
775
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
1 /* | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
2 +----------------------------------------------------------------------------- | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
3 | Project : GSM-F&D (8411) | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
4 | Modul : gdd_sys.h | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
5 +----------------------------------------------------------------------------- | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
6 | Copyright 2005 Texas Instruments Berlin, AG | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
7 | All rights reserved. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
8 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
9 | This file is confidential and a trade secret of Texas | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
10 | Instruments Berlin, AG | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
11 | The receipt of or possession of this file does not convey | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
12 | any rights to reproduce or disclose its contents or to | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
13 | manufacture, use, or sell anything it may describe, in | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
14 | whole, or in part, without the specific written consent of | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
15 | Texas Instruments Berlin, AG. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
16 +----------------------------------------------------------------------------- | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
17 | Purpose : API for limited system functionality offered to application | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
18 | domain libraries. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
19 +----------------------------------------------------------------------------- | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
20 */ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
21 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
22 #ifndef GDD_SYS_H | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
23 #define GDD_SYS_H | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
24 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
25 /*==== DEFINITIONS ==========================================================*/ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
26 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
27 typedef int T_GDD_SEM; | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
28 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
29 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
30 /*==== DYNAMIC MEMORY FUNCTIONS =============================================*/ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
31 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
32 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
33 /* | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
34 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
35 | Function : gdd_sys_mem_malloc | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
36 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
37 | Description : Allocate memory. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
38 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
39 | Parameters : size - Size of memory required. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
40 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
41 | Return : Pointer to first byte of allocated memory. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
42 | 0 if allocation failed. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
43 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
44 */ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
45 void * gdd_sys_mem_malloc(int size); | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
46 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
47 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
48 /* | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
49 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
50 | Function : gdd_sys_mem_free | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
51 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
52 | Description : Release memory which was previously allocated. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
53 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
54 | Parameters : p - Pointer to memory to be deallocated | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
55 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
56 */ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
57 void gdd_sys_mem_free(void * p); | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
58 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
59 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
60 /*==== SEMAPHORE FUNCTIONS ==================================================*/ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
61 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
62 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
63 /* | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
64 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
65 | Function : gdd_sys_sem_open | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
66 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
67 | Description : Opens a (counting) semaphore specified by its name. If the | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
68 | semaphore does not exist, it will be created with the initial | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
69 | count given. If the semaphore already exists the parameter count | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
70 | will be ignored. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
71 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
72 | Parameters : name - Some name to identify the semaphore | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
73 | count - initial count (e.g. 1 for a binary sem.) | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
74 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
75 | Return : Returns handle to created semaphore, or -1 if an error occured. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
76 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
77 */ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
78 T_GDD_SEM gdd_sys_sem_open(char * name, unsigned short count); | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
79 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
80 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
81 /* | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
82 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
83 | Function : gdd_sys_sem_close | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
84 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
85 | Description : Closes a semaphore | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
86 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
87 | Parameters : sem - handle of semaphore | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
88 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
89 | Return : 0 = succees | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
90 | 1 = error | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
91 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
92 */ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
93 int gdd_sys_sem_close(T_GDD_SEM sem); | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
94 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
95 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
96 /* | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
97 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
98 | Function : gdd_sys_sem_down | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
99 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
100 | Description : This functions obtains the specified semaphore, i.e. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
101 | the counter is decremented, if it is greater than zero. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
102 | If the counter is equal to zero, than the calling task is | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
103 | suspended until the counter is incremented by another task. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
104 | If the caller is a non-task thread the function returns | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
105 | immediately regardless if the request can be satisfied or not. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
106 | In this case, -1 is returned if the counter was already zero. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
107 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
108 | Parameters : sem - handle of semaphore | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
109 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
110 | Return : 0 = succees | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
111 | 1 = error | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
112 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
113 */ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
114 int gdd_sys_sem_down(T_GDD_SEM sem); | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
115 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
116 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
117 /* | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
118 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
119 | Function : gdd_sys_sem_down | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
120 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
121 | Description : Releases a semaphore, i.e. counter is incremented. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
122 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
123 | Parameters : sem - handle of semaphore | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
124 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
125 | Return : 0 = succees | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
126 | 1 = error | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
127 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
128 */ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
129 int gdd_sys_sem_up(T_GDD_SEM sem); | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
130 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
131 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
132 /* | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
133 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
134 | Function : gdd_sys_sem_status | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
135 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
136 | Description : Query (obtain) the counter of a semaphore. | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
137 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
138 | Parameters : sem - handle of semaphore | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
139 | count - output variable to pass back the counter | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
140 | | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
141 | Return : 0 = succees | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
142 | 1 = error | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
143 +------------------------------------------------------------------------------ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
144 */ | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
145 int gdd_sys_sem_status(T_GDD_SEM sem, /*out*/ unsigned short * count); | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
146 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
147 | 
| 
 
eedbf248bac0
gsm-fw/g23m-aci subtree: initial import from LoCosto source
 
Michael Spacefalcon <msokolov@ivan.Harhan.ORG> 
parents:  
diff
changeset
 | 
148 #endif /* GDD_SYS_H */ | 
