Skip to content

Firmware

Hiktron edited this page Dec 9, 2025 · 1 revision

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.

  1. 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

  1. 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.

  1. 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.

  1. 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

  1. Update System

HIZMOS includes a dual update pipeline:

  1. USB Firmware Flashing

Safe, fast, and recommended for developers

Supports ESP32-S3 USB DFU and esptool flashing

  1. OTA Updates

Push Wi-Fi updates

Local file update from SD card

Version tracking & rollback

  1. 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.

  1. 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

Clone this wiki locally