# SPDX-FileCopyrightText: 2018 Dean Miller for Adafruit Industries
#
# SPDX-License-Identifier: MIT
# pylint: disable=missing-docstring,invalid-name,too-many-public-methods
"""
`adafruit_seesaw.tftshield18` - Pin definitions for 1.8" TFT Shield V2
======================================================================
"""
from collections import namedtuple
import board
try:
from micropython import const
except ImportError:
def const(x):
return x
from adafruit_seesaw.seesaw import Seesaw
__version__ = "0.0.0+auto.0"
__repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_seesaw.git"
_TIMER_BASE = const(0x08)
_TIMER_PWM = const(0x01)
_TIMER_FREQ = const(0x02)
_TFTSHIELD_RESET_PIN = const(3)
_BUTTON_UP = const(5)
_BUTTON_DOWN = const(8)
_BUTTON_LEFT = const(6)
_BUTTON_RIGHT = const(9)
_BUTTON_SELECT = const(7)
_BUTTON_A = const(10)
_BUTTON_B = const(11)
_BUTTON_C = const(14)
Buttons = namedtuple("Buttons", "right down left up select a b c")
[docs]
class TFTShield18(Seesaw):
_BACKLIGHT_ON = b"\xFF\xFF"
_BACKLIGHT_OFF = b"\x00\x00"
try:
_button_mask = (
(1 << _BUTTON_RIGHT)
| (1 << _BUTTON_DOWN)
| (1 << _BUTTON_LEFT)
| (1 << _BUTTON_UP)
| (1 << _BUTTON_SELECT)
| (1 << _BUTTON_A)
| (1 << _BUTTON_B)
| (1 << _BUTTON_C)
)
except TypeError:
# During Sphinx build, the following error occurs:
# File ".../tftshield18.py", line 60, in TFTShield18
# (1 << _BUTTON_B) |
# TypeError: unsupported operand type(s) for <<: 'int' and '_MockObject'
_button_mask = 0xFF
def __init__(self, i2c_bus=None, addr=0x2E):
if i2c_bus is None:
try:
i2c_bus = board.I2C()
except AttributeError as attrError:
raise ValueError("Board has no default I2C bus.") from attrError
super().__init__(i2c_bus, addr)
self.pin_mode(_TFTSHIELD_RESET_PIN, self.OUTPUT)
self.pin_mode_bulk(self._button_mask, self.INPUT_PULLUP)
[docs]
def set_backlight(self, value):
"""
Set the backlight on
"""
if not isinstance(value, bool):
raise ValueError("Value must be of boolean type")
command = self._BACKLIGHT_ON if value else self._BACKLIGHT_OFF
self.write(_TIMER_BASE, _TIMER_PWM, b"\x00" + command)
[docs]
def set_backlight_freq(self, freq):
"""
Set the backlight frequency of the TFT Display
"""
if not isinstance(freq, int):
raise ValueError("Value must be of integer type")
value = b"\x00" + bytearray((freq >> 8) & 0xFF, freq & 0xFF)
self.write(_TIMER_BASE, _TIMER_FREQ, value)
[docs]
def tft_reset(self, rst=True):
"""
Reset the TFT Display
"""
self.digital_write(_TFTSHIELD_RESET_PIN, rst)
@property
def buttons(self):
"""
Return a set of buttons with current push values
"""
button_values = self.digital_read_bulk(self._button_mask)
return Buttons(
*[
not button_values & (1 << button)
for button in (
_BUTTON_RIGHT,
_BUTTON_DOWN,
_BUTTON_LEFT,
_BUTTON_UP,
_BUTTON_SELECT,
_BUTTON_A,
_BUTTON_B,
_BUTTON_C,
)
]
)