32 #include "hal_assert.h" 44 #define ICALL_SERVICE_CLASS_MASK 0xFFF8 52 #define ICALL_SERVICE_INSTANCE_MASK 0x0007 60 #define ICALL_SERVICE_CLASS_PRIMITIVE 0x0008 65 #define ICALL_SERVICE_CLASS_BLE 0x0010 68 #define ICALL_SERVICE_CLASS_TIMAC 0x0018 71 #define ICALL_SERVICE_CLASS_REMOTI_RTI 0x0020 74 #define ICALL_SERVICE_CLASS_REMOTI_RCN 0x0028 77 #define ICALL_SERVICE_CLASS_ZSTACK 0x0030 80 #define ICALL_SERVICE_CLASS_NPI 0x0038 83 #define ICALL_SERVICE_CLASS_BLE_MSG 0x0050 93 #define ICALL_SERVICE_CLASS_CRYPTO 0x0080 100 #define ICALL_SERVICE_CLASS_BLE_BOARD 0x0088 107 #define ICALL_SERVICE_CLASS_TIMAC_BOARD 0x0090 114 #define ICALL_SERVICE_CLASS_RADIO 0x0098 121 #define ICALL_SERVICE_CLASS_DUMMY 0x0100 129 #define ICALL_SERVICE_CLASS_DUMMY_BOARD 0x0200 134 #define ICALL_INVALID_ENTITY_ID 0xffu 139 #define ICALL_INVALID_TIMER_ID NULL 149 #define ICALL_UNDEF_DEST_ID 0xffu 153 #define ICALL_ERRNO_SUCCESS 0 156 #define ICALL_ERRNO_TIMEOUT 1 159 #define ICALL_ERRNO_NOMSG 2 166 #define ICALL_ERRNO_INVALID_SERVICE -1 172 #define ICALL_ERRNO_INVALID_FUNCTION -2 175 #define ICALL_ERRNO_INVALID_PARAMETER -3 178 #define ICALL_ERRNO_NO_RESOURCE -4 185 #define ICALL_ERRNO_UNKNOWN_THREAD -5 188 #define ICALL_ERRNO_CORRUPT_MSG -6 191 #define ICALL_ERRNO_OVERFLOW -7 194 #define ICALL_ERRNO_UNDERFLOW -8 197 #define ICALL_MSG_FORMAT_KEEP 0 203 #define ICALL_MSG_FORMAT_1ST_CHAR_TASK_ID 1 209 #define ICALL_MSG_FORMAT_3RD_CHAR_TASK_ID 2 215 #define ICALL_MSG_FORMAT_DIRECT_API_ID 3 220 #define ICALL_LITE_DIRECT_API_DONE_CMD_ID 0x42 227 #define ICALL_TIMEOUT_FOREVER 0xfffffffful 233 #ifndef ICALL_TIMEOUT_PREDEFINE 234 #define ICALL_TIMEOUT_PREDEFINE 5000 240 #define ICALL_SEMAPHORE_MODE_COUNTING 0 245 #define ICALL_SEMAPHORE_MODE_BINARY 1 251 #define ICALL_PRIMITIVE_FUNC_ENROLL 0 254 #define ICALL_PRIMITIVE_FUNC_REGISTER_APP 1 257 #define ICALL_PRIMITIVE_FUNC_MSG_ALLOC 2 260 #define ICALL_PRIMITIVE_FUNC_MSG_FREE 3 263 #define ICALL_PRIMITIVE_FUNC_MALLOC 4 266 #define ICALL_PRIMITIVE_FUNC_FREE 5 269 #define ICALL_PRIMITIVE_FUNC_SEND_MSG 6 272 #define ICALL_PRIMITIVE_FUNC_FETCH_MSG 7 275 #define ICALL_PRIMITIVE_FUNC_SEND_SERV_MSG 8 278 #define ICALL_PRIMITIVE_FUNC_FETCH_SERV_MSG 9 281 #define ICALL_PRIMITIVE_FUNC_WAIT 10 284 #define ICALL_PRIMITIVE_FUNC_SIGNAL 11 287 #define ICALL_PRIMITIVE_FUNC_ABORT 12 290 #define ICALL_PRIMITIVE_FUNC_ENABLE_INT 13 293 #define ICALL_PRIMITIVE_FUNC_DISABLE_INT 14 296 #define ICALL_PRIMITIVE_FUNC_ENABLE_MINT 15 299 #define ICALL_PRIMITIVE_FUNC_DISABLE_MINT 16 302 #define ICALL_PRIMITIVE_FUNC_REGISTER_ISR 17 305 #define ICALL_PRIMITIVE_FUNC_GET_TICKS 18 308 #define ICALL_PRIMITIVE_FUNC_SET_TIMER_MSECS 19 311 #define ICALL_PRIMITIVE_FUNC_GET_TICK_PERIOD 20 314 #define ICALL_PRIMITIVE_FUNC_GET_MAX_MILLISECONDS 21 317 #define ICALL_PRIMITIVE_FUNC_ENTITY2SERVICE 22 320 #define ICALL_PRIMITIVE_FUNC_PWR_UPD_ACTIVITY_COUNTER 23 323 #define ICALL_PRIMITIVE_FUNC_PWR_REGISTER_NOTIFY 24 326 #define ICALL_PRIMITIVE_FUNC_WAIT_MATCH 25 329 #define ICALL_PRIMITIVE_FUNC_GET_ENTITY_ID 26 332 #define ICALL_PRIMITIVE_FUNC_SET_TIMER 27 335 #define ICALL_PRIMITIVE_FUNC_STOP_TIMER 28 341 #define ICALL_PRIMITIVE_FUNC_PWR_CONFIG_AC_ACTION 29 344 #define ICALL_PRIMITIVE_FUNC_PWR_REQUIRE 30 347 #define ICALL_PRIMITIVE_FUNC_PWR_DISPENSE 31 350 #define ICALL_PRIMITIVE_FUNC_THREAD_SERVES 32 353 #define ICALL_PRIMITIVE_FUNC_PWR_IS_STABLE_XOSC_HF 33 356 #define ICALL_PRIMITIVE_FUNC_PWR_GET_TRANSITION_STATE 34 359 #define ICALL_PRIMITIVE_FUNC_CREATE_TASK 35 362 #define ICALL_PRIMITIVE_FUNC_CREATE_SEMAPHORE 36 365 #define ICALL_PRIMITIVE_FUNC_WAIT_SEMAPHORE 37 368 #define ICALL_PRIMITIVE_FUNC_SWITCH_XOSC_HF 38 371 #define ICALL_PRIMITIVE_FUNC_PWR_GET_XOSC_STARTUP_TIME 39 374 #define ICALL_PRIMITIVE_FUNC_REGISTER_ISR_EXT 40 378 #define ICALL_PRIMITIVE_FUNC_POST_SEMAPHORE 41 381 #define ICALL_PRIMITIVE_FUNC_CREATE_EVENT 42 384 #define ICALL_PRIMITIVE_FUNC_WAIT_EVENT 43 387 #define ICALL_PRIMITIVE_FUNC_POST_EVENT 44 395 #define ICALL_MSG_FUNC_GET_LOCAL_MSG_ENTITY_ID 0 404 #define ICALL_MSG_EVENT_ID Event_Id_31 411 #define ICALL_WAITMATCH_EVENT_ID Event_Id_29 455 uint32_t totalFreeSize;
456 uint32_t largestFreeSize;
579 void (*isrfunc)(void);
587 void (*isrfunc)(void);
666 void (*entryfn)(
size_t arg);
672 #ifdef ICALL_RTOS_SEMAPHORE_API 703 #ifdef ICALL_RTOS_EVENTS_API 705 typedef struct _icall_create_event_args_t
709 } ICall_CreateEventArgs;
712 typedef struct _icall_post_event_args_t
717 } ICall_PostEventArgs;
720 typedef struct _icall_wait_event_args_t
724 uint_least32_t milliseconds;
725 } ICall_WaitEventArgs;
735 typedef struct _icall_msg_hdr_t
933 PACKED_TYPEDEF_STRUCT
935 uint_least32_t *pointerStack;
936 icall_lite_id_t directAPI;
937 } icall_directAPIMsg_t;
939 PACKED_TYPEDEF_STRUCT
942 icall_directAPIMsg_t msg;
950 uint_least32_t imgTaskPriority;
951 uint_least32_t imgTaskStackSize;
952 void *ICall_imgInitParam;
953 } ICall_RemoteTask_t;
1071 ICall_EntityID dest,
1072 ICall_MSGFormat format,
1091 ICall_Errno
ICall_registerApp(ICall_EntityID *entity, ICall_SyncHandle *msgSyncHdl);
1153 ICall_ServiceEnum dest,
1154 ICall_MSGFormat format,
void *msg);
1186 ICall_EntityID *dest,
1202 ICall_Errno
ICall_wait(uint_fast32_t milliseconds);
1228 ICall_EntityID *entity,
1229 ICall_SyncHandle *msgSyncHdl);
1273 ICall_EntityID dest,
1274 ICall_MSGFormat format,
1297 ICall_EntityID *dest,
1320 ICall_ServiceEnum *servId);
1323 #ifdef HEAPMGR_METRICS 1624 uint_fast16_t stacksize,
size_t arg);
1626 #ifdef ICALL_RTOS_SEMAPHORE_API 1641 #ifdef ICALL_RTOS_SEMAPHORE_API 1653 #ifdef ICALL_RTOS_EVENTS_API 1661 ICall_createEvent(
void);
1670 ICall_postEvent(ICall_Event event, uint32_t events);
1685 ICall_waitEvent(ICall_Event event, uint_fast32_t milliseconds);
1688 #ifdef ICALL_RTOS_SEMAPHORE_API 1735 ICall_ServiceEnum *src,
1736 ICall_EntityID *dest,
1794 ICall_SyncHandle *msgSyncHdl)
1799 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_REGISTER_APP;
1819 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_MSG_ALLOC;
1838 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_MSG_FREE;
1885 ICall_ServiceEnum dest,
1886 ICall_MSGFormat format,
void *msg)
1890 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_SEND_SERV_MSG;
1928 ICall_EntityID *dest,
1934 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_FETCH_SERV_MSG;
1955 static ICall_Errno
ICall_wait(uint_fast32_t milliseconds)
1959 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_WAIT;
1969 static ICall_Errno
ICall_signal(ICall_SyncHandle msgSyncHdl)
1973 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_SIGNAL;
1997 ICall_EntityID *entity,
1998 ICall_SyncHandle *msgSyncHdl)
2003 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_ENROLL;
2025 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_MALLOC;
2044 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_FREE;
2063 static ICall_Errno
ICall_send(ICall_EntityID src,
2064 ICall_EntityID dest,
2065 ICall_MSGFormat format,
2070 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_SEND_MSG;
2098 ICall_EntityID *dest,
2104 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_FETCH_MSG;
2133 ICall_ServiceEnum *servId)
2138 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_ENTITY2SERVICE;
2156 HAL_ASSERT( HAL_ASSERT_CAUSE_ICALL_ABORT );
2160 args.
func = ICALL_PRIMITIVE_FUNC_ABORT;
2174 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_ENABLE_INT;
2189 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_DISABLE_INT;
2203 args.
func = ICALL_PRIMITIVE_FUNC_ENABLE_MINT;
2216 args.
func = ICALL_PRIMITIVE_FUNC_DISABLE_MINT;
2233 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_REGISTER_ISR;
2244 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_REGISTER_ISR_EXT;
2255 static uint_fast32_t
2260 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_GET_TICKS;
2269 static uint_fast32_t
2274 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_GET_TICK_PERIOD;
2285 static uint_fast32_t
2290 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_GET_MAX_MILLISECONDS;
2328 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_SET_TIMER_MSECS;
2371 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_SET_TIMER;
2392 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_STOP_TIMER;
2418 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_PWR_UPD_ACTIVITY_COUNTER;
2446 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_PWR_CONFIG_AC_ACTION;
2467 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_PWR_REQUIRE;
2488 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_PWR_DISPENSE;
2506 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_PWR_IS_STABLE_XOSC_HF;
2522 args.
func = ICALL_PRIMITIVE_FUNC_SWITCH_XOSC_HF;
2536 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_PWR_GET_XOSC_STARTUP_TIME;
2561 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_PWR_REGISTER_NOTIFY;
2580 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_PWR_GET_TRANSITION_STATE;
2603 uint_fast16_t stacksize,
size_t arg)
2608 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_CREATE_TASK;
2616 #ifdef ICALL_RTOS_SEMAPHORE_API 2627 static ICall_Semaphore
2634 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_CREATE_SEMAPHORE;
2646 #ifdef ICALL_RTOS_SEMAPHORE_API 2660 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_POST_SEMAPHORE;
2666 #ifdef ICALL_RTOS_EVENTS_API 2674 ICall_createEvent(
void)
2676 ICall_CreateEventArgs args;
2680 args.hdr.func = ICALL_PRIMITIVE_FUNC_CREATE_EVENT;
2697 ICall_postEvent(ICall_Event event, uint32_t events)
2699 ICall_PostEventArgs args;
2702 args.hdr.func = ICALL_PRIMITIVE_FUNC_POST_EVENT;
2704 args.events = events;
2721 ICall_waitEvent(ICall_Event event, uint_fast32_t milliseconds)
2723 ICall_WaitEventArgs args;
2726 args.hdr.func = ICALL_PRIMITIVE_FUNC_WAIT_EVENT;
2728 args.milliseconds = milliseconds;
2733 #ifdef ICALL_RTOS_SEMAPHORE_API 2753 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_WAIT_SEMAPHORE;
2789 ICall_ServiceEnum *src,
2790 ICall_EntityID *dest,
2796 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_WAIT_MATCH;
2822 static ICall_EntityID
2828 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_GET_ENTITY_ID;
2852 args.
hdr.
func = ICALL_PRIMITIVE_FUNC_THREAD_SERVES;
2895 #ifdef ICALL_NO_APP_EVENTS 2896 typedef uint8_t (*appCallback_t)(uint8_t event, uint8_t *msg);
2897 ICall_Errno ICall_registerAppCback(uint8_t *selfEntity, appCallback_t appCallback);
uint_fast8_t ICall_threadServes(ICall_ServiceEnum service)
Checks whether the calling thread provides the designated service.
ICall_FuncArgsHdr hdr
common arguments field to store source of the message
Definition: icall.h:524
ICall_Errno ICall_createTask(void(*entryfn)(size_t arg), uint_fast8_t priority, uint_fast16_t stacksize, size_t arg)
Creates a new RTOS task.
ICall_RemotiCmdEvent_t
RemoTI RNP and Remote Icall Messaging Interface Enumeration.
Definition: icall.h:914
ICall_Semaphore sem
semaphore
Definition: icall.h:691
void * ICall_Event
Event data type.
Definition: icall.h:443
uint32_t ICall_pwrGetXOSCStartupTime(uint_fast32_t timeUntilWakeupInMs)
uint_least32_t timeUntilWakeupInMs
field matching timeUntilWakeupInMs argument
Definition: icall.h:650
void * ICall_TimerID
Timer id data type.
Definition: icall.h:450
ICall_Errno ICall_enrollService(ICall_ServiceEnum service, ICall_ServiceFunc fn, ICall_EntityID *entity, ICall_SyncHandle *msgSyncHdl)
Registers a service entity.
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:806
void * ICall_SyncHandle
Synchronization object data type.
Definition: icall.h:433
uint_fast8_t ICall_PwrTransition
Power state transition type of the following values:
Definition: icall.h:755
ICall_Errno ICall_pwrDispense(ICall_PwrBitmap_t bitmap)
Releases power constraints and dependencies.
ICall_enrollService arguments
Definition: icall.h:878
bool incFlag
a boolean flag to indicate either increment or decrement
Definition: icall.h:616
ICall_MSGFormat format
Message format.
Definition: icall.h:517
uint_least8_t mode
semaphore mode. Either ICALL_SEMAPHORE_MODE_BINARY or ICALL_SEMAPHORE_MODE_COUNTING ...
Definition: icall.h:682
struct _icall_thread_serves_args_t ICall_ThreadServesArgs
ICall_threadServes argument
uint_least8_t localId
local entity ID
Definition: icall.h:910
struct _icall_send_args_t ICall_SendArgs
ICall_sendServiceMsg and ICall_send arguments
ICall_LeaveCS leavecs
leave CS
Definition: icall.h:853
ICall_CSState(* ICall_EnterCS)(void)
Critical section entry function pointer type.
Definition: icall.h:828
int intPriority
interrupt priority
Definition: icall.h:588
void(* ICall_TimerCback)(void *arg)
Prototype of a callback function for timer.
Definition: icall.h:475
int_fast16_t ICall_Errno
Error code data type.
Definition: icall.h:421
ICall_Errno ICall_wait(uint_fast32_t milliseconds)
Waits for a signal to the semaphore associated with the calling thread.
ICall_sendServiceMsg and ICall_send arguments
Definition: icall.h:508
void(* ICall_LeaveCS)(ICall_CSState key)
Critical section exit function pointer type.
Definition: icall.h:836
ICall_pwrRegisterNotify arguments
Definition: icall.h:785
ICall_Errno ICall_pwrRequire(ICall_PwrBitmap_t bitmap)
Sets power constraints and dependencies.
struct _icall_post_semaphore_args_t ICall_PostSemaphoreArgs
ICall_postSemaphore argument
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:649
uint_fast32_t ICall_getTickPeriod(void)
Gets the tick period.
uint_least16_t stacksize
task priority as understood by underlying RTOS implementation
Definition: icall.h:668
uint_least8_t priority
task priority as understood by underlying RTOS implementation
Definition: icall.h:667
ICall_Errno ICall_enableInt(int intnum)
Enables interrupt.
ICall_signal arguments
Definition: icall.h:549
uint_least32_t ICall_CSState
Critical section state data type.
Definition: icall.h:821
struct _icall_register_isr_args_t ICall_RegisterISRArgs
ICall_registerISR arguments
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:690
struct _icall_set_timer_args_t ICall_SetTimerArgs
ICall_setTimer arguments
bool(* ICall_MsgMatchFn)(ICall_ServiceEnum src, ICall_EntityID dest, const void *msg)
Prototype of a function used to compare a received message for a match.
Definition: icall.h:468
ICall_createTask argument
Definition: icall.h:663
ICall_ServiceEnum servId
service id
Definition: icall.h:798
Event for app RTI->stack RTI module.
Definition: icall.h:918
ICall_EntityID entityId
entity id
Definition: icall.h:528
ICall_signal arguments
Definition: icall.h:542
ICall Lite Command Status.
Definition: icall.h:928
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:631
ICall_stopTimer arguments
Definition: icall.h:898
struct _icall_getuint32_args_t ICall_GetUint32Args
ICall_getTicks , ICall_getTickPeriod and ICall_getMaxMSecs arguments
ICall_ServiceEnum servId
Service ID of destination.
Definition: icall.h:515
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:697
uint_fast32_t ICall_getMaxMSecs(void)
Gets the maximum timeout period supported by ICall_setTimerMSecs function.
struct _icall_wait_semaphore_args_t ICall_WaitSemaphoreArgs
ICall_waitSemaphore argument
uint_least32_t value
field to store the retrieved value
Definition: icall.h:598
ICall_ServiceFunc fn
handler function which handles function calls to the service
Definition: icall.h:882
uint_fast8_t ICall_pwrGetTransitionState(void)
Retrieves power transition state.
ICall_EntityID entity
client entity id
Definition: icall.h:807
ICall_FuncID func
function id
Definition: icall.h:481
struct _ICall_LiteCmdStatus_ ICall_LiteCmdStatus
ICall Lite Command Status.
#define ICALL_ERRNO_SUCCESS
ICall function return value for successful operation.
Definition: icall.h:153
ICall_SyncHandle msgSyncHdl
field to store the synchronous object handle associated with the calling thread
Definition: icall.h:489
ICall_PwrNotifyData * obj
data object
Definition: icall.h:789
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:562
void * msg
field to store the starting address of the message body
Definition: icall.h:800
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:665
Power state transition notify function data object type.
Definition: icall.h:775
bool pwrRequired
the result of current activity counter
Definition: icall.h:617
uint_least8_t ICall_MSGFormat
Message conversion format data type.
Definition: icall.h:427
union _icall_send_args_t::@0 dest
union of entity and service ID's
ICall_Errno ICall_registerISR(int intnum, void(*isrfunc)(void))
Registers an interrupt service routine.
uint_least16_t ICall_FuncID
Function id data type.
Definition: icall.h:430
ICall_FuncArgsHdr hdr
Common arguments.
Definition: icall.h:907
struct _icall_pwr_get_transition_state_args_t ICall_PwrGetTransitionStateArgs
ICall_pwrGetTransitionState arguments
struct _icall_pwr_bitmap_args_t ICall_PwrBitmapArgs
ICall_pwrConfigActivityCounterAction , ICall_pwrRequire and ICall_pwrDispense arguments.
ICall_pwrGetTransitionState arguments
Definition: icall.h:638
struct _icall_intnum_args_t ICall_IntNumArgs
ICall_enableInt and ICall_disableInt arguments
ICall_EnterCS entercs
enter CS
Definition: icall.h:852
ICall_pwrIsStableXOSCHF arguments
Definition: icall.h:604
ICall_freeMsg or ICall_free arguments
Definition: icall.h:501
ICall_postSemaphore argument
Definition: icall.h:688
ICall_Errno ICall_pwrConfigACAction(ICall_PwrBitmap_t bitmap)
Configures power constraint/dependency set/release actions upon activity counter change.
ICall_enableInt and ICall_disableInt arguments
Definition: icall.h:568
ICall_Semaphore ICall_createSemaphore(uint_fast8_t mode, int initcount)
Creates a semaphore.
void * ptr
pointer to the address of a memory block to free
Definition: icall.h:504
ICall_threadServes argument
Definition: icall.h:655
struct _icall_register_isr_args_ext_t ICall_RegisterISRArgs_Ext
ICall_registerISR_Ext arguments.
void ICall_freeMsg(void *msg)
Frees the memory block allocated for a message.
Common service function arguments.
Definition: icall.h:478
ICall_EntityID entityId
Entity ID of destination.
Definition: icall.h:514
ICall_Dispatcher dispatch
ICall dispatcher.
Definition: icall.h:851
ICall_fetchServiceMsg and ICall_fetchMsg arguments
Definition: icall.h:522
bool value
Definition: icall.h:609
ICall_EntityID entity
entity id
Definition: icall.h:909
void ICall_createRemoteTasksAtRuntime(ICall_RemoteTask_t *remoteTaskTable, uint8_t nb_elems)
Create remote tasks with parameters define at runtime.
struct _icall_register_app_args_t ICall_RegisterAppArgs
ICall_registerApp arguments
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:900
struct _icall_remote_task_arg_t ICall_RemoteTaskArg
Data type of the first argument passed to the entry point of an image which contains a remote task...
void ICall_free(void *msg)
Frees an allocated memory block.
size_t arg
argument passed to the task entry function
Definition: icall.h:669
ICall_registerISR_Ext arguments.
Definition: icall.h:583
struct _icall_wait_match_args_t ICall_WaitMatchArgs
ICall_waitMatch arguments
void * ICall_allocMsg(size_t size)
Allocates memory block for a message.
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:577
size_t size
size of the message body in bytes
Definition: icall.h:496
struct _icall_create_task_args_t ICall_CreateTaskArgs
ICall_createTask argument
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:503
ICall_SyncHandle msgSyncHdl
field to store the synchronous object handle associated with the calling thread
Definition: icall.h:884
ICall_Errno ICall_waitSemaphore(ICall_Semaphore sem, uint_fast32_t milliseconds)
Waits on a semaphore.
ICall_EntityID entity
field to store the entity id assigned to the application
Definition: icall.h:488
struct _icall_enroll_service_args_t ICall_EnrollServiceArgs
ICall_enrollService arguments
#define ICALL_MSG_FUNC_GET_LOCAL_MSG_ENTITY_ID
Messaging service function id for translating ICall_entityID to locally understandable id...
Definition: icall.h:395
ICall_Errno ICall_disableInt(int intnum)
Disables interrupt.
struct _icall_alloc_args_t ICall_AllocArgs
ICall_allocMsg or ICall_malloc arguments
Data type of the first argument passed to the entry point of an image which contains a remote task...
Definition: icall.h:849
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:640
ICall_Errno ICall_signal(ICall_SyncHandle msgSyncHdl)
Signals a semaphore.
void * msg
pointer to the message body to send
Definition: icall.h:518
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:615
ICall_ServiceEnum servId
Service ID of destination.
Definition: icall.h:658
ICall_Errno ICall_entityId2ServiceId(ICall_EntityID entityId, ICall_ServiceEnum *servId)
Transforms and entityId into a serviceId. Note that this function is useful in case an application wa...
struct _icall_get_local_msg_entity_id_args_t ICall_GetLocalMsgEntityIdArgs
ICall_getLocalMsgEntityId arguments
void * ICall_malloc(uint_least16_t size)
Allocates a memory block.
struct _icall_func_args_hdr_t ICall_FuncArgsHdr
Common service function arguments.
ICall_Errno ICall_disableMInt(void)
Disables master interrupt and context switching.
ICall_SyncHandle syncHandle
handle of a synchronous object to signal
Definition: icall.h:545
struct _icall_pwr_get_xosc_startup_time_args_t ICall_PwrGetXOSCStartupTimeArgs
ICall_pwrGetXOSCStartupTime arguments
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:795
void * ptr
pointer to store the start address of the newly allocated memory block
Definition: icall.h:497
ICall_LeaveCS ICall_leaveCriticalSection
Leave critical section function pointer of the current image.
ICall_Errno ICall_abort(void)
Aborts.
void(* ICall_PwrNotifyFn)(ICall_PwrTransition pwrTrans, struct _icall_pwr_notify_data_t *obj)
Definition: icall.h:769
#define ICALL_INVALID_ENTITY_ID
Entity ID used to indicate invalid entity.
Definition: icall.h:134
ICall_EntityID dest
field to store the entity id of the destination of the message
Definition: icall.h:530
ICall_getTicks , ICall_getTickPeriod and ICall_getMaxMSecs arguments
Definition: icall.h:595
ICall_Errno(* ICall_ServiceFunc)(ICall_FuncArgsHdr *args)
Call dispatcher service handler function pointer type.
Definition: icall.h:875
ICall_EntityID ICall_searchServiceEntity(ICall_ServiceEnum service)
Search for a service entity entry.
ICall_Errno ICall_sendServiceMsg(ICall_EntityID src, ICall_ServiceEnum dest, ICall_MSGFormat format, void *msg)
Sends a message to a registered server.
struct _icall_free_args_t ICall_FreeArgs
ICall_freeMsg or ICall_free arguments
ICall_SyncHandle syncHandle
handle of a synchronous object to signal
Definition: icall.h:552
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:495
struct _icall_entity2service_args_t ICall_EntityId2ServiceIdArgs
ICall_entityId2ServiceId arguments
ICall_pwrConfigActivityCounterAction , ICall_pwrRequire and ICall_pwrDispense arguments.
Definition: icall.h:629
uint_fast32_t ICall_PwrBitmap_t
Power control bitmap type.
Definition: icall.h:623
ICall_PwrNotifyFn _private
a field for private use. Do not access the field. User data should follow this field.
Definition: icall.h:781
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:597
uint32_t events
events
Definition: icall.h:553
ICall_ServiceEnum service
service id
Definition: icall.h:480
ICall_ServiceEnum servId
field to store the service id
Definition: icall.h:564
ICall_Errno ICall_send(ICall_EntityID src, ICall_EntityID dest, ICall_MSGFormat format, void *msg)
Sends a message to an entity.
ICall_entityId2ServiceId arguments
Definition: icall.h:560
#define ICALL_SERVICE_CLASS_PRIMITIVE
Service class enumerated value for primitive service.
Definition: icall.h:60
void * msg
field to store the starting address of the message body
Definition: icall.h:531
ICall_Errno ICall_postSemaphore(ICall_Semaphore sem)
Post on a semaphore.
uint_least32_t milliseconds
timeout period in milliseconds
Definition: icall.h:796
ICall_Errno(* ICall_Dispatcher)(ICall_FuncArgsHdr *args)
Call dispatcher function pointer type.
Definition: icall.h:816
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:487
struct _icall_get_entity_id_args_t ICall_GetEntityIdArgs
ICall_getEntityId arguments
Event for app RTI->stack RC App.
Definition: icall.h:916
void(* isrfunc)(void)
pointer to the interrupt service function
Definition: icall.h:579
uint_fast8_t state
power transition state
Definition: icall.h:641
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:657
uint_fast8_t ICall_getLocalMsgEntityId(ICall_ServiceEnum service, ICall_EntityID entity)
Retrieves an internal ID understood only by a service entity, corresponding to an ICall entity ID...
void ICall_stopTimer(ICall_TimerID id)
Stops a timer.
struct _icall_getbool_args_t ICall_GetBoolArgs
ICall_pwrIsStableXOSCHF arguments
int initcount
semaphore initial count value
Definition: icall.h:683
struct _icall_pwr_notify_data_t ICall_PwrNotifyData
Power state transition notify function data object type.
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:551
struct _icall_stop_timer_args_t ICall_StopTimerArgs
ICall_stopTimer arguments
ICall_getEntityId arguments
Definition: icall.h:804
ICall_allocMsg or ICall_malloc arguments
Definition: icall.h:493
ICall_Errno ICall_registerISR_Ext(int intnum, void(*isrfunc)(void), int intPriority)
ICall Register ISR.
ICall_Errno ICall_pwrSwitchXOSCHF(void)
Switch clock source to HF XOSC. This function must be called after HF XOSC is stable.
ICall_waitMatch arguments
Definition: icall.h:793
ICall_EnterCS ICall_enterCriticalSection
Enter critical section function pointer of the current image.
bool ICall_pwrIsStableXOSCHF(void)
Checks whether HF XOSC is stable. This function must be called after HF XOSC is turned on (through po...
ICall_EntityID dest
field to store the entity id of the destination of the message
Definition: icall.h:799
int_least32_t intnum
interrupt number
Definition: icall.h:586
struct _icall_signal_args_t ICall_SignalArgs
ICall_signal arguments
ICall_Errno ICall_pwrRegisterNotify(ICall_PwrNotifyFn fn, ICall_PwrNotifyData *obj)
Registers a power state transition notify function.
ICall_Errno ICall_setTimerMSecs(uint_fast32_t msecs, ICall_TimerCback cback, void *arg, ICall_TimerID *id)
Set up or restart a timer. Note that the timer setup initially by this function may be restarted usin...
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:880
uint_least32_t value
field to store the retrieved value
Definition: icall.h:651
ICall_wait arguments
Definition: icall.h:535
ICall_Errno ICall_sendServiceComplete(ICall_EntityID src, ICall_EntityID dest, ICall_MSGFormat format, void *msg)
function to indicate that servicing an direct API call is done
void ICall_createRemoteTasks(void)
Create remote tasks.
struct _icall_wait_args_t ICall_WaitArgs
ICall_wait arguments
ICall_TimerID timerid
timer ID
Definition: icall.h:892
void * arg
pointer to an argument to be passed to the callback function
Definition: icall.h:894
SYNC message from RNP app -> stack.
Definition: icall.h:921
ICall_ServiceEnum service
service id
Definition: icall.h:908
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:510
ICall_waitSemaphore argument
Definition: icall.h:695
ICall_Errno ICall_setTimer(uint32_t ticks, ICall_TimerCback cback, void *arg, ICall_TimerID *id)
Set up or restart a timer. Note that the timer setup initially by this function may be restarted usin...
int_least32_t intnum
interrupt number
Definition: icall.h:571
struct _icall_pwr_upd_activity_counter_args_t ICall_PwrUpdActivityCounterArgs
ICall_pwrUpdActivityCounter arguments
uint_least32_t milliseconds
timeout in milliseconds
Definition: icall.h:699
Event for stack RTI->app RTI module.
Definition: icall.h:919
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:787
uint_least8_t cmdId
command id (applicable only to User Profile subgrp)
Definition: icall.h:930
ICall_TaskHandle ICall_getRemoteTaskHandle(uint8 index)
return the task handle of a task.
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:676
ICall_registerISR arguments
Definition: icall.h:575
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:570
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:537
ICall_EntityID entityId
entity id
Definition: icall.h:563
void * ICall_TaskHandle
Synchronization object data type.
Definition: icall.h:436
void * ICall_Semaphore
Semaphore used for ICall.
Definition: icall.h:439
uint_least32_t icall_lite_id_t
ICall Lite ID.
Definition: icall.h:925
void(* entryfn)(size_t arg)
task entry function
Definition: icall.h:666
uint_least32_t milliseconds
timeout period in milliseconds
Definition: icall.h:538
ICall_EntityID entity
field to store the assigned entity id
Definition: icall.h:883
ICall_MsgMatchFn matchFn
match function
Definition: icall.h:797
ICall_TimerCback cback
callback function
Definition: icall.h:893
void(* isrfunc)(void)
pointer to ISR
Definition: icall.h:587
struct _icall_create_semaphore_args_t ICall_CreateSemaphoreArgs
ICall_createSemaphore argument
ICall_registerApp arguments
Definition: icall.h:485
Event for stack->app RC App.
Definition: icall.h:917
ICall_FuncArgsHdr hdr
Definition: icall.h:607
ICall_pwrUpdActivityCounter arguments
Definition: icall.h:613
ICall_Semaphore sem
semaphore
Definition: icall.h:698
uint_fast32_t ICall_getTicks(void)
Gets the current tick counter value.
void ICall_init(void)
Initializes the dispatcher implementation.
void * ICall_mallocLimited(uint_least16_t size)
ICall_getLocalMsgEntityId arguments
Definition: icall.h:905
void ICall_getHeapMgrGetMetrics(uint32_t *pBlkMax, uint32_t *pBlkCnt, uint32_t *pBlkFree, uint32_t *pMemAlo, uint32_t *pMemMax, uint32_t *pMemUB)
the function retrieve information about the osal heap. Note :ICall_getHeapMgrGetMetrics will not work...
ICall_ServiceEnum servId
service id
Definition: icall.h:527
ICall_createSemaphore argument
Definition: icall.h:674
struct _icall_pwr_register_notify_args_t ICall_PwrRegisterNotifyArgs
ICall_pwrRegisterNotify arguments
uint_least8_t ICall_resetReason
Special global variable to set the reset reason by the boot code, before ICall is initialized...
ICall_pwrGetXOSCStartupTime arguments
Definition: icall.h:647
uint_least8_t ICall_EntityID
Entity id data type.
Definition: icall.h:447
int_least32_t intnum
interrupt number
Definition: icall.h:578
ASYNC message from RNP app->stack.
Definition: icall.h:920
ICall_Dispatcher ICall_dispatcher
Call dispatcher pointer of the current image.
ICall_EntityID src
Entity id of the sender of the message Destination id.
Definition: icall.h:511
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:585
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:544
struct _icall_fetch_msg_args_t ICall_FetchMsgArgs
ICall_fetchServiceMsg and ICall_fetchMsg arguments
ICall_PwrNotifyFn fn
notify function to handle notification
Definition: icall.h:788
ICall_Errno ICall_fetchMsg(ICall_EntityID *src, ICall_EntityID *dest, void **msg)
Retrieves a message, queued to receive queue of the calling thread.
ICall_setTimer arguments
Definition: icall.h:888
ICall_Errno ICall_fetchServiceMsg(ICall_ServiceEnum *src, ICall_EntityID *dest, void **msg)
Retrieves a message received at the message queue associated with the calling thread.
uint_least32_t timeout
timeout period
Definition: icall.h:891
ICall_ServiceEnum service
service id of the enrolling service
Definition: icall.h:881
ICall_Errno ICall_enableMInt(void)
Enables master interrupt and context switching.
void(* ICall_RemoteTaskEntry)(const ICall_RemoteTaskArg *arg0, void *arg1)
Service entry function prototype.
Definition: icall.h:866
uint_fast8_t result
Result (true or false)
Definition: icall.h:659
ICall_TimerID timerid
timer ID
Definition: icall.h:901
uint_least16_t ICall_ServiceEnum
Service enumeration data type.
Definition: icall.h:424
ICall_Semaphore sem
created semaphore
Definition: icall.h:684
void ICall_getHeapStats(ICall_heapStats_t *stats)
Get Statistic on Heap.
ICall_Errno ICall_waitMatch(uint_least32_t milliseconds, ICall_MsgMatchFn matchFn, ICall_ServiceEnum *src, ICall_EntityID *dest, void **msg)
Waits for and retrieves a message received at the message queue associated with the calling thread...
struct _icall_signal_events_args_t ICall_SignalEventsArgs
ICall_signal arguments
uint32_t icall_directAPI(uint8_t service, icall_lite_id_t id,...)
generic variadic function to translate API id to a functional call in the stack context,
union _icall_fetch_msg_args_t::@1 src
union of service and entity id's
ICall_EntityID ICall_getEntityId(void)
Retrieves an entity ID of (arbitrary) one of the entities registered from the calling thread...
ICall_FuncArgsHdr hdr
common arguments
Definition: icall.h:890
bool ICall_pwrUpdActivityCounter(bool incFlag)
Increments or decrements power activity counter.
ICall_Errno ICall_registerApp(ICall_EntityID *entity, ICall_SyncHandle *msgSyncHdl)
Registers an application.
ICall_PwrBitmap_t bitmap
power configuration bitmap
Definition: icall.h:632