AN1105 datasheet(19/100 Pages) STMICROELECTRONICS

19 / 100 page

19/100

ST7 pCAN PERIPHERAL DRIVER

– Error ITs are only processed if the DEBUG option was chosen in can_custom.h. Then, the

application is notified of any other events through function calls. (Functions entered in

can_custom.c).

2.1.5 User Interface Description

This section describes the user interface in a “black-box” way. The parameters and the return

values of the function declared in can.h and can_custom.h are described in this section. For a

complete description of the algorithms and internal data type variables, please see Section 3

"Detailed Description".

2.1.5.1 Data-type Variables

CAN_Buffer -type variables

typedef struct CAN_Buffer{

u16msg_identifier;

CAN_Data_Size data_size;

u8 CAN_msg_data[CAN_MAX_DATA_SIZE];

CAN_Bool buffer_rw;

CAN_Bool buffer_free;

}CAN_Buffer;

Software representation of CAN data. The translation into hardware buffers is performed by

the driver.

A variable of this data-type must be passed to the driver each time it is requested by the

CAN_Request_Buffer notification function (See “Functions called unconditionally” on

page 26). Otherwise, data in the hardware buffer will be lost.

A pointer to this structure is also used as parameter of the CAN_Transmit_Request function

(See “Functions” on page 21).

–

msg_identifier: 2 bytes field containing the identifier of the CAN message. The identifier is

stored in the 12 most significant bits. The 4 least significant bits MUST be zero. The u16

type means 2 bytes unsigned variable and is defined in lib.h.

–

data_size: 1 byte field containing the length of the data in the message (in bytes). The

CAN_Data_Size type is an enum type (See below for its description).

–

CAN_msg_data: array of 8 bytes containing the data to be sent. The u8u16 type means 1

byte unsigned variable and is defined in lib.h.

–

buffer_rw: this boolean variable is to be used as a flag to prevent simultaneous writing/

reading on the structure. It is checked and modified by the driver each time an operation

is being performed on the buffer. If CTRUE, the structure will not be read or written. If

CFALSE, it can be used. Always check/modify this variable in your application for this pur-

pose.

–

buffer_free: boolean variable used to mark if the data in the buffer can be overwritten or

not. It has to be used as the security by the user’s application. If CFALSE, the driver will

refuse to perform any write operation on the data in the structure and return an error code.

AN1105 датащи(PDF) 19 Page - STMicroelectronics

AN1105 датащи(HTML) 19 Page - STMicroelectronics

Html Pages

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100

датащи скачать

ссылки URL