Merge tag 'dma-mapping-5.15' of git://git.infradead.org/users/hch/dma-mapping
[linux-2.6-microblaze.git] / Documentation / leds / leds-mlxcpld.rst
1 =======================================
2 Kernel driver for Mellanox systems LEDs
3 =======================================
4
5 Provide system LED support for the nex Mellanox systems:
6 "msx6710", "msx6720", "msb7700", "msn2700", "msx1410",
7 "msn2410", "msb7800", "msn2740", "msn2100".
8
9 Description
10 -----------
11 Driver 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
64 Driver 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
117 Driver supports HW blinking at 3Hz and 6Hz frequency (50% duty cycle).
118 For 3Hz duty cylce is about 167 msec, for 6Hz is about 83 msec.