Difference between revisions of "Component: LIN Master (Comms)"

From Flowcode Help
Jump to navigationJump to search
Line 16: Line 16:
  
 
==Component Source Code==
 
==Component Source Code==
 +
 +
Please click here to download the component source project: [https://www.flowcode.co.uk/wikicopy/componentsource/FC_Comp_Source_LinMaster.fcfx FC_Comp_Source_LinMaster.fcfx]
  
 
Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_LinMaster.fcfx FC_Comp_Source_LinMaster.fcfx]
 
Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_LinMaster.fcfx FC_Comp_Source_LinMaster.fcfx]
  
 
==Detailed description==
 
==Detailed description==
 +
 +
  
  
Line 42: Line 46:
  
 
==Examples==
 
==Examples==
 +
 +
  
  
Line 66: Line 72:
  
 
==Macro reference==
 
==Macro reference==
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''PowerDown'''
 +
|-
 +
| colspan="2" | Power Down the device 
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
 +
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetState'''
 +
|-
 +
| colspan="2" | Returns the current state 
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
 +
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''debug'''
 +
|-
 +
| colspan="2" |  
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | idx
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
 +
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendMessage'''
 +
|-
 +
| colspan="2" | Sends message with specified identifier and awaits a reply from a slave. Returns 0 to indicate a successful transaction. Returns 3 to indicate a timeout. Returns 6 to indicate a bad CRC. 
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Identifier
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | ResponseCount
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | ChecksumType
 +
|-
 +
| colspan="2" | 0=Classic, 1=Enhanced 
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
 +
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadDataCount'''
 +
|-
 +
| colspan="2" | Returns the data count size 
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
 +
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetData'''
 +
|-
 +
| colspan="2" | Sets the data bytes to be sent 
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Data1
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Data2
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Data3
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Data4
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Data5
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Data6
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Data7
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Data8
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
 +
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadData'''
 +
|-
 +
| colspan="2" | Returns a data byte indexed by Idx 
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Idx
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
 +
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendMessageWithData'''
 +
|-
 +
| colspan="2" | Sends a message with data of length DataCount. See SetData 
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Identifier
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | DataCount
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Checksum
 +
|-
 +
| colspan="2" | 0=Classic, 1=Enhanced 
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
 +
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WakeUp'''
 +
|-
 +
| colspan="2" | Wake Up the device 
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
 +
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
 +
|-
 +
| colspan="2" | Initialise the component 
 +
|-
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
 +
 +
 +
 +
 +
==Property reference==
 +
 +
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 +
| width="90%" | Baud Rate
 +
|-
 +
| colspan="2" | LIN bus data rate in bits per second 
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]]
 +
| width="90%" | Label
 +
|-
 +
| colspan="2" | Label shown on the comms flasher component. 
 +
|-
 +
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
 +
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
 +
| width="90%" | TX
 +
|-
 +
| colspan="2" | LIN Transmit Pin 
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
 +
| width="90%" | RX
 +
|-
 +
| colspan="2" | LIN Receive Pin  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
 +
| width="90%" | CS
 +
|-
 +
| colspan="2" | LIN bus chip select pin 
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
 +
| width="90%" | WAKE
 +
|-
 +
| colspan="2" | LIN bus Wake up pin  
 +
|}==Macro reference==
  
 
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"

Revision as of 15:23, 20 January 2023

Author Matrix Ltd
Version 1.2
Category Comms


LIN Master component

Low level routines for controlling a LIN master (1.3 & 2.0) interface.

Component Source Code

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

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

Detailed description

No detailed description exists yet for this component

Examples

No additional examples


Macro reference

Fc9-comp-macro.png PowerDown
Power Down the device 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png GetState
Returns the current state 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png debug
 
Fc9-u8-icon.png - BYTE idx
 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png SendMessage
Sends message with specified identifier and awaits a reply from a slave. Returns 0 to indicate a successful transaction. Returns 3 to indicate a timeout. Returns 6 to indicate a bad CRC. 
Fc9-u8-icon.png - BYTE Identifier
 
Fc9-u8-icon.png - BYTE ResponseCount
 
Fc9-u8-icon.png - BYTE ChecksumType
0=Classic, 1=Enhanced 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png ReadDataCount
Returns the data count size 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png SetData
Sets the data bytes to be sent 
Fc9-u8-icon.png - BYTE Data1
 
Fc9-u8-icon.png - BYTE Data2
 
Fc9-u8-icon.png - BYTE Data3
 
Fc9-u8-icon.png - BYTE Data4
 
Fc9-u8-icon.png - BYTE Data5
 
Fc9-u8-icon.png - BYTE Data6
 
Fc9-u8-icon.png - BYTE Data7
 
Fc9-u8-icon.png - BYTE Data8
 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png ReadData
Returns a data byte indexed by Idx 
Fc9-u8-icon.png - BYTE Idx
 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png SendMessageWithData
Sends a message with data of length DataCount. See SetData 
Fc9-u8-icon.png - BYTE Identifier
 
Fc9-u8-icon.png - BYTE DataCount
 
Fc9-u8-icon.png - BYTE Checksum
0=Classic, 1=Enhanced 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png WakeUp
Wake Up the device 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png Initialise
Initialise the component 
Fc9-void-icon.png - VOID Return



Property reference

Fc9-prop-icon.png Properties
Fc9-type-16-icon.png Baud Rate
LIN bus data rate in bits per second 
Fc9-type-10-icon.png Label
Label shown on the comms flasher component. 
Fc9-conn-icon.png Connections
Fc9-type-5-icon.png TX
LIN Transmit Pin 
Fc9-type-5-icon.png RX
LIN Receive Pin  
Fc9-type-5-icon.png CS
LIN bus chip select pin 
Fc9-type-5-icon.png WAKE
LIN bus Wake up pin  

==Macro reference==

Fc9-comp-macro.png PowerDown
Power Down the device 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png GetState
Returns the current state 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png debug
 
Fc9-u8-icon.png - BYTE idx
 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png SendMessage
Sends message with specified identifier and awaits a reply from a slave. Returns 0 to indicate a successful transaction. Returns 3 to indicate a timeout. Returns 6 to indicate a bad CRC. 
Fc9-u8-icon.png - BYTE Identifier
 
Fc9-u8-icon.png - BYTE ResponseCount
 
Fc9-u8-icon.png - BYTE ChecksumType
0=Classic, 1=Enhanced 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png ReadDataCount
Returns the data count size 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png SetData
Sets the data bytes to be sent 
Fc9-u8-icon.png - BYTE Data1
 
Fc9-u8-icon.png - BYTE Data2
 
Fc9-u8-icon.png - BYTE Data3
 
Fc9-u8-icon.png - BYTE Data4
 
Fc9-u8-icon.png - BYTE Data5
 
Fc9-u8-icon.png - BYTE Data6
 
Fc9-u8-icon.png - BYTE Data7
 
Fc9-u8-icon.png - BYTE Data8
 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png ReadData
Returns a data byte indexed by Idx 
Fc9-u8-icon.png - BYTE Idx
 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png SendMessageWithData
Sends a message with data of length DataCount. See SetData 
Fc9-u8-icon.png - BYTE Identifier
 
Fc9-u8-icon.png - BYTE DataCount
 
Fc9-u8-icon.png - BYTE Checksum
0=Classic, 1=Enhanced 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png WakeUp
Wake Up the device 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png Initialise
Initialise the component 
Fc9-void-icon.png - VOID Return



Property reference

Fc9-prop-icon.png Properties
Fc9-type-16-icon.png Baud Rate
LIN bus data rate in bits per second 
Fc9-type-10-icon.png Label
Label shown on the comms flasher component. 
Fc9-conn-icon.png Connections
Fc9-type-5-icon.png TX
LIN Transmit Pin 
Fc9-type-5-icon.png RX
LIN Receive Pin  
Fc9-type-5-icon.png CS
LIN bus chip select pin 
Fc9-type-5-icon.png WAKE
LIN bus Wake up pin  

==Macro reference==

Fc9-comp-macro.png PowerDown
Power Down the device 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png GetState
Returns the current state 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png debug
 
Fc9-u8-icon.png - BYTE idx
 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png SendMessage
Sends message with specified identifier and awaits a reply from a slave. Returns 0 to indicate a successful transaction. Returns 3 to indicate a timeout. Returns 6 to indicate a bad CRC. 
Fc9-u8-icon.png - BYTE Identifier
 
Fc9-u8-icon.png - BYTE ResponseCount
 
Fc9-u8-icon.png - BYTE ChecksumType
0=Classic, 1=Enhanced 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png ReadDataCount
Returns the data count size 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png SetData
Sets the data bytes to be sent 
Fc9-u8-icon.png - BYTE Data1
 
Fc9-u8-icon.png - BYTE Data2
 
Fc9-u8-icon.png - BYTE Data3
 
Fc9-u8-icon.png - BYTE Data4
 
Fc9-u8-icon.png - BYTE Data5
 
Fc9-u8-icon.png - BYTE Data6
 
Fc9-u8-icon.png - BYTE Data7
 
Fc9-u8-icon.png - BYTE Data8
 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png ReadData
Returns a data byte indexed by Idx 
Fc9-u8-icon.png - BYTE Idx
 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png SendMessageWithData
Sends a message with data of length DataCount. See SetData 
Fc9-u8-icon.png - BYTE Identifier
 
Fc9-u8-icon.png - BYTE DataCount
 
Fc9-u8-icon.png - BYTE Checksum
0=Classic, 1=Enhanced 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png WakeUp
Wake Up the device 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png Initialise
Initialise the component 
Fc9-void-icon.png - VOID Return



Property reference

Fc9-prop-icon.png Properties
Fc9-type-16-icon.png Baud Rate
LIN bus data rate in bits per second 
Fc9-type-10-icon.png Label
Label shown on the comms flasher component. 
Fc9-conn-icon.png Connections
Fc9-type-5-icon.png TX
LIN Transmit Pin 
Fc9-type-5-icon.png RX
LIN Receive Pin  
Fc9-type-5-icon.png CS
LIN bus chip select pin 
Fc9-type-5-icon.png WAKE
LIN bus Wake up pin