pwm: Add support for Azoteq IQS620A PWM generator
PATCH RESEND v5 1/1 pwm: Add support for Azoteq IQS620A PWM generator
This patch adds support for the Azoteq IQS620A, capable of generating a 1-kHz PWM output with duty cycle between ~0.4% and 100% (inclusive).
---
Note: This patch was originally part of a series that was intended to be taken
through mfd in its entirety. However, attempts to elicit an Ack for this patch went unanswered, so it was dropped in order to unblock the series.
The remainder of the series (including pwm bindings) landed in 5.7-rc1, so this patch is being sent on its own so that it may be taken through pwm during the next merge window.
Changes in v5:
- Replaced iqs62x->map with iqs62x->regmap throughout
- Updated iqs620_pwm_probe to read the values of IQS620_PWR_SETTINGS_PWM_OUT and IQS620_PWM_DUTY_CYCLE so that iqs620_pwm_get_state reflects the actual state of the device following any changes made by a bootloader
- Dropped #defines for platform_driver name and alias in favor of the actual string names
Changes in v4:
- Updated iqs620_pwm_apply and iqs620_pwm_get_state to hold the lock around only the minimum necessary code
- Removed the completion protecting against early use of chip->pwms[0] from inside iqs620_pwm_notifier in favor of cached register values
- Updated iqs620_pwm_get_state to use the cached register values instead of reading IQS620_PWR_SETTINGS_PWM_OUT and IQS620_PWM_DUTY_CYCLE (both equal to zero by default)
- Added a comment in iqs620_pwm_notifier to note that the parent MFD driver prints an error message in the event of a device reset
Changes in v3:
- Updated the commit message to say "~0.4%" instead of "0.4%"
- Clarified the effect of duty cycle and state changes in the 'Limitations' section and added a restriction regarding 0% duty cycle
- Added a comment in iqs620_pwm_apply to explain how duty cycle is derived
- Updated iqs620_pwm_apply to disable the output first and enable it last to prevent temporarily driving a stale duty cycle
- Rounded the calculation for duty cycle up and down in iqs620_pwm_get_state and iqs620_pwm_apply, respectively
- Added a comment in iqs620_pwm_get_state to explain what it reports follow- ing requests to set duty cycle to 0%
- Added a lock to prevent back-to-back access of IQS620_PWR_SETTINGS_PWM_OUT and IQS620_PWM_DUTY_CYCLE from being interrupted
- Updated iqs620_pwm_notifier to reference pwm->state directly as opposed to calling pwm_get_state
- Moved notifier unregistration back to a device-managed action
- Added a completion to prevent iqs620_pwm_notifier from referencing the pwm_chip structure until it has been initialized by pwmchip_add
Changes in v2:
- Merged 'Copyright' and 'Author' lines into one in introductory comments
- Added 'Limitations' section to introductory comments
- Replaced 'error' with 'ret' throughout
- Added const qualifier to state argument of iqs620_pwm_apply and removed all modifications to the variable's contents
- Updated iqs620_pwm_apply to return -ENOTSUPP or -EINVAL if the requested polarity is inverted or the requested period is below 1 ms, respectively
- Updated iqs620_pwm_apply to disable the PWM output if duty cycle is zero
- Added iqs620_pwm_get_state
- Eliminated tabbed alignment of pwm_ops and platform_driver struct members
- Moved notifier unregistration to already present iqs620_pwm_remove, which eliminated the need for a device-managed action and ready flag
- Added a comment in iqs620_pwm_probe to explain the order of operations
- Changed Kconfig "depends on" logic to MFD_IQS62X || COMPILE_TEST
drivers/pwm/Kconfig | 10 ++ drivers/pwm/Makefile | 1 + drivers/pwm/pwm-iqs620a.c | 270 ++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 281 insertions(+) create mode 100644 drivers/pwm/pwm-iqs620a.c
drivers/pwm/Kconfig +10 -0
@@ -232,6 +232,16 @@ config PWM_IMX_TPM To compile this driver as a module, choose M here: the module will be called pwm-imx-tpm. +config PWM_IQS620A + tristate "Azoteq IQS620A PWM support" + depends on MFD_IQS62X || COMPILE_TEST + help + Generic PWM framework driver for the Azoteq IQS620A multi-function + sensor. + + To compile this driver as a module, choose M here: the module will + be called pwm-iqs620a. + config PWM_JZ4740 tristate "Ingenic JZ47xx PWM support" depends on MACH_INGENIC
drivers/pwm/Makefile +1 -0
@@ -20,6 +20,7 @@ obj-$(CONFIG_PWM_IMG) += pwm-img.o obj-$(CONFIG_PWM_IMX1) += pwm-imx1.o obj-$(CONFIG_PWM_IMX27) += pwm-imx27.o obj-$(CONFIG_PWM_IMX_TPM) += pwm-imx-tpm.o +obj-$(CONFIG_PWM_IQS620A) += pwm-iqs620a.o obj-$(CONFIG_PWM_JZ4740) += pwm-jz4740.o obj-$(CONFIG_PWM_LP3943) += pwm-lp3943.o obj-$(CONFIG_PWM_LPC18XX_SCT) += pwm-lpc18xx-sct.o
drivers/pwm/pwm-iqs620a.c new file +270 -0
270 lines not on this page · raw message
Thierry Reding
AppliedQuoted 68 lines · Jeff LaBundy
This patch adds support for the Azoteq IQS620A, capable of generating a 1-kHz PWM output with duty cycle between ~0.4% and 100% (inclusive).
Signed-off-by Jeff LaBundy <[email protected]>Reviewed-by Uwe Kleine-König <[email protected]>---
Note: This patch was originally part of a series that was intended to be taken
through mfd in its entirety. However, attempts to elicit an Ack for this patch went unanswered, so it was dropped in order to unblock the series.The remainder of the series (including pwm bindings) landed in 5.7-rc1, so this patch is being sent on its own so that it may be taken through pwm during the next merge window.
Changes in v5:
- Replacediqs62x->mapwithiqs62x->regmapthroughout
- Updatediqs620_pwm_probeto read the values ofIQS620_PWR_SETTINGS_PWM_OUTandIQS620_PWM_DUTY_CYCLEso thatiqs620_pwm_get_statereflects the actual state of the device following any changes made by a bootloader
- Dropped #defines forplatform_drivername and alias in favor of the actual string namesChanges in v4:
- Updatediqs620_pwm_applyandiqs620_pwm_get_stateto hold the lock around only the minimum necessary code
- Removed the completion protecting against early use of chip->pwms[0] from insideiqs620_pwm_notifierin favor of cached register values
- Updatediqs620_pwm_get_stateto use the cached register values instead of readingIQS620_PWR_SETTINGS_PWM_OUTandIQS620_PWM_DUTY_CYCLE(both equal to zero by default)
- Added a comment iniqs620_pwm_notifierto note that the parent MFD driver prints an error message in the event of a device resetChanges in v3:
- Updated the commit message to say "~0.4%" instead of "0.4%"
- Clarified the effect of duty cycle and state changes in the 'Limitations' section and added a restriction regarding 0% duty cycle
- Added a comment iniqs620_pwm_applyto explain how duty cycle is derived
- Updatediqs620_pwm_applyto disable the output first and enable it last to prevent temporarily driving a stale duty cycle
- Rounded the calculation for duty cycle up and down iniqs620_pwm_get_stateandiqs620_pwm_apply, respectively
- Added a comment iniqs620_pwm_get_stateto explain what it reports follow- ing requests to set duty cycle to 0%
- Added a lock to prevent back-to-back access ofIQS620_PWR_SETTINGS_PWM_OUTandIQS620_PWM_DUTY_CYCLEfrom being interrupted
- Updatediqs620_pwm_notifierto referencepwm->statedirectly as opposed to callingpwm_get_state
- Moved notifier unregistration back to a device-managed action
- Added a completion to preventiqs620_pwm_notifierfrom referencing thepwm_chipstructure until it has been initialized bypwmchip_addChanges in v2:
- Merged 'Copyright' and 'Author' lines into one in introductory comments
- Added 'Limitations' section to introductory comments
- Replaced 'error' with 'ret' throughout
- Added const qualifier to state argument ofiqs620_pwm_applyand removed all modifications to the variable's contents
- Updatediqs620_pwm_applyto return-ENOTSUPPor-EINVALif the requested polarity is inverted or the requested period is below 1 ms, respectively
- Updatediqs620_pwm_applyto disable the PWM output if duty cycle is zero
- Addediqs620_pwm_get_state
- Eliminated tabbed alignment ofpwm_opsandplatform_driverstruct members
- Moved notifier unregistration to already presentiqs620_pwm_remove, which eliminated the need for a device-managed action and ready flag
- Added a comment iniqs620_pwm_probeto explain the order of operations
- ChangedKconfig"depends on" logic toMFD_IQS62X||COMPILE_TEST
Quoted 5 lines
drivers/pwm/Kconfig | 10 ++ drivers/pwm/Makefile | 1 + drivers/pwm/pwm-iqs620a.c | 270 ++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 281 insertions(+) create mode 100644 drivers/pwm/pwm-iqs620a.c
Applied, thanks.
Thierry