Merge pull request #2014 from kattni/feather-tft-code

Adding Feather TFT I2C and TFT code.

Author: kattni

Adafruit_Feather_TFT_ESP32-S2/LC709203_Adafruit_IO/code.py

@@ -0,0 +1,102 @@
+# SPDX-FileCopyrightText: 2021 Kattni Rembor for Adafruit Industries
+# SPDX-License-Identifier: MIT
+"""
+CircuitPython Adafruit IO Example for LC709203 Sensor
+"""
+import time
+import ssl
+import alarm
+import board
+import digitalio
+import wifi
+import socketpool
+import adafruit_requests
+from adafruit_io.adafruit_io import IO_HTTP
+from adafruit_lc709203f import LC709203F, PackSize
+try:
+    from secrets import secrets
+except ImportError:
+    print("WiFi and Adafruit IO credentials are kept in secrets.py, please add them there!")
+    raise
+
+# Duration of sleep in seconds. Default is 600 seconds (10 minutes).
+# Feather will sleep for this duration between sensor readings / sending data to AdafruitIO
+sleep_duration = 600
+
+# Update to match the mAh of your battery for more accurate readings.
+# Can be MAH100, MAH200, MAH400, MAH500, MAH1000, MAH2000, MAH3000.
+# Choose the closest match. Include "PackSize." before it, as shown.
+battery_pack_size = PackSize.MAH400
+
+# Setup the little red LED
+led = digitalio.DigitalInOut(board.LED)
+led.switch_to_output()
+
+# Set up the LC709203 sensor
+battery_monitor = LC709203F(board.I2C())
+battery_monitor.pack_size = battery_pack_size
+
+# Collect the sensor data values and format the data
+battery_voltage = "{:.2f}".format(battery_monitor.cell_voltage)
+battery_percent = "{:.1f}".format(battery_monitor.cell_percent)
+
+
+def go_to_sleep(sleep_period):
+    # Create a an alarm that will trigger sleep_period number of seconds from now.
+    time_alarm = alarm.time.TimeAlarm(monotonic_time=time.monotonic() + sleep_period)
+    # Exit and deep sleep until the alarm wakes us.
+    alarm.exit_and_deep_sleep_until_alarms(time_alarm)
+
+
+# Send the data. Requires a feed name and a value to send.
+def send_io_data(feed, value):
+    return io.send_data(feed["key"], value)
+
+
+# Wi-Fi connections can have issues! This ensures the code will continue to run.
+try:
+    # Connect to Wi-Fi
+    wifi.radio.connect(secrets["ssid"], secrets["password"])
+    print("Connected to {}!".format(secrets["ssid"]))
+    print("IP:", wifi.radio.ipv4_address)
+
+    pool = socketpool.SocketPool(wifi.radio)
+    requests = adafruit_requests.Session(pool, ssl.create_default_context())
+
+# Wi-Fi connectivity fails with error messages, not specific errors, so this except is broad.
+except Exception as e:  # pylint: disable=broad-except
+    print(e)
+    go_to_sleep(60)
+
+# Set your Adafruit IO Username and Key in secrets.py
+# (visit io.adafruit.com if you need to create an account,
+# or if you need your Adafruit IO key.)
+aio_username = secrets["aio_username"]
+aio_key = secrets["aio_key"]
+
+# Initialize an Adafruit IO HTTP API object
+io = IO_HTTP(aio_username, aio_key, requests)
+
+# Turn on the LED to indicate data is being sent.
+led.value = True
+# Print data values to the serial console. Not necessary for Adafruit IO.
+print("Current battery voltage: {0} V".format(battery_voltage))
+print("Current battery percent: {0} %".format(battery_percent))
+
+# Adafruit IO sending can run into issues if the network fails!
+# This ensures the code will continue to run.
+try:
+    print("Sending data to AdafruitIO...")
+    # Send data to Adafruit IO
+    send_io_data(io.create_and_get_feed("battery-voltage"), battery_voltage)
+    send_io_data(io.create_and_get_feed("battery-percent"), battery_percent)
+    print("Data sent!")
+    # Turn off the LED to indicate data sending is complete.
+    led.value = False
+
+# Adafruit IO can fail with multiple errors depending on the situation, so this except is broad.
+except Exception as e:  # pylint: disable=broad-except
+    print(e)
+    go_to_sleep(60)
+
+go_to_sleep(sleep_duration)

Adafruit_Feather_TFT_ESP32-S2/LC709203_Simple_Data/code.py

@@ -0,0 +1,21 @@
+# SPDX-FileCopyrightText: 2021 Kattni Rembor for Adafruit Industries
+# SPDX-License-Identifier: MIT
+"""
+CircuitPython Simple Example for LC709203 Sensor
+"""
+import time
+import board
+from adafruit_lc709203f import LC709203F, PackSize
+
+# Create sensor object, using the board's default I2C bus.
+battery_monitor = LC709203F(board.I2C())
+
+# Update to match the mAh of your battery for more accurate readings.
+# Can be MAH100, MAH200, MAH400, MAH500, MAH1000, MAH2000, MAH3000.
+# Choose the closest match. Include "PackSize." before it, as shown.
+battery_monitor.pack_size = PackSize.MAH400
+
+while True:
+    print("Battery Percent: {:.2f} %".format(battery_monitor.cell_percent))
+    print("Battery Voltage: {:.2f} V".format(battery_monitor.cell_voltage))
+    time.sleep(2)

Adafruit_Feather_TFT_ESP32-S2/TFT_GitHub_Stars/code.py

@@ -0,0 +1,57 @@
+# SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries
+# SPDX-License-Identifier: MIT
+"""
+CircuitPython GitHub Stars viewer
+"""
+import time
+import ssl
+import wifi
+import socketpool
+import displayio
+import board
+from adafruit_display_text import bitmap_label
+from adafruit_bitmap_font import bitmap_font
+import adafruit_requests
+
+# Get WiFi details secrets.py file
+try:
+    from secrets import secrets
+except ImportError:
+    print("WiFi secrets are kept in secrets.py, please add them there!")
+    raise
+
+display = board.DISPLAY
+
+# URL to fetch from
+JSON_STARS_URL = "https://api.github.com/repos/adafruit/circuitpython"
+
+# Set up background image and text
+bitmap = displayio.OnDiskBitmap("/images/stars_background.bmp")
+tile_grid = displayio.TileGrid(bitmap, pixel_shader=bitmap.pixel_shader)
+group = displayio.Group()
+group.append(tile_grid)
+font = bitmap_font.load_font("/fonts/Arial-Bold-24.bdf")
+text_area = bitmap_label.Label(font, text="----", color=0xFFFFFF)
+text_area.x = 125
+text_area.y = 90
+group.append(text_area)
+display.show(group)
+
+# Connect to WiFi
+print("Connecting to %s"%secrets["ssid"])
+wifi.radio.connect(secrets["ssid"], secrets["password"])
+print("Connected to %s!"%secrets["ssid"])
+print("My IP address is", wifi.radio.ipv4_address)
+
+pool = socketpool.SocketPool(wifi.radio)
+requests = adafruit_requests.Session(pool, ssl.create_default_context())
+
+while True:
+    print("Fetching and parsing json from", JSON_STARS_URL)
+    response = requests.get(JSON_STARS_URL)
+    stars = response.json()["stargazers_count"]
+    print("-" * 40)
+    print("CircuitPython GitHub Stars", stars)
+    print("-" * 40)
+    text_area.text = str(stars)
+    time.sleep(120)

Adafruit_Feather_TFT_ESP32-S2/TFT_GitHub_Stars/images/stars_background.bmp

@@ -0,0 +1,21 @@
+# SPDX-FileCopyrightText: 2021 Tim C for Adafruit Industries
+# SPDX-License-Identifier: MIT
+"""
+CircuitPython simple text display demo
+"""
+import board
+import terminalio
+from adafruit_display_text import bitmap_label
+
+# Update this to change the text displayed.
+text = "Hello, World!"
+# Update this to change the size of the text displayed. Must be a whole number.
+scale = 3
+
+text_area = bitmap_label.Label(terminalio.FONT, text=text, scale=scale)
+text_area.x = 10
+text_area.y = 10
+board.DISPLAY.show(text_area)
+
+while True:
+    pass

Adafruit_Feather_TFT_ESP32-S2/TFT_Hello_World/code.py

@@ -0,0 +1,20 @@
+# SPDX-FileCopyrightText: 2021 Tim C for Adafruit Industries
+# SPDX-License-Identifier: MIT
+"""
+CircuitPython simple bitmap display demo
+"""
+import board
+from displayio import OnDiskBitmap, TileGrid, Group
+
+main_group = Group()
+blinka_img = OnDiskBitmap("images/adafruit_blinka.bmp")
+
+tile_grid = TileGrid(bitmap=blinka_img, pixel_shader=blinka_img.pixel_shader)
+main_group.append(tile_grid)
+
+board.DISPLAY.show(main_group)
+
+tile_grid.x = board.DISPLAY.width // 2 - blinka_img.width // 2
+
+while True:
+    pass

Adafruit_Feather_TFT_ESP32-S2/TFT_bitmap_display/code.py

@@ -0,0 +1,32 @@
+# SPDX-FileCopyrightText: 2021 Tim C for Adafruit Industries
+# SPDX-License-Identifier: MIT
+"""
+CircuitPython simple sensor data display demo using LC709203 battery monitor and TFT display
+"""
+import time
+import board
+import terminalio
+from displayio import Group
+from adafruit_display_text import bitmap_label
+from adafruit_lc709203f import LC709203F
+
+text_area = bitmap_label.Label(terminalio.FONT, scale=2)
+text_area.anchor_point = (0.5, 0.5)
+text_area.anchored_position = (board.DISPLAY.width // 2, board.DISPLAY.height // 2)
+
+main_group = Group()
+
+main_group.append(text_area)
+
+print("LC709203F test")
+print("Make sure LiPoly battery is plugged into the board!")
+
+sensor = LC709203F(board.I2C())
+
+print("IC version:", hex(sensor.ic_version))
+
+board.DISPLAY.show(main_group)
+
+while True:
+    text_area.text = "Battery:\n{:.1f} Volts \n{}%".format(sensor.cell_voltage, sensor.cell_percent)
+    time.sleep(1)