PDGO driver APIs. More...

Functions
static void	pdgo_set_turnoff_counter (PDGO_Type *ptr, uint32_t counter)
	Set DGO turn-off counter. More...

static void	pdgo_enable_wkup_software_wakeup (PDGO_Type *ptr)
	Enable wakeup pin or software wakeup. More...

static void	pdgo_disable_wkup_software_wakeup (PDGO_Type *ptr)
	Disable wakeup pin or software wakeup. More...

static void	pdgo_enable_oneshot_wakeup (PDGO_Type *ptr)
	Set DGO to one-shot wakeup mode. More...

static void	pdgo_enable_retention_mode (PDGO_Type *ptr)
	Enable DGO register retention mode. More...

static bool	pdgo_is_retention_mode_enabled (PDGO_Type *ptr)
	Check whether the DGO retention mode is enabled or not. More...

static void	pdgo_disable_retention_mode (PDGO_Type *ptr)
	Disable DGO register retention mode. More...

static void	pdgo_enable_auto_wakeup (PDGO_Type *ptr)
	Set DGO to automatic wakeup mode. More...

static bool	pdgo_is_pin_wakeup (PDGO_Type *ptr)
	Check whether DGO is waked up by Wake-up/Reset Pin. More...

static bool	pdgo_is_auto_wakeup_enabled (PDGO_Type *ptr)
	Check whether Auto wake-up is enabled. More...

static void	pdgo_enable_pullup_resistor_for_reset_pin (PDGO_Type *ptr)
	Enable pull-up resistor for Reset Pin [in] ptr DGO base address. More...

static void	pdgo_disable_pullup_resistor_for_reset_pin (PDGO_Type *ptr)
	Disable pull-up resistor for Reset Pin [in] ptr DGO base address. More...

static void	pdgo_enable_pulldown_resistor_for_wakeup_pin (PDGO_Type *ptr)

static void	pdgo_disable_pulldown_resistor_for_wakeup_pin (PDGO_Type *ptr)

static void	pdgo_set_wakeup_counter (PDGO_Type *ptr, uint32_t wakeup_ctr)
	Set DGO wakeup counter. More...

static uint32_t	pdgo_get_wakeup_counter (PDGO_Type *ptr)
	Get DGO wakeup counter value. More...

static void	pdgo_write_gpr (PDGO_Type *ptr, uint32_t index, uint32_t content)
	Write data to DGO GPR register. More...

static uint32_t	pdgo_read_gpr (PDGO_Type *ptr, uint32_t index)
	Read data from DGO GPR register. More...

static uint32_t	pdgo_get_wakeup_counter_from_us (uint32_t us)
	Convert the microsecond to DGO Wake-up counter value. More...

static uint32_t	pdgo_get_us_from_wakeup_counter (uint32_t counter)
	Convert the DGO Wake-up counter to microseconds. More...

static uint32_t	pdgo_get_turnoff_counter_from_us (uint32_t us)
	Convert the microsecond to DGO Turn-off counter value. More...

static uint32_t	pdgo_get_us_from_turnoff_counter (uint32_t counter)
	Convert the DGO Turn-off counter to microseconds. More...

static void	pdgo_enable_software_wakeup (PDGO_Type *ptr)
	Enable Software Wake-up feature on DGO. More...

static void	pdgo_disable_software_wakeup (PDGO_Type *ptr)
	Disable Software Wake-up feature on DGO. More...

static void	pdgo_set_cycle_wakeup_counter (PDGO_Type *ptr, uint32_t counter)
	Set DGO cycle wakeup counter. More...

static void	pdgo_enable_wkup_pin_wakeup (PDGO_Type *ptr)
	Enable wkup pin Wake-up feature on DGO. More...

static void	pdgo_disable_wkup_pin_wakeup (PDGO_Type *ptr)
	Disable wkup pin Wake-up feature on DGO. More...

static void	pdgo_enable_wuio_pins_wakeup (PDGO_Type *ptr)
	Enable wuio pins Wake-up feature on DGO. More...

static void	pdgo_disable_wuio_pins_wakeup (PDGO_Type *ptr)
	Disable wuio pins Wake-up feature on DGO. More...

static void	pdgo_enable_pulse_capture0_wakeup (PDGO_Type *ptr)
	Enable pulse capture0 Wake-up feature on DGO. More...

static void	pdgo_disable_pulse_capture0_wakeup (PDGO_Type *ptr)
	Disable pulse capture0 Wake-up feature on DGO. More...

static void	pdgo_enable_pulse_counter0_wakeup (PDGO_Type *ptr)
	Enable pulse counter0 Wake-up feature on DGO. More...

static void	pdgo_disable_pulse_counter0_wakeup (PDGO_Type *ptr)
	Disable pulse counter0 Wake-up feature on DGO. More...

static void	pdgo_enable_wakeup_by_bit_mask (PDGO_Type *ptr, uint32_t mask)
	Enable Wake-up by bit mask. More...

static void	pdgo_disable_wakeup_by_bit_mask (PDGO_Type *ptr, uint32_t mask)
	Disable Wake-up by bit mask. More...

static uint32_t	pdgo_get_wakeup_status (PDGO_Type *ptr)
	Get Wake-up status. More...

static void	pdgo_clear_wakeup_status (PDGO_Type *ptr, uint32_t mask)
	Clear Wake-up status. More...

static void	pdgo_disable_all_irq (PDGO_Type *ptr)
	Disable DGO all interrupts. More...

static void	pdgo_enable_irq0_by_bit_mask (PDGO_Type *ptr, dgo_irq0_bit_mask_t mask)
	Enable DGO interrupt0 by bit mask. More...

static void	pdgo_disable_irq0_by_bit_mask (PDGO_Type *ptr, dgo_irq0_bit_mask_t mask)
	Disable DGO interrupt0 by bit mask. More...

static uint32_t	pdgo_get_irq0_en (PDGO_Type *ptr)
	Get DGO interrupt0 enable status. More...

static uint32_t	pdgo_get_irq0_status (PDGO_Type *ptr)
	Get irq0 status. More...

static void	pdgo_clear_irq0_status (PDGO_Type *ptr, uint32_t mask)
	Clear irq0 status. More...

static void	pdgo_enable_irq1_by_bit_mask (PDGO_Type *ptr, dgo_irq1_bit_mask_t mask)
	Enable DGO interrupt1 by bit mask. More...

static void	pdgo_disable_irq1_by_bit_mask (PDGO_Type *ptr, dgo_irq1_bit_mask_t mask)
	Disable DGO interrupt1 by bit mask. More...

static uint32_t	pdgo_get_irq1_en (PDGO_Type *ptr)
	Get DGO interrupt1 enable status. More...

static uint32_t	pdgo_get_irq1_status (PDGO_Type *ptr)
	Get irq1 status. More...

static void	pdgo_clear_irq1_status (PDGO_Type *ptr, uint32_t mask)
	Clear irq1 status. More...

static void	pdgo_enable_pulldown_resistor_for_wuio_pin (PDGO_Type *ptr, dgo_wuio_pin_num_t num)

static void	pdgo_disable_pulldown_resistor_for_wuio_pin (PDGO_Type *ptr, dgo_wuio_pin_num_t num)

static void	pdgo_set_wuio_pin_enable (PDGO_Type *ptr, dgo_wuio_pin_num_t num, bool enable)
	Set WUIO pin enable. More...

static void	pdgo_set_pcap_enable (PDGO_Type *ptr, dgo_pcap_num_t num, bool enable)
	Set PCAP enable. More...

static void	pdgo_set_pcap_counter_value (PDGO_Type *ptr, dgo_pcap_num_t num, uint16_t value)
	Set PCAP counter value. More...

static uint16_t	pdgo_get_pcap_counter_value (PDGO_Type *ptr, dgo_pcap_num_t num)
	Get PCAP counter value. More...

static void	pdgo_set_pcnt_enable (PDGO_Type *ptr, dgo_pcnt_num_t num, bool enable)
	Set PCNT enable. More...

static void	pdgo_set_pcnt_cmp_mode (PDGO_Type *ptr, dgo_pcnt_num_t num, dgo_pcnt_cmp_mode_t mode)
	Set PCNT cmp mode. More...

static void	pdgo_set_pcnt_cmp0_value (PDGO_Type *ptr, dgo_pcnt_num_t num, uint32_t value)
	Set PCNT cmp0 value. More...

static void	pdgo_set_pcnt_cmp1_value (PDGO_Type *ptr, dgo_pcnt_num_t num, uint32_t value)
	Set PCNT cmp1 value. More...

static void	pdgo_set_pcnt_raw_counter_value (PDGO_Type *ptr, dgo_pcnt_num_t num, uint32_t value)
	Set PCNT raw counter value. More...

static uint32_t	pdgo_get_pcnt_raw_counter_value (PDGO_Type *ptr, dgo_pcnt_num_t num)
	Get PCNT raw counter value. More...

static void	pdgo_enable_pcnt_dir_override (PDGO_Type *ptr, dgo_pcnt_num_t num)
	Enable PCNT dir override. More...

static void	pdgo_disable_pcnt_dir_override (PDGO_Type *ptr, dgo_pcnt_num_t num)
	Disable PCNT dir override. More...

static void	pdgo_set_pcnt_dir_override_value (PDGO_Type *ptr, dgo_pcnt_num_t num, bool reverse)
	Set PCNT dir override value. More...

void	pdgo_config_wuio_filter (PDGO_Type ptr, dgo_wuio_pin_num_t num, dgo_wuio_filter_cfg_t cfg)
	Config wakeup IO filter. More...

void	pdgo_config_pcap (PDGO_Type ptr, dgo_pcap_num_t num, dgo_pcap_cfg_t cfg)
	Config pulse capture. More...

void	pdgo_get_pcnt_defconfig (PDGO_Type ptr, dgo_pcnt_num_t num, dgo_pcnt_cfg_t cfg)
	Get pulse capture default config. More...

void	pdgo_config_pcnt (PDGO_Type ptr, dgo_pcnt_num_t num, dgo_pcnt_cfg_t cfg)
	Config pulse capture. More...

void	pdgo_get_pcnt_counter (PDGO_Type ptr, dgo_pcnt_num_t num, dgo_pcnt_counter_t counter)
	Get PCNT counter. More...

uint32_t	pdgo_convert_pcnt_counter (PDGO_Type ptr, dgo_pcnt_num_t num, dgo_pcnt_counter_t counter)
	Convert PCNT counter to raw counter value. More...

void	pdgo_config_pcnt_range_compare (PDGO_Type *ptr, dgo_pcnt_num_t num, uint32_t cmp0, uint32_t cmp1)
	Config PCNT range compare. More...

float	pdgo_calc_pcnt_tacho_cycles_per_line (PDGO_Type *ptr, dgo_pcnt_num_t num)
	Calculate PCNT tacho, unit: cycles per line. More...

Detailed Description

PDGO driver APIs.

Function Documentation

◆ pdgo_calc_pcnt_tacho_cycles_per_line()

float pdgo_calc_pcnt_tacho_cycles_per_line	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num
	)

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Calculate PCNT tacho, unit: cycles per line.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t

Returns: tacho calculated value, unit: cycles per line

◆ pdgo_clear_irq0_status()

static void pdgo_clear_irq0_status	(	PDGO_Type *	ptr,
		uint32_t	mask
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Clear irq0 status.

Parameters

[in]	ptr	DGO base address
[in]	mask	dgo_irq0_bit_mask_t

◆ pdgo_clear_irq1_status()

static void pdgo_clear_irq1_status	(	PDGO_Type *	ptr,
		uint32_t	mask
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Clear irq1 status.

Parameters

[in]	ptr	DGO base address
[in]	mask	dgo_irq1_bit_mask_t

◆ pdgo_clear_wakeup_status()

static void pdgo_clear_wakeup_status	(	PDGO_Type *	ptr,
		uint32_t	mask
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Clear Wake-up status.

Parameters

[in]	ptr	DGO base address
[in]	mask	dgo_wakeup_bit_mask_t

◆ pdgo_config_pcap()

void pdgo_config_pcap	(	PDGO_Type *	ptr,
		dgo_pcap_num_t	num,
		dgo_pcap_cfg_t *	cfg
	)

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Config pulse capture.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcap_num_t
[in]	cfg	dgo_pcap_cfg_t

◆ pdgo_config_pcnt()

void pdgo_config_pcnt	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		dgo_pcnt_cfg_t *	cfg
	)

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Config pulse capture.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[in]	cfg	dgo_pcnt_cfg_t

◆ pdgo_config_pcnt_range_compare()

void pdgo_config_pcnt_range_compare	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		uint32_t	cmp0,
		uint32_t	cmp1
	)

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Config PCNT range compare.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[in]	cmp0	compare0 value
[in]	cmp1	compare1 value

◆ pdgo_config_wuio_filter()

void pdgo_config_wuio_filter	(	PDGO_Type *	ptr,
		dgo_wuio_pin_num_t	num,
		dgo_wuio_filter_cfg_t *	cfg
	)

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Config wakeup IO filter.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_wuio_pin_num_t
[in]	cfg	dgo_wuio_filter_cfg_t

◆ pdgo_convert_pcnt_counter()

uint32_t pdgo_convert_pcnt_counter	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		dgo_pcnt_counter_t *	counter
	)

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Convert PCNT counter to raw counter value.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[in]	counter	data. dgo_pcnt_counter_t

Returns: raw counter value

◆ pdgo_disable_all_irq()

static void pdgo_disable_all_irq ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable DGO all interrupts.

Parameters

[in] ptr DGO base address

◆ pdgo_disable_irq0_by_bit_mask()

static void pdgo_disable_irq0_by_bit_mask	(	PDGO_Type *	ptr,
		dgo_irq0_bit_mask_t	mask
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable DGO interrupt0 by bit mask.

Parameters

[in]	ptr	DGO base address
[in]	mask	dgo_irq0_bit_mask_t

◆ pdgo_disable_irq1_by_bit_mask()

static void pdgo_disable_irq1_by_bit_mask	(	PDGO_Type *	ptr,
		dgo_irq1_bit_mask_t	mask
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable DGO interrupt1 by bit mask.

Parameters

[in]	ptr	DGO base address
[in]	mask	dgo_irq1_bit_mask_t

◆ pdgo_disable_pcnt_dir_override()

static void pdgo_disable_pcnt_dir_override	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable PCNT dir override.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t

◆ pdgo_disable_pulldown_resistor_for_wakeup_pin()

static void pdgo_disable_pulldown_resistor_for_wakeup_pin ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Disable pull-down resistor for Wakeup pin [in] ptr DGO base address

◆ pdgo_disable_pulldown_resistor_for_wuio_pin()

static void pdgo_disable_pulldown_resistor_for_wuio_pin	(	PDGO_Type *	ptr,
		dgo_wuio_pin_num_t	num
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable pull-down resistor for Wakeup IO pin

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_wuio_pin_num_t

◆ pdgo_disable_pullup_resistor_for_reset_pin()

static void pdgo_disable_pullup_resistor_for_reset_pin ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Disable pull-up resistor for Reset Pin [in] ptr DGO base address.

◆ pdgo_disable_pulse_capture0_wakeup()

static void pdgo_disable_pulse_capture0_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable pulse capture0 Wake-up feature on DGO.

Parameters

[in] ptr DGO base address

◆ pdgo_disable_pulse_counter0_wakeup()

static void pdgo_disable_pulse_counter0_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable pulse counter0 Wake-up feature on DGO.

Parameters

[in] ptr DGO base address

◆ pdgo_disable_retention_mode()

static void pdgo_disable_retention_mode ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Disable DGO register retention mode.

Parameters

[in] ptr DGO base address

◆ pdgo_disable_software_wakeup()

static void pdgo_disable_software_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable Software Wake-up feature on DGO.

Parameters

[in] ptr DGO base address

◆ pdgo_disable_wakeup_by_bit_mask()

static void pdgo_disable_wakeup_by_bit_mask	(	PDGO_Type *	ptr,
		uint32_t	mask
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable Wake-up by bit mask.

Parameters

[in]	ptr	DGO base address
[in]	mask	dgo_wakeup_bit_mask_t

◆ pdgo_disable_wkup_pin_wakeup()

static void pdgo_disable_wkup_pin_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable wkup pin Wake-up feature on DGO.

Parameters

[in] ptr DGO base address

◆ pdgo_disable_wkup_software_wakeup()

static void pdgo_disable_wkup_software_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Disable wakeup pin or software wakeup.

Parameters

[in] ptr DGO base address

◆ pdgo_disable_wuio_pins_wakeup()

static void pdgo_disable_wuio_pins_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Disable wuio pins Wake-up feature on DGO.

Parameters

[in] ptr DGO base address

◆ pdgo_enable_auto_wakeup()

static void pdgo_enable_auto_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Set DGO to automatic wakeup mode.

Parameters

[in] ptr DGO base address

◆ pdgo_enable_irq0_by_bit_mask()

static void pdgo_enable_irq0_by_bit_mask	(	PDGO_Type *	ptr,
		dgo_irq0_bit_mask_t	mask
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Enable DGO interrupt0 by bit mask.

Parameters

[in]	ptr	DGO base address
[in]	mask	dgo_irq0_bit_mask_t

◆ pdgo_enable_irq1_by_bit_mask()

static void pdgo_enable_irq1_by_bit_mask	(	PDGO_Type *	ptr,
		dgo_irq1_bit_mask_t	mask
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Enable DGO interrupt1 by bit mask.

Parameters

[in]	ptr	DGO base address
[in]	mask	dgo_irq0_bit_mask_t

◆ pdgo_enable_oneshot_wakeup()

static void pdgo_enable_oneshot_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Set DGO to one-shot wakeup mode.

Parameters

[in] ptr DGO base address

◆ pdgo_enable_pcnt_dir_override()

static void pdgo_enable_pcnt_dir_override	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Enable PCNT dir override.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t

◆ pdgo_enable_pulldown_resistor_for_wakeup_pin()

static void pdgo_enable_pulldown_resistor_for_wakeup_pin ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Enable pull-down resistor for Wakeup pin [in] ptr DGO base address

◆ pdgo_enable_pulldown_resistor_for_wuio_pin()

static void pdgo_enable_pulldown_resistor_for_wuio_pin	(	PDGO_Type *	ptr,
		dgo_wuio_pin_num_t	num
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Enable pull-down resistor for Wakeup IO pin

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_wuio_pin_num_t

◆ pdgo_enable_pullup_resistor_for_reset_pin()

static void pdgo_enable_pullup_resistor_for_reset_pin ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Enable pull-up resistor for Reset Pin [in] ptr DGO base address.

◆ pdgo_enable_pulse_capture0_wakeup()

static void pdgo_enable_pulse_capture0_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Enable pulse capture0 Wake-up feature on DGO.

Parameters

[in] ptr DGO base address

◆ pdgo_enable_pulse_counter0_wakeup()

static void pdgo_enable_pulse_counter0_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Enable pulse counter0 Wake-up feature on DGO.

Parameters

[in] ptr DGO base address

◆ pdgo_enable_retention_mode()

static void pdgo_enable_retention_mode ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Enable DGO register retention mode.

Parameters

[in] ptr DGO base address

◆ pdgo_enable_software_wakeup()

static void pdgo_enable_software_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Enable Software Wake-up feature on DGO.

Parameters

[in] ptr DGO base address

◆ pdgo_enable_wakeup_by_bit_mask()

static void pdgo_enable_wakeup_by_bit_mask	(	PDGO_Type *	ptr,
		uint32_t	mask
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Enable Wake-up by bit mask.

Parameters

[in]	ptr	DGO base address
[in]	mask	dgo_wakeup_bit_mask_t

◆ pdgo_enable_wkup_pin_wakeup()

static void pdgo_enable_wkup_pin_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Enable wkup pin Wake-up feature on DGO.

Parameters

[in] ptr DGO base address

◆ pdgo_enable_wkup_software_wakeup()

static void pdgo_enable_wkup_software_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Enable wakeup pin or software wakeup.

Parameters

[in] ptr DGO base address

◆ pdgo_enable_wuio_pins_wakeup()

static void pdgo_enable_wuio_pins_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Enable wuio pins Wake-up feature on DGO.

Parameters

[in] ptr DGO base address

◆ pdgo_get_irq0_en()

static uint32_t pdgo_get_irq0_en ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Get DGO interrupt0 enable status.

Parameters

[in] ptr DGO base address

◆ pdgo_get_irq0_status()

static uint32_t pdgo_get_irq0_status ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Get irq0 status.

Parameters

[in] ptr DGO base address

Returns: DGO irq0 status, dgo_irq0_bit_mask_t

◆ pdgo_get_irq1_en()

static uint32_t pdgo_get_irq1_en ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Get DGO interrupt1 enable status.

Parameters

[in] ptr DGO base address

◆ pdgo_get_irq1_status()

static uint32_t pdgo_get_irq1_status ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Get irq1 status.

Parameters

[in] ptr DGO base address

Returns: DGO irq1 status, dgo_irq1_bit_mask_t

◆ pdgo_get_pcap_counter_value()

static uint16_t pdgo_get_pcap_counter_value	(	PDGO_Type *	ptr,
		dgo_pcap_num_t	num
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Get PCAP counter value.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcap_num_t

Returns: counter value

◆ pdgo_get_pcnt_counter()

void pdgo_get_pcnt_counter	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		dgo_pcnt_counter_t *	counter
	)

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Get PCNT counter.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[out]	counter	data. dgo_pcnt_counter_t

◆ pdgo_get_pcnt_defconfig()

void pdgo_get_pcnt_defconfig	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		dgo_pcnt_cfg_t *	cfg
	)

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Get pulse capture default config.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[out]	cfg	dgo_pcnt_cfg_t

◆ pdgo_get_pcnt_raw_counter_value()

static uint32_t pdgo_get_pcnt_raw_counter_value	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Get PCNT raw counter value.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t

Returns: counter value

◆ pdgo_get_turnoff_counter_from_us()

static uint32_t pdgo_get_turnoff_counter_from_us ( uint32_t us )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Convert the microsecond to DGO Turn-off counter value.

Parameters

[in] us microsecond to be converted

Returns: Converted DGO Turn-off counter value

< DGO Turn-off counter frequency

◆ pdgo_get_us_from_turnoff_counter()

static uint32_t pdgo_get_us_from_turnoff_counter ( uint32_t counter )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Convert the DGO Turn-off counter to microseconds.

Parameters

[in] counter DGO Turn-off counter

Returns: Converted microseconds

< DGO Turn-off counter frequency

◆ pdgo_get_us_from_wakeup_counter()

static uint32_t pdgo_get_us_from_wakeup_counter ( uint32_t counter )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Convert the DGO Wake-up counter to microseconds.

Parameters

[in] counter DGO counter

Returns: Converted microseconds

< DGO Wakeup Counter frequency

◆ pdgo_get_wakeup_counter()

static uint32_t pdgo_get_wakeup_counter ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Get DGO wakeup counter value.

Parameters

[in] ptr DGO base address

Returns: DGO wakeup counter value

◆ pdgo_get_wakeup_counter_from_us()

static uint32_t pdgo_get_wakeup_counter_from_us ( uint32_t us )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Convert the microsecond to DGO Wake-up counter value.

Parameters

[in] us microsecond to be converted

Returns: Converted DGO Wake-up counter value

< DGO Wakeup Counter frequency

◆ pdgo_get_wakeup_status()

static uint32_t pdgo_get_wakeup_status ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Get Wake-up status.

Parameters

[in] ptr DGO base address

Returns: DGO wakeup status, dgo_wakeup_bit_mask_t

◆ pdgo_is_auto_wakeup_enabled()

static bool pdgo_is_auto_wakeup_enabled ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Check whether Auto wake-up is enabled.

Parameters

[in] ptr DGO base address

Return values

true	- Auto wake-up is enabled
false	- Auto wake-up is disabled

◆ pdgo_is_pin_wakeup()

static bool pdgo_is_pin_wakeup ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Check whether DGO is waked up by Wake-up/Reset Pin.

Parameters

[in] ptr DGO base address

Return values

true	if DGO is waked up by Wakeup/Reset pin

◆ pdgo_is_retention_mode_enabled()

static bool pdgo_is_retention_mode_enabled ( PDGO_Type * ptr )

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Check whether the DGO retention mode is enabled or not.

Parameters

[in] ptr DGO base address

Return values

true	Retention mode is enabled
false	Retention mode is disabled

◆ pdgo_read_gpr()

static uint32_t pdgo_read_gpr	(	PDGO_Type *	ptr,
		uint32_t	index
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Read data from DGO GPR register.

Parameters

[in]	ptr	DGO base address
[in]	index	GPR register index

Returns: DGO GPR register value

< DGO GPR register count

◆ pdgo_set_cycle_wakeup_counter()

static void pdgo_set_cycle_wakeup_counter	(	PDGO_Type *	ptr,
		uint32_t	counter
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Set DGO cycle wakeup counter.

Parameters

[in]	ptr	DGO base address
[in]	counter	Wakeup counter value. Clock source is 32K.

◆ pdgo_set_pcap_counter_value()

static void pdgo_set_pcap_counter_value	(	PDGO_Type *	ptr,
		dgo_pcap_num_t	num,
		uint16_t	value
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Set PCAP counter value.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcap_num_t
[in]	value	counter value

◆ pdgo_set_pcap_enable()

static void pdgo_set_pcap_enable	(	PDGO_Type *	ptr,
		dgo_pcap_num_t	num,
		bool	enable
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Set PCAP enable.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcap_num_t
[in]	enable	true to enable, false to disable

◆ pdgo_set_pcnt_cmp0_value()

static void pdgo_set_pcnt_cmp0_value	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		uint32_t	value
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Set PCNT cmp0 value.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[in]	value	cmp0 value

◆ pdgo_set_pcnt_cmp1_value()

static void pdgo_set_pcnt_cmp1_value	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		uint32_t	value
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Set PCNT cmp1 value.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[in]	value	cmp1 value

◆ pdgo_set_pcnt_cmp_mode()

static void pdgo_set_pcnt_cmp_mode	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		dgo_pcnt_cmp_mode_t	mode
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Set PCNT cmp mode.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[in]	mode	cmp mode dgo_pcnt_cmp_mode_t

◆ pdgo_set_pcnt_dir_override_value()

static void pdgo_set_pcnt_dir_override_value	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		bool	reverse
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Set PCNT dir override value.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[in]	reverse	true:reverse, false:forward

◆ pdgo_set_pcnt_enable()

static void pdgo_set_pcnt_enable	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		bool	enable
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Set PCNT enable.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[in]	enable	true to enable, false to disable

◆ pdgo_set_pcnt_raw_counter_value()

static void pdgo_set_pcnt_raw_counter_value	(	PDGO_Type *	ptr,
		dgo_pcnt_num_t	num,
		uint32_t	value
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Set PCNT raw counter value.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_pcnt_num_t
[in]	value	counter value

◆ pdgo_set_turnoff_counter()

static void pdgo_set_turnoff_counter	(	PDGO_Type *	ptr,
		uint32_t	counter
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Set DGO turn-off counter.

Parameters

[in]	ptr	DGO base address
[in]	counter	Turn-off counter value. Clock source is 24M

◆ pdgo_set_wakeup_counter()

static void pdgo_set_wakeup_counter	(	PDGO_Type *	ptr,
		uint32_t	wakeup_ctr
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Set DGO wakeup counter.

Parameters

[in]	ptr	DGO base address
[in]	wakeup_ctr	Wakeup counter value. clock source is 32K

◆ pdgo_set_wuio_pin_enable()

static void pdgo_set_wuio_pin_enable	(	PDGO_Type *	ptr,
		dgo_wuio_pin_num_t	num,
		bool	enable
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5E00/HPM5E31/hpm_pdgo_drv.h>

Set WUIO pin enable.

Parameters

[in]	ptr	DGO base address
[in]	num	dgo_wuio_pin_num_t
[in]	enable	true to enable, false to disable

◆ pdgo_write_gpr()

static void pdgo_write_gpr	(	PDGO_Type *	ptr,
		uint32_t	index,
		uint32_t	content
	)

inlinestatic

#include </home/docs/checkouts/readthedocs.org/user_builds/hpm-sdk/checkouts/latest/soc/HPM5300/HPM5301/hpm_pdgo_drv.h>

Write data to DGO GPR register.

Parameters

[in]	ptr	DGO base address
[in]	index	GPR register index
[in]	content	Data to be written to DGO GPR register

< DGO GPR register count

Functions

Detailed Description

Function Documentation

◆ pdgo_calc_pcnt_tacho_cycles_per_line()

◆ pdgo_clear_irq0_status()

◆ pdgo_clear_irq1_status()

◆ pdgo_clear_wakeup_status()

◆ pdgo_config_pcap()

◆ pdgo_config_pcnt()

◆ pdgo_config_pcnt_range_compare()

◆ pdgo_config_wuio_filter()

◆ pdgo_convert_pcnt_counter()

◆ pdgo_disable_all_irq()

◆ pdgo_disable_irq0_by_bit_mask()

◆ pdgo_disable_irq1_by_bit_mask()

◆ pdgo_disable_pcnt_dir_override()

◆ pdgo_disable_pulldown_resistor_for_wakeup_pin()

◆ pdgo_disable_pulldown_resistor_for_wuio_pin()

◆ pdgo_disable_pullup_resistor_for_reset_pin()

◆ pdgo_disable_pulse_capture0_wakeup()

◆ pdgo_disable_pulse_counter0_wakeup()

◆ pdgo_disable_retention_mode()

◆ pdgo_disable_software_wakeup()

◆ pdgo_disable_wakeup_by_bit_mask()

◆ pdgo_disable_wkup_pin_wakeup()

◆ pdgo_disable_wkup_software_wakeup()

◆ pdgo_disable_wuio_pins_wakeup()

◆ pdgo_enable_auto_wakeup()

◆ pdgo_enable_irq0_by_bit_mask()

◆ pdgo_enable_irq1_by_bit_mask()

◆ pdgo_enable_oneshot_wakeup()

◆ pdgo_enable_pcnt_dir_override()

◆ pdgo_enable_pulldown_resistor_for_wakeup_pin()

◆ pdgo_enable_pulldown_resistor_for_wuio_pin()

◆ pdgo_enable_pullup_resistor_for_reset_pin()

◆ pdgo_enable_pulse_capture0_wakeup()

◆ pdgo_enable_pulse_counter0_wakeup()

◆ pdgo_enable_retention_mode()

◆ pdgo_enable_software_wakeup()

◆ pdgo_enable_wakeup_by_bit_mask()

◆ pdgo_enable_wkup_pin_wakeup()

◆ pdgo_enable_wkup_software_wakeup()

◆ pdgo_enable_wuio_pins_wakeup()

◆ pdgo_get_irq0_en()

◆ pdgo_get_irq0_status()

◆ pdgo_get_irq1_en()

◆ pdgo_get_irq1_status()

◆ pdgo_get_pcap_counter_value()

◆ pdgo_get_pcnt_counter()

◆ pdgo_get_pcnt_defconfig()

◆ pdgo_get_pcnt_raw_counter_value()

◆ pdgo_get_turnoff_counter_from_us()

◆ pdgo_get_us_from_turnoff_counter()

◆ pdgo_get_us_from_wakeup_counter()

◆ pdgo_get_wakeup_counter()

◆ pdgo_get_wakeup_counter_from_us()

◆ pdgo_get_wakeup_status()

◆ pdgo_is_auto_wakeup_enabled()

◆ pdgo_is_pin_wakeup()

◆ pdgo_is_retention_mode_enabled()

◆ pdgo_read_gpr()

◆ pdgo_set_cycle_wakeup_counter()

◆ pdgo_set_pcap_counter_value()

◆ pdgo_set_pcap_enable()

◆ pdgo_set_pcnt_cmp0_value()

◆ pdgo_set_pcnt_cmp1_value()

◆ pdgo_set_pcnt_cmp_mode()

◆ pdgo_set_pcnt_dir_override_value()

◆ pdgo_set_pcnt_enable()

◆ pdgo_set_pcnt_raw_counter_value()

◆ pdgo_set_turnoff_counter()

◆ pdgo_set_wakeup_counter()

◆ pdgo_set_wuio_pin_enable()

◆ pdgo_write_gpr()