# rdkcentral/entservices-apis architecture

> Architecture diagram of the GitHub repository rdkcentral/entservices-apis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rdkcentral/entservices-apis
- Repository: https://github.com/rdkcentral/entservices-apis

## Overview

This repository defines Thunder service interfaces for RDK entertainment devices; it is not the service implementations themselves. The principal workflow is an application invoking an exposed interface to access a platform capability, with interface headers specifying the available operations and RPC annotations. Major documented capability areas span application lifecycle and packaging, device control, media, connectivity, storage, and system services. The README describes COM-RPC support by default and JSON-RPC where annotated. The graph represents these as API surfaces; sampled files do not establish runtime call chains between services.

Main entry points: [`apis/AppManager/IAppManager.h`](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AppManager/IAppManager.h) (App lifecycle), [`apis/LifecycleManager/ILifecycleManager.h`](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/LifecycleManager/ILifecycleManager.h) (Lifecycle control), [`apis/AppGateway/IAppGateway.h`](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AppGateway/IAppGateway.h) (App gateway), [`apis/PreinstallManager/IPreinstallManager.h`](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/PreinstallManager/IPreinstallManager.h) (Preinstallation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["App management"]
  node_app_lifecycle["App lifecycle<br/>[IAppManager.h]"]
  node_lifecycle_mgr["Lifecycle control"]
  node_app_gateway["App gateway<br/>[IAppGateway.h]"]
  node_preinstall["Preinstallation"]
end

subgraph group_device["Device capabilities"]
  node_device_info["Device information<br/>[IDeviceInfo.h]"]
  node_device_settings["Device settings<br/>[IDeviceSettings.h]"]
  node_audio_settings["Audio settings"]
  node_power["Power management<br/>[IPowerManager.h]"]
  node_remote["Remote control<br/>[IRemoteControl.h]"]
  node_hdmi["HDMI-CEC sink<br/>[IHdmiCecSink.h]"]
end

subgraph group_media["Media and connectivity"]
  node_avinput["AV input<br/>[IAVInput.h]"]
  node_text_track["Text tracks<br/>[ITextTrack.h]"]
  node_voice["Voice control<br/>[IVoiceControl.h]"]
  node_xcast["XCast<br/>[IXCast.h]"]
end

subgraph group_platform["Platform services"]
  node_system_services["System services<br/>[ISystemServices.h]"]
  node_resource_mgr["Resource management<br/>[IResourceManager.h]"]
  node_runtime_mgr["Runtime management<br/>[IRuntimeManager.h]"]
end

subgraph group_storage["Storage and packages"]
  node_shared_storage["Shared storage<br/>[ISharedStorage.h]"]
  node_app_package["App packages"]
  node_package_mgr["Package management<br/>[IPackageManager.h]"]
  node_app_storage["App storage"]
end

node_app(("Applications"))

node_app -->|"invokes API"| node_app_lifecycle
node_app -->|"invokes API"| node_lifecycle_mgr
node_app -->|"invokes API"| node_app_gateway
node_app -->|"invokes API"| node_preinstall
node_app -->|"invokes API"| node_device_info
node_app -->|"invokes API"| node_device_settings
node_app -->|"invokes API"| node_audio_settings
node_app -->|"invokes API"| node_power
node_app -->|"invokes API"| node_remote
node_app -->|"invokes API"| node_hdmi
node_app -->|"invokes API"| node_avinput
node_app -->|"invokes API"| node_text_track
node_app -->|"invokes API"| node_voice
node_app -->|"invokes API"| node_xcast
node_app -->|"invokes API"| node_system_services
node_app -->|"invokes API"| node_resource_mgr
node_app -->|"invokes API"| node_runtime_mgr
node_app -->|"invokes API"| node_shared_storage
node_app -->|"invokes API"| node_app_package
node_app -->|"invokes API"| node_package_mgr
node_app -->|"invokes API"| node_app_storage

click node_app_lifecycle "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AppManager/IAppManager.h"
click node_lifecycle_mgr "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/LifecycleManager/ILifecycleManager.h"
click node_app_gateway "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AppGateway/IAppGateway.h"
click node_preinstall "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/PreinstallManager/IPreinstallManager.h"
click node_device_info "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/DeviceInfo/IDeviceInfo.h"
click node_device_settings "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/DeviceSettings/IDeviceSettings.h"
click node_audio_settings "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/DeviceSettings/IDeviceSettingsAudio.h"
click node_power "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/PowerManager/IPowerManager.h"
click node_remote "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/RemoteControl/IRemoteControl.h"
click node_hdmi "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/HdmiCecSink/IHdmiCecSink.h"
click node_avinput "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AVInput/IAVInput.h"
click node_text_track "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/TextTrack/ITextTrack.h"
click node_voice "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/VoiceControl/IVoiceControl.h"
click node_xcast "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/XCast/IXCast.h"
click node_system_services "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/SystemServices/ISystemServices.h"
click node_resource_mgr "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/ResourceManager/IResourceManager.h"
click node_runtime_mgr "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/RuntimeManager/IRuntimeManager.h"
click node_shared_storage "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/SharedStorage/ISharedStorage.h"
click node_app_package "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AppPackageManager/IAppPackageManager.h"
click node_package_mgr "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/PackageManager/IPackageManager.h"
click node_app_storage "https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AppStorageManager/IAppStorageManager.h"

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_app_lifecycle,node_lifecycle_mgr,node_app_gateway,node_preinstall toneBlue
class node_device_info,node_device_settings,node_audio_settings,node_power,node_remote,node_hdmi toneAmber
class node_avinput,node_text_track,node_voice,node_xcast toneMint
class node_system_services,node_resource_mgr,node_runtime_mgr toneRose
class node_shared_storage,node_app_package,node_package_mgr,node_app_storage,node_app toneIndigo
```

## Components

### App management

- [App lifecycle](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AppManager/IAppManager.h): `apis/AppManager/IAppManager.h`
- [Lifecycle control](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/LifecycleManager/ILifecycleManager.h): `apis/LifecycleManager/ILifecycleManager.h`
- [App gateway](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AppGateway/IAppGateway.h): `apis/AppGateway/IAppGateway.h`
- [Preinstallation](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/PreinstallManager/IPreinstallManager.h): `apis/PreinstallManager/IPreinstallManager.h`

### Device capabilities

- [Device information](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/DeviceInfo/IDeviceInfo.h): `apis/DeviceInfo/IDeviceInfo.h`
- [Device settings](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/DeviceSettings/IDeviceSettings.h): `apis/DeviceSettings/IDeviceSettings.h`
- [Audio settings](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/DeviceSettings/IDeviceSettingsAudio.h): `apis/DeviceSettings/IDeviceSettingsAudio.h`
- [Power management](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/PowerManager/IPowerManager.h): `apis/PowerManager/IPowerManager.h`
- [Remote control](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/RemoteControl/IRemoteControl.h): `apis/RemoteControl/IRemoteControl.h`
- [HDMI-CEC sink](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/HdmiCecSink/IHdmiCecSink.h): `apis/HdmiCecSink/IHdmiCecSink.h`

### Media and connectivity

- [AV input](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AVInput/IAVInput.h): `apis/AVInput/IAVInput.h`
- [Text tracks](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/TextTrack/ITextTrack.h): `apis/TextTrack/ITextTrack.h`
- [Voice control](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/VoiceControl/IVoiceControl.h): `apis/VoiceControl/IVoiceControl.h`
- [XCast](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/XCast/IXCast.h): `apis/XCast/IXCast.h`

### Platform services

- [System services](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/SystemServices/ISystemServices.h): `apis/SystemServices/ISystemServices.h`
- [Resource management](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/ResourceManager/IResourceManager.h): `apis/ResourceManager/IResourceManager.h`
- [Runtime management](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/RuntimeManager/IRuntimeManager.h): `apis/RuntimeManager/IRuntimeManager.h`

### Storage and packages

- [Shared storage](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/SharedStorage/ISharedStorage.h): `apis/SharedStorage/ISharedStorage.h`
- [App packages](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AppPackageManager/IAppPackageManager.h): `apis/AppPackageManager/IAppPackageManager.h`
- [Package management](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/PackageManager/IPackageManager.h): `apis/PackageManager/IPackageManager.h`
- [App storage](https://github.com/rdkcentral/entservices-apis/blob/develop/apis/AppStorageManager/IAppStorageManager.h): `apis/AppStorageManager/IAppStorageManager.h`

### Other components

- **Applications**

## Connections

- Applications → App lifecycle: invokes API (evidence: `README.md`)
- Applications → Lifecycle control: invokes API (evidence: `README.md`)
- Applications → App gateway: invokes API (evidence: `README.md`)
- Applications → Preinstallation: invokes API (evidence: `README.md`)
- Applications → Device information: invokes API (evidence: `README.md`)
- Applications → Device settings: invokes API (evidence: `README.md`)
- Applications → Audio settings: invokes API (evidence: `README.md`)
- Applications → Power management: invokes API (evidence: `README.md`)
- Applications → Remote control: invokes API (evidence: `README.md`)
- Applications → HDMI-CEC sink: invokes API (evidence: `README.md`)
- Applications → AV input: invokes API (evidence: `README.md`)
- Applications → Text tracks: invokes API (evidence: `README.md`)
- Applications → Voice control: invokes API (evidence: `README.md`)
- Applications → XCast: invokes API (evidence: `README.md`)
- Applications → System services: invokes API (evidence: `README.md`)
- Applications → Resource management: invokes API (evidence: `README.md`)
- Applications → Runtime management: invokes API (evidence: `README.md`)
- Applications → Shared storage: invokes API (evidence: `README.md`)
- Applications → App packages: invokes API (evidence: `README.md`)
- Applications → Package management: invokes API (evidence: `README.md`)
- Applications → App storage: invokes API (evidence: `README.md`)
