WHY2025 wiki - User contributions [en]

Badge Doom how to

2025-08-10T18:17:35Z

Blueice:

How to run Doom on the WHY badge

[[File:Doom-Why-Badge.jpg |300px]]

== Prerequisites ==

* Have a working badge
* Having installed the toolchain and downloaded the badge firmware. Follow the instruction [https://gitlab.com/why2025/team-badge/firmware Welcome to BadgeVMS on GitLab] (Attention: the path for the cloned badge firmware project must not contain spaces). All filenames in this article refer to the firmware build folder.

== Include Doom app ==

To include the doomgeneric app into the firmware to build, edit <code>sdk_apps/CMakeLists.txt</code> and uncomment lines 240 to 326. By doing that, during building the doomgeneric app will be compiled and a .elf file is added to the tree <code>firmware/build/storage_staging/BADGEVMS/APPS</code>

== Get the WAD ==

DOOM needs some original game resources (music, textures, and that kind of things). This is provided in a WAD file. There are not part of the badge firmware because of copyright reasons.
Get the Doom Shareware version 1 WAD-file from [https://doomwiki.org/wiki/DOOM1.WAD Doom Wiki] , use the link under "External links" (or [https://distro.ibiblio.org/slitaz/sources/packages/d/doom1.wad get the file directly here])

Copy <code>doom1.wad</code> over to the <code>firmware/sdk_apps/doomgeneric/storage_skel/</code> folder to include the file into the firmware file system. the internal filename (BadgeVMS-style) will be <code>APPS:[doomgeneric]doom1.wad</code> where APPS: is the device, doomgeneric is the foldername and doom1.wad is the filename.

== Edit the toml file ==

In <code>firmware/flash_storage/skel/init.toml</code> defines which apps the badge boots up with.
The quickest way is to delete all content *OR* you also could comment out all previous content by prepending `#` to every line. Then insert the text below to include the doomgeneric app.

<pre>
[[apps]]
name = "sponsors"
path = "APPS:[doomgeneric]doomgeneric.elf"
restart_on_failure = false
stack_size = 16384
args = ["-iwad", "APPS:[doomgeneric]doom1.wad"]
</pre>

== compile and flash ==

Build the firmware

idf.py build

and flash it with:

idf.py flash monitor

This will also start the monitor. Check the monitor log to see if the flashing was successful and that Doom starts up. You can exit monitor by pressing RCtrl-].

=== Error Bad music ===
If get a message like ¨Bad music number¨, it means Doom has the wrong WAD file. Get the version 1 Doom Shareware file. See above. The file I used is about 4,9 MB.

Badge Doom how to

2025-08-10T10:41:56Z

Blueice:

How to run Doom on the WHY badge

[[File:Doom-Why-Badge.jpg |300px]]

== Prerequisites ==

* Have a working badge
* Having installed the toolchain and downloaded the badge firmware. Follow the instruction [https://gitlab.com/why2025/team-badge/firmware Welcome to BadgeVMS on GitLab]. All filenames in this article refer to the firmware build folder.

== Include Doom app ==

To include the doomgeneric app into the firmware to build, edit <code>sdk_apps/CMakeLists.txt</code> and uncomment lines 240 to 326. By doing that, during building the doomgeneric app will be compiled and a .elf file is added to the tree <code>firmware/build/storage_staging/BADGEVMS/APPS</code>

== Get the WAD ==

DOOM needs some original game resources (music, textures, and that kind of things). This is provided in a WAD file. There are not part of the badge firmware because of copyright reasons.
Get the Doom Shareware version 1 WAD-file from [https://doomwiki.org/wiki/DOOM1.WAD Doom Wiki] , use the link under "External links" (or [https://distro.ibiblio.org/slitaz/sources/packages/d/doom1.wad get the file directly here])

Copy <code>doom1.wad</code> over to the <code>firmware/sdk_apps/doomgeneric/storage_skel/</code> folder to include the file into the firmware file system. the internal filename (BadgeVMS-style) will be <code>APPS:[doomgeneric]doom1.wad</code> where APPS: is the device, doomgeneric is the foldername and doom1.wad is the filename.

== Edit the toml file ==

In <code>firmware/build/flash_storage/skel/init.toml</code> defines which apps the badge boots up with.
The quickest way is to delete all content *OR* you also could comment out all previous content by prepending `#` to every line. Then insert the text below to include the doomgeneric app.

<pre>
[[apps]]
name = "sponsors"
path = "APPS:[doomgeneric]doomgeneric.elf"
restart_on_failure = false
stack_size = 16384
args = ["-iwad", "APPS:[doomgeneric]doom1.wad"]
</pre>

== compile and flash ==

Build the firmware

idf.py build

and flash it with:

idf.py flash monitor

This will also start the monitor. Check the monitor log to see if the flashing was successful and that Doom starts up. You can exit monitor by pressing RCtrl-].

=== Error Bad music ===
If get a message like ¨Bad music number¨, it means Doom has the wrong WAD file. Get the version 1 Doom Shareware file. See above. The file I used is about 4,9 MB.

User:Blueice

2025-08-09T08:52:57Z

Blueice:

{{UserInfo
|Village=Village:Duck Armada
|Arrival=2025-08-07
|Departure=2025-08-12
|Languages=EN
|NickName={{PAGENAME}}
}}

User:Blueice

2025-06-12T12:33:56Z

Blueice: create user page

{{UserInfo
|NickName={{PAGENAME}}
|Languages=EN
|HackerSpace=
}}