# ximiyad123/ubports-garnet architecture

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

- Interactive diagram: https://gitdiagram.com/ximiyad123/ubports-garnet
- Repository: https://github.com/ximiyad123/ubports-garnet

## Overview

This repository is a Halium-based Ubuntu Touch device port for the Redmi Note 13 Pro 5G / Poco X6 5G (garnet). Its user-facing result is Ubuntu Touch running on that device; the README documents hardware support and known limitations. The tree shows system overlays, ramdisk additions, device configuration, and flashing assets, but no source excerpts were provided. Therefore the graph preserves those product areas without asserting unshown runtime calls or mappings from individual configuration files to hardware features.

Main entry points: [`deviceinfo`](https://github.com/ximiyad123/ubports-garnet/blob/ubports-garnet/deviceinfo) (Ubuntu Touch port)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device["Device definition"]
  node_port["Ubuntu Touch port"]
  node_hardware["Device hardware support"]
end

subgraph group_system["Ubuntu Touch integration"]
  node_system_overlay["System configuration overlay"]
  node_connectivity["USB and tethering"]
  node_telephony["Telephony configuration"]
  node_audio["Audio configuration"]
  node_media["Media hub policy"]
  node_libinput["Input quirks"]
  node_usb_services["USB services"]
end

subgraph group_boot["Boot environment"]
  node_ramdisk["Ramdisk extensions"]
  node_android_mounts["Android partition mounts"]
end

subgraph group_install["Device installation"]
  node_installer["Installer scripts"]
  node_images["Installer images"]
end

node_owner(("Port maintainer"))
node_garnet["Garnet device"]

node_owner -->|"builds for"| node_port
node_port -->|"targets"| node_garnet

click node_port "https://github.com/ximiyad123/ubports-garnet/blob/ubports-garnet/deviceinfo"
click node_hardware "https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system/etc/deviceinfo/devices"
click node_system_overlay "https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system"
click node_connectivity "https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system/usr/libexec/usb-moded"
click node_telephony "https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system/etc/ofono"
click node_audio "https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system/etc/pulse"
click node_media "https://github.com/ximiyad123/ubports-garnet/blob/ubports-garnet/overlay/system/etc/apparmor.d/local/usr.bin.media-hub-server"
click node_libinput "https://github.com/ximiyad123/ubports-garnet/blob/ubports-garnet/overlay/system/usr/libexec/lxc-android-config/generate-libinput-quirks"
click node_usb_services "https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system/etc/systemd/system"
click node_ramdisk "https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/ramdisk-overlay"
click node_android_mounts "https://github.com/ximiyad123/ubports-garnet/blob/ubports-garnet/overlay/system/usr/libexec/lxc-android-config/mount-android-partitions"
click node_installer "https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/installer-scripts"
click node_images "https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/installer-scripts/images"

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_port,node_hardware toneBlue
class node_system_overlay,node_connectivity,node_telephony,node_audio,node_media,node_libinput,node_usb_services toneAmber
class node_ramdisk,node_android_mounts toneMint
class node_installer,node_images toneRose
class node_owner,node_garnet toneIndigo
```

## Components

### Device definition

- [Ubuntu Touch port](https://github.com/ximiyad123/ubports-garnet/blob/ubports-garnet/deviceinfo): `deviceinfo`
- [Device hardware support](https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system/etc/deviceinfo/devices): `overlay/system/etc/deviceinfo/devices`

### Ubuntu Touch integration

- [System configuration overlay](https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system): `overlay/system`
- [USB and tethering](https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system/usr/libexec/usb-moded): `overlay/system/usr/libexec/usb-moded`
- [Telephony configuration](https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system/etc/ofono): `overlay/system/etc/ofono`
- [Audio configuration](https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system/etc/pulse): `overlay/system/etc/pulse`
- [Media hub policy](https://github.com/ximiyad123/ubports-garnet/blob/ubports-garnet/overlay/system/etc/apparmor.d/local/usr.bin.media-hub-server): `overlay/system/etc/apparmor.d/local/usr.bin.media-hub-server`
- [Input quirks](https://github.com/ximiyad123/ubports-garnet/blob/ubports-garnet/overlay/system/usr/libexec/lxc-android-config/generate-libinput-quirks): `overlay/system/usr/libexec/lxc-android-config/generate-libinput-quirks`
- [USB services](https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/overlay/system/etc/systemd/system): `overlay/system/etc/systemd/system`

### Boot environment

- [Ramdisk extensions](https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/ramdisk-overlay): `ramdisk-overlay`
- [Android partition mounts](https://github.com/ximiyad123/ubports-garnet/blob/ubports-garnet/overlay/system/usr/libexec/lxc-android-config/mount-android-partitions): `overlay/system/usr/libexec/lxc-android-config/mount-android-partitions`

### Device installation

- [Installer scripts](https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/installer-scripts): `installer-scripts`
- [Installer images](https://github.com/ximiyad123/ubports-garnet/tree/ubports-garnet/installer-scripts/images): `installer-scripts/images`

### Other components

- **Port maintainer**
- **Garnet device**

## Connections

- Port maintainer → Ubuntu Touch port: builds for (evidence: `README.md`)
- Ubuntu Touch port → Garnet device: targets (evidence: `README.md`)
