xref: /linux/Documentation/leds/leds-mlxcpld.rst (revision 0526b56cbc3c489642bd6a5fe4b718dea7ef0ee8)
1=======================================
2Kernel driver for Mellanox systems LEDs
3=======================================
4
5Provide system LED support for the nex Mellanox systems:
6"msx6710", "msx6720", "msb7700", "msn2700", "msx1410",
7"msn2410", "msb7800", "msn2740", "msn2100".
8
9Description
10-----------
11Driver provides the following LEDs for the systems "msx6710", "msx6720",
12"msb7700", "msn2700", "msx1410", "msn2410", "msb7800", "msn2740":
13
14  - mlxcpld:fan1:green
15  - mlxcpld:fan1:red
16  - mlxcpld:fan2:green
17  - mlxcpld:fan2:red
18  - mlxcpld:fan3:green
19  - mlxcpld:fan3:red
20  - mlxcpld:fan4:green
21  - mlxcpld:fan4:red
22  - mlxcpld:psu:green
23  - mlxcpld:psu:red
24  - mlxcpld:status:green
25  - mlxcpld:status:red
26
27 "status"
28  - CPLD reg offset: 0x20
29  - Bits [3:0]
30
31 "psu"
32  - CPLD reg offset: 0x20
33  - Bits [7:4]
34
35 "fan1"
36  - CPLD reg offset: 0x21
37  - Bits [3:0]
38
39 "fan2"
40  - CPLD reg offset: 0x21
41  - Bits [7:4]
42
43 "fan3"
44  - CPLD reg offset: 0x22
45  - Bits [3:0]
46
47 "fan4"
48  - CPLD reg offset: 0x22
49  - Bits [7:4]
50
51 Color mask for all the above LEDs:
52
53  [bit3,bit2,bit1,bit0] or
54  [bit7,bit6,bit5,bit4]:
55
56	- [0,0,0,0] = LED OFF
57	- [0,1,0,1] = Red static ON
58	- [1,1,0,1] = Green static ON
59	- [0,1,1,0] = Red blink 3Hz
60	- [1,1,1,0] = Green blink 3Hz
61	- [0,1,1,1] = Red blink 6Hz
62	- [1,1,1,1] = Green blink 6Hz
63
64Driver provides the following LEDs for the system "msn2100":
65
66  - mlxcpld:fan:green
67  - mlxcpld:fan:red
68  - mlxcpld:psu1:green
69  - mlxcpld:psu1:red
70  - mlxcpld:psu2:green
71  - mlxcpld:psu2:red
72  - mlxcpld:status:green
73  - mlxcpld:status:red
74  - mlxcpld:uid:blue
75
76 "status"
77  - CPLD reg offset: 0x20
78  - Bits [3:0]
79
80 "fan"
81  - CPLD reg offset: 0x21
82  - Bits [3:0]
83
84 "psu1"
85  - CPLD reg offset: 0x23
86  - Bits [3:0]
87
88 "psu2"
89  - CPLD reg offset: 0x23
90  - Bits [7:4]
91
92 "uid"
93  - CPLD reg offset: 0x24
94  - Bits [3:0]
95
96 Color mask for all the above LEDs, excepted uid:
97
98  [bit3,bit2,bit1,bit0] or
99  [bit7,bit6,bit5,bit4]:
100
101	- [0,0,0,0] = LED OFF
102	- [0,1,0,1] = Red static ON
103	- [1,1,0,1] = Green static ON
104	- [0,1,1,0] = Red blink 3Hz
105	- [1,1,1,0] = Green blink 3Hz
106	- [0,1,1,1] = Red blink 6Hz
107	- [1,1,1,1] = Green blink 6Hz
108
109 Color mask for uid LED:
110  [bit3,bit2,bit1,bit0]:
111
112	- [0,0,0,0] = LED OFF
113	- [1,1,0,1] = Blue static ON
114	- [1,1,1,0] = Blue blink 3Hz
115	- [1,1,1,1] = Blue blink 6Hz
116
117Driver supports HW blinking at 3Hz and 6Hz frequency (50% duty cycle).
118For 3Hz duty cylce is about 167 msec, for 6Hz is about 83 msec.
119