Difference between revisions of "Component: Switch Array (Slide) (Switches)"

From Flowcode Help
Jump to navigationJump to search
 
(One intermediate revision by the same user not shown)
Line 5: Line 5:
 
|-
 
|-
 
| width="20%" style="color:gray;" | Version
 
| width="20%" style="color:gray;" | Version
| 10.0
+
| 13.13
 
|-
 
|-
 
| width="20%" style="color:gray;" | Category
 
| width="20%" style="color:gray;" | Category
Line 18: Line 18:
  
 
  Library Version, Component Version, Date, Author, Info
 
  Library Version, Component Version, Date, Author, Info
 +
9, 9.0, 25-06-24, MW, Added option to customise appearance of individual or all switches
 
  10, 10.0, 26-06-24, MW, Corrected switch and component name bug
 
  10, 10.0, 26-06-24, MW, Corrected switch and component name bug
    
+
12, 11.0, 16-04-25, MW, Corrected bug when sim stopped Switch changed from on to off, but pin remained at VCC
 
+
12, 11.0, 16-04-25, MW, Added properties of Ev_PropertiesEX to Ev_Initialise
 +
12, 11.0, 16-04-25, MW, Fixed bug so individual customisation now works
 +
   12, 11.0, 16-04-25, MW, Created a new component icon
 +
13, 13.0, 25-09-25, MW, updated to brig in-line with Switch Array Push
  
 
==Detailed description==
 
==Detailed description==
Line 152: Line 156:
 
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''  
 
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''  
 
|-
 
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 +
| width="90%" | Count
 +
|-
 +
| colspan="2" | The number of LEDs in the array from 1 to 8. 
 
|-
 
|-
 
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
 
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Switch Settings
+
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Function
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 +
| width="90%" | Simulation Only
 
|-
 
|-
 +
| colspan="2" |  
 
|-
 
|-
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
+
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
| width="90%" | Count
+
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Switch Settings
 
|-
 
|-
| colspan="2" | The number of LEDs in the array from 1 to 8. 
 
 
|-
 
|-
 
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
Line 188: Line 201:
 
|-
 
|-
 
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
 
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Label
+
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Appearance
 
|-
 
|-
 
|-
 
|-
Line 195: Line 208:
 
|-
 
|-
 
| colspan="2" | Allows you to add your own label to each switch. If Same as Handle is selected then all custom text will be erased. 
 
| colspan="2" | Allows you to add your own label to each switch. If Same as Handle is selected then all custom text will be erased. 
|-
 
| width="10%" align="center" | [[File:Fc9-type-1-icon.png]]
 
| width="90%" | Label colour
 
|-
 
| colspan="2" | Colour of the port and pin labels 
 
|-
 
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
| width="90%" | Show Connection Label
 
|-
 
| colspan="2" | Enable or disable the pin values underneath each switch  
 
|-
 
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
| width="90%" | Show Pin Value
 
|-
 
| colspan="2" | Enable or disable the pin level (GND or VCC) underneath each switch  
 
|-
 
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
 
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation
 
|-
 
 
|-
 
|-
 
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
Line 224: Line 218:
 
|-
 
|-
 
| colspan="2" | Set distance betwwn each switch. Default = 55 
 
| colspan="2" | Set distance betwwn each switch. Default = 55 
|-
 
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
 
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Appearance
 
|-
 
|-
 
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 
| width="90%" | Customise individual switches
 
|-
 
| colspan="2" |  
 
 
|-
 
|-
 
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
Line 251: Line 236:
 
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]]
 
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]]
 
| width="90%" | Off Label
 
| width="90%" | Off Label
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-1-icon.png]]
 +
| width="90%" | Label Colour
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 +
| width="90%" | Show Connection Label
 +
|-
 +
| colspan="2" |  
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
 +
| width="90%" | Show Pin Value
 
|-
 
|-
 
| colspan="2" |  
 
| colspan="2" |  

Latest revision as of 21:16, 27 January 2026

Author MatrixTSL
Version 13.13
Category Switches


Switch Array (Slide) component

An array of up to eight slide switches. In embedded mode each switch is connected to a single pin of the specified port.

Version information

Library Version, Component Version, Date, Author, Info
9, 9.0, 25-06-24, MW, Added option to customise appearance of individual or all switches
10, 10.0, 26-06-24, MW, Corrected switch and component name bug
12, 11.0, 16-04-25, MW, Corrected bug when sim stopped Switch changed from on to off, but pin remained at VCC
12, 11.0, 16-04-25, MW, Added properties of Ev_PropertiesEX to Ev_Initialise
12, 11.0, 16-04-25, MW, Fixed bug so individual customisation now works
 12, 11.0, 16-04-25, MW, Created a new component icon
13, 13.0, 25-09-25, MW, updated to brig in-line with Switch Array Push

Detailed description

No detailed description exists yet for this component

Examples

Here is an example Flowcode program to read the values of a switch array. FC6 Icon.png Switch Array

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

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


Macro reference

ReadAll

Fc9-comp-macro.png ReadAll
Reads all of the switches at once, returning a byte containing one bit per switch. 
Fc9-u8-icon.png - BYTE Return


ReadState

Fc9-comp-macro.png ReadState
Read the state of the switch at the given index. 
Fc9-u8-icon.png - BYTE Index
The switch to read the status of. 
Fc9-bool-icon.png - BOOL Return


WaitUntilHigh

Fc9-comp-macro.png WaitUntilHigh
Pause the program until the switch at the given index is turned on. 
Fc9-u8-icon.png - BYTE Index
Index of the switch to wait for. 
Fc9-void-icon.png - VOID Return


WaitUntilLow

Fc9-comp-macro.png WaitUntilLow
Pause the program until the switch at the given index is turned on. 
Fc9-u8-icon.png - BYTE Index
Index of the switch to wait for. 
Fc9-void-icon.png - VOID Return


Property reference

Fc9-prop-icon.png Properties
Fc9-type-16-icon.png Count
The number of LEDs in the array from 1 to 8. 
Fc9-conn-icon.png Function
Fc9-type-7-icon.png Simulation Only
 
Fc9-conn-icon.png Switch Settings
Fc9-type-16-icon.png 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. 
Fc9-type-19-icon.png Port
 
Fc9-type-16-icon.png Polarity
Active High = LEDs light when the chosen chip pin is ON Active Low = LEDs light when the chosen chip pin is OFF 
Fc9-type-14-icon.png Debounce
Time in milliseconds allowed for the pin to settle following a change of state. 
Fc9-type-16-icon.png Operation
Sets whether switches toggle or are press/release. NB) This option can only be set when the original target includes this option. 
Fc9-conn-icon.png Appearance
Fc9-type-16-icon.png Component Label
Allows you to add your own label to each switch. If Same as Handle is selected then all custom text will be erased. 
Fc9-type-16-icon.png Switch layout
 
Fc9-type-21-icon.png Distance between switches
Set distance betwwn each switch. Default = 55 
Fc9-type-16-icon.png Style
 
Fc9-type-16-icon.png Type
 
Fc9-type-10-icon.png On Label
 
Fc9-type-10-icon.png Off Label
 
Fc9-type-1-icon.png Label Colour
 
Fc9-type-7-icon.png Show Connection Label
 
Fc9-type-7-icon.png Show Pin Value
 

Component Source Code

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

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