AM64x MCU+ SDK  08.02.00
EventP.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2018-2021 Texas Instruments Incorporated
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  *
11  * Redistributions in binary form must reproduce the above copyright
12  * notice, this list of conditions and the following disclaimer in the
13  * documentation and/or other materials provided with the
14  * distribution.
15  *
16  * Neither the name of Texas Instruments Incorporated nor the names of
17  * its contributors may be used to endorse or promote products derived
18  * from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 #ifndef EVENTP_H
34 #define EVENTP_H
35 
36 #ifdef __cplusplus
37 extern "C" {
38 #endif
39 
40 #include <stdint.h>
41 #include <kernel/dpl/SystemP.h>
42 
55 #define EventP_OBJECT_SIZE_MAX (60u)
56 
59 typedef struct EventP_Object_
60 {
61  /* uintptr_t translates to uint64_t for A53 and uint32_t for R5 and M4 */
62  /* This accounts for the 64bit pointer in A53 and 32bit pointer in R5 and M4 */
63  uintptr_t rsv[EventP_OBJECT_SIZE_MAX/sizeof(uint32_t)];
65 
74 
81 
120  uint32_t bitsToWaitFor,
121  uint8_t clearOnExit,
122  uint8_t waitForAll,
123  uint32_t timeToWaitInTicks,
124  uint32_t *eventBits);
125 
137 int32_t EventP_setBits(EventP_Object *obj, uint32_t bitsToSet);
138 
149 int32_t EventP_clearBits(EventP_Object *obj, uint32_t bitsToClear);
150 
165 int32_t EventP_getBits(EventP_Object *obj, uint32_t *eventBits);
166 
169 #ifdef __cplusplus
170 }
171 #endif
172 
173 #endif /* EVENTP_H */
EventP_clearBits
int32_t EventP_clearBits(EventP_Object *obj, uint32_t bitsToClear)
Clear a bit or multiple bits in the Event bits.
EventP_waitBits
int32_t EventP_waitBits(EventP_Object *obj, uint32_t bitsToWaitFor, uint8_t clearOnExit, uint8_t waitForAll, uint32_t timeToWaitInTicks, uint32_t *eventBits)
Read the Event bits, after optionally waiting for a bit or multiple bits to be set.
SystemP.h
EventP_getBits
int32_t EventP_getBits(EventP_Object *obj, uint32_t *eventBits)
Getting the current value of Event bits.
EventP_Object
Opaque Event object used with the Event APIs.
Definition: EventP.h:60
EventP_construct
int32_t EventP_construct(EventP_Object *obj)
Create an Event object.
EventP_setBits
int32_t EventP_setBits(EventP_Object *obj, uint32_t bitsToSet)
Setting a bit or multiple bits in the Event bits.
EventP_destruct
void EventP_destruct(EventP_Object *obj)
Cleanup, delete, destruct an Event object.
EventP_OBJECT_SIZE_MAX
#define EventP_OBJECT_SIZE_MAX
Max size of Event object across no-RTOS and all OS's.
Definition: EventP.h:55