How philips-labs/ble-ghs-client-example works
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: ServiceHandlerManager.kt BLE service manager · GenericHealthSensorServiceHandler.kt GHS service handler · MainActivity.kt Main screen · GhsRacpHandler.kt Stored record control
Components 25
App and BLE lifecycle
- Main screen
app/src/main/java/com/philips/bleclient/ui/MainActivity.kt - BLE service manager
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt - Service handler base
app/src/main/java/com/philips/bleclient/service/ServiceHandler.kt
Health observation handling
- GHS service handler
app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt - GHS protocol handlers
app/src/main/java/com/philips/bleclient/service/ghs - Device specialization
app/src/main/java/com/philips/bleclient/service/ghs/DeviceSpecialization.kt - Stored record control
app/src/main/java/com/philips/bleclient/service/ghs/GhsRacpHandler.kt
Peripheral services
- Auxiliary BLE handlers
app/src/main/java/com/philips/bleclient/service - Battery service
app/src/main/java/com/philips/bleclient/service/bas/BasServiceHandler.kt - Device information
app/src/main/java/com/philips/bleclient/service/dis/DisInfoMap.kt - Elapsed time service
app/src/main/java/com/philips/bleclient/service/ets/ElapsedTimeServiceHandler.kt - RCS service
app/src/main/java/com/philips/bleclient/service/rcs/RCSServiceHandler.kt - User data service
app/src/main/java/com/philips/bleclient/service/user/UserDataServiceHandler.kt
Screens and reporting
- Peripheral details screen
app/src/main/java/com/philips/bleclient/ui/PeripheralInfoActivity.kt - GHS device information
app/src/main/java/com/philips/bleclient/ui/GHSDeviceInfoMap.kt - Record query screen
app/src/main/java/com/philips/bleclient/ui/RacpActivity.kt - RACP log
app/src/main/java/com/philips/bleclient/ui/RacpLog.kt - Observation log
app/src/main/java/com/philips/bleclient/ui/ObservationLog.kt - Waveform display
app/src/main/java/com/philips/bleclient/ui/WaveformView.kt - FHIR uploader
app/src/main/java/com/philips/bleclient/fhir/FhirUploader.kt
Observation model
- Observation objects
app/src/main/java/com/philips/bleclient/observations/Observation.kt - Observation types
app/src/main/java/com/philips/bleclient/observations/ObservationType.kt
Other components
- App user
- BLE peripheral
- FHIR server
Connections 26
- App user → Main screen: uses
- Main screen → BLE service manager: starts scanning
app/src/main/java/com/philips/bleclient/ui/MainActivity.kt - BLE service manager → BLE peripheral: scans and connects
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt - BLE peripheral → BLE service manager: sends GATT events
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt - BLE service manager → Service handler base: routes events
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt - BLE service manager → GHS service handler: dispatches events
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt - BLE service manager → Battery service: registers handler
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt - BLE service manager → Auxiliary BLE handlers: routes services
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt - GHS service handler → GHS protocol handlers: delegates protocol work
app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt - GHS service handler → Observation objects: creates observations
app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt - GHS service handler → Observation types: uses observation types
app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt - GHS service handler → Device specialization: reports capabilities
app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt - GHS service handler → Stored record control: delegates record control
app/src/main/java/com/philips/bleclient/service/ghs/GenericHealthSensorServiceHandler.kt - Stored record control → BLE peripheral: writes record commands
app/src/main/java/com/philips/bleclient/service/ghs/GhsRacpHandler.kt - Main screen → Peripheral details screen: opens details
app/src/main/java/com/philips/bleclient/ui/MainActivity.kt - Peripheral details screen → GHS device information: reads device state
app/src/main/java/com/philips/bleclient/ui/PeripheralInfoActivity.kt - Record query screen → Stored record control: requests stored records
app/src/main/java/com/philips/bleclient/ui/RacpActivity.kt - Stored record control → RACP log: logs record actions
app/src/main/java/com/philips/bleclient/service/ghs/GhsRacpHandler.kt - Main screen → Observation log: logs observations
app/src/main/java/com/philips/bleclient/ui/MainActivity.kt - Main screen → FHIR uploader: uploads observations
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
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt - BLE service manager → Device information: routes service events
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt - BLE service manager → RCS service: routes service events
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt - BLE service manager → User data service: routes service events
app/src/main/java/com/philips/bleclient/service/ServiceHandlerManager.kt