# Sensors overview Note The Qualcomm® Sensing Hub (QSH) is available only on [QCS5430](https://www.qualcomm.com/products/internet-of-things/industrial/industrial-automation/qcs5430) and [QCS6490](https://www.qualcomm.com/products/internet-of-things/industrial/building-enterprise/qcs6490). The Qualcomm® system-on-chip (SoC) includes an application processor that runs the Linux operating system, a low-power application digital signal processor (aDSP), and other processors. The low-power processor runs the real-time operating system (RTOS) to handle the sensor data streaming using QSH framework. The aDSP supports the following for QSH operations: - GPIOs configurable as serial bus: serial peripheral interface (SPI), inter-integrated circuit (I^2^C), improved I^2^C (I^3^C), and universal asynchronous receiver/transmitter (UART). - Serial buses in low-power mode. - Dedicated local memory, also known as the island in QSH. ## Qualcomm sensing hub overview QSH provides a framework to use data from a wide range of sensors. The sensor data is useful in fields, such as IoT, gaming, health, and fitness. A device can have more than one sensor of a given type. For example, a flip-phone has an accelerometer placed on each of the two planes. The published attributes or capabilities distinguish each accelerometer sensor. The QSH client APIs allow you to access the availability, attributes, and capabilities of a sensor on the platform. Use the same QSH client APIs to get the sensor data from the QSH framework. The QSH framework APIs include QSH client APIs and sensor APIs to perform the following sensor-related tasks: - Identify the sensors available on a development kit. - Determine sensor capabilities using attributes, such as supported sample rate, maximum range, manufacturer, power requirement, and resolution. - Collect and provide data according to the configuration, thereby enabling sensors with a specified sample rate. The QSH framework provides access to both hardware-based and software-based sensors. ### Hardware-based sensors Hardware-based sensors are physical sensors that gather data by directly measuring specific environmental properties, such as acceleration, magnetic field, pressure, humidity, light, and angular velocity. The following table lists the hardware-based sensors that the QSH framework supports: > > > Table : Hardware-based sensors > > > | Sensor name | Sensor type | Description | Proto API | > | --- | --- | --- | --- | > | Accelerometer | `accel` | Measures the acceleration applied to a device on all the 3 physical axes (x, y, and z) in meter/second square (m/s^2^) | `sns_accel.proto` | > | Gyroscope | `gyro` | Measures the rate of rotation of a device around each of the 3 physical axes (x, y, and z) in radians/second (rad/s) | `sns_gyro.proto` | > | Sensor temperature | `sensor_temperature` | Measures the temperature of the sensor in degrees Celsius (°C) | `sns_sensor_temperature.proto` | > | Magnetometer | `mag` | Measures the ambient magnetic field for all the 3 physical axes (x, y, and z) in microtesla (μT) | `sns_mag.proto` | > | Proximity | `proximity` | Measures the proximity of an object and provides *near/far* events | `sns_proximity.proto` | > | Ambient light | `ambient_light` | Measures the ambient light level illumination in lux (lx) | `sns_ambient_light.proto` | > | Pressure | `pressure` | Measures the ambient air pressure in hectoPascal (hPa) | `sns_pressure.proto` | > | Humidity | `humidity` | Measures the relative ambient humidity in percentage (%) | `sns_humidity.proto` | > | Ambient temperature | `ambient_temperature` | Provides the ambient room temperature in degrees Celsius (°C) | `sns_ambient_temperature.proto` | > | Hall | `hall` | Measures the magnetic field and provides a magnet *near/far* indication | `sns_hall.proto` | > | Capacitive proximity | `sar` | Detects human object proximity using change in capacitance and reports *near/ far* events | `sns_sar.proto` | ### Software-based sensors Software-based sensors, also known as virtual sensors, are algorithms that gather data from one or more physical sensors and generate the intended output. The common examples are: > > > - Gravity > - Step counter > - Game rotation vector (GRV) The following table lists the software-based sensors that the QSH framework supports: > > > Table : Software-based sensors > > > | Sensor name | Sensor type | Proto API | Description | > | --- | --- | --- | --- | > | Absolute motion detector | `amd` | `sns_amd.proto` | | > | Relative motion detector | `rmd` | `sns_rmd.proto` | Reports a stationary state when the device isn’t moving significantly with respect to gravity. | > | Significant motion detector (SMD) | `sig_motion` | `sns_sig_motion.proto` | | > | Pedometer | `pedometer` | `sns_pedometer.proto` | Reports the number of step counts to the client. | > | Step detector | `step_detect` | `sns_step_detect.proto` | Detects steps and generates an event for each step. | > | Tilt detector | `tilt` | `sns_tilt.proto` | Generates an event each time there is a tilt. The direction of the 2-second window, with average gravity changing by at least 35 degrees since the activation or the last event generated by the sensor, defines a tilt event. | > | Tilt to wake | `tilt_to_wake` | `sns_tilt_to_wake.proto` | Detects the substantial device rotation gesture event when the picked device is in a specific range of the pitch and roll angles. | > | Gyroscope calibration | `gyro_cal` | `sns_gyro_cal.proto` | | > | Magnetometer calibration | `mag_cal` | `sns_mag_cal.proto` | | > | GRV | `game_rv` | `sns_game_rv.proto` | | > | Gravity/linear acceleration | `gravity` | `sns_gravity.proto` | | > | Persistent stationary detector | `persist_stationary_detect` | `sns_persist_stationary_detect.proto` | Reports an event when the device is stationary for at least 5 seconds. | > | Persistent motion detector | `persist_motion_detect` | `sns_persist_motion_detect.proto` | Reports an event when the device is in motion for at least 5 seconds. | > | Device orientation | `device_orient` | `sns_device_orient.proto` | Reports whether the device is in portrait mode or landscape mode. | > | Geomagnetic rotation vector | `geomag_rv` | `sns_geomag_rv.proto` | Reports the orientation of the device relative to the east, north, up (ENU) coordinates frame; obtained through integration of accelerometer and magnetometer readings. | > | Rotation vector (RV) | `rotv` | `sns_rotv.proto` | | > | Device position classifier | `device_position_classi fier` | `sns_dpc.proto` | Provides the device position information specifying if the device is in flat position or is at an angle with respect to the horizontal plain. | > | Activity recognition algorithm | `activity_recognition` | `sns_activity_recognition.proto` | Determines relative stationary states and classifications, for example walk, run, bike, car, nonmotorized vehicle, and motorized vehicle. | > | Distance bound | `distance_bound` | `sns_distance_bound.proto` | | ### QSH features The following table describes the impact on QSH for deployment in scenarios with IoT devices: Table : QSH features | Feature | Enable or disable | Impact | Description | | --- | --- | --- | --- | | OS and hardware-independent | N.A. | | | | Sensors in local memory | Yes. | | | | Sensors in normal mode | Yes. | | | | Factory calibration | No. | | | | Flexibility in configuring the sensors | No. | | | | Software-based or virtual sensors | Yes. | | | | QSH direct channel | Yes. | | | **Next steps** > > > [Qualcomm sensing hub architecture](https://docs.qualcomm.com/doc/80-70030-7/topic/architecture.html#sensors-architecture) Last Published: Jun 15, 2026 [Previous Topic Sensors documentation](https://docs.qualcomm.com/bundle/publicresource/80-70030-7/topics/landing_page.md) [Next Topic Qualcomm sensing hub architecture](https://docs.qualcomm.com/bundle/publicresource/80-70030-7/topics/architecture.md)