Devicetree Clocks API

Macros
#define	DT_CLOCKS_CTLR_BY_IDX(node_id, idx)    DT_PHANDLE_BY_IDX(node_id, clocks, idx)
	Get the node identifier for the controller phandle from a "clocks" phandle-array property at an index. More...
#define	DT_CLOCKS_CTLR(node_id)   DT_CLOCKS_CTLR_BY_IDX(node_id, 0)
	Equivalent to DT_CLOCKS_CTLR_BY_IDX(node_id, 0) More...
#define	DT_CLOCKS_CTLR_BY_NAME(node_id, name)    DT_PHANDLE_BY_NAME(node_id, clocks, name)
	Get the node identifier for the controller phandle from a clocks phandle-array property by name. More...
#define	DT_CLOCKS_CELL_BY_IDX(node_id, idx, cell)    DT_PHA_BY_IDX(node_id, clocks, idx, cell)
	Get a clock specifier's cell value at an index. More...
#define	DT_CLOCKS_CELL_BY_NAME(node_id, name, cell)    DT_PHA_BY_NAME(node_id, clocks, name, cell)
	Get a clock specifier's cell value by name. More...
#define	DT_CLOCKS_CELL(node_id, cell)   DT_CLOCKS_CELL_BY_IDX(node_id, 0, cell)
	Equivalent to DT_CLOCKS_CELL_BY_IDX(node_id, 0, cell) More...
#define	DT_INST_CLOCKS_CTLR_BY_IDX(inst, idx)    DT_CLOCKS_CTLR_BY_IDX(DT_DRV_INST(inst), idx)
	Get the node identifier for the controller phandle from a "clocks" phandle-array property at an index. More...
#define	DT_INST_CLOCKS_CTLR(inst)   DT_INST_CLOCKS_CTLR_BY_IDX(inst, 0)
	Equivalent to DT_INST_CLOCKS_CTLR_BY_IDX(inst, 0) More...
#define	DT_INST_CLOCKS_CTLR_BY_NAME(inst, name)    DT_CLOCKS_CTLR_BY_NAME(DT_DRV_INST(inst), name)
	Get the node identifier for the controller phandle from a clocks phandle-array property by name. More...
#define	DT_INST_CLOCKS_CELL_BY_IDX(inst, idx, cell)    DT_CLOCKS_CELL_BY_IDX(DT_DRV_INST(inst), idx, cell)
	Get a DT_DRV_COMPAT instance's clock specifier's cell value at an index. More...
#define	DT_INST_CLOCKS_CELL_BY_NAME(inst, name, cell)    DT_CLOCKS_CELL_BY_NAME(DT_DRV_INST(inst), name, cell)
	Get a DT_DRV_COMPAT instance's clock specifier's cell value by name. More...
#define	DT_INST_CLOCKS_CELL(inst, cell)    DT_INST_CLOCKS_CELL_BY_IDX(inst, 0, cell)
	Equivalent to DT_INST_CLOCKS_CELL_BY_IDX(inst, 0, cell) More...

Detailed Description

Macro Definition Documentation

DT_CLOCKS_CELL

#define DT_CLOCKS_CELL	(		node_id,
			cell
	)		DT_CLOCKS_CELL_BY_IDX(node_id, 0, cell)

#include <include/devicetree/clocks.h>

Equivalent to DT_CLOCKS_CELL_BY_IDX(node_id, 0, cell)

Parameters

node_id	node identifier for a node with a clocks property
cell	lowercase-and-underscores cell name

Returns

the cell value at index 0

See also

DT_CLOCKS_CELL_BY_IDX()

DT_CLOCKS_CELL_BY_IDX

#define DT_CLOCKS_CELL_BY_IDX	(		node_id,
			idx,
			cell
	)		DT_PHA_BY_IDX(node_id, clocks, idx, cell)

#include <include/devicetree/clocks.h>

Get a clock specifier's cell value at an index.

Example devicetree fragment:

clk1: clock-controller@... {
        compatible = "vnd,clock";
        #clock-cells = < 2 >;
};

n: node {
        clocks = < &clk1 10 20 >, < &clk1 30 40 >;
};

Bindings fragment for the vnd,clock compatible:

clock-cells:
  - bus
  - bits

Example usage:

DT_CLOCKS_CELL_BY_IDX(DT_NODELABEL(n), 0, bus) // 10
DT_CLOCKS_CELL_BY_IDX(DT_NODELABEL(n), 1, bits) // 40

Parameters

node_id	node identifier for a node with a clocks property
idx	logical index into clocks property
cell	lowercase-and-underscores cell name

Returns

the cell value at index "idx"

See also

DT_PHA_BY_IDX()

DT_CLOCKS_CELL_BY_NAME

#define DT_CLOCKS_CELL_BY_NAME	(		node_id,
			name,
			cell
	)		DT_PHA_BY_NAME(node_id, clocks, name, cell)

#include <include/devicetree/clocks.h>

Get a clock specifier's cell value by name.

Example devicetree fragment:

clk1: clock-controller@... {
        compatible = "vnd,clock";
        #clock-cells = < 2 >;
};

n: node {
        clocks = < &clk1 10 20 >, < &clk1 30 40 >;
        clock-names = "alpha", "beta";
};

Bindings fragment for the vnd,clock compatible:

clock-cells:
  - bus
  - bits

Example usage:

DT_CLOCKS_CELL_BY_NAME(DT_NODELABEL(n), alpha, bus) // 10
DT_CLOCKS_CELL_BY_NAME(DT_NODELABEL(n), beta, bits) // 40

Parameters

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

Returns

the cell value in the specifier at the named element

See also

DT_PHA_BY_NAME()

DT_CLOCKS_CTLR

#define DT_CLOCKS_CTLR

(

node_id

)

DT_CLOCKS_CTLR_BY_IDX(node_id, 0)

#include <include/devicetree/clocks.h>

Equivalent to DT_CLOCKS_CTLR_BY_IDX(node_id, 0)

Parameters

node_id

node identifier

Returns

a node identifier for the clocks controller at index 0 in "clocks"

See also

DT_CLOCKS_CTLR_BY_IDX()

DT_CLOCKS_CTLR_BY_IDX

#define DT_CLOCKS_CTLR_BY_IDX	(		node_id,
			idx
	)		DT_PHANDLE_BY_IDX(node_id, clocks, idx)

#include <include/devicetree/clocks.h>

Get the node identifier for the controller phandle from a "clocks" phandle-array property at an index.

Example devicetree fragment:

clk1: clock-controller@... { ... };

clk2: clock-controller@... { ... };

n: node {
        clocks = <&clk1 10 20>, <&clk2 30 40>;
};

Example usage:

DT_CLOCKS_CTLR_BY_IDX(DT_NODELABEL(n), 0)) // DT_NODELABEL(clk1)
DT_CLOCKS_CTLR_BY_IDX(DT_NODELABEL(n), 1)) // DT_NODELABEL(clk2)

Parameters

node_id	node identifier
idx	logical index into "clocks"

Returns

the node identifier for the clock controller referenced at index "idx"

See also

DT_PHANDLE_BY_IDX()

DT_CLOCKS_CTLR_BY_NAME

#define DT_CLOCKS_CTLR_BY_NAME	(		node_id,
			name
	)		DT_PHANDLE_BY_NAME(node_id, clocks, name)

#include <include/devicetree/clocks.h>

Get the node identifier for the controller phandle from a clocks phandle-array property by name.

Example devicetree fragment:

clk1: clock-controller@... { ... };

clk2: clock-controller@... { ... };

n: node {
        clocks = <&clk1 10 20>, <&clk2 30 40>;
        clock-names = "alpha", "beta";
};

Example usage:

DT_CLOCKS_CTLR_BY_NAME(DT_NODELABEL(n), beta) // DT_NODELABEL(clk2)

Parameters

node_id	node identifier
name	lowercase-and-underscores name of a clocks element as defined by the node's clock-names property

Returns

the node identifier for the clock controller referenced by name

See also

DT_PHANDLE_BY_NAME()

DT_INST_CLOCKS_CELL

#define DT_INST_CLOCKS_CELL	(		inst,
			cell
	)		DT_INST_CLOCKS_CELL_BY_IDX(inst, 0, cell)

#include <include/devicetree/clocks.h>

Equivalent to DT_INST_CLOCKS_CELL_BY_IDX(inst, 0, cell)

Parameters

inst	DT_DRV_COMPAT instance number
cell	lowercase-and-underscores cell name

Returns

the value of the cell inside the specifier at index 0

DT_INST_CLOCKS_CELL_BY_IDX

#define DT_INST_CLOCKS_CELL_BY_IDX	(		inst,
			idx,
			cell
	)		DT_CLOCKS_CELL_BY_IDX(DT_DRV_INST(inst), idx, cell)

#include <include/devicetree/clocks.h>

Get a DT_DRV_COMPAT instance's clock specifier's cell value at an index.

Parameters

inst	DT_DRV_COMPAT instance number
idx	logical index into clocks property
cell	lowercase-and-underscores cell name

Returns

the cell value at index "idx"

See also

DT_CLOCKS_CELL_BY_IDX()

DT_INST_CLOCKS_CELL_BY_NAME

#define DT_INST_CLOCKS_CELL_BY_NAME	(		inst,
			name,
			cell
	)		DT_CLOCKS_CELL_BY_NAME(DT_DRV_INST(inst), name, cell)

#include <include/devicetree/clocks.h>

Get a DT_DRV_COMPAT instance's clock specifier's cell value by name.

Parameters

inst	DT_DRV_COMPAT instance number
name	lowercase-and-underscores name of a clocks element as defined by the node's clock-names property
cell	lowercase-and-underscores cell name

Returns

the cell value in the specifier at the named element

See also

DT_CLOCKS_CELL_BY_NAME()

DT_INST_CLOCKS_CTLR

#define DT_INST_CLOCKS_CTLR

(

inst

)

DT_INST_CLOCKS_CTLR_BY_IDX(inst, 0)

#include <include/devicetree/clocks.h>

Equivalent to DT_INST_CLOCKS_CTLR_BY_IDX(inst, 0)

Parameters

inst	instance number

Returns

a node identifier for the clocks controller at index 0 in "clocks"

See also

DT_CLOCKS_CTLR()

DT_INST_CLOCKS_CTLR_BY_IDX

#define DT_INST_CLOCKS_CTLR_BY_IDX	(		inst,
			idx
	)		DT_CLOCKS_CTLR_BY_IDX(DT_DRV_INST(inst), idx)

#include <include/devicetree/clocks.h>

Get the node identifier for the controller phandle from a "clocks" phandle-array property at an index.

Parameters

inst	instance number
idx	logical index into "clocks"

Returns

the node identifier for the clock controller referenced at index "idx"

See also

DT_CLOCKS_CTLR_BY_IDX()

DT_INST_CLOCKS_CTLR_BY_NAME

#define DT_INST_CLOCKS_CTLR_BY_NAME	(		inst,
			name
	)		DT_CLOCKS_CTLR_BY_NAME(DT_DRV_INST(inst), name)

#include <include/devicetree/clocks.h>

Get the node identifier for the controller phandle from a clocks phandle-array property by name.

Parameters

inst	instance number
name	lowercase-and-underscores name of a clocks element as defined by the node's clock-names property

Returns

the node identifier for the clock controller referenced by the named element

See also

DT_CLOCKS_CTLR_BY_NAME()