Component: Switch (Controls) - Revision history

SteveT: Text replacement - "width="90%" style="background-color:#D8C9D8; color:#4B008D;"" to "width="90%" class="mtx-class-macrohead""

2026-07-13T14:23:26Z

Text replacement - "width="90%" style="background-color:#D8C9D8; color:#4B008D;"" to "width="90%" class="mtx-class-macrohead""

← Older revision		Revision as of 14:23, 13 July 2026
Line 66:		Line 66:
	\|-		\|-
	\| width="10%" align="center" class="mtx-class-macrohead" \| [[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;~~" \| '''GetState'''		\| width="90%" class="mtx-class-macrohead" \| '''GetState'''
	\|-		\|-
	\| colspan="2" \| Reads the state of the switch (true = on, false = off)		\| colspan="2" \| Reads the state of the switch (true = on, false = off)
Line 79:		Line 79:
	\|-		\|-
	\| width="10%" align="center" class="mtx-class-macrohead" \| [[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;~~" \| '''SetState'''		\| width="90%" class="mtx-class-macrohead" \| '''SetState'''
	\|-		\|-
	\| colspan="2" \| Sets the switch to be on or off.		\| colspan="2" \| Sets the switch to be on or off.
Line 101:		Line 101:
	\|-		\|-
	\| width="10%" align="center" class="mtx-class-macrohead" \| [[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 135:		Line 135:
	\|-		\|-
	\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-conn-icon.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-conn-icon.png]]
	\| width="90%" ~~style~~="~~background~~-~~color:#D8C9D8; color:#4B008D;~~" \| '''Connections'''		\| width="90%" class="mtx-class-macrohead" \| '''Connections'''
	\|-		\|-
	\|-		\|-
	\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-conn-icon.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-conn-icon.png]]
	\| width="90%" ~~style~~="~~background~~-~~color:#D8C9D8; color:#4B008D;~~" \| '''Simulations'''		\| width="90%" class="mtx-class-macrohead" \| '''Simulations'''
	\|-		\|-
	\|}		\|}

SteveT: Text replacement - "width="10%" align="center" style="background-color:#D8C9D8;"" to "width="10%" align="center" class="mtx-class-macrohead""

2026-07-13T14:21:27Z

Text replacement - "width="10%" align="center" style="background-color:#D8C9D8;"" to "width="10%" align="center" class="mtx-class-macrohead""

← Older revision		Revision as of 14:21, 13 July 2026
Line 100:		Line 100:
	{\| class="mtx-class-macrotable wikitable"		{\| 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%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Properties'''
	\|-		\|-
Line 134:		Line 134:
	\| colspan="2" \|		\| colspan="2" \|
	\|-		\|-
	\| width="10%" align="center" ~~style~~="~~background~~-~~color:#D8C9D8;~~" \| [[File:Fc9-conn-icon.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-conn-icon.png]]
	\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Connections'''		\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Connections'''
	\|-		\|-
	\|-		\|-
	\| width="10%" align="center" ~~style~~="~~background~~-~~color:#D8C9D8;~~" \| [[File:Fc9-conn-icon.png]]		\| width="10%" align="center" class="mtx-class-macrohead" \| [[File:Fc9-conn-icon.png]]
	\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Simulations'''		\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''Simulations'''
	\|-		\|-
	\|}		\|}

SteveT: Text replacement - "width="10%" align="center" style="background-color:#D8C9D8;" align="center"" to "width="10%" align="center" class="mtx-class-macrohead""

2026-07-13T14:17:32Z

Text replacement - "width="10%" align="center" style="background-color:#D8C9D8;" align="center"" to "width="10%" align="center" class="mtx-class-macrohead""

← Older revision		Revision as of 14:17, 13 July 2026
Line 65:		Line 65:
	{\| class="mtx-class-macrotable wikitable"		{\| 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;" \| '''GetState'''		\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''GetState'''
	\|-		\|-
Line 78:		Line 78:
	{\| class="mtx-class-macrotable wikitable"		{\| 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;" \| '''SetState'''		\| width="90%" style="background-color:#D8C9D8; color:#4B008D;" \| '''SetState'''
	\|-		\|-

SteveT: Text replacement - "class="wikitable" style="width:60%; background-color:#FFFFFF;"" to "class="mtx-class-macrotable wikitable""

2026-07-13T14:15:54Z

Text replacement - "class="wikitable" style="width:60%; background-color:#FFFFFF;"" to "class="mtx-class-macrotable wikitable""

← Older revision		Revision as of 14:15, 13 July 2026
Line 63:		Line 63:
	==Downloadable macro reference==		==Downloadable macro reference==

	{\| class="wikitable~~" style="width:60%; background-color:#FFFFFF;~~"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]
Line 76:		Line 76:


	{\| class="wikitable~~" style="width:60%; background-color:#FFFFFF;~~"		{\| class="mtx-class-macrotable wikitable"
	\|-		\|-
	\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]		\| width="10%" align="center" style="background-color:#D8C9D8;" align="center" \| [[File:Fc9-comp-macro.png]]
Line 98:		Line 98:
	==Property reference==		==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" style="background-color:#D8C9D8;" \| [[File:Fc9-prop-icon.png]]

MartinW at 08:39, 2 May 2025

2025-05-02T08:39:58Z

@@ Line 1: / Line 1: @@
 ==Switch component==
 A 2d switch component.
 ==Detailed description==

MartinW at 08:39, 2 May 2025

2025-05-02T08:39:06Z

← Older revision		Revision as of 08:39, 2 May 2025
Line 2:		Line 2:
	\|-		\|-
	\| width="20%" style="color:gray;" \| Author		\| width="20%" style="color:gray;" \| Author
	\| Steve Tandy		\| Steve Tandy & Martin Whitlock
	\|-		\|-
	\| width="20%" style="color:gray;" \| Version		\| width="20%" style="color:gray;" \| Version

MartinW: /* Examples */

2025-05-02T08:38:04Z

Examples

← Older revision		Revision as of 08:38, 2 May 2025
Line 27:		Line 27:

	Here is an example Flowcode program to read the value of a switch.		Here is an example Flowcode program to read the value of a switch.

	{{Fcfile\|Switch.fcfx\|Switch}}		{{Fcfile\|Switch.fcfx\|Switch}}

Line 33:		Line 34:
	[[File:switchschematic.jpg]]		[[File:switchschematic.jpg]]

	The polarity setting ~~within the~~ switch properties determines how the ~~relevant~~ bit of the input variable responds when a switch changes state.		The polarity setting in switch properties determines how the corresponding bit in the input variable responds when the switch changes state.

	This applies only when using switch functions and not when using input command icons.		This applies only when using switch functions and not when using input command icons.
	* Active High Polarity: When the switch is closed, the voltage on the pin transitions from 0V to the positive supply voltage (either 3.3V or 5V, depending on the microcontroller). As a result, the corresponding bit in the input variable changes from 0 to 1. A pull-down resistor is required ~~for~~ the ~~input~~ pin ~~to ensure it~~ stays at 0V when the switch is open.
	* Active Low Polarity: When the switch is closed, the voltage on the pin transitions from the positive supply voltage to 0V~~, and again, the relevant~~ bit of the input variable changes from 0 to 1. A pull-up resistor is required ~~for~~ the ~~input~~ pin ~~to ensure it~~ stays at the positive supply voltage when the switch is open.
			*Active High Polarity

			When the switch is closed, the voltage on the pin transitions from 0V to the positive supply voltage (either 3.3V or 5V, depending on the microcontroller).

			As a result, the corresponding bit in the input variable changes from 0 to 1.

			A pull-down resistor is required to ensure the pin stays at 0V when the switch is open.

			If using two resistors (as shown in the image above), they provide protection in case the pin is mistakenly set as an output while the switch is pressed.


			*Active Low Polarity

			When the switch is closed, the voltage on the pin transitions from the positive supply voltage to 0V.

			The corresponding bit in the input variable changes from 0 to 1.

			A pull-up resistor is required to ensure the pin stays at the positive supply voltage when the switch is open.

			If using two resistors(as shown in the image above), they provide protection if the pin is mistakenly set as an output while the switch is pressed.



	There are some differences depending on the type of switch you have, the above states assume a generic push to make type switch, however a push to break type switch would have reversed logic and a toggle switch can work well with either setup.		There are some differences depending on the type of switch you have, the above states assume a generic push to make type switch, however a push to break type switch would have reversed logic and a toggle switch can work well with either setup.


	The resistors are required for correct operation because when a microcontroller's input pin is essentially connected to nothing it will pick up noise in the environment and provide inconsistent readings. This state is referred to as floating i.e. the pin is floating. To test this remove the resistors (if possible) and touch the unconnected pin with your finger the output LED from the example file above will toggle on and off at high speed.		The resistors are required for correct operation because when a microcontroller's input pin is essentially connected to nothing it will pick up noise in the environment and provide inconsistent readings.

			This state is referred to as floating i.e. the pin is floating. To test this remove the resistors (if possible) and touch the unconnected pin with your finger the output LED from the example file above will toggle on and off at high speed.


			Any values of resistor can be used but it is important to keep the smaller resistor at least 10X smaller then the larger resistor to ensure that the pressed state provides at least 0.91% of the required pressed state voltage.

	Any values of resistor can be used but it is important to keep the smaller resistor at least 10X smaller then the larger resistor to ensure that the pressed state provides at least 0.91% of the required pressed state voltage. For example a active high switch circuit using 1K and 10K resistors should pull up to about 4.54V when the switch is pressed.		For example a active high switch circuit using 1K and 10K resistors should pull up to about 4.54V when the switch is pressed.

	(5V / 11K) * 10K = 4.54545V		(5V / 11K) * 10K = 4.54545V

MartinW: /* Examples */

2025-05-02T08:27:19Z

Examples

← Older revision		Revision as of 08:27, 2 May 2025
Line 33:		Line 33:
	[[File:switchschematic.jpg]]		[[File:switchschematic.jpg]]

	The ~~active high circuit will pass a logical 0 to~~ the input ~~pin~~ when ~~the~~ switch is not ~~pressed and a logical 1~~ when the switch is ~~pressed~~.		The polarity setting within the switch properties determines how the relevant bit of the input variable responds when a switch changes state.
			This applies only when using switch functions and not when using input command icons.
	~~The active low circuit will pass~~ a ~~logical~~ 1 to the input pin when the switch is ~~not pressed~~ and ~~a logical~~ 0 when the switch is ~~pressed~~.		* Active High Polarity: When the switch is closed, the voltage on the pin transitions from 0V to the positive supply voltage (either 3.3V or 5V, depending on the microcontroller). As a result, the corresponding bit in the input variable changes from 0 to 1. A pull-down resistor is required for the input pin to ensure it stays at 0V when the switch is open.
			* Active Low Polarity: When the switch is closed, the voltage on the pin transitions from the positive supply voltage to 0V, and again, the relevant bit of the input variable changes from 0 to 1. A pull-up resistor is required for the input pin to ensure it stays at the positive supply voltage when the switch is open.

	There are some differences depending on the type of switch you have, the above states assume a generic push to make type switch, however a push to break type switch would have reversed logic and a toggle switch can work well with either setup.		There are some differences depending on the type of switch you have, the above states assume a generic push to make type switch, however a push to break type switch would have reversed logic and a toggle switch can work well with either setup.

MartinW: /* Examples */

2022-02-17T09:10:51Z

Examples

← Older revision		Revision as of 09:10, 17 February 2022
Line 26:		Line 26:


	~~''<span style="color:red;">No additional examples</span>''~~		Here is an example Flowcode program to read the value of a switch.
			{{Fcfile\|Switch.fcfx\|Switch}}

			Here is a schematic of how to connect a basic switch to a microcontroller pin.

			[[File:switchschematic.jpg]]

			The active high circuit will pass a logical 0 to the input pin when the switch is not pressed and a logical 1 when the switch is pressed.

			The active low circuit will pass a logical 1 to the input pin when the switch is not pressed and a logical 0 when the switch is pressed.


			There are some differences depending on the type of switch you have, the above states assume a generic push to make type switch, however a push to break type switch would have reversed logic and a toggle switch can work well with either setup.


			The resistors are required for correct operation because when a microcontroller's input pin is essentially connected to nothing it will pick up noise in the environment and provide inconsistent readings. This state is referred to as floating i.e. the pin is floating. To test this remove the resistors (if possible) and touch the unconnected pin with your finger the output LED from the example file above will toggle on and off at high speed.


			Any values of resistor can be used but it is important to keep the smaller resistor at least 10X smaller then the larger resistor to ensure that the pressed state provides at least 0.91% of the required pressed state voltage. For example a active high switch circuit using 1K and 10K resistors should pull up to about 4.54V when the switch is pressed.

			(5V / 11K) * 10K = 4.54545V

	==Downloadable macro reference==		==Downloadable macro reference==

Wiki bot: Created page with "{| style="width:50%" |- | width="20%" style="color:gray;" | Author | Steve Tandy |- | width="20%" style="color:gray;" | Version | 1.0 |- | width="20%" style="color:gra..."

2022-01-07T16:17:13Z

Created page with "{| style="width:50%" |- | width="20%" style="color:gray;" | Author | Steve Tandy |- | width="20%" style="color:gray;" | Version | 1.0 |- | width="20%" style="color:gra..."

New page

{| style="width:50%"
|-
| width="20%" style="color:gray;" | Author
| Steve Tandy
|-
| width="20%" style="color:gray;" | Version
| 1.0
|-
| width="20%" style="color:gray;" | Category
| Controls
|}

==Switch component==
A 2d switch component.

==Component Pack==

FREE

==Detailed description==

''No detailed description exists yet for this component''

==Examples==

''<span style="color:red;">No additional examples</span>''

==Downloadable 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;" | '''GetState'''
|-
| colspan="2" | Reads the state of the switch (true = on, false = off) 
|-
|-
| 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;"
|-
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetState'''
|-
| colspan="2" | Sets the switch to be on or off. 
|-
|-
| width="10%" align="center" | [[File:Fc9-bool-icon.png]] - BOOL
| width="90%" | bState
|-
| colspan="2" | The new state of the switch (true=on, false=off) 
|-
| 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-12-icon.png]]
| width="90%" | State
|-
| colspan="2" |  
|-
| width="10%" align="center" | [[File:Fc9-type-12-icon.png]]
| width="90%" | Style
|-
| colspan="2" |  
|-
| width="10%" align="center" | [[File:Fc9-type-12-icon.png]]
| width="90%" | Type
|-
| colspan="2" |  
|-
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]]
| width="90%" | On Label
|-
| colspan="2" |  
|-
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]]
| width="90%" | Off Label
|-
| colspan="2" |  
|-
| width="10%" align="center" | [[File:Fc9-type-2-icon.png]]
| width="90%" | Background Colour
|-
| colspan="2" |  
|-
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-conn-icon.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Connections'''
|-
|-
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-conn-icon.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Simulations'''
|-
|}