A high-performance port of the classic Tomb Raider engine (OpenLara) for the ESP32-P4. Delivers 30 FPS via software rendering with fully integrated audio.
0
stars
2
commits
C
primary language
Sep 6, 2026
updated
README
OpenLara ESP32-P4
A port of OpenLara to the ESP32-P4-Function-EV-Board. Runs the classic Tomb Raider 1 engine with software rendering, audio, and USB HID keyboard input on Espressif's latest RISC-V SoC.
Author: Alejandro Villegas Alonso
Features
- Software RGB565 renderer at 320x240, hardware-scaled to 1024x600 via the PPA (Pixel Processing Accelerator)
- 44.1 kHz stereo audio via I2S + ES8311 codec
- USB HID keyboard input (boot protocol)
- GT911 capacitive touch (I2C)
- MicroSD card (SDMMC 4-bit) for game data
- MP3 (minimp3), OGG (stb_vorbis) and zlib (tinf) decode support
- On-screen FPS counter (F12 toggle)
- Custom health/oxygen HUD overlay
Demo
Hardware Requirements
| Component | Details |
|---|---|
| Board | ESP32-P4-Function-EV-Board |
| SoC | ESP32-P4, RISC-V dual-core @ 400 MHz (chip rev < 3.0) |
| Flash | 16 MB |
| PSRAM | 32 MB (SPIRAM, HEX mode, 200 MHz) |
| Display | 1024x600 MIPI DSI LCD (EK79007) |
| Touch | GT911 capacitive (I2C) |
| Audio | ES8311 codec via I2S |
| Storage | MicroSD card (SDMMC 4-bit) |
| Input | USB HID keyboard (required) |
Building
Prerequisites
- ESP-IDF v5.4+ (tested with v5.4.4 / v5.5.5)
riscv32-esp-elftoolchain
Build & Flash
# Set up ESP-IDF environment
. $IDF_PATH/export.sh
# Build
idf.py build
# Flash (adjust port as needed)
idf.py -p /dev/ttyUSB0 flash monitor
Game Data
You must provide your own Tomb Raider 1 data files (.PHD levels, .PCX images, cutscenes) inside a data folder on the MicroSD card. The game will not run without them.
Controls
A USB keyboard must be connected to the board.
| Key | Action |
|---|---|
| Arrow keys | Movement / Camera |
| Ctrl | Action (draw weapon, grab, interact) |
| Shift | Walk |
| Alt | Step / Look |
| Space | Jump |
| F12 | Toggle FPS counter |
Technical Notes
- Software rendering is based on the MS-DOS flavor of OpenLara (not the GL renderer), using the header-only
gapi/sw.hengine compiled as C++11 - Near-plane clipping patch applied for the software renderer
- FreeRTOS dual-core with a 1000 Hz tick; the audio pump task runs on core 0
- All game memory is allocated from PSRAM; internal SRAM is reserved for DMA and task stacks
- Saves and cache are written to the SD card
Credits
- XProger/OpenLara — the original open-source Tomb Raider 1 engine
License
OpenLara is licensed under the GPL-3.0.
Contributors
2 commits
See what people are saying
Similar repos
Languages
C
71.7%
C++
28.2%
A high-performance port of the classic Tomb Raider engine (OpenLara) for the ESP32-P4. Delivers 30 FPS via software rendering with fully integrated audio.
0
stars
2
commits
C
primary language
Sep 6, 2026
updated
README
OpenLara ESP32-P4
A port of OpenLara to the ESP32-P4-Function-EV-Board. Runs the classic Tomb Raider 1 engine with software rendering, audio, and USB HID keyboard input on Espressif's latest RISC-V SoC.
Author: Alejandro Villegas Alonso
Features
- Software RGB565 renderer at 320x240, hardware-scaled to 1024x600 via the PPA (Pixel Processing Accelerator)
- 44.1 kHz stereo audio via I2S + ES8311 codec
- USB HID keyboard input (boot protocol)
- GT911 capacitive touch (I2C)
- MicroSD card (SDMMC 4-bit) for game data
- MP3 (minimp3), OGG (stb_vorbis) and zlib (tinf) decode support
- On-screen FPS counter (F12 toggle)
- Custom health/oxygen HUD overlay
Demo
Hardware Requirements
| Component | Details |
|---|---|
| Board | ESP32-P4-Function-EV-Board |
| SoC | ESP32-P4, RISC-V dual-core @ 400 MHz (chip rev < 3.0) |
| Flash | 16 MB |
| PSRAM | 32 MB (SPIRAM, HEX mode, 200 MHz) |
| Display | 1024x600 MIPI DSI LCD (EK79007) |
| Touch | GT911 capacitive (I2C) |
| Audio | ES8311 codec via I2S |
| Storage | MicroSD card (SDMMC 4-bit) |
| Input | USB HID keyboard (required) |
Building
Prerequisites
- ESP-IDF v5.4+ (tested with v5.4.4 / v5.5.5)
riscv32-esp-elftoolchain
Build & Flash
# Set up ESP-IDF environment
. $IDF_PATH/export.sh
# Build
idf.py build
# Flash (adjust port as needed)
idf.py -p /dev/ttyUSB0 flash monitor
Game Data
You must provide your own Tomb Raider 1 data files (.PHD levels, .PCX images, cutscenes) inside a data folder on the MicroSD card. The game will not run without them.
Controls
A USB keyboard must be connected to the board.
| Key | Action |
|---|---|
| Arrow keys | Movement / Camera |
| Ctrl | Action (draw weapon, grab, interact) |
| Shift | Walk |
| Alt | Step / Look |
| Space | Jump |
| F12 | Toggle FPS counter |
Technical Notes
- Software rendering is based on the MS-DOS flavor of OpenLara (not the GL renderer), using the header-only
gapi/sw.hengine compiled as C++11 - Near-plane clipping patch applied for the software renderer
- FreeRTOS dual-core with a 1000 Hz tick; the audio pump task runs on core 0
- All game memory is allocated from PSRAM; internal SRAM is reserved for DMA and task stacks
- Saves and cache are written to the SD card
Credits
- XProger/OpenLara — the original open-source Tomb Raider 1 engine
License
OpenLara is licensed under the GPL-3.0.
See what people are saying
Similar repos
Contributors
2 commits
Languages
C
71.7%
C++
28.2%