How openwrt-xiaomi/xmir-patcher works
XMiR-Patcher is a Xiaomi-router firmware patcher. The documented entry is running the application; the source index shows firmware installation as a central operation, supported by device access, device information, firmware-image parsing, and boot activation. The tree also exposes feature unlocking, SSH and language installation, backups, and reboot operations. Those branches are included, but their wiring is not asserted where source evidence was unavailable. The parser internals are represented where the index or excerpts support relationships; unsampled source was not inspected.
Main entry points: install_fw.py Firmware install · gateway.py Router gateway · activate_boot.py Boot activation · __init__.py Device tree parser
Components 29
Router access
- Router gateway
gateway.py - Device information
read_info.py - Connection methods
connect.py - Telnet client
xmir_base/telnetlib/telnetlib.py - Router environment
envbuffer.py
Router operations
- Firmware install
install_fw.py - Boot activation
activate_boot.py - Feature unlock
unlock_features.py - SSH install
install_ssh.py - Language install
install_lang.py - Backup creation
create_backup.py - Reboot
reboot.py - Router models
xqmodel.py
Firmware parsing
- Image reader
xqimage.py - UBI image I/O
xmir_base/ubireader/ubi_io.py - UBI volumes
xmir_base/ubireader/ubi/__init__.py - UBI block sorting
xmir_base/ubireader/ubi/block/sort.py - UBI structures
xmir_base/ubireader/ubi/defines.py - UBIFS nodes
xmir_base/ubireader/ubifs/nodes.py - UBIFS structures
xmir_base/ubireader/ubifs/defines.py - UBIFS utilities
xmir_base/ubireader/ubifs/misc.py - UBIFS display
xmir_base/ubireader/ubifs/display.py - UBIFS traversal
xmir_base/ubireader/ubifs/walk.py - UBIFS output
xmir_base/ubireader/ubifs/output.py
Image formats
- Device tree parser
xmir_base/fdt/__init__.py - FDT headers
xmir_base/fdt/header.py - FDT items
xmir_base/fdt/items.py - FDT utilities
xmir_base/fdt/misc.py
Other components
- Operator
Connections 35
- Operator → Firmware install: runs patcher
README.md - Firmware install → Router gateway: uses access
install_fw.py - Firmware install → Device information: reads device
install_fw.py - Firmware install → Boot activation: activates boot
install_fw.py - Firmware install → Router models: checks model
install_fw.py - Firmware install → Device tree parser: parses tree
install_fw.py - Firmware install → UBI volumes: parses UBI
install_fw.py - Boot activation → Router gateway: uses access
activate_boot.py - Boot activation → Device information: reads device
activate_boot.py - Boot activation → Router environment: uses buffer
activate_boot.py - Feature unlock → Router gateway: uses access
unlock_features.py - Router gateway → Telnet client: uses client
gateway.py - Image reader → Router environment: uses buffer
xqimage.py - Image reader → Router models: checks model
xqimage.py - UBI volumes → UBI block sorting: sorts blocks
xmir_base/ubireader/ubi/__init__.py - UBI volumes → UBI structures: uses definitions
xmir_base/ubireader/ubi/__init__.py - UBI image I/O → UBI block sorting: sorts blocks
xmir_base/ubireader/ubi_io.py - Device tree parser → FDT headers: uses headers
xmir_base/fdt/__init__.py - Device tree parser → FDT items: uses items
xmir_base/fdt/__init__.py - Device tree parser → FDT utilities: uses utilities
xmir_base/fdt/__init__.py - UBIFS nodes → UBIFS structures: uses definitions
xmir_base/ubireader/ubifs/nodes.py - UBIFS nodes → UBIFS utilities: uses utilities
xmir_base/ubireader/ubifs/nodes.py - UBIFS nodes → UBIFS display: formats display
xmir_base/ubireader/ubifs/nodes.py - UBIFS traversal → UBIFS nodes: parses nodes
xmir_base/ubireader/ubifs/walk.py - UBIFS traversal → UBIFS structures: uses definitions
xmir_base/ubireader/ubifs/walk.py - UBIFS output → UBIFS traversal: traverses
xmir_base/ubireader/ubifs/output.py - UBIFS output → UBIFS utilities: uses utilities
xmir_base/ubireader/ubifs/output.py - Connection methods → Router gateway: connects through
- Firmware install → Image reader: uses image reader
- Firmware install → UBI image I/O: reads image
install_fw.py - Operator → Feature unlock: requests operation
- Operator → SSH install: requests operation
- Operator → Language install: requests operation
- Operator → Backup creation: requests operation
- Operator → Reboot: requests operation