1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * console driver for LCD2S 4x20 character displays connected through i2c.
4 * The display also has a spi interface, but the driver does not support
5 * this yet.
6 *
7 * This is a driver allowing you to use a LCD2S 4x20 from modtronix
8 * engineering as auxdisplay character device.
9 *
10 * (C) 2019 by Lemonage Software GmbH
11 * Author: Lars Pöschel <poeschel@lemonage.de>
12 * All rights reserved.
13 */
14 #include <linux/kernel.h>
15 #include <linux/module.h>
16 #include <linux/slab.h>
17 #include <linux/i2c.h>
18 #include <linux/delay.h>
19
20 #include "charlcd.h"
21
22 #define LCD2S_CMD_CUR_MOVES_FWD 0x09
23 #define LCD2S_CMD_CUR_BLINK_OFF 0x10
24 #define LCD2S_CMD_CUR_UL_OFF 0x11
25 #define LCD2S_CMD_DISPLAY_OFF 0x12
26 #define LCD2S_CMD_CUR_BLINK_ON 0x18
27 #define LCD2S_CMD_CUR_UL_ON 0x19
28 #define LCD2S_CMD_DISPLAY_ON 0x1a
29 #define LCD2S_CMD_BACKLIGHT_OFF 0x20
30 #define LCD2S_CMD_BACKLIGHT_ON 0x28
31 #define LCD2S_CMD_WRITE 0x80
32 #define LCD2S_CMD_MOV_CUR_RIGHT 0x83
33 #define LCD2S_CMD_MOV_CUR_LEFT 0x84
34 #define LCD2S_CMD_SHIFT_RIGHT 0x85
35 #define LCD2S_CMD_SHIFT_LEFT 0x86
36 #define LCD2S_CMD_SHIFT_UP 0x87
37 #define LCD2S_CMD_SHIFT_DOWN 0x88
38 #define LCD2S_CMD_CUR_ADDR 0x89
39 #define LCD2S_CMD_CUR_POS 0x8a
40 #define LCD2S_CMD_CUR_RESET 0x8b
41 #define LCD2S_CMD_CLEAR 0x8c
42 #define LCD2S_CMD_DEF_CUSTOM_CHAR 0x92
43 #define LCD2S_CMD_READ_STATUS 0xd0
44
45 #define LCD2S_CHARACTER_SIZE 8
46
47 #define LCD2S_STATUS_BUF_MASK 0x7f
48
49 struct lcd2s_data {
50 struct i2c_client *i2c;
51 struct charlcd *charlcd;
52 };
53
lcd2s_wait_buf_free(const struct i2c_client * client,int count)54 static s32 lcd2s_wait_buf_free(const struct i2c_client *client, int count)
55 {
56 s32 status;
57
58 status = i2c_smbus_read_byte_data(client, LCD2S_CMD_READ_STATUS);
59 if (status < 0)
60 return status;
61
62 while ((status & LCD2S_STATUS_BUF_MASK) < count) {
63 mdelay(1);
64 status = i2c_smbus_read_byte_data(client,
65 LCD2S_CMD_READ_STATUS);
66 if (status < 0)
67 return status;
68 }
69 return 0;
70 }
71
lcd2s_i2c_master_send(const struct i2c_client * client,const char * buf,int count)72 static int lcd2s_i2c_master_send(const struct i2c_client *client,
73 const char *buf, int count)
74 {
75 s32 status;
76
77 status = lcd2s_wait_buf_free(client, count);
78 if (status < 0)
79 return status;
80
81 return i2c_master_send(client, buf, count);
82 }
83
lcd2s_i2c_smbus_write_byte(const struct i2c_client * client,u8 value)84 static int lcd2s_i2c_smbus_write_byte(const struct i2c_client *client, u8 value)
85 {
86 s32 status;
87
88 status = lcd2s_wait_buf_free(client, 1);
89 if (status < 0)
90 return status;
91
92 return i2c_smbus_write_byte(client, value);
93 }
94
lcd2s_print(struct charlcd * lcd,int c)95 static int lcd2s_print(struct charlcd *lcd, int c)
96 {
97 struct lcd2s_data *lcd2s = lcd->drvdata;
98 u8 buf[2] = { LCD2S_CMD_WRITE, c };
99
100 lcd2s_i2c_master_send(lcd2s->i2c, buf, sizeof(buf));
101 return 0;
102 }
103
lcd2s_gotoxy(struct charlcd * lcd,unsigned int x,unsigned int y)104 static int lcd2s_gotoxy(struct charlcd *lcd, unsigned int x, unsigned int y)
105 {
106 struct lcd2s_data *lcd2s = lcd->drvdata;
107 u8 buf[] = { LCD2S_CMD_CUR_POS, y + 1, x + 1};
108
109 lcd2s_i2c_master_send(lcd2s->i2c, buf, sizeof(buf));
110
111 return 0;
112 }
113
lcd2s_home(struct charlcd * lcd)114 static int lcd2s_home(struct charlcd *lcd)
115 {
116 struct lcd2s_data *lcd2s = lcd->drvdata;
117
118 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_CUR_RESET);
119 return 0;
120 }
121
lcd2s_init_display(struct charlcd * lcd)122 static int lcd2s_init_display(struct charlcd *lcd)
123 {
124 struct lcd2s_data *lcd2s = lcd->drvdata;
125
126 /* turn everything off, but display on */
127 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_DISPLAY_ON);
128 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_BACKLIGHT_OFF);
129 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_CUR_MOVES_FWD);
130 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_CUR_BLINK_OFF);
131 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_CUR_UL_OFF);
132 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_CLEAR);
133
134 return 0;
135 }
136
lcd2s_shift_cursor(struct charlcd * lcd,enum charlcd_shift_dir dir)137 static int lcd2s_shift_cursor(struct charlcd *lcd, enum charlcd_shift_dir dir)
138 {
139 struct lcd2s_data *lcd2s = lcd->drvdata;
140
141 if (dir == CHARLCD_SHIFT_LEFT)
142 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_MOV_CUR_LEFT);
143 else
144 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_MOV_CUR_RIGHT);
145
146 return 0;
147 }
148
lcd2s_shift_display(struct charlcd * lcd,enum charlcd_shift_dir dir)149 static int lcd2s_shift_display(struct charlcd *lcd, enum charlcd_shift_dir dir)
150 {
151 struct lcd2s_data *lcd2s = lcd->drvdata;
152
153 if (dir == CHARLCD_SHIFT_LEFT)
154 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_SHIFT_LEFT);
155 else
156 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_SHIFT_RIGHT);
157
158 return 0;
159 }
160
lcd2s_backlight(struct charlcd * lcd,enum charlcd_onoff on)161 static void lcd2s_backlight(struct charlcd *lcd, enum charlcd_onoff on)
162 {
163 struct lcd2s_data *lcd2s = lcd->drvdata;
164
165 if (on)
166 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_BACKLIGHT_ON);
167 else
168 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_BACKLIGHT_OFF);
169 }
170
lcd2s_display(struct charlcd * lcd,enum charlcd_onoff on)171 static int lcd2s_display(struct charlcd *lcd, enum charlcd_onoff on)
172 {
173 struct lcd2s_data *lcd2s = lcd->drvdata;
174
175 if (on)
176 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_DISPLAY_ON);
177 else
178 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_DISPLAY_OFF);
179
180 return 0;
181 }
182
lcd2s_cursor(struct charlcd * lcd,enum charlcd_onoff on)183 static int lcd2s_cursor(struct charlcd *lcd, enum charlcd_onoff on)
184 {
185 struct lcd2s_data *lcd2s = lcd->drvdata;
186
187 if (on)
188 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_CUR_UL_ON);
189 else
190 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_CUR_UL_OFF);
191
192 return 0;
193 }
194
lcd2s_blink(struct charlcd * lcd,enum charlcd_onoff on)195 static int lcd2s_blink(struct charlcd *lcd, enum charlcd_onoff on)
196 {
197 struct lcd2s_data *lcd2s = lcd->drvdata;
198
199 if (on)
200 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_CUR_BLINK_ON);
201 else
202 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_CUR_BLINK_OFF);
203
204 return 0;
205 }
206
lcd2s_fontsize(struct charlcd * lcd,enum charlcd_fontsize size)207 static int lcd2s_fontsize(struct charlcd *lcd, enum charlcd_fontsize size)
208 {
209 return 0;
210 }
211
lcd2s_lines(struct charlcd * lcd,enum charlcd_lines lines)212 static int lcd2s_lines(struct charlcd *lcd, enum charlcd_lines lines)
213 {
214 return 0;
215 }
216
lcd2s_redefine_char(struct charlcd * lcd,char * esc)217 static int lcd2s_redefine_char(struct charlcd *lcd, char *esc)
218 {
219 /* Generator : LGcxxxxx...xx; must have <c> between '0'
220 * and '7', representing the numerical ASCII code of the
221 * redefined character, and <xx...xx> a sequence of 16
222 * hex digits representing 8 bytes for each character.
223 * Most LCDs will only use 5 lower bits of the 7 first
224 * bytes.
225 */
226
227 struct lcd2s_data *lcd2s = lcd->drvdata;
228 u8 buf[LCD2S_CHARACTER_SIZE + 2] = { LCD2S_CMD_DEF_CUSTOM_CHAR };
229 u8 value;
230 int shift, i;
231
232 if (!strchr(esc, ';'))
233 return 0;
234
235 esc++;
236
237 buf[1] = *(esc++) - '0';
238 if (buf[1] > 7)
239 return 1;
240
241 i = 2;
242 shift = 0;
243 value = 0;
244 while (*esc && i < LCD2S_CHARACTER_SIZE + 2) {
245 int half;
246
247 shift ^= 4;
248 half = hex_to_bin(*esc++);
249 if (half < 0)
250 continue;
251
252 value |= half << shift;
253 if (shift == 0) {
254 buf[i++] = value;
255 value = 0;
256 }
257 }
258
259 lcd2s_i2c_master_send(lcd2s->i2c, buf, sizeof(buf));
260 return 1;
261 }
262
lcd2s_clear_display(struct charlcd * lcd)263 static int lcd2s_clear_display(struct charlcd *lcd)
264 {
265 struct lcd2s_data *lcd2s = lcd->drvdata;
266
267 /* This implicitly sets cursor to first row and column */
268 lcd2s_i2c_smbus_write_byte(lcd2s->i2c, LCD2S_CMD_CLEAR);
269 return 0;
270 }
271
272 static const struct charlcd_ops lcd2s_ops = {
273 .print = lcd2s_print,
274 .backlight = lcd2s_backlight,
275 .gotoxy = lcd2s_gotoxy,
276 .home = lcd2s_home,
277 .clear_display = lcd2s_clear_display,
278 .init_display = lcd2s_init_display,
279 .shift_cursor = lcd2s_shift_cursor,
280 .shift_display = lcd2s_shift_display,
281 .display = lcd2s_display,
282 .cursor = lcd2s_cursor,
283 .blink = lcd2s_blink,
284 .fontsize = lcd2s_fontsize,
285 .lines = lcd2s_lines,
286 .redefine_char = lcd2s_redefine_char,
287 };
288
lcd2s_i2c_probe(struct i2c_client * i2c,const struct i2c_device_id * id)289 static int lcd2s_i2c_probe(struct i2c_client *i2c,
290 const struct i2c_device_id *id)
291 {
292 struct charlcd *lcd;
293 struct lcd2s_data *lcd2s;
294 int err;
295
296 if (!i2c_check_functionality(i2c->adapter,
297 I2C_FUNC_SMBUS_WRITE_BYTE_DATA |
298 I2C_FUNC_SMBUS_WRITE_BLOCK_DATA))
299 return -EIO;
300
301 lcd2s = devm_kzalloc(&i2c->dev, sizeof(*lcd2s), GFP_KERNEL);
302 if (!lcd2s)
303 return -ENOMEM;
304
305 /* Test, if the display is responding */
306 err = lcd2s_i2c_smbus_write_byte(i2c, LCD2S_CMD_DISPLAY_OFF);
307 if (err < 0)
308 return err;
309
310 lcd = charlcd_alloc();
311 if (!lcd)
312 return -ENOMEM;
313
314 lcd->drvdata = lcd2s;
315 lcd2s->i2c = i2c;
316 lcd2s->charlcd = lcd;
317
318 /* Required properties */
319 err = device_property_read_u32(&i2c->dev, "display-height-chars",
320 &lcd->height);
321 if (err)
322 goto fail1;
323
324 err = device_property_read_u32(&i2c->dev, "display-width-chars",
325 &lcd->width);
326 if (err)
327 goto fail1;
328
329 lcd->ops = &lcd2s_ops;
330
331 err = charlcd_register(lcd2s->charlcd);
332 if (err)
333 goto fail1;
334
335 i2c_set_clientdata(i2c, lcd2s);
336 return 0;
337
338 fail1:
339 charlcd_free(lcd2s->charlcd);
340 return err;
341 }
342
lcd2s_i2c_remove(struct i2c_client * i2c)343 static int lcd2s_i2c_remove(struct i2c_client *i2c)
344 {
345 struct lcd2s_data *lcd2s = i2c_get_clientdata(i2c);
346
347 charlcd_unregister(lcd2s->charlcd);
348 charlcd_free(lcd2s->charlcd);
349 return 0;
350 }
351
352 static const struct i2c_device_id lcd2s_i2c_id[] = {
353 { "lcd2s", 0 },
354 { }
355 };
356 MODULE_DEVICE_TABLE(i2c, lcd2s_i2c_id);
357
358 #ifdef CONFIG_OF
359 static const struct of_device_id lcd2s_of_table[] = {
360 { .compatible = "modtronix,lcd2s" },
361 { }
362 };
363 MODULE_DEVICE_TABLE(of, lcd2s_of_table);
364 #endif
365
366 static struct i2c_driver lcd2s_i2c_driver = {
367 .driver = {
368 .name = "lcd2s",
369 #ifdef CONFIG_OF
370 .of_match_table = of_match_ptr(lcd2s_of_table),
371 #endif
372 },
373 .probe = lcd2s_i2c_probe,
374 .remove = lcd2s_i2c_remove,
375 .id_table = lcd2s_i2c_id,
376 };
377
lcd2s_modinit(void)378 static int __init lcd2s_modinit(void)
379 {
380 int ret = 0;
381
382 ret = i2c_add_driver(&lcd2s_i2c_driver);
383 if (ret != 0)
384 pr_err("Failed to register lcd2s driver\n");
385
386 return ret;
387 }
module_init(lcd2s_modinit)388 module_init(lcd2s_modinit)
389
390 static void __exit lcd2s_exit(void)
391 {
392 i2c_del_driver(&lcd2s_i2c_driver);
393 }
394 module_exit(lcd2s_exit)
395
396 MODULE_DESCRIPTION("LCD2S character display driver");
397 MODULE_AUTHOR("Lars Poeschel");
398 MODULE_LICENSE("GPL");
399