This module has a common header that can be found in the
ti.ipc
package. Application code should include the common header file (not the
RTSC-generated one):
The RTSC module must be used in the application's RTSC configuration file
(.cfg) if runtime APIs will be used in the application:
Documentation for all runtime APIs, instance configuration parameters,
error codes macros and type definitions available to the application
integrator can be found in the
<A HREF="../../../../doxygen/html/files.html">Doxygen documenation</A>
for the IPC product. However, the documentation presented on this page
should be referred to for information specific to the RTSC module, such as
module configuration, Errors, and Asserts.
The Notify module typically doesn't require much (if any) configuration at
static time. However, it is possible to reduce the amount of shared memory
used by the Notify subsystem by reducing the value of
numEvents.
proxy Notify.SetupProxy |
 |
Device-specific Notify setup proxy
XDCscript usage |
meta-domain |
// some delegate module inheriting the
INotifySetup interface
// explicit access to the currently bound delegate module
const Notify.MAXEVENTS |
 |
Maximum number of events supported by the Notify module
XDCscript usage |
meta-domain |
const Notify.MAXEVENTS = 32;
#define Notify_MAXEVENTS (UInt)32
config Notify.A_alreadyRegistered // module-wide |
 |
Assert raised when trying to re-register for given line and processor
XDCscript usage |
meta-domain |
msg: "A_alreadyRegistered: Notify instance for the processor/line already registered"
};
extern const Assert_Id Notify_A_alreadyRegistered;
config Notify.A_notRegistered // module-wide |
 |
Assert raised when trying to use an unregistered Notify instance
XDCscript usage |
meta-domain |
msg: "A_notRegistered: Notify instance not yet registered for the processor/line"
};
extern const Assert_Id Notify_A_notRegistered;
config Notify.A_outOfOrderNesting // module-wide |
 |
Assert raised when restore called with improper key
XDCscript usage |
meta-domain |
msg: "A_outOfOrderNesting: Out of order nesting"
};
extern const Assert_Id Notify_A_outOfOrderNesting;
config Notify.A_reservedEvent // module-wide |
 |
Assert raised when trying to improperly use a reserved event
XDCscript usage |
meta-domain |
msg: "A_reservedEvent: Improper use of a reserved event"
};
extern const Assert_Id Notify_A_reservedEvent;
config Notify.numEvents // module-wide |
 |
Number of events supported by Notify
XDCscript usage |
meta-domain |
Notify.numEvents = UInt 32;
extern const UInt Notify_numEvents;
DETAILS
Lowering this value offers the benefit of lower footprint especially in
shared memory.
config Notify.reservedEvents // module-wide |
 |
Number of reserved event numbers
XDCscript usage |
meta-domain |
Notify.reservedEvents = UInt16 3;
extern const UInt16 Notify_reservedEvents;
DETAILS
The first reservedEvents event numbers are reserved for
middleware modules. Attempts to use these reserved events
will result in a
A_reservedEvent assert.
To use the reserved events, the top 16-bits of the eventId must have the
SYSTEMKEY OR'd in.
config Notify.sendEventPollCount // module-wide |
 |
Poll for specified amount before sendEvent times out
XDCscript usage |
meta-domain |
Notify.sendEventPollCount = UInt32 -1;
extern const UInt32 Notify_sendEventPollCount;
DETAILS
Setting a finite value for sendEventPollCount will cause
Notify_sendEvent to poll for an amount of time
proportional to this value.
metaonly config Notify.common$ // module-wide |
 |
Common module configuration parameters
XDCscript usage |
meta-domain |
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.
metaonly config Notify.rovViewInfo // module-wide |
 |
XDCscript usage |
meta-domain |
module-wide built-ins |
 |
// Get this module's unique id
Bool Notify_Module_startupDone( );
// Test if this module has completed startup
// The heap from which this module allocates memory
Bool Notify_Module_hasMask( );
// Test whether this module has a diagnostics mask
Bits16 Notify_Module_getMask( );
// Returns the diagnostics mask for this module
Void Notify_Module_setMask( Bits16 mask );
// Set the diagnostics mask for this module
per-instance object types |
 |
typedef struct Notify_Object Notify_Object;
// Opaque internal representation of an instance object
// Client reference to an instance object
typedef struct Notify_Struct Notify_Struct;
// Opaque client structure large enough to hold an instance object
// Convert this instance structure pointer into an instance handle
// Convert this instance handle into an instance structure pointer
per-instance config parameters |
 |
XDCscript usage |
meta-domain |
var params = new Notify.Params;
// Instance config-params object
typedef struct Notify_Params {
// Instance config-params structure
// Common per-instance configs
} Notify_Params;
// Initialize this config-params structure with supplier-specified defaults before instance creation
per-instance built-ins |
 |
Int Notify_Object_count( );
// The number of statically-created instance objects
// The handle of the i-th statically-created instance object (array == NULL)
// The handle of the first dynamically-created instance object, or NULL
// The handle of the next dynamically-created instance object, or NULL
// The heap used to allocate dynamically-created instance objects
// The label associated with this instance object
// The name of this instance object