compatible

"st,lps22hh"

Enables the lps22hh.c driver and associates it with the device.

reg

<0x5c>

LPS22HH slave address on the I²C bus, which will be used by the driver to communicate with the barometer.

drdy-gpios

<&gpio0 5 GPIO_ACTIVE_HIGH>

Host SoC GPIO, that will be used for LPS22HH interrupts.

compatible

"st,lis2dw12"

Enables the lis2dw12.c driver and associates it with the device.

reg

<0x19>

LIS2DW12 slave address on the I²C bus, which will be used by the driver to communicate with the IMU.

irq-gpios

<&gpio0 7 GPIO_ACTIVE_HIGH>, <&gpio0 6 GPIO_ACTIVE_HIGH>

Host SoC GPIO, that will be used for LIS2DW12 interrupts.

int-pin

<1>

Select DRDY pin number (1 or 2).

This number represents which of the two interrupt pins (INT1 or INT2) the drdy line is attached to. This property is not mandatory and if not present it defaults to 1 which is the configuration at power-up.

tap-threshold

<1>, <1>, <1>

Tap X/Y/Z axes threshold. Default is power-up configuration.

Thresholds to start the tap-event detection procedure on the X/Y/Z axes.
Threshold values for each axis are unsigned 5-bit corresponding to a 2g acceleration full-scale range. A threshold value equal to zero corresponds to disable the tap detection on that axis.

For example, if you want to set the threshold for X to 12, for Z to 14 and want to disable tap detection on Y, you should specify in Device Tree, which is equivalent to X = 12 * 2g/32 = 750mg and Z = 14 * 2g/32 = 875mg.

Function

Description

Comments

__syscall int sensor_attr_set(const struct device *dev, enum sensor_channel chan, enum sensor_attribute attr, const struct sensor_value *val);

Set an attribute for a sensor.

dev - pointer to the sensor device.

chan - the channel the attribute belongs to, if any. Some attributes may only be set for all channels of a device, depending on device capabilities.

attr - the attribute to set.

val - the value to set the attribute to.

Returns 0 if successful, negative errno code if failure.

__syscall int sensor_attr_get(const struct device *dev, enum sensor_channel chan, enum sensor_attribute attr, const struct sensor_value *val);

Get an attribute for a sensor.

dev - pointer to the sensor device.

chan - the channel the attribute belongs to, if any. Some attributes may only be set for all channels of a device, depending on device capabilities.

attr - the attribute to get.

val - pointer to where to store the attribute

Returns 0 if successful, negative errno code if failure.

__syscall int sensor_sample_fetch(const struct device *dev);

Fetch a sample from the sensor and store it in an internal driver buffer.

dev - pointer to the sensor device.

Returns 0 if successful, negative errno code if failure.

Read all of a sensor's active channels and, if necessary, perform any additional operations necessary to make the values useful. The user may then get individual channel values by calling sensor_channel_get().

The function blocks until the fetch operation is complete. Since the function communicates with the sensor device, it is unsafe to call it in an ISR if the device is connected via I2C or SPI.

__syscall int sensor_sample_fetch_chan(const struct device *dev, enum sensor_channel type);

Fetch a sample from the sensor and store it in an internal driver buffer.

dev - pointer to the sensor device.

type - the channel that needs updated.

Returns 0 if successful, negative errno code if failure.

Read and compute compensation for one type of sensor data (magnetometer, accelerometer, etc). The user may then get individual channel values by sensor_channel_get().

This is mostly implemented by multi function devices enabling reading at different sampling rates. The function blocks until the fetch operation is complete.

Since the function communicates with the sensor device, it is unsafe to call it in an ISR if the device is connected via I2C or SPI.

__syscall int sensor_channel_get(const struct device *dev, enum sensor_channel chan, struct sensor_value *val);

Get a reading from a sensor device.

dev - pointer to the sensor device
chan - the channel to read
val - pointer to the variable to store the value.

Return a useful value for a particular channel, from the driver's internal data. Before calling this function, a sample must be obtained by calling sensor_sample_fetch() or sensor_sample_fetch_chan(). It is guaranteed that two subsequent calls of this function for the same channels will yield the same value, if sensor_sample_fetch() or sensor_sample_fetch_chan() has not been called in the meantime.

static inline int sensor_trigger_set(const struct device *dev, const struct sensor_trigger *trig, sensor_trigger_handler_t handler);

Activate a sensor's trigger and set the trigger handle.

dev - pointer to the sensor device.
trig - the trigger to activate.
handler - the function that should be called when the trigger fires.

Returns 0 if successful, negative errno code if failure.

The handler will be called from a thread, so I2C or SPI operations are safe. However, the thread's stack is limited and defined by the driver. It is currently up to the caller to ensure that the handler does not overflow the stack.

The user-allocated trigger will be stored by the driver as a pointer, rather than a copy, and passed back to the handler. This enables the handler to use CONTAINER_OF to retrieve a context pointer when the trigger is embedded in a larger struct and requires that the trigger is not allocated on the stack.