162306a36Sopenharmony_ci/* SPDX-License-Identifier: GPL-2.0-only */
262306a36Sopenharmony_ci/*
362306a36Sopenharmony_ci * Driver model for leds and led triggers
462306a36Sopenharmony_ci *
562306a36Sopenharmony_ci * Copyright (C) 2005 John Lenz <lenz@cs.wisc.edu>
662306a36Sopenharmony_ci * Copyright (C) 2005 Richard Purdie <rpurdie@openedhand.com>
762306a36Sopenharmony_ci */
862306a36Sopenharmony_ci#ifndef __LINUX_LEDS_H_INCLUDED
962306a36Sopenharmony_ci#define __LINUX_LEDS_H_INCLUDED
1062306a36Sopenharmony_ci
1162306a36Sopenharmony_ci#include <dt-bindings/leds/common.h>
1262306a36Sopenharmony_ci#include <linux/device.h>
1362306a36Sopenharmony_ci#include <linux/mutex.h>
1462306a36Sopenharmony_ci#include <linux/rwsem.h>
1562306a36Sopenharmony_ci#include <linux/spinlock.h>
1662306a36Sopenharmony_ci#include <linux/timer.h>
1762306a36Sopenharmony_ci#include <linux/types.h>
1862306a36Sopenharmony_ci#include <linux/workqueue.h>
1962306a36Sopenharmony_ci
2062306a36Sopenharmony_cistruct attribute_group;
2162306a36Sopenharmony_cistruct device_node;
2262306a36Sopenharmony_cistruct fwnode_handle;
2362306a36Sopenharmony_cistruct gpio_desc;
2462306a36Sopenharmony_cistruct kernfs_node;
2562306a36Sopenharmony_cistruct led_pattern;
2662306a36Sopenharmony_cistruct platform_device;
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ci/*
2962306a36Sopenharmony_ci * LED Core
3062306a36Sopenharmony_ci */
3162306a36Sopenharmony_ci
3262306a36Sopenharmony_ci/* This is obsolete/useless. We now support variable maximum brightness. */
3362306a36Sopenharmony_cienum led_brightness {
3462306a36Sopenharmony_ci	LED_OFF		= 0,
3562306a36Sopenharmony_ci	LED_ON		= 1,
3662306a36Sopenharmony_ci	LED_HALF	= 127,
3762306a36Sopenharmony_ci	LED_FULL	= 255,
3862306a36Sopenharmony_ci};
3962306a36Sopenharmony_ci
4062306a36Sopenharmony_cienum led_default_state {
4162306a36Sopenharmony_ci	LEDS_DEFSTATE_OFF	= 0,
4262306a36Sopenharmony_ci	LEDS_DEFSTATE_ON	= 1,
4362306a36Sopenharmony_ci	LEDS_DEFSTATE_KEEP	= 2,
4462306a36Sopenharmony_ci};
4562306a36Sopenharmony_ci
4662306a36Sopenharmony_ci/**
4762306a36Sopenharmony_ci * struct led_lookup_data - represents a single LED lookup entry
4862306a36Sopenharmony_ci *
4962306a36Sopenharmony_ci * @list: internal list of all LED lookup entries
5062306a36Sopenharmony_ci * @provider: name of led_classdev providing the LED
5162306a36Sopenharmony_ci * @dev_id: name of the device associated with this LED
5262306a36Sopenharmony_ci * @con_id: name of the LED from the device's point of view
5362306a36Sopenharmony_ci */
5462306a36Sopenharmony_cistruct led_lookup_data {
5562306a36Sopenharmony_ci	struct list_head list;
5662306a36Sopenharmony_ci	const char *provider;
5762306a36Sopenharmony_ci	const char *dev_id;
5862306a36Sopenharmony_ci	const char *con_id;
5962306a36Sopenharmony_ci};
6062306a36Sopenharmony_ci
6162306a36Sopenharmony_cistruct led_init_data {
6262306a36Sopenharmony_ci	/* device fwnode handle */
6362306a36Sopenharmony_ci	struct fwnode_handle *fwnode;
6462306a36Sopenharmony_ci	/*
6562306a36Sopenharmony_ci	 * default <color:function> tuple, for backward compatibility
6662306a36Sopenharmony_ci	 * with in-driver hard-coded LED names used as a fallback when
6762306a36Sopenharmony_ci	 * DT "label" property is absent; it should be set to NULL
6862306a36Sopenharmony_ci	 * in new LED class drivers.
6962306a36Sopenharmony_ci	 */
7062306a36Sopenharmony_ci	const char *default_label;
7162306a36Sopenharmony_ci	/*
7262306a36Sopenharmony_ci	 * string to be used for devicename section of LED class device
7362306a36Sopenharmony_ci	 * either for label based LED name composition path or for fwnode
7462306a36Sopenharmony_ci	 * based when devname_mandatory is true
7562306a36Sopenharmony_ci	 */
7662306a36Sopenharmony_ci	const char *devicename;
7762306a36Sopenharmony_ci	/*
7862306a36Sopenharmony_ci	 * indicates if LED name should always comprise devicename section;
7962306a36Sopenharmony_ci	 * only LEDs exposed by drivers of hot-pluggable devices should
8062306a36Sopenharmony_ci	 * set it to true
8162306a36Sopenharmony_ci	 */
8262306a36Sopenharmony_ci	bool devname_mandatory;
8362306a36Sopenharmony_ci};
8462306a36Sopenharmony_ci
8562306a36Sopenharmony_ci#if IS_ENABLED(CONFIG_NEW_LEDS)
8662306a36Sopenharmony_cienum led_default_state led_init_default_state_get(struct fwnode_handle *fwnode);
8762306a36Sopenharmony_ci#else
8862306a36Sopenharmony_cistatic inline enum led_default_state
8962306a36Sopenharmony_ciled_init_default_state_get(struct fwnode_handle *fwnode)
9062306a36Sopenharmony_ci{
9162306a36Sopenharmony_ci	return LEDS_DEFSTATE_OFF;
9262306a36Sopenharmony_ci}
9362306a36Sopenharmony_ci#endif
9462306a36Sopenharmony_ci
9562306a36Sopenharmony_cistruct led_hw_trigger_type {
9662306a36Sopenharmony_ci	int dummy;
9762306a36Sopenharmony_ci};
9862306a36Sopenharmony_ci
9962306a36Sopenharmony_cistruct led_classdev {
10062306a36Sopenharmony_ci	const char		*name;
10162306a36Sopenharmony_ci	unsigned int brightness;
10262306a36Sopenharmony_ci	unsigned int max_brightness;
10362306a36Sopenharmony_ci	unsigned int color;
10462306a36Sopenharmony_ci	int			 flags;
10562306a36Sopenharmony_ci
10662306a36Sopenharmony_ci	/* Lower 16 bits reflect status */
10762306a36Sopenharmony_ci#define LED_SUSPENDED		BIT(0)
10862306a36Sopenharmony_ci#define LED_UNREGISTERING	BIT(1)
10962306a36Sopenharmony_ci	/* Upper 16 bits reflect control information */
11062306a36Sopenharmony_ci#define LED_CORE_SUSPENDRESUME	BIT(16)
11162306a36Sopenharmony_ci#define LED_SYSFS_DISABLE	BIT(17)
11262306a36Sopenharmony_ci#define LED_DEV_CAP_FLASH	BIT(18)
11362306a36Sopenharmony_ci#define LED_HW_PLUGGABLE	BIT(19)
11462306a36Sopenharmony_ci#define LED_PANIC_INDICATOR	BIT(20)
11562306a36Sopenharmony_ci#define LED_BRIGHT_HW_CHANGED	BIT(21)
11662306a36Sopenharmony_ci#define LED_RETAIN_AT_SHUTDOWN	BIT(22)
11762306a36Sopenharmony_ci#define LED_INIT_DEFAULT_TRIGGER BIT(23)
11862306a36Sopenharmony_ci
11962306a36Sopenharmony_ci	/* set_brightness_work / blink_timer flags, atomic, private. */
12062306a36Sopenharmony_ci	unsigned long		work_flags;
12162306a36Sopenharmony_ci
12262306a36Sopenharmony_ci#define LED_BLINK_SW			0
12362306a36Sopenharmony_ci#define LED_BLINK_ONESHOT		1
12462306a36Sopenharmony_ci#define LED_BLINK_ONESHOT_STOP		2
12562306a36Sopenharmony_ci#define LED_BLINK_INVERT		3
12662306a36Sopenharmony_ci#define LED_BLINK_BRIGHTNESS_CHANGE 	4
12762306a36Sopenharmony_ci#define LED_BLINK_DISABLE		5
12862306a36Sopenharmony_ci	/* Brightness off also disables hw-blinking so it is a separate action */
12962306a36Sopenharmony_ci#define LED_SET_BRIGHTNESS_OFF		6
13062306a36Sopenharmony_ci#define LED_SET_BRIGHTNESS		7
13162306a36Sopenharmony_ci#define LED_SET_BLINK			8
13262306a36Sopenharmony_ci
13362306a36Sopenharmony_ci	/* Set LED brightness level
13462306a36Sopenharmony_ci	 * Must not sleep. Use brightness_set_blocking for drivers
13562306a36Sopenharmony_ci	 * that can sleep while setting brightness.
13662306a36Sopenharmony_ci	 */
13762306a36Sopenharmony_ci	void		(*brightness_set)(struct led_classdev *led_cdev,
13862306a36Sopenharmony_ci					  enum led_brightness brightness);
13962306a36Sopenharmony_ci	/*
14062306a36Sopenharmony_ci	 * Set LED brightness level immediately - it can block the caller for
14162306a36Sopenharmony_ci	 * the time required for accessing a LED device register.
14262306a36Sopenharmony_ci	 */
14362306a36Sopenharmony_ci	int (*brightness_set_blocking)(struct led_classdev *led_cdev,
14462306a36Sopenharmony_ci				       enum led_brightness brightness);
14562306a36Sopenharmony_ci	/* Get LED brightness level */
14662306a36Sopenharmony_ci	enum led_brightness (*brightness_get)(struct led_classdev *led_cdev);
14762306a36Sopenharmony_ci
14862306a36Sopenharmony_ci	/*
14962306a36Sopenharmony_ci	 * Activate hardware accelerated blink, delays are in milliseconds
15062306a36Sopenharmony_ci	 * and if both are zero then a sensible default should be chosen.
15162306a36Sopenharmony_ci	 * The call should adjust the timings in that case and if it can't
15262306a36Sopenharmony_ci	 * match the values specified exactly.
15362306a36Sopenharmony_ci	 * Deactivate blinking again when the brightness is set to LED_OFF
15462306a36Sopenharmony_ci	 * via the brightness_set() callback.
15562306a36Sopenharmony_ci	 * For led_blink_set_nosleep() the LED core assumes that blink_set
15662306a36Sopenharmony_ci	 * implementations, of drivers which do not use brightness_set_blocking,
15762306a36Sopenharmony_ci	 * will not sleep. Therefor if brightness_set_blocking is not set
15862306a36Sopenharmony_ci	 * this function must not sleep!
15962306a36Sopenharmony_ci	 */
16062306a36Sopenharmony_ci	int		(*blink_set)(struct led_classdev *led_cdev,
16162306a36Sopenharmony_ci				     unsigned long *delay_on,
16262306a36Sopenharmony_ci				     unsigned long *delay_off);
16362306a36Sopenharmony_ci
16462306a36Sopenharmony_ci	int (*pattern_set)(struct led_classdev *led_cdev,
16562306a36Sopenharmony_ci			   struct led_pattern *pattern, u32 len, int repeat);
16662306a36Sopenharmony_ci	int (*pattern_clear)(struct led_classdev *led_cdev);
16762306a36Sopenharmony_ci
16862306a36Sopenharmony_ci	struct device		*dev;
16962306a36Sopenharmony_ci	const struct attribute_group	**groups;
17062306a36Sopenharmony_ci
17162306a36Sopenharmony_ci	struct list_head	 node;			/* LED Device list */
17262306a36Sopenharmony_ci	const char		*default_trigger;	/* Trigger to use */
17362306a36Sopenharmony_ci
17462306a36Sopenharmony_ci	unsigned long		 blink_delay_on, blink_delay_off;
17562306a36Sopenharmony_ci	struct timer_list	 blink_timer;
17662306a36Sopenharmony_ci	int			 blink_brightness;
17762306a36Sopenharmony_ci	int			 new_blink_brightness;
17862306a36Sopenharmony_ci	void			(*flash_resume)(struct led_classdev *led_cdev);
17962306a36Sopenharmony_ci
18062306a36Sopenharmony_ci	struct work_struct	set_brightness_work;
18162306a36Sopenharmony_ci	int			delayed_set_value;
18262306a36Sopenharmony_ci	unsigned long		delayed_delay_on;
18362306a36Sopenharmony_ci	unsigned long		delayed_delay_off;
18462306a36Sopenharmony_ci
18562306a36Sopenharmony_ci#ifdef CONFIG_LEDS_TRIGGERS
18662306a36Sopenharmony_ci	/* Protects the trigger data below */
18762306a36Sopenharmony_ci	struct rw_semaphore	 trigger_lock;
18862306a36Sopenharmony_ci
18962306a36Sopenharmony_ci	struct led_trigger	*trigger;
19062306a36Sopenharmony_ci	struct list_head	 trig_list;
19162306a36Sopenharmony_ci	void			*trigger_data;
19262306a36Sopenharmony_ci	/* true if activated - deactivate routine uses it to do cleanup */
19362306a36Sopenharmony_ci	bool			activated;
19462306a36Sopenharmony_ci
19562306a36Sopenharmony_ci	/* LEDs that have private triggers have this set */
19662306a36Sopenharmony_ci	struct led_hw_trigger_type	*trigger_type;
19762306a36Sopenharmony_ci
19862306a36Sopenharmony_ci	/* Unique trigger name supported by LED set in hw control mode */
19962306a36Sopenharmony_ci	const char		*hw_control_trigger;
20062306a36Sopenharmony_ci	/*
20162306a36Sopenharmony_ci	 * Check if the LED driver supports the requested mode provided by the
20262306a36Sopenharmony_ci	 * defined supported trigger to setup the LED to hw control mode.
20362306a36Sopenharmony_ci	 *
20462306a36Sopenharmony_ci	 * Return 0 on success. Return -EOPNOTSUPP when the passed flags are not
20562306a36Sopenharmony_ci	 * supported and software fallback needs to be used.
20662306a36Sopenharmony_ci	 * Return a negative error number on any other case  for check fail due
20762306a36Sopenharmony_ci	 * to various reason like device not ready or timeouts.
20862306a36Sopenharmony_ci	 */
20962306a36Sopenharmony_ci	int			(*hw_control_is_supported)(struct led_classdev *led_cdev,
21062306a36Sopenharmony_ci							   unsigned long flags);
21162306a36Sopenharmony_ci	/*
21262306a36Sopenharmony_ci	 * Activate hardware control, LED driver will use the provided flags
21362306a36Sopenharmony_ci	 * from the supported trigger and setup the LED to be driven by hardware
21462306a36Sopenharmony_ci	 * following the requested mode from the trigger flags.
21562306a36Sopenharmony_ci	 * Deactivate hardware blink control by setting brightness to LED_OFF via
21662306a36Sopenharmony_ci	 * the brightness_set() callback.
21762306a36Sopenharmony_ci	 *
21862306a36Sopenharmony_ci	 * Return 0 on success, a negative error number on flags apply fail.
21962306a36Sopenharmony_ci	 */
22062306a36Sopenharmony_ci	int			(*hw_control_set)(struct led_classdev *led_cdev,
22162306a36Sopenharmony_ci						  unsigned long flags);
22262306a36Sopenharmony_ci	/*
22362306a36Sopenharmony_ci	 * Get from the LED driver the current mode that the LED is set in hw
22462306a36Sopenharmony_ci	 * control mode and put them in flags.
22562306a36Sopenharmony_ci	 * Trigger can use this to get the initial state of a LED already set in
22662306a36Sopenharmony_ci	 * hardware blink control.
22762306a36Sopenharmony_ci	 *
22862306a36Sopenharmony_ci	 * Return 0 on success, a negative error number on failing parsing the
22962306a36Sopenharmony_ci	 * initial mode. Error from this function is NOT FATAL as the device
23062306a36Sopenharmony_ci	 * may be in a not supported initial state by the attached LED trigger.
23162306a36Sopenharmony_ci	 */
23262306a36Sopenharmony_ci	int			(*hw_control_get)(struct led_classdev *led_cdev,
23362306a36Sopenharmony_ci						  unsigned long *flags);
23462306a36Sopenharmony_ci	/*
23562306a36Sopenharmony_ci	 * Get the device this LED blinks in response to.
23662306a36Sopenharmony_ci	 * e.g. for a PHY LED, it is the network device. If the LED is
23762306a36Sopenharmony_ci	 * not yet associated to a device, return NULL.
23862306a36Sopenharmony_ci	 */
23962306a36Sopenharmony_ci	struct device		*(*hw_control_get_device)(struct led_classdev *led_cdev);
24062306a36Sopenharmony_ci#endif
24162306a36Sopenharmony_ci
24262306a36Sopenharmony_ci#ifdef CONFIG_LEDS_BRIGHTNESS_HW_CHANGED
24362306a36Sopenharmony_ci	int			 brightness_hw_changed;
24462306a36Sopenharmony_ci	struct kernfs_node	*brightness_hw_changed_kn;
24562306a36Sopenharmony_ci#endif
24662306a36Sopenharmony_ci
24762306a36Sopenharmony_ci	/* Ensures consistent access to the LED Flash Class device */
24862306a36Sopenharmony_ci	struct mutex		led_access;
24962306a36Sopenharmony_ci};
25062306a36Sopenharmony_ci
25162306a36Sopenharmony_ci/**
25262306a36Sopenharmony_ci * led_classdev_register_ext - register a new object of LED class with
25362306a36Sopenharmony_ci *			       init data
25462306a36Sopenharmony_ci * @parent: LED controller device this LED is driven by
25562306a36Sopenharmony_ci * @led_cdev: the led_classdev structure for this device
25662306a36Sopenharmony_ci * @init_data: the LED class device initialization data
25762306a36Sopenharmony_ci *
25862306a36Sopenharmony_ci * Register a new object of LED class, with name derived from init_data.
25962306a36Sopenharmony_ci *
26062306a36Sopenharmony_ci * Returns: 0 on success or negative error value on failure
26162306a36Sopenharmony_ci */
26262306a36Sopenharmony_ciint led_classdev_register_ext(struct device *parent,
26362306a36Sopenharmony_ci				     struct led_classdev *led_cdev,
26462306a36Sopenharmony_ci				     struct led_init_data *init_data);
26562306a36Sopenharmony_ci
26662306a36Sopenharmony_ci/**
26762306a36Sopenharmony_ci * led_classdev_register - register a new object of LED class
26862306a36Sopenharmony_ci * @parent: LED controller device this LED is driven by
26962306a36Sopenharmony_ci * @led_cdev: the led_classdev structure for this device
27062306a36Sopenharmony_ci *
27162306a36Sopenharmony_ci * Register a new object of LED class, with name derived from the name property
27262306a36Sopenharmony_ci * of passed led_cdev argument.
27362306a36Sopenharmony_ci *
27462306a36Sopenharmony_ci * Returns: 0 on success or negative error value on failure
27562306a36Sopenharmony_ci */
27662306a36Sopenharmony_cistatic inline int led_classdev_register(struct device *parent,
27762306a36Sopenharmony_ci					struct led_classdev *led_cdev)
27862306a36Sopenharmony_ci{
27962306a36Sopenharmony_ci	return led_classdev_register_ext(parent, led_cdev, NULL);
28062306a36Sopenharmony_ci}
28162306a36Sopenharmony_ci
28262306a36Sopenharmony_ci#if IS_ENABLED(CONFIG_LEDS_CLASS)
28362306a36Sopenharmony_ciint devm_led_classdev_register_ext(struct device *parent,
28462306a36Sopenharmony_ci					  struct led_classdev *led_cdev,
28562306a36Sopenharmony_ci					  struct led_init_data *init_data);
28662306a36Sopenharmony_ci#else
28762306a36Sopenharmony_cistatic inline int
28862306a36Sopenharmony_cidevm_led_classdev_register_ext(struct device *parent,
28962306a36Sopenharmony_ci			       struct led_classdev *led_cdev,
29062306a36Sopenharmony_ci			       struct led_init_data *init_data)
29162306a36Sopenharmony_ci{
29262306a36Sopenharmony_ci	return 0;
29362306a36Sopenharmony_ci}
29462306a36Sopenharmony_ci#endif
29562306a36Sopenharmony_ci
29662306a36Sopenharmony_cistatic inline int devm_led_classdev_register(struct device *parent,
29762306a36Sopenharmony_ci					     struct led_classdev *led_cdev)
29862306a36Sopenharmony_ci{
29962306a36Sopenharmony_ci	return devm_led_classdev_register_ext(parent, led_cdev, NULL);
30062306a36Sopenharmony_ci}
30162306a36Sopenharmony_civoid led_classdev_unregister(struct led_classdev *led_cdev);
30262306a36Sopenharmony_civoid devm_led_classdev_unregister(struct device *parent,
30362306a36Sopenharmony_ci				  struct led_classdev *led_cdev);
30462306a36Sopenharmony_civoid led_classdev_suspend(struct led_classdev *led_cdev);
30562306a36Sopenharmony_civoid led_classdev_resume(struct led_classdev *led_cdev);
30662306a36Sopenharmony_ci
30762306a36Sopenharmony_civoid led_add_lookup(struct led_lookup_data *led_lookup);
30862306a36Sopenharmony_civoid led_remove_lookup(struct led_lookup_data *led_lookup);
30962306a36Sopenharmony_ci
31062306a36Sopenharmony_cistruct led_classdev *__must_check led_get(struct device *dev, char *con_id);
31162306a36Sopenharmony_cistruct led_classdev *__must_check devm_led_get(struct device *dev, char *con_id);
31262306a36Sopenharmony_ci
31362306a36Sopenharmony_ciextern struct led_classdev *of_led_get(struct device_node *np, int index);
31462306a36Sopenharmony_ciextern void led_put(struct led_classdev *led_cdev);
31562306a36Sopenharmony_cistruct led_classdev *__must_check devm_of_led_get(struct device *dev,
31662306a36Sopenharmony_ci						  int index);
31762306a36Sopenharmony_cistruct led_classdev *__must_check devm_of_led_get_optional(struct device *dev,
31862306a36Sopenharmony_ci						  int index);
31962306a36Sopenharmony_ci
32062306a36Sopenharmony_ci/**
32162306a36Sopenharmony_ci * led_blink_set - set blinking with software fallback
32262306a36Sopenharmony_ci * @led_cdev: the LED to start blinking
32362306a36Sopenharmony_ci * @delay_on: the time it should be on (in ms)
32462306a36Sopenharmony_ci * @delay_off: the time it should ble off (in ms)
32562306a36Sopenharmony_ci *
32662306a36Sopenharmony_ci * This function makes the LED blink, attempting to use the
32762306a36Sopenharmony_ci * hardware acceleration if possible, but falling back to
32862306a36Sopenharmony_ci * software blinking if there is no hardware blinking or if
32962306a36Sopenharmony_ci * the LED refuses the passed values.
33062306a36Sopenharmony_ci *
33162306a36Sopenharmony_ci * This function may sleep!
33262306a36Sopenharmony_ci *
33362306a36Sopenharmony_ci * Note that if software blinking is active, simply calling
33462306a36Sopenharmony_ci * led_cdev->brightness_set() will not stop the blinking,
33562306a36Sopenharmony_ci * use led_set_brightness() instead.
33662306a36Sopenharmony_ci */
33762306a36Sopenharmony_civoid led_blink_set(struct led_classdev *led_cdev, unsigned long *delay_on,
33862306a36Sopenharmony_ci		   unsigned long *delay_off);
33962306a36Sopenharmony_ci
34062306a36Sopenharmony_ci/**
34162306a36Sopenharmony_ci * led_blink_set_nosleep - set blinking, guaranteed to not sleep
34262306a36Sopenharmony_ci * @led_cdev: the LED to start blinking
34362306a36Sopenharmony_ci * @delay_on: the time it should be on (in ms)
34462306a36Sopenharmony_ci * @delay_off: the time it should ble off (in ms)
34562306a36Sopenharmony_ci *
34662306a36Sopenharmony_ci * This function makes the LED blink and is guaranteed to not sleep. Otherwise
34762306a36Sopenharmony_ci * this is the same as led_blink_set(), see led_blink_set() for details.
34862306a36Sopenharmony_ci */
34962306a36Sopenharmony_civoid led_blink_set_nosleep(struct led_classdev *led_cdev, unsigned long delay_on,
35062306a36Sopenharmony_ci			   unsigned long delay_off);
35162306a36Sopenharmony_ci
35262306a36Sopenharmony_ci/**
35362306a36Sopenharmony_ci * led_blink_set_oneshot - do a oneshot software blink
35462306a36Sopenharmony_ci * @led_cdev: the LED to start blinking
35562306a36Sopenharmony_ci * @delay_on: the time it should be on (in ms)
35662306a36Sopenharmony_ci * @delay_off: the time it should ble off (in ms)
35762306a36Sopenharmony_ci * @invert: blink off, then on, leaving the led on
35862306a36Sopenharmony_ci *
35962306a36Sopenharmony_ci * This function makes the LED blink one time for delay_on +
36062306a36Sopenharmony_ci * delay_off time, ignoring the request if another one-shot
36162306a36Sopenharmony_ci * blink is already in progress.
36262306a36Sopenharmony_ci *
36362306a36Sopenharmony_ci * If invert is set, led blinks for delay_off first, then for
36462306a36Sopenharmony_ci * delay_on and leave the led on after the on-off cycle.
36562306a36Sopenharmony_ci *
36662306a36Sopenharmony_ci * This function is guaranteed not to sleep.
36762306a36Sopenharmony_ci */
36862306a36Sopenharmony_civoid led_blink_set_oneshot(struct led_classdev *led_cdev,
36962306a36Sopenharmony_ci			   unsigned long *delay_on, unsigned long *delay_off,
37062306a36Sopenharmony_ci			   int invert);
37162306a36Sopenharmony_ci/**
37262306a36Sopenharmony_ci * led_set_brightness - set LED brightness
37362306a36Sopenharmony_ci * @led_cdev: the LED to set
37462306a36Sopenharmony_ci * @brightness: the brightness to set it to
37562306a36Sopenharmony_ci *
37662306a36Sopenharmony_ci * Set an LED's brightness, and, if necessary, cancel the
37762306a36Sopenharmony_ci * software blink timer that implements blinking when the
37862306a36Sopenharmony_ci * hardware doesn't. This function is guaranteed not to sleep.
37962306a36Sopenharmony_ci */
38062306a36Sopenharmony_civoid led_set_brightness(struct led_classdev *led_cdev, unsigned int brightness);
38162306a36Sopenharmony_ci
38262306a36Sopenharmony_ci/**
38362306a36Sopenharmony_ci * led_set_brightness_sync - set LED brightness synchronously
38462306a36Sopenharmony_ci * @led_cdev: the LED to set
38562306a36Sopenharmony_ci * @value: the brightness to set it to
38662306a36Sopenharmony_ci *
38762306a36Sopenharmony_ci * Set an LED's brightness immediately. This function will block
38862306a36Sopenharmony_ci * the caller for the time required for accessing device registers,
38962306a36Sopenharmony_ci * and it can sleep.
39062306a36Sopenharmony_ci *
39162306a36Sopenharmony_ci * Returns: 0 on success or negative error value on failure
39262306a36Sopenharmony_ci */
39362306a36Sopenharmony_ciint led_set_brightness_sync(struct led_classdev *led_cdev, unsigned int value);
39462306a36Sopenharmony_ci
39562306a36Sopenharmony_ci/**
39662306a36Sopenharmony_ci * led_update_brightness - update LED brightness
39762306a36Sopenharmony_ci * @led_cdev: the LED to query
39862306a36Sopenharmony_ci *
39962306a36Sopenharmony_ci * Get an LED's current brightness and update led_cdev->brightness
40062306a36Sopenharmony_ci * member with the obtained value.
40162306a36Sopenharmony_ci *
40262306a36Sopenharmony_ci * Returns: 0 on success or negative error value on failure
40362306a36Sopenharmony_ci */
40462306a36Sopenharmony_ciint led_update_brightness(struct led_classdev *led_cdev);
40562306a36Sopenharmony_ci
40662306a36Sopenharmony_ci/**
40762306a36Sopenharmony_ci * led_get_default_pattern - return default pattern
40862306a36Sopenharmony_ci *
40962306a36Sopenharmony_ci * @led_cdev: the LED to get default pattern for
41062306a36Sopenharmony_ci * @size:     pointer for storing the number of elements in returned array,
41162306a36Sopenharmony_ci *            modified only if return != NULL
41262306a36Sopenharmony_ci *
41362306a36Sopenharmony_ci * Return:    Allocated array of integers with default pattern from device tree
41462306a36Sopenharmony_ci *            or NULL.  Caller is responsible for kfree().
41562306a36Sopenharmony_ci */
41662306a36Sopenharmony_ciu32 *led_get_default_pattern(struct led_classdev *led_cdev, unsigned int *size);
41762306a36Sopenharmony_ci
41862306a36Sopenharmony_ci/**
41962306a36Sopenharmony_ci * led_sysfs_disable - disable LED sysfs interface
42062306a36Sopenharmony_ci * @led_cdev: the LED to set
42162306a36Sopenharmony_ci *
42262306a36Sopenharmony_ci * Disable the led_cdev's sysfs interface.
42362306a36Sopenharmony_ci */
42462306a36Sopenharmony_civoid led_sysfs_disable(struct led_classdev *led_cdev);
42562306a36Sopenharmony_ci
42662306a36Sopenharmony_ci/**
42762306a36Sopenharmony_ci * led_sysfs_enable - enable LED sysfs interface
42862306a36Sopenharmony_ci * @led_cdev: the LED to set
42962306a36Sopenharmony_ci *
43062306a36Sopenharmony_ci * Enable the led_cdev's sysfs interface.
43162306a36Sopenharmony_ci */
43262306a36Sopenharmony_civoid led_sysfs_enable(struct led_classdev *led_cdev);
43362306a36Sopenharmony_ci
43462306a36Sopenharmony_ci/**
43562306a36Sopenharmony_ci * led_compose_name - compose LED class device name
43662306a36Sopenharmony_ci * @dev: LED controller device object
43762306a36Sopenharmony_ci * @init_data: the LED class device initialization data
43862306a36Sopenharmony_ci * @led_classdev_name: composed LED class device name
43962306a36Sopenharmony_ci *
44062306a36Sopenharmony_ci * Create LED class device name basing on the provided init_data argument.
44162306a36Sopenharmony_ci * The name can have <devicename:color:function> or <color:function>.
44262306a36Sopenharmony_ci * form, depending on the init_data configuration.
44362306a36Sopenharmony_ci *
44462306a36Sopenharmony_ci * Returns: 0 on success or negative error value on failure
44562306a36Sopenharmony_ci */
44662306a36Sopenharmony_ciint led_compose_name(struct device *dev, struct led_init_data *init_data,
44762306a36Sopenharmony_ci		     char *led_classdev_name);
44862306a36Sopenharmony_ci
44962306a36Sopenharmony_ci/**
45062306a36Sopenharmony_ci * led_sysfs_is_disabled - check if LED sysfs interface is disabled
45162306a36Sopenharmony_ci * @led_cdev: the LED to query
45262306a36Sopenharmony_ci *
45362306a36Sopenharmony_ci * Returns: true if the led_cdev's sysfs interface is disabled.
45462306a36Sopenharmony_ci */
45562306a36Sopenharmony_cistatic inline bool led_sysfs_is_disabled(struct led_classdev *led_cdev)
45662306a36Sopenharmony_ci{
45762306a36Sopenharmony_ci	return led_cdev->flags & LED_SYSFS_DISABLE;
45862306a36Sopenharmony_ci}
45962306a36Sopenharmony_ci
46062306a36Sopenharmony_ci/*
46162306a36Sopenharmony_ci * LED Triggers
46262306a36Sopenharmony_ci */
46362306a36Sopenharmony_ci/* Registration functions for simple triggers */
46462306a36Sopenharmony_ci#define DEFINE_LED_TRIGGER(x)		static struct led_trigger *x;
46562306a36Sopenharmony_ci#define DEFINE_LED_TRIGGER_GLOBAL(x)	struct led_trigger *x;
46662306a36Sopenharmony_ci
46762306a36Sopenharmony_ci#ifdef CONFIG_LEDS_TRIGGERS
46862306a36Sopenharmony_ci
46962306a36Sopenharmony_ci#define TRIG_NAME_MAX 50
47062306a36Sopenharmony_ci
47162306a36Sopenharmony_cistruct led_trigger {
47262306a36Sopenharmony_ci	/* Trigger Properties */
47362306a36Sopenharmony_ci	const char	 *name;
47462306a36Sopenharmony_ci	int		(*activate)(struct led_classdev *led_cdev);
47562306a36Sopenharmony_ci	void		(*deactivate)(struct led_classdev *led_cdev);
47662306a36Sopenharmony_ci
47762306a36Sopenharmony_ci	/* LED-private triggers have this set */
47862306a36Sopenharmony_ci	struct led_hw_trigger_type *trigger_type;
47962306a36Sopenharmony_ci
48062306a36Sopenharmony_ci	/* LEDs under control by this trigger (for simple triggers) */
48162306a36Sopenharmony_ci	spinlock_t	  leddev_list_lock;
48262306a36Sopenharmony_ci	struct list_head  led_cdevs;
48362306a36Sopenharmony_ci
48462306a36Sopenharmony_ci	/* Link to next registered trigger */
48562306a36Sopenharmony_ci	struct list_head  next_trig;
48662306a36Sopenharmony_ci
48762306a36Sopenharmony_ci	const struct attribute_group **groups;
48862306a36Sopenharmony_ci};
48962306a36Sopenharmony_ci
49062306a36Sopenharmony_ci/*
49162306a36Sopenharmony_ci * Currently the attributes in struct led_trigger::groups are added directly to
49262306a36Sopenharmony_ci * the LED device. As this might change in the future, the following
49362306a36Sopenharmony_ci * macros abstract getting the LED device and its trigger_data from the dev
49462306a36Sopenharmony_ci * parameter passed to the attribute accessor functions.
49562306a36Sopenharmony_ci */
49662306a36Sopenharmony_ci#define led_trigger_get_led(dev)	((struct led_classdev *)dev_get_drvdata((dev)))
49762306a36Sopenharmony_ci#define led_trigger_get_drvdata(dev)	(led_get_trigger_data(led_trigger_get_led(dev)))
49862306a36Sopenharmony_ci
49962306a36Sopenharmony_ci/* Registration functions for complex triggers */
50062306a36Sopenharmony_ciint led_trigger_register(struct led_trigger *trigger);
50162306a36Sopenharmony_civoid led_trigger_unregister(struct led_trigger *trigger);
50262306a36Sopenharmony_ciint devm_led_trigger_register(struct device *dev,
50362306a36Sopenharmony_ci				     struct led_trigger *trigger);
50462306a36Sopenharmony_ci
50562306a36Sopenharmony_civoid led_trigger_register_simple(const char *name,
50662306a36Sopenharmony_ci				struct led_trigger **trigger);
50762306a36Sopenharmony_civoid led_trigger_unregister_simple(struct led_trigger *trigger);
50862306a36Sopenharmony_civoid led_trigger_event(struct led_trigger *trigger,  enum led_brightness event);
50962306a36Sopenharmony_civoid led_trigger_blink(struct led_trigger *trigger, unsigned long delay_on,
51062306a36Sopenharmony_ci		       unsigned long delay_off);
51162306a36Sopenharmony_civoid led_trigger_blink_oneshot(struct led_trigger *trigger,
51262306a36Sopenharmony_ci			       unsigned long delay_on,
51362306a36Sopenharmony_ci			       unsigned long delay_off,
51462306a36Sopenharmony_ci			       int invert);
51562306a36Sopenharmony_civoid led_trigger_set_default(struct led_classdev *led_cdev);
51662306a36Sopenharmony_ciint led_trigger_set(struct led_classdev *led_cdev, struct led_trigger *trigger);
51762306a36Sopenharmony_civoid led_trigger_remove(struct led_classdev *led_cdev);
51862306a36Sopenharmony_ci
51962306a36Sopenharmony_cistatic inline void led_set_trigger_data(struct led_classdev *led_cdev,
52062306a36Sopenharmony_ci					void *trigger_data)
52162306a36Sopenharmony_ci{
52262306a36Sopenharmony_ci	led_cdev->trigger_data = trigger_data;
52362306a36Sopenharmony_ci}
52462306a36Sopenharmony_ci
52562306a36Sopenharmony_cistatic inline void *led_get_trigger_data(struct led_classdev *led_cdev)
52662306a36Sopenharmony_ci{
52762306a36Sopenharmony_ci	return led_cdev->trigger_data;
52862306a36Sopenharmony_ci}
52962306a36Sopenharmony_ci
53062306a36Sopenharmony_ci/**
53162306a36Sopenharmony_ci * led_trigger_rename_static - rename a trigger
53262306a36Sopenharmony_ci * @name: the new trigger name
53362306a36Sopenharmony_ci * @trig: the LED trigger to rename
53462306a36Sopenharmony_ci *
53562306a36Sopenharmony_ci * Change a LED trigger name by copying the string passed in
53662306a36Sopenharmony_ci * name into current trigger name, which MUST be large
53762306a36Sopenharmony_ci * enough for the new string.
53862306a36Sopenharmony_ci *
53962306a36Sopenharmony_ci * Note that name must NOT point to the same string used
54062306a36Sopenharmony_ci * during LED registration, as that could lead to races.
54162306a36Sopenharmony_ci *
54262306a36Sopenharmony_ci * This is meant to be used on triggers with statically
54362306a36Sopenharmony_ci * allocated name.
54462306a36Sopenharmony_ci */
54562306a36Sopenharmony_civoid led_trigger_rename_static(const char *name, struct led_trigger *trig);
54662306a36Sopenharmony_ci
54762306a36Sopenharmony_ci#define module_led_trigger(__led_trigger) \
54862306a36Sopenharmony_ci	module_driver(__led_trigger, led_trigger_register, \
54962306a36Sopenharmony_ci		      led_trigger_unregister)
55062306a36Sopenharmony_ci
55162306a36Sopenharmony_ci#else
55262306a36Sopenharmony_ci
55362306a36Sopenharmony_ci/* Trigger has no members */
55462306a36Sopenharmony_cistruct led_trigger {};
55562306a36Sopenharmony_ci
55662306a36Sopenharmony_ci/* Trigger inline empty functions */
55762306a36Sopenharmony_cistatic inline void led_trigger_register_simple(const char *name,
55862306a36Sopenharmony_ci					struct led_trigger **trigger) {}
55962306a36Sopenharmony_cistatic inline void led_trigger_unregister_simple(struct led_trigger *trigger) {}
56062306a36Sopenharmony_cistatic inline void led_trigger_event(struct led_trigger *trigger,
56162306a36Sopenharmony_ci				enum led_brightness event) {}
56262306a36Sopenharmony_cistatic inline void led_trigger_blink(struct led_trigger *trigger,
56362306a36Sopenharmony_ci				      unsigned long delay_on,
56462306a36Sopenharmony_ci				      unsigned long delay_off) {}
56562306a36Sopenharmony_cistatic inline void led_trigger_blink_oneshot(struct led_trigger *trigger,
56662306a36Sopenharmony_ci				      unsigned long delay_on,
56762306a36Sopenharmony_ci				      unsigned long delay_off,
56862306a36Sopenharmony_ci				      int invert) {}
56962306a36Sopenharmony_cistatic inline void led_trigger_set_default(struct led_classdev *led_cdev) {}
57062306a36Sopenharmony_cistatic inline int led_trigger_set(struct led_classdev *led_cdev,
57162306a36Sopenharmony_ci				  struct led_trigger *trigger)
57262306a36Sopenharmony_ci{
57362306a36Sopenharmony_ci	return 0;
57462306a36Sopenharmony_ci}
57562306a36Sopenharmony_ci
57662306a36Sopenharmony_cistatic inline void led_trigger_remove(struct led_classdev *led_cdev) {}
57762306a36Sopenharmony_cistatic inline void led_set_trigger_data(struct led_classdev *led_cdev) {}
57862306a36Sopenharmony_cistatic inline void *led_get_trigger_data(struct led_classdev *led_cdev)
57962306a36Sopenharmony_ci{
58062306a36Sopenharmony_ci	return NULL;
58162306a36Sopenharmony_ci}
58262306a36Sopenharmony_ci
58362306a36Sopenharmony_ci#endif /* CONFIG_LEDS_TRIGGERS */
58462306a36Sopenharmony_ci
58562306a36Sopenharmony_ci/* Trigger specific enum */
58662306a36Sopenharmony_cienum led_trigger_netdev_modes {
58762306a36Sopenharmony_ci	TRIGGER_NETDEV_LINK = 0,
58862306a36Sopenharmony_ci	TRIGGER_NETDEV_LINK_10,
58962306a36Sopenharmony_ci	TRIGGER_NETDEV_LINK_100,
59062306a36Sopenharmony_ci	TRIGGER_NETDEV_LINK_1000,
59162306a36Sopenharmony_ci	TRIGGER_NETDEV_HALF_DUPLEX,
59262306a36Sopenharmony_ci	TRIGGER_NETDEV_FULL_DUPLEX,
59362306a36Sopenharmony_ci	TRIGGER_NETDEV_TX,
59462306a36Sopenharmony_ci	TRIGGER_NETDEV_RX,
59562306a36Sopenharmony_ci
59662306a36Sopenharmony_ci	/* Keep last */
59762306a36Sopenharmony_ci	__TRIGGER_NETDEV_MAX,
59862306a36Sopenharmony_ci};
59962306a36Sopenharmony_ci
60062306a36Sopenharmony_ci/* Trigger specific functions */
60162306a36Sopenharmony_ci#ifdef CONFIG_LEDS_TRIGGER_DISK
60262306a36Sopenharmony_civoid ledtrig_disk_activity(bool write);
60362306a36Sopenharmony_ci#else
60462306a36Sopenharmony_cistatic inline void ledtrig_disk_activity(bool write) {}
60562306a36Sopenharmony_ci#endif
60662306a36Sopenharmony_ci
60762306a36Sopenharmony_ci#ifdef CONFIG_LEDS_TRIGGER_MTD
60862306a36Sopenharmony_civoid ledtrig_mtd_activity(void);
60962306a36Sopenharmony_ci#else
61062306a36Sopenharmony_cistatic inline void ledtrig_mtd_activity(void) {}
61162306a36Sopenharmony_ci#endif
61262306a36Sopenharmony_ci
61362306a36Sopenharmony_ci#if defined(CONFIG_LEDS_TRIGGER_CAMERA) || defined(CONFIG_LEDS_TRIGGER_CAMERA_MODULE)
61462306a36Sopenharmony_civoid ledtrig_flash_ctrl(bool on);
61562306a36Sopenharmony_civoid ledtrig_torch_ctrl(bool on);
61662306a36Sopenharmony_ci#else
61762306a36Sopenharmony_cistatic inline void ledtrig_flash_ctrl(bool on) {}
61862306a36Sopenharmony_cistatic inline void ledtrig_torch_ctrl(bool on) {}
61962306a36Sopenharmony_ci#endif
62062306a36Sopenharmony_ci
62162306a36Sopenharmony_ci/*
62262306a36Sopenharmony_ci * Generic LED platform data for describing LED names and default triggers.
62362306a36Sopenharmony_ci */
62462306a36Sopenharmony_cistruct led_info {
62562306a36Sopenharmony_ci	const char	*name;
62662306a36Sopenharmony_ci	const char	*default_trigger;
62762306a36Sopenharmony_ci	int		flags;
62862306a36Sopenharmony_ci};
62962306a36Sopenharmony_ci
63062306a36Sopenharmony_cistruct led_platform_data {
63162306a36Sopenharmony_ci	int		num_leds;
63262306a36Sopenharmony_ci	struct led_info	*leds;
63362306a36Sopenharmony_ci};
63462306a36Sopenharmony_ci
63562306a36Sopenharmony_cistruct led_properties {
63662306a36Sopenharmony_ci	u32		color;
63762306a36Sopenharmony_ci	bool		color_present;
63862306a36Sopenharmony_ci	const char	*function;
63962306a36Sopenharmony_ci	u32		func_enum;
64062306a36Sopenharmony_ci	bool		func_enum_present;
64162306a36Sopenharmony_ci	const char	*label;
64262306a36Sopenharmony_ci};
64362306a36Sopenharmony_ci
64462306a36Sopenharmony_citypedef int (*gpio_blink_set_t)(struct gpio_desc *desc, int state,
64562306a36Sopenharmony_ci				unsigned long *delay_on,
64662306a36Sopenharmony_ci				unsigned long *delay_off);
64762306a36Sopenharmony_ci
64862306a36Sopenharmony_ci/* For the leds-gpio driver */
64962306a36Sopenharmony_cistruct gpio_led {
65062306a36Sopenharmony_ci	const char *name;
65162306a36Sopenharmony_ci	const char *default_trigger;
65262306a36Sopenharmony_ci	unsigned 	gpio;
65362306a36Sopenharmony_ci	unsigned	active_low : 1;
65462306a36Sopenharmony_ci	unsigned	retain_state_suspended : 1;
65562306a36Sopenharmony_ci	unsigned	panic_indicator : 1;
65662306a36Sopenharmony_ci	unsigned	default_state : 2;
65762306a36Sopenharmony_ci	unsigned	retain_state_shutdown : 1;
65862306a36Sopenharmony_ci	/* default_state should be one of LEDS_GPIO_DEFSTATE_(ON|OFF|KEEP) */
65962306a36Sopenharmony_ci	struct gpio_desc *gpiod;
66062306a36Sopenharmony_ci};
66162306a36Sopenharmony_ci#define LEDS_GPIO_DEFSTATE_OFF		LEDS_DEFSTATE_OFF
66262306a36Sopenharmony_ci#define LEDS_GPIO_DEFSTATE_ON		LEDS_DEFSTATE_ON
66362306a36Sopenharmony_ci#define LEDS_GPIO_DEFSTATE_KEEP		LEDS_DEFSTATE_KEEP
66462306a36Sopenharmony_ci
66562306a36Sopenharmony_cistruct gpio_led_platform_data {
66662306a36Sopenharmony_ci	int 		num_leds;
66762306a36Sopenharmony_ci	const struct gpio_led *leds;
66862306a36Sopenharmony_ci
66962306a36Sopenharmony_ci#define GPIO_LED_NO_BLINK_LOW	0	/* No blink GPIO state low */
67062306a36Sopenharmony_ci#define GPIO_LED_NO_BLINK_HIGH	1	/* No blink GPIO state high */
67162306a36Sopenharmony_ci#define GPIO_LED_BLINK		2	/* Please, blink */
67262306a36Sopenharmony_ci	gpio_blink_set_t	gpio_blink_set;
67362306a36Sopenharmony_ci};
67462306a36Sopenharmony_ci
67562306a36Sopenharmony_ci#ifdef CONFIG_NEW_LEDS
67662306a36Sopenharmony_cistruct platform_device *gpio_led_register_device(
67762306a36Sopenharmony_ci		int id, const struct gpio_led_platform_data *pdata);
67862306a36Sopenharmony_ci#else
67962306a36Sopenharmony_cistatic inline struct platform_device *gpio_led_register_device(
68062306a36Sopenharmony_ci		int id, const struct gpio_led_platform_data *pdata)
68162306a36Sopenharmony_ci{
68262306a36Sopenharmony_ci	return 0;
68362306a36Sopenharmony_ci}
68462306a36Sopenharmony_ci#endif
68562306a36Sopenharmony_ci
68662306a36Sopenharmony_cienum cpu_led_event {
68762306a36Sopenharmony_ci	CPU_LED_IDLE_START,	/* CPU enters idle */
68862306a36Sopenharmony_ci	CPU_LED_IDLE_END,	/* CPU idle ends */
68962306a36Sopenharmony_ci	CPU_LED_START,		/* Machine starts, especially resume */
69062306a36Sopenharmony_ci	CPU_LED_STOP,		/* Machine stops, especially suspend */
69162306a36Sopenharmony_ci	CPU_LED_HALTED,		/* Machine shutdown */
69262306a36Sopenharmony_ci};
69362306a36Sopenharmony_ci#ifdef CONFIG_LEDS_TRIGGER_CPU
69462306a36Sopenharmony_civoid ledtrig_cpu(enum cpu_led_event evt);
69562306a36Sopenharmony_ci#else
69662306a36Sopenharmony_cistatic inline void ledtrig_cpu(enum cpu_led_event evt)
69762306a36Sopenharmony_ci{
69862306a36Sopenharmony_ci	return;
69962306a36Sopenharmony_ci}
70062306a36Sopenharmony_ci#endif
70162306a36Sopenharmony_ci
70262306a36Sopenharmony_ci#ifdef CONFIG_LEDS_BRIGHTNESS_HW_CHANGED
70362306a36Sopenharmony_civoid led_classdev_notify_brightness_hw_changed(
70462306a36Sopenharmony_ci	struct led_classdev *led_cdev, unsigned int brightness);
70562306a36Sopenharmony_ci#else
70662306a36Sopenharmony_cistatic inline void led_classdev_notify_brightness_hw_changed(
70762306a36Sopenharmony_ci	struct led_classdev *led_cdev, enum led_brightness brightness) { }
70862306a36Sopenharmony_ci#endif
70962306a36Sopenharmony_ci
71062306a36Sopenharmony_ci/**
71162306a36Sopenharmony_ci * struct led_pattern - pattern interval settings
71262306a36Sopenharmony_ci * @delta_t: pattern interval delay, in milliseconds
71362306a36Sopenharmony_ci * @brightness: pattern interval brightness
71462306a36Sopenharmony_ci */
71562306a36Sopenharmony_cistruct led_pattern {
71662306a36Sopenharmony_ci	u32 delta_t;
71762306a36Sopenharmony_ci	int brightness;
71862306a36Sopenharmony_ci};
71962306a36Sopenharmony_ci
72062306a36Sopenharmony_cienum led_audio {
72162306a36Sopenharmony_ci	LED_AUDIO_MUTE,		/* master mute LED */
72262306a36Sopenharmony_ci	LED_AUDIO_MICMUTE,	/* mic mute LED */
72362306a36Sopenharmony_ci	NUM_AUDIO_LEDS
72462306a36Sopenharmony_ci};
72562306a36Sopenharmony_ci
72662306a36Sopenharmony_ci#if IS_ENABLED(CONFIG_LEDS_TRIGGER_AUDIO)
72762306a36Sopenharmony_cienum led_brightness ledtrig_audio_get(enum led_audio type);
72862306a36Sopenharmony_civoid ledtrig_audio_set(enum led_audio type, enum led_brightness state);
72962306a36Sopenharmony_ci#else
73062306a36Sopenharmony_cistatic inline enum led_brightness ledtrig_audio_get(enum led_audio type)
73162306a36Sopenharmony_ci{
73262306a36Sopenharmony_ci	return LED_OFF;
73362306a36Sopenharmony_ci}
73462306a36Sopenharmony_cistatic inline void ledtrig_audio_set(enum led_audio type,
73562306a36Sopenharmony_ci				     enum led_brightness state)
73662306a36Sopenharmony_ci{
73762306a36Sopenharmony_ci}
73862306a36Sopenharmony_ci#endif
73962306a36Sopenharmony_ci
74062306a36Sopenharmony_ci#endif		/* __LINUX_LEDS_H_INCLUDED */
741