Component: Switch (EB007) (E-blocks 1): Difference between revisions

Latest revision as of 14:37, 13 July 2026

Author	Matrix Ltd.
Version	2.0
Category	E-blocks 1

Switch component

An array of up to eight momentary push switches, each connected to a single pin of the specified port.

Component Source Code

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

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

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

GetHandle

	GetHandle
Retrieves the object handle of the switch component at the given index.
- BYTE	Index

- HANDLE	Return

ReadAll

	ReadAll
Reads all of the switches at once, returning a byte containing one bit per switch.
- BYTE	Return

ReadState

	ReadState
Read the state of the switch at the given index.
- BYTE	Index
The switch to read the status of.
- BOOL	Return

WaitUntilHigh

	WaitUntilHigh
Pause the program until the switch at the given index is turned on.
- BYTE	Index
Index of the switch to wait for.
- VOID	Return

WaitUntilLow

	WaitUntilLow
Pause the program until the switch at the given index is turned on.
- BYTE	Index
Index of the switch to wait for.
- VOID	Return

Property reference

	Properties
	Count
The number of LEDs in the array from 1 to 8.
	Connections
	Input Mode
Choose a single port for all LEDs - pins are allocated in sequence from pin 0 - 7 ...or choose 'Custom pins' to assign each switch individually.
	Port

	Debounce
Time in milliseconds allowed for the pin to settle following a change of state.

@@ Line 49: / Line 49: @@
 ''<span style="color:red;">No additional examples</span>''
@@ Line 55: / Line 63: @@
 ==Macro reference==
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+===GetHandle===
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadState'''
+| width="90%" class="mtx-class-macrohead" | '''GetHandle'''
 |-
-| colspan="2" | Read the state of the switch at the given index.&nbsp;
+| colspan="2" | Retrieves the object handle of the switch component at the given index.&nbsp;
 |-
 |-
@@ Line 66: / Line 75: @@
 | width="90%" | Index
 |-
-| colspan="2" | The switch to read the status of.&nbsp;
+| colspan="2" | &nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-bool-icon.png]] - BOOL
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-h32-icon.png]] - HANDLE
 | width="90%" style="border-top: 2px solid #000;" | ''Return''
 |}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+===ReadAll===
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WaitUntilHigh'''
+| width="90%" class="mtx-class-macrohead" | '''ReadAll'''
 |-
-| colspan="2" | Pause the program until the switch at the given index is turned on.&nbsp;
+| colspan="2" | Reads all of the switches at once, returning a byte containing one bit per switch.&nbsp;
 |-
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | Index
-|-
-| colspan="2" | Index of the switch to wait for.&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''
 |}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+===ReadState===
+{| class="mtx-class-macrotable wikitable"
+|-
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
+| width="90%" class="mtx-class-macrohead" | '''ReadState'''
+|-
+| colspan="2" | Read the state of the switch at the given index.&nbsp;
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadAll'''
 |-
-| colspan="2" | Reads all of the switches at once, returning a byte containing one bit per switch.&nbsp;
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | Index
 |-
+| colspan="2" | The switch to read the status of.&nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-bool-icon.png]] - BOOL
 | width="90%" style="border-top: 2px solid #000;" | ''Return''
 |}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+===WaitUntilHigh===
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetHandle'''
+| width="90%" class="mtx-class-macrohead" | '''WaitUntilHigh'''
 |-
-| colspan="2" | Retrieves the object handle of the switch component at the given index.&nbsp;
+| colspan="2" | Pause the program until the switch at the given index is turned on.&nbsp;
 |-
 |-
@@ Line 115: / Line 127: @@
 | width="90%" | Index
 |-
-| colspan="2" | &nbsp;
+| colspan="2" | Index of the switch to wait for.&nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-h32-icon.png]] - HANDLE
+| 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;"
+===WaitUntilLow===
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WaitUntilLow'''
+| width="90%" class="mtx-class-macrohead" | '''WaitUntilLow'''
 |-
 | colspan="2" | Pause the program until the switch at the given index is turned on.&nbsp;
@@ Line 138: / Line 151: @@
 | width="90%" style="border-top: 2px solid #000;" | ''Return''
 |}
 ==Property reference==
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+| width="90%" class="mtx-class-macrohead" | '''Properties'''
 |-
 |-
@@ Line 155: / Line 166: @@
 | colspan="2" | The number of LEDs in the array from 1 to 8.&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections
+| width="90%" class="mtx-class-propfolder" | Connections
 |-
 |-

SteveT (talk | contribs)