aboutsummaryrefslogtreecommitdiff
path: root/libraries/LiquidCrystal
diff options
context:
space:
mode:
Diffstat (limited to 'libraries/LiquidCrystal')
-rwxr-xr-xlibraries/LiquidCrystal/LiquidCrystal.cpp128
-rwxr-xr-xlibraries/LiquidCrystal/LiquidCrystal.h31
-rw-r--r--libraries/LiquidCrystal/examples/HelloWorld/HelloWorld.pde18
-rw-r--r--libraries/LiquidCrystal/examples/SerialDisplay/SerialDisplay.pde34
-rwxr-xr-xlibraries/LiquidCrystal/keywords.txt23
5 files changed, 234 insertions, 0 deletions
diff --git a/libraries/LiquidCrystal/LiquidCrystal.cpp b/libraries/LiquidCrystal/LiquidCrystal.cpp
new file mode 100755
index 0000000..b5f2cd4
--- /dev/null
+++ b/libraries/LiquidCrystal/LiquidCrystal.cpp
@@ -0,0 +1,128 @@
+#include "LiquidCrystal.h"
+
+#include <stdio.h>
+#include <string.h>
+#include <inttypes.h>
+#include "WProgram.h"
+
+// When the display powers up, it is configured as follows:
+//
+// 1. Display clear
+// 2. Function set:
+// DL = 1; 8-bit interface data
+// N = 0; 1-line display
+// F = 0; 5x8 dot character font
+// 3. Display on/off control:
+// D = 0; Display off
+// C = 0; Cursor off
+// B = 0; Blinking off
+// 4. Entry mode set:
+// I/D = 1; Increment by 1
+// S = 0; No shift
+//
+// Note, however, that resetting the Arduino doesn't reset the LCD, so we
+// can't assume that its in that state when a sketch starts (and the
+// LiquidCrystal constructor is called).
+
+LiquidCrystal::LiquidCrystal(uint8_t rs, uint8_t rw, uint8_t enable,
+ uint8_t d0, uint8_t d1, uint8_t d2, uint8_t d3,
+ uint8_t d4, uint8_t d5, uint8_t d6, uint8_t d7) :
+ _four_bit_mode(0), _rs_pin(rs), _rw_pin(rw), _enable_pin(enable)
+{
+ _data_pins[0] = d0;
+ _data_pins[1] = d1;
+ _data_pins[2] = d2;
+ _data_pins[3] = d3;
+ _data_pins[4] = d4;
+ _data_pins[5] = d5;
+ _data_pins[6] = d6;
+ _data_pins[7] = d7;
+
+ pinMode(_rs_pin, OUTPUT);
+ pinMode(_rw_pin, OUTPUT);
+ pinMode(_enable_pin, OUTPUT);
+
+ for (int i = 0; i < 8; i++)
+ pinMode(_data_pins[i], OUTPUT);
+
+ command(0x38); // function set: 8 bits, 1 line, 5x8 dots
+ command(0x0C); // display control: turn display on, cursor off, no blinking
+ command(0x06); // entry mode set: increment automatically, display shift, right shift
+ clear();
+}
+
+LiquidCrystal::LiquidCrystal(uint8_t rs, uint8_t rw, uint8_t enable,
+ uint8_t d0, uint8_t d1, uint8_t d2, uint8_t d3) :
+ _four_bit_mode(1), _rs_pin(rs), _rw_pin(rw), _enable_pin(enable)
+{
+ _data_pins[0] = d0;
+ _data_pins[1] = d1;
+ _data_pins[2] = d2;
+ _data_pins[3] = d3;
+
+ pinMode(_rs_pin, OUTPUT);
+ pinMode(_rw_pin, OUTPUT);
+ pinMode(_enable_pin, OUTPUT);
+
+ for (int i = 0; i < 4; i++)
+ pinMode(_data_pins[i], OUTPUT);
+
+ command(0x28); // function set: 4 bits, 1 line, 5x8 dots
+ command(0x0C); // display control: turn display on, cursor off, no blinking
+ command(0x06); // entry mode set: increment automatically, display shift, right shift
+ clear();
+}
+
+void LiquidCrystal::clear()
+{
+ command(0x01); // clear display, set cursor position to zero
+ delayMicroseconds(2000);
+}
+
+void LiquidCrystal::home()
+{
+ command(0x02); // set cursor position to zero
+ delayMicroseconds(2000);
+}
+
+void LiquidCrystal::setCursor(int col, int row)
+{
+ int row_offsets[] = { 0x00, 0x40, 0x14, 0x54 };
+ command(0x80 | (col + row_offsets[row]));
+}
+
+void LiquidCrystal::command(uint8_t value) {
+ send(value, LOW);
+}
+
+void LiquidCrystal::write(uint8_t value) {
+ send(value, HIGH);
+}
+
+void LiquidCrystal::send(uint8_t value, uint8_t mode) {
+ digitalWrite(_rs_pin, mode);
+ digitalWrite(_rw_pin, LOW);
+
+ if (_four_bit_mode) {
+ for (int i = 0; i < 4; i++) {
+ digitalWrite(_data_pins[i], (value >> (i + 4)) & 0x01);
+ }
+
+ digitalWrite(_enable_pin, HIGH);
+ digitalWrite(_enable_pin, LOW);
+
+ for (int i = 0; i < 4; i++) {
+ digitalWrite(_data_pins[i], (value >> i) & 0x01);
+ }
+
+ digitalWrite(_enable_pin, HIGH);
+ digitalWrite(_enable_pin, LOW);
+ } else {
+ for (int i = 0; i < 8; i++) {
+ digitalWrite(_data_pins[i], (value >> i) & 0x01);
+ }
+
+ digitalWrite(_enable_pin, HIGH);
+ digitalWrite(_enable_pin, LOW);
+ }
+}
diff --git a/libraries/LiquidCrystal/LiquidCrystal.h b/libraries/LiquidCrystal/LiquidCrystal.h
new file mode 100755
index 0000000..a5edc5f
--- /dev/null
+++ b/libraries/LiquidCrystal/LiquidCrystal.h
@@ -0,0 +1,31 @@
+#ifndef LiquidCrystal_h
+#define LiquidCrystal_h
+
+#include <inttypes.h>
+#include "Print.h"
+
+class LiquidCrystal : public Print {
+public:
+ LiquidCrystal(uint8_t, uint8_t, uint8_t, uint8_t, uint8_t, uint8_t, uint8_t);
+ LiquidCrystal(uint8_t, uint8_t, uint8_t, uint8_t, uint8_t, uint8_t, uint8_t,
+ uint8_t, uint8_t, uint8_t, uint8_t);
+ void clear();
+ void home();
+ void setCursor(int, int);
+ /*
+ void shiftDisplayLeft();
+ void shiftDisplayRight();
+ */
+ virtual void write(uint8_t);
+ void command(uint8_t);
+private:
+ void send(uint8_t, uint8_t);
+
+ uint8_t _four_bit_mode;
+ uint8_t _rs_pin; // LOW: command. HIGH: character.
+ uint8_t _rw_pin; // LOW: write to LCD. HIGH: read from LCD.
+ uint8_t _enable_pin; // activated by a HIGH pulse.
+ uint8_t _data_pins[8];
+};
+
+#endif
diff --git a/libraries/LiquidCrystal/examples/HelloWorld/HelloWorld.pde b/libraries/LiquidCrystal/examples/HelloWorld/HelloWorld.pde
new file mode 100644
index 0000000..2f244d0
--- /dev/null
+++ b/libraries/LiquidCrystal/examples/HelloWorld/HelloWorld.pde
@@ -0,0 +1,18 @@
+#include <LiquidCrystal.h>
+
+// LiquidCrystal display with:
+// rs on pin 12
+// rw on pin 11
+// enable on pin 10
+// d4, d5, d6, d7 on pins 5, 4, 3, 2
+LiquidCrystal lcd(12, 11, 10, 5, 4, 3, 2);
+
+void setup()
+{
+ // Print a message to the LCD.
+ lcd.print("hello, world!");
+}
+
+void loop()
+{
+}
diff --git a/libraries/LiquidCrystal/examples/SerialDisplay/SerialDisplay.pde b/libraries/LiquidCrystal/examples/SerialDisplay/SerialDisplay.pde
new file mode 100644
index 0000000..0c4ce35
--- /dev/null
+++ b/libraries/LiquidCrystal/examples/SerialDisplay/SerialDisplay.pde
@@ -0,0 +1,34 @@
+/*
+ * Displays text sent over the serial port (e.g. from the Serial Monitor) on
+ * an attached LCD.
+ */
+
+#include <LiquidCrystal.h>
+
+// LiquidCrystal display with:
+// rs on pin 12
+// rw on pin 11
+// enable on pin 10
+// d4, d5, d6, d7 on pins 5, 4, 3, 2
+LiquidCrystal lcd(12, 11, 10, 5, 4, 3, 2);
+
+void setup()
+{
+ Serial.begin(9600);
+}
+
+void loop()
+{
+ // when characters arrive over the serial port...
+ if (Serial.available()) {
+ // wait a bit for the entire message to arrive
+ delay(100);
+ // clear the screen
+ lcd.clear();
+ // read all the available characters
+ while (Serial.available() > 0) {
+ // display each character to the LCD
+ lcd.write(Serial.read());
+ }
+ }
+}
diff --git a/libraries/LiquidCrystal/keywords.txt b/libraries/LiquidCrystal/keywords.txt
new file mode 100755
index 0000000..367ab1f
--- /dev/null
+++ b/libraries/LiquidCrystal/keywords.txt
@@ -0,0 +1,23 @@
+#######################################
+# Syntax Coloring Map For LiquidCrystal
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+LiquidCrystal KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+
+clear KEYWORD2
+home KEYWORD2
+print KEYWORD2
+setCursor KEYWORD2
+
+#######################################
+# Constants (LITERAL1)
+#######################################
+