Skip to content

Latest commit

 

History

History
41 lines (28 loc) · 1.5 KB

README.md

File metadata and controls

41 lines (28 loc) · 1.5 KB

Quake for embedded devices

QuakEMBD is yet another WinQuake port for embedded devices, primarily for ARM Cortex-M devices.

QuakEMBD on Action

Based on original Quake GPL source: https://github.com/id-Software/Quake

Limitations

  • All sound functions are not yet supported.
  • Many other features may not be supported or left untested.

Will it run Quake?

Currently the following devices are supported.

  • STM32H747I-DISCO
    • Locate *.PAK files under <micro-sd-card>/quakembd/id1
    • You can use STM32CubeProgrammer to program quakembd.bin file
    • Touch screen & joystick are supported for the minimal playing experience

How to build

Use CMake with GNU Arm Embedded Toolchain installed.

The defaut toolchain file assumes:

  • GNU Arm Embedded Toolchain is installed under ~/gcc-arm-none-eabi-9-2019-q4-major
  • STM32Cube package is cloned under ~/STM32CubeH7

See port/boards/stm32h747i_disco/gcc/toolchain.cmake file for details.

$ mkdir build && cd build
$ cmake \
-DCMAKE_TOOLCHAIN_FILE=../port/boards/stm32h747i_disco/gcc/toolchain.cmake \
-DCMAKE_BUILD_TYPE=RELEASE \
-DBOARD_NAME=stm32h747i_disco \
-GNinja ..
$ ninja