A 3D Graphics Engine for the ESP32.

Version 2.0

Hardware

• Board/Display: LILYGO T-Display-S3 ESP32-S3 --> https://www.amazon.com/dp/B0C2T6DP5J?ref=ppx_yo2ov_dt_b_product_details&th=1
• x2 SparkFun Qwiic Joysticks --> https://www.sparkfun.com/products/15168
• x1 SparkFun Qwiic Mux Breakout - 8 Channel (TCA9548A) --> https://www.sparkfun.com/products/16784

.OBJ Format

If using blender, Export > Wavefront (.obj). Make sure the exported options are selected:

Geometry

• Scale: 1.0
• Forward Axis: -Z
• Up Axis: Y
• Colors: True
• Triangulated Mesh: True

Materials

• Export: True

Instructions/Gotchas

1. Make sure to select "Upload Filesystem Image" from the PlatformIO extension in VS Code. This will upload all the data/*.obj files to your ESP32 board.

2. Copy and paste this code in setup() and run the program once. Comment it out or remove it after it succeeds for the first time.

   if (!SPIFFS.begin(true)) { Serial.println("Failed while mounting SPIFFS."); return; }

Note: When the program starts, if you still see a black screen after ~15 seconds you may need to try a few things. Option 1: Restart the device. Option 2: Disconnect it from your computer and use some other power source. Option 3: Open the serial monitor in VS code. Option 4: Pray.