From 5a0a3c0d3803a243fa6b51ce4b101e0054a9c2fe Mon Sep 17 00:00:00 2001
From: arofarn <arofarn@arofarn.info>
Date: Sun, 27 Jun 2021 19:02:03 +0200
Subject: [PATCH] Update doc and add example

---
 docs/index.rst                            | 10 +---
 examples/trellism4_extended_simpletest.py | 66 ++++++++++++++++++++++-
 2 files changed, 67 insertions(+), 9 deletions(-)

diff --git a/docs/index.rst b/docs/index.rst
index c00904f..82e20b8 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -21,17 +21,11 @@ Table of Contents
 
     api
 
-.. toctree::
-    :caption: Tutorials
-
-.. todo:: Add any Learn guide links here. If there are none, then simply delete this todo and leave
-    the toctree above for use later.
-
 .. toctree::
     :caption: Related Products
 
-.. todo:: Add any product links here. If there are none, then simply delete this todo and leave
-    the toctree above for use later.
+    Adafruit NeoTrellis M4 Express <https://www.adafruit.com/product/3938>
+    Adafruit NeoTrellis RGB Driver PCB for 4x4 Keypad <https://www.adafruit.com/product/3954>
 
 .. toctree::
     :caption: Other Links
diff --git a/examples/trellism4_extended_simpletest.py b/examples/trellism4_extended_simpletest.py
index 6d8b750..17e52ee 100644
--- a/examples/trellism4_extended_simpletest.py
+++ b/examples/trellism4_extended_simpletest.py
@@ -1,4 +1,68 @@
 # SPDX-FileCopyrightText: 2017 Scott Shawcroft, written for Adafruit Industries
 # SPDX-FileCopyrightText: Copyright (c) 2021 Arofarn
 #
-# SPDX-License-Identifier: Unlicense
+# SPDX-License-Identifier: MIT
+
+import time
+
+from board import SCL, SDA
+import busio
+from adafruit_neotrellis.neotrellis import NeoTrellis
+from adafruit_neotrellis.multitrellis import MultiTrellis
+from neotrellism4 import NeoTrellisM4
+
+# Create the i2c object for the trellis
+I2C = busio.I2C(SCL, SDA)
+
+# Create the trellis. This is for a 2x2 array of TrellisM4 (first row) with
+# 2 Neotrellis (second row).
+#
+# [ NeoM4_left | NeoM4_right ]
+#  neotrellis0 | neotrellis1
+
+trellim4_left = NeoTrellisM4()
+trellim4_right = NeoTrellisM4(left_part=trellim4_left)
+trelli = [[trellim4_left, trellim4_right],
+            [NeoTrellis(I2C, False, addr=0x2F), NeoTrellis(I2C, False, addr=0x2E)]]
+
+trellis = MultiTrellis(trelli)
+
+# some color definitions
+OFF = (0, 0, 0)
+RED = (127, 0, 0)
+YELLOW = (127, 75, 0)
+GREEN = (0, 127, 0)
+CYAN = (0, 127, 127)
+BLUE = (0, 0, 127)
+PURPLE = (90, 0, 127)
+
+# this will be called when button events are received
+def blink(xcoord, ycoord, edge):
+    """Turn the LED on when a rising edge is detected or
+    turn the LED off when a falling edge is detected
+    """
+    if edge == NeoTrellis.EDGE_RISING:
+        trellis.color(xcoord, ycoord, BLUE)
+    elif edge == NeoTrellis.EDGE_FALLING:
+        trellis.color(xcoord, ycoord, OFF)
+
+for y in range(8):
+    for x in range(8):
+        # activate rising edge events on all keys
+        print(x, y)
+        trellis.activate_key(x, y, NeoTrellis.EDGE_RISING)
+        # activate falling edge events on all keys
+        trellis.activate_key(x, y, NeoTrellis.EDGE_FALLING)
+        trellis.set_callback(x, y, blink)
+        trellis.color(x, y, PURPLE)
+        time.sleep(.05)
+
+for y in range(8):
+    for x in range(8):
+        trellis.color(x, y, OFF)
+        time.sleep(.05)
+
+while True:
+    # the trellis can only be read every 17 millisecons or so
+    trellis.sync()
+    time.sleep(.02)