Interface implemented by all drivers for the notify module. Modules that
implement this interface expect the eventId arguments to be valid.
metaonly config INotifyDriver.common$ // module-wide |
|
Common module configuration parameters
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.
INotifyDriver.disable() // instance |
|
Disable a NotifyDriver instance
DETAILS
Disables the ability of a Notify driver to receive events for a given
processor. This interface function is called by the Notify_disable
function. Refer to its documentation for more details.
INotifyDriver.disableEvent() // instance |
|
Disable an event
Void disableEvent(UInt32 eventId);
ARGUMENTS
eventId
Number of event to disable
DETAILS
This interface function is called by the Notify_disableEvent function.
Refer to its documentation for more details.
The Notify module does validation of the eventId. The Notify module
enters calls this function within the Notify module gate.
INotifyDriver.enable() // instance |
|
Enable a NotifyDriver instance
DETAILS
Enables the ability of a Notify driver to receive events for a given
processor. This interface function is called by the Notify_restore
function. Refer to its documentation for more details.
INotifyDriver.enableEvent() // instance |
|
Enable an event
Void enableEvent(UInt32 eventId);
ARGUMENTS
eventId
Number of event to enable
DETAILS
This interface function is called by the Notify_disableEvent function.
Refer to its documentation for more details.
The Notify module does validation of the eventId. The Notify module
enters calls this function within the Notify module gate.
INotifyDriver.registerEvent() // instance |
|
Register a callback to an event
Void registerEvent(UInt32 eventId);
ARGUMENTS
eventId
Number of event that is being registered
DETAILS
This driver function is called by the Notify_registerEvent function
within the Notify module gate. Refer to its documentation for more
details.
INotifyDriver.sendEvent() // instance |
|
Send a signal to an event
Int sendEvent(UInt32 eventId, UInt32 payload, Bool waitClear);
ARGUMENTS
eventId
Number of event to signal
payload
Payload (optional) to pass to callback function
waitClear
If TRUE, have the NotifyDriver wait for
acknowledgement back from the destination
processor.
RETURNS
Notify status
DETAILS
This interface function is called by the Notify_sendEvent function.
Notify_sendEvent does not provide any context protection for
INotifyDriver_sendEvent, so appropriate measures must be taken within
the driver itself.
INotifyDriver.unregisterEvent() // instance |
|
Remove an event listener from an event
Void unregisterEvent(UInt32 eventId);
ARGUMENTS
eventId
Number of event that is being unregistered
DETAILS
This driver function is called by the Notify_unregisterEvent function
within the Notify module gate. Refer to it for more details.