The SystemK USB Stick🔗

Overview🔗

This USB stick contains audio files and firmware for SystemK-based devices. The directory structure is organized into sound effect folders and platform-specific system files. The stick should be formatted as FAT32.

Structure Summary:

01/ - Game sound effects and event audio
10/ - Voiced number announcements (0-100)
ESP/ - 32ESPecial-specific configuration and firmware files

Directory: `01/` - Game Sound Effects🔗

Contains audio files for laser tag game events, UI feedback, and player interactions.

Note

The firmware only reads the first four characters of each filename (###_) to identify sound files. The descriptive names after the underscore are for human reference only and can be modified without affecting functionality.

Initialization & System🔗

001_.mp3 - System startup sound
010_.mp3 - Error notification
025_.mp3 - System reprogramming alert

Weapon & Combat Sounds🔗

002_.mp3 - Primary weapon activated
003_.mp3 - Player hit confirmation
004_.mp3 - Player tagged out sound
018_.mp3 - Near miss alert
021_.mp3 - Friendly fire alert
026_.mp3 - Special weapon activated

005_.mp3 - Menu navigation click
006_.mp3 - Menu open/access sound
007_.mp3 - Selection confirmation
017_.mp3 - UI negative feedback sound
023_.mp3 - UI tone "boop"
024_.mp3 - UI tone "beep"

Settings Menus🔗

008_.mp3 - Health status announcement
011_.mp3 - Volume setting announcement
012_.mp3 - Right-handed mode
013_.mp3 - Left-handed mode
015_.mp3 - Hardware settings menu
016_.mp3 - Game settings menu
019_.mp3 - Player identification announcement
020_.mp3 - Team assignment announcement

Game State🔗

014_.mp3 - Game reentry
027_.mp3 - Game over

Music🔗

009_.mp3 - Lights and sounds test mode
022_.mp3 - "Starting Game" theme song

Directory: `10/` - Voiced Numbers🔗

Contains audio files with spoken numbers for menu navigation and settings display.

001.mp3 through 100.mp3 - Voiced numbers "one" to "one hundred"
101.mp3 - Voiced "zero"

Directory: `ESP/` - ESP32-Specific Files🔗

Contains 32ESPecial-specific configuration and firmware files.

Configuration🔗

CONFIG.TXT - Saved configuration settings for the device (player preferences, hardware settings, game parameters)

Firmware🔗

Located in ESP/firmware/ subdirectory:

APP_.bin - Application firmware binary
Main program code for the 32ESPecial.
SPIFFS_.bin - SPI Flash File System binary
Embedded filesystem image corresponding to the firmware version.

Default USB Filesystem for the 32ESPecial🔗

KTag 32ESPecial USB Stick v01.00

KTag 32ESPecial USB Stick v01.00 Contents

┌── 01
│   ├── 001_KTag_32ESPecial_Initialized.mp3
│   ├── 002_BigLaserBlast.mp3
│   ├── 003_YouveBeenHit.mp3
│   ├── 004_Death_Bell_2025.mp3
│   ├── 005_SciFiClick.mp3
│   ├── 006_Menu.mp3
│   ├── 007_Selected.mp3
│   ├── 008_health_remaining.mp3
│   ├── 009_party_lights.mp3
│   ├── 010_ErrorInMyProgramming.mp3
│   ├── 011_Volume.mp3
│   ├── 012_RightHanded.mp3
│   ├── 013_LeftHanded.mp3
│   ├── 014_GameOn.mp3
│   ├── 015_HardwareSettings.mp3
│   ├── 016_GameSettings.mp3
│   ├── 017_Sci-Fi_Bonk.mp3
│   ├── 018_NearMiss.mp3
│   ├── 019_PlayerID.mp3
│   ├── 020_Team.mp3
│   ├── 021_FriendlyFireAlert.mp3
│   ├── 022_KTag_Far_Horizon_02.mp3
│   ├── 023_Boop.mp3
│   ├── 024_Beep.mp3
│   ├── 025_Reprogramming_Initiated.mp3
│   ├── 026_DynamiteWithSensor.mp3
│   └── 027_GameOver.mp3
├── 10
│   ├── 001.mp3
│   ├── 002.mp3
│   ├── 003.mp3
|   ...
│   ├── 099.mp3
│   ├── 100.mp3
│   └── 101.mp3
└── ESP
    ├── CONFIG.TXT
    └── firmware
        ├── APP_2024Av01.00.bin
        └── SPIFFS_2024Av01.00.bin