[deliverable/linux.git] / Documentation / devicetree / bindings / leds / leds-bcm6358.txt

LEDs connected to Broadcom BCM6358 controller

This controller is present on BCM6358 and BCM6368.
In these SoCs there are Serial LEDs (LEDs connected to a 74x164 controller),
which can either be controlled by software (exporting the 74x164 as spi-gpio.
See Documentation/devicetree/bindings/gpio/gpio-74x164.txt), or
by hardware using this driver.

Required properties:
  - compatible : should be "brcm,bcm6358-leds".
  - #address-cells : must be 1.
  - #size-cells : must be 0.
  - reg : BCM6358 LED controller address and size.

Optional properties:
  - brcm,clk-div : SCK signal divider. Possible values are 1, 2, 4 and 8.
    Default : 1
  - brcm,clk-dat-low : Boolean, makes clock and data signals active low.
    Default : false

Each LED is represented as a sub-node of the brcm,bcm6358-leds device.

LED sub-node required properties:
  - reg : LED pin number (only LEDs 0 to 31 are valid).

LED sub-node optional properties:
  - label : see Documentation/devicetree/bindings/leds/common.txt
  - active-low : Boolean, makes LED active low.
    Default : false
  - default-state : see
    Documentation/devicetree/bindings/leds/leds-gpio.txt
  - linux,default-trigger : see
    Documentation/devicetree/bindings/leds/common.txt

Examples:
Scenario 1 : BCM6358
	leds0: led-controller@fffe00d0 {
		compatible = "brcm,bcm6358-leds";
		#address-cells = <1>;
		#size-cells = <0>;
		reg = <0xfffe00d0 0x8>;

		alarm_white {
			reg = <0>;
			active-low;
			label = "white:alarm";
		};
		tv_white {
			reg = <2>;
			active-low;
			label = "white:tv";
		};
		tel_white {
			reg = <3>;
			active-low;
			label = "white:tel";
		};
		adsl_white {
			reg = <4>;
			active-low;
			label = "white:adsl";
		};
	};

Scenario 2 : BCM6368
	leds0: led-controller@100000d0 {
		compatible = "brcm,bcm6358-leds";
		#address-cells = <1>;
		#size-cells = <0>;
		reg = <0x100000d0 0x8>;
		brcm,pol-low;
		brcm,clk-div = <4>;

		power_red {
			reg = <0>;
			active-low;
			label = "red:power";
		};
		power_green {
			reg = <1>;
			active-low;
			label = "green:power";
			default-state = "on";
		};
		power_blue {
			reg = <2>;
			label = "blue:power";
		};
		broadband_red {
			reg = <3>;
			active-low;
			label = "red:broadband";
		};
		broadband_green {
			reg = <4>;
			label = "green:broadband";
		};
		broadband_blue {
			reg = <5>;
			active-low;
			label = "blue:broadband";
		};
		wireless_red {
			reg = <6>;
			active-low;
			label = "red:wireless";
		};
		wireless_green {
			reg = <7>;
			active-low;
			label = "green:wireless";
		};
		wireless_blue {
			reg = <8>;
			label = "blue:wireless";
		};
		phone_red {
			reg = <9>;
			active-low;
			label = "red:phone";
		};
		phone_green {
			reg = <10>;
			active-low;
			label = "green:phone";
		};
		phone_blue {
			reg = <11>;
			label = "blue:phone";
		};
		upgrading_red {
			reg = <12>;
			active-low;
			label = "red:upgrading";
		};
		upgrading_green {
			reg = <13>;
			active-low;
			label = "green:upgrading";
		};
		upgrading_blue {
			reg = <14>;
			label = "blue:upgrading";
		};
	};
Commit	Line	Data
c87cc342 ÁFR	1	LEDs connected to Broadcom BCM6358 controller
	2
	3	This controller is present on BCM6358 and BCM6368.
	4	In these SoCs there are Serial LEDs (LEDs connected to a 74x164 controller),
	5	which can either be controlled by software (exporting the 74x164 as spi-gpio.
	6	See Documentation/devicetree/bindings/gpio/gpio-74x164.txt), or
	7	by hardware using this driver.
	8
	9	Required properties:
	10	- compatible : should be "brcm,bcm6358-leds".
	11	- #address-cells : must be 1.
	12	- #size-cells : must be 0.
	13	- reg : BCM6358 LED controller address and size.
	14
	15	Optional properties:
	16	- brcm,clk-div : SCK signal divider. Possible values are 1, 2, 4 and 8.
	17	Default : 1
	18	- brcm,clk-dat-low : Boolean, makes clock and data signals active low.
	19	Default : false
	20
	21	Each LED is represented as a sub-node of the brcm,bcm6358-leds device.
	22
	23	LED sub-node required properties:
	24	- reg : LED pin number (only LEDs 0 to 31 are valid).
	25
	26	LED sub-node optional properties:
	27	- label : see Documentation/devicetree/bindings/leds/common.txt
	28	- active-low : Boolean, makes LED active low.
	29	Default : false
	30	- default-state : see
	31	Documentation/devicetree/bindings/leds/leds-gpio.txt
	32	- linux,default-trigger : see
	33	Documentation/devicetree/bindings/leds/common.txt
	34
	35	Examples:
	36	Scenario 1 : BCM6358
	37	leds0: led-controller@fffe00d0 {
	38	compatible = "brcm,bcm6358-leds";
	39	#address-cells = <1>;
	40	#size-cells = <0>;
	41	reg = <0xfffe00d0 0x8>;
	42
	43	alarm_white {
	44	reg = <0>;
	45	active-low;
	46	label = "white:alarm";
	47	};
	48	tv_white {
	49	reg = <2>;
	50	active-low;
	51	label = "white:tv";
	52	};
	53	tel_white {
	54	reg = <3>;
	55	active-low;
	56	label = "white:tel";
	57	};
	58	adsl_white {
	59	reg = <4>;
	60	active-low;
	61	label = "white:adsl";
	62	};
	63	};
	64
65	Scenario 2 : BCM6368
66	leds0: led-controller@100000d0 {
67	compatible = "brcm,bcm6358-leds";
68	#address-cells = <1>;
69	#size-cells = <0>;
70	reg = <0x100000d0 0x8>;
71	brcm,pol-low;
72	brcm,clk-div = <4>;
73
74	power_red {
75	reg = <0>;
76	active-low;
77	label = "red:power";
78	};
79	power_green {
80	reg = <1>;
81	active-low;
82	label = "green:power";
83	default-state = "on";
84	};
85	power_blue {
86	reg = <2>;
87	label = "blue:power";
88	};
89	broadband_red {
90	reg = <3>;
91	active-low;
92	label = "red:broadband";
93	};
94	broadband_green {
95	reg = <4>;
96	label = "green:broadband";
97	};
98	broadband_blue {
99	reg = <5>;
100	active-low;
101	label = "blue:broadband";
102	};
103	wireless_red {
104	reg = <6>;
105	active-low;
106	label = "red:wireless";
107	};
108	wireless_green {
109	reg = <7>;
110	active-low;
111	label = "green:wireless";
112	};
113	wireless_blue {
114	reg = <8>;
115	label = "blue:wireless";
116	};
117	phone_red {
118	reg = <9>;
119	active-low;
120	label = "red:phone";
121	};
122	phone_green {
123	reg = <10>;
124	active-low;
125	label = "green:phone";
126	};
127	phone_blue {
128	reg = <11>;
129	label = "blue:phone";
130	};
131	upgrading_red {
132	reg = <12>;
133	active-low;
134	label = "red:upgrading";
135	};
136	upgrading_green {
137	reg = <13>;
138	active-low;
139	label = "green:upgrading";
140	};
141	upgrading_blue {
142	reg = <14>;
143	label = "blue:upgrading";
144	};
145	};