module ti.sysbios.family.arm.v7m.SysCall
index URL

System Call Manager

C synopsis target-domain sourced in ti/sysbios/family/arm/v7m/SysCall.xdc
#include <ti/sysbios/family/arm/v7m/SysCall.h>
Functions common to all ISysCall modules
macro Void 
SysCall_enterPrivMode// ();
macro Void 
SysCall_enterUnprivMode// ();
macro Void 
SysCall_restorePrivMode// ();
Functions common to all target modules
SysCall_Module_getMask// Returns the diagnostics mask for this module, SysCall_Module_hasMask// Test whether this module has a diagnostics mask, SysCall_Module_heap// The heap from which this module allocates memory, SysCall_Module_id// Get this module's unique id, SysCall_Module_setMask// Set the diagnostics mask for this module, SysCall_Module_startupDone// Test if this module has completed startup
Defines
#define
SysCall_NUM_SYSCALLS//  (UInt16)3
Typedefs
typedef Void 
(*SysCall_FuncPtr// Callback function type definition)(UArg);
Constants
extern const Error_Id 
SysCall_E_requestFailed// Error raised when a User Task attempts to switch privilege mode;
extern const SysCall_FuncPtr 
SysCall_requestFailedFunc// Callback function for when a system call request is denied. Default is set to an internal function that raises an error;
 
 
const SysCall_NUM_SYSCALLS
index URL
C synopsis target-domain
#define SysCall_NUM_SYSCALLS (UInt16)3
 
 
typedef SysCall_FuncPtr
index URL

Callback function type definition

C synopsis target-domain
typedef Void (*SysCall_FuncPtr)(UArg);
 
 
config SysCall_E_requestFailed  // module-wide
index URL

Error raised when a User Task attempts to switch privilege mode

C synopsis target-domain
extern const Error_Id SysCall_E_requestFailed;
 
DETAILS
This error is raised by the system call handler if the caller's PC does not fall within the kernel wrapper function section. This typically happens if a User Task attempts to directly invoke a system call to switch the CPU's privileged mode.
 
config SysCall_requestFailedFunc  // module-wide
index URL

Callback function for when a system call request is denied. Default is set to an internal function that raises an error

C synopsis target-domain
extern const SysCall_FuncPtr SysCall_requestFailedFunc;
 
DETAILS
If the validation check performed by the system call handler fails, the request is denied and this function is called.
 
SysCall_enterPrivMode()  // module-wide
index URL
C synopsis target-domain
macro Void SysCall_enterPrivMode();
 
 
SysCall_enterUnprivMode()  // module-wide
index URL
C synopsis target-domain
macro Void SysCall_enterUnprivMode();
 
 
SysCall_restorePrivMode()  // module-wide
index URL
C synopsis target-domain
macro Void SysCall_restorePrivMode();
 
Module-Wide Built-Ins
index URL

C synopsis target-domain
Types_ModuleId SysCall_Module_id();
// Get this module's unique id
 
Bool SysCall_Module_startupDone();
// Test if this module has completed startup
 
IHeap_Handle SysCall_Module_heap();
// The heap from which this module allocates memory
 
Bool SysCall_Module_hasMask();
// Test whether this module has a diagnostics mask
 
Bits16 SysCall_Module_getMask();
// Returns the diagnostics mask for this module
 
Void SysCall_Module_setMask(Bits16 mask);
// Set the diagnostics mask for this module
 
Configuration settings sourced in ti/sysbios/family/arm/v7m/SysCall.xdc
var SysCall = xdc.useModule('ti.sysbios.family.arm.v7m.SysCall');
module-wide constants & types
    const SysCall.NUM_SYSCALLS//  = 3;
module-wide config parameters
    SysCall.E_requestFailed// Error raised when a User Task attempts to switch privilege mode = Error.Desc {
        msg: "E_requestFailed: Request (Svc #%d) to switch CPU privilege denied."
    };
    SysCall.requestFailedFunc// Callback function for when a system call request is denied. Default is set to an internal function that raises an error = Void(*)(UArg) undefined;
 
    SysCall.common$// Common module configuration parameters = Types.Common$ undefined;
 
 
const SysCall.NUM_SYSCALLS
index URL
Configuration settings
const SysCall.NUM_SYSCALLS = 3;
 
C SYNOPSIS
SysCall_NUM_SYSCALLS
 
config SysCall.E_requestFailed  // module-wide
index URL

Error raised when a User Task attempts to switch privilege mode

Configuration settings
SysCall.E_requestFailed = Error.Desc {
    msg: "E_requestFailed: Request (Svc #%d) to switch CPU privilege denied."
};
 
DETAILS
This error is raised by the system call handler if the caller's PC does not fall within the kernel wrapper function section. This typically happens if a User Task attempts to directly invoke a system call to switch the CPU's privileged mode.
C SYNOPSIS
SysCall_E_requestFailed
 
config SysCall.requestFailedFunc  // module-wide
index URL

Callback function for when a system call request is denied. Default is set to an internal function that raises an error

Configuration settings
SysCall.requestFailedFunc = Void(*)(UArg) undefined;
 
DETAILS
If the validation check performed by the system call handler fails, the request is denied and this function is called.
C SYNOPSIS
SysCall_requestFailedFunc
 
metaonly config SysCall.common$  // module-wide
index URL

Common module configuration parameters

Configuration settings
SysCall.common$ = Types.Common$ undefined;
 
DETAILS
All modules have this configuration parameter. Its name contains the '$' character to ensure it does not conflict with configuration parameters declared by the module. This allows new configuration parameters to be added in the future without any chance of breaking existing modules.
generated on Thu, 23 May 2019 00:22:40 GMT