README.md

@@ -1,45 +1,30 @@
-# UEFI Fireworks
-### Retro fireworks you can run on your modern UEFI system
-Simple automatic fireworks app that runs on your UEFI firmware with basic controls.  
-Primary purpose of this app is just to look at something nice.
 
-> [!CAUTION]
+# UEFI Fireworks  
-> This app may cause epileptic seizures in people with epilepsy.  
-> $\color{red}{\text{!!!If you have a history of seizures, do not use this program!!!}}$  
-> I don't know if colorful expanding circles can cause seizures and i don't want for anyone to get hurt
 
 ## How to build  
 
-> [!IMPORTANT]  
-> You will need these programs to compile:  
-> - git  
-> - gcc  
-> - xxd  
-> - ImageMagick (if you changed the firework image)
-
 ```bash
 git submodule update --init --recursive
-cd edk2
+cd  edk2
 source edksetup.sh
 make -C BaseTools
 cd ..
-./build.sh # to build for a different arch than X64 change TARGET_ARCH in build.sh
+./build.sh
 ```
 
 ## How to use  
 
 ### Download release  
 
-#### On real hardware
+#### On Real hardware  
 
-If you have an amd64 (x86_64) UEFI computer,  
+if your have amd64(x86_64) UEFI computer  
-download the release and copy UEFI_fireworks.efi to /EFI/BOOT/bootx64.efi (case-insensitive).
+Download release and copy the UEFI_fireworks.efi to <USB_DRIVE>/EFI/BOOT/bootx64.efi case independent  
 
 #### On VM  
 
-You will need OVMF firmware; you can get it here: https://qemu.weilnetz.de/test/ovmf/usr/share/OVMF/OVMF_CODE_4M.fd
+run:  
-
+you will need OVMF firmware you can get it [here](https://qemu.weilnetz.de/test/ovmf/usr/share/OVMF/OVMF_CODE_4M.fd)
-Run:
 ```bash
 qemu-system-x86_64 -machine type=q35,accel=kvm -drive if=pflash,format=raw,readonly=on,file="$OVMF_CODE_PATH" -hda fat:rw:build -boot order=c -smp 4 -s -serial mon:stdio
 ```  
@@ -48,41 +33,27 @@ qemu-system-x86_64 -machine type=q35,accel=kvm -drive if=pflash,format=raw,reado
 
 #### On VM  
 
-You will need OVMF firmware; you can get it here: https://qemu.weilnetz.de/test/ovmf/usr/share/OVMF/OVMF_CODE_4M.fd
+you will need OVMF firmware you can get it [here](https://qemu.weilnetz.de/test/ovmf/usr/share/OVMF/OVMF_CODE_4M.fd)  
+run ```./test.sh $OVMF_CODE_PATH# only works on AMD64``` to run in VM using QEMU  
 
-Run:
+#### On Real hardware  
-```bash
-./test.sh $OVMF_CODE_PATH  # only works on AMD64
-```
-to run in a VM using QEMU.
 
-#### On real hardware
+copy ```edk2/Build/UEFI_fireworks/DEBUG_GCC5/<YOUR ARCH>/UEFI_fireworks.efi``` to FAT32 or FAT16 USB at location:
 
-Copy:
+| Architecture        | Default Boot Path        |
-```
+| ------------------- | ------------------------ |
-edk2/Build/UEFI_fireworks/DEBUG_GCC5//UEFI_fireworks.efi
+| **x86_64 (AMD64)**  | `/EFI/BOOT/BOOTX64.EFI`  |
-```
+| **x86 (IA32)**      | `/EFI/BOOT/BOOTIA32.EFI` |
-to a FAT32 or FAT16 USB at the following location:
+| **ARM64 (AArch64)** | `/EFI/BOOT/BOOTAA64.EFI` |
+| **ARM (32-bit)**    | `/EFI/BOOT/BOOTARM.EFI`  |
 
-| Architecture    | Default Boot Path        |
+## Controling  
-| --------------- | ------------------------ |
-| x86_64 (AMD64)  | `/EFI/BOOT/BOOTX64.EFI`  |
-| x86 (IA32)      | `/EFI/BOOT/BOOTIA32.EFI` |
-| ARM64 (AARCH64) | `/EFI/BOOT/BOOTAA64.EFI` |
-| ARM (32-bit)    | `/EFI/BOOT/BOOTARM.EFI`  |
 
-## Controlling
+| Key        | Action       | Note                                |
-
+| ---------- | ------------ | ----------------------------------- |
-| Key        | Action       | Note                               |
+| ARROW_UP   | speed up     | delays under 1ms may be unrelayable |
-| ---------- | ------------ | ---------------------------------- |
+| ARROW_DOWN | slow down    | max delay is about UINT32_MAXμs     |
-| ARROW_UP   | speed up     | delays under 1ms may be unreliable |
+| PAGE_UP    | speed up     | 10x step                            |
-| ARROW_DOWN | slow down    | max delay is about UINT32_MAX μs   |
+| PAGE_DOWN  | speed down   | 10x step                            |
-| PAGE_UP    | speed up     | 10× step                           |
+| Home key   | reset speed  | reset frame delay to 10ms           |
-| PAGE_DOWN  | slow down    | 10× step                           |
+| Delete key | clear screen |                                     |
-| Home       | reset speed  | reset frame delay to 10ms          |
-| Delete     | clear screen |                                    |
-
-## Showcase
-In QEMU/KVM
-
-https://github.com/user-attachments/assets/275e28aa-eb2e-4348-ac08-95f909c46a1f

UEFI_fireworks.dsc

@@ -4,7 +4,7 @@
   PLATFORM_VERSION               = 1.0
   DSC_SPECIFICATION              = 0x00010005
   OUTPUT_DIRECTORY               = Build/UEFI_fireworks
-  SUPPORTED_ARCHITECTURES        = X64|IA32|AARCH64
+  SUPPORTED_ARCHITECTURES        = X64
   BUILD_TARGETS                  = DEBUG|RELEASE
   SKUID_IDENTIFIER               = DEFAULT
 

build.sh

@@ -1,14 +1,11 @@
 #!/bin/bash
 export PACKAGES_PATH=$PWD:$PWD/edk2
-export TARGET_ARCH=X64
-# export GCC5_AARCH64_PREFIX=aarch64-linux-gnu- # uncomment for AARCH64 crosscompilation or you can use
-# export GCC5_AARCH64_PREFIX=aarch64-none-elf-
 magick assets/rocket_orig.bmp -type TrueColor -define  bmp:format=bmp3 -compress None assets/rocket.bmp
 xxd -i assets/rocket.bmp > src/UEFI_fireworks/rocket.c
 if [ "$1" == "debug" ]; then
-    build -a $TARGET_ARCH -t GCC5 -p UEFI_fireworks.dsc -b DEBUG
+    build -a X64 -t GCC5 -p UEFI_fireworks.dsc -b DEBUG
 else
-    build -a $TARGET_ARCH -t GCC5 -p UEFI_fireworks.dsc -b RELEASE
+    build -a X64 -t GCC5 -p UEFI_fireworks.dsc -b RELEASE
 fi
 mkdir -p build/EFI/BOOT/
 if [ "$1" == "debug" ]; then

src/UEFI_fireworks/UEFI_fireworks.inf

@@ -6,16 +6,13 @@
   VERSION_STRING                 = 1.0
   ENTRY_POINT                    = UefiMain
 
-[Sources.Common]
+[Sources]
   UefiMain.c
   drawing.c
   rng.c
   time.c
   rocket.c
 
-[Sources.AARCH64]
-  memcpy.c
-
 [Packages]
   edk2/MdePkg/MdePkg.dec
 

src/UEFI_fireworks/UefiMain.c

@@ -52,8 +52,8 @@ EFI_STATUS EFIAPI UefiMain(IN EFI_HANDLE imgHandle,
     return EFI_NOT_FOUND;
   }
 
-  framebuffer = (EFI_GRAPHICS_OUTPUT_BLT_PIXEL *)(UINTN)
+  framebuffer =
-                    GraphicsOutput->Mode->FrameBufferBase;
+      (EFI_GRAPHICS_OUTPUT_BLT_PIXEL *)GraphicsOutput->Mode->FrameBufferBase;
 
   init_rng();
   init_rocket_blt();

src/UEFI_fireworks/memcpy.c

@@ -1,96 +0,0 @@
-#include <Library/BaseLib.h>
-#include <Uefi.h>
-
-VOID *memcpy(VOID *CONST Destination, CONST VOID *Source, UINTN Length) {
-  UINT8 *Dest = (UINT8 *)Destination;
-  CONST UINT8 *Src = (CONST UINT8 *)Source;
-
-  if (Length < 16) {
-    switch (Length) {
-    case 15:
-      *Dest++ = *Src++;
-    case 14:
-      *Dest++ = *Src++;
-    case 13:
-      *Dest++ = *Src++;
-    case 12:
-      *Dest++ = *Src++;
-    case 11:
-      *Dest++ = *Src++;
-    case 10:
-      *Dest++ = *Src++;
-    case 9:
-      *Dest++ = *Src++;
-    case 8:
-      *Dest++ = *Src++;
-    case 7:
-      *Dest++ = *Src++;
-    case 6:
-      *Dest++ = *Src++;
-    case 5:
-      *Dest++ = *Src++;
-    case 4:
-      *Dest++ = *Src++;
-    case 3:
-      *Dest++ = *Src++;
-    case 2:
-      *Dest++ = *Src++;
-    case 1:
-      *Dest++ = *Src++;
-    case 0:
-      break;
-    }
-    return Destination;
-  }
-
-#ifdef MDE_CPU_X64
-  typedef UINT64 WORD_T;
-#else
-  typedef UINT32 WORD_T;
-#endif
-
-  while ((UINTN)Dest & (sizeof(WORD_T) - 1)) {
-    *Dest++ = *Src++;
-    Length--;
-  }
-
-  WORD_T *WordDest = (WORD_T *)Dest;
-  CONST WORD_T *WordSrc = (CONST WORD_T *)Src;
-
-  while (Length >= 8 * sizeof(WORD_T)) {
-    WordDest[0] = WordSrc[0];
-    WordDest[1] = WordSrc[1];
-    WordDest[2] = WordSrc[2];
-    WordDest[3] = WordSrc[3];
-    WordDest[4] = WordSrc[4];
-    WordDest[5] = WordSrc[5];
-    WordDest[6] = WordSrc[6];
-    WordDest[7] = WordSrc[7];
-    WordDest += 8;
-    WordSrc += 8;
-    Length -= 8 * sizeof(WORD_T);
-  }
-
-  while (Length >= 4 * sizeof(WORD_T)) {
-    WordDest[0] = WordSrc[0];
-    WordDest[1] = WordSrc[1];
-    WordDest[2] = WordSrc[2];
-    WordDest[3] = WordSrc[3];
-    WordDest += 4;
-    WordSrc += 4;
-    Length -= 4 * sizeof(WORD_T);
-  }
-
-  while (Length >= sizeof(WORD_T)) {
-    *WordDest++ = *WordSrc++;
-    Length -= sizeof(WORD_T);
-  }
-
-  Dest = (UINT8 *)WordDest;
-  Src = (CONST UINT8 *)WordSrc;
-  while (Length--) {
-    *Dest++ = *Src++;
-  }
-
-  return Destination;
-}