Component: 7Segment (Hex TM1637) 2D (Segment): Difference between revisions

Latest revision as of 14:37, 13 July 2026

Author	Matrix Ltd
Version	1.0
Category	Segment

7Segment (Hex TM1637) 2D 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_2dgi.fcfx

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

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

ReadSwitches

	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.
- BYTE	Return

SetBrightness

	SetBrightness
Controls the brightness of the 7-seg displays
- BYTE	Brightness
Range: 0-7 - 0=Darkest, 7=Brightest
- BOOL	On
0 = Display Off, 1 = Display On
- VOID	Return

ShowDigit

	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.
- BYTE	Digit
Which of the digits to change. (0...5)
- BYTE	Value
The number value to set the digit to (0...15), 16=Clear
- BYTE	DecimalPoint
Whether to show the decimal point.
- VOID	Return

ShowDigits

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

ShowSegments

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

Property reference

	Properties
	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
	Show Seg Labels
Show segment name labels overlayed over the component.
	Connections
	DIO
Data Pin connection to TM1637 IC
	CLK
Clock Pin connection to TM1637 IC
	Colors
	LED Color
Color of the LED segments when truned on. When off, they use a much darker shade of the same hue.
	Body Color
Color of the plastic casing containing the LEDs.
	Label Color
Color for the optional LED segment labels.

@@ Line 48: / Line 48: @@
 ''<span style="color:red;">No additional examples</span>''
@@ Line 55: / Line 63: @@
 ==Macro reference==
-===ShowDigits===
+===ReadSwitches===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
+|-
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
+| width="90%" class="mtx-class-macrohead" | '''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''
+|}
+===SetBrightness===
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ShowDigits'''
+| width="90%" class="mtx-class-macrohead" | '''SetBrightness'''
 |-
-| colspan="2" | Set the number and decimal point to be displayed in the given digit of the display.&nbsp;
+| colspan="2" | Controls the brightness of the 7-seg displays&nbsp;
 |-
 |-
 | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | Value0
+| width="90%" | Brightness
 |-
-| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
+| colspan="2" | Range: 0-7 - 0=Darkest, 7=Brightest&nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-bool-icon.png]] - BOOL
-| width="90%" | Value1
+| width="90%" | On
 |-
-| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
+| colspan="2" | 0 = Display Off, 1 = Display On&nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
-| width="90%" | Value2
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+===ShowDigit===
+{| class="mtx-class-macrotable wikitable"
 |-
-| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
+| width="90%" class="mtx-class-macrohead" | '''ShowDigit'''
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| 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="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
+| width="90%" | Digit
 |-
-| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
+| colspan="2" | Which of the digits to change. (0...5)&nbsp;
 |-
 | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | Value5
+| width="90%" | Value
 |-
 | colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
@@ Line 97: / Line 123: @@
 | width="90%" | DecimalPoint
 |-
-| colspan="2" | Bit field containing the states of the decimal points.&nbsp;
+| 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
@@ Line 104: / Line 130: @@
-===ReadSwitches===
+===ShowDigits===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadSwitches'''
+| width="90%" class="mtx-class-macrohead" | '''ShowDigits'''
 |-
-| 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;
+| colspan="2" | Set the number and decimal point to be displayed in the given digit of the display.&nbsp;
 |-
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
+| width="90%" | Value0
-|}
-===SetBrightness===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
-| 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%" | 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%" | Brightness
+| width="90%" | Value2
 |-
-| colspan="2" | Range: 0-7 - 0=Darkest, 7=Brightest&nbsp;
+| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-bool-icon.png]] - BOOL
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | On
+| width="90%" | Value3
 |-
-| colspan="2" | 0 = Display Off, 1 = Display On&nbsp;
+| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
+| width="90%" | Value4
-|}
-===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;
 |-
+| 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%" | Digit
+| width="90%" | Value5
 |-
-| colspan="2" | Which of the digits to change. (0...5)&nbsp;
+| 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%" | Segments
+| width="90%" | DecimalPoint
 |-
-| colspan="2" | The binary segment value to display&nbsp;
+| 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
@@ Line 166: / Line 179: @@
-===ShowDigit===
+===ShowSegments===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ShowDigit'''
+| width="90%" class="mtx-class-macrohead" | '''ShowSegments'''
 |-
-| 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;
+| colspan="2" | Allows for manual control over the display segments. The colon character can also be controlled when writing to digit 1.&nbsp;
 |-
 |-
@@ Line 181: / Line 194: @@
 |-
 | width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | Value
+| width="90%" | Segments
 |-
-| colspan="2" | The number value to set the digit to (0...15), 16=Clear&nbsp;
+| colspan="2" | The binary segment value to display&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''
 |}
 ==Property reference==
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+| width="90%" class="mtx-class-macrohead" | '''Properties'''
 |-
 |-
@@ Line 215: / Line 221: @@
 | colspan="2" | Show segment name labels overlayed over the component.&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections
+| width="90%" class="mtx-class-propfolder" | Connections
 |-
 |-
@@ Line 229: / Line 235: @@
 | colspan="2" | Clock Pin connection to TM1637 IC&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Colors
+| width="90%" class="mtx-class-propfolder" | Colors
 |-
 |-

SteveT (talk | contribs)