Skip to content

Latest commit

 

History

History
70 lines (50 loc) · 6.42 KB

README.md

File metadata and controls

70 lines (50 loc) · 6.42 KB
Raw

Examples

Here you will find example sketches to run on your Trinity ranging from a simple "Hello World" to full projects like the WiFi Tetris clock

These examples are compatible with any ESP32 using the I2S Matrix library (including my I2S Matrix Shield).

You should also check out the examples that come with the I2S Matrix library for more things to run, but they might not be configured to work with the Trinity out of the box

Basics

In this section you will find some simple sketches to get you up and running on your Trinity. These are a great place to get started, as I alway would recomend getting something simple running on any hardware to make sure your setup works!

  • Hello World - A simple example showing different size fonts in different colours
  • ColourTest - A simple sketch that just cycles through colours (WARNING - can use a lot of power!)
  • PanelChecker - A modified version of the Hello World that can be used to change the matrix config by using the Trinity touch buttons on startup. Check the Usage at the top of the sketch.

Building Blocks

This section shows examples on how to do some things that could be useful to use inside a different project. I've also tried to cover some of the more commonly asked questions of how to do things here too

  • Text
    • CenterText - An example for showing you how to center align text.
    • ScrollingText - An example to show you how to scroll text.
  • Images
    • DisplayImageFromWeb - Downloads a JPG from a URL (imgur in this case), save it to SPIFFS and displays it to the Matrix
    • DisplayGIF - Displays severtal GIFs on the matrix. Check the top of the file for more info.
  • Shapes
    • BouncingSquares - Displays squares of different colours and sizes which bounce off the sides.

Trinity Features

This section is show how to use some of the additional features of the Trinity

  • LDRAutoBrightness - An example of using the LDR to automatically adjust the brightness of the display Additional Requirements: Included LDR needs to be soldered
  • SDCardTest - An example of using an SD Card with your Trinity. Could be adapted to work with any SPI device. The matrix uses some of the deafult SPI pins so we had to get creative. Additional Requirements: An SD/Micro SD module
  • TouchPointTest - A basic example of using the built-in Touch pads of the Trinity.

Projects

This is a collection of some of the projects I've written for the Trinity that you should be able to just use to get a full working project going on your Trinity in just a few minutes! Also feel free to build on top of these or change them for you needs.

Note: This is not a full list of projects I've made as some will have their own repos. Please check the Project Section for a full list of my projects and user contributed ones.

  • FallingSand: A fun project that emulates sand falling on the Matrix using an accelerometer module. This was originally created by Tetra3DPrint and ported to the I2S matrix library by me. Additional Requirements: GY521 Accelermoter Module
  • SnakeWithNunchuck I'm tired of these monkey fighting snakes on this Monday to Friday Matrix! A simple version of the clasic game controlled by a Nintendo Wii Nunchuck. Additional Requirements: Wii Nunchuck and an adaptor
  • TetrisWithNunchuck Please don't sue me EA. Tetris on your matrix controlled by a Wii Nunchuck. Additional Requirements: Wii Nunchuck and an adaptor
  • WifiTetrisClock Really, Please don't sue me EA. A clock displayed using falling matrix blocks. Video about it here but it refers to the original project I ported this code from.
  • WifiTetrisClockWifiManager The same as above, but uses WiFi manager to manage your Wifi details and other configs.
  • YouTubeLivestreamDraw Allow your livestream viewers chat draw on your matrix, what could go wrong? See in action on Unexpected Makers channel
  • TrafficLight A simple traffic light that changes based on time.
  • BluetoothSpeakerSpectrumDisplay ESP32 as a bluetooth speaker with a Spectrum analyser display on the Matrix Additional Requirements: Max 98357A I2S Amp Module

But I still haven't found what I'm looking for

If you feel like there is something missing please or you just need some addtional help, feel free to:

  • Ask on my Discord - This will be the fastest as other helpful makers can jump in too!
  • Raise a Github Issue here

And I will do my best to help if I can!