Functions test with Optrex LCD 20x4

Dependencies:   mbed

Dependents:   DatatypesLength AsciiCode IntegerFormatSpecifiers FloatFormatSpecifier

Files at this revision

API Documentation at this revision

Comitter:
Eduard
Date:
Mon Nov 29 22:27:13 2010 +0000
Parent:
2:9e13bd7280e1
Commit message:

Changed in this revision

OptrexLCD.cpp Show diff for this revision Revisions of this file
OptrexLCD.h Show diff for this revision Revisions of this file
main.cpp Show annotated file Show diff for this revision Revisions of this file
mbed.bld Show annotated file Show diff for this revision Revisions of this file
diff -r 9e13bd7280e1 -r 52fb10c44695 OptrexLCD.cpp
--- a/OptrexLCD.cpp	Mon Nov 29 22:26:12 2010 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,180 +0,0 @@
-/* mbed TextLCD Library, for a 4-bit LCD based on Optrex DCM20481 NY-LY-ABE
-*
-* Copyright (c) 2007-2010, sford modified by E.Sjoukes
-*
-* Permission is hereby granted, free of charge, to any person obtaining a copy
-* of this software and associated documentation files (the "Software"), to deal
-* in the Software without restriction, including without limitation the rights
-* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-* copies of the Software, and to permit persons to whom the Software i
-* furnished to do so, subject to the following conditions:
-*
-* The above copyright notice and this permission notice shall be included in
-* all copies or substantial portions of the Software.
-*
-* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-* THE SOFTWARE.
-*/
-
-#include "OptrexLCD.h"
-#include "mbed.h"
-
-// initialiseer  
-TextLCD::TextLCD(PinName rs, PinName e, PinName d0, PinName d1, PinName d2, 
-            PinName d3, LCDType type) : _rs(rs), _e(e), _d(d0, d1, d2, d3), _type(type) 
-{
-    _e  = 1;                // enable normaly high
-    _rs = 0;                // command mode
- 
-    wait(0.015);            // Wait 15ms to ensure powered up
-
-    for (int i=0; i<3; i++) // send "Display Settings" 3 times
-    {
-        writeByte(0x3);
-        wait(0.00164);      // this command takes 1.64ms, so wait for it
-    }
-    writeByte(0x2);         // 4-bit mode
-    wait(0.000040f);        // most instructions take 40us
-
-    writeCommand(0x28);     // Function set 001 BW N F - -
-    writeCommand(0x0C);
-    writeCommand(0x6);      // Cursor Direction and Display Shift : 0000 01 CD S (CD 0-left, 1-right S(hift) 0-no, 1-yes
-    cls();
-}
- 
-void TextLCD::character(int column, int row, int c) 
-{
-    int a = address(column, row);
-    writeCommand(a);
-    writeData(c);
-}
- 
-void TextLCD::cls() 
-{
-    writeCommand(0x01);    // cls, and set cursor to 0
-    wait(0.003000f);       // This command takes 3ms with Optrex, normaly it wood be 1.64ms
-    locate(0, 0);
-}
- 
-void TextLCD::locate(int column, int row) 
-{
-    _column = column;
-    _row = row;
-}
- 
-int TextLCD::_putc(int value) 
-{
-    if (value == '\n') 
-    {
-        _column = 0;
-        _row++;
-        if (_row >= rows()) 
-        {
-            _row = 0;
-        }
-    } 
-    else 
-    {
-        character(_column, _row, value);
-        _column++;
-        if (_column >= columns()) 
-        {
-            _column = 0;
-            _row++;
-            if (_row >= rows()) 
-            {
-                _row = 0;
-            }
-        }
-    }
-    return value;
-}
- 
-int TextLCD::_getc() 
-{
-     return -1;
-}
- 
-void TextLCD::writeByte(int value) 
-{
-     _d = value >> 4;
-     wait(0.000040f);   // most instructions take 40us
-     _e = 0;
-     wait(0.000075f);   // enable puls of Optrex needs to be 75us 
-     _e = 1;
-     _d = value >> 0;
-     wait(0.000075f);   // enable puls of Optrex needs to be 75us
-     _e = 0;
-     wait(0.000075f);   // enable puls of Optrex needs to be 75us
-     _e = 1;
-}
- 
-void TextLCD::writeCommand(int command) 
-{
-     _rs = 0;
-     writeByte(command);
-}
-
-void TextLCD::writeData(int data) 
-{
-     _rs = 1;
-     writeByte(data);
-}
-
-int TextLCD::address(int column, int row) 
-{
-     switch (_type) 
-     {
-       case LCD20x4:
-             switch (row) 
-             {
-                 case 0:
-                     return 0x80 + column;
-                 case 1:
-                     return 0xc0 + column;
-                 case 2:
-                     return 0x94 + column;
-                 case 3:
-                     return 0xd4 + column;
-             }
-         case LCD16x2B:
-            return 0x80 + (row * 40) + column;
-         case LCD16x2:
-         case LCD20x2:
-         default:
-             return 0x80 + (row * 0x40) + column;
-     }
-}
- 
-int TextLCD::columns() 
-{
-     switch (_type) 
-     {
-         case LCD20x4:
-         case LCD20x2:
-            return 20;
-         case LCD16x2:
-         case LCD16x2B:
-         default:
-             return 16;
-     }
-}
- 
-int TextLCD::rows() 
-{
-     switch (_type) 
-     {
-         case LCD20x4:
-             return 4;
-         case LCD16x2:
-         case LCD16x2B:
-         case LCD20x2:
-         default:
-             return 2;
-     }
-}
diff -r 9e13bd7280e1 -r 52fb10c44695 OptrexLCD.h
--- a/OptrexLCD.h	Mon Nov 29 22:26:12 2010 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,105 +0,0 @@
-/* mbed TextLCD Library, for a 4-bit LCD based on Optrex  DCM20481 NY-LY-ABE
-* Copyright (c) 2007-2010, sford modified by E.Sjoukes
-*
-* Permission is hereby granted, free of charge, to any person obtaining a copy
-* of this software and associated documentation files (the "Software"), to deal
-* in the Software without restriction, including without limitation the rights
-* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-* copies of the Software, and to permit persons to whom the Software is
-* furnished to do so, subject to the following conditions:
-*
-* The above copyright notice and this permission notice shall be included in
-* all copies or substantial portions of the Software.
-*
-* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-* THE SOFTWARE.
-*/
- 
-#ifndef MBED_OptrexLCD_H
-#define MBED_OptrexLCD_H
- 
-#include "mbed.h"
- 
-/** A TextLCD interface for driving 4-bit HD44780-based LCDs
-*
-* Currently supports 16x2, 20x2 and 20x4 panels
-*
-* @code
-* #include "mbed.h"
-* #include "OptrexLCD.h"
-* 
-* TextLCD lcd(p10, p12, p15, p16, p17, p18 ); // rs, e, d0-d3
-* 
-* int main() {
-*     lcd.printf("Hello World!\n");
-* }
-* @endcode
-*/
-class TextLCD : public Stream 
-{
-public:
-     /** LCD panel format */
-     enum LCDType 
-     {
-         LCD16x2,   /**< 16x2 LCD panel (default) */
-         LCD16x2B,  /**< 16x2 LCD panel alternate addressing */
-         LCD20x2,   /**< 20x2 LCD panel */
-         LCD20x4    /**< 20x4 LCD panel */
-     };
- 
-     /** Create a TextLCD interface
-       * @param rs    Instruction/data control line
-       * @param e     Enable line (clock)
-       * @param d0-d3 Data lines
-       * @param type  Sets the panel size/addressing mode (default = LCD16x2)
-     */
-     TextLCD(PinName rs, PinName e, PinName d0, PinName d1, PinName d2, PinName d3, LCDType type = LCD16x2);
- 
-#if DOXYGEN_ONLY
-     /** Write a character to the LCD
-       * @param c The character to write to the display
-     */
-     int putc(int c);
- 
-     /** Write a formated string to the LCD
-       * @param format A printf-style format string, followed by the variables to use in formating the string.            
-      */
-     int printf(const char* format, ...);
-#endif
- 
-     /** Locate to a screen column and row
-       * @param column  The horizontal position from the left, indexed from 0
-       * @param row     The vertical position from the top, indexed from 0
-      */
-     void locate(int column, int row);
- 
-     /** Clear the screen and locate to 0,0 */
-     void cls();
-     int rows();
-     int columns();
- 
-protected:
-    // Stream implementation functions
-    virtual int _putc(int value);
-    virtual int _getc();
- 
-    int address(int column, int row);
-    void character(int column, int row, int c);
-    void writeByte(int value);
-    void writeCommand(int command);
-    void writeData(int data);
-
-    DigitalOut _rs, _e;
-    BusOut _d;
-    LCDType _type;
- 
-    int _column;
-    int _row;
-};
-
-#endif
\ No newline at end of file
diff -r 9e13bd7280e1 -r 52fb10c44695 main.cpp
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/main.cpp	Mon Nov 29 22:27:13 2010 +0000
@@ -0,0 +1,76 @@
+/*******************************************************************************************
+* Program to test OptrexLCD library witch is a clone of TextLCD only with a different timing.
+* Normaly it takes a 40us enable puls to execute an instruction, but with the optrex 20x4 LCD
+* it takes 75us. Also the cls command takes 3ms instead of the 1.64ms which is normal.
+* Because the timing is the only difference, all functionality is equal to TextLCD. 
+* Probally the OptrexLCD library works with other LCD as well, if not the origenal TextLCD library
+* can included instead.
+* The program write the text: "Start" and after half a second: "Hello rownr:0" next to it on the first row.
+* After another half a second it writes: "Second row? rownr:1" on the next row, then it
+* will write: "Third row? rownr:2" on the next and: "Fourth row? rownr:3" on the last.
+* After 1 second the screen got cleared and ASCII character nr.65 ("A") is put to the LCD at column "0"
+* and row "0". Then character nr.66 ("B") is written to column "1" and row "1". Next nr67 ("C") is written
+* to column "2", row "2" and nr68 ("D") on "3,3". Row "3" is the last row. When trying to select row "4" the 
+* LCD goes in "Two Rows" mode instead of "Four Rows" mode. The characters "E" to "H" are written 
+* in upwards direction.
+**********************************************************************************************/
+#include "mbed.h"
+#include "OptrexLCD.h"
+
+DigitalOut BlinkLed(LED4);  // when the led is blinking the program runs well
+
+TextLCD lcd(p10, p12, p15, p16, p17, p18, TextLCD::LCD20x4 ); // rs, e, d0-d3
+ 
+int main() 
+{
+    while(1)
+    {        
+        BlinkLed = !BlinkLed;       //indicates the programm is running
+        
+        lcd.printf("Start ");                   // the printf instruction writes a text string to the LCD
+        wait(0.5);
+        lcd.printf("Hello rownr:0\n");          // the "\n" directive tells the program to go to the next row.
+        wait(0.5);
+        lcd.printf("Second row? rownr:1\n");
+        wait(0.5);
+        lcd.printf("Third row?  rownr:2\n");
+        wait(0.5);
+        lcd.printf("Fourth row? rownr:3\n");    
+        wait(0.5);
+        lcd.printf("Fifth row?  rownr:4\n"); // there are only four rows, the fifth wil be at the first row, rownr:0.
+        wait(0.5);
+        lcd.printf("Sixth row?  rownr:5\n"); // this wil be written on the second row
+        wait(2);
+                
+        lcd.cls();          // clear the LCD and go to column "0" and row "0"
+        wait(0.5);
+        
+        lcd.putc(65);       // put character 65 (A) at column "0" and row "0"
+        wait(0.5);
+        lcd.locate(1,1);    // go to column "1" and row "1"
+        lcd.putc(66);       // put a "B" in (1,1)
+        wait(0.5);
+        lcd.locate(2,2);        
+        lcd.putc(67);       // put a "C" in (2,2)
+        wait(0.5);
+        lcd.locate(3,3);
+        lcd.putc(68);
+        wait(0.5);
+        
+        lcd.locate(4,3);
+        lcd.putc(69);
+        wait(0.5);
+        lcd.locate(5,2);
+        lcd.putc(70);
+        wait(0.5);
+        lcd.locate(6,1);
+        lcd.putc(71);
+        wait(0.5);
+        lcd.locate(7,0);
+        lcd.putc(72);
+        wait(0.5);
+        
+        lcd.cls();
+        wait(0.5);                     
+    }
+}
diff -r 9e13bd7280e1 -r 52fb10c44695 mbed.bld
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mbed.bld	Mon Nov 29 22:27:13 2010 +0000
@@ -0,0 +1,1 @@
+http://mbed.org/users/mbed_official/code/mbed/builds/e2ac27c8e93e