204 lines
7.1 KiB
Python
204 lines
7.1 KiB
Python
# Copyright (c) 2014 Adafruit Industries
|
|
# Author: Tony DiCola
|
|
#
|
|
# Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
# of this software and associated documentation files (the "Software"), to deal
|
|
# in the Software without restriction, including without limitation the rights
|
|
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
# copies of the Software, and to permit persons to whom the Software is
|
|
# furnished to do so, subject to the following conditions:
|
|
#
|
|
# The above copyright notice and this permission notice shall be included in
|
|
# all copies or substantial portions of the Software.
|
|
#
|
|
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
# THE SOFTWARE.
|
|
from . import HT16K33
|
|
|
|
|
|
# Digit value to bitmask mapping:
|
|
DIGIT_VALUES = {
|
|
' ': 0x00,
|
|
'-': 0x40,
|
|
'0': 0x3F,
|
|
'1': 0x06,
|
|
'2': 0x5B,
|
|
'3': 0x4F,
|
|
'4': 0x66,
|
|
'5': 0x6D,
|
|
'6': 0x7D,
|
|
'7': 0x07,
|
|
'8': 0x7F,
|
|
'9': 0x6F,
|
|
'A': 0x77,
|
|
'B': 0x7C,
|
|
'C': 0x39,
|
|
'D': 0x5E,
|
|
'E': 0x79,
|
|
'F': 0x71
|
|
}
|
|
|
|
IDIGIT_VALUES = {
|
|
' ': 0x00,
|
|
'-': 0x40,
|
|
'0': 0x3F,
|
|
'1': 0x30,
|
|
'2': 0x5B,
|
|
'3': 0x79,
|
|
'4': 0x74,
|
|
'5': 0x6D,
|
|
'6': 0x6F,
|
|
'7': 0x38,
|
|
'8': 0x7F,
|
|
'9': 0x7D,
|
|
'A': 0x7E,
|
|
'B': 0x67,
|
|
'C': 0x0F,
|
|
'D': 0x73,
|
|
'E': 0x4F,
|
|
'F': 0x4E
|
|
}
|
|
|
|
|
|
|
|
class SevenSegment(HT16K33.HT16K33):
|
|
"""Seven segment LED backpack display."""
|
|
|
|
def __init__(self, invert=False, **kwargs):
|
|
"""Initialize display. All arguments will be passed to the HT16K33 class
|
|
initializer, including optional I2C address and bus number parameters.
|
|
"""
|
|
super(SevenSegment, self).__init__(**kwargs)
|
|
self.invert = invert
|
|
|
|
def set_invert(self, _invert):
|
|
"""Set whether the display is upside-down or not.
|
|
"""
|
|
self.invert = _invert
|
|
|
|
def set_digit_raw(self, pos, bitmask):
|
|
"""Set digit at position to raw bitmask value. Position should be a value
|
|
of 0 to 3 with 0 being the left most digit on the display."""
|
|
if pos < 0 or pos > 3:
|
|
# Ignore out of bounds digits.
|
|
return
|
|
# Jump past the colon at position 2 by adding a conditional offset.
|
|
offset = 0 if pos < 2 else 1
|
|
|
|
# Calculate the correct position depending on orientation
|
|
if self.invert:
|
|
pos = 4-(pos+offset)
|
|
else:
|
|
pos = pos+offset
|
|
|
|
# Set the digit bitmask value at the appropriate position.
|
|
self.buffer[pos*2] = bitmask & 0xFF
|
|
|
|
def set_decimal(self, pos, decimal):
|
|
"""Turn decimal point on or off at provided position. Position should be
|
|
a value 0 to 3 with 0 being the left most digit on the display. Decimal
|
|
should be True to turn on the decimal point and False to turn it off.
|
|
"""
|
|
if pos < 0 or pos > 3:
|
|
# Ignore out of bounds digits.
|
|
return
|
|
# Jump past the colon at position 2 by adding a conditional offset.
|
|
offset = 0 if pos < 2 else 1
|
|
|
|
# Calculate the correct position depending on orientation
|
|
if self.invert:
|
|
pos = 4-(pos+offset)
|
|
else:
|
|
pos = pos+offset
|
|
|
|
# Set bit 7 (decimal point) based on provided value.
|
|
if decimal:
|
|
self.buffer[pos*2] |= (1 << 7)
|
|
else:
|
|
self.buffer[pos*2] &= ~(1 << 7)
|
|
|
|
def set_digit(self, pos, digit, decimal=False):
|
|
"""Set digit at position to provided value. Position should be a value
|
|
of 0 to 3 with 0 being the left most digit on the display. Digit should
|
|
be a number 0-9, character A-F, space (all LEDs off), or dash (-).
|
|
"""
|
|
if self.invert:
|
|
self.set_digit_raw(pos, IDIGIT_VALUES.get(str(digit).upper(), 0x00))
|
|
else:
|
|
self.set_digit_raw(pos, DIGIT_VALUES.get(str(digit).upper(), 0x00))
|
|
|
|
if decimal:
|
|
self.set_decimal(pos, True)
|
|
|
|
def set_colon(self, show_colon):
|
|
"""Turn the colon on with show colon True, or off with show colon False."""
|
|
if show_colon:
|
|
self.buffer[4] |= 0x02
|
|
else:
|
|
self.buffer[4] &= (~0x02) & 0xFF
|
|
|
|
def set_left_colon(self, show_colon):
|
|
"""Turn the left colon on with show color True, or off with show colon
|
|
False. Only the large 1.2" 7-segment display has a left colon.
|
|
"""
|
|
if show_colon:
|
|
self.buffer[4] |= 0x04
|
|
self.buffer[4] |= 0x08
|
|
else:
|
|
self.buffer[4] &= (~0x04) & 0xFF
|
|
self.buffer[4] &= (~0x08) & 0xFF
|
|
|
|
def set_fixed_decimal(self, show_decimal):
|
|
"""Turn on/off the single fixed decimal point on the large 1.2" 7-segment
|
|
display. Set show_decimal to True to turn on and False to turn off.
|
|
Only the large 1.2" 7-segment display has this decimal point (in the
|
|
upper right in the normal orientation of the display).
|
|
"""
|
|
if show_decimal:
|
|
self.buffer[4] |= 0x10
|
|
else:
|
|
self.buffer[4] &= (~0x10) & 0xFF
|
|
|
|
def print_number_str(self, value, justify_right=True):
|
|
"""Print a 4 character long string of numeric values to the display.
|
|
Characters in the string should be any supported character by set_digit,
|
|
or a decimal point. Decimal point characters will be associated with
|
|
the previous character.
|
|
"""
|
|
# Calculate length of value without decimals.
|
|
length = sum(map(lambda x: 1 if x != '.' else 0, value))
|
|
# Error if value without decimals is longer than 4 characters.
|
|
if length > 4:
|
|
self.print_number_str('----')
|
|
return
|
|
# Calculcate starting position of digits based on justification.
|
|
pos = (4-length) if justify_right else 0
|
|
# Go through each character and print it on the display.
|
|
for i, ch in enumerate(value):
|
|
if ch == '.':
|
|
# Print decimal points on the previous digit.
|
|
self.set_decimal(pos-1, True)
|
|
else:
|
|
self.set_digit(pos, ch)
|
|
pos += 1
|
|
|
|
def print_float(self, value, decimal_digits=2, justify_right=True):
|
|
"""Print a numeric value to the display. If value is negative
|
|
it will be printed with a leading minus sign. Decimal digits is the
|
|
desired number of digits after the decimal point.
|
|
"""
|
|
format_string = '{{0:0.{0}F}}'.format(decimal_digits)
|
|
self.print_number_str(format_string.format(value), justify_right)
|
|
|
|
def print_hex(self, value, justify_right=True):
|
|
"""Print a numeric value in hexadecimal. Value should be from 0 to FFFF.
|
|
"""
|
|
if value < 0 or value > 0xFFFF:
|
|
# Ignore out of range values.
|
|
return
|
|
self.print_number_str('{0:X}'.format(value), justify_right)
|