Functions
void	arch_busy_wait (uint32_t usec_to_wait)
	Architecture-specific implementation of busy-waiting.

static uint32_t	arch_k_cycle_get_32 (void)
	Obtain the current cycle count, in units specified by CONFIG_SYS_CLOCK_HW_CYCLES_PER_SEC.

static uint64_t	arch_k_cycle_get_64 (void)
	As for arch_k_cycle_get_32(), but with a 64 bit return value.

void	arch_timing_init (void)
	Initialize the timing subsystem.

void	arch_timing_start (void)
	Signal the start of the timing information gathering.

void	arch_timing_stop (void)
	Signal the end of the timing information gathering.

timing_t	arch_timing_counter_get (void)
	Return timing counter.

uint64_t	arch_timing_cycles_get (volatile timing_t const start, volatile timing_t const end)
	Get number of cycles between `start` and `end`.

uint64_t	arch_timing_freq_get (void)
	Get frequency of counter used (in Hz).

uint64_t	arch_timing_cycles_to_ns (uint64_t cycles)
	Convert number of `cycles` into nanoseconds.

uint64_t	arch_timing_cycles_to_ns_avg (uint64_t cycles, uint32_t count)
	Convert number of `cycles` into nanoseconds with averaging.

uint32_t	arch_timing_freq_get_mhz (void)
	Get frequency of counter used (in MHz).

Detailed Description

Function Documentation

◆ arch_busy_wait()

void arch_busy_wait ( uint32_t usec_to_wait )

#include <kernel/include/kernel_arch_interface.h>

Architecture-specific implementation of busy-waiting.

Parameters

usec_to_wait Wait period, in microseconds

◆ arch_k_cycle_get_32()

static uint32_t arch_k_cycle_get_32 ( void )

inlinestatic

#include <include/zephyr/sys/arch_interface.h>

Obtain the current cycle count, in units specified by CONFIG_SYS_CLOCK_HW_CYCLES_PER_SEC.

While this is historically specified as part of the architecture API, in practice virtually all platforms forward it to the sys_clock_cycle_get_32() API provided by the timer driver.

See also: k_cycle_get_32()

Returns: The current cycle time. This should count up monotonically through the full 32 bit space, wrapping at 0xffffffff. Hardware with fewer bits of precision in the timer is expected to synthesize a 32 bit count.

◆ arch_k_cycle_get_64()

static uint64_t arch_k_cycle_get_64 ( void )

inlinestatic

#include <include/zephyr/sys/arch_interface.h>

As for arch_k_cycle_get_32(), but with a 64 bit return value.

Not all timer hardware has a 64 bit timer, this needs to be implemented only if CONFIG_TIMER_HAS_64BIT_CYCLE_COUNTER is set.

See also: arch_k_cycle_get_32()

Returns: The current cycle time. This should count up monotonically through the full 64 bit space, wrapping at 2^64-1. Hardware with fewer bits of precision in the timer is generally not expected to implement this API.

◆ arch_timing_counter_get()

timing_t arch_timing_counter_get ( void )

#include <include/zephyr/sys/arch_interface.h>

Return timing counter.

Note: Any call to arch_timing_counter_get() must be done between calls to arch_timing_start() and arch_timing_stop(), and on the same CPU core.; Not all platforms have a timing counter with 64 bit precision. It is possible to see this value "go backwards" due to internal rollover. Timing code must be prepared to address the rollover (with platform-dependent code, e.g. by casting to a uint32_t before subtraction) or by using arch_timing_cycles_get() which is required to understand the distinction.

Returns: Timing counter.

See also: timing_counter_get()

◆ arch_timing_cycles_get()

uint64_t arch_timing_cycles_get	(	volatile timing_t *const	start,
		volatile timing_t *const	end
	)

#include <include/zephyr/sys/arch_interface.h>

Get number of cycles between start and end.

For some architectures or SoCs, the raw numbers from counter need to be scaled to obtain actual number of cycles, or may roll over internally. This function computes a positive-definite interval between two returned cycle values.

Parameters