EMATech / Network-Studio-Clock

Adafruit MatrixPortal M4 and CircuitPython powered prototype

Network Studio Clock

Adafruit MatrixPortal M4 and CircuitPython powered prototype.

Based upon Adafruit's Metro Matrix Clock for Airlift Metro M4 with 64x32 RGB Matrix display & shield.

Copyright (c) 2018 Adafruit Industries
Copyright (c) 2021-2022 Raphaël Doursenaud [e-mail]

Licensed under MIT. See LICENSE.

Demonstration

BOM

• Adafruit Matrix Portal Starter Kit - ADABOX 016 Essentials (PRODUCT ID: 4812)
  Contains:
  • Adafruit Matrix Portal - CircuitPython Powered Internet Display (Product ID: 4745)
  • 64x32 RGB LED Matrix - 4mm pitch (Product ID: 2278)
  • Black LED Diffusion Acrylic Panel - 10.2" x 5.1" - 0.1" / 2.6mm thick (Product ID: 4749)
  • Clear Adhesive Squares - 6 pack - UGlu Dashes (Product ID: 4813)
  • 5V 2.5A Switching Power Supply with 20AWG MicroUSB Cable (Product ID: 1995)
  • Micro B USB to USB C Adapter (Product ID: 4299)
• Adafruit DS3231 Precision RTC - STEMMA QT (PRODUCT ID: 5188)
• STEMMA QT / Qwiic JST SH 4-Pin Cable - 50mm Long (PRODUCT ID: 4399)

How to use

1. Firmware updates
   1. Update the ESP32 firmware.
   2. Update the U2F Bootloader.
   3. Install or update to CircuitPython version 7.x.
2. Libraries
   1. Install the requirements listed in requirements-circuitpython.txt on your Matrix Portal. (I tend to use CircUp).
3. WLAN configuration
   1. Complete your informations into _secrets.py.
   2. Rename _secrets.py to secrets.py.
4. Installation
   1. Copy all the files under src to the root of your Matrix Portal storage.

Features & TODO

• Clock
  • RTC
    • Integrated into MCU
    • DS3231
  • NTP (WiFi)
  • GPS
• USB-MIDI support (adafruit_midi)
• MIDI Time Code (MTC) display (uses heavily modified snippets from Jeff Mikels' timecode_tools)
  • Adafruit MIDI MTC Quarter Frame support
  • MTC decoding with correct frame sync
  • Performance optimization
• Transport status display
  • MTC
    • running
    • synced
    • stopped
    • direction
    • FPS
  • MTC synced
  • MIDI clock
    • Metronome display?
• HUI mode
  • timecode
  • bargraph
  • rec enable?
• MCU mode (See https://github.com/EMATech/PythonMcu)
  • timecode
  • bargraph
  • rec enable?
• Environmental sensors support?

CHANGES from the Metro Matrix Clock

• Adapted to MatrixPortal M4.
• Defaults to using standard NTP instead of adafruit.io to fetch time.
• Added a 24 hours display mode.
• Added seconds display.
• Added Gorgy Timing inspired seconds chaser and font.
• Added date display.
• Added button handling for stealth mode.
• Added RTC (DS3231) support.
• Added a prototype MIDI Time Code (MTC) display mode.

Similar software programs

• https://github.com/orchetect/MIDIKitSync (Implementation looks to be on point)
• https://github.com/AlexDWong/MTCDisplay (Similar hardware)