lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <vri7ypbwczwj3mrsdocy27k6g4umk3swq5uw34yds2yvri2sq3@7wnx5klo4gfs>
Date: Wed, 26 Mar 2025 12:32:33 +0100
From: Uwe Kleine-König <ukleinek@...nel.org>
To: "Rafael V. Volkmer" <rafael.v.volkmer@...il.com>
Cc: linux-kernel@...r.kernel.org, linux-pwm@...r.kernel.org
Subject: Re: [PATCH v3 2/3] pwm: ehrpwm: add get_state function to retrieve
 PWM channel state

Hello Rafael,

On Fri, Feb 07, 2025 at 06:32:34PM -0300, Rafael V. Volkmer wrote:
> The ehrpwm driver was missing a get_state function, which is required
> to properly retrieve the current state of the PWM channel. This commit
> adds the ehrpwm_get_state() function, allowing users to query the
> enabled state, period, duty cycle, and polarity of the PWM output.

s/This commit adds/Add/

> The function reads the relevant registers (AQCSFRC, AQCTLx, TBPRD, CMPA)
> to determine:
> - Whether the PWM is enabled or disabled
> - The configured period and duty cycle
> - The polarity based on action-qualifier configurations
> 
> Additionally, this commit updates the pwm_ops structure to include
> .get_state, ensuring proper integration with the PWM subsystem.

The last two paragraphs are too verbose. I'd drop them.

> Signed-off-by: Rafael V. Volkmer <rafael.v.volkmer@...il.com>
> ---
>  drivers/pwm/pwm-tiehrpwm.c | 122 +++++++++++++++++++++++++++++++++++++
>  1 file changed, 122 insertions(+)
> 
> diff --git a/drivers/pwm/pwm-tiehrpwm.c b/drivers/pwm/pwm-tiehrpwm.c
> index 50516f46ab04..52527136c507 100644
> --- a/drivers/pwm/pwm-tiehrpwm.c
> +++ b/drivers/pwm/pwm-tiehrpwm.c
> @@ -81,7 +81,9 @@
>  #define AQCTL_ZRO_MASK			GENMASK(1, 0)
>  #define AQCTL_PRD_MASK			GENMASK(3, 2)
>  #define AQCTL_CAU_MASK			GENMASK(5, 4)
> +#define AQCTL_CAD_MASK			GENMASK(7, 6)
>  #define AQCTL_CBU_MASK			GENMASK(9, 8)
> +#define AQCTL_CBD_MASK			GENMASK(11, 10)
>  
>  /*
>   * FORCE LOW	=> 0b01
> @@ -495,9 +497,129 @@ static int ehrpwm_pwm_apply(struct pwm_chip *chip, struct pwm_device *pwm,
>  	return err;
>  }
>  
> +/**
> + * ehrpwm_get_state - Retrieves the current state of the eHRPWM channel
> + * @chip:	pointer to the PWM chip structure
> + * @pwm:	pointer to the PWM device structure
> + * @state:	pointer to the pwm_state structure to be filled
> + *
> + * @return:	0 on success or a negative error code on failure
> + */
> +static int ehrpwm_get_state(struct pwm_chip *chip, struct pwm_device *pwm,
> +							struct pwm_state *state)
> +{
> +	int ret = 0u;
> +
> +	struct ehrpwm_pwm_chip *pc = NULL;
> +
> +	unsigned long long tbclk_rate = 0u;
> +
> +	/* Registers */
> +	u16 aqcsfrc_reg = 0u;
> +	u16 aqctl_reg = 0u;
> +	u16 tbprd_reg = 0u;
> +	u16 cmpa_reg = 0u;

No need to initialize these. Also please drop the u suffix (which is
also inconsistant as you used U in patch #1). And then they can group
them in single code lines (i.e.

	u16 aqcsfrc_reg, aqctl_reg, tbprd_reg, cmpa_reg;

).

> +	/* Bits */
> +	u8 csf_bits = 0u;
> +
> +	/* Values */
> +	u64 period_cycles = 0u;
> +	u64 duty_cycles = 0u;
> +
> +	/* Actions */
> +	u8 up_action = 0u;
> +	u8 down_action = 0u;
> +
> +	if (chip == NULL || pwm == NULL || state == NULL)
> +		return -EINVAL;

Drop this check, the core makes sure these are all valid.

> +	pc = to_ehrpwm_pwm_chip(chip);
> +	if (pc == NULL || pwm == NULL || state == NULL)
> +		return -EINVAL;

Some of these you already checked above (so drop these, too). In my eyes
you can assume that to_ehrpwm_pwm_chip() doesn't return NULL.

> +	tbclk_rate = clk_get_rate(pc->tbclk);
> +	if (tbclk_rate <= 0)
> +		return -EINVAL;

tbclk_rate is long long while the return value of clk_get_rate is long
only. Also given that tbclk_rate is unsigned <= doesn't make much sense.

Also note that clk_get_rate() is only supposed to be called for an
enabled clock.

> +	/*< Get if EHRPWM is enable by checking registers values >*/

s/enable/enabled/

> +	/*
> +	 * The 'hwpwm' field identifies which hardware output channel (e.g.,
> +	 * 0 for channel A and 1 for channel B) of the eHRPWM module is in use.
> +	 */
> +	if (pwm->hwpwm == 0) {
> +		aqcsfrc_reg = readw(pc->mmio_base + AQCSFRC);
> +		csf_bits = FIELD_GET(AQCSFRC_CSFA_MASK, aqcsfrc_reg);
> +		aqctl_reg = readw(pc->mmio_base + AQCTLA);
> +	} else {
> +		aqcsfrc_reg = readw(pc->mmio_base + AQCSFRC);
> +		csf_bits = FIELD_GET(AQCSFRC_CSFB_MASK, aqcsfrc_reg);
> +		aqctl_reg = readw(pc->mmio_base + AQCTLB);
> +	}
> +
> +	if (csf_bits)
> +		state->enabled = false;
> +
> +	else if (aqctl_reg)
> +		state->enabled = true;

	else
		state->enable is uninitialized :-\

> +	/*< Get EHRPWM Period by checking registers values >*/

This is kind of obvious. What is that /*< style? Looks like a bird :-)

> +	tbprd_reg = readw(pc->mmio_base + TBPRD);
> +	period_cycles = (u64)(tbprd_reg + 1u);

Maybe you need to cast first and then add 1?

> +	/*
> +	 * period (in ns) = (period_cycles * 1e9) / tbclk_rate
> +	 * Using DIV_ROUND_UP_ULL to avoid floating-point operations.
> +	 */
> +	state->period = DIV_ROUND_UP_ULL(period_cycles * NSEC_PER_SEC, tbclk_rate);
> +
> +	/*< Get EHRPWM Duty Cycle by checking registers values >*/
> +	cmpa_reg = readw(pc->mmio_base + CMPA);
> +	duty_cycles = cmpa_reg;
> +
> +	/*
> +	 * duty_cycle (in ns) = (duty_cycles * 1e9) / tbclk_rate
> +	 * Using DIV_ROUND_UP_ULL to avoid floating-point operations.
> +	 */
> +	state->duty_cycle  = DIV_ROUND_UP_ULL(duty_cycles * NSEC_PER_SEC, tbclk_rate);

s/  / /

> +
> +	/*< Get EHRPWM polarity by checking registers values >*/
> +
> +	/*
> +	 * The 'hwpwm' field identifies which hardware output channel (e.g.,
> +	 * 0 for channel A and 1 for channel B) of the eHRPWM module is in use.
> +	 */
> +	if (pwm->hwpwm == 0) {
> +		aqctl_reg = readw(pc->mmio_base + AQCTLA);
> +		up_action = FIELD_GET(AQCTL_CAU_MASK, aqctl_reg);
> +		down_action = FIELD_GET(AQCTL_CAD_MASK, aqctl_reg);
> +	} else {
> +		aqctl_reg = readw(pc->mmio_base + AQCTLB);
> +		up_action = FIELD_GET(AQCTL_CBU_MASK, aqctl_reg);
> +		down_action = FIELD_GET(AQCTL_CBD_MASK, aqctl_reg);
> +	}
> +
> +	/*
> +	 * Evaluate the actions to determine the PWM polarity:
> +	 *  - If an up-count event sets the output (AQCTL_FRCHIGH) and a down-count
> +	 *    event clears it (AQ_CLEAR), then polarity is NORMAL.
> +	 *  - If an up-count event clears the output (AQ_CLEAR) and a down-count
> +	 *    event sets it (AQCTL_FRCLOW), then polarity is INVERSED.
> +	 */
> +	if (up_action == AQCTL_FRCHIGH && down_action == AQCTL_FRCLOW)
> +		state->polarity = PWM_POLARITY_NORMAL;
> +
> +	else if (up_action == AQCTL_FRCLOW && down_action == AQCTL_FRCHIGH)
> +		state->polarity = PWM_POLARITY_INVERSED;

	else ??? (maybe return an error?)

> +	return ret;
> +}
> +

Best regards
Uwe

Download attachment "signature.asc" of type "application/pgp-signature" (489 bytes)

Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ