Devicetree HW spinlock API

Macros
#define	DT_HWSPINLOCK_CTRL_BY_IDX(node_id, idx)    DT_PHANDLE_BY_IDX(node_id, hwlocks, idx)
	Get the node identifier for the hardware spinlock controller from a hwlocks property by id.
#define	DT_HWSPINLOCK_CTRL_BY_NAME(node_id, name)    DT_PHANDLE_BY_NAME(node_id, hwlocks, name)
	Get the node identifier for the hardware spinlock controller from a hwlocks property by name.
#define	DT_HWSPINLOCK_ID_BY_NAME(node_id, name)    DT_PHA_BY_NAME(node_id, hwlocks, name, id)
	Get a hardware spinlock id by name.
#define	DT_HWSPINLOCK_ID_BY_IDX(node_id, idx)    DT_PHA_BY_IDX(node_id, hwlocks, idx, id)
	Get a hardware spinlock id by index.

Detailed Description

Macro Definition Documentation

DT_HWSPINLOCK_CTRL_BY_IDX

#define DT_HWSPINLOCK_CTRL_BY_IDX	(		node_id,
			idx
	)		DT_PHANDLE_BY_IDX(node_id, hwlocks, idx)

#include <include/zephyr/devicetree/hwspinlock.h>

Get the node identifier for the hardware spinlock controller from a hwlocks property by id.

Example devicetree fragment:

hwlock1: hwspinlock-controller@... { ... };
hwlock2: hwspinlock-controller@... { ... };

n: node {
        hwlocks = <&hwlock1 8>,
                  <&hwlock2 1>;
        hwlock-names = "rd", "wr";
};

Example usage:

DT_HWSPINLOCK_CTRL_BY_IDX(DT_NODELABEL(n), 0) // DT_NODELABEL(hwlock1)
DT_HWSPINLOCK_CTRL_BY_IDX(DT_NODELABEL(n), 1) // DT_NODELABEL(hwlock2)

Parameters

node_id	node identifier for a node with a hwlocks property
idx	index of a hwlocks element in the hwlocks

Returns

the node identifier for the hardware spinlock controller in the named element

See also

DT_PHANDLE_BY_IDX()

DT_HWSPINLOCK_CTRL_BY_NAME

#define DT_HWSPINLOCK_CTRL_BY_NAME	(		node_id,
			name
	)		DT_PHANDLE_BY_NAME(node_id, hwlocks, name)

#include <include/zephyr/devicetree/hwspinlock.h>

Get the node identifier for the hardware spinlock controller from a hwlocks property by name.

Example devicetree fragment:

hwlock1: hwspinlock-controller@... { ... };
hwlock2: hwspinlock-controller@... { ... };

n: node {
        hwlocks = <&hwlock1 8>,
                  <&hwlock2 1>;
        hwlock-names = "rd", "wr";
};

Example usage:

DT_HWSPINLOCK_CTRL_BY_NAME(DT_NODELABEL(n), rd) // DT_NODELABEL(hwlock1)
DT_HWSPINLOCK_CTRL_BY_NAME(DT_NODELABEL(n), wr) // DT_NODELABEL(hwlock2)

Parameters

node_id	node identifier for a node with a hwlocks property
name	lowercase-and-underscores name of a hwlocks element as defined by the node's hwlocks-names property

Returns

the node identifier for the hardware spinlock controller in the named element

See also

DT_PHANDLE_BY_NAME()

DT_HWSPINLOCK_ID_BY_IDX

#define DT_HWSPINLOCK_ID_BY_IDX	(		node_id,
			idx
	)		DT_PHA_BY_IDX(node_id, hwlocks, idx, id)

#include <include/zephyr/devicetree/hwspinlock.h>

Get a hardware spinlock id by index.

Example devicetree fragment:

hwlock1: hwspinlock-controller@... {
        #hwlock-cells = <1>;
};

n: node {
        hwlocks = <&hwlock1 1>,
                  <&hwlock1 6>;
};

Example usage:

DT_HWSPINLOCK_ID_BY_IDX(DT_NODELABEL(n), 0) // 1
DT_HWSPINLOCK_ID_BY_IDX(DT_NODELABEL(n), 1) // 6

Parameters

node_id	node identifier for a node with a hwlocks property
idx	index of a hwlocks element in the hwlocks

Returns

the channel value in the specifier at the named element or 0 if no channels are supported

See also

DT_PHA_BY_IDX()

DT_HWSPINLOCK_ID_BY_NAME

#define DT_HWSPINLOCK_ID_BY_NAME	(		node_id,
			name
	)		DT_PHA_BY_NAME(node_id, hwlocks, name, id)

#include <include/zephyr/devicetree/hwspinlock.h>

Get a hardware spinlock id by name.

Example devicetree fragment:

hwlock1: hwspinlock-controller@... {
        #hwlock-cells = <1>;
};

n: node {
        hwlocks = <&hwlock1 1>,
                  <&hwlock1 6>;
        hwlock-names = "rd", "wr";
};

Bindings fragment for the hwspinlock compatible:

hwlock-cells:
  - id

Example usage:

DT_HWSPINLOCK_ID_BY_NAME(DT_NODELABEL(n), rd) // 1
DT_HWSPINLOCK_ID_BY_NAME(DT_NODELABEL(n), wr) // 6

Parameters

node_id	node identifier for a node with a hwlocks property
name	lowercase-and-underscores name of a hwlocks element as defined by the node's hwlock-names property

Returns

the channel value in the specifier at the named element or 0 if no channels are supported

See also

DT_PHA_BY_NAME()