https://github.com/cfrankb/esp-idf-cs3

ESP32 port of an MSDOS game using the ST7789 / ILI9341 LCD display and a joystick module.
https://github.com/cfrankb/esp-idf-cs3

button esp-idf esp32 game game-2d game-engine ili9341 joystick maze maze-game retro retrogaming st7789 tilemap

Last synced: about 1 month ago
JSON representation

ESP32 port of an MSDOS game using the ST7789 / ILI9341 LCD display and a joystick module.

• Host: GitHub
• URL: https://github.com/cfrankb/esp-idf-cs3
• Owner: cfrankb
• License: mit
• Created: 2022-11-03T19:10:36.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-05-18T13:15:44.000Z (7 months ago)
• Last Synced: 2024-05-18T14:28:04.101Z (7 months ago)
• Topics: button, esp-idf, esp32, game, game-2d, game-engine, ili9341, joystick, maze, maze-game, retro, retrogaming, st7789, tilemap
• Language: C++
• Homepage:
• Size: 1.29 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# About

This project is a game port to ESP-32 microcontroller of an MS-DOS Game.

Current status is alpha. 90% of the core mechanic has been implemented.

## Original MS-DOS

![Image](images/Screenshot_2022-10-19_21-01-20.png "icon")

## ESP-32

![Image](images/20231224_082059.jpg "icon")

I am also releasing the source code for the map editor:

https://github.com/cfrankb/cs3-map-edit

Try the online version of the game: 

https://cfrankb.com/games/ems/cs3v2.html

# Software required

esp-idf v5.1.2 or later.

# Installation

This project is based in part on: https://github.com/nopnop2002/esp-idf-st7789

```Shell

git clone https://github.com/cfrankb/esp-idf-cs3.git

cd esp-idf-cs3/

idf.py set-target {esp32/esp32s2/esp32s3/esp32c3}

idf.py menuconfig

idf.py flash

```

# Tested with this hardware

| Driver  | Resolution | Max SPI Freq | Display Inv |

| ------- | ---------- | ------------ | ----------- |

| ST7789  | 240x320    | 20M          | True        |

| ILI9341 | 240x320    | 40M          | False       |

## ESP-32

https://www.aliexpress.com/item/32959541446.html

## ST7789

https://www.aliexpress.com/item/1005004343881408.html

| ST7789   | wirecolor | GPIO Pin   |

| -------- | --------- | ---------- |

| SDK/MISO | purple    |            |

| LED      | grey      | 32 (BL???) |

| SCK      | yellow    | 18         |

| SDI/MOSI | orange    | 23         |

| DC       | green     | 27         |

| RESET    | brown     | 33         |

| CS       | white     | 14 or 25   |

| GRN      | black     | GRN        |

| VCC      | red       | 3.3v or 5v |

## Joystick

https://www.aliexpress.com/item/32345829014.html

| JOYSTICK | wirecolor | GPIO Pin |

| -------- | --------- | -------- |

| VRX      | brown     | 35       |

| VRY      | white     | 34       |

| SW       | blue      | 26       |

| GRN      | black     | GRN      |

| VCC      | red       | 3.3v     |

The above configuration is for the ESP32.

Pin out will vary per model. Check log output.

## Dupont cables

https://www.aliexpress.com/item/1005004611997111.html

## Button Module (optional)

https://www.aliexpress.com/item/32909058328.html

| Module | wirecolor | GPIO Pin  |

| ------ | --------- | --------- |

| GRN    | black     | GRN       |

| OUT    | green     | 4         |

| VCC    | red       | 3.3v / 5v |

## Further reading

https://github.com/DiegoPaezA/ESP32-freeRTOS