Sensor emulator backend API

Sensor emulator backend API. More...

Functions
static bool	emul_sensor_backend_is_supported (const struct emul *target)
	Check if a given sensor emulator supports the backend API.
static int	emul_sensor_backend_set_channel (const struct emul *target, enum sensor_channel ch, q31_t value, int8_t shift)
	Set an expected value for a given channel on a given sensor emulator.
static int	emul_sensor_backend_get_sample_range (const struct emul *target, enum sensor_channel ch, q31_t *lower, q31_t *upper, q31_t *epsilon, int8_t *shift)
	Query an emulator for a channel's supported sample value range and tolerance.

Detailed Description

Sensor emulator backend API.

Function Documentation

emul_sensor_backend_get_sample_range()

static int emul_sensor_backend_get_sample_range ( const struct emul *  target, enum sensor_channel  ch, q31_t *  lower, q31_t *  upper, q31_t *  epsilon, int8_t *  shift  )

inlinestatic

#include <zephyr/drivers/emul_sensor.h>

Query an emulator for a channel's supported sample value range and tolerance.

Parameters

	target	Pointer to emulator instance to operate on
	ch	The channel to request info for. If ch is unsupported, return -ENOTSUP
[out]	lower	Minimum supported sample value in SI units, fixed-point format
[out]	upper	Maximum supported sample value in SI units, fixed-point format
[out]	epsilon	Tolerance to use comparing expected and actual values to account for rounding and sensor precision issues. This can usually be set to the minimum sample value step size. Uses SI units and fixed-point format.
[out]	shift	The shift value (scaling factor) associated with lower, upper, and epsilon.

Returns

0 if successful

-ENOTSUP if no backend API or if channel not supported by emul

emul_sensor_backend_is_supported()

static bool emul_sensor_backend_is_supported ( const struct emul *  target )

inlinestatic

#include <zephyr/drivers/emul_sensor.h>

Check if a given sensor emulator supports the backend API.

Parameters

target

Pointer to emulator instance to query

Returns

True if supported, false if unsupported or if target is NULL.

emul_sensor_backend_set_channel()

static int emul_sensor_backend_set_channel ( const struct emul *  target, enum sensor_channel  ch, q31_t  value, int8_t  shift  )

inlinestatic

#include <zephyr/drivers/emul_sensor.h>

Set an expected value for a given channel on a given sensor emulator.

Parameters

target	Pointer to emulator instance to operate on
ch	Sensor channel to set expected value for
value	Expected value in fixed-point format using standard SI unit for sensor type
shift	Shift value (scaling factor) applied to value

Returns

0 if successful

-ENOTSUP if no backend API or if channel not supported by emul

-ERANGE if provided value is not in the sensor's supported range