This page configures the AdminBoxx hardware integration. For more information about the AdminBoxx you can visit this page:
AdminBoxx is a dedicated USB race-control button box for iRacing. It combines LED button feedback, spoken/audio confirmations, and one-touch shortcuts for common admin actions such as cautions, penalties, wave-bys, session control, and replay navigation.
When connected, MAIRA controls the AdminBoxx LEDs, plays confirmation tones/voice prompts, reacts to iRacing session flags, and sends the appropriate admin chat commands on your behalf.
MAIRA can also automatically update the AdminBoxx firmware when the version on the device does not match the version bundled with the app.
CONNECTION
These settings control whether MAIRA should connect to the AdminBoxx hardware.
Connect to AdminBoxx
Turns the AdminBoxx connection on/off. If the device is not detected, MAIRA disables this control and shows Device not found.
When MAIRA successfully connects, it enables LED control, starts keep-alive communication, requests the firmware version from the box, and enables the Test button.
Connect to AdminBoxx on App Startup
If this is ON, MAIRA will try to connect to the AdminBoxx automatically when the app starts.
Default: OFF
Test
Runs a built-in LED test cycle on the AdminBoxx. This steps through several flag colors/patterns plus the main layout states so you can verify that the LEDs are working correctly.
This button is only enabled while AdminBoxx is connected.
DISPLAY
These settings affect the brightness of the AdminBoxx button LEDs.
Brightness
Adjusts the LED brightness of the AdminBoxx buttons.
Changing this immediately resends all current LED colors to the box using the new brightness value.
Default: 15%
AUDIO
These settings control AdminBoxx tones and spoken feedback.
Volume
Adjusts the playback volume of AdminBoxx tones, replay beeps, and spoken confirmation phrases/numbers.
Changing this setting plays a short beep so you can hear the current level immediately.
Default: 75%
HOW ADMINBOXX WORKS
The AdminBoxx hardware is an 8×4 illuminated button matrix. MAIRA listens for button presses from the box, updates the button LEDs to reflect the current mode/state, and sends the matching iRacing admin commands through chat or replay control APIs.
Examples of supported actions include:
- Throw yellow / caution
- Black flag, clear flag, clear all penalties
- Toggle chat on/off
- Toggle single-file / double-file restart mode
- Wave by, end-of-line, disqualify, or remove a driver
- Adjust caution laps and advance to the next session
- Replay controls such as live, previous incident, next incident, slow motion, reverse, play/pause, and fast forward
Some actions require a car number. In those cases, AdminBoxx switches into a numpad entry mode. You enter the driver number on the illuminated keypad and then press Enter to send the command, or Escape to cancel it.
AdminBoxx also reacts to simulator state. For example, it can animate flag colors for yellow/green/white/checkered-style events, show replay-mode indicators, and reflect whether chat is enabled or whether restart mode is single-file or double-file.
FIRMWARE UPDATES
After connecting, MAIRA requests the firmware version from the AdminBoxx device. If the version on the hardware does not match the version bundled with MAIRA, the app automatically starts a firmware update by sending the latest code to the device over USB serial.
During this process, the AdminBoxx status in MAIRA shows that the firmware is being updated. When the transfer completes, the device reboots and reconnects using the new firmware.
Previous page: Seat Belt Tensioner
Next page: Overlays