SAUL registry

Global sensor/actuator registry for SAUL devices. More...

Detailed Description

Global sensor/actuator registry for SAUL devices.

See also

[S]ensor [A]ctuator [U]ber [L]ayer

Files
file	saul_reg.h
	SAUL registry interface definition.

Data Structures
struct	saul_reg
	SAUL registry entry. More...
struct	saul_reg_info_t
	Additional data to collect for each entry. More...

Typedefs
typedef struct saul_reg	saul_reg_t
	SAUL registry entry.

Functions
int	saul_reg_add (saul_reg_t *dev)
	Register a device with the SAUL registry.
saul_reg_t *	saul_reg_find_nth (int pos)
	Find a device by its position in the registry.
saul_reg_t *	saul_reg_find_type (uint8_t type)
	Find the first device by its type in the registry.
saul_reg_t *	saul_reg_find_name (const char *name)
	Find the first device by its name in the registry.
saul_reg_t *	saul_reg_find_type_and_name (uint8_t type, const char *name)
	Find the first device by its type and name in the registry.
int	saul_reg_read (saul_reg_t *dev, phydat_t *res)
	Read data from the given device.
int	saul_reg_write (saul_reg_t *dev, const phydat_t *data)
	Write data to the given device.

Variables
saul_reg_t *	saul_reg
	Export the SAUL registry as global variable.

Function Documentation

saul_reg_add()

int saul_reg_add

(

saul_reg_t *

dev

)

Register a device with the SAUL registry.

Note

Make sure the registry entry the dev pointer is pointing to resides in some persistent memory location and not on some position on the stack where it will be overwritten...

Parameters

[in]

dev

pointer to a pre-populated registry entry

Returns

0 on success

-ENODEV on invalid entry given

saul_reg_find_name()

saul_reg_t * saul_reg_find_name

(

const char *

name

)

Find the first device by its name in the registry.

Parameters

[in]

name

the name to look for

Returns

pointer to the first device matching the given name

NULL if no device with that name could be found

saul_reg_find_nth()

saul_reg_t * saul_reg_find_nth

(

int

pos

)

Find a device by its position in the registry.

Parameters

[in]

pos

position to look up

Returns

pointer to the device at position specified by pos

NULL if no device is registered at that position

saul_reg_find_type()

saul_reg_t * saul_reg_find_type

(

uint8_t

type

)

Find the first device by its type in the registry.

Parameters

[in]

type

the device type to look for

Returns

pointer to the first device matching the given type

NULL if no device of that type could be found

saul_reg_find_type_and_name()

saul_reg_t * saul_reg_find_type_and_name	(	uint8_t	type,
		const char *	name
	)

Find the first device by its type and name in the registry.

Parameters

[in]	type	the device type to look for
[in]	name	the name to look for

Returns

pointer to the first device matching the given type and name

NULL if no device with that type and name could be found

saul_reg_read()

int saul_reg_read	(	saul_reg_t *	dev,
		phydat_t *	res
	)

Read data from the given device.

Parameters

[in]	dev	device to read from
[out]	res	location to store the results in

Returns

the number of data elements read to res [1-3]

-ENODEV if given device is invalid

-ENOTSUP if read operation is not supported by the device

-ECANCELED on device errors

saul_reg_write()

int saul_reg_write	(	saul_reg_t *	dev,
		const phydat_t *	data
	)

Write data to the given device.

Parameters

[in]	dev	device to write to
[in]	data	data to write to the device

Returns

the number of data elements processed by the device

-ENODEV if given device is invalid

-ENOTSUP if read operation is not supported by the device

-ECANCELED on device errors