demo.py

#!/usr/bin/env python3

# Raspberry Pi Python 3 TM1637 quad 7-segment LED display driver examples
from time import sleep

import tm1637

CLK = 1
DIO = 0
DELAY = 0.5

tm = tm1637.TM1637(clk=CLK, dio=DIO)

# all segments on "88:88"
tm.write([127, 255, 127, 127])
tm.write(bytearray([127, 255, 127, 127]))
tm.write(b'\x7F\xFF\x7F\x7F')
tm.show('8888', True)
tm.numbers(88, 88, True)
sleep(DELAY)

# all segments off
tm.write([0, 0, 0, 0])
tm.show('    ')
sleep(DELAY)

# write to the 2nd and 3rd segments only
tm.write([119, 124], 1)  # _Ab_
sleep(DELAY)
tm.write([0, 0, 0, 0])
tm.write([124], 2)  # __b_
sleep(DELAY)
tm.write([119], 1)  # _A__
sleep(DELAY)

# display "0123"
tm.write([63, 6, 91, 79])
tm.write(bytearray([63, 6, 91, 79]))
tm.write(b'\x3F\x06\x5B\x4F')
sleep(DELAY)
tm.show('1234')
tm.number(1234)
tm.numbers(12, 34, False)
sleep(DELAY)

# display "4567"
tm.write([102, 109, 125, 7])
sleep(DELAY)
tm.write([0, 0, 0, 0])
tm.write([102], 0)  # 4___
sleep(DELAY)
tm.write([109], 1)  # _5__
sleep(DELAY)
tm.write([125], 2)  # __6_
sleep(DELAY)
tm.write([7], 3)  # ___7
sleep(DELAY)

# set middle two segments to "12", ie "4127"
tm.write([6, 91], 1)  # _12_
sleep(DELAY)

# set last segment to "9", ie "4129"
tm.write([111], 3)  # ___9
sleep(DELAY)

# walk through all possible LED combinations
for i in range(128):
    tm.number(i)
    tm.write([i])
    sleep(0.1)

# show "AbCd"
tm.write([119, 124, 57, 94])
tm.show('abcd')
sleep(DELAY)

# show "COOL"
tm.write([0b00111001, 0b00111111, 0b00111111, 0b00111000])
tm.write([0x39, 0x3F, 0x3F, 0x38])
tm.write(b'\x39\x3F\x3F\x38')
tm.write([57, 63, 63, 56])
tm.show('cool')
tm.show('COOL')
sleep(DELAY)

# display "dEAd", "bEEF"
tm.hex(0xdead)
sleep(DELAY)
tm.hex(0xbeef)
sleep(DELAY)
tm.show('dead')
sleep(DELAY)
tm.show('Beef')
sleep(DELAY)

# show "12:59"
tm.numbers(12, 59)
tm.show('1259', True)
sleep(DELAY)

# show "-123"
tm.number(-123)
tm.show('-123')
sleep(DELAY)

# Show Help
tm.show('Help')
tm.write(tm.encode_string('Help'))
tm.write([tm.encode_char('H'), tm.encode_char('e'), tm.encode_char('l'), tm.encode_char('p')])
sleep(DELAY)

# Scroll Hello World from right to left
tm.scroll('Hello World')  # 4 fps
tm.scroll('Hello World', 1000)  # 1 fps

# Scroll all available characters
tm.scroll(list(tm1637._SEGMENTS))

# all LEDs dim
tm.brightness(0)
sleep(DELAY)

# all LEDs bright
tm.brightness(7)
sleep(DELAY)

# converts a digit 0-0x0f to a byte representing a single segment
# use write() to render the byte on a single segment
tm.encode_digit(0)
# 63

tm.encode_digit(8)
# 127

tm.encode_digit(0x0f)
# 113

# 15 or 0x0f generates a segment that can output a F character
tm.encode_digit(15)
# 113

tm.encode_digit(0x0f)
# 113

# used to convert a 1-4 length string to an array of segments
tm.encode_string('   1')
# bytearray(b'\x00\x00\x00\x06')

tm.encode_string('2   ')
# bytearray(b'[\x00\x00\x00')

tm.encode_string('1234')
# bytearray(b'\x06[Of')

tm.encode_string('-12-')
# bytearray(b'@\x06[@')

tm.encode_string('cafe')
# bytearray(b'9wqy')

tm.encode_string('CAFE')
# bytearray(b'9wqy')

tm.encode_string('a')
# bytearray(b'w\x00\x00\x00')

tm.encode_string('ab')
# bytearray(b'w|\x00\x00')

# used to convert a single character to a segment byte
tm.encode_char('1')
# 6

tm.encode_char('9')
# 111

tm.encode_char('-')
# 64

tm.encode_char('a')
# 119

tm.encode_char('F')
# 113

# display "dEAd", "bEEF", "CAFE" and "bAbE"
tm.hex(0xdead)
sleep(DELAY)
tm.hex(0xbeef)
sleep(DELAY)
tm.hex(0xcafe)
sleep(DELAY)
tm.hex(0xbabe)
sleep(DELAY)

# show "00FF" (hex right aligned)
tm.hex(0xff)
sleep(DELAY)

# show "   1" (numbers right aligned)
tm.number(1)
sleep(DELAY)

# show "  12"
tm.number(12)
sleep(DELAY)

# show " 123"
tm.number(123)
sleep(DELAY)

# show "9999" capped at 9999
tm.number(20000)
sleep(DELAY)

# show "  -1"
tm.number(-1)
sleep(DELAY)

# show " -12"
tm.number(-12)
sleep(DELAY)

# show "-123"
tm.number(-123)
sleep(DELAY)

# show "-999" capped at -999
tm.number(-1234)
sleep(DELAY)

# show "01:02"
tm.numbers(1, 2)
sleep(DELAY)

# show "0102"
tm.numbers(1, 2, False)
sleep(DELAY)

# show "-5:11"
tm.numbers(-5, 11)
sleep(DELAY)

# show "12:59"
tm.numbers(12, 59)
sleep(DELAY)

# show temperature '24*C'
tm.temperature(24)
sleep(DELAY)
tm.show('24*C')
sleep(DELAY)

# show temperature works for range -9 to +99
tm.temperature(-10)  # LO*C
sleep(DELAY)
tm.temperature(-9)  # -9*C
sleep(DELAY)
tm.temperature(5)  # 5*C
sleep(DELAY)
tm.temperature(99)  # 99*C
sleep(DELAY)
tm.temperature(100)  # HI*C
sleep(DELAY)