Device Tables (DT) for IP clkmgr and top earlgrey. More...

#include "hw/top/dt/dt_clkmgr.h"
#include "hw/top/clkmgr_regs.h"

Data Structures
struct	dt_desc_clkmgr
	Description of instances. More...

struct	dt_desc_clkmgr.clkmgr_ext

Macros
#define	TRY_GET_DT(dt, default)
	Return a pointer to the `dt_clkmgr_desc_t` structure of the requested `dt` if it's a valid index.

Typedefs
typedef struct dt_desc_clkmgr	dt_desc_clkmgr_t
	Description of instances.

Functions
dt_clkmgr_t	dt_clkmgr_from_instance_id (dt_instance_id_t inst_id)
	Get the clkmgr instance from an instance ID.

dt_instance_id_t	dt_clkmgr_instance_id (dt_clkmgr_t dt)
	Get the instance ID of an instance.

uint32_t	dt_clkmgr_reg_block (dt_clkmgr_t dt, dt_clkmgr_reg_block_t reg_block)
	Get the register base address of an instance.

uint32_t	dt_clkmgr_memory_base (dt_clkmgr_t dt, dt_clkmgr_memory_t mem)
	Get the base address of a memory.

uint32_t	dt_clkmgr_memory_size (dt_clkmgr_t dt, dt_clkmgr_memory_t mem)
	Get the size of a memory.

dt_alert_id_t	dt_clkmgr_alert_to_alert_id (dt_clkmgr_t dt, dt_clkmgr_alert_t alert)
	Get the alert ID of a clkmgr alert for a given instance.

dt_clkmgr_alert_t	dt_clkmgr_alert_from_alert_id (dt_clkmgr_t dt, dt_alert_id_t alert)
	Convert a global alert ID to a local clkmgr alert type.

dt_clock_t	dt_clkmgr_clock (dt_clkmgr_t dt, dt_clkmgr_clock_t clk)
	Get the clock signal connected to a clock port of an instance.

dt_reset_t	dt_clkmgr_reset (dt_clkmgr_t dt, dt_clkmgr_reset_t rst)
	Get the reset signal connected to a reset port of an instance.

size_t	dt_clkmgr_gateable_clock_count (dt_clkmgr_t dt)
	Get the number of software gateable clocks.

dt_instance_id_t	dt_clkmgr_gateable_clock (dt_clkmgr_t dt, size_t idx)
	Get the instance ID of a gateable clock.

size_t	dt_clkmgr_hintable_clock_count (dt_clkmgr_t dt)
	Get the number of software hintable clocks.

dt_instance_id_t	dt_clkmgr_hintable_clock (dt_clkmgr_t dt, size_t idx)
	Get the instance ID of a hintable clock.

size_t	dt_clkmgr_measurable_clock_count (dt_clkmgr_t dt)
	Get the number of measurable clocks.

dt_clkmgr_measurable_clk_t	dt_clkmgr_measurable_clock (dt_clkmgr_t dt, size_t idx)
	Get the description of a measurable clock.

Detailed Description

Device Tables (DT) for IP clkmgr and top earlgrey.

Definition in file dt_clkmgr.c.

Data Structure Documentation

◆ dt_desc_clkmgr

struct dt_desc_clkmgr

Description of instances.

Definition at line 21 of file dt_clkmgr.c.

Data Fields
struct dt_desc_clkmgr	clkmgr_ext	Extension.
struct dt_desc_clkmgr	clkmgr_ext	Extension.
struct dt_desc_clkmgr.clkmgr_ext	clkmgr_ext	Extension.
dt_clock_t	clock[kDtClkmgrClockCount]	Clock signal connected to each clock port.
top_darjeeling_alert_id_t	first_alert	Alert ID of the first Alert of this instance. This value is undefined if the block is not connected to the Alert Handler.
top_earlgrey_alert_id_t	first_alert	Alert ID of the first Alert of this instance. This value is undefined if the block is not connected to the Alert Handler.
dt_instance_id_t	inst_id	Instance ID.
uint32_t	mem_addr[kDtClkmgrMemoryCount]	Base address of each memory.
uint32_t	mem_size[kDtClkmgrMemoryCount]	Size in bytes of each memory.
uint32_t	reg_addr[kDtClkmgrRegBlockCount]	Base address of each register block.
dt_reset_t	reset[kDtClkmgrResetCount]	Reset signal connected to each reset port.

◆ dt_desc_clkmgr.clkmgr_ext

struct dt_desc_clkmgr.clkmgr_ext

Definition at line 28 of file dt_clkmgr.c.

Data Fields
dt_instance_id_t	hint_clks[1]	List of hintable clocks, in the order of the register fields.
dt_instance_id_t	hint_clks[4]	List of hintable clocks, in the order of the register fields.
dt_instance_id_t	hint_clks[4]	List of hintable clocks, in the order of the register fields.
dt_clkmgr_measurable_clk_t	measurable_clks[2]	List of measurables clocks.
dt_clkmgr_measurable_clk_t	measurable_clks[4]	List of measurables clocks.
dt_clkmgr_measurable_clk_t	measurable_clks[5]	List of measurables clocks.
dt_instance_id_t	sw_clks[2]	List of gateable clocks, in the order of the register fields.
dt_instance_id_t	sw_clks[4]	List of gateable clocks, in the order of the register fields.
dt_instance_id_t	sw_clks[4]	List of gateable clocks, in the order of the register fields.

Macro Definition Documentation

◆ TRY_GET_DT

#define TRY_GET_DT	(		dt,
			default )

Value:

({ if ((dt) < (dt_clkmgr_t)0 || (dt) >= kDtClkmgrCount) return (default); &clkmgr_desc[dt]; })

Return a pointer to the dt_clkmgr_desc_t structure of the requested dt if it's a valid index.

Otherwise, this macro will return (i.e. exit the function) with the provided default value.

Definition at line 141 of file dt_clkmgr.c.

Function Documentation

◆ dt_clkmgr_alert_from_alert_id()

dt_clkmgr_alert_t dt_clkmgr_alert_from_alert_id	(	dt_clkmgr_t	dt,
		dt_alert_id_t	alert )

Convert a global alert ID to a local clkmgr alert type.

Parameters

dt	Instance of clkmgr.
alert	A global alert ID that belongs to this instance.

Returns: The clkmgr alert, or kDtClkmgrAlertCount.

Note: This function assumes that the global alert ID belongs to the instance of clkmgr passed in parameter. In other words, it must be the case that dt_clkmgr_instance_id(dt) == dt_alert_id_to_instance_id(alert). Otherwise, this function will return kDtClkmgrAlertCount.

Definition at line 183 of file dt_clkmgr.c.

◆ dt_clkmgr_alert_to_alert_id()

dt_alert_id_t dt_clkmgr_alert_to_alert_id	(	dt_clkmgr_t	dt,
		dt_clkmgr_alert_t	alert )

Get the alert ID of a clkmgr alert for a given instance.

Note: This function only makes sense if the instance is connected to the Alert Handler. For any instances where the instance is not connected, the return value is unspecified.

Parameters

dt	Instance of clkmgr.
alert	A clkmgr alert.

Returns: The Alert Handler alert ID of the alert of this instance.

Definition at line 177 of file dt_clkmgr.c.

◆ dt_clkmgr_clock()

dt_clock_t dt_clkmgr_clock	(	dt_clkmgr_t	dt,
		dt_clkmgr_clock_t	clk )

Get the clock signal connected to a clock port of an instance.

Parameters

dt	Instance of clkmgr.
clk	Clock port.

Returns: Clock signal.

Definition at line 195 of file dt_clkmgr.c.

◆ dt_clkmgr_from_instance_id()

dt_clkmgr_t dt_clkmgr_from_instance_id ( dt_instance_id_t inst_id )

Get the clkmgr instance from an instance ID.

For example, dt_uart_from_instance_id(kDtInstanceIdUart3) == kDtUart3.

Parameters

inst_id Instance ID.

Returns: A clkmgr instance.

Note: This function only makes sense if the instance ID has device type clkmgr, otherwise the returned value is unspecified.

Definition at line 143 of file dt_clkmgr.c.

◆ dt_clkmgr_gateable_clock()

dt_instance_id_t dt_clkmgr_gateable_clock	(	dt_clkmgr_t	dt,
		size_t	idx )

Get the instance ID of a gateable clock.

The clocks are ordered as they appear in the registers.

Parameters

dt	Instance of clkmgr.
idx	Index of the gateable clock, between 0 and `dt_clkmgr_sw_clock_count(dt)-1`.

Returns: Instance ID of the device whose clock is gateable.

Definition at line 218 of file dt_clkmgr.c.

◆ dt_clkmgr_gateable_clock_count()

size_t dt_clkmgr_gateable_clock_count ( dt_clkmgr_t dt )

Get the number of software gateable clocks.

Parameters

dt	Instance of clkmgr.

Returns: Number of gateable clocks.

Definition at line 214 of file dt_clkmgr.c.

◆ dt_clkmgr_hintable_clock()

dt_instance_id_t dt_clkmgr_hintable_clock	(	dt_clkmgr_t	dt,
		size_t	idx )

Get the instance ID of a hintable clock.

The clocks sources are ordered as they appear in the registers.

Parameters

dt	Instance of clkmgr.
idx	Index of the hintable clock, between 0 and `dt_clkmgr_hint_clock_count(dt)-1`.

Returns: Instance ID of the device whose clock is hintable.

Definition at line 226 of file dt_clkmgr.c.

◆ dt_clkmgr_hintable_clock_count()

size_t dt_clkmgr_hintable_clock_count ( dt_clkmgr_t dt )

Get the number of software hintable clocks.

Parameters

dt	Instance of clkmgr.

Returns: Number of hintable clocks.

Definition at line 222 of file dt_clkmgr.c.

◆ dt_clkmgr_instance_id()

dt_instance_id_t dt_clkmgr_instance_id ( dt_clkmgr_t dt )

Get the instance ID of an instance.

Parameters

dt	Instance of clkmgr.

Returns: The instance ID of that instance.

Definition at line 150 of file dt_clkmgr.c.

◆ dt_clkmgr_measurable_clock()

dt_clkmgr_measurable_clk_t dt_clkmgr_measurable_clock	(	dt_clkmgr_t	dt,
		size_t	idx )

Get the description of a measurable clock.

Parameters

dt	Instance of clkmgr.
idx	Index of the measurable clock, between 0 and `dt_clkmgr_measurable_clock_count(dt)-1`.

Returns: Description of the measurable clock.

Definition at line 234 of file dt_clkmgr.c.

◆ dt_clkmgr_measurable_clock_count()

size_t dt_clkmgr_measurable_clock_count ( dt_clkmgr_t dt )

Get the number of measurable clocks.

Parameters

dt	Instance of clkmgr.

Returns: Number of measurable clocks.

Definition at line 230 of file dt_clkmgr.c.

◆ dt_clkmgr_memory_base()

uint32_t dt_clkmgr_memory_base	(	dt_clkmgr_t	dt,
		dt_clkmgr_memory_t	mem )

Get the base address of a memory.

Parameters

dt	Instance of clkmgr.
mem	The memory requested.

Returns: The base address of the requested memory.

Definition at line 162 of file dt_clkmgr.c.

◆ dt_clkmgr_memory_size()

uint32_t dt_clkmgr_memory_size	(	dt_clkmgr_t	dt,
		dt_clkmgr_memory_t	mem )

Get the size of a memory.

Parameters

dt	Instance of clkmgr.
mem	The memory requested.

Returns: The size of the requested memory.

Definition at line 169 of file dt_clkmgr.c.

◆ dt_clkmgr_reg_block()

uint32_t dt_clkmgr_reg_block	(	dt_clkmgr_t	dt,
		dt_clkmgr_reg_block_t	reg_block )

Get the register base address of an instance.

Parameters

dt	Instance of clkmgr.
reg_block	The register block requested.

Returns: The register base address of the requested block.

Definition at line 155 of file dt_clkmgr.c.

◆ dt_clkmgr_reset()

dt_reset_t dt_clkmgr_reset	(	dt_clkmgr_t	dt,
		dt_clkmgr_reset_t	rst )

Get the reset signal connected to a reset port of an instance.

Parameters

dt	Instance of clkmgr.
rst	Reset port.

Returns: Reset signal.

Definition at line 202 of file dt_clkmgr.c.

Data Structures

Macros

Typedefs

Functions

Detailed Description

Data Structure Documentation

◆ dt_desc_clkmgr

◆ dt_desc_clkmgr.clkmgr_ext

Macro Definition Documentation

◆ TRY_GET_DT

Function Documentation

◆ dt_clkmgr_alert_from_alert_id()

◆ dt_clkmgr_alert_to_alert_id()

◆ dt_clkmgr_clock()

◆ dt_clkmgr_from_instance_id()

◆ dt_clkmgr_gateable_clock()

◆ dt_clkmgr_gateable_clock_count()

◆ dt_clkmgr_hintable_clock()

◆ dt_clkmgr_hintable_clock_count()

◆ dt_clkmgr_instance_id()

◆ dt_clkmgr_measurable_clock()

◆ dt_clkmgr_measurable_clock_count()

◆ dt_clkmgr_memory_base()

◆ dt_clkmgr_memory_size()

◆ dt_clkmgr_reg_block()

◆ dt_clkmgr_reset()