[PATCH 2.6.17.13] display: Driver ks0108 and cfag12864b

From: Miguel Ojeda
Date: Mon Sep 11 2006 - 19:24:26 EST

Miguel Ojeda Sandonis

Adds support for additional "display" devices, like small LCD screens.
Adds support for the ks0108 LCD Controller.
Adds support for the cfag12864b LCD.

Signed-off-by: Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>
---
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/Documentation/drivers/display/cfag12864b
linux-2.6.17.13/Documentation/drivers/display/cfag12864b
--- linux-2.6.17.13-vanilla/Documentation/drivers/display/cfag12864b 1970-01-01
01:00:00.000000000 +0100
+++ linux-2.6.17.13/Documentation/drivers/display/cfag12864b 2006-09-12
00:10:43.000000000 +0200
@@ -0,0 +1,363 @@
+ ===============================
+ cfag12864b Driver Documentation
+ ===============================
+
+License: GPL
+Author & Maintainer: Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>
+Date: 2006-09-10
+
+
+
+--------
+0. INDEX
+--------
+
+ 1. DEVICE INFORMATION
+ 2. WIRING
+ 3. USER-SPACE PROGRAMMING
+ 3.1. ioctl and a 128*64 boolean matrix
+ 3.2. Direct writing
+ 4. USEFUL FILES
+ 4.1. cfag12864b.h
+ 4.2. bmpwriter.h
+
+
+
+---------------------
+1. DEVICE INFORMATION
+---------------------
+
+Manufacturer: Crystalfontz
+Webpage: http://www.crystalfontz.com
+Device Webpage: http://www.crystalfontz.com/products/12864b/
+Type: LCD Display
+Width: 128
+Height: 64
+Colors: 2
+Controller: ks0108
+Controllers: 2
+Pages: 8 each controller
+Addresses: 64 each page
+
+
+If you compiled the device as a module, don't remember to
+update udev to get the new device node at /dev.
+
+
+---------
+2. WIRING
+---------
+
+The cfag12864b LCD Display Series don't have a official wiring.
+
+The common wiring is done to the parallel port:
+
+http://www.skippari.net/lcd/sekalaista/crystalfontz_cfag12864B-TMI-V.png
+
+You can get help at Crystalfontz and LCDInfo forums.
+
+
+
+-------------------------
+3. USER-SPACE PROGRAMMING
+-------------------------
+
+Include a copy of the provided header:
+
+ #include "cfag12864b.h"
+
+Open the device for writing, /dev/cfag12864b0:
+
+ int fd = open("/dev/cfag12864b0",O_WRONLY);
+
+Then use simple ioctl calls to control it:
+
+ ioctl(fdisplay,CFAG12864B_IOCOFF); /* Turn off (don't clear) */
+ ioctl(fdisplay,CFAG12864B_IOCON); /* Turn on */
+ ioctl(fdisplay,CFAG12864B_IOCCLEAR); /* Clear the display */
+
+For writing to the display, you have two options:
+
+
+3.1. ioctl & 128*64 boolean matrix
+-------------------------------------------------------
+
+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:
+
+ unsigned char MyDrawing[CFAG12864B_WIDTH][CFAG12864B_HEIGHT];
+
+ unsigned char Buffer[CFAG12864B_FORMATSIZE];
+
+Copy the 2d matrix to the buffer , like:
+
+ for(i=0;i<CFAG12864B_WIDTH;++i)
+ for(j=0;j<CFAG12864B_HEIGHT;++j)
+ Buffer[i+j*CFAG12864B_WIDTH]=MyDrawing[i][j];
+
+Call the ioctl:
+
+ 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,
+so you can achieve a higher update rate.
+
+The device size is 1024 == CFAG12864B_SIZE.
+
+You can write and seek the device. The first 512 bytes write to
+the first k0108 controller (left display half) and the last 512 bytes
+write to the second ks0108 controller (right display half).
+
+Each controller is divided into 8 pages. Each page has 64 bytes.
+
+ Controller 0 Controller 1
+ _________________________
+Page 0 |____________|____________|
+Page 1 |____________|____________|
+Page 2 |____________|____________|
+Page 3 |____________|____________|
+Page 4 |____________|____________|
+Page 5 |____________|____________|
+Page 6 |____________|____________|
+Page 7 |____________|____________|
+ <--- 64 --->
+
+You will understand how the device work executing some commands:
+
+ # echo -n A > /dev/cfag12864b0
+ # echo -n a > /dev/cfag12864b0
+ # echo AAAAAA > /dev/cfag12864b0
+ # echo 000000 > /dev/cfag12864b0
+ # echo Hello world! > /dev/cfag12864b0
+ # echo Hello world! Hello world! > /dev/cfag12864b0
+
+After you understand it, code your functions to change specific bytes.
+
+Use write() and lseek() system calls, like:
+
+ lseek(fdisplay,ipage*CFAG12864B_HEIGHT,SEEK_SET);
+ lseek(fdisplay,icontroller*CFAG12864B_SIZE/2,SEEK_SET);
+
+ write(fdisplay,bufpage,CFAG12864B_HEIGHT);
+ write(fdisplay,bufcontroller,CFAG12864B_SIZE/2);
+ write(fdisplay,bufdisplay,CFAG12864B_SIZE);
+
+
+---------------
+4. USEFUL FILES
+---------------
+
+
+4.1 cfag12864b.h
+----------------
+
+You can use a copy of this header in your user-space programs.
+
+---
+/*
+ * Filename: cfag12864b.h
+ * Version: 0.1.0
+ * Description: cfag12864b LCD Display Driver Header for user-space apps
+ * License: GPL
+ *
+ * Author: Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>
+ * Date: 2006-09-10
+ */
+
+#ifndef _CFAG12864B_H_
+#define _CFAG12864B_H_
+
+#include <sys/ioctl.h>
+
+#define CFAG12864B_WIDTH 128
+#define CFAG12864B_HEIGHT 64
+#define CFAG12864B_FORMATSIZE CFAG12864B_WIDTH*CFAG12864B_HEIGHT
+#define CFAG12864B_SIZE 1024
+
+#define CFAG12864B_IOC_MAGIC 0xFF
+
+#define CFAG12864B_IOCOFF _IO(CFAG12864B_IOC_MAGIC,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 *)
+
+#endif // _CFAG12864B_H_
+---
+
+
+
+4.2 Example BMP writer
+----------------------
+
+You can take ideas from this code. It reads a .bmp file,
+convert it to a boolean [128*64] buffer and then use
+ioctl to display it on the screen.
+
+---
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <fcntl.h>
+
+#include "cfag12864b.h"
+
+#define BMP_SIZE 1024
+
+union dword
+{
+ unsigned int u32;
+ unsigned char u8[4];
+};
+
+#define Bit(n) ((unsigned char)(1<<(n)))
+
+void BMP2Format(
+ unsigned char _Src[BMP_SIZE],
+ unsigned char _Dest[CFAG12864B_FORMATSIZE])
+{
+ const unsigned int Width = CFAG12864B_WIDTH;
+ const unsigned int Height = CFAG12864B_HEIGHT;
+ const unsigned int Bits = 8;
+
+ unsigned int Y,X,Bit;
+
+ for(Y=0; Y<Height; ++Y)
+ for(X=0; X<Width/Bits; ++X)
+ for(Bit=0; Bit<Bits; ++Bit)
+ _Dest[X*Bits+Bit+(Height-Y-1)*Width] =
+ _Src[Y*Width/Bits+X]&Bit(Bits-Bit-1)?0:1;
+}
+
+int main(int argc, char * argv[])
+{
+ const unsigned int Width = CFAG12864B_WIDTH;
+ const unsigned int Height = CFAG12864B_HEIGHT;
+ const unsigned int Size = CFAG12864B_SIZE;
+ const unsigned int BPP = 1;
+ const unsigned int HeaderSize = 0x3E;
+ const unsigned int BMPSize = BMP_SIZE;
+
+ unsigned char c;
+ unsigned int i,j;
+ union dword n;
+
+ unsigned char Buffer_BMP[BMP_SIZE];
+ unsigned char Buffer_Matrix[CFAG12864B_FORMATSIZE];
+
+ int fdisplay;
+ FILE * fbmp;
+
+ // Check args
+ if(argc!=3) {
+ printf("%s: Bad number of arguments. Expected 3\n",
+ argv[0]);
+ return -1;
+ }
+
+ // Open file
+ fbmp = fopen(argv[2],"rb");
+ if(fbmp==NULL) {
+ printf("%s: Can't open %s\n",argv[0], argv[2]);
+ return -2;
+ }
+
+ // Check file size
+ fseek(fbmp,0,SEEK_END);
+ i=ftell(fbmp);
+ if(i!=HeaderSize+Size) {
+ printf("%s: Bad file size. %i instead of %i\n",
+ argv[0], i, HeaderSize+Size);
+ fclose(fbmp);
+ return -3;
+ }
+
+ // Check both magic BMP bytes
+ fseek(fbmp,0,SEEK_SET);
+ c = fgetc(fbmp);
+ if(c!='B') {
+ printf("%s: Bad first magic byte. '%c' instead of 'B'\n",
+ argv[0], c);
+ fclose(fbmp);
+ return -4;
+ }
+ c = fgetc(fbmp);
+ if(c!='M') {
+ printf("%s: Bad second magic byte. '%c' instead of 'M'\n",
+ argv[0], c);
+ fclose(fbmp);
+ return -5;
+ }
+
+ // Check this is a 128x64 1-bpp BMP file
+ fseek(fbmp,0x12,SEEK_SET);
+ for(i=0; i<4; ++i)
+ n.u8[i] = fgetc(fbmp);
+ if(n.u32!=Width) {
+ printf("%s: Bad width. %i instead of %i\n",
+ argv[0], n.u32, Width);
+ fclose(fbmp);
+ return -6;
+ }
+ for(i=0; i<4; ++i)
+ n.u8[i] = fgetc(fbmp);
+ if(n.u32!=Height) {
+ printf("%s: Bad width. %i instead of %i\n",
+ argv[0], n.u32, Height);
+ fclose(fbmp);
+ return -7;
+ }
+ fseek(fbmp,0x1C,SEEK_SET);
+ c = fgetc(fbmp);
+ if(c!=BPP) {
+ printf("%s: Bad bpp. %i instead of %i\n",
+ argv[0], c, BPP);
+ fclose(fbmp);
+ return -8;
+ }
+
+ // Get bitmap data
+ fseek(fbmp,0x3E,SEEK_SET);
+ for(i=0; i<BMPSize; ++i)
+ Buffer_BMP[i]=fgetc(fbmp);
+ fclose(fbmp);
+
+ // Transform BMP data to 2D matrix
+ BMP2Format(Buffer_BMP,Buffer_Matrix);
+
+ // Open file
+ fdisplay = open(argv[1],O_WRONLY);
+ if(fdisplay < 0) {
+ printf("%s: Can't open %s\n", argv[0], argv[1]);
+ return -9;
+ }
+
+ // Send matrix
+ ioctl(fdisplay,CFAG12864B_IOCFORMAT,Buffer_Matrix);
+
+ // Close file
+ close(fdisplay);
+
+ return 0;
+}
+---
+
+
+EOF
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/Documentation/drivers/display/display
linux-2.6.17.13/Documentation/drivers/display/display
--- linux-2.6.17.13-vanilla/Documentation/drivers/display/display 1970-01-01
01:00:00.000000000 +0100
+++ linux-2.6.17.13/Documentation/drivers/display/display 2006-09-12
00:24:39.000000000 +0200
@@ -0,0 +1,37 @@
+ =============================
+ Display Drivers Documentation
+ =============================
+
+License: GPL
+Author & Maintainer: Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>
+Date: 2006-09-10
+
+--------
+0. INDEX
+--------
+
+ 1. NEW DISPLAY DRIVERS
+ 2. GENERAL TIPS
+
+
+
+----------------------
+1. NEW DISPLAY DRIVERS
+----------------------
+
+Feel free to send me new display drivers. I will try to do my best.
+
+If you don't get any answer, send your patch directly to the linux-kernel ml.
+
+
+
+---------------
+2. GENERAL TIPS
+---------------
+
+- Divide your driver into the controller driver, like ks0108,
+ and the specific LCD display series driver, like cfag12864b.
+
+- Claim for your IO ports in the controller driver.
+
+EOF
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/Documentation/ioctl-number.txt
linux-2.6.17.13/Documentation/ioctl-number.txt
--- linux-2.6.17.13-vanilla/Documentation/ioctl-number.txt 2006-09-09
05:23:25.000000000 +0200
+++ linux-2.6.17.13/Documentation/ioctl-number.txt 2006-09-12
00:36:48.000000000 +0200
@@ -190,3 +190,5 @@ Code Seq# Include File Comments
<mailto:aherrman@xxxxxxxxxx>
0xF3 00-3F video/sisfb.h sisfb (in development)
<mailto:thomas@xxxxxxxxxxxxxxxx>
+0xFF 00-1F cfag12864b LCD Display linux/cfag12864b.h
+ <mailto:maxextreme@xxxxxxxxx>
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/CREDITS linux-2.6.17.13/CREDITS
--- linux-2.6.17.13-vanilla/CREDITS 2006-09-09 05:23:25.000000000 +0200
+++ linux-2.6.17.13/CREDITS 2006-09-12 00:16:06.000000000 +0200
@@ -2534,6 +2534,14 @@ S: Subiaco, 6008
S: Perth, Western Australia
S: Australia

+N: Miguel Ojeda Sandonis
+E: maxextreme@xxxxxxxxx
+D: Author: LCD Display Drivers (ks0108, cfag12864b)
+D: Maintainer: LCD Display Drivers Tree (drivers/display/*)
+S: C/ Mieses 20, 9-B
+S: Valladolid 47009
+S: Spain
+
N: Greg Page
E: gpage@xxxxxxxxxxxxx
D: IPX development and support
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/drivers/display/cfag12864b.c
linux-2.6.17.13/drivers/display/cfag12864b.c
--- linux-2.6.17.13-vanilla/drivers/display/cfag12864b.c 1970-01-01
01:00:00.000000000 +0100
+++ linux-2.6.17.13/drivers/display/cfag12864b.c 2006-09-11
23:48:59.000000000 +0200
@@ -0,0 +1,585 @@
+/*
+ * Filename: cfag12864b.c
+ * Version: 0.1.0
+ * Description: cfag12864b LCD Display Driver
+ * License: GPL
+ * Depends: display ks0108
+ *
+ * Author: Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>
+ * Date: 2006-09-10
+ */
+
+
+#include <linux/init.h>
+#include <linux/module.h>
+#include <linux/kernel.h>
+#include <linux/fs.h>
+#include <linux/cdev.h>
+#include <linux/device.h>
+#include <linux/display.h>
+#include <linux/ks0108.h>
+#include <linux/cfag12864b.h>
+#include <asm/uaccess.h>
+
+#define NAME "cfag12864b"
+#define PRINTK_PREFIX KERN_INFO NAME ": "
+
+
+
+//
+// Device
+//
+
+static const unsigned int FirstMinor = 0;
+static const unsigned int nDevices = 1;
+static const char * Name = NAME;
+
+static int Major;
+static dev_t FirstDevice;
+
+struct cfag12864b
+{
+ int Minor;
+ dev_t Device;
+ struct cdev CharDevice;
+};
+
+static struct cfag12864b * Devices;
+
+
+
+//
+// cfag12864b Commands
+//
+
+#define Bit(n) ((unsigned char)(1<<(n)))
+#define NoBit(n) ((unsigned char)(~Bit(n)))
+static const unsigned int Bits = 8;
+
+static const unsigned int Width = CFAG12864B_WIDTH;
+static const unsigned int Height = CFAG12864B_HEIGHT;
+static const unsigned int MatrixSize = CFAG12864B_MATRIXSIZE;
+static const unsigned int Controllers = CFAG12864B_CONTROLLERS;
+static const unsigned int Pages = CFAG12864B_PAGES;
+static const unsigned int Addresses = CFAG12864B_ADDRESSES;
+static const unsigned int Size = CFAG12864B_SIZE;
+
+static unsigned char State = 0;
+
+void cfag12864b_Set(void)
+{
+ ks0108_WriteControl(State ^ (Bit(3) | Bit(1) | Bit(0)) );
+}
+
+void cfag12864b_E(unsigned char _State)
+{
+ if(_State)
+ State |= Bit(0);
+ else
+ State &= NoBit(0);
+ cfag12864b_Set();
+}
+
+void cfag12864b_CS1(unsigned char _State)
+{
+ if(_State)
+ State |= Bit(2);
+ else
+ State &= NoBit(2);
+ cfag12864b_Set();
+}
+
+void cfag12864b_CS2(unsigned char _State)
+{
+ if(_State)
+ State |= Bit(1);
+ else
+ State &= NoBit(1);
+ cfag12864b_Set();
+}
+
+void cfag12864b_DI(unsigned char _State)
+{
+ if(_State)
+ State |= Bit(3);
+ else
+ State &= NoBit(3);
+ cfag12864b_Set();
+}
+
+void cfag12864b_FirstController(unsigned char _State)
+{
+ if(_State)
+ cfag12864b_CS1(0);
+ else
+ cfag12864b_CS1(1);
+}
+
+void cfag12864b_SecondController(unsigned char _State)
+{
+ if(_State)
+ cfag12864b_CS2(0);
+ else
+ cfag12864b_CS2(1);
+}
+
+void cfag12864b_Controllers(unsigned char _First, unsigned char _Second)
+{
+ cfag12864b_FirstController(_First);
+ cfag12864b_SecondController(_Second);
+}
+
+void cfag12864b_Controller(unsigned char _Which)
+{
+ if(_Which==0)
+ cfag12864b_Controllers(1,0);
+ else if(_Which==1)
+ cfag12864b_Controllers(0,1);
+}
+
+void cfag12864b_DisplayState(unsigned char _State)
+{
+ cfag12864b_DI(0);
+ cfag12864b_E(1);
+ ks0108_DisplayState(_State);
+ cfag12864b_E(0);
+}
+
+void cfag12864b_Address(unsigned char _Address)
+{
+ cfag12864b_DI(0);
+ cfag12864b_E(1);
+ ks0108_Address(_Address);
+ cfag12864b_E(0);
+}
+
+void cfag12864b_Page(unsigned char _Page)
+{
+ cfag12864b_DI(0);
+ cfag12864b_E(1);
+ ks0108_Page(_Page);
+ cfag12864b_E(0);
+}
+
+void cfag12864b_StartLine(unsigned char _StartLine)
+{
+ cfag12864b_DI(0);
+ cfag12864b_E(1);
+ ks0108_StartLine(_StartLine);
+ cfag12864b_E(0);
+}
+
+void cfag12864b_WriteByte(unsigned char _Byte)
+{
+ cfag12864b_DI(1);
+ cfag12864b_E(1);
+ ks0108_WriteData(_Byte);
+ cfag12864b_E(0);
+}
+
+void cfag12864b_NOP(void)
+{
+ cfag12864b_StartLine(0);
+}
+
+
+
+//
+// Auxiliar
+//
+
+void NormalizeOffset(unsigned int * _Offset)
+{
+ if(*_Offset>=Pages*Addresses)
+ *_Offset-=Pages*Addresses;
+}
+
+unsigned char GetAddress(unsigned int _Offset)
+{
+ NormalizeOffset(&_Offset);
+ return _Offset%Addresses;
+}
+
+unsigned char GetController(unsigned int _Offset)
+{
+ if(_Offset<Pages*Addresses)
+ return 0;
+ return 1;
+}
+
+unsigned char GetPage(unsigned int _Offset)
+{
+ NormalizeOffset(&_Offset);
+ return _Offset/Addresses;
+}
+
+
+
+//
+// cfag12864b Exported Commands
+//
+
+void cfag12864b_On(void)
+{
+ cfag12864b_Controllers(1,1);
+ cfag12864b_DisplayState(1);
+}
+
+void cfag12864b_Off(void)
+{
+ cfag12864b_Controllers(1,1);
+ cfag12864b_DisplayState(0);
+}
+
+void cfag12864b_Clear(void)
+{
+ unsigned char Page,Address;
+
+ cfag12864b_Controllers(1,1);
+ for(Page=0; Page<Pages; ++Page) {
+ cfag12864b_Page(Page);
+ cfag12864b_Address(0);
+ for(Address=0; Address<Addresses; ++Address)
+ cfag12864b_WriteByte(0x00);
+ }
+}
+
+void cfag12864b_Write(
+ unsigned short _Offset,
+ unsigned char * _Buffer,
+ unsigned short _Count)
+{
+ unsigned short i;
+
+ // Invalid values: They get updated at the first cycle
+ unsigned char Controller = 0xFF;
+ unsigned char Page = 0xFF;
+ unsigned char Address = 0xFF;
+
+ unsigned char tmpController, tmpPage, tmpAddress;
+
+ for(i=0; i<_Count; ++i, ++_Offset, ++Address) {
+ tmpController = GetController(_Offset);
+ tmpPage = GetPage(_Offset);
+ tmpAddress = GetAddress(_Offset);
+
+ if(Controller != tmpController) {
+ Controller = tmpController;
+ cfag12864b_Controller(Controller);
+ cfag12864b_NOP();
+ }
+ if(Page != tmpPage) {
+ Page = tmpPage;
+ cfag12864b_Page(Page);
+ cfag12864b_NOP();
+ }
+
+ /*if(Address != tmpAddress) {
+ Address = tmpAddress;
+ cfag12864b_Address(Address);
+ cfag12864b_NOP();
+ }*/
+
+ /*if(tmpController == 0) {
+ if(Address != tmpAddress) {
+ Address = tmpAddress;
+ cfag12864b_Address(Address);
+ }
+ }
+ else {
+ cfag12864b_Address(tmpAddress);
+ cfag12864b_NOP();
+ }*/
+
+ // Safe method, still quick
+ cfag12864b_Address(tmpAddress);
+ cfag12864b_NOP();
+
+ // Dummy
+ cfag12864b_NOP();
+
+ cfag12864b_WriteByte(_Buffer[i]);
+ }
+}
+
+void cfag12864b_Format(unsigned char * _Src)
+{
+ unsigned short Controller,Page,Address,Bit;
+ unsigned char * Dest = kmalloc(sizeof(unsigned char)*Size,GFP_KERNEL);
+
+ if(Dest == NULL) {
+ printk(PRINTK_PREFIX "Format: ERROR: "
+ "kmalloc\n");
+ return;
+ }
+
+ for(Controller=0; Controller<Controllers; ++Controller)
+ for(Page=0; Page<Pages; ++Page)
+ for(Address=0; Address<Addresses; ++Address) {
+ Dest[(Controller*Pages+Page)*Addresses+Address]=0;
+ for(Bit=0; Bit<Bits; ++Bit)
+ if(_Src[Controller*Addresses+Address+(Page*Bits+Bit)*Width])
+ Dest[(Controller*Pages+Page)*Addresses+Address]|=Bit(Bit);
+ }
+
+ cfag12864b_Write(0,Dest,Size);
+
+ kfree(Dest);
+}
+
+EXPORT_SYMBOL_GPL(cfag12864b_On);
+EXPORT_SYMBOL_GPL(cfag12864b_Off);
+EXPORT_SYMBOL_GPL(cfag12864b_Clear);
+EXPORT_SYMBOL_GPL(cfag12864b_Write);
+EXPORT_SYMBOL_GPL(cfag12864b_Format);
+
+
+//
+// Fops
+//
+
+int Open(
+ struct inode * _Inode,
+ struct file * _File)
+{
+ _File->private_data = container_of(_Inode->i_cdev, struct
cfag12864b, CharDevice);
+
+ return 0;
+}
+
+loff_t Seek(
+ struct file * _File,
+ loff_t _Offset,
+ int _Whence)
+{
+ loff_t New;
+
+ switch(_Whence) {
+ case 0: // SEEK_SET
+ New = _Offset;
+ break;
+ case 1: // SEEK_CUR
+ New = _File->f_pos + _Offset;
+ break;
+ case 2: // SEEK_END
+ New = Size + _Offset;
+ break;
+ default:
+ return -EINVAL;
+ }
+
+ if(New < 0)
+ return -EINVAL;
+ _File->f_pos = New;
+ return New;
+}
+
+
+ssize_t Write(
+ struct file * _File,
+ const char __user * _Buffer,
+ size_t _Count,
+ loff_t * _Offset)
+{
+ int Result;
+ char * Buffer;
+
+ if(*_Offset>Size)
+ return 0;
+ if(*_Offset+_Count>Size)
+ _Count=Size-*_Offset;
+
+ Buffer = kmalloc(_Count,GFP_KERNEL);
+ if(Buffer == NULL) {
+ printk(PRINTK_PREFIX "FOP Write: ERROR: "
+ "kmalloc\n");
+ return -ENOMEM;
+ }
+
+ Result = copy_from_user(Buffer, _Buffer, _Count);
+ if(Result != 0) {
+ printk(PRINTK_PREFIX "FOP Write: ERROR: "
+ "copy_from_user\n");
+ Result = -EFAULT;
+ goto out;
+ }
+
+ cfag12864b_Write(*_Offset, Buffer, _Count);
+
+ *_Offset += _Count;
+ Result = _Count;
+
+out:
+ kfree(Buffer);
+ return Result;
+}
+
+int IOCtl_Format(unsigned long _Arg)
+{
+ int Result,Return = -ENOTTY;
+
+ unsigned char * IOCFormatSrc;
+
+ // Alloc src buffer
+ IOCFormatSrc = kmalloc(sizeof(unsigned char)*Width*Height,GFP_KERNEL);
+ if(IOCFormatSrc == NULL) {
+ printk(PRINTK_PREFIX "FOP IOCtl: ERROR: "
+ "IOC FormatWrite: "
+ "kmalloc\n");
+ goto out;
+ }
+
+ // Copy src buffer from user
+ Result = copy_from_user(
+ IOCFormatSrc,
+ (void __user *)_Arg,
+ sizeof(unsigned char)*Width*Height);
+ if(Result != 0) {
+ printk(PRINTK_PREFIX "FOP IOCtl: ERROR: "
+ "IOC FormatWrite: "
+ "copy_from_user(IOCFormatSrc,...\n");
+ goto allocsrc;
+ }
+
+ cfag12864b_Format(IOCFormatSrc);
+
+ Return = 0;
+
+allocsrc:
+ kfree(IOCFormatSrc);
+out:
+ return Return;
+}
+
+int IOCtl(
+ struct inode * _Inode,
+ struct file * _File,
+ unsigned int _Cmd,
+ unsigned long _Arg)
+{
+ if(_IOC_TYPE(_Cmd) != CFAG12864B_IOC_MAGIC)
+ return -ENOTTY;
+ if(_IOC_NR(_Cmd) > CFAG12864B_IOC_MAXNR)
+ return -ENOTTY;
+
+ switch(_Cmd) {
+ case CFAG12864B_IOCON:
+ cfag12864b_On();
+ break;
+ case CFAG12864B_IOCOFF:
+ cfag12864b_Off();
+ break;
+ case CFAG12864B_IOCCLEAR:
+ cfag12864b_Clear();
+ break;
+ case CFAG12864B_IOCFORMAT:
+ return IOCtl_Format(_Arg);
+ default:
+ return -ENOTTY;
+ }
+
+ return 0;
+}
+
+
+
+struct file_operations Fops =
+{
+ .owner = THIS_MODULE,
+ .llseek = Seek,
+ .write = Write,
+ .ioctl = IOCtl,
+ .open = Open,
+};
+
+
+
+
+
+
+
+
+
+//
+// Module Init & Exit
+//
+
+int cfag12864b_init(void)
+{
+ unsigned int i;
+ int Result;
+
+ printk(PRINTK_PREFIX "Init... ");
+
+ Result = alloc_chrdev_region(&FirstDevice, FirstMinor, nDevices, Name);
+ if(Result < 0) {
+ printk("ERROR - alloc_chrdev_region\n");
+ return Result;
+ }
+ Major = MAJOR(FirstDevice);
+
+ Devices = kmalloc(nDevices * sizeof(struct cfag12864b), GFP_KERNEL);
+ if(Devices == NULL) {
+ printk("ERROR - kmalloc\n");
+ return -ENOMEM;
+ }
+ memset(Devices, 0, nDevices * sizeof(struct cfag12864b));
+
+ for(i=0; i<nDevices; ++i) {
+ Devices[i].Minor = FirstMinor+i;
+ Devices[i].Device = MKDEV(Major,Devices[i].Minor);
+
+ cdev_init(&(Devices[i].CharDevice), &Fops);
+ Devices[i].CharDevice.owner = THIS_MODULE;
+ Devices[i].CharDevice.ops = &Fops;
+ Result = cdev_add(&(Devices[i].CharDevice),
+ Devices[i].Device, 1);
+ if(Result < 0) {
+ printk("ERROR - cdev_add\n");
+ kfree(Devices);
+ return Result;
+ }
+
+ class_device_create(
+ display_class,NULL,MKDEV(Major,Devices[i].Minor),
+ NULL,"cfag12864b%d",Devices[i].Minor);
+ }
+
+
+ cfag12864b_Clear();
+ cfag12864b_On();
+
+ printk("Done\n");
+
+ return 0;
+}
+
+void cfag12864b_exit(void)
+{
+ unsigned int i;
+
+ printk(PRINTK_PREFIX "Exit... ");
+
+ cfag12864b_Off();
+
+ if(Devices != NULL) {
+ for(i=0; i<nDevices; ++i) {
+ class_device_destroy(display_class,MKDEV(Major,Devices[i].Minor));
+ cdev_del(&(Devices[i].CharDevice));
+ }
+ kfree(Devices);
+ }
+
+ unregister_chrdev_region(FirstDevice, nDevices);
+
+ printk("Done\n");
+}
+
+module_init(cfag12864b_init);
+module_exit(cfag12864b_exit);
+
+
+MODULE_LICENSE("GPL");
+MODULE_AUTHOR("Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>");
+MODULE_DESCRIPTION("cfag12864b");
+
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/drivers/display/display.c
linux-2.6.17.13/drivers/display/display.c
--- linux-2.6.17.13-vanilla/drivers/display/display.c 1970-01-01
01:00:00.000000000 +0100
+++ linux-2.6.17.13/drivers/display/display.c 2006-09-11
23:53:22.000000000 +0200
@@ -0,0 +1,60 @@
+/*
+ * Filename: display.c
+ * Version: 0.1.0
+ * Description: Display Class
+ * License: GPL
+ * Depends: -
+ *
+ * Author: Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>
+ * Date: 2006-09-10
+ */
+
+
+#include <linux/init.h>
+#include <linux/module.h>
+#include <linux/kernel.h>
+#include <linux/fs.h>
+#include <linux/device.h>
+#include <linux/display.h>
+
+#define NAME "display"
+#define PRINTK_PREFIX KERN_INFO NAME ": "
+
+static char * Name = NAME;
+
+//
+// Exported Display Data
+//
+
+struct class * display_class;
+EXPORT_SYMBOL_GPL(display_class);
+
+
+//
+// Module Init & Exit
+//
+
+int display_init(void)
+{
+ display_class = class_create(THIS_MODULE,Name);
+ if(IS_ERR(display_class)) {
+ printk(PRINTK_PREFIX "ERROR: class_simple_create\n");
+ return -EINVAL;
+ }
+
+ return 0;
+}
+
+void display_exit(void)
+{
+ class_destroy(display_class);
+}
+
+module_init(display_init);
+module_exit(display_exit);
+
+
+MODULE_LICENSE("GPL");
+MODULE_AUTHOR("Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>");
+MODULE_DESCRIPTION("display");
+
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/drivers/display/Kconfig
linux-2.6.17.13/drivers/display/Kconfig
--- linux-2.6.17.13-vanilla/drivers/display/Kconfig 1970-01-01
01:00:00.000000000 +0100
+++ linux-2.6.17.13/drivers/display/Kconfig 2006-09-12 00:04:14.000000000 +0200
@@ -0,0 +1,61 @@
+#
+# For a description of the syntax of this configuration file,
+# see Documentation/kbuild/kconfig-language.txt.
+#
+# Display drivers configuration.
+#
+
+menu "Display support"
+
+config DISPLAY
+ tristate "Display support"
+ default n
+ ---help---
+ If you have an extra display, like a small LCD screen, say Y.
+
+ To compile this as a module, choose M here:
+ module will be called display.
+
+ If unsure, say N.
+
+comment "Parallel port dependent:"
+
+config KS0108
+ tristate "KS0108 LCD Controller"
+ depends on DISPLAY && PARPORT
+ default n
+ ---help---
+ If you have a LCD display controlled by one or more KS0108
+ 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,
+ you will be able only to compile this as a module (M).
+
+ To compile this as a module, choose M here:
+ module will be called ks0108.
+
+ If unsure, say N.
+
+config CFAG12864B
+ tristate "CFAG12864B LCD Display"
+ 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
+
+ To compile this as a module, choose M here:
+ module will be called cfag12864b.
+
+ If unsure, say N.
+
+endmenu
+
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/drivers/display/ks0108.c
linux-2.6.17.13/drivers/display/ks0108.c
--- linux-2.6.17.13-vanilla/drivers/display/ks0108.c 1970-01-01
01:00:00.000000000 +0100
+++ linux-2.6.17.13/drivers/display/ks0108.c 2006-09-11 23:49:15.000000000 +0200
@@ -0,0 +1,177 @@
+/*
+ * Filename: ks0108.c
+ * Version: 0.1.0
+ * Description: ks0108 LCD Display Controller Driver
+ * License: GPL
+ * Depends: parport
+ *
+ * Author: Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>
+ * Date: 2006-09-10
+ */
+
+
+#include <linux/init.h>
+#include <linux/module.h>
+#include <linux/kernel.h>
+#include <linux/fs.h>
+#include <linux/delay.h>
+#include <linux/parport.h>
+#include <linux/ks0108.h>
+#include <asm/io.h>
+#include <asm/uaccess.h>
+
+
+#define NAME "ks0108"
+#define PRINTK_PREFIX KERN_INFO NAME ": "
+
+
+
+//
+// Module
+//
+
+static unsigned int Port = 0x378;
+module_param(Port,uint,S_IRUGO);
+
+
+
+//
+// Device
+//
+
+static const char * Name = NAME;
+
+static struct parport * Parport;
+static struct pardevice * Pardevice;
+
+
+
+//
+// ks0108 Exported Commands
+//
+
+#define Bit(n) ((unsigned char)(1<<(n)))
+
+void ks0108_WriteData(unsigned char _Byte)
+{
+ parport_write_data(Parport,_Byte);
+}
+
+void ks0108_WriteControl(unsigned char _Byte)
+{
+ const unsigned int ECycleDelay = 1;
+ udelay(ECycleDelay);
+ parport_write_control(Parport,_Byte);
+}
+
+void ks0108_DisplayState(unsigned char _State)
+{
+ unsigned char Command = Bit(1) | Bit(2) | Bit(3) | Bit(4) | Bit(5);
+ if(_State)
+ Command |= Bit(0);
+ ks0108_WriteData(Command);
+}
+
+void ks0108_StartLine(unsigned char _StartLine)
+{
+ const unsigned char MaxStartLine = 63;
+ unsigned char Command = Bit(6) | Bit(7);
+ if(_StartLine>MaxStartLine)
+ _StartLine=MaxStartLine;
+ Command |= _StartLine;
+ ks0108_WriteData(Command);
+}
+
+void ks0108_Address(unsigned char _Address)
+{
+ const unsigned char MaxAddress = 63;
+ unsigned char Command = Bit(6);
+ if(_Address>MaxAddress)
+ _Address=MaxAddress;
+ Command |= _Address;
+ ks0108_WriteData(Command);
+}
+
+void ks0108_Page(unsigned char _Page)
+{
+ const unsigned char MaxPage = 7;
+ unsigned char Command = Bit(3) | Bit(4) | Bit(5) | Bit(7);
+ if(_Page>MaxPage)
+ _Page=MaxPage;
+ Command |= _Page;
+ ks0108_WriteData(Command);
+}
+
+
+EXPORT_SYMBOL_GPL(ks0108_WriteData);
+EXPORT_SYMBOL_GPL(ks0108_WriteControl);
+EXPORT_SYMBOL_GPL(ks0108_DisplayState);
+EXPORT_SYMBOL_GPL(ks0108_StartLine);
+EXPORT_SYMBOL_GPL(ks0108_Address);
+EXPORT_SYMBOL_GPL(ks0108_Page);
+
+
+
+
+//
+// Module Init & Exit
+//
+
+int ks0108_init(void)
+{
+ int Return = -EINVAL;
+
+ printk(PRINTK_PREFIX "Init... ");
+
+ Parport = parport_find_base(Port);
+ if(Parport == NULL) {
+ printk("ERROR - parport_find_base\n");
+ Return = -EFAULT;
+ goto none;
+ }
+
+ Pardevice = parport_register_device(
+ Parport,Name,
+ NULL,NULL,NULL,
+ PARPORT_DEV_EXCL,NULL);
+ if(Pardevice == NULL) {
+ printk("ERROR: parport_register_device\n");
+ Return = -EFAULT;
+ goto none;
+ }
+
+ if(parport_claim(Pardevice) != 0) {
+ printk("ERROR: parport_claim\n");
+ Return = -EFAULT;
+ goto registered;
+ }
+
+ printk("Done\n");
+ return 0;
+
+registered:
+ parport_unregister_device(Pardevice);
+
+none:
+ return Return;
+}
+
+void ks0108_exit(void)
+{
+ printk(PRINTK_PREFIX "Exit... ");
+
+ parport_release(Pardevice);
+
+ parport_unregister_device(Pardevice);
+
+ printk("Done\n");
+}
+
+module_init(ks0108_init);
+module_exit(ks0108_exit);
+
+
+MODULE_LICENSE("GPL");
+MODULE_AUTHOR("Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>");
+MODULE_DESCRIPTION("ks0108");
+
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/drivers/display/Makefile
linux-2.6.17.13/drivers/display/Makefile
--- linux-2.6.17.13-vanilla/drivers/display/Makefile 1970-01-01
01:00:00.000000000 +0100
+++ linux-2.6.17.13/drivers/display/Makefile 2006-09-11 18:00:05.000000000 +0200
@@ -0,0 +1,7 @@
+#
+# Makefile for the kernel Display device drivers.
+#
+
+obj-$(CONFIG_DISPLAY) += display.o
+obj-$(CONFIG_KS0108) += ks0108.o
+obj-$(CONFIG_CFAG12864B) += cfag12864b.o
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/drivers/Kconfig
linux-2.6.17.13/drivers/Kconfig
--- linux-2.6.17.13-vanilla/drivers/Kconfig 2006-09-09 05:23:25.000000000 +0200
+++ linux-2.6.17.13/drivers/Kconfig 2006-09-11 19:04:53.000000000 +0200
@@ -72,4 +72,8 @@ source "drivers/edac/Kconfig"

source "drivers/rtc/Kconfig"

+# parport before display - some displays depend on it.
+
+source "drivers/display/Kconfig"
+
endmenu
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/drivers/Makefile
linux-2.6.17.13/drivers/Makefile
--- linux-2.6.17.13-vanilla/drivers/Makefile 2006-09-09 05:23:25.000000000 +0200
+++ linux-2.6.17.13/drivers/Makefile 2006-09-11 19:15:50.000000000 +0200
@@ -74,3 +74,4 @@ obj-$(CONFIG_SGI_SN) += sn/
obj-y += firmware/
obj-$(CONFIG_CRYPTO) += crypto/
obj-$(CONFIG_SUPERH) += sh/
+obj-$(CONFIG_DISPLAY) += display/
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/include/linux/cfag12864b.h
linux-2.6.17.13/include/linux/cfag12864b.h
--- linux-2.6.17.13-vanilla/include/linux/cfag12864b.h 1970-01-01
01:00:00.000000000 +0100
+++ linux-2.6.17.13/include/linux/cfag12864b.h 2006-09-11
17:32:19.000000000 +0200
@@ -0,0 +1,45 @@
+/*
+ * Filename: cfag12864b.h
+ * Version: 0.1.0
+ * Description: cfag12864b LCD Display Driver Header
+ * License: GPL
+ *
+ * Author: Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>
+ * Date: 2006-09-10
+ */
+
+#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
+
+#define CFAG12864B_CONTROLLERS 2
+#define CFAG12864B_PAGES 8
+#define CFAG12864B_ADDRESSES 64
+#define CFAG12864B_SIZE CFAG12864B_CONTROLLERS * \
+ CFAG12864B_PAGES * \
+ CFAG12864B_ADDRESSES
+
+#define CFAG12864B_IOC_MAGIC 0xFF
+#define CFAG12864B_IOC_MAXNR 0x03
+
+#define CFAG12864B_IOCOFF _IO(CFAG12864B_IOC_MAGIC,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,
+ unsigned char * Buffer,
+ unsigned short Count);
+extern void cfag12864b_Format(unsigned char * Src);
+
+#endif // _CFAG12864B_H_
+
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/include/linux/display.h
linux-2.6.17.13/include/linux/display.h
--- linux-2.6.17.13-vanilla/include/linux/display.h 1970-01-01
01:00:00.000000000 +0100
+++ linux-2.6.17.13/include/linux/display.h 2006-09-11 19:25:44.000000000 +0200
@@ -0,0 +1,19 @@
+/*
+ * Filename: display.h
+ * Version: 0.1.0
+ * Description: Display Class Header
+ * License: GPL
+ *
+ * Author: Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>
+ * Date: 2006-09-10
+ */
+
+#ifndef _DISPLAY_H_
+#define _DISPLAY_H_
+
+#include <linux/device.h>
+
+extern struct class * display_class;
+
+#endif // _DISPLAY_H_
+
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/include/linux/ks0108.h
linux-2.6.17.13/include/linux/ks0108.h
--- linux-2.6.17.13-vanilla/include/linux/ks0108.h 1970-01-01
01:00:00.000000000 +0100
+++ linux-2.6.17.13/include/linux/ks0108.h 2006-09-11 23:27:26.000000000 +0200
@@ -0,0 +1,22 @@
+/*
+ * Filename: ks0108.h
+ * Version: 0.1.0
+ * Description: ks0108 LCD Display Controller Driver Header
+ * License: GPL
+ *
+ * Author: Miguel Ojeda Sandonis <maxextreme@xxxxxxxxx>
+ * Date: 2006-09-10
+ */
+
+#ifndef _KS0108_H_
+#define _KS0108_H_
+
+extern void ks0108_WriteData(unsigned char Byte);
+extern void ks0108_WriteControl(unsigned char Byte);
+extern void ks0108_DisplayState(unsigned char State);
+extern void ks0108_StartLine(unsigned char StartLine);
+extern void ks0108_Address(unsigned char Address);
+extern void ks0108_Page(unsigned char Page);
+
+#endif // _KS0108_H_
+
diff -uprN -X linux-2.6.17.13-vanilla/Documentation/dontdiff
linux-2.6.17.13-vanilla/MAINTAINERS linux-2.6.17.13/MAINTAINERS
--- linux-2.6.17.13-vanilla/MAINTAINERS 2006-09-09 05:23:25.000000000 +0200
+++ linux-2.6.17.13/MAINTAINERS 2006-09-12 00:17:51.000000000 +0200
@@ -1640,6 +1640,11 @@ M: James.Bottomley@xxxxxxxxxxxxxxxxxxxxx
L: linux-scsi@xxxxxxxxxxxxxxx
S: Maintained

+DISPLAY DRIVERS
+P: Miguel Ojeda Sandonis
+M: maxextreme@xxxxxxxxx
+S: Maintained
+
LED SUBSYSTEM
P: Richard Purdie
M: rpurdie@xxxxxxxxx
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/