# Troubleshoot sensors

The following resources describe a few common issues and the techniques available to analyze and troubleshoot these issues.

Note

The `<registry_path>` should be considered as one of the existing paths on the device: `/etc/sensors/registry/registry/` or `/var/cache/sensors/registry/registry/`.

## The `ssc_sensor_info` tool is unable to list sensors

This error indicates a failure in parsing the sensor registry, rendering the sensor
unavailable for listing using the `ssc_sensor_info` tool. Do the following to resolve this error:

> 
> 
> Note
> 
> 
> Verify that the read and write permissions for the files are enabled for User mode, and read only permission is enabled for Group and Others modes. Ensure that the User and Group mode names are `system system`.
> 
> 
> 1. Ensure that `/etc/sensors/sns_reg_config` and `/etc/sensors/config/json.lst` files are present with the required permissions
> as shown in the following example:
> 
> 
> 
> 
> > 
> > 
> > root@qcm6490:~# ls -l /etc/sensors/sns_reg_config
> >     -rw-r--r--. 1 system system 226 Mar  9  2018 /etc/sensors/sns_reg_config
> >     Copy to clipboard
> > 
> > 
> > root@qcm6490:~# ls -l /etc/sensors/config/json.lst
> >     -rw-r--r--. 1 system system 1452 Mar 9  2018 /etc/sensors/config/json.lst
> >     Copy to clipboard
> 
> 
> 2. Ensure that `/etc/sensors/config/` directory has the sensor JSON file with the required permissions, as described in the above note.
> 
> 
> 
> 
> > 
> > 
> > [root@qcm6490](mailto:root&#37;&#52;&#48;qcm6490):/etc/sensors/config# ls -l
> > total 548
> > -rw-r–r–. 1 system system 1452 Mar 9  2018 json.lst
> > -rw-r–r–. 1 system system 5638 Mar 9  2018 kodiak\_ak991x\_0.json
> > -rw-r–r–. 1 system system 2837 Mar 9  2018 kodiak\_bu52053nvx\_0.json
> > -rw-r–r–. 1 system system 5480 Mar 9  2018 kodiak\_default\_sensors.json
> > -rw-r–r–. 1 system system  293 Mar 9  2018 kodiak\_dynamic\_sensors.json
> > -rw-r–r–. 1 system system  392 Mar 9  2018 kodiak\_idp\_ak991x\_0.json
> > -rw-r–r–. 1 system system  384 Mar 9  2018 kodiak\_idp\_lsm6dst\_0.json
> > -rw-r–r–. 1 system system  384 Mar 9  2018 kodiak\_idp\_lsm6dst\_1.json
> > ..
> > -rw-r–r–. 1 system system  302 Mar 9  2018 qcm6490\_power\_0.json
> > -rw-r–r–. 1 system system 7952 Mar 9  2018 qcm6490\_rbx\_icm4x6xx\_0.json
> > -rw-r–r–. 1 system system 5922 Mar 9  2018 qcm6490\_rbx\_navmez\_ak991x\_0.json
> > -rw-r–r–. 1 system system 7957 Mar 9  2018 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json
> > -rw-r–r–. 1 system system 7957 Mar 9  2018 qcm6490\_rbx\_navmez\_rev2\_icm4x6xx\_0.json
> > -rw-r–r–. 1 system system 3688 Mar 9  2018 qcm6490\_rbx\_navmezz\_icp101xx\_0.json
> 
> 
> 3. Ensure that `<registry_path>` directory is accessible and has the corresponding parsed file, as shown below.
> 
> 
> 
> 
> > 
> > 
> > [root@qcm6490](mailto:root&#37;&#52;&#48;qcm6490):/var/cache/sensors/registry/registry# ls -l
> > total 524
> > -rw-r–r–. 1 system system    3 Jan  1 00:00 DIR
> > -rw-r–r–. 1 system system  902 Apr 28  2022 qcm6490\_default\_sensors.json.default\_sensors
> > -rw-r–r–. 1 system system   86 Apr 28  2022 qcm6490\_default\_sensors.json.default\_sensors.accel
> > -rw-r–r–. 1 system system  133 Apr 28  2022 qcm6490\_default\_sensors.json.default\_sensors.accel.attr\_0
> > -rw-r–r–. 1 system system   90 Apr 28  2022 qcm6490\_default\_sensors.json.default\_sensors.accel\_cal
> > ..
> > -rw-r–r–. 1 system system   84 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.temp
> > -rw-r–r–. 1 system system  232 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.temp.config
> > -rw-r–r–. 1 system system  346 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform
> > -rw-r–r–. 1 system system   95 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel
> > -rw-r–r–. 1 system system  146 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel.fac\_cal
> > -rw-r–r–. 1 system system  183 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel.fac\_cal.bias
> > -rw-r–r–. 1 system system  445 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel.fac\_cal.corr\_mat
> > -rw-r–r–. 1 system system  863 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.config

## SUID lookup failures

This error indicates a custom code failure in retrieving SUID for a specified sensor. Do the following to resolve this error:

> 
> 
> 1. Run the `ssc_sensor_info` tool to check if the specified sensor is available.
> 
> 
> 
> 
> > 
> > 
> > - If the sensor list is empty, see the first debugging method described in [The ssc\_sensor\_info tool is unable to list sensors](https://docs.qualcomm.com/doc/80-70022-7/topic/debug.html#troubleshooting-ssc-sensor-info).
> > - If only the specified sensor is unavailable, proceed with the following checks:
> > 
> > 
> > 
> > 
> > > 
> > > 
> > > 1. Ensure that the sensor is listed in `/etc/sensors/config/json.lst` file, as shown in the following example:
> > > 
> > > 
> > > [root@qcm6490](mailto:root&#37;&#52;&#48;qcm6490):~# cat /etc/sensors/config/json.lst
> > > kodiak\_ak991x\_0.json
> > > qcm6490\_default\_sensors.json
> > > qcm6490\_power\_0.json
> > > qcm6490\_rbx\_icm4x6xx\_0.json
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json
> > > qcm6490\_rbx\_navmezz\_icp101xx\_0.json
> > > qcm6490\_rbx\_navmez\_ak991x\_0.json
> > > 2. Verify that the configuration file for the specified sensor is parsed and present in the `parsed_file_list.csv` file, as shown in the following example:
> > > 
> > > 
> > > [root@qcm6490](mailto:root&#37;&#52;&#48;qcm6490):/var/cache/sensors/registry# cat parsed\_file\_list.csv
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.config
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.orient
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.gyro.fac\_cal.corr\_mat
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.gyro.fac\_cal.bias
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.gyro.fac\_cal
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.gyro
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel.fac\_cal.corr\_mat
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel.fac\_cal.bias
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel.fac\_cal
> > > qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel
> > > 3. Verify that the configuration file for the specified sensor is parsed and present in the `<registry_path>` directory as shown in the following example:
> > > 
> > > 
> > > [root@qcm6490](mailto:root&#37;&#52;&#48;qcm6490):/var/cache/sensors/registry/registry# ls -l
> > > total 524
> > > -rw-r–r–. 1 system system  248 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0
> > > -rw-r–r–. 1 system system   85 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.accel
> > > -rw-r–r–. 1 system system  233 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.accel.config
> > > -rw-r–r–. 1 system system   88 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.freefall
> > > -rw-r–r–. 1 system system  236 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.freefall.config
> > > -rw-r–r–. 1 system system   84 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.gyro
> > > -rw-r–r–. 1 system system  232 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.gyro.config
> > > -rw-r–r–. 1 system system   82 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.md
> > > -rw-r–r–. 1 system system  230 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.md.config
> > > -rw-r–r–. 1 system system   84 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.temp
> > > -rw-r–r–. 1 system system  232 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0.temp.config
> > > -rw-r–r–. 1 system system  346 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform
> > > -rw-r–r–. 1 system system   95 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel
> > > -rw-r–r–. 1 system system  146 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel.fac\_cal
> > > -rw-r–r–. 1 system system  183 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel.fac\_cal.bias
> > > -rw-r–r–. 1 system system  445 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.accel.fac\_cal.corr\_mat
> > > -rw-r–r–. 1 system system  863 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.config
> > > -rw-r–r–. 1 system system   94 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.gyro
> > > -rw-r–r–. 1 system system  145 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.gyro.fac\_cal
> > > -rw-r–r–. 1 system system  182 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.gyro.fac\_cal.bias
> > > -rw-r–r–. 1 system system  444 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.gyro.fac\_cal.corr\_mat
> > > -rw-r–r–. 1 system system   91 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.md
> > > -rw-r–r–. 1 system system  192 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.md.config
> > > -rw-r–r–. 1 system system  174 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.orient
> > > -rw-r–r–. 1 system system  536 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.placement
> > > -rw-r–r–. 1 system system   94 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.temp
> > > -rw-r–r–. 1 system system  142 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.temp.fac\_cal
> > > -rw-r–r–. 1 system system  102 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.temp.fac\_cal.bias
> > > -rw-r–r–. 1 system system  103 Apr 28  2022 qcm6490\_rbx\_navmez\_icm4x6xx\_0.json.icm4x6xx\_0\_platform.temp.fac\_cal.scale
> 
> 
> 2. If the preceding validations don’t identify any issues, then there could be an issue with your own app’s custom code implementation that uses the QSH client APIs. Please revisit your code implementation.

## Sensor is listed but unable to receive sensor data

This error indicates failure of the sample or custom code, use the following sensor tool to receive events for a specified sensor.

> 
> 
> Run the following command to stream the specified sensor:
> 
> 
> 
> > 
> > 
> > `see_workhorse [-sensor=][-sample_rate=] [-batch_period=] [-calibrated=<0 | 1>] [-wakeup=<0 | 1>]`
> 
> 
> 
> For example,
> 
> 
> see_workhorse -sensor=accel -sample_rate=max -duration=30 -display_events=1
>     Copy to clipboard

If the tool is able to receive the sensor event then there could be an issue with your app’s custom code implementation that uses the QSH client APIs. Please revisit your code implementation.

For more information, see [Tools](https://docs.qualcomm.com/doc/80-70022-7/topic/test_troubleshoot.html#test-tools).

Last Published: Oct 08, 2025

[Previous Topic
Test and troubleshoot](https://docs.qualcomm.com/bundle/publicresource/80-70022-7/topics/test_troubleshoot.md) [Next Topic
References](https://docs.qualcomm.com/bundle/publicresource/80-70022-7/topics/references.md)