XXX_Open

Description

This function marks the given CAN device as used, e.g. it locks the device. The return value is the identifier of the device and must be used for further actions with this device.

Prototype

CPU_INT16S	XXX_Open(CPU_INT16S  drv, 
                     CPU_INT32U  devName,
                     CPU_INT16U  mode);

Parameter

Meaning

drv

bus node name which must be used by the interrupt routine to access the can bus layer.

devName

device name which indicates the device within the controller

mode

not used

Return Value

Device identifier for success or -1 if an error occurs.

Note

Separation of bus node from driver device is necessary when different CAN modules are used, i.e. on a processor with integrated CAN module and also external CAN module(s).

Example: On a MPC565 processor TouCAN A, B, C are used and also 3 external SJA1000 CAN modules. Then 6 CAN nodes are available, but driver devices from TouCAN range 0-2 and driver devices from SJA1000 do also range from 0-2. To get unique device identification the bus node name is used. (see also Configure the CAN Bus)