# elohim-etz/android_device_realme_rm6785 architecture

> Architecture diagram of the GitHub repository elohim-etz/android_device_realme_rm6785, 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/elohim-etz/android_device_realme_rm6785
- Repository: https://github.com/elohim-etz/android_device_realme_rm6785

## Overview

This is an Android device-support repository for the RM6785/MediaTek platform, not a standalone application. Its runtime responsibilities include hardware service adapters, a configurable doze/pickup experience, device initialization and product-specific resource configuration. A user enables doze or pickup behavior in Settings; the settings logic persists preferences and starts or stops the service, which monitors screen and sensor events and wakes the display or requests a doze pulse. Hardware services independently expose lights, touchscreen gestures and fingerprint functionality. Edges below are limited to excerpted calls and imports; several device subsystems are represented from the tree without asserting unsampled wiring.

Main entry points: [`doze/src/org/lineageos/settings/doze/Utils.kt`](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/Utils.kt) (Doze controls), [`doze/src/org/lineageos/settings/doze/DozeService.kt`](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/DozeService.kt) (Doze service), [`hidl/fingerprint/BiometricsFingerprint.cpp`](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/hidl/fingerprint/BiometricsFingerprint.cpp) (Fingerprint adapter), [`device.mk`](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/device.mk) (Device product setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_doze["Doze experience"]
  node_settings_activity["Doze settings activity"]
  node_settings_fragment["Doze preferences"]
  node_doze_utils["Doze controls<br/>[Utils.kt]"]
  node_doze_service["Doze service<br/>[DozeService.kt]"]
  node_pickup["Pickup sensor<br/>[PickupSensor.kt]"]
  node_pocket["Pocket sensor<br/>[PocketSensor.kt]"]
  node_boot_receiver["Boot receiver"]
end

subgraph group_hal["Hardware services"]
  node_lights_service["Lights HAL service<br/>[main.rs]"]
  node_lights_impl["Backlight control<br/>[lights.rs]"]
  node_touch_service["Touch gesture service<br/>[service.cpp]"]
  node_touch_impl["Gesture controls"]
  node_touch_iface["Touch AIDL interface"]
  node_fp_service["Fingerprint service<br/>[service.cpp]"]
  node_fp_adapter["Fingerprint adapter"]
  node_fp_iface["Fingerprint adapter API"]
end

subgraph group_device["Device configuration"]
  node_device_mk["Device product setup<br/>[device.mk]"]
  node_overlays["Resource overlays"]
  node_device_init["Device initialization<br/>[init_RM6785.cpp]"]
  node_vendor_init["Vendor initialization"]
  node_root_init["Runtime init rules<br/>[init.RM6785.rc]"]
  node_device_configs["Hardware configs"]
end

subgraph group_compat["Platform compatibility"]
  node_shims["Platform shims<br/>[mtk_hw_shim.cpp]"]
  node_audio_shim["Audio shim<br/>[libshim_audio.cpp]"]
  node_media["Camera provider extension"]
end

node_user(("Device user"))
node_systemui(("Android SystemUI"))
node_sysfs[("Backlight sysfs")]
node_vendor_fp["Oplus fingerprint HAL"]

node_user -->|"opens settings"| node_settings_activity
node_settings_activity -->|"loads fragment"| node_settings_fragment
node_settings_fragment -->|"updates controls"| node_doze_utils
node_doze_utils -->|"starts or stops"| node_doze_service
node_doze_service -->|"enables sensor"| node_pickup
node_doze_service -->|"checks preference"| node_doze_utils
node_pickup -->|"checks and pulses"| node_doze_utils
node_doze_utils -->|"broadcasts pulse"| node_systemui
node_boot_receiver -->|"checks service"| node_doze_utils
node_lights_service -->|"registers service"| node_lights_impl
node_lights_impl -->|"reads and writes"| node_sysfs
node_touch_service -->|"instantiates service"| node_touch_impl
node_touch_impl -->|"implements interface"| node_touch_iface
node_fp_service -->|"registers adapter"| node_fp_adapter
node_fp_adapter -->|"implements interface"| node_fp_iface
node_fp_adapter -->|"delegates requests"| node_vendor_fp
node_device_mk -.->|"configures resources"| node_overlays
node_root_init -.->|"runs initialization"| node_device_init
node_device_mk -.->|"installs settings"| node_device_configs

click node_settings_activity "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/DozeSettingsActivity.kt"
click node_settings_fragment "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/DozeSettingsFragment.kt"
click node_doze_utils "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/Utils.kt"
click node_doze_service "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/DozeService.kt"
click node_pickup "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/PickupSensor.kt"
click node_pocket "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/PocketSensor.kt"
click node_boot_receiver "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/BootCompletedReceiver.kt"
click node_lights_service "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/aidl/lights/main.rs"
click node_lights_impl "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/aidl/lights/lights.rs"
click node_touch_service "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/aidl/touch/service.cpp"
click node_touch_impl "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/aidl/touch/TouchscreenGesture.cpp"
click node_touch_iface "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/aidl/touch/TouchscreenGesture.h"
click node_fp_service "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/hidl/fingerprint/service.cpp"
click node_fp_adapter "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/hidl/fingerprint/BiometricsFingerprint.cpp"
click node_fp_iface "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/hidl/fingerprint/BiometricsFingerprint.h"
click node_device_mk "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/device.mk"
click node_overlays "https://github.com/elohim-etz/android_device_realme_rm6785/tree/lineage-23.2/rro_overlays"
click node_device_init "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/init/init_RM6785.cpp"
click node_vendor_init "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/init/init_RM6785_vendor.cpp"
click node_root_init "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/rootdir/etc/init.RM6785.rc"
click node_device_configs "https://github.com/elohim-etz/android_device_realme_rm6785/tree/lineage-23.2/configs"
click node_shims "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/libshims/mtk_hw_shim/mtk_hw_shim.cpp"
click node_audio_shim "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/libshims/libshim_audio.cpp"
click node_media "https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/camera/CameraProviderExtension.cpp"

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_settings_activity,node_settings_fragment,node_doze_utils,node_doze_service,node_pickup,node_pocket,node_boot_receiver,node_user,node_systemui toneBlue
class node_lights_service,node_lights_impl,node_touch_service,node_touch_impl,node_touch_iface,node_fp_service,node_fp_adapter,node_fp_iface,node_sysfs toneAmber
class node_device_mk,node_overlays,node_device_init,node_vendor_init,node_root_init,node_device_configs toneMint
class node_shims,node_audio_shim,node_media toneRose
class node_vendor_fp toneIndigo
```

## Components

### Doze experience

- [Doze settings activity](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/DozeSettingsActivity.kt): `doze/src/org/lineageos/settings/doze/DozeSettingsActivity.kt`
- [Doze preferences](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/DozeSettingsFragment.kt): `doze/src/org/lineageos/settings/doze/DozeSettingsFragment.kt`
- [Doze controls](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/Utils.kt): `doze/src/org/lineageos/settings/doze/Utils.kt`
- [Doze service](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/DozeService.kt): `doze/src/org/lineageos/settings/doze/DozeService.kt`
- [Pickup sensor](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/PickupSensor.kt): `doze/src/org/lineageos/settings/doze/PickupSensor.kt`
- [Pocket sensor](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/PocketSensor.kt): `doze/src/org/lineageos/settings/doze/PocketSensor.kt`
- [Boot receiver](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/doze/src/org/lineageos/settings/doze/BootCompletedReceiver.kt): `doze/src/org/lineageos/settings/doze/BootCompletedReceiver.kt`

### Hardware services

- [Lights HAL service](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/aidl/lights/main.rs): `aidl/lights/main.rs`
- [Backlight control](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/aidl/lights/lights.rs): `aidl/lights/lights.rs`
- [Touch gesture service](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/aidl/touch/service.cpp): `aidl/touch/service.cpp`
- [Gesture controls](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/aidl/touch/TouchscreenGesture.cpp): `aidl/touch/TouchscreenGesture.cpp`
- [Touch AIDL interface](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/aidl/touch/TouchscreenGesture.h): `aidl/touch/TouchscreenGesture.h`
- [Fingerprint service](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/hidl/fingerprint/service.cpp): `hidl/fingerprint/service.cpp`
- [Fingerprint adapter](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/hidl/fingerprint/BiometricsFingerprint.cpp): `hidl/fingerprint/BiometricsFingerprint.cpp`
- [Fingerprint adapter API](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/hidl/fingerprint/BiometricsFingerprint.h): `hidl/fingerprint/BiometricsFingerprint.h`

### Device configuration

- [Device product setup](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/device.mk): `device.mk`
- [Resource overlays](https://github.com/elohim-etz/android_device_realme_rm6785/tree/lineage-23.2/rro_overlays): `rro_overlays`
- [Device initialization](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/init/init_RM6785.cpp): `init/init_RM6785.cpp`
- [Vendor initialization](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/init/init_RM6785_vendor.cpp): `init/init_RM6785_vendor.cpp`
- [Runtime init rules](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/rootdir/etc/init.RM6785.rc): `rootdir/etc/init.RM6785.rc`
- [Hardware configs](https://github.com/elohim-etz/android_device_realme_rm6785/tree/lineage-23.2/configs): `configs`

### Platform compatibility

- [Platform shims](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/libshims/mtk_hw_shim/mtk_hw_shim.cpp): `libshims/mtk_hw_shim/mtk_hw_shim.cpp`
- [Audio shim](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/libshims/libshim_audio.cpp): `libshims/libshim_audio.cpp`
- [Camera provider extension](https://github.com/elohim-etz/android_device_realme_rm6785/blob/lineage-23.2/camera/CameraProviderExtension.cpp): `camera/CameraProviderExtension.cpp`

### Other components

- **Device user**
- **Android SystemUI**
- **Backlight sysfs**
- **Oplus fingerprint HAL**

## Connections

- Device user → Doze settings activity: opens settings (evidence: `doze/src/org/lineageos/settings/doze/DozeSettingsActivity.kt`)
- Doze settings activity → Doze preferences: loads fragment (evidence: `doze/src/org/lineageos/settings/doze/DozeSettingsActivity.kt`)
- Doze preferences → Doze controls: updates controls (evidence: `doze/src/org/lineageos/settings/doze/DozeSettingsFragment.kt`)
- Doze controls → Doze service: starts or stops (evidence: `doze/src/org/lineageos/settings/doze/Utils.kt`)
- Doze service → Pickup sensor: enables sensor (evidence: `doze/src/org/lineageos/settings/doze/DozeService.kt`)
- Doze service → Doze controls: checks preference (evidence: `doze/src/org/lineageos/settings/doze/DozeService.kt`)
- Pickup sensor → Doze controls: checks and pulses (evidence: `doze/src/org/lineageos/settings/doze/PickupSensor.kt`)
- Doze controls → Android SystemUI: broadcasts pulse (evidence: `doze/src/org/lineageos/settings/doze/Utils.kt`)
- Boot receiver → Doze controls: checks service (evidence: `doze/src/org/lineageos/settings/doze/BootCompletedReceiver.kt`)
- Lights HAL service → Backlight control: registers service (evidence: `aidl/lights/main.rs`)
- Backlight control → Backlight sysfs: reads and writes (evidence: `aidl/lights/lights.rs`)
- Touch gesture service → Gesture controls: instantiates service (evidence: `aidl/touch/service.cpp`)
- Gesture controls → Touch AIDL interface: implements interface (evidence: `aidl/touch/TouchscreenGesture.cpp`)
- Fingerprint service → Fingerprint adapter: registers adapter (evidence: `hidl/fingerprint/service.cpp`)
- Fingerprint adapter → Fingerprint adapter API: implements interface (evidence: `hidl/fingerprint/BiometricsFingerprint.cpp`)
- Fingerprint adapter → Oplus fingerprint HAL: delegates requests (evidence: `hidl/fingerprint/BiometricsFingerprint.cpp`)
- Device product setup → Resource overlays: configures resources
- Runtime init rules → Device initialization: runs initialization
- Device product setup → Hardware configs: installs settings
