# raspberry-vanilla/android_device_brcm_rpi5 architecture

> Architecture diagram of the GitHub repository raspberry-vanilla/android_device_brcm_rpi5, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/raspberry-vanilla/android_device_brcm_rpi5
- Repository: https://github.com/raspberry-vanilla/android_device_brcm_rpi5

## Overview

##### Project type and purpose
- This is not a user-facing app but a device configuration layer for AOSP (Android Open Source Project) 15, targeting Raspberry Pi 5.
- It provides HAL implementations (audio, bluetooth, camera, hdmi, health, light, media, usb, wifi), init scripts, SELinux policies, overlays, and build definitions needed to produce a bootable Android image for the Pi 5.

##### File structure
- Top-level build scripts:
- Android.bp, AndroidProducts.mk, device.mk, BoardConfig.mk, product_manifest.xml → Soong/Make integration to assemble the device.
- mkbootimg.mk, mkimg.sh, wrimg.sh → Boot-image and system-image creation.
- Hardware modules (each folder builds a HAL + service): audio/, bluetooth/, camera/, hdmi/, health/, light/, media/, usb/, wifi/, suspend_blocker/
- Each contains Android.bp, service RC & XML for init, apex manifests.
- System configuration:
- ramdisk/ (init.rpi5.rc, fstab), overlay/ (multiple APK-overrides for SystemUI, Settings, Bluetooth, Wifi, Car, etc.), sepolicy/ and seccomp_policy/
- Manifest.xml and aosp_rpi5*.mk variants for Car/TV/Vanilla products.

##### README
- Confirms “Raspberry Vanilla AOSP 15 device configuration for Raspberry Pi 5.”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Kernel Layer
    Kernel["Linux Kernel + Device Drivers"]:::kernel

    %% Init & Ramdisk
    subgraph "Init & Ramdisk" 
        direction TB
        InitR1["init.rpi5.rc"]:::init
        InitR2["init.rpi5.usb.rc"]:::init
        InitR3["ueventd.rpi5.rc"]:::init
        InitR4["fstab.rpi5"]:::init
    end

    %% SELinux Policy Engine
    subgraph "SELinux Policy Engine"
        direction TB
        SePolicyDir["sepolicy/"]:::selinux
        Seccomp1["android.hardware.media.c2-ffmpeg.policy"]:::selinux
        Seccomp2["mediacodec.policy"]:::selinux
        Seccomp3["mediaswcodec.policy"]:::selinux
    end

    %% Vendor HAL Layer
    subgraph "Vendor HAL Layer"
        direction TB
        AudioHAL["Audio HAL APEX"]:::hal
        BluetoothHAL["Bluetooth HAL APEX"]:::hal
        CameraHAL["Camera HAL APEX"]:::hal
        HdmiCecHAL["HDMI CEC HAL APEX"]:::hal
        HdmiConnHAL["HDMI Connection HAL APEX"]:::hal
        HealthHAL["Health HAL APEX"]:::hal
        LightHAL["Light HAL APEX"]:::hal
        MediaHAL["Media HAL (codec configs)"]:::hal
        UsbHAL["USB HAL APEX"]:::hal
        WifiHAL["WiFi HAL APEX"]:::hal
        SuspendHAL["Suspend Blocker HAL APEX"]:::hal
    end

    %% Framework & System Apps
    Framework["Android Framework & System Apps"]:::framework

    %% Overlays
    subgraph "Resource Overlays"
        direction TB
        OverlayBase["AndroidRpiOverlay"]:::overlay
        OverlayTv["AndroidTvRpiOverlay"]:::overlay
        OverlayBt["BluetoothRpiOverlay"]:::overlay
        OverlayCar["CarServiceRpiOverlay"]:::overlay
        OverlaySP["SettingsProviderRpiOverlay"]:::overlay
        OverlaySPTv["SettingsProviderTvRpiOverlay"]:::overlay
        OverlaySettings["SettingsRpiOverlay"]:::overlay
        OverlaySysUI["SystemUIRpiOverlay"]:::overlay
        OverlayWifi["WifiRpiOverlay"]:::overlay
    end

    %% Build System
    subgraph "Build System"
        direction TB
        AndroidBP["Android.bp"]:::build
        ProductsMK["AndroidProducts.mk"]:::build
        BoardCfg["BoardConfig.mk"]:::build
        DeviceMK["device.mk"]:::build
        VariantsMK["aosp_rpi5*.mk"]:::build
        Manifest["manifest.xml & product_manifest.xml"]:::build
        ImgScripts["mkbootimg.mk, mkimg.sh, wrimg.sh"]:::build
    end

    %% Boot Configuration
    BootConfig["boot/config.txt & vendor.prop"]:::build

    %% Connections
    Kernel -->|"exposes device nodes"| InitR1
    Kernel --> InitR2
    Kernel --> InitR3
    Kernel --> InitR4

    InitR1 -->|"starts HAL services"| AudioHAL
    InitR1 --> BluetoothHAL
    InitR1 --> CameraHAL
    InitR1 --> HdmiCecHAL
    InitR1 --> HdmiConnHAL
    InitR1 --> HealthHAL
    InitR1 --> LightHAL
    InitR1 --> MediaHAL
    InitR1 --> UsbHAL
    InitR1 --> WifiHAL
    InitR1 --> SuspendHAL

    SePolicyDir -->|enforces| InitR1
    SePolicyDir -->|enforces| AudioHAL
    SePolicyDir -->|enforces| BluetoothHAL
    SePolicyDir -->|enforces| CameraHAL
    SePolicyDir -->|enforces| HdmiCecHAL
    SePolicyDir -->|enforces| HdmiConnHAL
    SePolicyDir -->|enforces| HealthHAL
    SePolicyDir -->|enforces| LightHAL
    SePolicyDir -->|enforces| MediaHAL
    SePolicyDir -->|enforces| UsbHAL
    SePolicyDir -->|enforces| WifiHAL
    SePolicyDir -->|enforces| SuspendHAL

    AudioHAL -->|"Binder IPC"| Framework
    BluetoothHAL --> Framework
    CameraHAL --> Framework
    HdmiCecHAL --> Framework
    HdmiConnHAL --> Framework
    HealthHAL --> Framework
    LightHAL --> Framework
    MediaHAL --> Framework
    UsbHAL --> Framework
    WifiHAL --> Framework
    SuspendHAL --> Framework

    Overlays --> Framework

    BuildSystem -->|"compiles Android.bp modules & merges overlays"| Framework
    BuildSystem -->|"packages APEX & creates images"| ImgScripts
    ImgScripts --> BootConfig

    %% Click Events
    click InitR1 "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/ramdisk/init.rpi5.rc"
    click InitR2 "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/ramdisk/init.rpi5.usb.rc"
    click InitR3 "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/ramdisk/ueventd.rpi5.rc"
    click InitR4 "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/ramdisk/fstab.rpi5"

    click SePolicyDir "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/tree/android-15.0/sepolicy/"
    click Seccomp1 "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/seccomp_policy/android.hardware.media.c2-ffmpeg.policy"
    click Seccomp2 "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/seccomp_policy/mediacodec.policy"
    click Seccomp3 "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/seccomp_policy/mediaswcodec.policy"

    click AudioHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/audio/Android.bp"
    click BluetoothHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/bluetooth/Android.bp"
    click CameraHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/camera/android.hardware.camera.provider@2.5-service_64.rpi.rc"
    click HdmiCecHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/hdmi/cec/Android.bp"
    click HdmiConnHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/hdmi/connection/Android.bp"
    click HealthHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/health/Android.bp"
    click LightHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/light/Android.bp"
    click MediaHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/media/media_codecs.xml"
    click UsbHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/usb/Android.bp"
    click WifiHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/wifi/Android.bp"
    click SuspendHAL "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/suspend_blocker/Android.bp"

    click OverlayBase "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/tree/android-15.0/overlay/AndroidRpiOverlay/"
    click OverlayTv "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/tree/android-15.0/overlay/AndroidTvRpiOverlay/"
    click OverlayBt "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/tree/android-15.0/overlay/BluetoothRpiOverlay/"
    click OverlayCar "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/tree/android-15.0/overlay/CarServiceRpiOverlay/"
    click OverlaySP "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/tree/android-15.0/overlay/SettingsProviderRpiOverlay/"
    click OverlaySPTv "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/tree/android-15.0/overlay/SettingsProviderTvRpiOverlay/"
    click OverlaySettings "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/tree/android-15.0/overlay/SettingsRpiOverlay/"
    click OverlaySysUI "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/tree/android-15.0/overlay/SystemUIRpiOverlay/"
    click OverlayWifi "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/tree/android-15.0/overlay/WifiRpiOverlay/"

    click AndroidBP "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/Android.bp"
    click ProductsMK "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/AndroidProducts.mk"
    click BoardCfg "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/BoardConfig.mk"
    click DeviceMK "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/device.mk"
    click VariantsMK "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/aosp_rpi5.mk"
    click Manifest "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/product_manifest.xml"
    click ImgScripts "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/mkimg.sh"

    click BootConfig "https://github.com/raspberry-vanilla/android_device_brcm_rpi5/blob/android-15.0/boot/config.txt"

    %% Styles
    classDef kernel fill:#eef,stroke:#333,stroke-width:1px
    classDef init fill:#e8f8e0,stroke:#333,stroke-width:1px
    classDef selinux fill:#fdecea,stroke:#333,stroke-width:1px
    classDef hal fill:#e0f0ff,stroke:#333,stroke-width:1px
    classDef framework fill:#fff4e0,stroke:#333,stroke-width:1px
    classDef overlay fill:#e8e8f8,stroke:#333,stroke-width:1px
    classDef build fill:#fffdea,stroke:#333,stroke-width:1px
```
