Difference between revisions of "Component: 7Segment (Hex TM1637) (Segment)"

From Flowcode Help
Jump to navigationJump to search
(XML import)
 
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
 
+
{| style="width:50%"
−
 
 
−
{| width="50%"
 
 
|-
 
|-
−
| width="20%" style="color: gray;" | Author
+
| width="20%" style="color:gray;" | Author
 
| Matrix Ltd
 
| Matrix Ltd
 
|-
 
|-
−
| 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
 
| Segment
 
| Segment
 
|}
 
|}
  
  
 +
==7Segment (Hex TM1637) component==
 +
Hex seven segment display using an two pin communications bus to reduce the number of control pins. Also provides up to 16 individual input switches. Driven using a TM1637 hex 7-segment display driver.
  
−
==[[File:Component Icon 4de4697e_2de3_432e_a0fe_97ef8c79dfc0.png|Image]] 7Segment (Hex TM1637) component==
+
==Component Source Code==
−
Hex seven segment display using an two pin communications bus to reduce the number of control pins.
 
−
Also provides up to 16 individual input switches.
 
−
Driven using a TM1637 hex 7-segment display driver.
 
  
−
==Examples==
+
Please click here to download the component source project: [https://www.flowcode.co.uk/wiki/componentsource/FC_Comp_Source_TM1637_7SEG_Hex_Driver.fcfx FC_Comp_Source_TM1637_7SEG_Hex_Driver.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_TM1637_7SEG_Hex_Driver.fcfx FC_Comp_Source_TM1637_7SEG_Hex_Driver.fcfx]
  
−
==Downloadable macro reference==
+
==Detailed description==
  
−
===<span style="font-weight: normal;"><u><tt>ShowDigits</tt></u></span>===
 
−
Set the number and decimal point to be displayed in the given digit of the display.
 
  
−
'''Parameters'''
 
  
−
:[[Variable Types|BYTE]] ''Value0''
 
−
::The number value to set the digit to (0...15), 16=Clear
 
  
−
:[[Variable Types|BYTE]] ''Value1''
 
−
::The number value to set the digit to (0...15), 16=Clear
 
  
−
:[[Variable Types|BYTE]] ''Value2''
 
−
::The number value to set the digit to (0...15), 16=Clear
 
  
−
:[[Variable Types|BYTE]] ''Value3''
 
−
::The number value to set the digit to (0...15), 16=Clear
 
  
−
:[[Variable Types|BYTE]] ''Value4''
 
−
::The number value to set the digit to (0...15), 16=Clear
 
  
−
:[[Variable Types|BYTE]] ''Value5''
 
−
::The number value to set the digit to (0...15), 16=Clear
 
  
−
:[[Variable Types|BYTE]] ''DecimalPoint''
 
−
::Bit field containing the states of the decimal points.
 
  
  
−
'''Return value'''
 
  
−
:''This call does not return a value''
 
  
  
−
===<span style="font-weight: normal;"><u><tt>ReadSwitches</tt></u></span>===
 
−
Samples the switches and returns a value from 0-16.
 
  
−
0 indicates that no switches are pressed.
 
  
−
1 - 16 indicates that a switch is pressed and provides the index of the switch.
 
  
−
Only one switch can be pressed at any time.
 
  
−
'''Parameters'''
 
  
−
:''This macro has no parameters''
 
  
  
−
'''Return value'''
+
''No detailed description exists yet for this component''
  
−
:[[Variable Types|BYTE]]
+
==Examples==
  
  
−
===<span style="font-weight: normal;"><u><tt>SetBrightness</tt></u></span>===
 
−
Controls the brightness of the 7-seg displays
 
  
−
'''Parameters'''
 
  
−
:[[Variable Types|BYTE]] ''Brightness''
 
−
::Range: 0-7 - 0=Darkest, 7=Brightest
 
  
−
:[[Variable Types|BOOL]] ''On''
 
−
::0 = Display Off, 1 = Display On
 
  
  
−
'''Return value'''
 
  
−
:''This call does not return a value''
 
  
  
−
===<span style="font-weight: normal;"><u><tt>ShowSegments</tt></u></span>===
 
−
Allows for manual control over the display segments.
 
  
−
The colon character can also be controlled when writing to digit 1.
 
  
−
'''Parameters'''
 
  
−
:[[Variable Types|BYTE]] ''Digit''
 
−
::Which of the digits to change. (0...5)
 
  
−
:[[Variable Types|BYTE]] ''Segments''
 
−
::The binary segment value to display
 
  
  
−
'''Return value'''
 
  
−
:''This call does not return a value''
 
  
  
−
===<span style="font-weight: normal;"><u><tt>ShowDigit</tt></u></span>===
 
−
Set the number to be displayed in the given digit of the display.
 
  
−
The colon character can also be controlled when writing to digit 1.
 
  
−
'''Parameters'''
 
  
−
:[[Variable Types|BYTE]] ''Digit''
+
''<span style="color:red;">No additional examples</span>''
−
::Which of the digits to change. (0...5)
 
  
−
:[[Variable Types|BYTE]] ''Value''
 
−
::The number value to set the digit to (0...15), 16=Clear
 
  
−
:[[Variable Types|BYTE]] ''DecimalPoint''
 
−
::Whether to show the decimal point.
 
  
  
−
'''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>Display Type</u></span>
 
  
−
This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''Display_Type''.
+
==Macro reference==
  
−
Set this according to the specification of your hardware display.
+
===ReadSwitches===
 +
{| 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;" | '''ReadSwitches'''
 +
|-
 +
| colspan="2" | Samples the switches and returns a value from 0-16. 0 indicates that no switches are pressed. 1 - 16 indicates that a switch is pressed and provides the index of the switch. Only one switch can be pressed at any time.&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''
 +
|}
  
−
Common Anode:  Pin true -> LED Off,  Pin false -> LED On
 
  
−
Common Cathode: Pin true -> LED On, Pin false -> LED Off
+
===SetBrightness===
 +
{| 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;" | '''SetBrightness'''
 +
|-
 +
| colspan="2" | Controls the brightness of the 7-seg displays&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Brightness
 +
|-
 +
| colspan="2" | Range: 0-7 - 0=Darkest, 7=Brightest&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-bool-icon.png]] - BOOL
 +
| width="90%" | On
 +
|-
 +
| colspan="2" | 0 = Display Off, 1 = Display On&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''
 +
|}
  
−
<span style="font-weight: normal;"><u>Show Seg Labels</u></span>
 
  
−
This property is of type ''True or false'' and can be referenced with the variable name ''ShowSegLabels''.
+
===ShowDigit===
 +
{| 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;" | '''ShowDigit'''
 +
|-
 +
| colspan="2" | Set the number to be displayed in the given digit of the display. The colon character can also be controlled when writing to digit 1.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Digit
 +
|-
 +
| colspan="2" | Which of the digits to change. (0...5)&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Value
 +
|-
 +
| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | DecimalPoint
 +
|-
 +
| colspan="2" | Whether to show the decimal point.&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''
 +
|}
  
−
Show segment name labels overlayed over the component.
 
  
−
<span style="font-weight: normal;"><u>DIO</u></span>
+
===ShowDigits===
 +
{| 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;" | '''ShowDigits'''
 +
|-
 +
| colspan="2" | Set the number and decimal point to be displayed in the given digit of the display.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Value0
 +
|-
 +
| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Value1
 +
|-
 +
| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Value2
 +
|-
 +
| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Value3
 +
|-
 +
| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Value4
 +
|-
 +
| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Value5
 +
|-
 +
| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | DecimalPoint
 +
|-
 +
| colspan="2" | Bit field containing the states of the decimal points.&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''
 +
|}
  
−
This property is of type ''Single digital pin'' and can be referenced with the variable name ''DATA_PIN''.
 
  
−
Data Pin connection to TM1637 IC
+
===ShowSegments===
 +
{| 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;" | '''ShowSegments'''
 +
|-
 +
| colspan="2" | Allows for manual control over the display segments. The colon character can also be controlled when writing to digit 1.&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Digit
 +
|-
 +
| colspan="2" | Which of the digits to change. (0...5)&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
 +
| width="90%" | Segments
 +
|-
 +
| colspan="2" | The binary segment value to display&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''
 +
|}
  
−
<span style="font-weight: normal;"><u>CLK</u></span>
 
  
−
This property is of type ''Single digital pin'' and can be referenced with the variable name ''CLK_PIN''.
+
==Property reference==
  
−
Clock Pin connection to TM1637 IC
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
−
 
+
|-
−
<span style="font-weight: normal;"><u>LED Color</u></span>
+
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
−
 
+
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
−
This property is of type ''Color picker'' and can be referenced with the variable name ''FGColor''.
+
|-
−
 
+
|-
−
Color of the LED segments when truned on.  When off, they use a much darker shade of the same hue.
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
−
 
+
| width="90%" | Display Type
−
<span style="font-weight: normal;"><u>Body Color</u></span>
+
|-
−
 
+
| colspan="2" | Set this according to the specification of your hardware display. Common Anode:  Pin true -> LED Off,  Pin false -> LED On Common Cathode:  Pin true -> LED On,  Pin false -> LED Off&nbsp;
−
This property is of type ''Color picker'' and can be referenced with the variable name ''BGColor''.
+
|-
−
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
−
Color of the plastic casing containing the LEDs.
+
| width="90%" | Show Seg Labels
−
 
+
|-
−
<span style="font-weight: normal;"><u>Label Color</u></span>
+
| colspan="2" | Show segment name labels overlayed over the component.&nbsp;
−
 
+
|-
−
This property is of type ''Color picker'' and can be referenced with the variable name ''LabelColor''.
+
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
−
 
+
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections
−
Color for the optional LED segment labels.
+
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
 +
| width="90%" | DIO
 +
|-
 +
| colspan="2" | Data Pin connection to TM1637 IC&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
 +
| width="90%" | CLK
 +
|-
 +
| colspan="2" | Clock Pin connection to TM1637 IC&nbsp;
 +
|-
 +
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
 +
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Colors
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-1-icon.png]]
 +
| width="90%" | LED Color
 +
|-
 +
| colspan="2" | Color of the LED segments when truned on.  When off, they use a much darker shade of the same hue.&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-1-icon.png]]
 +
| width="90%" | Body Color
 +
|-
 +
| colspan="2" | Color of the plastic casing containing the LEDs.&nbsp;
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-type-1-icon.png]]
 +
| width="90%" | Label Color
 +
|-
 +
| colspan="2" | Color for the optional LED segment labels.&nbsp;
 +
|}

Latest revision as of 13:13, 7 February 2023

Author Matrix Ltd
Version 1.0
Category Segment


7Segment (Hex TM1637) component

Hex seven segment display using an two pin communications bus to reduce the number of control pins. Also provides up to 16 individual input switches. Driven using a TM1637 hex 7-segment display driver.

Component Source Code

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

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

Detailed description

No detailed description exists yet for this component

Examples

No additional examples







Macro reference

ReadSwitches

Fc9-comp-macro.png ReadSwitches
Samples the switches and returns a value from 0-16. 0 indicates that no switches are pressed. 1 - 16 indicates that a switch is pressed and provides the index of the switch. Only one switch can be pressed at any time. 
Fc9-u8-icon.png - BYTE Return


SetBrightness

Fc9-comp-macro.png SetBrightness
Controls the brightness of the 7-seg displays 
Fc9-u8-icon.png - BYTE Brightness
Range: 0-7 - 0=Darkest, 7=Brightest 
Fc9-bool-icon.png - BOOL On
0 = Display Off, 1 = Display On 
Fc9-void-icon.png - VOID Return


ShowDigit

Fc9-comp-macro.png ShowDigit
Set the number to be displayed in the given digit of the display. The colon character can also be controlled when writing to digit 1. 
Fc9-u8-icon.png - BYTE Digit
Which of the digits to change. (0...5) 
Fc9-u8-icon.png - BYTE Value
The number value to set the digit to (0...15), 16=Clear 
Fc9-u8-icon.png - BYTE DecimalPoint
Whether to show the decimal point. 
Fc9-void-icon.png - VOID Return


ShowDigits

Fc9-comp-macro.png ShowDigits
Set the number and decimal point to be displayed in the given digit of the display. 
Fc9-u8-icon.png - BYTE Value0
The number value to set the digit to (0...15), 16=Clear 
Fc9-u8-icon.png - BYTE Value1
The number value to set the digit to (0...15), 16=Clear 
Fc9-u8-icon.png - BYTE Value2
The number value to set the digit to (0...15), 16=Clear 
Fc9-u8-icon.png - BYTE Value3
The number value to set the digit to (0...15), 16=Clear 
Fc9-u8-icon.png - BYTE Value4
The number value to set the digit to (0...15), 16=Clear 
Fc9-u8-icon.png - BYTE Value5
The number value to set the digit to (0...15), 16=Clear 
Fc9-u8-icon.png - BYTE DecimalPoint
Bit field containing the states of the decimal points. 
Fc9-void-icon.png - VOID Return


ShowSegments

Fc9-comp-macro.png ShowSegments
Allows for manual control over the display segments. The colon character can also be controlled when writing to digit 1. 
Fc9-u8-icon.png - BYTE Digit
Which of the digits to change. (0...5) 
Fc9-u8-icon.png - BYTE Segments
The binary segment value to display 
Fc9-void-icon.png - VOID Return


Property reference

Fc9-prop-icon.png Properties
Fc9-type-16-icon.png Display Type
Set this according to the specification of your hardware display. Common Anode: Pin true -> LED Off, Pin false -> LED On Common Cathode: Pin true -> LED On, Pin false -> LED Off 
Fc9-type-7-icon.png Show Seg Labels
Show segment name labels overlayed over the component. 
Fc9-conn-icon.png Connections
Fc9-type-5-icon.png DIO
Data Pin connection to TM1637 IC 
Fc9-type-5-icon.png CLK
Clock Pin connection to TM1637 IC 
Fc9-conn-icon.png Colors
Fc9-type-1-icon.png LED Color
Color of the LED segments when truned on. When off, they use a much darker shade of the same hue. 
Fc9-type-1-icon.png Body Color
Color of the plastic casing containing the LEDs. 
Fc9-type-1-icon.png Label Color
Color for the optional LED segment labels. 
Retrieved from "https://www.flowcode.co.uk/wiki/index.php?title=Component:_7Segment_(Hex_TM1637)_(Segment)&oldid=38364"