Difference between revisions of "Component: Switch (BL0145) (E-blocks 2)"

From Flowcode Help
Jump to navigationJump to search
(XML import)
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
+
{| style="width:50%"
{| width="50%"
 
 
|-
 
|-
| width="20%" style="color: gray;" | Author
+
| width="20%" style="color:gray;" | Author
 
| Matrix TSL
 
| Matrix TSL
 
|-
 
|-
| width="20%" style="color: gray;" | Version
+
| width="20%" style="color:gray;" | Version
| 1.0 (Release)
+
| 1.0
 
|-
 
|-
| width="20%" style="color: gray;" | Category
+
| width="20%" style="color:gray;" | Category
 
| E-blocks 2
 
| E-blocks 2
 
|}
 
|}
  
  
 +
==Switch component==
 +
A set of 8 push switches that can be connected to an E-blocks 2 upstream board via a port connector. Switches are wired in an active high configuration.
  
==[[File:Component Icon b3a7287a_4070_49d1_9122_bf6169f67cd1.png|Image]] Switch (BL0145) component==
+
==Component Source Code==
A set of 8 push switches that can be connected to an E-blocks 2 upstream board via a port connector.
 
Switches are wired in an active high configuration.
 
  
==Examples==
+
Please click here to download the component source project: [https://www.flowcode.co.uk/wiki/componentsource/FC_Comp_Source_EBlocks2_Switch_BL0145.fcfx FC_Comp_Source_EBlocks2_Switch_BL0145.fcfx]
''<span style="color:red;">No additional examples</span>''
 
  
 +
Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_EBlocks2_Switch_BL0145.fcfx FC_Comp_Source_EBlocks2_Switch_BL0145.fcfx]
  
==Downloadable macro reference==
+
==Detailed description==
  
===<span style="font-weight: normal;"><u><tt>ReadState</tt></u></span>===
 
Read the state of the switch at the given index.
 
  
'''Parameters'''
 
  
:[[Variable Types|BYTE]] ''Index''
 
::The switch to read the status of.
 
  
  
'''Return value'''
 
  
:[[Variable Types|BOOL]] : Key state - true = on, false = off
 
  
  
===<span style="font-weight: normal;"><u><tt>WaitUntilHigh</tt></u></span>===
 
Pause the program until the switch at the given index is turned on.
 
  
'''Parameters'''
 
  
:[[Variable Types|BYTE]] ''Index''
 
::Index of the switch to wait for.
 
  
 +
''No detailed description exists yet for this component''
  
'''Return value'''
+
==Examples==
  
:''This call does not return a value''
 
  
  
===<span style="font-weight: normal;"><u><tt>ReadAll</tt></u></span>===
 
Reads all of the switches at once, returning a byte containing one bit per
 
  
switch.
 
  
'''Parameters'''
 
  
:''This macro has no parameters''
 
  
  
'''Return value'''
 
  
:[[Variable Types|BYTE]] : One bit per switch in the array.
 
  
  
===<span style="font-weight: normal;"><u><tt>WaitUntilLow</tt></u></span>===
 
Pause the program until the switch at the given index is turned on.
 
  
'''Parameters'''
+
''<span style="color:red;">No additional examples</span>''
  
:[[Variable Types|BYTE]] ''Index''
 
::Index of the switch  to wait for.
 
  
  
'''Return value'''
 
  
:''This call does not return a value''
 
  
  
  
==Simulation macro reference==
 
  
''This component does not contain any simulation macros''
 
  
  
==Property reference==
 
<span style="font-weight: normal;"><u>Input Mode</u></span>
 
  
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''port''.
 
  
Choose how your switches are connected.
+
==Macro reference==
  
PORT = Single port byte for all switches - pins are allocated in sequence from pin 0 - X
+
===ReadAll===
 +
{| 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;" | '''ReadAll'''
 +
|-
 +
| colspan="2" | Reads all of the switches at once, returning a byte containing one bit per switch.&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''
 +
|}
  
Custom = Individual pin by pin connections
 
  
<span style="font-weight: normal;"><u>Port</u></span>
+
===ReadState===
 +
{| 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;" | '''ReadState'''
 +
|-
 +
| colspan="2" | Read the state of the switch at the given index.&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-bool-icon.png]] - BOOL
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
This property is of type ''Digital port byte'' and can be referenced with the variable name ''PortByte''.
 
  
''<span style="color:red;">No additional information</span>''
+
===WaitUntilHigh===
 +
{| 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;" | '''WaitUntilHigh'''
 +
|-
 +
| colspan="2" | Pause the program until the switch at the given index is turned on.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[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''
 +
|}
 +
 
 +
 
 +
===WaitUntilLow===
 +
{| 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;" | '''WaitUntilLow'''
 +
|-
 +
| colspan="2" | Pause the program until the switch at the given index is turned on.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[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''
 +
|}
 +
 
 +
 
 +
==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" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
 +
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 +
| width="90%" | Input Mode
 +
|-
 +
| colspan="2" | Choose how your switches are connected. PORT = Single port byte for all switches - pins are allocated in sequence from pin 0 - X Custom = Individual pin by pin connections&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-19-icon.png]]
 +
| width="90%" | Port
 +
|-
 +
| colspan="2" | &nbsp;
 +
|}

Latest revision as of 13:10, 7 February 2023

Author Matrix TSL
Version 1.0
Category E-blocks 2


Switch component

A set of 8 push switches that can be connected to an E-blocks 2 upstream board via a port connector. Switches are wired in an active high configuration.

Component Source Code

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

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

Detailed description

No detailed description exists yet for this component

Examples

No additional examples







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-conn-icon.png Connections
Fc9-type-16-icon.png Input Mode
Choose how your switches are connected. PORT = Single port byte for all switches - pins are allocated in sequence from pin 0 - X Custom = Individual pin by pin connections 
Fc9-type-19-icon.png Port