Revision 0:775da631eb9a, committed 2010-01-17

Comitter:

paulg

Date:

Sun Jan 17 11:06:20 2010 +0000

Commit message:

Changed in this revision

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/TextStar.cpp	Sun Jan 17 11:06:20 2010 +0000
@@ -0,0 +1,147 @@
+/* mbed TextStar serial LCD Library
+ * Copyright (c) 2009-2010 Paul Griffith 
+ * Released under the MIT License: http://mbed.org/license/mit
+ *
+ * Last edit: 10 Jan 2010
+ *  
+ * TextStar CW-LCD-02 16x2 serial LCD module
+ * Cat's Whisker Technologies, http://www.cats-whisker.com 
+ */
+ 
+#include "TextStar.h"
+#include "mbed.h"
+
+
+TextStar::TextStar(PinName tx, PinName rx) : Serial(tx, rx) {
+    reset();
+}
+
+void TextStar::cls() {
+    //clear screen = 254,'S'
+    //does not affect auto-blank and auto-scroll
+    this->putc('\014');
+}
+
+void TextStar::locate(int column, int row) {
+    //position cursor = 254,'P',line (0-15), col (0-15) 
+    this->printf("\376P%c%c", row + 1, column + 1);
+}
+
+void TextStar::foreground(int colour) {
+    //colours not supported
+}
+
+void TextStar::background(int colour) {
+    //colours not supported
+}
+
+void TextStar::reset(int autoblank, int autoscroll) {
+    //reset screen = 254,'R'
+    this->printf("\376R");
+    //set up auto-blank and auto-scroll as per arguments
+    _autoblank = (autoblank == 0) ? 0 : 1;
+    _autoscroll = (autoscroll == 0) ? 0 : 1;
+    this->printf("\376G%c", 1 + (_autoblank * 64) + (_autoscroll * 64) );
+//    this->printf("AB = %d AS = %d", _autoblank, _autoscroll);
+//    wait(2.0);
+//    cls();
+}
+
+void TextStar::left(void) {
+    //move cursor left = 8
+    this->putc('\010');
+}
+
+void TextStar::right(void) {
+    //move cursor right = 9
+    this->putc('\011');
+}
+
+void TextStar::down(void) {
+    //move cursor down one line = 10
+    this->putc('\012');
+}
+
+void TextStar::up(void) {
+    //move cursor up one line = 11
+    this->putc('\013');
+}
+
+void TextStar::home(void) {
+    //cursor home = 254,'H'
+    this->printf("\376H");
+}
+
+void TextStar::crlf(void) {
+    //carriage return = 13
+    this->putc('\015');
+}
+
+void TextStar::del(void) {
+    //delete character = 127
+    this->putc('\177');
+}
+
+void TextStar::set_cursor(int style) {
+    //styles: 0 = none, 1 = solid block, 2 = flash block, 3 = solid uline, 4 = flash uline
+    if (style < 0 || style > 4)
+        return;
+    this->printf("\376C%c", style);
+}
+
+void TextStar::window(int line) {
+    //move visible window to line (0-14)
+    if (line < 0 || line > 14)
+        return;
+    this->printf("\376G%c", line + 1 + (_autoblank * 64) + (_autoscroll * 128) );
+}
+
+void TextStar::scroll_up(void) {
+    //move visble window up one line
+    this->printf("\376O%c", 1);
+}
+
+void TextStar::scroll_down(void) {
+    //move visible window down one line
+    this->printf("\376O%c", 0);
+}
+
+void TextStar::bar_graph(int capped, int length, int percentage) {
+    if (length < 1 || length > 16) {
+        this->printf("Bad len %d", length);
+        wait(2.0);
+        return;
+    }
+    if (percentage < 0 || percentage > 100) {
+        this->printf("Bad val %d", percentage);
+        wait(2.0);
+        return;
+    }
+    this->printf("\376%c%c%c", (capped == 0)? 'B' : 'b', length, percentage);
+} 
+
+void TextStar::custom_char(int num, char *bitmap) {
+    //define custom character = 254,'D',bm1,bm2,bm3,bm4,bm5,bm6,bm7,bm8
+    if (num < 128 || num > 135) {
+        this->printf("Bad CC num %d", num);
+        wait(2.0);
+        return;
+    }
+    this->printf("\376D%c%c%c%c%c%c%c%c%c", num, bitmap[0], bitmap[1], bitmap[2], bitmap[3],
+        bitmap[4], bitmap[5], bitmap[6], bitmap[7]);    
+}
+
+void TextStar::version(void) {
+    //display firmware version and custom characters = 254,'V'
+    this->printf("\376V");
+}
+
+void TextStar::send_version(void) {
+    //send firmware version = 254,'v'
+    this->printf("\376v");
+}
+
+void TextStar::send_keys(void) {
+    //send key states = 254,'K'
+    this->printf("\376K");
+}
\ No newline at end of file

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/TextStar.h	Sun Jan 17 11:06:20 2010 +0000
@@ -0,0 +1,56 @@
+/* mbed TextStar serial LCD Library
+ * Copyright (c) 2009-2010 Paul Griffith
+ * Released under the MIT License: http://mbed.org/license/mit
+ *
+ * Last edit: 10 Jan 2010
+ *
+ * TextStar CW-LCD-02 16x2 serial LCD module
+ * Cat's Whisker Technologies, http://www.cats-whisker.com 
+ */
+
+#include "mbed.h"
+
+#ifndef MBED_TEXTSTAR_H
+#define MBED_TEXTSTAR_H
+
+class TextStar : public Serial {
+public:
+
+    TextStar(PinName tx, PinName rx);
+
+   //printf(), putc(), baud() etc are inherited from Serial
+    
+    //basic commands common to all mbed Text Display libraries
+
+    void cls();
+    void locate(int column, int row);
+    void foreground(int colour);
+    void background(int colour);
+
+    //TextStar specific commands
+                
+    void reset(int autoblank =1, int autoscroll =1);
+    void left();
+    void right();
+    void down();
+    void up();
+    void home();
+    void crlf();
+    void del();
+    void set_cursor(int style);
+    void window(int line);
+    void scroll_up();
+    void scroll_down();
+    void bar_graph(int capped, int length, int percentage);
+    void custom_char(int num, char *bitmap);
+    void version();
+    void send_version();
+    void send_keys();
+
+protected:
+
+    int _autoblank, _autoscroll;
+
+};
+
+#endif

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/main.cpp	Sun Jan 17 11:06:20 2010 +0000
@@ -0,0 +1,290 @@
+/* Test harness for TextStar serial LCD library
+ * Paul Griffith
+ * Last edit: 10 Jan 2010
+ */
+ 
+#include "mbed.h"
+#include "TextStar.h"
+
+void bargraph_demo(int);
+void printhelps(void);
+void bad_args(void);
+
+Serial pc(USBTX, USBRX);
+TextStar lcd(p9, p10); // tx, rx
+
+int main() {
+    char buf[120], *cp;
+    char arg1[50], arg2[50], arg3[50];
+    int argc, cnt = 0, i, j, k, l;
+
+
+    printf("TextStar Serial LCD test harness\n");
+    printf("Type ? for help\n");
+    lcd.printf("TextStar Serial\rLCD test harness");
+            
+    while (1) {
+        printf("> ");
+        cp = buf;
+        while ( (*cp++ = putchar(getchar())) != '\r') ;   //get a line of input
+        *cp = '\0';                                       //terminate buffer
+        printf("\n");
+        argc = sscanf(buf, "%s%s%s", arg1, arg2, arg3);   //extract command and arguments
+        if (argc < 1)
+            continue;
+        switch (arg1[0]) {
+
+            case 'b':        //bar graph demo
+                bargraph_demo(0);
+                wait(1.0);
+                bargraph_demo(1);
+                break;
+
+            case 'c':        //clear display
+                lcd.cls();
+                break;
+
+            case 'C':        //set cursor style
+                if (argc != 2) {
+                    bad_args();
+                    break;
+                }
+                sscanf(arg2, "%d", &i);   //extract style number
+                lcd.set_cursor(i);                
+                break;
+
+            case 'd':    //move cursor down
+                j = 1;
+                if (argc == 2)
+                    sscanf(arg2, "%d", &j);
+                for (i = 0; i < j; i++)
+                    lcd.down();
+                break;
+                                
+            case 'D':    //define custom character
+                sscanf(buf, "%s%d%x%x", arg1, &i, &j, &k);   //extract arguments
+                arg3[0] = (j >> 24) & 0xFF;
+                arg3[1] = (j >> 16) & 0xFF;
+                arg3[2] = (j >> 8) & 0xFF;
+                arg3[3] = j & 0xFF;
+                arg3[4] = (k >> 24) & 0xFF;
+                arg3[5] = (k >> 16) & 0xFF;
+                arg3[6] = (k >> 8) & 0xFF;
+                arg3[7] = k & 0xFF;
+                lcd.custom_char(i, arg3);
+                lcd.cls();
+                lcd.printf("Custom chars");
+                lcd.locate(0, 1);
+                lcd.printf("128-135 %c%c%c%c%c%c%c%c", 0x80, 0x81,
+                    0x82, 0x83, 0x84, 0x85, 0x86, 0x87);
+                break;
+
+            case 'e':        //enter text at current position
+                if (argc < 2) {
+                    bad_args();
+                    break;
+                }
+                *--cp = '\0';    //get rid of \r at end of buffer
+                sscanf(buf, "%s%n", arg1, &i);   //extract arguments
+//                cp = buf + i;
+//                while (*cp++ == ' ') ;    //find start of text
+//                --cp;
+                cp = buf + i + 1;    //allow leading white space
+                lcd.printf("%s", cp);
+                break;
+
+            case 'h':        //cursor home
+                lcd.home();
+                break;
+
+            case 'k':        //get key states
+                while (lcd.readable() )
+                    lcd.getc();        //empty buffer
+                printf("Key states = ");
+                lcd.send_keys();
+                i = lcd.getc();
+                j = lcd.getc();
+                k = lcd.getc();
+                l = lcd.getc();
+                printf("%c%c%c%c\n", i, j, k, l);
+                break;
+
+            case 'K':        //get key output until any char typed on pc
+                printf("Key output: ");
+                while (pc.readable() == 0) {
+                    if (lcd.readable() )
+                        pc.putc(lcd.getc() );
+                }
+                while (pc.readable() )
+                    pc.getc();
+                printf("\nAll done\n");
+                break;
+                
+            case 'o':        //output demo
+                lcd.cls();
+                j = 20;
+                if (argc == 2) {
+                    sscanf(arg2, "%d", &j);
+                }
+                for (i = 0; i < j; i++) {
+                    lcd.printf("Count = %d\r", cnt++);
+                    wait( (i == 0) ? 1.0 : 0.2);
+                }
+                break;
+
+            case 'l':        //move cursor left
+                j = 1;
+                if (argc == 2)
+                    sscanf(arg2, "%d", &j);
+                for (i = 0; i < j; i++)
+                    lcd.left();
+                break;
+                            
+            case 'p':        //set cursor position
+                if (argc < 3) {
+                    bad_args();
+                    break;
+                }
+                sscanf(buf, "%s%d%d", arg1, &i, &j);   //extract arguments
+                lcd.locate(j, i);
+                break;
+                
+            case 'q':        //quit
+                exit(1);
+                break;
+
+            case 'r':        //move cursor right
+                j = 1;
+                if (argc == 2)
+                    sscanf(arg2, "%d", &j);
+                for (i = 0; i < j; i++)
+                    lcd.right();
+                break;
+                
+            case 'R':        //reset display (and set autoblank (and autoscroll) )
+                if (argc == 1) {
+                    lcd.reset();
+                }
+                else if (argc == 2) {
+                    sscanf(arg2, "%d", &i);
+                    lcd.reset(i);
+                }
+                else if (argc >= 3) {
+                    sscanf(arg2, "%d", &i);
+                    sscanf(arg3, "%d", &j);
+                    lcd.reset(i, j);
+                }
+                break;
+
+            case 's':        //scroll down
+                j = 1;
+                if (argc == 2)
+                    sscanf(arg2, "%d", &j);
+                for (i = 0; i < j; i++)
+                    lcd.scroll_down();
+                break;
+
+            case 'S':        //scroll up
+                j = 1;
+                if (argc == 2)
+                    sscanf(arg2, "%d", &j);
+                for (i = 0; i < j; i++)
+                    lcd.scroll_up();
+                break;
+                
+            case 'u':        //move cursor up
+                j = 1;
+                if (argc == 2)
+                    sscanf(arg2, "%d", &j);
+                for (i = 0; i < j; i++)
+                    lcd.up();
+                break;
+                   
+            case 'v':        //display firmware version
+                lcd.version();
+                break;
+
+                            
+            case 'w':        //move visible window
+                if (argc != 2) {
+                    bad_args();
+                    break;
+                }
+                sscanf(arg2, "%d", &i);   //extract line number
+                lcd.window(i);
+                break;
+                
+            case 'x':        //send hex data to display
+                argc = sscanf(buf, "%s%x%x%x%x", arg1, &i, &j, &k, &l);   //extract arguments
+                if (argc > 1)
+                    lcd.putc(i & 0xFF);
+                if (argc > 2)
+                    lcd.putc(j & 0xFF);
+                if (argc > 3)
+                    lcd.putc(k & 0xFF);
+                if (argc > 4)
+                    lcd.putc(l & 0xFF);                    
+                break;
+
+            case '?':        //print help
+                printhelps();
+                break;
+                
+            default:
+                printf("?? Unknown command\n");
+                break;
+        }
+    }
+}
+
+//Command functions
+
+void printhelps(void) {
+    printf("Command summary:\n");
+    printf("b            bar graph demo\n");
+    printf("c            clear display\n");
+    printf("C style      set cursor style (0-4)\n");
+    printf("d [n]        cursor down n times (default 1)\n");
+    printf("D n bm1 bm2  define custom char n (128-135) with bitmap in hex\n");
+    printf("             bm1 = bitmap rows 1-4, bm2 = rows 5-8\n");
+    printf("e text       enter text at current position\n");
+    printf("h            cursor home\n");
+    printf("k            get key states\n");
+    printf("K            show key output\n");
+    printf("l [n]        cursor left n times (default 1)\n");
+    printf("o            output demo\n");
+    printf("p line col   set cursor position to line (0-15) and column (0-15)\n");
+    printf("q            quit\n");
+    printf("r [n]        cursor right n times (default 1)\n");
+    printf("R [ab] [as]  reset display, set auto-blank (0/1) and auto-scroll (0/1)\n");
+    printf("s [n]        scroll down n times (default 1)\n");
+    printf("S [n]        scroll up n times (default 1)\n");
+    printf("u [n]        cursor up n times (default 1)\n");
+    printf("v            display firmware version\n");
+    printf("w line       move display window to specified line (0-14)\n");
+    printf("x b b b b    send hex data to display, up to 4 bytes\n");
+}
+
+void bargraph_demo(int capped) {
+
+    int i;
+
+    lcd.cls();
+    lcd.printf("BAR GRAPH DEMO %d", capped + 1);
+    for (i = 0; i <= 100; i++) {
+        lcd.locate(0, 1);
+        lcd.bar_graph(capped, 16, i);
+        wait( (i == 0) ? 1.0 : 0.02);
+    }
+    wait(1.0);
+    for (i = 100; i >= 0; i--) {
+        lcd.locate(0, 1);
+        lcd.bar_graph(capped, 16, i);
+        wait( (i == 0) ? 1.0 : 0.02);
+    }
+}
+
+void bad_args(void) {
+    printf("?? Bad arguments\n");
+}
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mbed.bld	Sun Jan 17 11:06:20 2010 +0000
@@ -0,0 +1,1 @@
+http://mbed.org/users/mbed_official/code/mbed/builds/49a220cc26e0