Overview
Boot logos are stored at the end of flash storage, next to user settings. This location ensures they survive firmware updates. Key features:- Supports static images and animations
- Configurable display duration
- Survives firmware updates
- Supported on all IronOS devices
Boot logos are no longer included in the main IronOS repository. You need to generate or download them separately.
Getting Pre-Made Logos
The community has contributed many ready-to-use logos:- Visit IronOS-Meta Releases
- Download the appropriate zip file:
- Pinecil.zip for Pinecil V1/V2
- Miniware.zip for TS100/TS80/TS80P/TS101
- Extract and flash using the instructions in the Flashing section
Creating Custom Logos
Image Requirements
| Specification | Value |
|---|---|
| Resolution | 96×16 pixels |
| Color depth | 1-bit (black & white) |
| Format | PNG or BMP |
| Orientation | Landscape |
Required Tools
- Python 3 (any recent version)
- Pillow library
- IntelHex library
Installing Dependencies
Via pip (recommended):Windows users should use PowerShell instead of Command Prompt.
Converting Images
- Download IronOS-Meta repository
- Navigate to the
Boot Logosfolder - Copy your image file to this folder
- Run the conversion script:
Supported Models
| Model Code | Devices |
|---|---|
miniware | TS100, TS80, TS80P |
pinecilv1 | Pinecil V1 |
pinecilv2 | Pinecil V2 |
ts101 | TS101 (requires special steps, see below) |
s60 | Sequre S60 |
mhp30 | MHP30 |
.hex and .dfu files. Which one you use depends on your device.
Example
output/my_logo.hexoutput/my_logo.dfu
TS101 Special Requirements
The TS101 has unique quirks due to its STM32 clone MCU and modified bootloader: Limitations:- Cannot flash small files alone
- Bootloader cannot write above 99K in flash
- Logo must be merged with firmware
- Download latest IronOS firmware for TS101
- Convert your logo with merge flag:
- Flash the merged file (contains both firmware and logo)
- Future firmware updates preserve the logo
Pre-made TS101 logos are not available in IronOS-Meta releases due to this requirement.
Flashing the Logo
Method 1: Virtual Disk (TS100/TS101/TS80/TS80P/S60/MHP30)
For devices with DFU bootloader that appear as USB drives:- Put device in update mode:
- Hold
Bbutton while connecting USB
- Hold
- Device appears as a USB drive
- Copy the
.hexfile to the drive - Wait for
.rdyfile to appear (indicates success) - Unplug and reconnect to see your logo
Method 2: GUI Flash Tool (Pinecil V1/V2)
If you use a GUI application for firmware updates:- Open your flashing tool
- Try the
.dfufile first - If that fails, try the
.hexfile - If neither work, update your flashing tool
Method 3: dfu-util (Pinecil V1 / IronOS-DFU)
For command-line flashing on Pinecil V1 or devices with IronOS-DFU bootloader:Method 4: blisp (Pinecil V2)
For Pinecil V2 command-line flashing:Erasing Logos
To remove a custom logo: Option 1: Flash the erase file generated with your logo Option 2: Perform a full flash erase (method depends on device) Option 3: Flash a different logo to replace itRegular firmware updates do NOT erase logos.
Configuring Display Duration
Set how long the boot logo displays:- Enter Settings menu
- Navigate to User interface submenu
- Find Boot logo duration
- Adjust value (in seconds)
- Set to
0to skip logo entirely
Troubleshooting
| Problem | Solution |
|---|---|
| Script won’t run | Verify Python 3 and dependencies are installed |
| Image looks wrong | Create 96×16 B&W image manually instead of converting color |
| Logo doesn’t appear | Check you flashed the correct model file |
| Logo erased after update | Shouldn’t happen; check flash method |
| TS101 won’t flash | Ensure firmware and logo are merged together |
Community Resources
- IronOS-Meta Repository - Conversion scripts and community logos
- IronOS-Meta Releases - Pre-converted logos for all models
- Share your logos with the community by contributing to IronOS-Meta