-
Notifications
You must be signed in to change notification settings - Fork 24
Firmware
Software & Firmware Overview
HIZMOS runs a modular, high‑performance firmware stack built around the ESP32‑S3 and optimized for real‑time RF tasks, UI rendering, and hardware expansion. The firmware is fully open-source, allowing developers, students, and researchers to extend the system with new tools and apps.
- Operating Architecture
HIZMOS firmware is built on a modular service-based architecture, where each subsystem runs independently but communicates through a clean API layer.
Core Services
RF Service — manages CC1101, GT24, IR, and NFC modules
UI Engine — renders the OLED UI, icons, menus, and animations
File System Manager — handles SD card, logs, configs, and apps
Connectivity Stack — Wi-Fi, BLE, USB, OTA updater
Crypto & Encoding Engine — handles hashing, encoding, and packet formatting
Task Scheduler — manages real-time processes and multitasking
This architecture allows:
Parallel RF operations
Real-time analysis
Smooth UI rendering while running heavy tasks
Background scanning or BLE services
- App System (HIZMOS Apps)
HIZMOS uses an app‑based structure, where each tool runs as a mini‑module. Developers can add new apps by creating a folder with C++ files and registering them in the main firmware.
Built‑In Apps
RF Toolkit: frequency testing, modulation tools, packet visualizer
Wi-Fi Tools: scanner, signal monitor, handshake viewer
BLE Tools: HID keyboard/mouse, advertiser, BLE analyzer
IR Tools: learn & transmit, protocol inspector
NFC Tools: read, emulate (for supported formats), card diagnostics
Oscilloscope & Logic Viewer: digital/analog sampling
Signal Generator: PWM, square wave, tone output
File Browser: manage logs, dumps, and user files
Developer Mode: GPIO control, SPI/I2C testing, UART console
Each app is isolated, safe, and can be extended without breaking the system.
- UI & UX System
HIZMOS uses a vector‑based UI framework designed for speed and readability.
Features:
Animated menus
Smooth transitions at stable framerate
Icon + text hybrid UI
Theme and color customization
On-screen hints and status indicators (RSSI, battery, active modules)
The UI engine uses PSRAM acceleration to avoid lag even during RF workloads.
- Connectivity Stack Wi-Fi Suite
2.4GHz and optional 5GHz (depending on ESP07 module)
Supports scanning, signal strength mapping, and frame inspection in controlled environments
Built-in OTA updater
Captive portal for configuration
Bluetooth LE Suite
BLE HID keyboard & mouse
BLE advertiser with custom payloads
BLE service scanner
BLE device bridge (device ↔ PC/phone)
USB‑C (OTG)
Serial monitor
Mass storage mode (read-only for safety)
USB HID
Firmware flashing
- Update System
HIZMOS includes a dual update pipeline:
- USB Firmware Flashing
Safe, fast, and recommended for developers
Supports ESP32-S3 USB DFU and esptool flashing
- OTA Updates
Push Wi-Fi updates
Local file update from SD card
Version tracking & rollback
- Security & Stability Features
App sandboxing
Watchdog timers for each subsystem
RF safety limits
Memory protection via PSRAM isolation
Config checksum verification
Safe-mode boot if an app crashes
These features ensure HIZMOS remains stable even with experimental apps.
- Developer APIs & Extensibility
Developers can access:
SPI / I2C / UART / CAN drivers
RF control APIs
Packet formatting utilities
UI rendering library
File system & storage APIs
Multitasking & threading hooks
This allows custom apps ranging from:
Robotics controllers
RF analyzers
IoT interfaces
Educational experiments
Sensor dashboards