Skip to main content
The Qualcomm® sensing hub (QSH) interfaces are available for hardware-based, software-based, pre-existing, or any other QSH-compliant sensors. The QSH framework runs on low-power processors and exposes the APIs at the application processor. These APIs include the following:
  • QSH client APIs and various feature APIs for application development.
  • Sensor APIs to create new sensors on a low-power processor.

​
Application processor APIs

QSH offers feature APIs on the application processor to address specific sensor use cases.

​
QSH client APIs

The QSH client APIs provide an interface that enables client code to access the QSH functionality and develop end-to-end sensor applications. The QSH supports the following APIs:

​
getSession()

This API creates an instance of ISession and returns a pointer to it. Syntax
Parameters — None. Response

​
open()

This API initiates the client session created using getSession() API. The Open() API sets up and establishes communication between the client and the QSH framework. The client must call this function only once per session. Syntax
Parameters — None. Response

​
setCallBacks()

For a specified SUID, this API allows the user to set callbacks for responses, errors, and events received over the session opened using Open() API. This API registers the SUID with the callback functions passed as parameters to this API. To unset the callbacks for already registered SUID, you can pass nullptr for all the three callback functions: respCallBack, errorCallBack, and eventCallBack. Passing nullptr for all callback functions results in an error for an unregistered SUID. Syntax
Parameters Response

​
sendRequest()

This API asynchronously sends a protocol buffer (proto) encoded message to the QSH framework. The proto-encoded message has instructions or configuration settings for the sensor identified by the SUID. For a specified SUID, if you set the callback pointers using setCallBacks() API, then the response, event, or a combination of responses and events are received from the QSH framework. Syntax
Parameters Response

​
close()

This API closes the sensor session and terminates the communication between the client and the QSH framework. The client must call this function at the end of the session to release the resources and avoid memory leaks. Syntax
Parameters — None. Response
For more information and example codes, see Develop applications using the QSH client APIs.

​
QSH direct channel APIs

QSH direct channel APIs provides low latency sensor data channel for high rate applications. Direct channel APIs use the FastRPC interface, which bypasses the standard interprocessor communication (IPC) mechanism to achieve faster communication. For more information, see Qualcomm sensing hub APIs.

​
Low-power processor APIs

The low-power processor APIs provide access to the following:
  • QSH framework resources, such as services and utilities.
  • Core functionalities, such as the diagnostic interface and timer.
You can use the low-power processor APIs to create algorithms and sensor drivers that comply with the QSH standards. For more information, see Qualcomm sensing hub APIs. Next steps