Re: [RFC 1/4] pwm: sifive: Add DT documentation for SiFive PWM Controller.
From: Atish Patra <hidden>
Date: 2018-10-16 22:42:04
Also in:
linux-gpio, linux-pwm, linux-riscv, lkml
On 10/16/18 3:51 AM, Thierry Reding wrote:
On Mon, Oct 15, 2018 at 03:45:46PM -0700, Atish Patra wrote:quoted
On 10/10/18 6:51 AM, Thierry Reding wrote:quoted
On Tue, Oct 09, 2018 at 11:51:22AM -0700, Atish Patra wrote: [...]quoted
+- interrupts: one interrupt per PWM channel (currently unused in the driver)This should probably say what the interrupt is used for. And once you have that, remove the comment about it being unused in the driver. DT is OS agnostic, so "driver" is very unspecific and your claim may actually be false. ThierryAs per my understanding, they are generated by hardware but no usage of pwm interrupts as of now.It might be useful to say when they are generated. Are they generated once per period? At the beginning or the end of the period? That kind of thing.
Sure. I might have over simplified the statement above. I could only find this about pwm interrupts in spec. "The PWM can be configured to provide periodic counter interrupts by enabling auto-zeroing of the count register when a comparator 0 fires" I may be wrong here but it looks like we need to configure the hardware to generate periodic interrupts. I will confirm with Wesly and update it in v2.
quoted
I am not sure if removing the entire entry is a good idea. What would be the best way to represent that information ? May be this ? +-interrupts: one interrupt per PWM channel. No usage in HiFive Unleashed SoC.Why do you think you need to say that they are unused? If the hardware generates these interrupts, then they are "used". If no driver currently has a use for them, that's driver specific and doesn't belong in the DT bindings.
Sounds good. I will update accordingly. Regards, Atish
Thierry