ca4ti/ttgo-doom

A port of DOOM to the LilyGO T-Watch

TTGO-DOOM

This is a port of DOOM to the LilyGO T-Watch, a cheap ESP32 based "smart" watch. I have only tried it on the T-Watch-2020, but it may work on other models.

Building / Flashing

This is a PlatformIO project. You can build it through the PlatformIO IDE (vscode) or from the command line using

pio run -t upload

After building and uploading the firmware, you will also need to upload the game data (WAD files). Run the flashwad.sh script. This requires esptool to be installed. You will need to specify the serial port the device is connected to, for instance /dev/ttyUSB0.

./flashwad.sh /dev/ttyUSB0

I have included the WAD file for the shareware version of DOOM (data/DOOM1.WAD), but you can replace it with the WAD for a retail version if you have it. There is 14,720 Kb available for the WAD file.

Controls

Menu Controls
Side Button	Open/close the menu
Swipe up/down/left/right	Navigate the menu
Touch	Make a selection

Game Controls
Tilt left/right	Turn left and right
Tilt forward/back	Move forward and backward
Tap	Shoot or use

TODO

• Touchscreen gestures
• Accelerometer for movement control
• Sound
• Load WAD files from SPIFFS filesystem instead of reading data directly from flash partitions
• Save / Load games
• Run vibration motor when you get hit
• Multiplayer using WiFi
• Gamepad using bluetooth
• Maybe show the time?

Credits

• DOOM was released by iD software in 1999 under the Gnu GPL.
• PrBoom is a modification of this code; its authors are credited in the src/prboom/AUTHORS file.
• The ESP32 port was done by Espressif and is licensed under the Apache license, version 2.0.
• Also uses code from App-Z and jkirsons.