# qualcomm/sensinghub architecture

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

- Interactive diagram: https://gitdiagram.com/qualcomm/sensinghub
- Repository: https://github.com/qualcomm/sensinghub

## Overview

QSH provides clients with a transport-neutral session API for opening a hub connection, registering per-sensor callbacks, and sending protobuf-encoded requests that receive asynchronous responses and events. Runtime implementations support QMI and GLINK; the repository also contains hub configuration, sensor-ID lookup, protocol definitions, and session logging. The README describes the product broadly but does not document a complete end-to-end pipeline, so edges are limited to relationships visible in excerpts or the SOURCE INDEX.

Main entry points: [`core/sessionImpl/src/qmiSession.cpp`](https://github.com/qualcomm/sensinghub/blob/main/core/sessionImpl/src/qmiSession.cpp) (QMI session), [`core/sessionImpl/src/glinkSession.cpp`](https://github.com/qualcomm/sensinghub/blob/main/core/sessionImpl/src/glinkSession.cpp) (GLINK session), [`core/sessionImpl/src/sessionImpl.cpp`](https://github.com/qualcomm/sensinghub/blob/main/core/sessionImpl/src/sessionImpl.cpp) (Session selection), [`sessionlogger/src/LoggerFactory.cpp`](https://github.com/qualcomm/sensinghub/blob/main/sessionlogger/src/LoggerFactory.cpp) (Session logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Client API"]
  node_factory["Session factory<br/>[SessionFactory.cpp]"]
  node_session["Session interface<br/>[ISession.h]"]
end

subgraph group_transport["Session Transports"]
  node_impl["Session selection<br/>[sessionImpl.cpp]"]
  node_qmi["QMI session<br/>[qmiSession.cpp]"]
  node_glink["GLINK session<br/>[glinkSession.cpp]"]
end

subgraph group_protocol["Sensor Protocols"]
  node_qmiidl["QMI service messages"]
  node_proto["Sensor protobuf APIs"]
end

subgraph group_support["Runtime Support"]
  node_config["Hub configuration<br/>[qshJsonParser.cpp]"]
  node_lookup["Sensor ID lookup<br/>[suidLookUp.cpp]"]
  node_pb["Protobuf utilities<br/>[qshPb.cpp]"]
  node_logger["Session logging<br/>[LoggerFactory.cpp]"]
  node_diag["Diagnostics logger"]
  node_worker["Task worker<br/>[qshWorker.h]"]
  node_wakelock["Wake lock<br/>[qshWakelock.cpp]"]
  node_daemon["Sensors daemon<br/>[sensorsdaemon.cpp]"]
end

node_client(("Application client"))
node_hub(("Sensing Hub"))

node_client -->|"creates session"| node_factory
node_client -->|"opens and requests"| node_session
node_impl -->|"selects implementation"| node_qmi
node_impl -->|"selects implementation"| node_glink
node_qmi -->|"communicates via QMI"| node_hub
node_glink -->|"communicates via GLINK"| node_hub
node_qmi -->|"uses messages"| node_qmiidl
node_qmi -->|"looks up sensor IDs"| node_lookup
node_qmi -->|"encodes and decodes"| node_pb
node_glink -->|"encodes and decodes"| node_pb
node_qmi -->|"queues recovery work"| node_worker
node_glink -->|"creates session logger"| node_logger
node_qmi -->|"creates session logger"| node_logger
node_logger -->|"provides diagnostics"| node_diag
node_glink -->|"uses wake lock"| node_wakelock
node_impl -->|"reads hub settings"| node_config
node_lookup -->|"uses protobuf utilities"| node_pb
node_session -->|"exchanges encoded data"| node_proto

click node_factory "https://github.com/qualcomm/sensinghub/blob/main/session/1.0/src/SessionFactory.cpp"
click node_session "https://github.com/qualcomm/sensinghub/blob/main/session/1.0/inc/ISession.h"
click node_impl "https://github.com/qualcomm/sensinghub/blob/main/core/sessionImpl/src/sessionImpl.cpp"
click node_qmi "https://github.com/qualcomm/sensinghub/blob/main/core/sessionImpl/src/qmiSession.cpp"
click node_glink "https://github.com/qualcomm/sensinghub/blob/main/core/sessionImpl/src/glinkSession.cpp"
click node_qmiidl "https://github.com/qualcomm/sensinghub/blob/main/core/qshQmiIDL/sns_client_api_v01.h"
click node_proto "https://github.com/qualcomm/sensinghub/tree/main/apis/proto"
click node_config "https://github.com/qualcomm/sensinghub/blob/main/utils/src/qshJsonParser.cpp"
click node_lookup "https://github.com/qualcomm/sensinghub/blob/main/utils/src/suidLookUp.cpp"
click node_pb "https://github.com/qualcomm/sensinghub/blob/main/utils/src/qshPb.cpp"
click node_logger "https://github.com/qualcomm/sensinghub/blob/main/sessionlogger/src/LoggerFactory.cpp"
click node_diag "https://github.com/qualcomm/sensinghub/blob/main/sessionlogger/src/SensorsDiagLogger.cpp"
click node_worker "https://github.com/qualcomm/sensinghub/blob/main/utils/inc/qshWorker.h"
click node_wakelock "https://github.com/qualcomm/sensinghub/blob/main/utils/src/qshWakelock.cpp"
click node_daemon "https://github.com/qualcomm/sensinghub/blob/main/services/sensorsdaemon/src/sensorsdaemon.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_factory,node_session,node_client toneBlue
class node_impl,node_qmi,node_glink toneAmber
class node_qmiidl,node_proto toneMint
class node_config,node_lookup,node_pb,node_logger,node_diag,node_worker,node_wakelock,node_daemon toneRose
class node_hub toneIndigo
```

## Components

### Client API

- [Session factory](https://github.com/qualcomm/sensinghub/blob/main/session/1.0/src/SessionFactory.cpp): `session/1.0/src/SessionFactory.cpp`
- [Session interface](https://github.com/qualcomm/sensinghub/blob/main/session/1.0/inc/ISession.h): `session/1.0/inc/ISession.h`

### Session Transports

- [Session selection](https://github.com/qualcomm/sensinghub/blob/main/core/sessionImpl/src/sessionImpl.cpp): `core/sessionImpl/src/sessionImpl.cpp`
- [QMI session](https://github.com/qualcomm/sensinghub/blob/main/core/sessionImpl/src/qmiSession.cpp): `core/sessionImpl/src/qmiSession.cpp`
- [GLINK session](https://github.com/qualcomm/sensinghub/blob/main/core/sessionImpl/src/glinkSession.cpp): `core/sessionImpl/src/glinkSession.cpp`

### Sensor Protocols

- [QMI service messages](https://github.com/qualcomm/sensinghub/blob/main/core/qshQmiIDL/sns_client_api_v01.h): `core/qshQmiIDL/sns_client_api_v01.h`
- [Sensor protobuf APIs](https://github.com/qualcomm/sensinghub/tree/main/apis/proto): `apis/proto`

### Runtime Support

- [Hub configuration](https://github.com/qualcomm/sensinghub/blob/main/utils/src/qshJsonParser.cpp): `utils/src/qshJsonParser.cpp`
- [Sensor ID lookup](https://github.com/qualcomm/sensinghub/blob/main/utils/src/suidLookUp.cpp): `utils/src/suidLookUp.cpp`
- [Protobuf utilities](https://github.com/qualcomm/sensinghub/blob/main/utils/src/qshPb.cpp): `utils/src/qshPb.cpp`
- [Session logging](https://github.com/qualcomm/sensinghub/blob/main/sessionlogger/src/LoggerFactory.cpp): `sessionlogger/src/LoggerFactory.cpp`
- [Diagnostics logger](https://github.com/qualcomm/sensinghub/blob/main/sessionlogger/src/SensorsDiagLogger.cpp): `sessionlogger/src/SensorsDiagLogger.cpp`
- [Task worker](https://github.com/qualcomm/sensinghub/blob/main/utils/inc/qshWorker.h): `utils/inc/qshWorker.h`
- [Wake lock](https://github.com/qualcomm/sensinghub/blob/main/utils/src/qshWakelock.cpp): `utils/src/qshWakelock.cpp`
- [Sensors daemon](https://github.com/qualcomm/sensinghub/blob/main/services/sensorsdaemon/src/sensorsdaemon.cpp): `services/sensorsdaemon/src/sensorsdaemon.cpp`

### Other components

- **Application client**
- **Sensing Hub**

## Connections

- Application client → Session factory: creates session
- Application client → Session interface: opens and requests (evidence: `session/1.0/inc/ISession.h`)
- Session selection → QMI session: selects implementation (evidence: `core/sessionImpl/src/sessionImpl.cpp`)
- Session selection → GLINK session: selects implementation (evidence: `core/sessionImpl/src/sessionImpl.cpp`)
- QMI session → Sensing Hub: communicates via QMI (evidence: `core/sessionImpl/src/qmiSession.cpp`)
- GLINK session → Sensing Hub: communicates via GLINK (evidence: `core/sessionImpl/src/glinkSession.cpp`)
- QMI session → QMI service messages: uses messages (evidence: `core/sessionImpl/src/qmiSession.cpp`)
- QMI session → Sensor ID lookup: looks up sensor IDs (evidence: `core/sessionImpl/src/qmiSession.cpp`)
- QMI session → Protobuf utilities: encodes and decodes
- GLINK session → Protobuf utilities: encodes and decodes
- QMI session → Task worker: queues recovery work (evidence: `core/sessionImpl/src/qmiSession.cpp`)
- GLINK session → Session logging: creates session logger (evidence: `core/sessionImpl/src/glinkSession.cpp`)
- QMI session → Session logging: creates session logger (evidence: `core/sessionImpl/src/qmiSession.cpp`)
- Session logging → Diagnostics logger: provides diagnostics (evidence: `sessionlogger/src/SensorsDiagLogger.cpp`)
- GLINK session → Wake lock: uses wake lock
- Session selection → Hub configuration: reads hub settings (evidence: `core/sessionImpl/src/sessionImpl.cpp`)
- Sensor ID lookup → Protobuf utilities: uses protobuf utilities
- Session interface → Sensor protobuf APIs: exchanges encoded data (evidence: `session/1.0/inc/ISession.h`)
