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

From Flowcode Help
Jump to navigationJump to search
(XML import)
 
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 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 Pack==
−
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==
+
BASICIO
−
''<span style="color:red;">No additional examples</span>''
 
  
 +
==Detailed description==
  
−
==Downloadable macro reference==
+
''No detailed description exists yet for this component''
  
−
===<span style="font-weight: normal;"><u><tt>ShowDigits</tt></u></span>===
+
==Examples==
−
Set the number and decimal point to be displayed in the given digit of the display.
 
  
−
'''Parameters'''
 
  
−
:[[Variable Types|BYTE]] ''Value0''
+
''<span style="color:red;">No additional examples</span>''
−
::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''
+
==Downloadable macro reference==
−
::The number value to set the digit to (0...15), 16=Clear
 
  
−
:[[Variable Types|BYTE]] ''Value3''
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
−
::The number value to set the digit to (0...15), 16=Clear
+
|-
 +
| 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''
 +
|}
  
−
:[[Variable Types|BYTE]] ''Value4''
 
−
::The number value to set the digit to (0...15), 16=Clear
 
  
−
:[[Variable Types|BYTE]] ''Value5''
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
−
::The number value to set the digit to (0...15), 16=Clear
+
|-
 +
| 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''
 +
|}
  
−
:[[Variable Types|BYTE]] ''DecimalPoint''
 
−
::Bit field containing the states of the decimal points.
 
  
 +
{| 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''
 +
|}
  
−
'''Return value'''
 
  
−
:''This call does not return a value''
+
{| 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><tt>ReadSwitches</tt></u></span>===
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
−
Samples the switches and returns a value from 0-16.
+
|-
−
 
+
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
−
0 indicates that no switches are pressed.
+
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ShowDigit'''
−
 
+
|-
−
1 - 16 indicates that a switch is pressed and provides the index of the switch.
+
| 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;
−
 
+
|-
−
Only one switch can be pressed at any time.
+
|-
−
 
+
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
−
'''Parameters'''
+
| width="90%" | Digit
−
 
+
|-
−
:''This macro has no parameters''
+
| colspan="2" | Which of the digits to change. (0...5)&nbsp;
−
 
+
|-
−
 
+
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
−
'''Return value'''
+
| width="90%" | Value
−
 
+
|-
−
:[[Variable Types|BYTE]]
+
| 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
−
===<span style="font-weight: normal;"><u><tt>SetBrightness</tt></u></span>===
+
| width="90%" | DecimalPoint
−
Controls the brightness of the 7-seg displays
+
|-
−
 
+
| colspan="2" | Whether to show the decimal point.&nbsp;
−
'''Parameters'''
+
|-
−
 
+
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
−
:[[Variable Types|BYTE]] ''Brightness''
+
| width="90%" style="border-top: 2px solid #000;" | ''Return''
−
::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''
 
−
::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==
 
==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''.
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
−
 
+
|-
−
Set this according to the specification of your hardware display.
+
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
−
 
+
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''  
−
Common Anode:  Pin true -> LED Off,  Pin false -> LED On
+
|-
−
 
+
|-
−
Common Cathode:  Pin true -> LED On,  Pin false -> LED Off
+
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
−
 
+
| width="90%" | Display Type
−
<span style="font-weight: normal;"><u>Show Seg Labels</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 ''True or false'' and can be referenced with the variable name ''ShowSegLabels''.
+
|-
−
 
+
| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
−
Show segment name labels overlayed over the component.
+
| width="90%" | Show Seg Labels
−
 
+
|-
−
<span style="font-weight: normal;"><u>DIO</u></span>
+
| colspan="2" | Show segment name labels overlayed over the component.&nbsp;
−
 
+
|-
−
This property is of type ''Single digital pin'' and can be referenced with the variable name ''DATA_PIN''.
+
| width="10%" align="center" | [[File:Fc9-type-1-icon.png]]
−
 
+
| width="90%" | LED Color
−
Data Pin connection to TM1637 IC
+
|-
−
 
+
| colspan="2" | Color of the LED segments when truned on.  When off, they use a much darker shade of the same hue.&nbsp;
−
<span style="font-weight: normal;"><u>CLK</u></span>
+
|-
−
 
+
| width="10%" align="center" | [[File:Fc9-type-1-icon.png]]
−
This property is of type ''Single digital pin'' and can be referenced with the variable name ''CLK_PIN''.
+
| width="90%" | Body Color
−
 
+
|-
−
Clock Pin connection to TM1637 IC
+
| colspan="2" | Color of the plastic casing containing the LEDs.&nbsp;
−
 
+
|-
−
<span style="font-weight: normal;"><u>LED Color</u></span>
+
| width="10%" align="center" | [[File:Fc9-type-1-icon.png]]
−
 
+
| width="90%" | Label Color
−
This property is of type ''Color picker'' and can be referenced with the variable name ''FGColor''.
+
|-
−
 
+
| colspan="2" | Color for the optional LED segment labels.&nbsp;
−
Color of the LED segments when truned on.  When off, they use a much darker shade of the same hue.
+
|-
−
 
+
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-conn-icon.png]]
−
<span style="font-weight: normal;"><u>Body Color</u></span>
+
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Connections'''  
−
 
+
|-
−
This property is of type ''Color picker'' and can be referenced with the variable name ''BGColor''.
+
|-
−
 
+
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
−
Color of the plastic casing containing the LEDs.
+
| width="90%" | DIO
−
 
+
|-
−
<span style="font-weight: normal;"><u>Label Color</u></span>
+
| colspan="2" | Data Pin connection to TM1637 IC&nbsp;
−
 
+
|-
−
This property is of type ''Color picker'' and can be referenced with the variable name ''LabelColor''.
+
| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
−
 
+
| width="90%" | CLK
−
Color for the optional LED segment labels.
+
|-
 +
| colspan="2" | Clock Pin connection to TM1637 IC&nbsp;
 +
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-conn-icon.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Simulations'''  
 +
|-
 +
|}

Revision as of 16:31, 7 January 2022

Author Matrix Ltd
Version 1.0
Category Segment


7Segment 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 Pack

BASICIO

Detailed description

No detailed description exists yet for this component

Examples

No additional examples


Downloadable macro reference

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


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


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


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


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



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-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. 
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 Simulations
Retrieved from "https://www.flowcode.co.uk/wiki/index.php?title=Component:_7Segment_(Hex_TM1637)_(Segment)&oldid=28184"