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

Latest revision as of 13:11, 7 February 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

GetState

	GetState
Returns the current state
- BYTE	Return

Initialise

	Initialise
Initialise the component
- VOID	Return

PowerDown

	PowerDown
Power Down the device
- VOID	Return

ReadData

	ReadData
Returns a data byte indexed by Idx
- BYTE	Idx

- BYTE	Return

ReadDataCount

	ReadDataCount
Returns the data count size
- BYTE	Return

SendMessage

	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.
- BYTE	Identifier

- BYTE	ResponseCount

- BYTE	ChecksumType
0=Classic, 1=Enhanced
- BYTE	Return

SendMessageWithData

	SendMessageWithData
Sends a message with data of length DataCount. See SetData
- BYTE	Identifier

- BYTE	DataCount

- BYTE	Checksum
0=Classic, 1=Enhanced
- BYTE	Return

SetData

	SetData
Sets the data bytes to be sent
- BYTE	Data1

- BYTE	Data2

- BYTE	Data3

- BYTE	Data4

- BYTE	Data5

- BYTE	Data6

- BYTE	Data7

- BYTE	Data8

- VOID	Return

WakeUp

	WakeUp
Wake Up the device
- VOID	Return

debug

	debug

- BYTE	idx

- BYTE	Return

Property reference

	Properties
	Baud Rate
LIN bus data rate in bits per second
	Label
Label shown on the comms flasher component.
	Connections
	TX
LIN Transmit Pin
	RX
LIN Receive Pin
	CS
LIN bus chip select pin
	WAKE
LIN bus Wake up pin

@@ Line 77: / Line 77: @@
 ''<span style="color:red;">No additional examples</span>''
@@ Line 84: / Line 90: @@
 ==Macro reference==
+===GetState===
+{| 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&nbsp;
+|-
+|-
+| 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''
+|}
+===Initialise===
+{| 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&nbsp;
+|-
+|-
+| 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''
+|}
 ===PowerDown===
@@ Line 99: / Line 133: @@
-===GetState===
+===ReadData===
 {| 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'''
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadData'''
+|-
+| colspan="2" | Returns a data byte indexed by Idx&nbsp;
 |-
-| colspan="2" | Returns the current state&nbsp;
 |-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | Idx
+|-
+| colspan="2" | &nbsp;
 |-
 | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
@@ Line 113: / Line 152: @@
-===debug===
+===ReadDataCount===
 {| 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'''
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadDataCount'''
-|-
-| colspan="2" | &nbsp;
 |-
+| colspan="2" | Returns the data count size&nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | idx
-|-
-| colspan="2" | &nbsp;
 |-
 | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
@@ Line 161: / Line 195: @@
-===ReadDataCount===
+===SendMessageWithData===
 {| 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'''
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendMessageWithData'''
+|-
+| colspan="2" | Sends a message with data of length DataCount. See SetData&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | Identifier
+|-
+| colspan="2" | &nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | DataCount
+|-
+| colspan="2" | &nbsp;
 |-
-| colspan="2" | Returns the data count size&nbsp;
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | Checksum
 |-
+| colspan="2" | 0=Classic, 1=Enhanced&nbsp;
 |-
 | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
@@ Line 229: / Line 278: @@
-===ReadData===
+===WakeUp===
 {| 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'''
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WakeUp'''
 |-
-| colspan="2" | Returns a data byte indexed by Idx&nbsp;
+| colspan="2" | Wake Up the device&nbsp;
 |-
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
-| width="90%" | Idx
-|-
-| colspan="2" | &nbsp;
-|-
-| 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''
 |}
-===SendMessageWithData===
+===debug===
 {| 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'''
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''debug'''
 |-
-| colspan="2" | Sends a message with data of length DataCount. See SetData&nbsp;
+| colspan="2" | &nbsp;
 |-
 |-
 | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | Identifier
+| width="90%" | idx
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | DataCount
 |-
 | colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | Checksum
-|-
-| colspan="2" | 0=Classic, 1=Enhanced&nbsp;
 |-
 | 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''
 |}
-===WakeUp===
-{| 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&nbsp;
-|-
-|-
-| 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''
-|}
-===Initialise===
-{| 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&nbsp;
-|-
-|-
-| 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''
-|}