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.
Downloadable macro reference
|
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
|
|
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
|
|
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
|
|
SetRxMask
|
Generic function to set Identifier. CAN registers will be configured depending upon Std/Ext mode setting.
|
- BYTE
|
mask
|
|
- ULONG
|
id
|
|
- VOID
|
Return
|
|
GetValue
|
Get the Value of the Named property
|
- STRING
|
Name
|
|
- STRING
|
Return
|
|
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
|
|
InitRXMask
|
Initialization setting for RX Mask
|
- BYTE
|
Mask
|
Mask Number (0 or 1)
|
- ULONG
|
Value
|
|
- VOID
|
Return
|
|
SendBuffer
|
Sends the contents of the buffer previously filled with Set_TX_... calls
|
- BYTE
|
Buffer
|
Send buffer: 0 to,2
|
- VOID
|
Return
|
|
InitRXFilter
|
Initialization setting for RX Filter
|
- BYTE
|
Filter
|
|
- ULONG
|
Value
|
|
- VOID
|
Return
|
|
GetRxDataCount
|
Returns the number of valid data bytes in the buffer
|
- BYTE
|
buffer
|
The index of the required buffer
|
- BYTE
|
Return
|
|
Init
|
Must be called at least once and after every Uninit call to enable the CAN instance
|
- VOID
|
Return
|
|
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
|
|
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
|
|
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
|
|
SetValue
|
Set the Value of the Named property
|
- STRING
|
Name
|
|
- STRING
|
Value
|
|
- VOID
|
Return
|
|
SetRxFilter
|
Generic function to set Identifier. CAN registers will be configured depending upon Std/Ext mode setting.
|
- BYTE
|
filter
|
|
- ULONG
|
id
|
|
- VOID
|
Return
|
|
SetTxIdent
|
Generic function to set Identifier. CAN registers will be configured depending upon Std/Ext mode setting.
|
- BYTE
|
buffer
|
|
- ULONG
|
id
|
|
- VOID
|
Return
|
|
CheckRx
|
Checks to see if any messages are available for 'Buffer' specified
|
- BYTE
|
Buffer
|
Send buffer: 0 to 1
|
- BYTE
|
Return
|
|
InitRXConfig
|
Initialization setting for RX Buffer Config
|
- BYTE
|
Buffer
|
Buffer Number (0 or 1)
|
- BYTE
|
Value
|
Config data byte
|
- VOID
|
Return
|
|
Uninit
|
Uninitialises the CAN, freeing its connections for general use
|
- VOID
|
Return
|
|
GetList
|
Get the Filter List of the Named Property
|
- STRING
|
Name
|
|
- STRING
|
Return
|
|
GetRxIdent
|
Generic function to get the received message Identifier.
|
- BYTE
|
buffer
|
|
- ULONG
|
Return
|
|
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
|
|
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
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
Connections
|
|
Simulations
|
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
|