drivers: add lcd display support

drivers/lcddisplay/cfag12864b.c +9 -0

@@ -0,0 +1,592 @@
+
+#define CFAG12864B_NAME "cfag12864b"
+
+/*
+ * Device
+ */
+
+static const unsigned int cfag12864b_firstminor;
+static const unsigned int cfag12864b_ndevices = 1;

drivers/lcddisplay/cfag12864b.c +10 -0

+	if (state)
+		cfag12864b_state |= bit(n);
+	else
+		cfag12864b_state &= ~bit(n);
+	cfag12864b_set();
+}
+
+static void cfag12864b_e(unsigned char state)
+{
+	cfag12864b_setbit(state, 0);

drivers/lcddisplay/cfag12864b.c +10 -0

+		cfag12864b_setcontrollers(1, 0);
+	else if (which == 1)
+		cfag12864b_setcontrollers(0, 1);
+}
+
+/*
+ * Auxiliary
+ */
+
+static void normalizeoffset(unsigned int * offset)

drivers/lcddisplay/cfag12864b.c +9 -0

+{
+	if (*offset >= CFAG12864B_PAGES*CFAG12864B_ADDRESSES)
+		*offset -= CFAG12864B_PAGES*CFAG12864B_ADDRESSES;
+}
+
+static unsigned char calcaddress(unsigned int offset)
+{
+	normalizeoffset(&offset);
+	return offset%CFAG12864B_ADDRESSES;

drivers/lcddisplay/cfag12864b.c +13 -0

+}
+
+static unsigned char calccontroller(unsigned int offset)
+{
+	if (offset < CFAG12864B_PAGES*CFAG12864B_ADDRESSES)
+		return 0;
+	return 1;
+}
+
+static unsigned char calcpage(unsigned int offset)
+{
+	normalizeoffset(&offset);
+	return offset/CFAG12864B_ADDRESSES;

drivers/lcddisplay/cfag12864b.c +5 -0

+}
+
+void cfag12864b_format_nolock(unsigned char *src)
+{
+	unsigned short i,j,k,n;

drivers/lcddisplay/cfag12864b.c +3 -0

+	unsigned char *dest;
+
+	dest = kmalloc(sizeof(unsigned char) * CFAG12864B_SIZE, GFP_KERNEL);

drivers/lcddisplay/cfag12864b.c +3 -0

+	if (dest == NULL) {
+		printk(KERN_ERR CFAG12864B_NAME ": " "format: ERROR: "
+			"can't alloc memory %i bytes\n",

drivers/lcddisplay/cfag12864b.c +7 -0

+			sizeof(unsigned char) * CFAG12864B_SIZE);
+		return;
+	}
+
+	for (i = 0; i < CFAG12864B_CONTROLLERS; i++)
+	for (j = 0; j < CFAG12864B_PAGES; j++)
+	for (k = 0; k < CFAG12864B_ADDRESSES; k++) {

drivers/lcddisplay/cfag12864b.c +2 -0

+		dest[(i * CFAG12864B_PAGES + j) * CFAG12864B_ADDRESSES + k] = 0;
+		for (n=0; n < 8; n++)

drivers/lcddisplay/cfag12864b.c +10 -0

+	kfree(dest);
+}
+
+/*
+ * cfag12864b Exported Commands (do lock)
+ */
+
+void cfag12864b_on(void)
+{
+	if(down_interruptible(&cfag12864b_mutex))

drivers/lcddisplay/cfag12864b.c +10 -0

+		return;
+
+	cfag12864b_on_nolock();
+
+	up(&cfag12864b_mutex);
+}
+
+void cfag12864b_off(void)
+{
+	if(down_interruptible(&cfag12864b_mutex))

drivers/lcddisplay/cfag12864b.c +10 -0

+		return;
+
+	cfag12864b_off_nolock();
+
+	up(&cfag12864b_mutex);
+}
+
+void cfag12864b_clear(void)
+{
+	if(down_interruptible(&cfag12864b_mutex))

drivers/lcddisplay/cfag12864b.c +11 -0

+		return;
+
+	cfag12864b_clear_nolock();
+
+	up(&cfag12864b_mutex);
+}
+
+void cfag12864b_write(unsigned short offset, const unsigned char *buffer,
+	unsigned short count)
+{
+	if(down_interruptible(&cfag12864b_mutex))

drivers/lcddisplay/cfag12864b.c +10 -0

+		return;
+
+	cfag12864b_write_nolock(offset,buffer,count);
+
+	up(&cfag12864b_mutex);
+}
+
+void cfag12864b_format(unsigned char *src)
+{
+	if(down_interruptible(&cfag12864b_mutex))

drivers/lcddisplay/cfag12864b.c +10 -0

+EXPORT_SYMBOL_GPL(cfag12864b_off);
+EXPORT_SYMBOL_GPL(cfag12864b_clear);
+EXPORT_SYMBOL_GPL(cfag12864b_write);
+EXPORT_SYMBOL_GPL(cfag12864b_format);
+
+/*
+ * cfag12864b ioctls (don't lock because ioctl fop do)
+ */
+
+static int cfag12864b_fopioctlformat(void __user * arg)

drivers/lcddisplay/cfag12864b.c +7 -0

+{
+	int result;
+	int ret = -ENOTTY;
+	unsigned char *tmpbuffer;
+
+	tmpbuffer = kmalloc(
+		sizeof(unsigned char)*CFAG12864B_MATRIXSIZE,GFP_KERNEL);

drivers/lcddisplay/cfag12864b.c +3 -0

+	if (tmpbuffer == NULL) {
+		printk(KERN_ERR CFAG12864B_NAME ": " "FOP ioctl: ERROR: "
+			"can't alloc memory %i bytes\n",

drivers/lcddisplay/cfag12864b.c +1 -0

+			sizeof(unsigned char)*CFAG12864B_MATRIXSIZE);

drivers/lcddisplay/cfag12864b.c +8 -0

+		goto none;
+	}
+
+	result = copy_from_user(tmpbuffer, arg,
+		sizeof(unsigned char) * CFAG12864B_MATRIXSIZE);
+	if (result != 0) {
+		printk(KERN_ERR CFAG12864B_NAME ": " "FOP ioctl: ERROR: "
+			"can't copy memory from user\n");

drivers/lcddisplay/cfag12864b.c +10 -0

+
+/*
+ * cfag12864b_fops (do lock)
+ */
+
+static loff_t cfag12864b_fopseek(struct file *filp, loff_t offset, int whence)
+{
+	loff_t ret = -EINVAL;
+
+	if(down_interruptible(&cfag12864b_mutex))

drivers/lcddisplay/cfag12864b.c +10 -0

+
+
+static ssize_t cfag12864b_fopwrite(struct file *filp,
+	const char __user *buffer, size_t count, loff_t *offset)
+{
+	int ret = -EINVAL;
+	int result;
+	unsigned char *tmpbuffer;
+
+	if(down_interruptible(&cfag12864b_mutex))

drivers/lcddisplay/cfag12864b.c +10 -0

+		return -ERESTARTSYS;
+
+	if (*offset > CFAG12864B_SIZE) {
+		ret = 0;
+		goto none;
+	}
+	if (*offset + count > CFAG12864B_SIZE)
+		count = CFAG12864B_SIZE-*offset;
+
+	tmpbuffer = kmalloc(count, GFP_KERNEL);

drivers/lcddisplay/cfag12864b.c +3 -0

+	if (tmpbuffer == NULL) {
+		printk(KERN_ERR CFAG12864B_NAME ": " "FOP write: ERROR: "
+			"can't alloc memory %i bytes\n",count);

drivers/lcddisplay/cfag12864b.c +10 -0

+	up(&cfag12864b_mutex);
+	return ret;
+}
+
+static int cfag12864b_fopioctl(struct inode * inode, struct file * filp,
+	unsigned int cmd, unsigned long arg)
+{
+	int ret = -ENOTTY;
+
+	if(down_interruptible(&cfag12864b_mutex))

drivers/lcddisplay/cfag12864b.c +10 -0

+	result = cdev_add(&cfag12864b_chardevice, cfag12864b_device,
+		cfag12864b_ndevices);
+	if (result < 0) {
+		printk(KERN_ERR CFAG12864B_NAME ": " "ERROR: "
+			"unable to add a new char device\n");
+		ret = result;
+		goto regionalloced;
+	}
+
+	if(class_device_create(lcddisplay_class, NULL, cfag12864b_device, NULL,

drivers/lcddisplay/cfag12864b.c +8 -0

+		"cfag12864b%d", cfag12864b_minor) == NULL) {
+		printk(KERN_ERR CFAG12864B_NAME ": " "ERROR: "
+			"unable to create a device class\n");
+		ret = -EINVAL;
+		goto cdevadded;
+	}
+
+	printk(KERN_INFO CFAG12864B_NAME ": " "Inited\n");

drivers/lcddisplay/cfag12864b.c +10 -0

+
+static void __exit cfag12864b_exit(void)
+{
+	cfag12864b_off_nolock();
+
+	class_device_destroy(lcddisplay_class, cfag12864b_device);
+	cdev_del(&cfag12864b_chardevice);
+	unregister_chrdev_region(cfag12864b_device, cfag12864b_ndevices);
+
+	printk(KERN_INFO CFAG12864B_NAME ": " "Exited\n");

drivers/lcddisplay/cfag12864b.c +8 -0

+}
+
+module_init(cfag12864b_init);
+module_exit(cfag12864b_exit);
+
+MODULE_LICENSE("GPL");
+MODULE_AUTHOR("Miguel Ojeda Sandonis <[email protected]>");
+MODULE_DESCRIPTION("cfag12864b");

diff -uprN -X dontdiff linux-2.6.18-vanilla/drivers/lcddisplay/cfag12864b_image.h linux-2.6.18/drivers/lcddisplay/cfag12864b_image.h

drivers/lcddisplay/cfag12864b_image.h +4 -0

@@ -0,0 +1,95 @@
+#ifndef _CFAG12864B_IMAGE_H_
+#define _CFAG12864B_IMAGE_H_
+
+const unsigned char cfag12864b_image[] = {

diff -uprN -X dontdiff linux-2.6.18-vanilla/drivers/lcddisplay/Kconfig linux-2.6.18/drivers/lcddisplay/Kconfig

drivers/lcddisplay/Kconfig +8 -0

@@ -0,0 +1,110 @@
+#
+# For a description of the syntax of this configuration file,
+# see Documentation/kbuild/kconfig-language.txt.
+#
+# LCD Display drivers configuration.
+#
+# Maintainer: Miguel Ojeda Sandonis <[email protected]>
+#

drivers/lcddisplay/Kconfig +10 -0

+menu "LCD Display support"
+
+config LCDDISPLAY
+	tristate "LCD Display support"
+	default n
+	---help---
+	  If you have a LCD display, say Y.
+
+	  To compile this as a module, choose M here:
+	  module will be called lcddisplay.

drivers/lcddisplay/Kconfig +1 -0

+	  Most LCD drivers use a I/O port (like the parallel port)

drivers/lcddisplay/Kconfig +1 -0

+	  so you will need to say Y or M at them if you want to see

drivers/lcddisplay/Kconfig +5 -0

+	  more options in this menu.
+
+	  If unsure, say N.
+
+	  Maintainer: Miguel Ojeda Sandonis <[email protected]>

drivers/lcddisplay/Kconfig +8 -0

+comment "Parallel port dependent:"
+
+config KS0108
+	tristate "KS0108 LCD Controller"
+	depends on LCDDISPLAY && PARPORT
+	default n
+	---help---
+	  If you have a LCD display controlled by one or more KS0108

drivers/lcddisplay/Kconfig +6 -0

+	  controllers, say Y. You will need also another more specific
+	  driver for your LCD.
+
+	  Depends on Parallel Port support. If you say Y at
+	  parport, you will be able to compile this as a module (M)
+	  and built-in as well (Y). If you said M at parport,

drivers/lcddisplay/Kconfig +1 -0

+	  you will be able only to compile this as a module (M).

drivers/lcddisplay/Kconfig +2 -0

+	  To compile this as a module, choose M here:
+	  module will be called ks0108.

drivers/lcddisplay/Kconfig +3 -0

+	  If unsure, say N.
+
+	  Maintainer: Miguel Ojeda Sandonis <[email protected]>

drivers/lcddisplay/Kconfig +2 -0

+config KS0108_PORT
+	hex "Parallel port where the LCD is connected to"

drivers/lcddisplay/Kconfig +4 -0

+	depends on KS0108
+	default 0x378
+	---help---
+	  The address of the parallel port where the LCD is connected to.

drivers/lcddisplay/Kconfig +8 -0

+	  The first  standard parallel port address is 0x378.
+	  The second standard parallel port address is 0x278.
+	  The third  standard parallel port address is 0x3BC.
+
+	  You can specify a different address if you need.
+
+	  If you don't know what I'm talking about, load the parport module,
+	  and execute "dmesg". You can see there how many parallel ports

drivers/lcddisplay/Kconfig +1 -0

+	  where detected and which address everyone has.

drivers/lcddisplay/Kconfig +10 -0

+	depends on KS0108
+	default n
+	---help---
+	  If you have a Crystalfontz 128x64 2-color LCD display,
+	  cfag12864b Series, say Y. You also need the ks0108 LCD
+	  Controller driver.
+
+	  For help about how to wire your LCD to the parallel port,
+	  check this image: http://www.skippari.net/lcd/sekalaista
+	                    /crystalfontz_cfag12864B-TMI-V.png

drivers/lcddisplay/Kconfig +2 -0

+	  To compile this as a module, choose M here:
+	  module will be called cfag12864b.

drivers/lcddisplay/Kconfig +3 -0

+	  If unsure, say N.
+
+	  Maintainer: Miguel Ojeda Sandonis <[email protected]>

drivers/lcddisplay/Kconfig +2 -0

+endmenu
+

diff -uprN -X dontdiff linux-2.6.18-vanilla/drivers/lcddisplay/ks0108.c linux-2.6.18/drivers/lcddisplay/ks0108.c

drivers/lcddisplay/ks0108.c +5 -0

@@ -0,0 +1,160 @@
+/*
+ * ks0108 Exported cmds (don't lock)
+ *
+ *   you _should_ lock in the top driver, so
+ *   this functions _should not_ get race conditions in any way.

drivers/lcddisplay/ks0108.c +9 -0

+ *   Locking for each byte here would be so slow and useless.
+ */
+
+#define bit(n) (((unsigned char)1)<<(n))
+
+void ks0108_writecontrol(unsigned char byte)
+{
+	udelay(ks0108_delay);
+	parport_write_control(ks0108_parport, byte ^ (bit(0) | bit(1) | bit(3)));

drivers/lcddisplay/ks0108.c +5 -0

+}
+
+void ks0108_displaystate(unsigned char state)
+{
+	ks0108_writedata((state ? bit(0) : 0) | bit(1) | bit(2) | bit(3) | bit(4) | bit(5));

drivers/lcddisplay/ks0108.c +5 -0

+}
+
+void ks0108_startline(unsigned char startline)
+{
+	ks0108_writedata(min(startline,(unsigned char)63) | bit(6) | bit(7));

drivers/lcddisplay/ks0108.c +5 -0

+}
+
+void ks0108_address(unsigned char address)
+{
+	ks0108_writedata(min(address,(unsigned char)63) | bit(6));

drivers/lcddisplay/ks0108.c +5 -0

+}
+
+void ks0108_page(unsigned char page)
+{
+	ks0108_writedata(min(page,(unsigned char)7) | bit(3) | bit(4) | bit(5) | bit(7));

drivers/lcddisplay/ks0108.c +10 -0

+}
+
+static int __init ks0108_init(void)
+{
+	int result;
+	int ret = -EINVAL;
+
+	ks0108_parport = parport_find_base(ks0108_port);
+	if (ks0108_parport == NULL) {
+		printk(KERN_ERR KS0108_NAME ": " "ERROR: "

drivers/lcddisplay/ks0108.c +1 -0

+			"parport didn't find %i port\n",ks0108_port);

drivers/lcddisplay/ks0108.c +10 -0

+	if (ks0108_pardevice == NULL) {
+		printk(KERN_ERR KS0108_NAME ": " "ERROR: "
+			"parport didn't register new device\n");
+		goto none;
+	}
+
+	result = parport_claim(ks0108_pardevice);
+	if (result != 0) {
+		printk(KERN_ERR KS0108_NAME ": " "ERROR: "
+			"can't claim %i parport, maybe in use\n",ks0108_port);

drivers/lcddisplay/ks0108.c +10 -0

+	parport_unregister_device(ks0108_pardevice);
+
+none:
+	return ret;
+}
+
+
+MODULE_LICENSE("GPL");
+MODULE_AUTHOR("Miguel Ojeda Sandonis <[email protected]>");
+MODULE_DESCRIPTION("ks0108");

diff -uprN -X dontdiff linux-2.6.18-vanilla/drivers/lcddisplay/lcddisplay.c linux-2.6.18/drivers/lcddisplay/lcddisplay.c

drivers/lcddisplay/lcddisplay.c +8 -0

@@ -0,0 +1,79 @@
+
+static int __init lcddisplay_init(void)
+{
+	int ret = -EINVAL;
+
+	lcddisplay_class = class_create(THIS_MODULE, LCDDISPLAY_NAME);
+	if (IS_ERR(lcddisplay_class)) {
+		printk(KERN_ERR LCDDISPLAY_NAME ": " "ERROR: "

drivers/lcddisplay/lcddisplay.c +5 -0

+			"can't create %s class\n", LCDDISPLAY_NAME);
+		goto none;
+	}
+
+	printk(KERN_INFO LCDDISPLAY_NAME ": " "Inited\n");

drivers/lcddisplay/lcddisplay.c +11 -0

+	return 0;
+
+none:
+	return ret;
+}
+
+static void __exit lcddisplay_exit(void)
+{
+	class_destroy(lcddisplay_class);
+
+	printk(KERN_INFO LCDDISPLAY_NAME ": " "Exited\n");

drivers/lcddisplay/lcddisplay.c +8 -0

+}
+
+module_init(lcddisplay_init);
+module_exit(lcddisplay_exit);
+
+MODULE_LICENSE("GPL");
+MODULE_AUTHOR("Miguel Ojeda Sandonis <[email protected]>");
+MODULE_DESCRIPTION("lcddisplay");

diff -uprN -X dontdiff linux-2.6.18-vanilla/include/linux/cfag12864b.h linux-2.6.18/include/linux/cfag12864b.h

include/linux/cfag12864b.h +9 -0

@@ -0,0 +1,58 @@
+
+#ifndef _CFAG12864B_H_
+#define _CFAG12864B_H_
+
+#include <linux/ioctl.h>
+
+#define CFAG12864B_WIDTH	128
+#define CFAG12864B_HEIGHT	64
+#define CFAG12864B_MATRIXSIZE	CFAG12864B_WIDTH*CFAG12864B_HEIGHT

include/linux/cfag12864b.h +6 -0

+#define CFAG12864B_CONTROLLERS	2
+#define CFAG12864B_PAGES	8
+#define CFAG12864B_ADDRESSES	64
+#define CFAG12864B_SIZE		CFAG12864B_CONTROLLERS * \
+				CFAG12864B_PAGES * \
+				CFAG12864B_ADDRESSES

include/linux/cfag12864b.h +10 -0

+#define CFAG12864B_IOCON	_IO(CFAG12864B_IOC_MAGIC,1)
+#define CFAG12864B_IOCCLEAR	_IO(CFAG12864B_IOC_MAGIC,2)
+#define CFAG12864B_IOCFORMAT	_IOW(CFAG12864B_IOC_MAGIC,3,void *)
+
+extern void cfag12864b_on(void);
+extern void cfag12864b_off(void);
+extern void cfag12864b_clear(void);
+extern void cfag12864b_write(unsigned short offset,
+	const unsigned char *buffer, unsigned short count);
+extern void cfag12864b_format(unsigned char *src);

include/linux/cfag12864b.h +2 -0

+#endif /* _CFAG12864B_H_ */
+

diff -uprN -X dontdiff linux-2.6.18-vanilla/Documentation/lcddisplay/cfag12864b linux-2.6.18/Documentation/lcddisplay/cfag12864b

Documentation/lcddisplay/cfag12864b +6 -0

@@ -0,0 +1,371 @@
+
+---------
+2. WIRING
+---------
+
+The cfag12864b LCD Display Series don't have a official wiring.

Documentation/lcddisplay/cfag12864b +10 -0

+This method is easier, but you have to update the entire display
+each time you want to change it.
+
+Note:
+
+	CFAG12864B_FORMATSIZE ==
+	CFAG12864B_WIDTH * CFAG12864B_HEIGHT ==
+	128 * 64
+
+Declare the matrix and other one:

Documentation/lcddisplay/cfag12864b +5 -0

+	unsigned char MyDrawing[CFAG12864B_WIDTH][CFAG12864B_HEIGHT];
+
+	unsigned char Buffer[CFAG12864B_FORMATSIZE];
+
+Copy the 2d matrix to the buffer , like:

Documentation/lcddisplay/cfag12864b +10 -0

+	ioctl(fdisplay, CFAG12864B_IOCFORMAT, Buffer);
+
+Voila! Your drawing should appear on the screen.
+
+
+
+3.2. Direct writing
+-------------------
+
+This methods allows you to change each byte of the device,

Documentation/lcddisplay/cfag12864b +7 -0

+so you can achieve a higher update rate updating only the pixels
+you are going to change.
 
+4.2 Example BMP writer
+----------------------
+
+You can take ideas from this code and start programming. I think it is useful
+for understanding how the driver can be used. It just work, don't expect

Documentation/lcddisplay/cfag12864b +3 -0

+good BMP-related code. I chose such bitmap format because it is simple.
+
+The program reads a .bmp 128x64 2-colors file, convert it to a

diff -uprN -X dontdiff linux-2.6.18-vanilla/Documentation/ioctl-number.txt linux-2.6.18/Documentation/ioctl-number.txt

Documentation/ioctl-number.txt +2 -0

@@ -191,3 +191,5 @@ Code	Seq#	Include File		Comments
 					<mailto:[email protected]>
 0xF3	00-3F	video/sisfb.h		sisfb (in development)
 					<mailto:[email protected]>
+0xFF	00-1F	linux/cfag12864b.h	cfag12864b LCD Display Driver
+					<mailto:[email protected]>

diff -uprN -X dontdiff linux-2.6.18-vanilla/MAINTAINERS linux-2.6.18/MAINTAINERS

MAINTAINERS +5 -0

@@ -1707,6 +1707,11 @@ M:	[email protected]
 L:	[email protected]
 S:	Maintained
 
+LCD DISPLAY DRIVERS
+P:	Miguel Ojeda Sandonis
+M:	[email protected]
+S:	Maintained
+