A port of prBoom to NXP MCXN MCU running Zephyr RTOS

1. Software
2. Hardware
3. Setup
4. Results
5. FAQs
6. Support
7. Release Notes

• Zephyr 4.0
• Zephyr SDK version 0.17.0

FRDM Development Board for MCX N947	LCD-PAR-S035 480x320 IPS LCD

Optional Joystick shield on FRDM-MCXN947 Arduino Header

Before getting started, make sure you have a proper Zephyr development environment. Follow the official Zephyr Getting Started Guide.

The first step is to initialize the DOOM-MCX Zephyr workspace folder (doom-mcx-workspace) where doom-mcx and all Zephyr modules will be cloned. Run the following command:

# initialize  for the example-application (main branch)
west init -m https://github.com/nxphovergames/doom-mcx --mr main doom-mcx-workspace
# update Zephyr modules
cd doom-mcx-workspace
west update

To build the application, run the following command:

cd doom-mcx
west build -p always -b frdm_mcxn947/mcxn947/cpu0

To flash the application to the FRDM-MCXN947 board. Connect a USB-C cable to the "MCU-Link" USB-C port and run the following command:

west flash

On a successful flash the display (LCD-PAR-S035) should turn and you can start playing the game.

Doom-MCX supports 2 types of control either through touchscreen or the Joystick shield.

Open doors/start: Tap "Use Area"
Fire: Tap "Fire Area"
Wake & Strafe Tap and drag in the "Virtual Joystick Area"

Fire: D
Use: C
Walk: Joystick Y-axis
Strafe: Joystick X-axis
Menu: A

Questions regarding the content/correctness of this example can be entered as Issues within this GitHub repository.

Warning: For more general technical questions regarding NXP Microcontrollers and the difference in expected functionality, enter your questions on the NXP Community Forum

Zephyr RTOS also provides a native_posix target

To compile as native type:

west build -p always -b native_posix_64

To run type

cd doom-mcx
./build/zephyr/zephyr.elf

Fire: CTRL
Use: Spacebar
Walk: Up-arrow & Down-arrow
Strafe: Left-arrow & Right-arrow
Menu: ESC