# philips-labs/ble-ghs-client-example architecture

> Architecture diagram of the GitHub repository philips-labs/ble-ghs-client-example, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/philips-labs/ble-ghs-client-example
- Repository: https://github.com/philips-labs/ble-ghs-client-example

## Overview

This is an Android BLE Generic Health Sensor client demonstrator. The main workflow is: a user starts scanning, connects to a peripheral, the BLE manager routes GATT events to service handlers, and the GHS handler parses observations for display, logging, or optional FHIR upload. Separate capabilities support stored-observation retrieval (RACP), device information and clock controls, and auxiliary BLE services. The source excerpts and index show key routing and calls; some UI-to-feature wiring is documented only in the README, and unsampled service details are represented at subsystem level.

Main entry points: [`app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt) (BLE service manager), [`app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt`](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt) (GHS service handler), [`app/src/main/java/com/philips/bleclient/ui/MainActivity.kt`](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/MainActivity.kt) (Main screen), [`app/src/main/java/com/philips/bleclient/service/ghs/GhsRacpHandler.kt`](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ghs/GhsRacpHandler.kt) (Stored record control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and BLE lifecycle"]
  node_main["Main screen<br/>[MainActivity.kt]"]
  node_manager["BLE service manager"]
  node_basehandler["Service handler base<br/>[ServiceHandler.kt]"]
end

subgraph group_ghs["Health observation handling"]
  node_ghshandler["GHS service handler"]
  node_ghshelpers["GHS protocol handlers"]
  node_specialization["Device specialization"]
  node_racp["Stored record control<br/>[GhsRacpHandler.kt]"]
end

subgraph group_services["Peripheral services"]
  node_otherhandlers["Auxiliary BLE handlers"]
  node_bas["Battery service"]
  node_dis["Device information<br/>[DisInfoMap.kt]"]
  node_ets["Elapsed time service"]
  node_rcs["RCS service"]
  node_userservice["User data service"]
end

subgraph group_ui["Screens and reporting"]
  node_peripheralinfo["Peripheral details screen"]
  node_deviceinfo["GHS device information"]
  node_racpui["Record query screen<br/>[RacpActivity.kt]"]
  node_racplog["RACP log<br/>[RacpLog.kt]"]
  node_obslog["Observation log<br/>[ObservationLog.kt]"]
  node_waveform["Waveform display<br/>[WaveformView.kt]"]
  node_fhir["FHIR uploader<br/>[FhirUploader.kt]"]
end

subgraph group_model["Observation model"]
  node_observation["Observation objects<br/>[Observation.kt]"]
  node_obstype["Observation types<br/>[ObservationType.kt]"]
end

node_user(("App user"))
node_peripheral(("BLE peripheral"))
node_fhirserver(("FHIR server"))

node_user -->|"uses"| node_main
node_main -->|"starts scanning"| node_manager
node_manager -->|"scans and connects"| node_peripheral
node_peripheral -->|"sends GATT events"| node_manager
node_manager -->|"routes events"| node_basehandler
node_manager -->|"dispatches events"| node_ghshandler
node_manager -->|"registers handler"| node_bas
node_manager -->|"routes services"| node_otherhandlers
node_ghshandler -->|"delegates protocol work"| node_ghshelpers
node_ghshandler -->|"creates observations"| node_observation
node_ghshandler -->|"uses observation types"| node_obstype
node_ghshandler -->|"reports capabilities"| node_specialization
node_ghshandler -->|"delegates record control"| node_racp
node_racp -->|"writes record commands"| node_peripheral
node_main -->|"opens details"| node_peripheralinfo
node_peripheralinfo -->|"reads device state"| node_deviceinfo
node_racpui -->|"requests stored records"| node_racp
node_racp -->|"logs record actions"| node_racplog
node_main -->|"logs observations"| node_obslog
node_main -->|"uploads observations"| node_fhir
node_fhir -->|"posts FHIR data"| node_fhirserver
node_observation -.->|"renders sample arrays"| node_waveform
node_manager -->|"routes service events"| node_ets
node_manager -->|"routes service events"| node_dis
node_manager -->|"routes service events"| node_rcs
node_manager -->|"routes service events"| node_userservice

click node_main "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/MainActivity.kt"
click node_manager "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt"
click node_basehandler "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ServiceHandler.kt"
click node_ghshandler "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt"
click node_ghshelpers "https://github.com/philips-labs/ble-ghs-client-example/tree/main/app/src/main/java/com/philips/bleclient/service/ghs"
click node_specialization "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ghs/DeviceSpecialization.kt"
click node_racp "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ghs/GhsRacpHandler.kt"
click node_observation "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/observations/Observation.kt"
click node_obstype "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/observations/ObservationType.kt"
click node_otherhandlers "https://github.com/philips-labs/ble-ghs-client-example/tree/main/app/src/main/java/com/philips/bleclient/service"
click node_bas "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/bas/BasServiceHandler.kt"
click node_dis "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/dis/DisInfoMap.kt"
click node_ets "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ets/ElapsedTimeServiceHandler.kt"
click node_rcs "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/rcs/RCSServiceHandler.kt"
click node_userservice "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/user/UserDataServiceHandler.kt"
click node_peripheralinfo "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/PeripheralInfoActivity.kt"
click node_deviceinfo "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/GHSDeviceInfoMap.kt"
click node_racpui "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/RacpActivity.kt"
click node_racplog "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/RacpLog.kt"
click node_obslog "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/ObservationLog.kt"
click node_waveform "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/WaveformView.kt"
click node_fhir "https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/fhir/FhirUploader.kt"

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_main,node_manager,node_basehandler,node_user toneBlue
class node_ghshandler,node_ghshelpers,node_specialization,node_racp toneAmber
class node_otherhandlers,node_bas,node_dis,node_ets,node_rcs,node_userservice,node_fhirserver toneMint
class node_peripheralinfo,node_deviceinfo,node_racpui,node_racplog,node_obslog,node_waveform,node_fhir toneRose
class node_observation,node_obstype,node_peripheral toneIndigo
```

## Components

### App and BLE lifecycle

- [Main screen](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/MainActivity.kt): `app/src/main/java/com/philips/bleclient/ui/MainActivity.kt`
- [BLE service manager](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt): `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`
- [Service handler base](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ServiceHandler.kt): `app/src/main/java/com/philips/bleclient/service/ServiceHandler.kt`

### Health observation handling

- [GHS service handler](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt): `app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt`
- [GHS protocol handlers](https://github.com/philips-labs/ble-ghs-client-example/tree/main/app/src/main/java/com/philips/bleclient/service/ghs): `app/src/main/java/com/philips/bleclient/service/ghs`
- [Device specialization](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ghs/DeviceSpecialization.kt): `app/src/main/java/com/philips/bleclient/service/ghs/DeviceSpecialization.kt`
- [Stored record control](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ghs/GhsRacpHandler.kt): `app/src/main/java/com/philips/bleclient/service/ghs/GhsRacpHandler.kt`

### Peripheral services

- [Auxiliary BLE handlers](https://github.com/philips-labs/ble-ghs-client-example/tree/main/app/src/main/java/com/philips/bleclient/service): `app/src/main/java/com/philips/bleclient/service`
- [Battery service](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/bas/BasServiceHandler.kt): `app/src/main/java/com/philips/bleclient/service/bas/BasServiceHandler.kt`
- [Device information](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/dis/DisInfoMap.kt): `app/src/main/java/com/philips/bleclient/service/dis/DisInfoMap.kt`
- [Elapsed time service](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/ets/ElapsedTimeServiceHandler.kt): `app/src/main/java/com/philips/bleclient/service/ets/ElapsedTimeServiceHandler.kt`
- [RCS service](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/rcs/RCSServiceHandler.kt): `app/src/main/java/com/philips/bleclient/service/rcs/RCSServiceHandler.kt`
- [User data service](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/service/user/UserDataServiceHandler.kt): `app/src/main/java/com/philips/bleclient/service/user/UserDataServiceHandler.kt`

### Screens and reporting

- [Peripheral details screen](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/PeripheralInfoActivity.kt): `app/src/main/java/com/philips/bleclient/ui/PeripheralInfoActivity.kt`
- [GHS device information](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/GHSDeviceInfoMap.kt): `app/src/main/java/com/philips/bleclient/ui/GHSDeviceInfoMap.kt`
- [Record query screen](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/RacpActivity.kt): `app/src/main/java/com/philips/bleclient/ui/RacpActivity.kt`
- [RACP log](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/RacpLog.kt): `app/src/main/java/com/philips/bleclient/ui/RacpLog.kt`
- [Observation log](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/ObservationLog.kt): `app/src/main/java/com/philips/bleclient/ui/ObservationLog.kt`
- [Waveform display](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/ui/WaveformView.kt): `app/src/main/java/com/philips/bleclient/ui/WaveformView.kt`
- [FHIR uploader](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/fhir/FhirUploader.kt): `app/src/main/java/com/philips/bleclient/fhir/FhirUploader.kt`

### Observation model

- [Observation objects](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/observations/Observation.kt): `app/src/main/java/com/philips/bleclient/observations/Observation.kt`
- [Observation types](https://github.com/philips-labs/ble-ghs-client-example/blob/main/app/src/main/java/com/philips/bleclient/observations/ObservationType.kt): `app/src/main/java/com/philips/bleclient/observations/ObservationType.kt`

### Other components

- **App user**
- **BLE peripheral**
- **FHIR server**

## Connections

- App user → Main screen: uses
- Main screen → BLE service manager: starts scanning (evidence: `app/src/main/java/com/philips/bleclient/ui/MainActivity.kt`)
- BLE service manager → BLE peripheral: scans and connects (evidence: `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`)
- BLE peripheral → BLE service manager: sends GATT events (evidence: `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`)
- BLE service manager → Service handler base: routes events (evidence: `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`)
- BLE service manager → GHS service handler: dispatches events (evidence: `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`)
- BLE service manager → Battery service: registers handler (evidence: `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`)
- BLE service manager → Auxiliary BLE handlers: routes services (evidence: `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`)
- GHS service handler → GHS protocol handlers: delegates protocol work (evidence: `app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt`)
- GHS service handler → Observation objects: creates observations (evidence: `app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt`)
- GHS service handler → Observation types: uses observation types (evidence: `app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt`)
- GHS service handler → Device specialization: reports capabilities (evidence: `app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt`)
- GHS service handler → Stored record control: delegates record control (evidence: `app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt`)
- Stored record control → BLE peripheral: writes record commands (evidence: `app/src/main/java/com/philips/bleclient/service/ghs/GhsRacpHandler.kt`)
- Main screen → Peripheral details screen: opens details (evidence: `app/src/main/java/com/philips/bleclient/ui/MainActivity.kt`)
- Peripheral details screen → GHS device information: reads device state (evidence: `app/src/main/java/com/philips/bleclient/ui/PeripheralInfoActivity.kt`)
- Record query screen → Stored record control: requests stored records (evidence: `app/src/main/java/com/philips/bleclient/ui/RacpActivity.kt`)
- Stored record control → RACP log: logs record actions (evidence: `app/src/main/java/com/philips/bleclient/service/ghs/GhsRacpHandler.kt`)
- Main screen → Observation log: logs observations (evidence: `app/src/main/java/com/philips/bleclient/ui/MainActivity.kt`)
- Main screen → FHIR uploader: uploads observations (evidence: `app/src/main/java/com/philips/bleclient/ui/MainActivity.kt`)
- FHIR uploader → FHIR server: posts FHIR data
- Observation objects → Waveform display: renders sample arrays
- BLE service manager → Elapsed time service: routes service events (evidence: `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`)
- BLE service manager → Device information: routes service events (evidence: `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`)
- BLE service manager → RCS service: routes service events (evidence: `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`)
- BLE service manager → User data service: routes service events (evidence: `app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt`)
