AN1105 STMicroelectronics, AN1105 Datasheet - Page 26

• Manufacturer Part Number: AN1105
• Description: ST7 PCAN PERIPHERAL DRIVER
• Manufacturer: STMicroelectronics

ST7 pCAN PERIPHERAL DRIVER
If DEBUG is defined, you can then chose to add the following options:
//#define GENERAL_RECEPTION_ERROR
All reception errors trigger an interrupt. You CANNOT use this option and the Status Change
Notification function together because both use the same IT flag. This option does not exclude
the bus Wake-Up feature.
//#define SIMULTANEOUS_EMISSION_RECEPTION
Only if Debug is also defined.
This function is used for forcing the cell to simultaneously send and receive any message it is
ordered to transmit to check the hardware integrity of the CAN transceiver and controller.
2.1.5.5 Can_custom.c File
This is a source file you have to complete, to allow your application to react on hardware
events as they happen. An example of implementation is given in
Section 2.2.3 "Implementing
the Notification
Functions".
Functions called unconditionally
CAN_Buffer* CAN_Request_Buffer(u16 ident_of_message)
This function is called unconditionally when a new data message is available in the hardware
buffer of the cell. This function has to be completed to return a pointer on a buffer structure. To
ignore it, return NULL. To help you to manage your reception buffer(s), the ID of the message
is passed as a parameter.
void CAN_Remote_Reception_Notification(u16 ident_of_remote)
This function is called unconditionally when a remote message has been saved in a hardware
buffer. Its ID is passed as a parameter for a quick answer.
void CAN_Data_Reception_Notification(u16 message_ident)
This function is called unconditionally when a data message has been successfully saved in a
software buffer supplied by the application. Its ID is passed as a parameter.
void CAN_Transmission_Notification(void)
This function is called unconditionally upon the successful transmission of a message.
Functions called conditionally
The following functions are called only if the corresponding option is set in can_custom.h.
void CAN_Dominant_Bit_Reception_Notification(void)
This function is called upon reception of a dominant bit while in Standby mode, if the
RUN_ON_STARTUP option was not defined in can_custom.h. The corresponding interrupt
will be accepted only once. Then its acceptance flag will be cleared.
void CAN_Bus_Passive_Notification(void)
void CAN_Bus_Active_Notification(void)
26/100