Files
hexagonrpc/README.md
Richard Acayan cd314096a3 README: remove statement that watch command is invalid for stream type 0
Normally, the CHRE performs a full configuration on streaming sensors
with a stream type of zero. This made it seem like a simple enable would
not properly activate sensors with this stream type, but it is possible
to use the watch command on streaming sensors. Remove this statement
which may be misleading.
2023-12-18 19:48:40 -05:00

2.3 KiB

This is a proof-of-concept for interacting with the Snapdragon Sensor Core using the reverse-engineered protocol buffers. It was made to try to initialize it, but the Pixel 3a is missing some sensors once the firmware is loaded.

A best effort is made to prefix all log messages with sensh: so it's clear which lines were entered by the user.

Requirements

Installation

This can be compiled using Meson:

$ meson setup build
$ ninja -C build

There is also a Makefile to compile this, if you can get it to work:

$ mkdir build
$ make -k

Usage

Sensh doesn't automatically track, probe, or look up sensors; that is for a full implementation. Instead, it expects you to look up the sensor and copy the ID with your terminal emulator:

lookup accel_cal
sensh: accel_cal sensor found: A1392FDF217B7D9EI6648AED8C04DDFB9
attr A1392FDF217B7D9EI6648AED8C04DDFB9
sensh: name: ASH_CAL
sensh: vendor: GOOGLE
sensh: type: accel_cal
sensh: version: 1
sensh: api: sns_cal.proto
sensh: rates: 10.000000
sensh: stream type: 1
sensh: physical sensor: 0
sensh: available: 1

You can send 3 messages: lookup, attr, and watch. The lookup command returns SUIDs for the passed data type. The attr command returns attributes for the sensor. Finally, the watch command tells the sensor core to send events from a sensor whenever the sensor's value changes.

An EOF (normally Ctrl+D) is enough to exit the shell unless the sensor core died.

References

The following sources were used as reference: