Input Interface

Input Interface. More...

Modules
	Input Event Definitions

Data Structures
struct	input_event
	Input event structure. More...
struct	input_listener
	Input listener callback structure. More...

Macros
#define	INPUT_CALLBACK_DEFINE(_dev, _callback)
	Register a callback structure for input events.

Functions
int	input_report (const struct device *dev, uint8_t type, uint16_t code, int32_t value, bool sync, k_timeout_t timeout)
	Report a new input event.
static int	input_report_key (const struct device *dev, uint16_t code, int32_t value, bool sync, k_timeout_t timeout)
	Report a new INPUT_EV_KEY input event, note that value is converted to either 0 or 1.
static int	input_report_rel (const struct device *dev, uint16_t code, int32_t value, bool sync, k_timeout_t timeout)
	Report a new INPUT_EV_REL input event.
static int	input_report_abs (const struct device *dev, uint16_t code, int32_t value, bool sync, k_timeout_t timeout)
	Report a new INPUT_EV_ABS input event.
bool	input_queue_empty (void)
	Returns true if the input queue is empty.

Detailed Description

Input Interface.

Macro Definition Documentation

INPUT_CALLBACK_DEFINE

#define INPUT_CALLBACK_DEFINE	(		_dev,
			_callback
	)

#include <zephyr/input/input.h>

Value:

        static const STRUCT_SECTION_ITERABLE(input_listener,                   \
                                             _input_listener__##_callback) = { \
                .dev = _dev,                                                   \
                .callback = _callback,                                         \
        }

Register a callback structure for input events.

The _dev field can be used to only invoke callback for events generated by a specific device. Setting dev to NULL causes callback to be invoked for every event.

Parameters

_dev	device pointer or NULL.
_callback	The callback function.

Function Documentation

input_queue_empty()

bool input_queue_empty

(

void

)

#include <zephyr/input/input.h>

Returns true if the input queue is empty.

This can be used to batch input event processing until the whole queue has been emptied. Always returns true if CONFIG_INPUT_MODE_SYNCHRONOUS is enabled.

input_report()

int input_report	(	const struct device *	dev,
		uint8_t	type,
		uint16_t	code,
		int32_t	value,
		bool	sync,
		k_timeout_t	timeout
	)

#include <zephyr/input/input.h>

Report a new input event.

This causes all the listeners for the specified device to be triggered, either synchronously or through the input thread if utilized.

Parameters

dev	Device generating the event or NULL.
type	Event type (see INPUT_EV_CODES).
code	Event code (see INPUT_KEY_CODES, INPUT_BTN_CODES, INPUT_ABS_CODES, INPUT_REL_CODES, INPUT_MSC_CODES).
value	Event value.
sync	Set the synchronization bit for the event.
timeout	Timeout for reporting the event, ignored if CONFIG_INPUT_MODE_SYNCHRONOUS is used.

Return values

0	if the message has been processed.
negative	if CONFIG_INPUT_MODE_THREAD is enabled and the message failed to be enqueued.

input_report_abs()

static int input_report_abs ( const struct device *  dev, uint16_t  code, int32_t  value, bool  sync, k_timeout_t  timeout  )

inlinestatic

#include <zephyr/input/input.h>

Report a new INPUT_EV_ABS input event.

See also

input_report() for more details.

input_report_key()

static int input_report_key ( const struct device *  dev, uint16_t  code, int32_t  value, bool  sync, k_timeout_t  timeout  )

inlinestatic

#include <zephyr/input/input.h>

Report a new INPUT_EV_KEY input event, note that value is converted to either 0 or 1.

See also

input_report() for more details.

input_report_rel()

static int input_report_rel ( const struct device *  dev, uint16_t  code, int32_t  value, bool  sync, k_timeout_t  timeout  )

inlinestatic

#include <zephyr/input/input.h>

Report a new INPUT_EV_REL input event.

See also

input_report() for more details.