2.15 MSI Driver
Overview
The MSI module is a bridge between the Main and a Secondary processor system, each of which operates within independent clock domains. The Main and Secondary have their own registers to communicate between the MSI modules; the Main MSI registers are located in the Main SFR space and the Secondary MSI registers are in the Secondary SFR space.
For detailed explanation, refer this link "4.1 dsPIC33CH Architecture Overview and Features"
Features
-
Sixteen Unidirectional Data Mailbox Registers
-
Direction of each Mailbox register is fuse-selectable
-
Byte and word-addressable
-
-
Eight Mailbox Data Flow Control Protocol Blocks
-
Individual fuse enables
-
Write port active; read port passive (i.e., no read data request required)
-
Automatic, interrupt-driven (or polled), data flow control mechanism across MSI clock boundary
-
Fuse assignable to any of the Mailbox registers, supports any length data buffers (up to the number of available Mailbox registers)
-
-
Main to Secondary and Secondary to Main Interrupt Request with Acknowledge Data Flow Control
-
Two-Channel FIFO Memory Structure
-
One read and one write channel, each 32 words deep
-
Circular operation with empty and full status, and interrupts
-
Overflow/underflow detection with interrupts to Main core and Secondary core
-
Interrupt-based, software polled or DMA transfer-compatible
-
-
Main and Secondary Processor Cross-Boundary Control and Status
-
Readable operating mode status for both processors
-
Secondary enable from Main (subject to satisfying a hardware write interlock sequencer)
-
Main interrupt when Secondary is reset during code execution
-
Secondary interrupt when Main is reset during code execution
-
-
Optional (fuse) Decoupling of Main and Secondary Resets; POR/BOR/MCLR always Resets Main and Secondary; Influence of Remaining Run-Time Resets on the Secondary Enable is Fuse-Programmable
2.15.1 Module Documentation
2.15.1.1 MSI-Main Core Driver
2.15.1.1.1 Module description
This is the generated driver interface file for the MAIN_CORE driver.
Data structures
struct MAIN_CORE_INTERFACE
Structure containing the function pointers of MAIN_CORE driver.
Enumerations
enum MAIN_CORE_SYSTEM_STATUS { MAIN_CORE_SYSTEM_STATUS_NOT_IN_LOW_POWER_MODE = 0, MAIN_CORE_SYSTEM_STATUS_SLEEP_MODE = 1, MAIN_CORE_SYSTEM_STATUS_IDLE_MODE = 2, MAIN_CORE_SYSTEM_STATUS_RUNNING_STATE = 3, MAIN_CORE_SYSTEM_STATUS_IN_RESET_STATE = 4 }
Defines the status enumeration for main_core.
enum MAIN_CORE_PROTOCOLS { MSI1_ProtocolA, MSI1_ProtocolB }
Defines the list of Protocols configured for MAIN_CORE_driver.
enum MAIN_CORE_PROTOCOL_SIZE { MSI1_ProtocolA_SIZE = 1, MSI1_ProtocolB_SIZE = 1 }
Defines the size for Protocols.
Functions
void MAIN_CORE_Initialize (void)
This routine initializes the MSI driver. This routine must be called before any other MSI routine is called. This routine should only be called once during system initialization.
void MAIN_CORE_Deinitialize (void)
Deinitializes MAIN_CORE to POR values.
void MAIN_CORE_InterruptRequestGenerate (void)
This routine generates interrupt to MAIN_CORE.
bool MAIN_CORE_IsInterruptRequestAcknowledged (void)
This routine returns the status of interrupt request acknowledge from the MAIN_CORE.
void MAIN_CORE_InterruptRequestComplete (void)
This routine clears interrupt to MAIN_CORE.
bool MAIN_CORE_IsInterruptRequested (void)
This routine returns the status of interrupt request from the MAIN_CORE.
void MAIN_CORE_InterruptRequestAcknowledge (void)
This routine acknowledges interrupt received from Main MSI.
void MAIN_CORE_InterruptRequestAcknowledgeComplete (void)
This routine clears acknowledge for interrupt received from Main MSI.
enum MAIN_CORE_SYSTEM_STATUS MAIN_CORE_SystemStatusGet (void)
This routine returns Main system status.
uint16_t MAIN_CORE_FIFORead (uint16_t *pData, uint16_t wordCount)
This routine reads FIFO data sent from the Main Core.
uint16_t MAIN_CORE_FIFOWrite (uint16_t *pData, uint16_t wordCount)
This routine transfers FIFO data to Main Core.
static bool MAIN_CORE_FIFOReadIsFull (void)
This inline function checks whether the status of Read FIFO is full. last write by Secondary core to Read FIFO (RFDATA) was into the last free location.
static bool MAIN_CORE_FIFOReadIsEmpty (void)
This inline function checks whether the status of Read FIFO is Empty. Returns true if last read by Main core from Read FIFO (RFDATA) emptied the FIFO of all valid data or FIFO is disabled (and initialized to the empty state)
static bool MAIN_CORE_FIFOWriteIsFull (void)
This inline function checks whether the status of Write FIFO is Full. Returns true if last write by Main core to Write FIFO (WFDATA) was into the last free location.
static bool MAIN_CORE_FIFOWriteIsEmpty (void)
This inline function checks whether the status of Write FIFO is Empty. Returns true if last write by Main to Write FIFO (WFDATA) was into the last free location.
bool MAIN_CORE_ProtocolWrite (enum MAIN_CORE_PROTOCOLS protocolName, uint16_t *pData)
This routine writes data to mailbox.
bool MAIN_CORE_ProtocolRead (enum MAIN_CORE_PROTOCOLS protocolName, uint16_t *pData)
This routine reads data from mailbox.
static bool MAIN_CORE_ProtocolIsFull (enum MAIN_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is full. Returns true if New data are ready to read. Returns false when No data are available to be read by Main core.
static bool MAIN_CORE_ProtocolIsEmpty (enum MAIN_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is empty. Returns true if Protocol is empty indicating mailbox is ready to write by Main core. returns false indicating write operation cannot be performed by Main core.
void MAIN_CORE_ProtocolCallbackRegister (enum MAIN_CORE_PROTOCOLS protocolName, void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE protocol event.
void MAIN_CORE_MSI1_ProtocolACallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MSI1_ProtocolACallbackRegister.
void MAIN_CORE_MSI1_ProtocolBCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MSI1_ProtocolBCallbackRegister.
void MAIN_CORE_ReadFIFODataReadyCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE ReadFIFODataReady event.
void MAIN_CORE_ReadFIFODataReadyCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_ReadFIFODataReadyCallbackRegister.
void MAIN_CORE_WriteFIFOEmptyCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE WriteFIFOEmpty event.
void MAIN_CORE_WriteFIFOEmptyCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_WriteFIFOEmptyCallbackRegister.
void MAIN_CORE_FIFOOverFLowUnderFlowCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE FIFOOverFLowUnderFlow event.
void MAIN_CORE_FIFOOverFLowUnderFlowCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_FIFOOverFLowUnderFlowCallbackRegister.
void MAIN_CORE_MainInitiatedCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE MainInitiated event.
void MAIN_CORE_MainInitiatedCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MainInitiatedCallbackRegister.
void MAIN_CORE_MainBreakCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE MainBreak event.
void MAIN_CORE_MainBreakCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MainBreakCallbackRegister.
void MAIN_CORE_MainResetCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE MainReset event.
void MAIN_CORE_MainResetCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MainResetCallbackRegister.
Variables
const struct MAIN_CORE_INTERFACE MSIInterface
Structure object of type MAIN_CORE_INTERFACE with the custom name given by the user in the Melody Driver User interface. The default name e.g. Main_Core can be changed by the user in the MAIN_CORE user interface. This allows defining a structure with application specific name using the 'Custom Name' field. Application specific name allows the API Portability.
2.15.1.1.2 Function Documentation
MAIN_CORE_Deinitialize()
void MAIN_CORE_Deinitialize (void )
Deinitializes MAIN_CORE to POR values.
none |
none |
MAIN_CORE_FIFOOverFLowUnderFlowCallback()
void MAIN_CORE_FIFOOverFLowUnderFlowCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_FIFOOverFLowUnderFlowCallbackRegister.
none |
none |
MAIN_CORE_FIFOOverFLowUnderFlowCallbackRegister()
void MAIN_CORE_FIFOOverFLowUnderFlowCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for MAIN_CORE FIFOOverFLowUnderFlow event.
in | handler |
- Address of the callback function. |
none |
MAIN_CORE_FIFORead()
uint16_t MAIN_CORE_FIFORead (uint16_t * pData, uint16_t wordCount)
This routine reads FIFO data sent from the Main Core.
in | *pData |
- Pointer to an array to store the read data |
in | wordCount |
- Number of words to be read. |
Number of words read. |
MAIN_CORE_FIFOReadIsEmpty()
inline static bool MAIN_CORE_FIFOReadIsEmpty (void )
This inline function checks whether the status of Read FIFO is Empty. Returns true if last read by Main core from Read FIFO (RFDATA) emptied the FIFO of all valid data or FIFO is disabled (and initialized to the empty state)
MAIN_CORE_FIFOReadIsFull()
inline static bool MAIN_CORE_FIFOReadIsFull (void )
This inline function checks whether the status of Read FIFO is full. last write by Secondary core to Read FIFO (RFDATA) was into the last free location.
MAIN_CORE_FIFOWrite()
uint16_t MAIN_CORE_FIFOWrite (uint16_t * pData, uint16_t wordCount)
This routine transfers FIFO data to Main Core.
MAIN_CORE_Initialize() should be called before calling this routine. |
in | *pData |
- Pointer to an array which has data for transmission. |
in | wordCount |
- Number of words to be transfer. |
Number of words transferred. |
MAIN_CORE_FIFOWriteIsEmpty()
inline static bool MAIN_CORE_FIFOWriteIsEmpty (void )
This inline function checks whether the status of Write FIFO is Empty. Returns true if last write by Main to Write FIFO (WFDATA) was into the last free location.
MAIN_CORE_FIFOWriteIsFull()
inline static bool MAIN_CORE_FIFOWriteIsFull (void )
This inline function checks whether the status of Write FIFO is Full. Returns true if last write by Main core to Write FIFO (WFDATA) was into the last free location.
MAIN_CORE_Initialize()
void MAIN_CORE_Initialize (void )
This routine initializes the MSI driver. This routine must be called before any other MSI routine is called. This routine should only be called once during system initialization.
none |
none |
MAIN_CORE_InterruptRequestAcknowledge()
void MAIN_CORE_InterruptRequestAcknowledge (void )
This routine acknowledges interrupt received from Main MSI.
none |
none |
MAIN_CORE_InterruptRequestAcknowledgeComplete()
void MAIN_CORE_InterruptRequestAcknowledgeComplete (void )
This routine clears acknowledge for interrupt received from Main MSI.
none |
none |
MAIN_CORE_InterruptRequestComplete()
void MAIN_CORE_InterruptRequestComplete (void )
This routine clears interrupt to MAIN_CORE.
none |
none |
MAIN_CORE_InterruptRequestGenerate()
void MAIN_CORE_InterruptRequestGenerate (void )
This routine generates interrupt to MAIN_CORE.
none |
none |
MAIN_CORE_IsInterruptRequestAcknowledged()
bool MAIN_CORE_IsInterruptRequestAcknowledged (void )
This routine returns the status of interrupt request acknowledge from the MAIN_CORE.
none |
True - when MAIN_CORE has acknowledged Main MSI interrupt request. False - when MAIN_CORE has not acknowledged Main MSI interrupt request. |
MAIN_CORE_IsInterruptRequested()
bool MAIN_CORE_IsInterruptRequested (void )
This routine returns the status of interrupt request from the MAIN_CORE.
none |
True - when MAIN_CORE has issued interrupt to Secondary Core. False - when MAIN_CORE has not issued interrupt to Secondary Core. |
MAIN_CORE_MainBreakCallback()
void MAIN_CORE_MainBreakCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MainBreakCallbackRegister.
none |
none |
MAIN_CORE_MainBreakCallbackRegister()
void MAIN_CORE_MainBreakCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for MAIN_CORE MainBreak event.
in | handler |
- Address of the callback function. |
none |
MAIN_CORE_MainInitiatedCallback()
void MAIN_CORE_MainInitiatedCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MainInitiatedCallbackRegister.
none |
none |
MAIN_CORE_MainInitiatedCallbackRegister()
void MAIN_CORE_MainInitiatedCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for MAIN_CORE MainInitiated event.
in | handler |
- Address of the callback function. |
none |
MAIN_CORE_MainResetCallback()
void MAIN_CORE_MainResetCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MainResetCallbackRegister.
none |
none |
MAIN_CORE_MainResetCallbackRegister()
void MAIN_CORE_MainResetCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for MAIN_CORE MainReset event.
in | handler |
- Address of the callback function. |
none |
MAIN_CORE_MSI1_ProtocolACallback()
void MAIN_CORE_MSI1_ProtocolACallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MSI1_ProtocolACallbackRegister.
none |
none |
MAIN_CORE_MSI1_ProtocolBCallback()
void MAIN_CORE_MSI1_ProtocolBCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MSI1_ProtocolBCallbackRegister.
none |
none |
MAIN_CORE_ProtocolCallbackRegister()
void MAIN_CORE_ProtocolCallbackRegister (enum MAIN_CORE_PROTOCOLS protocolName, void(*)(void) handler)
This function can be used to override default callback and to define custom callback for MAIN_CORE protocol event.
in | protocolName |
- Selected protocol |
in | handler |
- Address of the callback function. |
none |
MAIN_CORE_ProtocolIsEmpty()
inline static bool MAIN_CORE_ProtocolIsEmpty (enum MAIN_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is empty. Returns true if Protocol is empty indicating mailbox is ready to write by Main core. returns false indicating write operation cannot be performed by Main core.
in | protocolName |
- Selected protocol |
true - Protocol is empty false - Protocol is full |
MAIN_CORE_ProtocolIsFull()
inline static bool MAIN_CORE_ProtocolIsFull (enum MAIN_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is full. Returns true if New data are ready to read. Returns false when No data are available to be read by Main core.
in | protocolName |
- Selected protocol |
true - Protocol is full false - Protocol is empty |
MAIN_CORE_ProtocolRead()
bool MAIN_CORE_ProtocolRead (enum MAIN_CORE_PROTOCOLS protocolName, uint16_t * pData)
This routine reads data from mailbox.
in | protocolName |
- Selected protocol |
in | *pData |
- Pointer to a structure to store the read data |
true - successful read false - unsuccessful read |
MAIN_CORE_ProtocolWrite()
bool MAIN_CORE_ProtocolWrite (enum MAIN_CORE_PROTOCOLS protocolName, uint16_t * pData)
This routine writes data to mailbox.
in | protocolName |
- Selected protocol |
in | *pData |
- Pointer to a structure which has data for transmission. |
true - successful write false - unsuccessful write |
MAIN_CORE_ReadFIFODataReadyCallback()
void MAIN_CORE_ReadFIFODataReadyCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_ReadFIFODataReadyCallbackRegister.
none |
none |
MAIN_CORE_ReadFIFODataReadyCallbackRegister()
void MAIN_CORE_ReadFIFODataReadyCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for MAIN_CORE ReadFIFODataReady event.
in | handler |
- Address of the callback function. |
none |
MAIN_CORE_SystemStatusGet()
enum MAIN_CORE_SYSTEM_STATUS MAIN_CORE_SystemStatusGet (void )
This routine returns Main system status.
none |
MAIN_CORE_SYSTEM_STATUS: Enum which provides the status of MAIN_CORE. |
MAIN_CORE_WriteFIFOEmptyCallback()
void MAIN_CORE_WriteFIFOEmptyCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_WriteFIFOEmptyCallbackRegister.
none |
none |
MAIN_CORE_WriteFIFOEmptyCallbackRegister()
void MAIN_CORE_WriteFIFOEmptyCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for MAIN_CORE WriteFIFOEmpty event.
in | handler |
- Address of the callback function. |
none |
2.15.1.1.3 Enumeration Type Documentation
MAIN_CORE_PROTOCOL_SIZE
enum MAIN_CORE_PROTOCOL_SIZE
Defines the size for Protocols.
Size not required for the driver but will be required for application to create the buffers
MSI1_ProtocolA_SIZE |
Size of ProtocolA in 16-bit word |
MSI1_ProtocolB_SIZE |
Size of ProtocolB in 16-bit word |
MAIN_CORE_PROTOCOLS
enum MAIN_CORE_PROTOCOLS
Defines the list of Protocols configured for MAIN_CORE_driver.
These Protocols are required to create the buffer by the application
MSI1_ProtocolA |
Custom-name of ProtocolA for read operation only |
MSI1_ProtocolB |
Custom-name of ProtocolB for write operation only |
MAIN_CORE_SYSTEM_STATUS
enum MAIN_CORE_SYSTEM_STATUS
Defines the status enumeration for main_core.
MAIN_CORE_SYSTEM_STATUS_NOT_IN_LOW_POWER_MODE |
main_core status is in Low power mode |
MAIN_CORE_SYSTEM_STATUS_SLEEP_MODE |
main_core status is in Sleep mode |
MAIN_CORE_SYSTEM_STATUS_IDLE_MODE |
main_core status is in Idle mode |
MAIN_CORE_SYSTEM_STATUS_RUNNING_STATE |
main_core status is in Running state |
MAIN_CORE_SYSTEM_STATUS_IN_RESET_STATE |
main_core status is in Reset state |
2.15.1.1.4 Variable Documentation
MSIInterface
const struct MAIN_CORE_INTERFACE MSIInterface
Structure object of type MAIN_CORE_INTERFACE with the custom name given by the user in the Melody Driver User interface. The default name e.g. Main_Core can be changed by the user in the MAIN_CORE user interface. This allows defining a structure with application specific name using the 'Custom Name' field. Application specific name allows the API Portability.
2.15.2 Class Documentation
2.15.2.1 MAIN_CORE_INTERFACE Struct Reference
Structure containing the function pointers of MAIN_CORE driver.
2.15.2.1.1 Detailed Description
Structure containing the function pointers of MAIN_CORE driver.
#include <main_core_interface.h>
Public Attributes
void(* Initialize )(void)
Pointer to MAIN_CORE_Initialize.
void(* Deinitialize )(void)
Pointer to MAIN_CORE_Deinitialize.
void(* InterruptRequestGenerate )(void)
Pointer to MAIN_CORE_InterruptRequestGenerate.
bool(* IsInterruptRequestAcknowledged )(void)
Pointer to MAIN_CORE_IsInterruptRequestAcknowledged.
void(* InterruptRequestComplete )(void)
Pointer to MAIN_CORE_InterruptRequestComplete.
bool(* IsInterruptRequested )(void)
Pointer to MAIN_CORE_IsInterruptRequested.
void(* InterruptRequestAcknowledge )(void)
Pointer to MAIN_CORE_InterruptRequestAcknowledge.
void(* InterruptRequestAcknowledgeComplete )(void)
Pointer to MAIN_CORE_InterruptRequestAcknowledgeComplete.
enum MAIN_CORE_SYSTEM_STATUS(* SystemStatusGet )(void)
Pointer to MAIN_CORE_SystemStatusGet.
uint16_t(* FIFORead )(uint16_t *pData, uint16_t wordCount)
Pointer to MAIN_CORE_FIFORead.
uint16_t(* FIFOWrite )(uint16_t *pData, uint16_t wordCount)
Pointer to MAIN_CORE_FIFOWrite.
bool(* FIFOReadIsFull )(void)
Pointer to MAIN_CORE_FIFOReadIsFull.
bool(* FIFOReadIsEmpty )(void)
Pointer to MAIN_CORE_FIFOReadIsEmpty.
bool(* FIFOWriteIsFull )(void)
Pointer to MAIN_CORE_FIFOWriteIsFull.
bool(* FIFOWriteIsEmpty )(void)
Pointer to MAIN_CORE_FIFOWriteIsEmpty.
bool(* ProtocolRead )(enum MAIN_CORE_PROTOCOLS protocolName, uint16_t *pData)
Pointer to MAIN_CORE_ProtocolRead.
bool(* ProtocolWrite )(enum MAIN_CORE_PROTOCOLS protocolName, uint16_t *pData)
Pointer to MAIN_CORE_ProtocolRead.
bool(* ProtocolIsFull )(enum MAIN_CORE_PROTOCOLS protocolName)
Pointer to MAIN_CORE_ProtocolIsFull.
bool(* ProtocolIsEmpty )(enum MAIN_CORE_PROTOCOLS protocolName)
Pointer to MAIN_CORE_ProtocolIsEmpty.
void(* ProtocolCallbackRegister )(enum MAIN_CORE_PROTOCOLS protocolName, void(*handler)(void))
Pointer to MAIN_CORE_ProtocolCallbackRegister.
void(* ReadFIFODataReadyCallbackRegister )(void(*handler)(void))
Pointer to MAIN_CORE_ReadFIFODataReadyCallbackRegister.
void(* WriteFIFOEmptyCallbackRegister )(void(*handler)(void))
Pointer to MAIN_CORE_WriteFIFOEmptyCallbackRegister.
void(* FIFOOverFLowUnderFlowCallbackRegister )(void(*handler)(void))
Pointer to MAIN_CORE_FIFOOverFLowUnderFlowCallbackRegister.
void(* MainInitiatedCallbackRegister )(void(*handler)(void))
Pointer to MAIN_CORE_MainInitiatedCallbackRegister.
void(* MainBreakCallbackRegister )(void(*handler)(void))
Pointer to MAIN_CORE_MainBreakCallbackRegister.
void(* MainResetCallbackRegister )(void(*handler)(void))
Pointer to MAIN_CORE_MainResetCallbackRegister.
2.15.2.1.2 Member Data Documentation
The documentation for this struct was generated from the following file:
source/
Deinitialize
void(* Deinitialize) (void)
Pointer to MAIN_CORE_Deinitialize.
FIFOOverFLowUnderFlowCallbackRegister
void(* FIFOOverFLowUnderFlowCallbackRegister) (void(*handler)(void))
Pointer to MAIN_CORE_FIFOOverFLowUnderFlowCallbackRegister.
FIFORead
uint16_t(* FIFORead) (uint16_t *pData, uint16_t wordCount)
Pointer to MAIN_CORE_FIFORead.
FIFOReadIsEmpty
bool(* FIFOReadIsEmpty) (void)
Pointer to MAIN_CORE_FIFOReadIsEmpty.
FIFOReadIsFull
bool(* FIFOReadIsFull) (void)
Pointer to MAIN_CORE_FIFOReadIsFull.
FIFOWrite
uint16_t(* FIFOWrite) (uint16_t *pData, uint16_t wordCount)
Pointer to MAIN_CORE_FIFOWrite.
FIFOWriteIsEmpty
bool(* FIFOWriteIsEmpty) (void)
Pointer to MAIN_CORE_FIFOWriteIsEmpty.
FIFOWriteIsFull
bool(* FIFOWriteIsFull) (void)
Pointer to MAIN_CORE_FIFOWriteIsFull.
Initialize
void(* Initialize) (void)
Pointer to MAIN_CORE_Initialize.
InterruptRequestAcknowledge
void(* InterruptRequestAcknowledge) (void)
Pointer to MAIN_CORE_InterruptRequestAcknowledge.
InterruptRequestAcknowledgeComplete
void(* InterruptRequestAcknowledgeComplete) (void)
Pointer to MAIN_CORE_InterruptRequestAcknowledgeComplete.
InterruptRequestComplete
void(* InterruptRequestComplete) (void)
Pointer to MAIN_CORE_InterruptRequestComplete.
InterruptRequestGenerate
void(* InterruptRequestGenerate) (void)
Pointer to MAIN_CORE_InterruptRequestGenerate.
IsInterruptRequestAcknowledged
bool(* IsInterruptRequestAcknowledged) (void)
Pointer to MAIN_CORE_IsInterruptRequestAcknowledged.
IsInterruptRequested
bool(* IsInterruptRequested) (void)
Pointer to MAIN_CORE_IsInterruptRequested.
MainBreakCallbackRegister
void(* MainBreakCallbackRegister) (void(*handler)(void))
Pointer to MAIN_CORE_MainBreakCallbackRegister.
MainInitiatedCallbackRegister
void(* MainInitiatedCallbackRegister) (void(*handler)(void))
Pointer to MAIN_CORE_MainInitiatedCallbackRegister.
MainResetCallbackRegister
void(* MainResetCallbackRegister) (void(*handler)(void))
Pointer to MAIN_CORE_MainResetCallbackRegister.
ProtocolCallbackRegister
void(* ProtocolCallbackRegister) (enum MAIN_CORE_PROTOCOLS protocolName, void(*handler)(void))
Pointer to MAIN_CORE_ProtocolCallbackRegister.
ProtocolIsEmpty
bool(* ProtocolIsEmpty) (enum MAIN_CORE_PROTOCOLS protocolName)
Pointer to MAIN_CORE_ProtocolIsEmpty.
ProtocolIsFull
bool(* ProtocolIsFull) (enum MAIN_CORE_PROTOCOLS protocolName)
Pointer to MAIN_CORE_ProtocolIsFull.
ProtocolRead
bool(* ProtocolRead) (enum MAIN_CORE_PROTOCOLS protocolName, uint16_t *pData)
Pointer to MAIN_CORE_ProtocolRead.
ProtocolWrite
bool(* ProtocolWrite) (enum MAIN_CORE_PROTOCOLS protocolName, uint16_t *pData)
Pointer to MAIN_CORE_ProtocolRead.
ReadFIFODataReadyCallbackRegister
void(* ReadFIFODataReadyCallbackRegister) (void(*handler)(void))
Pointer to MAIN_CORE_ReadFIFODataReadyCallbackRegister.
SystemStatusGet
enum MAIN_CORE_SYSTEM_STATUS(* SystemStatusGet) (void)
Pointer to MAIN_CORE_SystemStatusGet.
WriteFIFOEmptyCallbackRegister
void(* WriteFIFOEmptyCallbackRegister) (void(*handler)(void))
Pointer to MAIN_CORE_WriteFIFOEmptyCallbackRegister.
2.15.3 File Documentation
2.15.3.1 source/main_core.h File Reference
This is the generated driver header file for the MAIN_CORE driver.
#include <xc.h> #include <stdint.h> #include <stdbool.h> #include "main_core_types.h" #include "main_core_interface.h"
2.15.3.1.1 Functions
void MAIN_CORE_Initialize (void)
This routine initializes the MSI driver. This routine must be called before any other MSI routine is called. This routine should only be called once during system initialization.
void MAIN_CORE_Deinitialize (void)
Deinitializes MAIN_CORE to POR values.
void MAIN_CORE_InterruptRequestGenerate (void)
This routine generates interrupt to MAIN_CORE.
bool MAIN_CORE_IsInterruptRequestAcknowledged (void)
This routine returns the status of interrupt request acknowledge from the MAIN_CORE.
void MAIN_CORE_InterruptRequestComplete (void)
This routine clears interrupt to MAIN_CORE.
bool MAIN_CORE_IsInterruptRequested (void)
This routine returns the status of interrupt request from the MAIN_CORE.
void MAIN_CORE_InterruptRequestAcknowledge (void)
This routine acknowledges interrupt received from Main MSI.
void MAIN_CORE_InterruptRequestAcknowledgeComplete (void)
This routine clears acknowledge for interrupt received from Main MSI.
enum MAIN_CORE_SYSTEM_STATUS MAIN_CORE_SystemStatusGet (void)
This routine returns Main system status.
uint16_t MAIN_CORE_FIFORead (uint16_t *pData, uint16_t wordCount)
This routine reads FIFO data sent from the Main Core.
uint16_t MAIN_CORE_FIFOWrite (uint16_t *pData, uint16_t wordCount)
This routine transfers FIFO data to Main Core.
static bool MAIN_CORE_FIFOReadIsFull (void)
This inline function checks whether the status of Read FIFO is full. last write by Secondary core to Read FIFO (RFDATA) was into the last free location.
static bool MAIN_CORE_FIFOReadIsEmpty (void)
This inline function checks whether the status of Read FIFO is Empty. Returns true if last read by Main core from Read FIFO (RFDATA) emptied the FIFO of all valid data or FIFO is disabled (and initialized to the empty state)
static bool MAIN_CORE_FIFOWriteIsFull (void)
This inline function checks whether the status of Write FIFO is Full. Returns true if last write by Main core to Write FIFO (WFDATA) was into the last free location.
static bool MAIN_CORE_FIFOWriteIsEmpty (void)
This inline function checks whether the status of Write FIFO is Empty. Returns true if last write by Main to Write FIFO (WFDATA) was into the last free location.
bool MAIN_CORE_ProtocolWrite (enum MAIN_CORE_PROTOCOLS protocolName, uint16_t *pData)
This routine writes data to mailbox.
bool MAIN_CORE_ProtocolRead (enum MAIN_CORE_PROTOCOLS protocolName, uint16_t *pData)
This routine reads data from mailbox.
static bool MAIN_CORE_ProtocolIsFull (enum MAIN_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is full. Returns true if New data are ready to read. Returns false when No data are available to be read by Main core.
static bool MAIN_CORE_ProtocolIsEmpty (enum MAIN_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is empty. Returns true if Protocol is empty indicating mailbox is ready to write by Main core. returns false indicating write operation cannot be performed by Main core.
void MAIN_CORE_ProtocolCallbackRegister (enum MAIN_CORE_PROTOCOLS protocolName, void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE protocol event.
void MAIN_CORE_MSI1_ProtocolACallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MSI1_ProtocolACallbackRegister.
void MAIN_CORE_MSI1_ProtocolBCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MSI1_ProtocolBCallbackRegister.
void MAIN_CORE_ReadFIFODataReadyCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE ReadFIFODataReady event.
void MAIN_CORE_ReadFIFODataReadyCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_ReadFIFODataReadyCallbackRegister.
void MAIN_CORE_WriteFIFOEmptyCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE WriteFIFOEmpty event.
void MAIN_CORE_WriteFIFOEmptyCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_WriteFIFOEmptyCallbackRegister.
void MAIN_CORE_FIFOOverFLowUnderFlowCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE FIFOOverFLowUnderFlow event.
void MAIN_CORE_FIFOOverFLowUnderFlowCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_FIFOOverFLowUnderFlowCallbackRegister.
void MAIN_CORE_MainInitiatedCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE MainInitiated event.
void MAIN_CORE_MainInitiatedCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MainInitiatedCallbackRegister.
void MAIN_CORE_MainBreakCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE MainBreak event.
void MAIN_CORE_MainBreakCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MainBreakCallbackRegister.
void MAIN_CORE_MainResetCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for MAIN_CORE MainReset event.
void MAIN_CORE_MainResetCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using MAIN_CORE_MainResetCallbackRegister.
2.15.3.1.2 Variables
const struct MAIN_CORE_INTERFACE MSIInterface
Structure object of type MAIN_CORE_INTERFACE with the custom name given by the user in the Melody Driver User interface. The default name e.g. Main_Core can be changed by the user in the MAIN_CORE user interface. This allows defining a structure with application specific name using the 'Custom Name' field. Application specific name allows the API Portability.
2.15.3.1.3 Detailed Description
This is the generated driver header file for the MAIN_CORE driver.
MAIN_CORE Generated Driver Header File
2.15.3.2 source/main_core_interface.h File Reference
#include <stddef.h> #include <stdint.h> #include <stdbool.h> #include "main_core_types.h"
2.15.3.2.1 Data structures
struct MAIN_CORE_INTERFACE
Structure containing the function pointers of MAIN_CORE driver.
2.15.3.2.2 Detailed Description
MAIN_CORE Generated Driver Interface Header File
2.15.3.3 source/main_core_types.h File Reference
This is the generated driver types header file for the MAIN_CORE driver.
2.15.3.3.1 Enumerations
enum MAIN_CORE_SYSTEM_STATUS { MAIN_CORE_SYSTEM_STATUS_NOT_IN_LOW_POWER_MODE = 0, MAIN_CORE_SYSTEM_STATUS_SLEEP_MODE = 1, MAIN_CORE_SYSTEM_STATUS_IDLE_MODE = 2, MAIN_CORE_SYSTEM_STATUS_RUNNING_STATE = 3, MAIN_CORE_SYSTEM_STATUS_IN_RESET_STATE = 4 }
Defines the status enumeration for main_core.
enum MAIN_CORE_PROTOCOLS { MSI1_ProtocolA, MSI1_ProtocolB }
Defines the list of Protocols configured for MAIN_CORE_driver.
enum MAIN_CORE_PROTOCOL_SIZE { MSI1_ProtocolA_SIZE = 1, MSI1_ProtocolB_SIZE = 1 }
Defines the size for Protocols.
2.15.3.3.2 Detailed Description
This is the generated driver types header file for the MAIN_CORE driver.
MAIN_CORE Generated Driver Types Header File
2.15.4 Module Documentation
2.15.4.1 MSI-Secondary Core Driver
2.15.4.1.1 Module description
This is the generated driver interface file for SEC_CORE driver.
Data structures
struct SEC_CORE_INTERFACE
Structure containing the function pointers of SEC_CORE driver.
Enumerations
enum SEC_CORE_SYSTEM_STATUS { SEC_CORE_SYSTEM_STATUS_NOT_IN_LOW_POWER_MODE = 0, SEC_CORE_SYSTEM_STATUS_SLEEP_MODE = 1, SEC_CORE_SYSTEM_STATUS_IDLE_MODE = 2, SEC_CORE_SYSTEM_STATUS_RUNNING_STATE = 3, SEC_CORE_SYSTEM_STATUS_IN_RESET_STATE = 4 }
Defines the status enumeration for sec_core.
enum SEC_CORE_RESET_CAUSE { SEC_CORE_RESET_CAUSE_WATCHDOG = 0, SEC_CORE_RESET_CAUSE_UNSPECIFIED = 1 }
Defines the sec_core reset cause enumeration.
enum SEC_CORE_PROTOCOLS { MSI1_ProtocolA, MSI1_ProtocolB }
Defines the list of Protocols configured for SEC_CORE_driver.
enum SEC_CORE_PROTOCOL_SIZE { MSI1_ProtocolA_SIZE = 1, MSI1_ProtocolB_SIZE = 1 }
Defines the size for Protocols.
Functions
void SEC_CORE1_Initialize (void)
This routine initializes the MSI driver. This routine must be called before any other MSI routine is called. This routine should only be called once during system initialization.
void SEC_CORE1_Deinitialize (void)
Deinitializes SEC_CORE1 to POR values.
void SEC_CORE1_Start (void)
This routine enables secondary core.
void SEC_CORE1_Program (void)
This routine programs secondary.
void SEC_CORE1_InterruptRequestGenerate (void)
This routine generates interrupt to SEC_CORE1.
bool SEC_CORE1_IsInterruptRequestAcknowledged (void)
This routine returns the status of interrupt request acknowledge from the SEC_CORE1.
void SEC_CORE1_InterruptRequestComplete (void)
This routine clears interrupt to SEC_CORE1.
bool SEC_CORE1_IsInterruptRequested (void)
This routine returns the status of interrupt request from the SEC_CORE1.
void SEC_CORE1_InterruptRequestAcknowledge (void)
This routine acknowledges interrupt received from SEC_CORE1.
void SEC_CORE1_InterruptRequestAcknowledgeComplete (void)
This routine clears acknowledge for interrupt received from SEC_CORE1.
enum SEC_CORE_RESET_CAUSE SEC_CORE1_GetResetCause (void)
This routine returns the cause for SEC_CORE1 reset.
void SEC_CORE1_ResetCauseClear (enum SEC_CORE_RESET_CAUSE resetCause)
This routine clears the cause for SEC_CORE1 reset.
enum SEC_CORE_SYSTEM_STATUS SEC_CORE1_SystemStatusGet (void)
This routine returns Secondary system status.
uint16_t SEC_CORE1_FIFORead (uint16_t *pData, uint16_t wordCount)
This routine reads FIFO data sent from the SEC_CORE1.
uint16_t SEC_CORE1_FIFOWrite (uint16_t *pData, uint16_t wordCount)
This routine transfers FIFO data to SEC_CORE1.
static void SEC_CORE1_WriteFIFOEnable (void)
This inline function Enables the Write FIFO.
static void SEC_CORE1_WriteFIFODisable (void)
This inline function Disables the Write FIFO.
static void SEC_CORE1_ReadFIFOEnable (void)
This inline function Enables the Read FIFO.
static void SEC_CORE1_ReadFIFODisable (void)
This inline function Disables the Read FIFO.
static bool SEC_CORE1_FIFOReadIsFull (void)
This inline function checks whether the status of Read FIFO is full. last write by Secondary core to Read FIFO (RFDATA) was into the last free location.
static bool SEC_CORE1_FIFOReadIsEmpty (void)
This inline function checks whether the status of Read FIFO is Empty. Returns true if last read by Main core from Read FIFO (RFDATA) emptied the FIFO of all valid data or FIFO is disabled (and initialized to the empty state)
static bool SEC_CORE1_FIFOWriteIsFull (void)
This inline function checks whether the status of Write FIFO is Full. Returns true if last write by Main core to Write FIFO (WFDATA) was into the last free location.
static bool SEC_CORE1_FIFOWriteIsEmpty (void)
This inline function checks whether the status of Write FIFO is Empty. Returns true if last write by Main core to Write FIFO (WFDATA) was into the last free location.
bool SEC_CORE1_ProtocolWrite (enum SEC_CORE_PROTOCOLS protocolName, uint16_t *pData)
This routine writes data to mailbox.
bool SEC_CORE1_ProtocolRead (enum SEC_CORE_PROTOCOLS protocolName, uint16_t *pData)
This routine reads data from mailbox.
static bool SEC_CORE1_ProtocolIsFull (enum SEC_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is full. Returns true if new data are ready to read. Returns false when no data are available to be read by secondary.
static bool SEC_CORE1_ProtocolIsEmpty (enum SEC_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is empty. Returns true if Protocol is empty indicating mailbox is ready to write by secondary. Returns false indicating write operation cannot be performed by secondary.
void SEC_CORE1_ProtocolCallbackRegister (enum SEC_CORE_PROTOCOLS protocolName, void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 protocol event.
void SEC_CORE1_MSI1_ProtocolACallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_MSI1_ProtocolACallbackRegister.
void SEC_CORE1_MSI1_ProtocolBCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_MSI1_ProtocolBCallbackRegister.
void SEC_CORE1_ReadFIFODataReadyCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 ReadFIFODataReady event.
void SEC_CORE1_ReadFIFODataReadyCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_ReadFIFODataReadyCallbackRegister.
void SEC_CORE1_WriteFIFOEmptyCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 WriteFIFOEmpty event.
void SEC_CORE1_WriteFIFOEmptyCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_WriteFIFOEmptyCallbackRegister.
void SEC_CORE1_FIFOOverFLowUnderFlowCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 FIFOOverFLowUnderFlow event.
void SEC_CORE1_FIFOOverFLowUnderFlowCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_FIFOOverFLowUnderFlowCallbackRegister.
void SEC_CORE1_SecondaryInitiatedCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 SecondaryInitiated event.
void SEC_CORE1_SecondaryInitiatedCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_SecondaryInitiatedCallbackRegister.
void SEC_CORE1_SecondaryBreakCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 SecondaryBreak event.
void SEC_CORE1_SecondaryBreakCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_SecondaryBreakCallbackRegister.
void SEC_CORE1_SecondaryResetCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 SecondaryReset event.
void SEC_CORE1_SecondaryResetCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_SecondaryResetCallbackRegister.
Variables
const struct SEC_CORE_INTERFACE MSIInterface
Structure object of type SEC_CORE_INTERFACE with the custom name given by the user in the Melody Driver User interface. The default name e.g. Secondary1 can be changed by the user in the SEC_CORE user interface. This allows defining a structure with application specific name using the 'Custom Name' field. Application specific name allows the API Portability.
2.15.4.1.2 Function Documentation
SEC_CORE1_Deinitialize()
void SEC_CORE1_Deinitialize (void )
Deinitializes SEC_CORE1 to POR values.
none |
none |
SEC_CORE1_FIFOOverFLowUnderFlowCallback()
void SEC_CORE1_FIFOOverFLowUnderFlowCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_FIFOOverFLowUnderFlowCallbackRegister.
none |
none |
SEC_CORE1_FIFOOverFLowUnderFlowCallbackRegister()
void SEC_CORE1_FIFOOverFLowUnderFlowCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for SEC_CORE1 FIFOOverFLowUnderFlow event.
in | handler |
- Address of the callback function. |
none |
SEC_CORE1_FIFORead()
uint16_t SEC_CORE1_FIFORead (uint16_t * pData, uint16_t wordCount)
This routine reads FIFO data sent from the SEC_CORE1.
SEC_CORE1_ReadFIFOEnable should be called before calling this routine. |
in | *pData |
- Pointer to an array to store the read data |
in | wordCount |
- Number of words to be read. |
Number of words read. |
SEC_CORE1_FIFOReadIsEmpty()
inline static bool SEC_CORE1_FIFOReadIsEmpty (void )
This inline function checks whether the status of Read FIFO is Empty. Returns true if last read by Main core from Read FIFO (RFDATA) emptied the FIFO of all valid data or FIFO is disabled (and initialized to the empty state)
SEC_CORE1_FIFOReadIsFull()
inline static bool SEC_CORE1_FIFOReadIsFull (void )
This inline function checks whether the status of Read FIFO is full. last write by Secondary core to Read FIFO (RFDATA) was into the last free location.
SEC_CORE1_FIFOWrite()
uint16_t SEC_CORE1_FIFOWrite (uint16_t * pData, uint16_t wordCount)
This routine transfers FIFO data to SEC_CORE1.
SEC_CORE1_WriteFIFOEnable() should be called before calling this routine. |
in | *pData |
- Pointer to an array which has data for transmission. |
in | wordCount |
- Number of words to be transfer. |
Number of words transferred. |
SEC_CORE1_FIFOWriteIsEmpty()
inline static bool SEC_CORE1_FIFOWriteIsEmpty (void )
This inline function checks whether the status of Write FIFO is Empty. Returns true if last write by Main core to Write FIFO (WFDATA) was into the last free location.
SEC_CORE1_FIFOWriteIsFull()
inline static bool SEC_CORE1_FIFOWriteIsFull (void )
This inline function checks whether the status of Write FIFO is Full. Returns true if last write by Main core to Write FIFO (WFDATA) was into the last free location.
SEC_CORE1_GetResetCause()
enum SEC_CORE_RESET_CAUSE SEC_CORE1_GetResetCause (void )
This routine returns the cause for SEC_CORE1 reset.
none |
SECONDARY_RESET_CAUSE: Enum which provides the cause for SEC_CORE1 reset. |
SEC_CORE1_Initialize()
void SEC_CORE1_Initialize (void )
This routine initializes the MSI driver. This routine must be called before any other MSI routine is called. This routine should only be called once during system initialization.
none |
none |
SEC_CORE1_InterruptRequestAcknowledge()
void SEC_CORE1_InterruptRequestAcknowledge (void )
This routine acknowledges interrupt received from SEC_CORE1.
none |
none |
SEC_CORE1_InterruptRequestAcknowledgeComplete()
void SEC_CORE1_InterruptRequestAcknowledgeComplete (void )
This routine clears acknowledge for interrupt received from SEC_CORE1.
none |
none |
SEC_CORE1_InterruptRequestComplete()
void SEC_CORE1_InterruptRequestComplete (void )
This routine clears interrupt to SEC_CORE1.
none |
none |
SEC_CORE1_InterruptRequestGenerate()
void SEC_CORE1_InterruptRequestGenerate (void )
This routine generates interrupt to SEC_CORE1.
none |
none |
SEC_CORE1_IsInterruptRequestAcknowledged()
bool SEC_CORE1_IsInterruptRequestAcknowledged (void )
This routine returns the status of interrupt request acknowledge from the SEC_CORE1.
none |
True - when SEC_CORE1 has acknowledged Main MSI interrupt request. False - when SEC_CORE1 has not acknowledged Main MSI interrupt request. |
SEC_CORE1_IsInterruptRequested()
bool SEC_CORE1_IsInterruptRequested (void )
This routine returns the status of interrupt request from the SEC_CORE1.
none |
True - when SEC_CORE1 has issued interrupt to Main Core. False - when SEC_CORE1 has not issued interrupt to Main Core. |
SEC_CORE1_MSI1_ProtocolACallback()
void SEC_CORE1_MSI1_ProtocolACallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_MSI1_ProtocolACallbackRegister.
none |
none |
SEC_CORE1_MSI1_ProtocolBCallback()
void SEC_CORE1_MSI1_ProtocolBCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_MSI1_ProtocolBCallbackRegister.
none |
none |
SEC_CORE1_Program()
void SEC_CORE1_Program (void )
This routine programs secondary.
none |
none |
SEC_CORE1_ProtocolCallbackRegister()
void SEC_CORE1_ProtocolCallbackRegister (enum SEC_CORE_PROTOCOLS protocolName, void(*)(void) handler)
This function can be used to override default callback and to define custom callback for SEC_CORE1 protocol event.
in | protocolName |
- Selected protocol |
in | handler |
- Address of the callback function. |
none |
SEC_CORE1_ProtocolIsEmpty()
inline static bool SEC_CORE1_ProtocolIsEmpty (enum SEC_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is empty. Returns true if Protocol is empty indicating mailbox is ready to write by secondary. Returns false indicating write operation cannot be performed by secondary.
in | protocolName |
- Selected protocol |
true - Mailbox is empty false - Mailbox is full |
SEC_CORE1_ProtocolIsFull()
inline static bool SEC_CORE1_ProtocolIsFull (enum SEC_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is full. Returns true if new data are ready to read. Returns false when no data are available to be read by secondary.
in | protocolName |
- Selected protocol |
true - Mailbox is full false - Mailbox is empty |
SEC_CORE1_ProtocolRead()
bool SEC_CORE1_ProtocolRead (enum SEC_CORE_PROTOCOLS protocolName, uint16_t * pData)
This routine reads data from mailbox.
in | protocolName |
- Selected protocol |
in | *pData |
- Pointer to a structure to store the read data |
true - successful read false - unsuccessful read |
SEC_CORE1_ProtocolWrite()
bool SEC_CORE1_ProtocolWrite (enum SEC_CORE_PROTOCOLS protocolName, uint16_t * pData)
This routine writes data to mailbox.
in | protocolName |
- Selected protocol |
in | *pData |
- Pointer to a structure which has data for transmission. |
true - successful write false - unsuccessful write |
SEC_CORE1_ReadFIFODataReadyCallback()
void SEC_CORE1_ReadFIFODataReadyCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_ReadFIFODataReadyCallbackRegister.
none |
none |
SEC_CORE1_ReadFIFODataReadyCallbackRegister()
void SEC_CORE1_ReadFIFODataReadyCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for SEC_CORE1 ReadFIFODataReady event.
in | handler |
- Address of the callback function. |
none |
SEC_CORE1_ReadFIFODisable()
inline static void SEC_CORE1_ReadFIFODisable (void )
This inline function Disables the Read FIFO.
none |
none |
SEC_CORE1_ReadFIFOEnable()
inline static void SEC_CORE1_ReadFIFOEnable (void )
This inline function Enables the Read FIFO.
none |
none |
SEC_CORE1_ResetCauseClear()
void SEC_CORE1_ResetCauseClear (enum SEC_CORE_RESET_CAUSE resetCause)
This routine clears the cause for SEC_CORE1 reset.
SECONDARY_RESET_CAUSE: Enum which provides the cause for SEC_CORE1 reset. |
resetCause |
- reset to be cleared |
none |
SEC_CORE1_SecondaryBreakCallback()
void SEC_CORE1_SecondaryBreakCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_SecondaryBreakCallbackRegister.
none |
none |
SEC_CORE1_SecondaryBreakCallbackRegister()
void SEC_CORE1_SecondaryBreakCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for SEC_CORE1 SecondaryBreak event.
in | handler |
- Address of the callback function. |
none |
SEC_CORE1_SecondaryInitiatedCallback()
void SEC_CORE1_SecondaryInitiatedCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_SecondaryInitiatedCallbackRegister.
none |
none |
SEC_CORE1_SecondaryInitiatedCallbackRegister()
void SEC_CORE1_SecondaryInitiatedCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for SEC_CORE1 SecondaryInitiated event.
in | handler |
- Address of the callback function. |
none |
SEC_CORE1_SecondaryResetCallback()
void SEC_CORE1_SecondaryResetCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_SecondaryResetCallbackRegister.
none |
none |
SEC_CORE1_SecondaryResetCallbackRegister()
void SEC_CORE1_SecondaryResetCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for SEC_CORE1 SecondaryReset event.
in | handler |
- Address of the callback function. |
none |
SEC_CORE1_Start()
void SEC_CORE1_Start (void )
This routine enables secondary core.
none |
none |
SEC_CORE1_SystemStatusGet()
enum SEC_CORE_SYSTEM_STATUS SEC_CORE1_SystemStatusGet (void )
This routine returns Secondary system status.
none |
SEC_CORE_SYSTEM_STATUS: Enum which provides the status of SEC_CORE1. |
SEC_CORE1_WriteFIFODisable()
inline static void SEC_CORE1_WriteFIFODisable (void )
This inline function Disables the Write FIFO.
none |
none |
SEC_CORE1_WriteFIFOEmptyCallback()
void SEC_CORE1_WriteFIFOEmptyCallback (void )
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_WriteFIFOEmptyCallbackRegister.
none |
none |
SEC_CORE1_WriteFIFOEmptyCallbackRegister()
void SEC_CORE1_WriteFIFOEmptyCallbackRegister (void(*)(void) handler)
This function can be used to override default callback and to define custom callback for SEC_CORE1 WriteFIFOEmpty event.
in | handler |
- Address of the callback function. |
none |
SEC_CORE1_WriteFIFOEnable()
inline static void SEC_CORE1_WriteFIFOEnable (void )
This inline function Enables the Write FIFO.
none |
none |
2.15.4.1.3 Enumeration Type Documentation
SEC_CORE_PROTOCOL_SIZE
enum SEC_CORE_PROTOCOL_SIZE
Defines the size for Protocols.
Size not required for the driver but will be required for application to create the buffers
MSI1_ProtocolA_SIZE |
Size of ProtocolA in 16-bit word |
MSI1_ProtocolB_SIZE |
Size of ProtocolB in 16-bit word |
SEC_CORE_PROTOCOLS
enum SEC_CORE_PROTOCOLS
Defines the list of Protocols configured for SEC_CORE_driver.
These Protocols are required to create the buffer by the application
MSI1_ProtocolA |
Custom-name of ProtocolA for read operation only |
MSI1_ProtocolB |
Custom-name of ProtocolB for read operation only |
SEC_CORE_RESET_CAUSE
enum SEC_CORE_RESET_CAUSE
Defines the sec_core reset cause enumeration.
SEC_CORE_RESET_CAUSE_WATCHDOG |
sec_core reset caused from Watchdog Timer |
SEC_CORE_RESET_CAUSE_UNSPECIFIED |
sec_core reset cause is unspecified |
SEC_CORE_SYSTEM_STATUS
enum SEC_CORE_SYSTEM_STATUS
Defines the status enumeration for sec_core.
SEC_CORE_SYSTEM_STATUS_NOT_IN_LOW_POWER_MODE |
sec_core status is in Low power mode |
SEC_CORE_SYSTEM_STATUS_SLEEP_MODE |
sec_core status is in Sleep mode |
SEC_CORE_SYSTEM_STATUS_IDLE_MODE |
sec_core status is in Idle mode |
SEC_CORE_SYSTEM_STATUS_RUNNING_STATE |
sec_core status is in Running state |
SEC_CORE_SYSTEM_STATUS_IN_RESET_STATE |
sec_core status is in Reset state |
2.15.4.1.4 Variable Documentation
MSIInterface
const struct SEC_CORE_INTERFACE MSIInterface
Structure object of type SEC_CORE_INTERFACE with the custom name given by the user in the Melody Driver User interface. The default name e.g. Secondary1 can be changed by the user in the SEC_CORE user interface. This allows defining a structure with application specific name using the 'Custom Name' field. Application specific name allows the API Portability.
2.15.5 Class Documentation
2.15.5.1 SEC_CORE_INTERFACE Struct Reference
Structure containing the function pointers of SEC_CORE driver.
2.15.5.1.1 Detailed Description
Structure containing the function pointers of SEC_CORE driver.
#include <sec_core_interface.h>
Public Attributes
void(* Initialize )(void)
Pointer to SEC_COREx_Initialize e.g. SEC_CORE1_Initialize.
void(* Deinitialize )(void)
Pointer to SEC_COREx_Deinitialize e.g. SEC_CORE1_Deinitialize.
void(* Program )(void)
Pointer to SEC_COREx_Program e.g. SEC_CORE1_Program.
void(* Start )(void)
Pointer to SEC_COREx_Start e.g. SEC_CORE1_Start.
void(* InterruptRequestGenerate )(void)
Pointer to SEC_COREx_InterruptRequestGenerate e.g. SEC_CORE1_InterruptRequestGenerate.
bool(* IsInterruptRequestAcknowledged )(void)
Pointer to SEC_COREx_IsInterruptRequestAcknowledged e.g. SEC_CORE1_IsInterruptRequestAcknowledged.
void(* InterruptRequestComplete )(void)
Pointer to SEC_COREx_InterruptRequestComplete e.g. SEC_CORE1_InterruptRequestComplete.
bool(* IsInterruptRequested )(void)
Pointer to SEC_COREx_IsInterruptRequested e.g. SEC_CORE1_IsInterruptRequested.
void(* InterruptRequestAcknowledge )(void)
Pointer to SEC_COREx_InterruptRequestAcknowledge e.g. SEC_CORE1_InterruptRequestAcknowledge.
void(* InterruptRequestAcknowledgeComplete )(void)
Pointer to SEC_COREx_InterruptRequestAcknowledgeComplete e.g. SEC_CORE1_InterruptRequestAcknowledgeComplete.
enum SEC_CORE_RESET_CAUSE(* GetResetCause )(void)
Pointer to SEC_COREx_GetResetCause e.g. SEC_CORE1_GetResetCause.
void(* ResetCauseClear )(enum SEC_CORE_RESET_CAUSE resetCause)
Pointer to SEC_COREx_ResetCauseClear e.g. SEC_CORE1_ResetCauseClear.
enum SEC_CORE_SYSTEM_STATUS(* SystemStatusGet )(void)
Pointer to SEC_COREx_SystemStatusGet e.g. SEC_CORE1_SystemStatusGet.
void(* WriteFIFOEnable )(void)
Pointer to SEC_COREx_WriteFIFOEnable e.g. SEC_CORE1_WriteFIFOEnable.
void(* WriteFIFODisable )(void)
Pointer to SEC_COREx_WriteFIFODisable e.g. SEC_CORE1_WriteFIFODisable.
void(* ReadFIFOEnable )(void)
Pointer to SEC_COREx_ReadFIFOEnable e.g. SEC_CORE1_ReadFIFOEnable.
void(* ReadFIFODisable )(void)
Pointer to SEC_COREx_ReadFIFODisable e.g. SEC_CORE1_ReadFIFODisable.
uint16_t(* FIFORead )(uint16_t *pData, uint16_t wordCount)
Pointer to SEC_COREx_FIFORead e.g. SEC_CORE1_FIFORead.
uint16_t(* FIFOWrite )(uint16_t *pData, uint16_t wordCount)
Pointer to SEC_COREx_FIFOWrite e.g. SEC_CORE1_FIFOWrite.
bool(* FIFOReadIsFull )(void)
Pointer to SEC_COREx_FIFOReadIsFull e.g. SEC_CORE1_FIFOReadIsFull.
bool(* FIFOReadIsEmpty )(void)
Pointer to SEC_COREx_FIFOReadIsEmpty e.g. SEC_CORE1_FIFOReadIsEmpty.
bool(* FIFOWriteIsFull )(void)
Pointer to SEC_COREx_FIFOWriteIsFull e.g. SEC_CORE1_FIFOWriteIsFull.
bool(* FIFOWriteIsEmpty )(void)
Pointer to SEC_COREx_FIFOWriteIsEmpty e.g. SEC_CORE1_FIFOWriteIsEmpty.
bool(* ProtocolRead )(enum SEC_CORE_PROTOCOLS protocolName, uint16_t *pData)
Pointer to SEC_COREx_ProtocolRead e.g. SEC_CORE1_ProtocolRead.
bool(* ProtocolWrite )(enum SEC_CORE_PROTOCOLS protocolName, uint16_t *pData)
Pointer to SEC_COREx_ProtocolRead e.g. SEC_CORE1_ProtocolRead.
bool(* ProtocolIsFull )(enum SEC_CORE_PROTOCOLS protocolName)
Pointer to SEC_COREx_ProtocolIsFull e.g. SEC_CORE1_ProtocolIsFull.
bool(* ProtocolIsEmpty )(enum SEC_CORE_PROTOCOLS protocolName)
Pointer to SEC_COREx_ProtocolIsEmpty e.g. SEC_CORE1_ProtocolIsEmpty.
void(* ProtocolCallbackRegister )(enum SEC_CORE_PROTOCOLS protocolName, void(*handler)(void))
Pointer to SEC_COREx_ProtocolCallbackRegister e.g. SEC_CORE1_ProtocolCallbackRegister.
void(* ReadFIFODataReadyCallbackRegister )(void(*handler)(void))
Pointer to SEC_COREx_ReadFIFODataReadyCallbackRegister e.g. SEC_CORE1_ReadFIFODataReadyCallbackRegister.
void(* WriteFIFOEmptyCallbackRegister )(void(*handler)(void))
Pointer to SEC_COREx_WriteFIFOEmptyCallbackRegister e.g. SEC_CORE1_WriteFIFOEmptyCallbackRegister.
void(* FIFOOverFLowUnderFlowCallbackRegister )(void(*handler)(void))
Pointer to SEC_COREx_FIFOOverFLowUnderFlowCallbackRegister e.g. SEC_CORE1_FIFOOverFLowUnderFlowCallbackRegister.
void(* SecondaryInitiatedCallbackRegister )(void(*handler)(void))
Pointer to SEC_COREx_SecondaryInitiatedCallbackRegister e.g. SEC_CORE1_SecondaryInitiatedCallbackRegister.
void(* SecondaryBreakCallbackRegister )(void(*handler)(void))
Pointer to SEC_COREx_SecondaryBreakCallbackRegister e.g. SEC_CORE1_SecondaryBreakCallbackRegister.
void(* SecondaryResetCallbackRegister )(void(*handler)(void))
Pointer to SEC_COREx_SecondaryResetCallbackRegister e.g. SEC_CORE1_SecondaryResetCallbackRegister.
2.15.5.1.2 Member Data Documentation
The documentation for this struct was generated from the following file:
source/
Deinitialize
void(* Deinitialize) (void)
Pointer to SEC_COREx_Deinitialize e.g. SEC_CORE1_Deinitialize.
FIFOOverFLowUnderFlowCallbackRegister
void(* FIFOOverFLowUnderFlowCallbackRegister) (void(*handler)(void))
Pointer to SEC_COREx_FIFOOverFLowUnderFlowCallbackRegister e.g. SEC_CORE1_FIFOOverFLowUnderFlowCallbackRegister.
FIFORead
uint16_t(* FIFORead) (uint16_t *pData, uint16_t wordCount)
Pointer to SEC_COREx_FIFORead e.g. SEC_CORE1_FIFORead.
FIFOReadIsEmpty
bool(* FIFOReadIsEmpty) (void)
Pointer to SEC_COREx_FIFOReadIsEmpty e.g. SEC_CORE1_FIFOReadIsEmpty.
FIFOReadIsFull
bool(* FIFOReadIsFull) (void)
Pointer to SEC_COREx_FIFOReadIsFull e.g. SEC_CORE1_FIFOReadIsFull.
FIFOWrite
uint16_t(* FIFOWrite) (uint16_t *pData, uint16_t wordCount)
Pointer to SEC_COREx_FIFOWrite e.g. SEC_CORE1_FIFOWrite.
FIFOWriteIsEmpty
bool(* FIFOWriteIsEmpty) (void)
Pointer to SEC_COREx_FIFOWriteIsEmpty e.g. SEC_CORE1_FIFOWriteIsEmpty.
FIFOWriteIsFull
bool(* FIFOWriteIsFull) (void)
Pointer to SEC_COREx_FIFOWriteIsFull e.g. SEC_CORE1_FIFOWriteIsFull.
GetResetCause
enum SEC_CORE_RESET_CAUSE(* GetResetCause) (void)
Pointer to SEC_COREx_GetResetCause e.g. SEC_CORE1_GetResetCause.
Initialize
void(* Initialize) (void)
Pointer to SEC_COREx_Initialize e.g. SEC_CORE1_Initialize.
InterruptRequestAcknowledge
void(* InterruptRequestAcknowledge) (void)
Pointer to SEC_COREx_InterruptRequestAcknowledge e.g. SEC_CORE1_InterruptRequestAcknowledge.
InterruptRequestAcknowledgeComplete
void(* InterruptRequestAcknowledgeComplete) (void)
Pointer to SEC_COREx_InterruptRequestAcknowledgeComplete e.g. SEC_CORE1_InterruptRequestAcknowledgeComplete.
InterruptRequestComplete
void(* InterruptRequestComplete) (void)
Pointer to SEC_COREx_InterruptRequestComplete e.g. SEC_CORE1_InterruptRequestComplete.
InterruptRequestGenerate
void(* InterruptRequestGenerate) (void)
Pointer to SEC_COREx_InterruptRequestGenerate e.g. SEC_CORE1_InterruptRequestGenerate.
IsInterruptRequestAcknowledged
bool(* IsInterruptRequestAcknowledged) (void)
Pointer to SEC_COREx_IsInterruptRequestAcknowledged e.g. SEC_CORE1_IsInterruptRequestAcknowledged.
IsInterruptRequested
bool(* IsInterruptRequested) (void)
Pointer to SEC_COREx_IsInterruptRequested e.g. SEC_CORE1_IsInterruptRequested.
Program
void(* Program) (void)
Pointer to SEC_COREx_Program e.g. SEC_CORE1_Program.
ProtocolCallbackRegister
void(* ProtocolCallbackRegister) (enum SEC_CORE_PROTOCOLS protocolName, void(*handler)(void))
Pointer to SEC_COREx_ProtocolCallbackRegister e.g. SEC_CORE1_ProtocolCallbackRegister.
ProtocolIsEmpty
bool(* ProtocolIsEmpty) (enum SEC_CORE_PROTOCOLS protocolName)
Pointer to SEC_COREx_ProtocolIsEmpty e.g. SEC_CORE1_ProtocolIsEmpty.
ProtocolIsFull
bool(* ProtocolIsFull) (enum SEC_CORE_PROTOCOLS protocolName)
Pointer to SEC_COREx_ProtocolIsFull e.g. SEC_CORE1_ProtocolIsFull.
ProtocolRead
bool(* ProtocolRead) (enum SEC_CORE_PROTOCOLS protocolName, uint16_t *pData)
Pointer to SEC_COREx_ProtocolRead e.g. SEC_CORE1_ProtocolRead.
ProtocolWrite
bool(* ProtocolWrite) (enum SEC_CORE_PROTOCOLS protocolName, uint16_t *pData)
Pointer to SEC_COREx_ProtocolRead e.g. SEC_CORE1_ProtocolRead.
ReadFIFODataReadyCallbackRegister
void(* ReadFIFODataReadyCallbackRegister) (void(*handler)(void))
Pointer to SEC_COREx_ReadFIFODataReadyCallbackRegister e.g. SEC_CORE1_ReadFIFODataReadyCallbackRegister.
ReadFIFODisable
void(* ReadFIFODisable) (void)
Pointer to SEC_COREx_ReadFIFODisable e.g. SEC_CORE1_ReadFIFODisable.
ReadFIFOEnable
void(* ReadFIFOEnable) (void)
Pointer to SEC_COREx_ReadFIFOEnable e.g. SEC_CORE1_ReadFIFOEnable.
ResetCauseClear
void(* ResetCauseClear) (enum SEC_CORE_RESET_CAUSE resetCause)
Pointer to SEC_COREx_ResetCauseClear e.g. SEC_CORE1_ResetCauseClear.
SecondaryBreakCallbackRegister
void(* SecondaryBreakCallbackRegister) (void(*handler)(void))
Pointer to SEC_COREx_SecondaryBreakCallbackRegister e.g. SEC_CORE1_SecondaryBreakCallbackRegister.
SecondaryInitiatedCallbackRegister
void(* SecondaryInitiatedCallbackRegister) (void(*handler)(void))
Pointer to SEC_COREx_SecondaryInitiatedCallbackRegister e.g. SEC_CORE1_SecondaryInitiatedCallbackRegister.
SecondaryResetCallbackRegister
void(* SecondaryResetCallbackRegister) (void(*handler)(void))
Pointer to SEC_COREx_SecondaryResetCallbackRegister e.g. SEC_CORE1_SecondaryResetCallbackRegister.
Start
void(* Start) (void)
Pointer to SEC_COREx_Start e.g. SEC_CORE1_Start.
SystemStatusGet
enum SEC_CORE_SYSTEM_STATUS(* SystemStatusGet) (void)
Pointer to SEC_COREx_SystemStatusGet e.g. SEC_CORE1_SystemStatusGet.
WriteFIFODisable
void(* WriteFIFODisable) (void)
Pointer to SEC_COREx_WriteFIFODisable e.g. SEC_CORE1_WriteFIFODisable.
WriteFIFOEmptyCallbackRegister
void(* WriteFIFOEmptyCallbackRegister) (void(*handler)(void))
Pointer to SEC_COREx_WriteFIFOEmptyCallbackRegister e.g. SEC_CORE1_WriteFIFOEmptyCallbackRegister.
WriteFIFOEnable
void(* WriteFIFOEnable) (void)
Pointer to SEC_COREx_WriteFIFOEnable e.g. SEC_CORE1_WriteFIFOEnable.
2.15.6 File Documentation
2.15.6.1 source/sec_core1.h File Reference
This is the generated driver header file for the SEC_CORE1 driver.
#include <xc.h> #include <stdint.h> #include <stdbool.h> #include "sec_core_types.h" #include "sec_core_interface.h"
2.15.6.1.1 Functions
void SEC_CORE1_Initialize (void)
This routine initializes the MSI driver. This routine must be called before any other MSI routine is called. This routine should only be called once during system initialization.
void SEC_CORE1_Deinitialize (void)
Deinitializes SEC_CORE1 to POR values.
void SEC_CORE1_Start (void)
This routine enables secondary core.
void SEC_CORE1_Program (void)
This routine programs secondary.
void SEC_CORE1_InterruptRequestGenerate (void)
This routine generates interrupt to SEC_CORE1.
bool SEC_CORE1_IsInterruptRequestAcknowledged (void)
This routine returns the status of interrupt request acknowledge from the SEC_CORE1.
void SEC_CORE1_InterruptRequestComplete (void)
This routine clears interrupt to SEC_CORE1.
bool SEC_CORE1_IsInterruptRequested (void)
This routine returns the status of interrupt request from the SEC_CORE1.
void SEC_CORE1_InterruptRequestAcknowledge (void)
This routine acknowledges interrupt received from SEC_CORE1.
void SEC_CORE1_InterruptRequestAcknowledgeComplete (void)
This routine clears acknowledge for interrupt received from SEC_CORE1.
enum SEC_CORE_RESET_CAUSE SEC_CORE1_GetResetCause (void)
This routine returns the cause for SEC_CORE1 reset.
void SEC_CORE1_ResetCauseClear (enum SEC_CORE_RESET_CAUSE resetCause)
This routine clears the cause for SEC_CORE1 reset.
enum SEC_CORE_SYSTEM_STATUS SEC_CORE1_SystemStatusGet (void)
This routine returns Secondary system status.
uint16_t SEC_CORE1_FIFORead (uint16_t *pData, uint16_t wordCount)
This routine reads FIFO data sent from the SEC_CORE1.
uint16_t SEC_CORE1_FIFOWrite (uint16_t *pData, uint16_t wordCount)
This routine transfers FIFO data to SEC_CORE1.
static void SEC_CORE1_WriteFIFOEnable (void)
This inline function Enables the Write FIFO.
static void SEC_CORE1_WriteFIFODisable (void)
This inline function Disables the Write FIFO.
static void SEC_CORE1_ReadFIFOEnable (void)
This inline function Enables the Read FIFO.
static void SEC_CORE1_ReadFIFODisable (void)
This inline function Disables the Read FIFO.
static bool SEC_CORE1_FIFOReadIsFull (void)
This inline function checks whether the status of Read FIFO is full. last write by Secondary core to Read FIFO (RFDATA) was into the last free location.
static bool SEC_CORE1_FIFOReadIsEmpty (void)
This inline function checks whether the status of Read FIFO is Empty. Returns true if last read by Main core from Read FIFO (RFDATA) emptied the FIFO of all valid data or FIFO is disabled (and initialized to the empty state)
static bool SEC_CORE1_FIFOWriteIsFull (void)
This inline function checks whether the status of Write FIFO is Full. Returns true if last write by Main core to Write FIFO (WFDATA) was into the last free location.
static bool SEC_CORE1_FIFOWriteIsEmpty (void)
This inline function checks whether the status of Write FIFO is Empty. Returns true if last write by Main core to Write FIFO (WFDATA) was into the last free location.
bool SEC_CORE1_ProtocolWrite (enum SEC_CORE_PROTOCOLS protocolName, uint16_t *pData)
This routine writes data to mailbox.
bool SEC_CORE1_ProtocolRead (enum SEC_CORE_PROTOCOLS protocolName, uint16_t *pData)
This routine reads data from mailbox.
static bool SEC_CORE1_ProtocolIsFull (enum SEC_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is full. Returns true if new data are ready to read. Returns false when no data are available to be read by secondary.
static bool SEC_CORE1_ProtocolIsEmpty (enum SEC_CORE_PROTOCOLS protocolName)
This inline function checks whether mailbox is empty. Returns true if Protocol is empty indicating mailbox is ready to write by secondary. Returns false indicating write operation cannot be performed by secondary.
void SEC_CORE1_ProtocolCallbackRegister (enum SEC_CORE_PROTOCOLS protocolName, void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 protocol event.
void SEC_CORE1_MSI1_ProtocolACallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_MSI1_ProtocolACallbackRegister.
void SEC_CORE1_MSI1_ProtocolBCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_MSI1_ProtocolBCallbackRegister.
void SEC_CORE1_ReadFIFODataReadyCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 ReadFIFODataReady event.
void SEC_CORE1_ReadFIFODataReadyCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_ReadFIFODataReadyCallbackRegister.
void SEC_CORE1_WriteFIFOEmptyCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 WriteFIFOEmpty event.
void SEC_CORE1_WriteFIFOEmptyCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_WriteFIFOEmptyCallbackRegister.
void SEC_CORE1_FIFOOverFLowUnderFlowCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 FIFOOverFLowUnderFlow event.
void SEC_CORE1_FIFOOverFLowUnderFlowCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_FIFOOverFLowUnderFlowCallbackRegister.
void SEC_CORE1_SecondaryInitiatedCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 SecondaryInitiated event.
void SEC_CORE1_SecondaryInitiatedCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_SecondaryInitiatedCallbackRegister.
void SEC_CORE1_SecondaryBreakCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 SecondaryBreak event.
void SEC_CORE1_SecondaryBreakCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_SecondaryBreakCallbackRegister.
void SEC_CORE1_SecondaryResetCallbackRegister (void(*handler)(void))
This function can be used to override default callback and to define custom callback for SEC_CORE1 SecondaryReset event.
void SEC_CORE1_SecondaryResetCallback (void)
This is the default callback with weak attribute. The user can override and implement the default callback without weak attribute or can register a custom callback function using SEC_CORE1_SecondaryResetCallbackRegister.
2.15.6.1.2 Variables
const struct SEC_CORE_INTERFACE MSIInterface
Structure object of type SEC_CORE_INTERFACE with the custom name given by the user in the Melody Driver User interface. The default name e.g. Secondary1 can be changed by the user in the SEC_CORE user interface. This allows defining a structure with application specific name using the 'Custom Name' field. Application specific name allows the API Portability.
2.15.6.1.3 Detailed Description
This is the generated driver header file for the SEC_CORE1 driver.
SEC_CORE1 Generated Driver Header File
2.15.6.2 source/sec_core_interface.h File Reference
#include <stddef.h> #include <stdint.h> #include <stdbool.h> #include "sec_core_types.h"
2.15.6.2.1 Data structures
struct SEC_CORE_INTERFACE
Structure containing the function pointers of SEC_CORE driver.
2.15.6.2.2 Detailed Description
SEC_CORE Generated Driver Interface Header File
2.15.6.3 source/sec_core_types.h File Reference
This is the generated driver types header file for the SEC_CORE driver.
2.15.6.3.1 Enumerations
enum SEC_CORE_SYSTEM_STATUS { SEC_CORE_SYSTEM_STATUS_NOT_IN_LOW_POWER_MODE = 0, SEC_CORE_SYSTEM_STATUS_SLEEP_MODE = 1, SEC_CORE_SYSTEM_STATUS_IDLE_MODE = 2, SEC_CORE_SYSTEM_STATUS_RUNNING_STATE = 3, SEC_CORE_SYSTEM_STATUS_IN_RESET_STATE = 4 }
Defines the status enumeration for sec_core.
enum SEC_CORE_RESET_CAUSE { SEC_CORE_RESET_CAUSE_WATCHDOG = 0, SEC_CORE_RESET_CAUSE_UNSPECIFIED = 1 }
Defines the sec_core reset cause enumeration.
enum SEC_CORE_PROTOCOLS { MSI1_ProtocolA, MSI1_ProtocolB }
Defines the list of Protocols configured for SEC_CORE_driver.
enum SEC_CORE_PROTOCOL_SIZE { MSI1_ProtocolA_SIZE = 1, MSI1_ProtocolB_SIZE = 1 }
Defines the size for Protocols.
2.15.6.3.2 Detailed Description
This is the generated driver types header file for the SEC_CORE driver.
SEC_CORE Generated Driver Types Header File