UM0459

Using the ST10F27xZx CAN Library

5/29

1

Using the ST10F27xZx CAN Library

1.1

Library content

The ST10F27xZx CAN library is a software package consisting of a zip file containing the

following folders:

●

Library containing the C source and header files.

–

st10f27x_can.c C source file containing the C source of the library functions

–

st10f27_can.h: header file containing the function prototypes and the CAN

interface definitions

–

st10F27x_types.h: header files containing the definition of data types used by the

library.

●

Example folder with two examples on how to use the CAN library functions. Polling and

interrupt examples are provided.

CAN cell access is made using pointers to the CAN cell addresses. This makes the library

compatible with both Keil and Tasking. The provided examples are compiled and tested

under Tasking toolchain. Applications can be ported easily to the Keil toolchain.

1.2

How to install the ST10F27xZx CAN Library

The ST10F27xZx CAN library is delivered as an archive file with .zip extension. To install the

CAN library, the user needs to unzip the file in the directory where the library has to be

copied.

1.3

Getting started with the library

To use the CAN library, the user should include the st10f27x_can.h header file.

The two CAN interfaces are accessed using the structure pointing to their addresses. CAN

and IF interface definitions are located in st10f27x_can.h. When calling the CAN library

functions, the user should use the CAN1 or CAN2 parameter.

The user should pay attention to the bitrate configuration: if the application environment is

different from the library conditions, the user should recalculate the seg1, seg2,brp and sjw

CAN bit timing parameters. This is the case when ST10 frequency = 40 MHz and the CAN

clock input is derived from the clock generator divided by 2 (see XMISC register).

For more details, please refer to the CAN bit timing configuration in the ST10F27xZx user

manual.

The CAN input/output pins must be configured by the user before using the CAN library.