Timer capability. More...

#include <timer_types.h>

Collaboration diagram for odp_timer_capability_t:

Data Fields
uint32_t	max_pools_combined
	Maximum number of timer pools. More...

uint32_t	max_pools
	Maximum number of timer pools for single shot timers (per clock source) More...

uint16_t	max_priority
	Maximum single shot timer pool priority. More...

uint32_t	max_timers
	Maximum number of single shot timers in a pool. More...

uint64_t	highest_res_ns
	Highest timer resolution in nanoseconds. More...

odp_timer_res_capability_t	max_res
	Maximum resolution. More...

odp_timer_res_capability_t	max_tmo
	Maximum timeout length. More...

odp_bool_t	queue_type_sched
	Scheduled queue destination support. More...

odp_bool_t	queue_type_plain
	Plain queue destination support. More...

struct {
struct {
uint32_t base_mul: 1
	ODP_TIMER_TYPE_PERIODIC_BASE_MUL supported.

uint32_t freq: 1
	ODP_TIMER_TYPE_PERIODIC_FREQ supported.

} support
	Supported period configuration types.

uint32_t max_pools
	Maximum number of timer pools for periodic timers.

uint16_t max_priority
	Maximum periodic timer pool priority.

uint32_t max_timers
	Maximum number of periodic timers in a pool.

odp_fract_u64_t min_base_freq_hz
	Minimum supported base frequency value. More...

odp_fract_u64_t max_base_freq_hz
	Maximum supported base frequency value. More...

odp_fract_u64_t min_freq_hz
	Minimum supported periodic timer frequency value. More...

odp_fract_u64_t max_freq_hz
	Maximum supported periodic timer frequency value. More...

uint32_t min_pending_tmo
	Minimum value for odp_timer_pool_param_t::periodic::max_pending_tmo.

uint32_t max_pending_tmo
	Maximum value for odp_timer_pool_param_t::periodic::max_pending_tmo. More...

}	periodic
	Periodic timer capabilities.

Detailed Description

Timer capability.

Examples: odp_bench_timer.c, odp_debug.c, odp_sched_pktio.c, odp_stress.c, odp_sysinfo.c, odp_timer_accuracy.c, odp_timer_perf.c, odp_timer_simple.c, and odp_timer_stress.c.

Definition at line 155 of file api/spec/timer_types.h.

Field Documentation

◆ max_pools_combined

uint32_t odp_timer_capability_t::max_pools_combined

Maximum number of timer pools.

The total number of timer pools that can be created combining both types and different clock sources.

Examples: odp_sysinfo.c.

Definition at line 161 of file api/spec/timer_types.h.

◆ max_pools

uint32_t odp_timer_capability_t::max_pools

Maximum number of timer pools for single shot timers (per clock source)

Maximum number of timer pools for periodic timers.

Examples: odp_stress.c, odp_sysinfo.c, odp_timer_perf.c, and odp_timer_stress.c.

Definition at line 164 of file api/spec/timer_types.h.

◆ max_priority

uint16_t odp_timer_capability_t::max_priority

Maximum single shot timer pool priority.

Maximum periodic timer pool priority.

Examples: odp_sysinfo.c.

Definition at line 167 of file api/spec/timer_types.h.

◆ max_timers

uint32_t odp_timer_capability_t::max_timers

Maximum number of single shot timers in a pool.

Maximum number of periodic timers in a pool.

The value of zero means that limited only by the available memory size for the pool.

Examples: odp_bench_timer.c, odp_sysinfo.c, odp_timer_accuracy.c, odp_timer_perf.c, and odp_timer_stress.c.

Definition at line 173 of file api/spec/timer_types.h.

◆ highest_res_ns

uint64_t odp_timer_capability_t::highest_res_ns

Highest timer resolution in nanoseconds.

This defines the highest resolution supported by a timer. It's the minimum valid value for 'res_ns' timer pool parameter.

This value is equal to 'max_res.res_ns' capability.

Examples: odp_sched_pktio.c, odp_sysinfo.c, odp_timer_simple.c, and odp_timer_stress.c.

Definition at line 183 of file api/spec/timer_types.h.

◆ max_res

odp_timer_res_capability_t odp_timer_capability_t::max_res

Maximum resolution.

This defines the highest resolution supported by a timer, with limits to min/max timeout values. The highest resolution for a timer pool is defined by 'max_res.res_ns' in nanoseconds and 'max_res.res_hz' in hertz. When this resolution is used:

'min_tmo' parameter value must be in minimum 'max_res.min_tmo'
'max_tmo' parameter value must be in maximum 'max_res.max_tmo'

Examples: odp_bench_timer.c, odp_sysinfo.c, odp_timer_accuracy.c, and odp_timer_perf.c.

Definition at line 196 of file api/spec/timer_types.h.

◆ max_tmo

odp_timer_res_capability_t odp_timer_capability_t::max_tmo

Maximum timeout length.

This defines the maximum relative timeout value supported by a timer, with limits to min timeout and max resolution values. The maximum value for 'max_tmo' timer pool parameter is defined by 'max_tmo.max_tmo'. When this max timeout value is used:

'min_tmo' parameter value must be in minimum 'max_tmo.min_tmo'
'res_ns' parameter value must be in minimum 'max_tmo.res_ns' or
'res_hz' parameter value must be in maximum 'max_tmo.res_hz'

Examples: odp_debug.c, and odp_sysinfo.c.

Definition at line 209 of file api/spec/timer_types.h.

◆ queue_type_sched

odp_bool_t odp_timer_capability_t::queue_type_sched

Scheduled queue destination support.

This defines whether schedule queues are supported as timeout destination queues. 0: Scheduled queues are not supported as timeout destination queues 1: Scheduled queues are supported as timeout destination queues

See also: odp_timer_alloc()

Examples: odp_bench_timer.c, odp_debug.c, odp_stress.c, odp_sysinfo.c, and odp_timer_stress.c.

Definition at line 220 of file api/spec/timer_types.h.

◆ queue_type_plain

odp_bool_t odp_timer_capability_t::queue_type_plain

Plain queue destination support.

This defines whether plain queues are supported as timeout destination queues. 0: Plain queues are not supported as timeout destination queues 1: Plain queues are supported as timeout destination queues