Get started
Overview
Introduces the Qualcomm® SoC architecture, the role of the application processor and application digital signal processor (aDSP), and where Qualcomm® sensing hub (QSH) fits in the Linux sensor stack.
Architecture
Describes the unified event-driven QSH framework, its components, services, platform sensors, utilities, OS abstraction (OSA), and platform abstraction layer (PAL).
Messages
The shared communication contract for both client applications and sensor drivers. Covers sensor unique identifier (SUID), nanopb, message types, request options, event fields, and proto file schemas.
Features
QSH capabilities including OS and hardware independence, island memory, low-power operation, and direct channel APIs.
Develop
Software for application and low-power processors
Directory layout for the application processor and aDSP source trees.
QSH client API workflow
For application developers to understand the QSH client API session workflow and the
SessionClient sample application.Develop sensors
For driver and algorithm authors to understand the sensor and sensor instance lifecycle, QSH services, and stress testing.
API
Qualcomm® sensing hub APIs
Full syntax reference for
getSession, open, close, setCallback, sendRequest, feature APIs, and direct channel APIs.Test and validate
Calibrate sensors
Factory and runtime calibration procedures for accelerometer, gyroscope, magnetometer, proximity, and ambient light sensors.
Verify sensors
Use
ssc_sensor_info to list all QSH-supported sensors and inspect their attributes.Troubleshoot sensors
Diagnose and resolve registry errors, SUID lookup failures, and data stream issues.
Sensor testing tools
Describes testing tools –
ssc_sensor_info, ssc_drva_test, see_workhorse, Qualcomm® Hexagon™ toolchain, and QXDM Professional™ Tool.Supported platforms
Qualcomm Dragonwing™ platform
Hardware specification and sensor bring-up for the Qualcomm Dragonwing™ RB3 Gen 2 Development Kit. Includes end-to-end bring-up procedures.
Sensors on the platform
Sensor placement and part number table for the Core Kit and Vision Kit.
Simulation platform
Use the sensing hub simulator (SHS) to develop and test sensor algorithms without physical hardware.
Related documents
External guides including the Sensors Guide Addendum, Linux Build Guide, Yocto Guide, and Development Kit documentation.
Acronyms and terms
Sensors-specific acronyms and definitions used throughout this guide.