root/tags/0.10.0/drv_MilfordInstruments.c

/* $Id: drv_MilfordInstruments.c,v 1.14 2005/05/08 04:32:44 reinelt Exp $
 *
 * driver for Milford Instruments 'BPK' piggy-back serial interface board
 * for standard Hitachi 44780 compatible lcd modules.
 *
 * Copyright (C) 2003, 2004 Andy Baxter <andy@earthsong.free-online.co.uk>
 * Copyright (C) 2004 The LCD4Linux Team <lcd4linux-devel@users.sourceforge.net>
 *
 * based on the MatrixOrbital driver which is
 * Copyright (C) 1999, 2000 Michael Reinelt <reinelt@eunet.at>
 *
 * 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.
 *
 *
 * $Log: drv_MilfordInstruments.c,v $
 * Revision 1.14  2005/05/08 04:32:44  reinelt
 * CodingStyle added and applied
 *
 * Revision 1.13  2005/01/18 06:30:23  reinelt
 * added (C) to all copyright statements
 *
 * Revision 1.12  2004/06/26 12:04:59  reinelt
 *
 * uh-oh... the last CVS log message messed up things a lot...
 *
 * Revision 1.11  2004/06/26 09:27:21  reinelt
 *
 * added '-W' to CFLAGS
 * changed all C++ comments to C ones
 * cleaned up a lot of signed/unsigned mistakes
 *
 * Revision 1.10  2004/06/20 10:09:54  reinelt
 *
 * 'const'ified the whole source
 *
 * Revision 1.9  2004/06/06 06:51:59  reinelt
 *
 * do not display end splash screen if quiet=1
 *
 * Revision 1.8  2004/06/05 06:41:40  reinelt
 *
 * chancged splash screen again
 *
 * Revision 1.7  2004/06/05 06:13:12  reinelt
 *
 * splash screen for all text-based display drivers
 *
 * Revision 1.6  2004/06/02 09:41:19  reinelt
 *
 * prepared support for startup splash screen
 *
 * Revision 1.5  2004/05/31 05:38:02  reinelt
 *
 * fixed possible bugs with user-defined chars (clear high bits)
 * thanks to Andy Baxter for debugging the MilfordInstruments driver!
 *
 * Revision 1.4  2004/05/31 01:31:01  andy-b
 *
 *
 * fixed bug in Milford Instruments driver which drew extra graphics chars in
 * odd places when drawing double bars. (the display doesn't like it if you put
 * the escape character 0xfe inside a define char sequence).
 *
 * Revision 1.1  2004/05/26 05:03:27  reinelt
 *
 * MilfordInstruments driver ported
 *
 */

/* 
 *
 * exported fuctions:
 *
 * struct DRIVER drv_MilfordInstruments
 *
 */

#include "config.h"

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

#include "debug.h"
#include "cfg.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"


static char Name[] = "MilfordInstruments";

typedef struct {
    int type;
    char *name;
    int rows;
    int cols;
} MODEL;

static MODEL Models[] = {
    {216, "MI216", 2, 16},
    {220, "MI220", 2, 20},
    {240, "MI240", 2, 40},
    {420, "MI420", 4, 20},
    {-1, "unknown", -1, -1},
};

static int Model;


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

static void drv_MI_clear(void)
{
    drv_generic_serial_write("\376\001", 2);  /* clear screen */
}


static void drv_MI_write(const int row, const int col, const char *data, const int len)
{
    char cmd[2] = "\376x";
    int ddbase = 128;
    if (row & 1) {    /* i.e. if row is 1 or 3 */
  ddbase += 64;
    }
    if (row & 2) {    /* i.e. if row is 0 or 2. */
  ddbase += 20;
    }
    cmd[1] = (char) (ddbase + col);
    drv_generic_serial_write(cmd, 2);

    drv_generic_serial_write(data, len);
}


static void drv_MI_defchar(const int ascii, const unsigned char *matrix)
{
    int i;
    char cmd[10] = "\376x";

    if (ascii < 8) {
  cmd[1] = (char) (64 + ascii * 8);
  for (i = 0; i < 8; i++) {
      cmd[i + 2] = matrix[i] & 0x1f;
  };
  drv_generic_serial_write(cmd, 10);
    }
}


static int drv_MI_start(const char *section, const int quiet)
{
    int i;
    char *model;

    model = cfg_get(section, "Model", NULL);
    if (model == NULL && *model == '\0') {
  error("%s: no '%s.Model' entry from %s", Name, section, cfg_source());
  return -1;
    }

    for (i = 0; Models[i].type != 0xff; i++) {
  if (strcasecmp(Models[i].name, model) == 0)
      break;
    }
    if (Models[i].type == 0xff) {
  error("%s: %s.Model '%s' is unknown from %s", Name, section, model, cfg_source());
  return -1;
    }
    Model = i;
    info("%s: using model '%s'", Name, Models[Model].name);

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

    /* initialize global variables */
    DROWS = Models[Model].rows;
    DCOLS = Models[Model].cols;

    drv_MI_clear();
    drv_generic_serial_write("\376\014", 2);  /* cursor off */

    if (!quiet) {
  if (drv_generic_text_greet(Models[Model].name, "Milford Instruments")) {
      sleep(3);
      drv_MI_clear();
  }
    }

    return 0;
}


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

/* none at the moment... */


/****************************************/
/***        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_MI_list(void)
{
    int i;

    for (i = 0; Models[i].type > 0; i++) {
  printf("%s ", Models[i].name);
    }
    return 0;
}


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

    /* 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 */
    GOTO_COST = 4;    /* number of bytes a goto command requires */

    /* real worker functions */
    drv_generic_text_real_write = drv_MI_write;
    drv_generic_text_real_defchar = drv_MI_defchar;


    /* start display */
    if ((ret = drv_MI_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 */
    drv_generic_text_bar_add_segment(0, 0, 255, 32);  /* ASCII  32 = blank */
    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 at the moment... */

    return 0;
}


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

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

    drv_generic_text_quit();

    /* clear display */
    drv_MI_clear();

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

    drv_generic_serial_close();

    return (0);
}


DRIVER drv_MilfordInstruments = {
  name:Name,
  list:drv_MI_list,
  init:drv_MI_init,
  quit:drv_MI_quit,
};