# dikeckaan/mu300-linux architecture

> Architecture diagram of the GitHub repository dikeckaan/mu300-linux, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dikeckaan/mu300-linux
- Repository: https://github.com/dikeckaan/mu300-linux

## Overview

This repository adapts the ZTE F50/MU300 and U30 Air into headless Linux devices, supporting Ubuntu or OpenWrt while retaining the ability to return to Android. The documented user journey is to check a rooted device, install Linux, then use it over SSH, USB networking, or LuCI; the installer entry point itself is not present in the supplied tree. The graph covers documented capabilities and sampled kernel/tool components. Some kernel subsystems are represented by their exact enclosing directories because their implementation files were not sampled.

Main entry points: [`boot/build-boot-image.py`](https://github.com/dikeckaan/mu300-linux/blob/main/boot/build-boot-image.py) (Boot Image), [`android-vendor`](https://github.com/dikeckaan/mu300-linux/tree/main/android-vendor) (Vendor Files), [`upstream/modules/sprd_wlan_combo`](https://github.com/dikeckaan/mu300-linux/tree/main/upstream/modules/sprd_wlan_combo) (Wi-Fi Driver), [`upstream/modules/wcn_bsp/pcie`](https://github.com/dikeckaan/mu300-linux/tree/main/upstream/modules/wcn_bsp/pcie) (Wireless Bus)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device["Device Enablement"]
  node_zte["ZTE Device"]
  node_bootimage["Boot Image"]
  node_vendor["Vendor Files"]
  node_linux["Linux System"]
end

subgraph group_connectivity["Connectivity"]
  node_wlan["Wi-Fi Driver"]
  node_wcn["Wireless Bus"]
  node_bluetooth["Bluetooth Setup<br/>[mu300-bt-init.c]"]
  node_modem["5G Modem"]
end

subgraph group_kernel["Kernel Drivers"]
  node_clock["UMS9620 Clocks<br/>[ums9620-clk.c]"]
  node_power["Modem Power"]
  node_gpu["Mali GPU"]
  node_platform["Platform Drivers"]
end

subgraph group_interaction["User Access"]
  node_openwrtui["LuCI Cellular<br/>[mu300cell.js]"]
  node_ssh["SSH Access"]
  node_usbnet["USB Networking"]
  node_toolkit["Device Toolkit"]
  node_serial["Serial Console<br/>[mu300-serial.py]"]
end

node_user(("Device Owner"))

node_user -->|"connects"| node_zte
node_user -->|"installs"| node_linux
node_bootimage -->|"boots Linux"| node_zte
node_vendor -.->|"supplies files"| node_bootimage
node_zte -->|"runs"| node_linux
node_linux -->|"offers interface"| node_openwrtui
node_linux -->|"provides access"| node_ssh
node_linux -->|"provides networking"| node_usbnet
node_linux -->|"provides console"| node_serial
node_linux -->|"includes"| node_toolkit
node_linux -->|"supports hotspot"| node_wlan
node_linux -.->|"supports wireless"| node_wcn
node_linux -->|"supports Bluetooth"| node_bluetooth
node_linux -->|"uses 5G"| node_modem
node_linux -->|"supports OpenCL"| node_gpu
node_linux -.->|"uses clock driver"| node_clock
node_linux -.->|"manages modem power"| node_power
node_linux -.->|"uses device drivers"| node_platform

click node_bootimage "https://github.com/dikeckaan/mu300-linux/blob/main/boot/build-boot-image.py"
click node_vendor "https://github.com/dikeckaan/mu300-linux/tree/main/android-vendor"
click node_openwrtui "https://github.com/dikeckaan/mu300-linux/blob/main/openwrt/overlay/www/luci-static/resources/protocol/mu300cell.js"
click node_wlan "https://github.com/dikeckaan/mu300-linux/tree/main/upstream/modules/sprd_wlan_combo"
click node_wcn "https://github.com/dikeckaan/mu300-linux/tree/main/upstream/modules/wcn_bsp/pcie"
click node_bluetooth "https://github.com/dikeckaan/mu300-linux/blob/main/tools/bt-init/mu300-bt-init.c"
click node_modem "https://github.com/dikeckaan/mu300-linux/tree/main/upstream/modules/sprd_modem"
click node_clock "https://github.com/dikeckaan/mu300-linux/blob/main/upstream/port/drivers/clk/sprd/ums9620-clk.c"
click node_power "https://github.com/dikeckaan/mu300-linux/blob/main/upstream/modules/sprd_modem/power_manager/sprd_power_manager.c"
click node_gpu "https://github.com/dikeckaan/mu300-linux/tree/main/upstream/modules/mali"
click node_platform "https://github.com/dikeckaan/mu300-linux/tree/main/upstream/port/drivers"
click node_serial "https://github.com/dikeckaan/mu300-linux/blob/main/tools/mu300-serial.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_zte,node_bootimage,node_vendor,node_linux toneBlue
class node_wlan,node_wcn,node_bluetooth,node_modem toneAmber
class node_clock,node_power,node_gpu,node_platform toneMint
class node_openwrtui,node_ssh,node_usbnet,node_toolkit,node_serial toneRose
class node_user toneIndigo
```

## Components

### Device Enablement

- **ZTE Device**
- [Boot Image](https://github.com/dikeckaan/mu300-linux/blob/main/boot/build-boot-image.py): `boot/build-boot-image.py`
- [Vendor Files](https://github.com/dikeckaan/mu300-linux/tree/main/android-vendor): `android-vendor`
- **Linux System**

### Connectivity

- [Wi-Fi Driver](https://github.com/dikeckaan/mu300-linux/tree/main/upstream/modules/sprd_wlan_combo): `upstream/modules/sprd_wlan_combo`
- [Wireless Bus](https://github.com/dikeckaan/mu300-linux/tree/main/upstream/modules/wcn_bsp/pcie): `upstream/modules/wcn_bsp/pcie`
- [Bluetooth Setup](https://github.com/dikeckaan/mu300-linux/blob/main/tools/bt-init/mu300-bt-init.c): `tools/bt-init/mu300-bt-init.c`
- [5G Modem](https://github.com/dikeckaan/mu300-linux/tree/main/upstream/modules/sprd_modem): `upstream/modules/sprd_modem`

### Kernel Drivers

- [UMS9620 Clocks](https://github.com/dikeckaan/mu300-linux/blob/main/upstream/port/drivers/clk/sprd/ums9620-clk.c): `upstream/port/drivers/clk/sprd/ums9620-clk.c`
- [Modem Power](https://github.com/dikeckaan/mu300-linux/blob/main/upstream/modules/sprd_modem/power_manager/sprd_power_manager.c): `upstream/modules/sprd_modem/power_manager/sprd_power_manager.c`
- [Mali GPU](https://github.com/dikeckaan/mu300-linux/tree/main/upstream/modules/mali): `upstream/modules/mali`
- [Platform Drivers](https://github.com/dikeckaan/mu300-linux/tree/main/upstream/port/drivers): `upstream/port/drivers`

### User Access

- [LuCI Cellular](https://github.com/dikeckaan/mu300-linux/blob/main/openwrt/overlay/www/luci-static/resources/protocol/mu300cell.js): `openwrt/overlay/www/luci-static/resources/protocol/mu300cell.js`
- **SSH Access**
- **USB Networking**
- **Device Toolkit**
- [Serial Console](https://github.com/dikeckaan/mu300-linux/blob/main/tools/mu300-serial.py): `tools/mu300-serial.py`

### Other components

- **Device Owner**

## Connections

- Device Owner → ZTE Device: connects (evidence: `README.md`)
- Device Owner → Linux System: installs (evidence: `README.md`)
- Boot Image → ZTE Device: boots Linux (evidence: `README.md`)
- Vendor Files → Boot Image: supplies files
- ZTE Device → Linux System: runs (evidence: `README.md`)
- Linux System → LuCI Cellular: offers interface (evidence: `README.md`)
- Linux System → SSH Access: provides access (evidence: `README.md`)
- Linux System → USB Networking: provides networking (evidence: `README.md`)
- Linux System → Serial Console: provides console (evidence: `README.md`)
- Linux System → Device Toolkit: includes (evidence: `README.md`)
- Linux System → Wi-Fi Driver: supports hotspot (evidence: `README.md`)
- Linux System → Wireless Bus: supports wireless
- Linux System → Bluetooth Setup: supports Bluetooth (evidence: `README.md`)
- Linux System → 5G Modem: uses 5G (evidence: `README.md`)
- Linux System → Mali GPU: supports OpenCL (evidence: `README.md`)
- Linux System → UMS9620 Clocks: uses clock driver
- Linux System → Modem Power: manages modem power
- Linux System → Platform Drivers: uses device drivers
