- C 76.2%
- Python 20.1%
- Meson 3.5%
- Shell 0.2%
|
Vasiliy Doylov
4b176d4ed9
This changes add ability to read gyroscope sensor messages. Gyroscope provides x,y,z velocity measurements Tested on Oneplus 6 (oneplus-enchilada) Signed-off-by: Vasiliy Doylov <nekodevelopper@gmail.com> |
||
|---|---|---|
| data | libssc-sensor-gyroscope: new sensor | |
| docs | docs: stream type attribute and QMI header length | |
| mocking | CHANGELOG: release v0.2.2 | |
| src | libssc-sensor-gyroscope: new sensor | |
| tests | tests: Use g_assert_no_error | |
| utils | treewide: bump copyright to 2025 | |
| .gitmodules | mocking: add SSC Server for emulating DSP | |
| CHANGELOG.md | CHANGELOG: release v0.2.2 | |
| LICENSE | LICENSE: fix GPLv3 document | |
| meson.build | CHANGELOG: release v0.2.2 | |
| README.md | mocking: ssc-server: allow running with OS libs | |
| RELEASE.md | meson.build: mocking Protobuf message dir | |
| run-tests.sh | tests: run meson reconfigure | |
libssc
libssc is a library to expose the sensors managed by the Qualcomm Sensor Core
found in many Qualcomm System-on-Chips (SoCs) from 2018 and onwards.
Qualcomm SoCs feature a Sensor Lower Power Island (SLPI) to offload sensors to a dedicated Digital Signal Processor (DSP) for optimizing power consumption and reducing the tasks of the main CPU. This way, the main CPU may enter full suspend while the DSP can detect proximity from the proximity sensor and wake up the main CPU. Direct access to the sensors is prohibited by the hypervisor, thus the only way to access sensors on these SoCs is by talking to the DSP managing these sensors. Libssc performs this task and exposes the sensors as a GLib-based library which allows seamless integration with the existing Linux ecosystem.
Qualcomm, Sensor Low Power Island (SLPI), and Qualcomm Sensor Core are registed trademarks of QUALCOMM Incorporated. Any rights therein are reserved to QUALCOMM Incorporated. Any use by the libssc project is for referential purposes only and does not indicate any sponsorship, endorsement or affiliation between QUALCOMM Incorporated and the libssc project.
Documentation
General information about libssc, documentation, and other information can be found at https://libssc.dylanvanassche.be.
Building
libssc uses the Meson build system with a minimal list of external dependencies:
libqmi >=1.33.4glib >= 2.56protobuf-c
libssc tests requires an additional dependency to compile the ProtoBuf messages for simulating the DSP QMI responses:
protobufpython-gobject3qrtr-libs
cd build
meson ..
ninja
Linking against libssc
Use pkg-config in your favorite build system to link against libssc.
The library is called libssc, in Meson it looks like this:
libssc_dep = dependency('libssc')
Lockdown
Systemd features a lockdown feature to reduce access to resources for services.
If libssc is used in a service such as iio-sensor-proxy, make sure access to the address family AF_QIPCRTR
otherwise access to the QRTR bus is prohibited.
Tests
Libssc has tests with and without the SSC mocking server to verify also the behavior of libssc when the QMI service is not present. It is advisable to run them separate:
Without mocking server
meson test tests-no-service
With mocking server
./mocking/ssc-server
meson test tests-general
License
Available under the GPLv3 license.
Copyright (c) by libssc Authors (2022-2025)