Component: CAN (CAL) (Misc)

Author	Matrix TSL
Version	2.4
Category	Misc

CAN component

CAL = Code Abstraction Layer - Allows one code base to run on a wide range of chips. Low level routines for controling the internal CAN peripheral.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_CAN.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_CAN.fcfx

Detailed description

No detailed description exists yet for this component

Examples

Example showing how to build a component using a CAL component Using CAL Components.

Macro reference

CheckRx

	CheckRx
Checks to see if any messages are available for 'Buffer' specified
- BYTE	Buffer
Send buffer: 0 to 1
- BYTE	Return

GetList

	GetList
Get the Filter List of the Named Property
- STRING	Name
- STRING	Return

GetRxData

	GetRxData
Returns the data byte at index from the buffer specified
- BYTE	buffer
The index of the required buffer
- BYTE	index
The index of the required data byte in the buffer
- BYTE	Return

GetRxDataCount

	GetRxDataCount
Returns the number of valid data bytes in the buffer
- BYTE	buffer
The index of the required buffer
- BYTE	Return

GetRxIdent

	GetRxIdent
Generic function to get the received message Identifier.
- BYTE	buffer
- ULONG	Return

GetValue

	GetValue
Get the Value of the Named property
- STRING	Name
- STRING	Return

Init

	Init
Must be called at least once and after every Uninit call to enable the CAN instance
- VOID	Return

InitRXConfig

	InitRXConfig
Initialization setting for RX Buffer Config
- BYTE	Buffer
Buffer Number (0 or 1)
- BYTE	Value
Config data byte
- VOID	Return

InitRXFilter

	InitRXFilter
Initialization setting for RX Filter
- BYTE	Filter
- ULONG	Value
- VOID	Return

InitRXMask

	InitRXMask
Initialization setting for RX Mask
- BYTE	Mask
Mask Number (0 or 1)
- ULONG	Value
- VOID	Return

InitTXBuffer

	InitTXBuffer
Initialization settings for TX Buffers
- BYTE	Buffer
TX Buffer ID = 0,1 or 2
- ULONG	ID
CAN Address
- BYTE	Length
Number of bytes to send
- STRING	Data
Data Array (of Length bytes)
- VOID	Return

SendBuffer

	SendBuffer
Sends the contents of the buffer previously filled with Set_TX_... calls
- BYTE	Buffer
Send buffer: 0 to,2
- VOID	Return

SetRxFilter

	SetRxFilter
Generic function to set Identifier. CAN registers will be configured depending upon Std/Ext mode setting.
- BYTE	filter
- ULONG	id
- VOID	Return

SetRxFilterExd

	SetRxFilterExd
Sets the 32-bit filter as a bit-mask of the extended ID for received messages The messages are accepted if (ExtID & Mask) == Filter
- BYTE	Filter
Send filter: 0 to 3
- BYTE	ID3
The high byte (bits 24-31) of the ID
- BYTE	ID2
The mid-high byte (bits 16-23) of the ID
- BYTE	ID1
The mid-low byte (bits 8-15) of the ID
- BYTE	ID0
The low byte (bits 0-7) of the ID
- VOID	Return

SetRxFilterStd

	SetRxFilterStd
Sets the 16-bit filter as a bit-mask of the standard ID for received messages The messages are accepted if (StdID & Mask) == Filter
- BYTE	Filter
Filter number
- BYTE	Hi
The high byte (bits 8-15) of the ID
- BYTE	Lo
The low byte (bits 0-7) of the ID
- VOID	Return

SetRxMask

	SetRxMask
Generic function to set Identifier. CAN registers will be configured depending upon Std/Ext mode setting.
- BYTE	mask
- ULONG	id
- VOID	Return

SetRxMaskExd

	SetRxMaskExd
Sets the 32-bit filter as a bit-mask of the extended ID for received messages The messages are accepted if (ExtID & Mask) == Filter
- BYTE	Mask
Mask 0 or 1
- BYTE	ID3
The high byte (bits 24-31) of the ID
- BYTE	ID2
The mid-high byte (bits 16-23) of the ID
- BYTE	ID1
The mid-low byte (bits 8-15) of the ID
- BYTE	ID0
The low byte (bits 0-7) of the ID
- VOID	Return

SetRxMaskStd

	SetRxMaskStd
Sets the 16-bit filter as a bit-mask of the standard ID for received messages The messages are accepted if (StdID & Mask) == Filter
- BYTE	Mask
Mask number
- BYTE	Hi
The high byte (bits 8-15) of the ID
- BYTE	Lo
The low byte (bits 0-7) of the ID
- VOID	Return

SetTxData

	SetTxData
Sets the CAN transmit data for the buffer specified (0, 1 or 2). The count parameter Data_Cnt indicates the number of valid data bytes. D0 to D7 are the payload data bytes to be loaded into the transmit buffer.
- BYTE	Buffer
Send buffer: 0 to,2
- BYTE	Data_Cnt
The number of bytes of data to add, 0 to 8
- BYTE	D0
Data byte 0 to add
- BYTE	D1
Data byte 1 to add
- BYTE	D2
Data byte 2 to add
- BYTE	D3
Data byte 3 to add
- BYTE	D4
Data byte 4 to add
- BYTE	D5
Data byte 5 to add
- BYTE	D6
Data byte 6 to add
- BYTE	D7
Data byte 7 to add
- VOID	Return

SetTxIdent

	SetTxIdent
Generic function to set Identifier. CAN registers will be configured depending upon Std/Ext mode setting.
- BYTE	buffer
- ULONG	id
- VOID	Return

SetTxIdentExd

	SetTxIdentExd
Sets the optional 32-bit ID to send along with the standard ID and data in the next CAN message
- BYTE	Buffer
Send buffer: 0 to,2
- BYTE	ID3
The high byte (bits 24-31) of the ID
- BYTE	ID2
The mid-high byte (bits 16-23) of the ID
- BYTE	ID1
The mid-low byte (bits 8-15) of the ID
- BYTE	ID0
The low byte (bits 0-7) of the ID
- VOID	Return

SetTxIdentStd

	SetTxIdentStd
Sets the ID to send along with the data in the next CAN message
- BYTE	Buffer
Send buffer: 0 to,2
- BYTE	Hi
The high byte (bits 8-15) of the ID
- BYTE	Lo
The low byte (bits 0-7) of the ID
- VOID	Return

SetValue

	SetValue
Set the Value of the Named property
- STRING	Name
- STRING	Value
- VOID	Return

Uninit

	Uninit
Uninitialises the CAN, freeing its connections for general use
- VOID	Return

Property reference

	Properties
	Channel
Selects the CAN channel to be used
	TX Pin
	RX Pin
	TX Remap
	RX Remap
	Bus Rate
selects the Bus Rate (KHz)
	Sample Point
selects the Sample Point for bit reading
	SJW
Synchronization Jump Width adjusts the bit clock by 1 to 4 TQ periods
	Fosc
	BRGCON1
	BRGCON2
	BRGCON3
	ID Type
selects the CAN ID type
	TX Buffer 0
	Message ID
CAN Message ID for Transmit Buffer 0
	Length
Number of valid data bytes in the message
	D0
Data byte 0
	D1
Data byte 1
	D2
Data byte 2
	D3
Data byte 3
	D4
Data byte 4
	D5
Data byte 5
	D6
Data byte 6
	D7
Data byte 7
	TX Buffer 1
	Message ID
CAN Message ID for Transmit Buffer 1
	Length
Number of valid data bytes in the message
	D0
Data byte 0
	D1
Data byte 1
	D2
Data byte 2
	D3
Data byte 3
	D4
Data byte 4
	D5
Data byte 5
	D6
Data byte 6
	D7
Data byte 7
	TX Buffer 2
	Message ID
CAN Message ID for Transmit Buffer 2
	Length
Number of valid data bytes in the message
	D0
Data byte 0
	D1
Data byte 1
	D2
Data byte 2
	D3
Data byte 3
	D4
Data byte 4
	D5
Data byte 5
	D6
Data byte 6
	D7
Data byte 7
	RX Buffer 0
	Settings
Filter setting for Receive Buffer 0
	Mask
Value for Receive Mask 0
	Filter 0
Value for Filter 0
	Filter 1
Value for Filter 1
	RX Buffer 1
	Settings
Filter setting for Receive Buffer 1
	Mask
Value for Receive Mask 1
	Filter 2
Value for Filter 2
	Filter 3
Value for Filter 3
	Filter 4
Value for Filter 4
	Filter 5
Value for Filter 5