1 ========================
2 Kernel driver for lp5523
3 ========================
4
5 * National Semiconductor LP5523 led driver chi
6 * Datasheet: http://www.national.com/pf/LP/LP5
7
8 Authors: Mathias Nyman, Yuri Zaporozhets, Samu
9 Contact: Samu Onkalo (samu.p.onkalo-at-nokia.c
10
11 Description
12 -----------
13 LP5523 can drive up to 9 channels. Leds can be
14 the led class control interface.
15 The name of each channel is configurable in th
16 There are three options to make the channel na
17
18 a) Define the 'name' in the platform data
19
20 To make specific channel name, then use 'name'
21
22 - /sys/class/leds/R1 (name: 'R1'
23 - /sys/class/leds/B1 (name: 'B1'
24
25 b) Use the 'label' with no 'name' field
26
27 For one device name with channel number, then
28 - /sys/class/leds/RGB:channelN (label: 'RG
29
30 c) Default
31
32 If both fields are NULL, 'lp5523' is used by d
33 - /sys/class/leds/lp5523:channelN (N: 0 ~ 8)
34
35 LP5523 has the internal program memory for run
36 There are two ways to run LED patterns.
37
38 1) Legacy interface - enginex_mode, enginex_lo
39
40 Control interface for the engines:
41
42 x is 1 .. 3
43
44 enginex_mode:
45 disabled, load, run
46 enginex_load:
47 microcode load
48 enginex_leds:
49 led mux control
50
51 ::
52
53 cd /sys/class/leds/lp5523:channel2/dev
54 echo "load" > engine3_mode
55 echo "9d80400004ff05ff437f0000" > engi
56 echo "111111111" > engine3_leds
57 echo "run" > engine3_mode
58
59 To stop the engine::
60
61 echo "disabled" > engine3_mode
62
63 2) Firmware interface - LP55xx common interfac
64
65 For the details, please refer to 'firmware' se
66
67 LP5523 has three master faders. If a channel i
68 the master faders, its output is dimmed based
69 fader.
70
71 For example::
72
73 echo "123000123" > master_fader_leds
74
75 creates the following channel-fader mappings::
76
77 channel 0,6 to master_fader1
78 channel 1,7 to master_fader2
79 channel 2,8 to master_fader3
80
81 Then, to have 25% of the original output on ch
82
83 echo 64 > master_fader1
84
85 To have 0% of the original output (i.e. no out
86
87 echo 0 > master_fader2
88
89 To have 100% of the original output (i.e. no d
90
91 echo 255 > master_fader3
92
93 To clear all master fader controls::
94
95 echo "000000000" > master_fader_leds
96
97 Selftest uses always the current from the plat
98
99 Each channel contains led current settings.
100 - /sys/class/leds/lp5523:channel2/led_current
101 - /sys/class/leds/lp5523:channel2/max_current
102
103 Format: 10x mA i.e 10 means 1.0 mA
104
105 Example platform data::
106
107 static struct lp55xx_led_config lp5523
108 {
109 .name = "D1"
110 .chan_nr = 0,
111 .led_current = 50,
112 .max_current = 130,
113 },
114 ...
115 {
116 .chan_nr = 8,
117 .led_current = 50,
118 .max_current = 130,
119 }
120 };
121
122 static int lp5523_setup(void)
123 {
124 /* Setup HW resources */
125 }
126
127 static void lp5523_release(void)
128 {
129 /* Release HW resources */
130 }
131
132 static void lp5523_enable(bool state)
133 {
134 /* Control chip enable signal
135 }
136
137 static struct lp55xx_platform_data lp5
138 .led_config = lp5523_led_c
139 .num_channels = ARRAY_SIZE(l
140 .clock_mode = LP55XX_CLOCK
141 .setup_resources = lp5523_se
142 .release_resources = lp5523_re
143 .enable = lp5523_en
144 };
145
146 Note
147 chan_nr can have values between 0 and 8.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.