Component: Injector (CAN) ()
| Author | Matrix Ltd |
| Version | 1.0 |
| Category |
Injector (CAN) component
Comms data injector to allow CAN message identifiers to be decoded to specific message strings. Uses an external CSV file to specify the IDs and descriptive strings.
Component Source Code
Please click here to download the component source project: FC_Comp_Source_InjectorCAN.fcfx
Please click here to view the component source code (Beta): FC_Comp_Source_InjectorCAN.fcfx
Detailed description
No detailed description exists yet for this component
Examples
The CAN component works together with the injector component to allow you to decode a CAN message ID into a meaningful command.
Example File
CAN_Example1
When a key on the keypad is pressed the CAN components transmits a CAN packet.
The CAN packet is decoded by the injector component to give us a meaningful log on the console window.
High Level CAN Data Console
Low Level CAN Data Console
Reference from CAN Injector to ID decode file, $(srcdir) refers to the current project directory.
Demo CAN ID file File:CANID.csv
Macro reference
|
InitialiseInjector |
| Sets up the injector ready to receive commands or send data | |
 - STRING
|
InjectorName |
| Name of the console that will be created | |
 - BYTE
|
Return |
|
|
TxByte |
| Puts a byte onto the comms channel. CAN packet is inserted into injector like this: ID3, ID2, ID1, ID0, D7, D6, D5, D4, D3, D2, D1, D0, \n | |
| - BYTE
|
DataByte |
 - VOID
|
Return |
|
|
RxByte |
| Attempt to receive a byte back from the injector 0 - 255 = Valid data 256 = RX timeout no data available | |
 - UINT
|
Return |
|
|
GetConsoleHandle |
| Gets the handle to the console allowing data displaying on the panel etc. | |
| - BYTE
|
HandleIndex |
| Selects which console handle to obtain - 0=ID/Data 1=ID Meanings | |
 - HANDLE
|
Return |
Property reference
|
Properties |
|
CAN Injector Settings |
|
Circular Buffer Size |
| Number of bytes that can be held in the injector's circular buffer | |
|
Termination Character |
| Used to signify the end of a message, in the case of CAN it will end a specific identifier message | |
|
CSV ID File |
| Location of comma seperated ID description file. e.g. ID,Description 1,Door Open 2,Door Closed 3,Window Open 4,Window Closed 1023,System Disable 1024,System Enable | |
==Macro reference==
|
|
InitialiseInjector |
| Sets up the injector ready to receive commands or send data | |
| - STRING
|
InjectorName |
| Name of the console that will be created | |
| - BYTE
|
Return |
|
|
TxByte |
| Puts a byte onto the comms channel. CAN packet is inserted into injector like this: ID3, ID2, ID1, ID0, D7, D6, D5, D4, D3, D2, D1, D0, \n | |
| - BYTE
|
DataByte |
| - VOID
|
Return |
|
|
RxByte |
| Attempt to receive a byte back from the injector 0 - 255 = Valid data 256 = RX timeout no data available | |
| - UINT
|
Return |
|
|
GetConsoleHandle |
| Gets the handle to the console allowing data displaying on the panel etc. | |
| - BYTE
|
HandleIndex |
| Selects which console handle to obtain - 0=ID/Data 1=ID Meanings | |
| - HANDLE
|
Return |
Property reference
|
|
Properties |
|
|
CAN Injector Settings |
|
|
Circular Buffer Size |
| Number of bytes that can be held in the injector's circular buffer | |
|
|
Termination Character |
| Used to signify the end of a message, in the case of CAN it will end a specific identifier message | |
|
|
CSV ID File |
| Location of comma seperated ID description file. e.g. ID,Description 1,Door Open 2,Door Closed 3,Window Open 4,Window Closed 1023,System Disable 1024,System Enable | |
==Macro reference==
|
|
InitialiseInjector |
| Sets up the injector ready to receive commands or send data | |
| - STRING
|
InjectorName |
| Name of the console that will be created | |
| - BYTE
|
Return |
|
|
TxByte |
| Puts a byte onto the comms channel. CAN packet is inserted into injector like this: ID3, ID2, ID1, ID0, D7, D6, D5, D4, D3, D2, D1, D0, \n | |
| - BYTE
|
DataByte |
| - VOID
|
Return |
|
|
RxByte |
| Attempt to receive a byte back from the injector 0 - 255 = Valid data 256 = RX timeout no data available | |
| - UINT
|
Return |
|
|
GetConsoleHandle |
| Gets the handle to the console allowing data displaying on the panel etc. | |
| - BYTE
|
HandleIndex |
| Selects which console handle to obtain - 0=ID/Data 1=ID Meanings | |
| - HANDLE
|
Return |
Property reference
|
|
Properties |
|
|
CAN Injector Settings |
|
|
Circular Buffer Size |
| Number of bytes that can be held in the injector's circular buffer | |
|
|
Termination Character |
| Used to signify the end of a message, in the case of CAN it will end a specific identifier message | |
|
|
CSV ID File |
| Location of comma seperated ID description file. e.g. ID,Description 1,Door Open 2,Door Closed 3,Window Open 4,Window Closed 1023,System Disable 1024,System Enable | |
==Macro reference==
|
|
InitialiseInjector |
| Sets up the injector ready to receive commands or send data | |
| - STRING
|
InjectorName |
| Name of the console that will be created | |
| - BYTE
|
Return |
|
|
TxByte |
| Puts a byte onto the comms channel. CAN packet is inserted into injector like this: ID3, ID2, ID1, ID0, D7, D6, D5, D4, D3, D2, D1, D0, \n | |
| - BYTE
|
DataByte |
| - VOID
|
Return |
|
|
RxByte |
| Attempt to receive a byte back from the injector 0 - 255 = Valid data 256 = RX timeout no data available | |
| - UINT
|
Return |
|
|
GetConsoleHandle |
| Gets the handle to the console allowing data displaying on the panel etc. | |
| - BYTE
|
HandleIndex |
| Selects which console handle to obtain - 0=ID/Data 1=ID Meanings | |
| - HANDLE
|
Return |
Property reference
|
|
Properties |
|
|
CAN Injector Settings |
|
|
Circular Buffer Size |
| Number of bytes that can be held in the injector's circular buffer | |
|
|
Termination Character |
| Used to signify the end of a message, in the case of CAN it will end a specific identifier message | |
|
|
CSV ID File |
| Location of comma seperated ID description file. e.g. ID,Description 1,Door Open 2,Door Closed 3,Window Open 4,Window Closed 1023,System Disable 1024,System Enable | |