Detailed Description

Interface for the Port Output Enable for GPT.

Defines the API and data structures for the Port Output Enable for GPT (POEG) interface.

Summary

The POEG disables GPT output pins based on configurable events.

Classes
struct	st_poeg_status

struct	st_poeg_callback_args

struct	st_poeg_cfg

struct	st_poeg_api

struct	st_poeg_instance

Typedefs
typedef struct st_poeg_status	poeg_status_t

typedef struct st_poeg_callback_args	poeg_callback_args_t

typedef void	poeg_ctrl_t

typedef struct st_poeg_cfg	poeg_cfg_t

typedef struct st_poeg_api	poeg_api_t

typedef struct st_poeg_instance	poeg_instance_t

Enumerations
enum	poeg_state_t

enum	poeg_trigger_t

enum	poeg_gtetrg_polarity_t

enum	poeg_gtetrg_noise_filter_t

Class Documentation

◆ RZN::st_poeg_status

struct RZN::st_poeg_status

POEG status

Class Members
poeg_state_t	state	Current state of POEG.

◆ RZN::st_poeg_callback_args

struct RZN::st_poeg_callback_args

Callback function parameter data.

Class Members
void *	p_context	Placeholder for user data, set in poeg_cfg_t.

◆ RZN::st_poeg_cfg

struct RZN::st_poeg_cfg

User configuration structure, used in the open function.

Public Attributes
poeg_trigger_t	trigger
	Select one or more triggers for the POEG.

poeg_gtetrg_polarity_t	polarity
	Select the polarity for the GTETRG pin.

poeg_gtetrg_noise_filter_t	noise_filter
	Configure the GTETRG noise filter.

void(*	p_callback )(poeg_callback_args_t *p_args)

void *	p_context

uint32_t	unit
	POEG unit to be used.

uint32_t	channel
	Channel 0 corresponds to GTETRGA, 1 to GTETRGB, etc.

IRQn_Type	irq
	Interrupt number assigned to this instance.

uint8_t	ipl
	POEG interrupt priority.

void const *	p_extend
	Extension parameter for hardware specific settings.

Member Data Documentation

◆ p_callback

void(* p_callback) (poeg_callback_args_t *p_args)

Callback called when a POEG interrupt occurs.

◆ p_context

void* p_context

Placeholder for user data. Passed to the user callback in poeg_callback_args_t.

◆ RZN::st_poeg_api

struct RZN::st_poeg_api

Port Output Enable for GPT (POEG) API structure. POEG functions implemented at the HAL layer will follow this API.

Public Attributes
fsp_err_t(*	open )(poeg_ctrl_t const p_ctrl, poeg_cfg_t const const p_cfg)

fsp_err_t(*	statusGet )(poeg_ctrl_t const p_ctrl, poeg_status_t p_status)

fsp_err_t(*	callbackSet )(poeg_ctrl_t const p_ctrl, void(p_callback)(poeg_callback_args_t ), void const p_context, poeg_callback_args_t *const p_callback_memory)

fsp_err_t(*	outputDisable )(poeg_ctrl_t *const p_ctrl)

fsp_err_t(*	reset )(poeg_ctrl_t *const p_ctrl)

fsp_err_t(*	close )(poeg_ctrl_t *const p_ctrl)

Member Data Documentation

◆ open

fsp_err_t(* open) (poeg_ctrl_t *const p_ctrl, poeg_cfg_t const *const p_cfg)

Initial configuration.

Parameters

[in]	p_ctrl	Pointer to control block. Must be declared by user. Elements set here.
[in]	p_cfg	Pointer to configuration structure. All elements of this structure must be set by user.

◆ statusGet

fsp_err_t(* statusGet) (poeg_ctrl_t *const p_ctrl, poeg_status_t *p_status)

Gets the current driver state.

Parameters

[in]	p_ctrl	Control block set in poeg_api_t::open call.
[out]	p_status	Provides the current state of the POEG.

◆ callbackSet

fsp_err_t(* callbackSet) (poeg_ctrl_t *const p_ctrl, void(*p_callback)(poeg_callback_args_t *), void *const p_context, poeg_callback_args_t *const p_callback_memory)

Specify callback function and optional context pointer and working memory pointer.

Parameters

[in]	p_ctrl	Control block set in poeg_api_t::open call for this timer.
[in]	p_callback	Callback function to register
[in]	p_context	Pointer to send to callback function
[in]	p_working_memory	Pointer to volatile memory where callback structure can be allocated. Callback arguments allocated here are only valid during the callback.

◆ outputDisable

fsp_err_t(* outputDisable) (poeg_ctrl_t *const p_ctrl)

Disables GPT output pins by software request.

Parameters

[in] p_ctrl Control block set in poeg_api_t::open call.

◆ reset

fsp_err_t(* reset) (poeg_ctrl_t *const p_ctrl)

Attempts to clear status flags to reenable GPT output pins. Confirm all status flags are cleared after calling this function by calling poeg_api_t::statusGet().

Parameters

[in] p_ctrl Control block set in poeg_api_t::open call.

◆ close

fsp_err_t(* close) (poeg_ctrl_t *const p_ctrl)

Disables POEG interrupt.

Parameters

[in] p_ctrl Control block set in poeg_api_t::open call.

◆ RZN::st_poeg_instance

struct RZN::st_poeg_instance

This structure encompasses everything that is needed to use an instance of this interface.

Class Members
poeg_ctrl_t *	p_ctrl	Pointer to the control structure for this instance.
poeg_cfg_t const *	p_cfg	Pointer to the configuration structure for this instance.
poeg_api_t const *	p_api	Pointer to the API structure for this instance.

Typedef Documentation

◆ poeg_status_t

typedef struct st_poeg_status poeg_status_t

POEG status Please refer to the struct st_poeg_status.

◆ poeg_callback_args_t

typedef struct st_poeg_callback_args poeg_callback_args_t

Callback function parameter data. Please refer to the struct st_poeg_callback_args.

◆ poeg_ctrl_t

typedef void poeg_ctrl_t

POEG control block. Allocate an instance specific control block to pass into the POEG API calls.

◆ poeg_cfg_t

typedef struct st_poeg_cfg poeg_cfg_t

User configuration structure, used in the open function. Please refer to the struct st_poeg_cfg.

◆ poeg_api_t

typedef struct st_poeg_api poeg_api_t

Port Output Enable for GPT (POEG) API structure. POEG functions implemented at the HAL layer will follow this API. Please refer to the struct st_poeg_api.

◆ poeg_instance_t

typedef struct st_poeg_instance poeg_instance_t

This structure encompasses everything that is needed to use an instance of this interface. Please refer to the struct st_poeg_instance.

Enumeration Type Documentation

◆ poeg_state_t

enum poeg_state_t

POEG states.

Enumerator
POEG_STATE_NO_DISABLE_REQUEST	GPT output is not disabled by POEG.
POEG_STATE_PIN_DISABLE_REQUEST	GPT output disabled due to GTETRG pin level.
POEG_STATE_GPT_OR_COMPARATOR_DISABLE_REQUEST	GPT output disabled due to high speed analog comparator or GPT.
POEG_STATE_OSCILLATION_STOP_DISABLE_REQUEST	GPT output disabled due to main oscillator stop.
POEG_STATE_SOFTWARE_STOP_DISABLE_REQUEST	GPT output disabled due to poeg_api_t::outputDisable()
POEG_STATE_PIN_DISABLE_REQUEST_ACTIVE	GPT output disable request active from the GTETRG pin. If a filter is used, this flag represents the state of the filtered input.
POEG_STATE_NO_DISABLE_REQUEST	GPT output is not disabled by POEG.
POEG_STATE_PIN_DISABLE_REQUEST	GPT output disabled due to GTETRG pin level.
POEG_STATE_GPT_OR_COMPARATOR_DISABLE_REQUEST	GPT output disabled due to high speed analog comparator or GPT.
POEG_STATE_OSCILLATION_STOP_DISABLE_REQUEST	GPT output disabled due to main oscillator stop.
POEG_STATE_SOFTWARE_STOP_DISABLE_REQUEST	GPT output disabled due to poeg_api_t::outputDisable()
POEG_STATE_DSMIF0_DISABLE_REQUEST	GPT output disabled due to DSMIF0 error 0.
POEG_STATE_DSMIF1_DISABLE_REQUEST	GPT output disabled due to DSMIF1 error 0.
POEG_STATE_DSMIF2_DISABLE_REQUEST	GPT output disabled due to DSMIF2 error 0.
POEG_STATE_DSMIF3_DISABLE_REQUEST	GPT output disabled due to DSMIF3 error 0.
POEG_STATE_DSMIF4_DISABLE_REQUEST	GPT output disabled due to DSMIF4 error 0.
POEG_STATE_DSMIF5_DISABLE_REQUEST	GPT output disabled due to DSMIF5 error 0.
POEG_STATE_DSMIF7_DISABLE_REQUEST	GPT output disabled due to DSMIF7 error 0.
POEG_STATE_DSMIF8_DISABLE_REQUEST	GPT output disabled due to DSMIF8 error 0.
POEG_STATE_PIN_DISABLE_REQUEST_ACTIVE	GPT output disable request active from the GTETRG pin. If a filter is used, this flag represents the state of the filtered input.
POEG_STATE_DSMIF0_1_DISABLE_REQUEST	GPT output disabled due to DSMIF0 error 1.
POEG_STATE_DSMIF1_1_DISABLE_REQUEST	GPT output disabled due to DSMIF1 error 1.
POEG_STATE_DSMIF2_1_DISABLE_REQUEST	GPT output disabled due to DSMIF2 error 1.
POEG_STATE_DSMIF3_1_DISABLE_REQUEST	GPT output disabled due to DSMIF3 error 1.
POEG_STATE_DSMIF4_1_DISABLE_REQUEST	GPT output disabled due to DSMIF4 error 1.
POEG_STATE_DSMIF5_1_DISABLE_REQUEST	GPT output disabled due to DSMIF5 error 1.
POEG_STATE_DSMIF7_1_DISABLE_REQUEST	GPT output disabled due to DSMIF7 error 1.
POEG_STATE_DSMIF8_1_DISABLE_REQUEST	GPT output disabled due to DSMIF8 error 1.
POEG_STATE_NO_DISABLE_REQUEST	GPT output is not disabled by POEG.
POEG_STATE_PIN_DISABLE_REQUEST	GPT output disabled due to GTETRG pin level.
POEG_STATE_GPT_OR_COMPARATOR_DISABLE_REQUEST	GPT output disabled due to high speed analog comparator or GPT.
POEG_STATE_OSCILLATION_STOP_DISABLE_REQUEST	GPT output disabled due to main oscillator stop.
POEG_STATE_SOFTWARE_STOP_DISABLE_REQUEST	GPT output disabled due to poeg_api_t::outputDisable()
POEG_STATE_PIN_DISABLE_REQUEST_ACTIVE	GPT output disable request active from the GTETRG pin. If a filter is used, this flag represents the state of the filtered input.
POEG_STATE_DSMIF0_DISABLE_REQUEST	GPT output disabled due to DSMIF0 error 0.
POEG_STATE_DSMIF1_DISABLE_REQUEST	GPT output disabled due to DSMIF1 error 0.

◆ poeg_trigger_t

enum poeg_trigger_t

Triggers that will disable GPT output pins.

Enumerator
POEG_TRIGGER_SOFTWARE	Software disable is always supported with POEG. Select this option if no other triggers are used.
POEG_TRIGGER_PIN	Disable GPT output based on GTETRG input level. Disable GPT output based on GTETRG input level(PIDE)
POEG_TRIGGER_GPT_OUTPUT_LEVEL	Disable GPT output based on GPT output pin levels. Disable GPT output based on GPT output pin levels(IOCE)
POEG_TRIGGER_OSCILLATION_STOP	Disable GPT output based on main oscillator stop. Disable GPT output based on main oscillator stop(OSPTE)
POEG_TRIGGER_ACMPHS0	Disable GPT output based on ACMPHS0 comparator result.
POEG_TRIGGER_ACMPHS1	Disable GPT output based on ACMPHS1 comparator result.
POEG_TRIGGER_ACMPHS2	Disable GPT output based on ACMPHS2 comparator result.
POEG_TRIGGER_ACMPHS3	Disable GPT output based on ACMPHS3 comparator result.
POEG_TRIGGER_ACMPHS4	Disable GPT output based on ACMPHS4 comparator result.
POEG_TRIGGER_ACMPHS5	Disable GPT output based on ACMPHS5 comparator result.
POEG_TRIGGER_SOFTWARE	Software disable is always supported with POEG. Select this option if no other triggers are used.
POEG_TRIGGER_PIN	Disable GPT output based on GTETRG input level. Disable GPT output based on GTETRG input level(PIDE)
POEG_TRIGGER_GPT_OUTPUT_LEVEL	Disable GPT output based on GPT output pin levels. Disable GPT output based on GPT output pin levels(IOCE)
POEG_TRIGGER_OSCILLATION_STOP	Disable GPT output based on main oscillator stop. Disable GPT output based on main oscillator stop(OSPTE)
POEG_TRIGGER_ACMPHS0	Disable GPT output based on ACMPHS0 comparator result.
POEG_TRIGGER_ACMPHS1	Disable GPT output based on ACMPHS1 comparator result.
POEG_TRIGGER_ACMPHS2	Disable GPT output based on ACMPHS2 comparator result.
POEG_TRIGGER_ACMPHS3	Disable GPT output based on ACMPHS3 comparator result.
POEG_TRIGGER_ACMPHS4	Disable GPT output based on ACMPHS4 comparator result.
POEG_TRIGGER_ACMPHS5	Disable GPT output based on ACMPHS5 comparator result.
POEG_TRIGGER_D0ERR0E	Permit output disabled by DSMIF0 error detection. The GPT output pins can be disabled when DSMIF error occurs (LLPP only).
POEG_TRIGGER_D1ERR0E	Permit output disabled by DSMIF1 error detection.
POEG_TRIGGER_D2ERR0E	Permit output disabled by DSMIF2 error detection.
POEG_TRIGGER_D3ERR0E	Permit output disabled by DSMIF3 error detection.
POEG_TRIGGER_D4ERR0E	Permit output disabled by DSMIF4 error detection.
POEG_TRIGGER_D5ERR0E	Permit output disabled by DSMIF5 error detection.
POEG_TRIGGER_D7ERR0E	Permit output disabled by DSMIF7 error detection.
POEG_TRIGGER_D8ERR0E	Permit output disabled by DSMIF8 error detection.
POEG_TRIGGER_D0ERR1E	Permit output disabled by DSMIF0 error 1 detection.
POEG_TRIGGER_D1ERR1E	Permit output disabled by DSMIF1 error 1 detection.
POEG_TRIGGER_D2ERR1E	Permit output disabled by DSMIF2 error 1 detection.
POEG_TRIGGER_D3ERR1E	Permit output disabled by DSMIF3 error 1 detection.
POEG_TRIGGER_D4ERR1E	Permit output disabled by DSMIF4 error 1 detection.
POEG_TRIGGER_D5ERR1E	Permit output disabled by DSMIF5 error 1 detection.
POEG_TRIGGER_D7ERR1E	Permit output disabled by DSMIF7 error 1 detection.
POEG_TRIGGER_D8ERR1E	Permit output disabled by DSMIF8 error 1 detection.
POEG_TRIGGER_SOFTWARE	Software disable is always supported with POEG. Select this option if no other triggers are used.
POEG_TRIGGER_PIN	Disable GPT output based on GTETRG input level. Disable GPT output based on GTETRG input level(PIDE)
POEG_TRIGGER_GPT_OUTPUT_LEVEL	Disable GPT output based on GPT output pin levels. Disable GPT output based on GPT output pin levels(IOCE)
POEG_TRIGGER_OSCILLATION_STOP	Disable GPT output based on main oscillator stop. Disable GPT output based on main oscillator stop(OSPTE)
POEG_TRIGGER_ACMPHS0	Disable GPT output based on ACMPHS0 comparator result.
POEG_TRIGGER_ACMPHS1	Disable GPT output based on ACMPHS1 comparator result.
POEG_TRIGGER_ACMPHS2	Disable GPT output based on ACMPHS2 comparator result.
POEG_TRIGGER_ACMPHS3	Disable GPT output based on ACMPHS3 comparator result.
POEG_TRIGGER_ACMPHS4	Disable GPT output based on ACMPHS4 comparator result.
POEG_TRIGGER_ACMPHS5	Disable GPT output based on ACMPHS5 comparator result.
POEG_TRIGGER_DERR0E	Permit output disabled by DSMIF0 error detection. The GPT output pins can be disabled when DSMIF error occurs (LLPP only).
POEG_TRIGGER_DERR1E	Permit output disabled by DSMIF1 error detection.

◆ poeg_gtetrg_polarity_t

enum poeg_gtetrg_polarity_t

GTETRG polarity.

Enumerator
POEG_GTETRG_POLARITY_ACTIVE_HIGH	Disable GPT output based when GTETRG input level is high.
POEG_GTETRG_POLARITY_ACTIVE_LOW	Disable GPT output based when GTETRG input level is low.

◆ poeg_gtetrg_noise_filter_t

enum poeg_gtetrg_noise_filter_t

GTETRG noise filter. For the input signal to pass through the noise filter, the active level set in poeg_gtetrg_polarity_t must be read 3 consecutive times at the sampling clock selected.

Enumerator
POEG_GTETRG_NOISE_FILTER_DISABLED	No noise filter applied to GTETRG input.
POEG_GTETRG_NOISE_FILTER_CLK_SOURCE_DIV_1	Apply noise filter with sample clock equal to Clock source/1.
POEG_GTETRG_NOISE_FILTER_CLK_SOURCE_DIV_8	Apply noise filter with sample clock equal to Clock source/8.
POEG_GTETRG_NOISE_FILTER_CLK_SOURCE_DIV_32	Apply noise filter with sample clock equal to Clock source/32.
POEG_GTETRG_NOISE_FILTER_CLK_SOURCE_DIV_128	Apply noise filter with sample clock equal to Clock source/128.

Detailed Description

Summary

Classes

Typedefs

Enumerations

Class Documentation

◆ RZN::st_poeg_status

◆ RZN::st_poeg_callback_args

◆ RZN::st_poeg_cfg

Public Attributes

Member Data Documentation

◆ p_callback

◆ p_context

◆ RZN::st_poeg_api

Public Attributes

Member Data Documentation

◆ open

◆ statusGet

◆ callbackSet

◆ outputDisable

◆ reset

◆ close

◆ RZN::st_poeg_instance

Typedef Documentation

◆ poeg_status_t

◆ poeg_callback_args_t

◆ poeg_ctrl_t

◆ poeg_cfg_t

◆ poeg_api_t

◆ poeg_instance_t

Enumeration Type Documentation

◆ poeg_state_t

◆ poeg_trigger_t

◆ poeg_gtetrg_polarity_t

◆ poeg_gtetrg_noise_filter_t