Component: Switch Array (Push) (Switches)
Author | Matrix Ltd. |
Version | 2.0 |
Category | Switches |
Contents
Switch Array (Push) 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.fcfx
Please click here to view the component source code (Beta): FC_Comp_Source_switch_array_push.fcfx
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. Switch Array
Here is a schematic of how to connect a basic switch to a microcontroller pin.
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
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 |