aboutsummaryrefslogtreecommitdiffstats
path: root/TODO
blob: bb6c9a081828095aecb19a3549021266a3a3dabc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
ToDo-List / Wishlist for lcd4linux

2000-04-04 Michael Reinelt <reinelt@eunet.at>
implement some sort of 'graphs', similar to bars, but with a time axis
can be filled (made up of bars) or not (needs raster graphics)

// 2000-04-04 Michael Reinelt <reinelt@eunet.at>
// write a driver for PNG. This should be the first step towards a WWW-driver.
Done 2001-03-01 -lt.

2000-04-15 Thomas Skyt Jessen <thskyt@foni.net>
show partition information (used, free, ...)

2000-04-25 Michael Mueller <m.mueller@netsystec.de>
show process information            

2000-12-03 Ghassan Matar <gmatar@hexapods.com>
show other sensors than temperature
we have to use libsensors instead of parsing the proc files directly

2000-12-03 Ghassan Matar <gmatar@hexapods.com>
show contents of any text file
the file should only contain one line, with a fixed format
there are two possibilities: text and numbers
numbers can be used for bars, too

2000-12-03 Ghassan Matar <gmatar@hexapods.com>
accept data from external sources (fifo?)

2001-02-11 Carsten Nau <info@cnau.de>
connect a LED to a spare pin of the parallel port and show if ISDN
is online

// 2001-01-27 Axel Ehnert <axel@ehnert.net>
// - display numer of emails in a mailbox
// - display seti@home values
done.

2001-03-05 Leo T�tsch <lt@toetsch.at>
rename some tokens: %o->%os, %v->%ov, %r->%or, %p->%op,
will be done with the big config-rework

2001-03-05 Leo T�tsch <lt@toetsch.at>
replace T_EXTENDED with a Flag similar to 'bar'
> 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291
/* $Id: drv_LCDTerm.c 975 2009-01-18 11:16:20Z michael $
 * $URL: https://ssl.bulix.org/svn/lcd4linux/trunk/drv_LCDTerm.c $
 *
 * driver for the LCDTerm serial-to-HD44780 adapter boards
 * http://www.bobblick.com/techref/projects/lcdterm/lcdterm.html
 *
 * Copyright (C) 2005 Michael Reinelt <michael@reinelt.co.at>
 * Copyright (C) 2005 The LCD4Linux Team <lcd4linux-devel@users.sourceforge.net>
 *
 * This file is part of LCD4Linux.
 *
 * LCD4Linux is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2, or (at your option)
 * any later version.
 *
 * LCD4Linux is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 *
 */

/* 
 *
 * exported fuctions:
 *
 * struct DRIVER drv_LCDTerm
 *
 */

#include "config.h"

#include <stdlib.h>
#include <unistd.h>

#include "debug.h"
#include "cfg.h"
#include "qprintf.h"
#include "plugin.h"
#include "widget.h"
#include "widget_text.h"
#include "widget_icon.h"
#include "widget_bar.h"
#include "drv.h"
#include "drv_generic_text.h"
#include "drv_generic_serial.h"

#define LCD_CLEAR 0x03
#define LCD_CMD   0x12
#define LCD_DATA  0x14

static char Name[] = "LCDTerm";


/****************************************/
/***  hardware dependant functions    ***/
/****************************************/

static void drv_LT_clear(void)
{
    char cmd[1];

    cmd[0] = LCD_CLEAR;		/* clear display */
    drv_generic_serial_write(cmd, 1);	/* clear screen */
}


static int drv_LT_send(const char request, const char value)
{
    char buf[2];

    buf[0] = request;
    buf[1] = value;
    drv_generic_serial_write(buf, 2);

    return 0;
}


static void drv_LT_command(const char cmd)
{
    drv_LT_send(LCD_CMD, cmd);
}


static void drv_LT_write(const int row, const int col, const char *data, int len)
{
    int pos;

    /* 16x4 Displays use a slightly different layout */
    if (DCOLS == 16 && DROWS == 4) {
	pos = (row % 2) * 64 + (row / 2) * 16 + col;
    } else {
	pos = (row % 2) * 64 + (row / 2) * 20 + col;
    }

    drv_LT_command(0x80 | pos);

    while (len--) {
	drv_LT_send(LCD_DATA, *data++);
    }
}

static void drv_LT_defchar(const int ascii, const unsigned char *matrix)
{
    int i;

    drv_LT_command(0x40 | 8 * ascii);

    for (i = 0; i < 8; i++) {
	drv_LT_send(LCD_DATA, *matrix++ & 0x1f);
    }
}


static int drv_LT_start(const char *section, const int quiet)
{
    int rows = -1, cols = -1;
    char *s;

    if (drv_generic_serial_open(section, Name, 0) < 0)
	return -1;

    s = cfg_get(section, "Size", NULL);
    if (s == NULL || *s == '\0') {
	error("%s: no '%s.Size' entry from %s", Name, section, cfg_source());
	return -1;
    }
    if (sscanf(s, "%dx%d", &cols, &rows) != 2 || rows < 1 || cols < 1) {
	error("%s: bad %s.Size '%s' from %s", Name, section, s, cfg_source());
	free(s);
	return -1;
    }

    DROWS = rows;
    DCOLS = cols;

    /* initialize display */
    drv_LT_command(0x29);	/* 8 Bit mode, 1/16 duty cycle, 5x8 font */
    drv_LT_command(0x08);	/* Display off, cursor off, blink off */
    drv_LT_command(0x0c);	/* Display on, cursor off, blink off */
    drv_LT_command(0x06);	/* curser moves to right, no shift */

    drv_LT_clear();		/* clear display */

    if (!quiet) {
	char buffer[40];
	qprintf(buffer, sizeof(buffer), "%s %dx%d", Name, DCOLS, DROWS);
	if (drv_generic_text_greet(buffer, "www.bwct.de")) {
	    sleep(3);
	    drv_LT_clear();
	}
    }

    return 0;
}


/****************************************/
/***            plugins               ***/
/****************************************/

/* none */


/****************************************/
/***        widget callbacks          ***/
/****************************************/


/* using drv_generic_text_draw(W) */
/* using drv_generic_text_icon_draw(W) */
/* using drv_generic_text_bar_draw(W) */


/****************************************/
/***        exported functions        ***/
/****************************************/


/* list models */
int drv_LT_list(void)
{
    printf("LCDTerm serial-to-HD44780 adapter board");
    return 0;
}


/* initialize driver & display */
int drv_LT_init(const char *section, const int quiet)
{
    WIDGET_CLASS wc;
    int asc255bug;
    int ret;

    info("%s: %s", Name, "$Rev: 975 $");

    /* display preferences */
    XRES = 5;			/* pixel width of one char  */
    YRES = 8;			/* pixel height of one char  */
    CHARS = 8;			/* number of user-defineable characters */
    CHAR0 = 0;			/* ASCII of first user-defineable char */

    /* Fixme: */
    GOTO_COST = 2;		/* number of bytes a goto command requires */

    /* real worker functions */
    drv_generic_text_real_write = drv_LT_write;
    drv_generic_text_real_defchar = drv_LT_defchar;


    /* start display */
    if ((ret = drv_LT_start(section, quiet)) != 0)
	return ret;

    /* initialize generic text driver */
    if ((ret = drv_generic_text_init(section, Name)) != 0)
	return ret;

    /* initialize generic icon driver */
    if ((ret = drv_generic_text_icon_init()) != 0)
	return ret;

    /* initialize generic bar driver */
    if ((ret = drv_generic_text_bar_init(0)) != 0)
	return ret;

    /* add fixed chars to the bar driver */
    /* most displays have a full block on ascii 255, but some have kind of  */
    /* an 'inverted P'. If you specify 'asc255bug 1 in the config, this */
    /* char will not be used, but rendered by the bar driver */
    cfg_number(section, "asc255bug", 0, 0, 1, &asc255bug);
    drv_generic_text_bar_add_segment(0, 0, 255, 32);	/* ASCII  32 = blank */
    if (!asc255bug)
	drv_generic_text_bar_add_segment(255, 255, 255, 255);	/* ASCII 255 = block */

    /* register text widget */
    wc = Widget_Text;
    wc.draw = drv_generic_text_draw;
    widget_register(&wc);

    /* register icon widget */
    wc = Widget_Icon;
    wc.draw = drv_generic_text_icon_draw;
    widget_register(&wc);

    /* register bar widget */
    wc = Widget_Bar;
    wc.draw = drv_generic_text_bar_draw;
    widget_register(&wc);

    /* register plugins */
    /* none */

    return 0;
}


/* close driver & display */
int drv_LT_quit(const int quiet)
{

    info("%s: shutting down.", Name);

    drv_generic_text_quit();

    /* clear display */
    drv_LT_clear();

    /* say goodbye... */
    if (!quiet) {
	drv_generic_text_greet("goodbye!", NULL);
    }

    drv_generic_serial_close();

    return (0);
}


DRIVER drv_LCDTerm = {
    .name = Name,
    .list = drv_LT_list,
    .init = drv_LT_init,
    .quit = drv_LT_quit,
};