11 #include <linux/pwm.h>
21 #include <dt-bindings/pwm/pwm.h>
24 #include <trace/events/pwm.h>
35 static struct pwm_device *pwm_to_device(unsigned int pwm)  in pwm_to_device()  argument
37 	return radix_tree_lookup(&pwm_tree, pwm);  in pwm_to_device()
58 		struct pwm_device *pwm = &chip->pwms[i];  in free_pwms()  local
60 		radix_tree_delete(&pwm_tree, pwm->pwm);  in free_pwms()
92 static int pwm_device_request(struct pwm_device *pwm, const char *label)  in pwm_device_request()  argument
96 	if (test_bit(PWMF_REQUESTED, &pwm->flags))  in pwm_device_request()
99 	if (!try_module_get(pwm->chip->ops->owner))  in pwm_device_request()
102 	if (pwm->chip->ops->request) {  in pwm_device_request()
103 		err = pwm->chip->ops->request(pwm->chip, pwm);  in pwm_device_request()
105 			module_put(pwm->chip->ops->owner);  in pwm_device_request()
110 	if (pwm->chip->ops->get_state) {  in pwm_device_request()
111 		pwm->chip->ops->get_state(pwm->chip, pwm, &pwm->state);  in pwm_device_request()
112 		trace_pwm_get(pwm, &pwm->state);  in pwm_device_request()
115 			pwm->last = pwm->state;  in pwm_device_request()
118 	set_bit(PWMF_REQUESTED, &pwm->flags);  in pwm_device_request()
119 	pwm->label = label;  in pwm_device_request()
127 	struct pwm_device *pwm;  in of_pwm_xlate_with_flags()  local
139 	pwm = pwm_request_from_chip(pc, args->args[0], NULL);  in of_pwm_xlate_with_flags()
140 	if (IS_ERR(pwm))  in of_pwm_xlate_with_flags()
141 		return pwm;  in of_pwm_xlate_with_flags()
143 	pwm->args.period = args->args[1];  in of_pwm_xlate_with_flags()
144 	pwm->args.polarity = PWM_POLARITY_NORMAL;  in of_pwm_xlate_with_flags()
148 			pwm->args.polarity = PWM_POLARITY_INVERSED;  in of_pwm_xlate_with_flags()
151 	return pwm;  in of_pwm_xlate_with_flags()
158 	struct pwm_device *pwm;  in of_pwm_single_xlate()  local
167 	pwm = pwm_request_from_chip(pc, 0, NULL);  in of_pwm_single_xlate()
168 	if (IS_ERR(pwm))  in of_pwm_single_xlate()
169 		return pwm;  in of_pwm_single_xlate()
171 	pwm->args.period = args->args[0];  in of_pwm_single_xlate()
172 	pwm->args.polarity = PWM_POLARITY_NORMAL;  in of_pwm_single_xlate()
175 		pwm->args.polarity = PWM_POLARITY_INVERSED;  in of_pwm_single_xlate()
177 	return pwm;  in of_pwm_single_xlate()
189 		if (of_property_read_u32(chip->dev->of_node, "#pwm-cells",  in of_pwmchip_add()
207  * pwm_set_chip_data() - set private chip data for a PWM
208  * @pwm: PWM device
213 int pwm_set_chip_data(struct pwm_device *pwm, void *data)  in pwm_set_chip_data()  argument
215 	if (!pwm)  in pwm_set_chip_data()
218 	pwm->chip_data = data;  in pwm_set_chip_data()
225  * pwm_get_chip_data() - get private chip data for a PWM
226  * @pwm: PWM device
228  * Returns: A pointer to the chip-private data for the PWM device.
230 void *pwm_get_chip_data(struct pwm_device *pwm)  in pwm_get_chip_data()  argument
232 	return pwm ? pwm->chip_data : NULL;  in pwm_get_chip_data()
251  * pwmchip_add() - register a new PWM chip
252  * @chip: the PWM chip to add
254  * Register a new PWM chip.
260 	struct pwm_device *pwm;  in pwmchip_add()  local
278 	chip->pwms = kcalloc(chip->npwm, sizeof(*pwm), GFP_KERNEL);  in pwmchip_add()
285 		pwm = &chip->pwms[i];  in pwmchip_add()
287 		pwm->chip = chip;  in pwmchip_add()
288 		pwm->pwm = chip->base + i;  in pwmchip_add()
289 		pwm->hwpwm = i;  in pwmchip_add()
291 		radix_tree_insert(&pwm_tree, pwm->pwm, pwm);  in pwmchip_add()
315  * pwmchip_remove() - remove a PWM chip
316  * @chip: the PWM chip to remove
318  * Removes a PWM chip. This function may return busy if the PWM chip provides
319  * a PWM device that is still requested.
360  * pwm_request() - request a PWM device
361  * @pwm: global PWM device index
362  * @label: PWM device label
366  * Returns: A pointer to a PWM device or an ERR_PTR()-encoded error code on
369 struct pwm_device *pwm_request(int pwm, const char *label)  in pwm_request()  argument
374 	if (pwm < 0 || pwm >= MAX_PWMS)  in pwm_request()
379 	dev = pwm_to_device(pwm);  in pwm_request()
397  * pwm_request_from_chip() - request a PWM device relative to a PWM chip
398  * @chip: PWM chip
399  * @index: per-chip index of the PWM to request
400  * @label: a literal description string of this PWM
402  * Returns: A pointer to the PWM device at the given index of the given PWM
404  * specified PWM chip or if the PWM device cannot be requested.
410 	struct pwm_device *pwm;  in pwm_request_from_chip()  local
417 	pwm = &chip->pwms[index];  in pwm_request_from_chip()
419 	err = pwm_device_request(pwm, label);  in pwm_request_from_chip()
421 		pwm = ERR_PTR(err);  in pwm_request_from_chip()
424 	return pwm;  in pwm_request_from_chip()
429  * pwm_free() - free a PWM device
430  * @pwm: PWM device
434 void pwm_free(struct pwm_device *pwm)  in pwm_free()  argument
436 	pwm_put(pwm);  in pwm_free()
440 static void pwm_apply_state_debug(struct pwm_device *pwm,  in pwm_apply_state_debug()  argument
443 	struct pwm_state *last = &pwm->last;  in pwm_apply_state_debug()
444 	struct pwm_chip *chip = pwm->chip;  in pwm_apply_state_debug()
460 	chip->ops->get_state(chip, pwm, &s1);  in pwm_apply_state_debug()
461 	trace_pwm_get(pwm, &s1);  in pwm_apply_state_debug()
516 	err = chip->ops->apply(chip, pwm, &s1);  in pwm_apply_state_debug()
523 	trace_pwm_apply(pwm, &s1);  in pwm_apply_state_debug()
525 	chip->ops->get_state(chip, pwm, last);  in pwm_apply_state_debug()
526 	trace_pwm_get(pwm, last);  in pwm_apply_state_debug()
542  * pwm_apply_state() - atomically apply a new state to a PWM device
543  * @pwm: PWM device
546 int pwm_apply_state(struct pwm_device *pwm, const struct pwm_state *state)  in pwm_apply_state()  argument
560 	if (!pwm || !state || !state->period ||  in pwm_apply_state()
564 	chip = pwm->chip;  in pwm_apply_state()
566 	if (state->period == pwm->state.period &&  in pwm_apply_state()
567 	    state->duty_cycle == pwm->state.duty_cycle &&  in pwm_apply_state()
568 	    state->polarity == pwm->state.polarity &&  in pwm_apply_state()
569 	    state->enabled == pwm->state.enabled &&  in pwm_apply_state()
570 	    state->usage_power == pwm->state.usage_power)  in pwm_apply_state()
573 	err = chip->ops->apply(chip, pwm, state);  in pwm_apply_state()
577 	trace_pwm_apply(pwm, state);  in pwm_apply_state()
579 	pwm->state = *state;  in pwm_apply_state()
582 	 * only do this after pwm->state was applied as some  in pwm_apply_state()
585 	pwm_apply_state_debug(pwm, state);  in pwm_apply_state()
592  * pwm_capture() - capture and report a PWM signal
593  * @pwm: PWM device
599 int pwm_capture(struct pwm_device *pwm, struct pwm_capture *result,  in pwm_capture()  argument
604 	if (!pwm || !pwm->chip->ops)  in pwm_capture()
607 	if (!pwm->chip->ops->capture)  in pwm_capture()
611 	err = pwm->chip->ops->capture(pwm->chip, pwm, result, timeout);  in pwm_capture()
619  * pwm_adjust_config() - adjust the current PWM config to the PWM arguments
620  * @pwm: PWM device
622  * This function will adjust the PWM config to the PWM arguments provided
623  * by the DT or PWM lookup table. This is particularly useful to adapt
626 int pwm_adjust_config(struct pwm_device *pwm)  in pwm_adjust_config()  argument
631 	pwm_get_args(pwm, &pargs);  in pwm_adjust_config()
632 	pwm_get_state(pwm, &state);  in pwm_adjust_config()
635 	 * If the current period is zero it means that either the PWM driver  in pwm_adjust_config()
636 	 * does not support initial state retrieval or the PWM has not yet  in pwm_adjust_config()
647 		return pwm_apply_state(pwm, &state);  in pwm_adjust_config()
651 	 * Adjust the PWM duty cycle/period based on the period value provided  in pwm_adjust_config()
652 	 * in PWM args.  in pwm_adjust_config()
670 	return pwm_apply_state(pwm, &state);  in pwm_adjust_config()
692 					       struct pwm_device *pwm)  in pwm_device_link_add()  argument
698 		 * No device for the PWM consumer has been provided. It may  in pwm_device_link_add()
699 		 * impact the PM sequence ordering: the PWM supplier may get  in pwm_device_link_add()
702 		dev_warn(pwm->chip->dev,  in pwm_device_link_add()
707 	dl = device_link_add(dev, pwm->chip->dev, DL_FLAG_AUTOREMOVE_CONSUMER);  in pwm_device_link_add()
710 			dev_name(pwm->chip->dev));  in pwm_device_link_add()
718  * of_pwm_get() - request a PWM via the PWM framework
719  * @dev: device for PWM consumer
720  * @np: device node to get the PWM from
723  * Returns the PWM device parsed from the phandle and index specified in the
725  * Values parsed from the device tree are stored in the returned PWM device
728  * If con_id is NULL, the first PWM device listed in the "pwms" property will
729  * be requested. Otherwise the "pwm-names" property is used to do a reverse
730  * lookup of the PWM index. This also means that the "pwm-names" property
731  * becomes mandatory for devices that look up the PWM device via the con_id
734  * Returns: A pointer to the requested PWM device or an ERR_PTR()-encoded
740 	struct pwm_device *pwm = NULL;  in of_pwm_get()  local
748 		index = of_property_match_string(np, "pwm-names", con_id);  in of_pwm_get()
753 	err = of_parse_phandle_with_args(np, "pwms", "#pwm-cells", index,  in of_pwm_get()
763 			pr_err("%s(): PWM chip not found\n", __func__);  in of_pwm_get()
765 		pwm = ERR_CAST(pc);  in of_pwm_get()
769 	pwm = pc->of_xlate(pc, &args);  in of_pwm_get()
770 	if (IS_ERR(pwm))  in of_pwm_get()
773 	dl = pwm_device_link_add(dev, pwm);  in of_pwm_get()
776 		pwm_free(pwm);  in of_pwm_get()
777 		pwm = ERR_CAST(dl);  in of_pwm_get()
783 	 * "pwm-names" property if it exists. Otherwise use the name of  in of_pwm_get()
787 		err = of_property_read_string_index(np, "pwm-names", index,  in of_pwm_get()
793 	pwm->label = con_id;  in of_pwm_get()
798 	return pwm;  in of_pwm_get()
802  * acpi_pwm_get() - request a PWM via parsing "pwms" property in ACPI
805  * Returns the PWM device parsed from the fwnode and index specified in the
807  * Values parsed from the device tree are stored in the returned PWM device
813  *     { <PWM device reference>, <PWM index>, <PWM period> [, <PWM flags>]}}
815  * Returns: A pointer to the requested PWM device or an ERR_PTR()-encoded
820 	struct pwm_device *pwm;  in acpi_pwm_get()  local
838 	pwm = pwm_request_from_chip(chip, args.args[0], NULL);  in acpi_pwm_get()
839 	if (IS_ERR(pwm))  in acpi_pwm_get()
840 		return pwm;  in acpi_pwm_get()
842 	pwm->args.period = args.args[1];  in acpi_pwm_get()
843 	pwm->args.polarity = PWM_POLARITY_NORMAL;  in acpi_pwm_get()
846 		pwm->args.polarity = PWM_POLARITY_INVERSED;  in acpi_pwm_get()
848 	return pwm;  in acpi_pwm_get()
852  * pwm_add_table() - register PWM device consumers
869  * pwm_remove_table() - unregister PWM device consumers
886  * pwm_get() - look up and request a PWM device
887  * @dev: device for PWM consumer
891  * a device tree, a PWM chip and a relative index is looked up via a table
894  * Once a PWM chip has been found the specified PWM device will be requested
897  * Returns: A pointer to the requested PWM device or an ERR_PTR()-encoded
904 	struct pwm_device *pwm;  in pwm_get()  local
918 		pwm = acpi_pwm_get(fwnode);  in pwm_get()
919 		if (!IS_ERR(pwm) || PTR_ERR(pwm) != -ENOENT)  in pwm_get()
920 			return pwm;  in pwm_get()
930 	 * If a match is found, the provider PWM chip is looked up by name  in pwm_get()
931 	 * and a PWM device is requested using the PWM device per-chip index.  in pwm_get()
981 	 * the PWM chip lookup. This can be used to work around driver load  in pwm_get()
994 	pwm = pwm_request_from_chip(chip, chosen->index, con_id ?: dev_id);  in pwm_get()
995 	if (IS_ERR(pwm))  in pwm_get()
996 		return pwm;  in pwm_get()
998 	dl = pwm_device_link_add(dev, pwm);  in pwm_get()
1000 		pwm_free(pwm);  in pwm_get()
1004 	pwm->args.period = chosen->period;  in pwm_get()
1005 	pwm->args.polarity = chosen->polarity;  in pwm_get()
1007 	return pwm;  in pwm_get()
1012  * pwm_put() - release a PWM device
1013  * @pwm: PWM device
1015 void pwm_put(struct pwm_device *pwm)  in pwm_put()  argument
1017 	if (!pwm)  in pwm_put()
1022 	if (!test_and_clear_bit(PWMF_REQUESTED, &pwm->flags)) {  in pwm_put()
1023 		pr_warn("PWM device already freed\n");  in pwm_put()
1027 	if (pwm->chip->ops->free)  in pwm_put()
1028 		pwm->chip->ops->free(pwm->chip, pwm);  in pwm_put()
1030 	pwm_set_chip_data(pwm, NULL);  in pwm_put()
1031 	pwm->label = NULL;  in pwm_put()
1033 	module_put(pwm->chip->ops->owner);  in pwm_put()
1039 static void devm_pwm_release(void *pwm)  in devm_pwm_release()  argument
1041 	pwm_put(pwm);  in devm_pwm_release()
1046  * @dev: device for PWM consumer
1049  * This function performs like pwm_get() but the acquired PWM device will
1052  * Returns: A pointer to the requested PWM device or an ERR_PTR()-encoded
1057 	struct pwm_device *pwm;  in devm_pwm_get()  local
1060 	pwm = pwm_get(dev, con_id);  in devm_pwm_get()
1061 	if (IS_ERR(pwm))  in devm_pwm_get()
1062 		return pwm;  in devm_pwm_get()
1064 	ret = devm_add_action_or_reset(dev, devm_pwm_release, pwm);  in devm_pwm_get()
1068 	return pwm;  in devm_pwm_get()
1073  * devm_fwnode_pwm_get() - request a resource managed PWM from firmware node
1074  * @dev: device for PWM consumer
1075  * @fwnode: firmware node to get the PWM from
1078  * Returns the PWM device parsed from the firmware node. See of_pwm_get() and
1081  * Returns: A pointer to the requested PWM device or an ERR_PTR()-encoded
1088 	struct pwm_device *pwm = ERR_PTR(-ENODEV);  in devm_fwnode_pwm_get()  local
1092 		pwm = of_pwm_get(dev, to_of_node(fwnode), con_id);  in devm_fwnode_pwm_get()
1094 		pwm = acpi_pwm_get(fwnode);  in devm_fwnode_pwm_get()
1095 	if (IS_ERR(pwm))  in devm_fwnode_pwm_get()
1096 		return pwm;  in devm_fwnode_pwm_get()
1098 	ret = devm_add_action_or_reset(dev, devm_pwm_release, pwm);  in devm_fwnode_pwm_get()
1102 	return pwm;  in devm_fwnode_pwm_get()
1112 		struct pwm_device *pwm = &chip->pwms[i];  in pwm_dbg_show()  local
1115 		pwm_get_state(pwm, &state);  in pwm_dbg_show()
1117 		seq_printf(s, " pwm-%-3d (%-20.20s):", i, pwm->label);  in pwm_dbg_show()
1119 		if (test_bit(PWMF_REQUESTED, &pwm->flags))  in pwm_dbg_show()
1161 	seq_printf(s, "%s%s/%s, %d PWM device%s\n", (char *)s->private,  in pwm_seq_show()
1182 	debugfs_create_file("pwm", S_IFREG | 0444, NULL, NULL,  in pwm_debugfs_init()