How bboe/firebreak works
firebreak is a USB firmware-transition tool for three Echo models: it identifies the connected device and its current state, plans progress toward an unlock or stock target, then executes recovery, bootloader, and firmware operations. The CLI also offers direct reboot, fastboot, TWRP, and bootrom actions. Device-specific configuration and low-level MediaTek/eMMC access support those stages. The index and excerpts establish the main orchestration links; several capability branches are documented or indexed but their implementation was not sampled, so those links are omitted where unverified.
Main entry points: route.py Transition planner · __main__.py Command interface · bootrom_step.py Bootrom stage · host.py ADB and fastboot
Components 27
Workflow and discovery
- Command interface
firebreak/__main__.py - Device detection
firebreak/identify.py - State probing
firebreak/entry.py - Transition planner
firebreak/route.py - Device plans
firebreak/plugin.py - Device states
firebreak/states.py
Device transitions
- Echo models
firebreak/devices/biscuit.py - Unlock workflow
firebreak/unlock.py - Bootrom stage
firebreak/bootrom_step.py - Kamakiri stage
firebreak/kamakiri_step.py - Fire OS changes
firebreak/fireos.py - Recovery workflow
firebreak/recovery.py - TWRP operations
firebreak/twrp.py - Stock restoration
firebreak/stock.py
USB and storage
- MediaTek USB protocol
firebreak/mediatek/usbdl.py - Amonet payload
firebreak/amonet/payload.py - eMMC access
firebreak/emmc.py - ADB and fastboot
firebreak/host.py
Firmware and support
- Download cache
firebreak/cache.py - Device backup
firebreak/backup.py - Backup restore
firebreak/restore.py - Device survey
firebreak/survey.py - Progress and prompts
firebreak/ui.py
Other components
- Operator
- ADB executable
- Fastboot executable
- Echo over USB
Connections 41
- Operator → Command interface: invokes
README.md - Command interface → Device detection: discovers
firebreak/__main__.py - Command interface → Transition planner: dispatches
firebreak/__main__.py - Command interface → Device backup: invokes
firebreak/__main__.py - Command interface → Backup restore: invokes
firebreak/__main__.py - Command interface → Device survey: invokes
firebreak/__main__.py - Device detection → ADB and fastboot: queries
firebreak/identify.py - Device detection → Device states: reports
firebreak/identify.py - State probing → Device detection: checks device
firebreak/entry.py - State probing → Bootrom stage: runs stage
firebreak/entry.py - State probing → Kamakiri stage: runs stage
firebreak/entry.py - State probing → TWRP operations: checks recovery
firebreak/entry.py - State probing → Unlock workflow: invokes
firebreak/entry.py - Transition planner → Bootrom stage: dispatches
firebreak/route.py - Transition planner → Kamakiri stage: dispatches
firebreak/route.py - Transition planner → Fire OS changes: dispatches
firebreak/route.py - Transition planner → Recovery workflow: dispatches
firebreak/route.py - Transition planner → Stock restoration: dispatches
firebreak/route.py - Transition planner → Device plans: uses plans
firebreak/route.py - Transition planner → Device states: tracks progress
firebreak/route.py - Device plans → Device states: defines states
firebreak/plugin.py - Echo models → Device plans: configures models
firebreak/devices/biscuit.py - Bootrom stage → Amonet payload: starts payload
firebreak/bootrom_step.py - Bootrom stage → MediaTek USB protocol: uses protocol
firebreak/bootrom_step.py - Bootrom stage → eMMC access: accesses storage
firebreak/bootrom_step.py - Amonet payload → MediaTek USB protocol: uses connection
firebreak/amonet/payload.py - Kamakiri stage → MediaTek USB protocol: uses protocol
firebreak/kamakiri_step.py - Unlock workflow → Bootrom stage: invokes
firebreak/unlock.py - Unlock workflow → Recovery workflow: invokes
firebreak/unlock.py - Unlock workflow → TWRP operations: invokes
firebreak/unlock.py - Fire OS changes → ADB and fastboot: runs device commands
firebreak/fireos.py - Fire OS changes → Download cache: gets artifacts
firebreak/fireos.py - Recovery workflow → ADB and fastboot: runs device commands
firebreak/recovery.py - Recovery workflow → TWRP operations: uses recovery
firebreak/recovery.py - TWRP operations → ADB and fastboot: runs device commands
firebreak/twrp.py - ADB and fastboot → ADB executable: runs
firebreak/host.py - ADB and fastboot → Fastboot executable: runs
README.md - Device detection → Echo over USB: scans
firebreak/identify.py - MediaTek USB protocol → Echo over USB: communicates
README.md - Download cache → Progress and prompts: reports downloads
firebreak/cache.py - Progress and prompts → Operator: prompts
firebreak/ui.py