How qualcomm/sensinghub works
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: qmiSession.cpp QMI session · glinkSession.cpp GLINK session · sessionImpl.cpp Session selection · LoggerFactory.cpp Session logging
Components 17
Client API
- Session factory
session/1.0/src/SessionFactory.cpp - Session interface
session/1.0/inc/ISession.h
Session Transports
- Session selection
core/sessionImpl/src/sessionImpl.cpp - QMI session
core/sessionImpl/src/qmiSession.cpp - GLINK session
core/sessionImpl/src/glinkSession.cpp
Sensor Protocols
- QMI service messages
core/qshQmiIDL/sns_client_api_v01.h - Sensor protobuf APIs
apis/proto
Runtime Support
- Hub configuration
utils/src/qshJsonParser.cpp - Sensor ID lookup
utils/src/suidLookUp.cpp - Protobuf utilities
utils/src/qshPb.cpp - Session logging
sessionlogger/src/LoggerFactory.cpp - Diagnostics logger
sessionlogger/src/SensorsDiagLogger.cpp - Task worker
utils/inc/qshWorker.h - Wake lock
utils/src/qshWakelock.cpp - Sensors daemon
services/sensorsdaemon/src/sensorsdaemon.cpp
Other components
- Application client
- Sensing Hub
Connections 18
- Application client → Session factory: creates session
- Application client → Session interface: opens and requests
session/1.0/inc/ISession.h - Session selection → QMI session: selects implementation
core/sessionImpl/src/sessionImpl.cpp - Session selection → GLINK session: selects implementation
core/sessionImpl/src/sessionImpl.cpp - QMI session → Sensing Hub: communicates via QMI
core/sessionImpl/src/qmiSession.cpp - GLINK session → Sensing Hub: communicates via GLINK
core/sessionImpl/src/glinkSession.cpp - QMI session → QMI service messages: uses messages
core/sessionImpl/src/qmiSession.cpp - QMI session → Sensor ID lookup: looks up sensor IDs
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
core/sessionImpl/src/qmiSession.cpp - GLINK session → Session logging: creates session logger
core/sessionImpl/src/glinkSession.cpp - QMI session → Session logging: creates session logger
core/sessionImpl/src/qmiSession.cpp - Session logging → Diagnostics logger: provides diagnostics
sessionlogger/src/SensorsDiagLogger.cpp - GLINK session → Wake lock: uses wake lock
- Session selection → Hub configuration: reads hub settings
core/sessionImpl/src/sessionImpl.cpp - Sensor ID lookup → Protobuf utilities: uses protobuf utilities
- Session interface → Sensor protobuf APIs: exchanges encoded data
session/1.0/inc/ISession.h