first commit

libraries/hd44780/examples/otherLibraries/LiquidCrystalIO/README.md

@@ -0,0 +1,14 @@
+LiquidCrytsalIO hd44780 examples
+=================================
+
+LiquidCrystalIO and IoAbstration libraries must be installed in order to use these sketches.<br>
+The liquidCrystalIO library contains multiple i/o classes.
+
+
+#### The examples are broken up into various sub directories for each i/o class
+
+* `ioUsingArduino`<br>
+Contains example sketches that are for LCDs that are wired up directly to Arduino pins.
+
+* `iofrom8574`<br>
+Contains example sketches that are for LCDs connected to a backpack using the i2c PCF8574 i/o expander chip to control the LCD.

libraries/hd44780/examples/otherLibraries/LiquidCrystalIO/ioFrom8574/hd44780examples/LCDiSpeed/LCDiSpeed.ino

@@ -0,0 +1,61 @@
+// ----------------------------------------------------------------------------
+// LCDiSpeed - LCD Interface Speed test: LiquidCrystalIO with ioFrom8574
+// ----------------------------------------------------------------------------
+// NOTE: this also requires the IoAbstration library
+//
+// This sketch is a wrapper sketch for the hd44780 library example LCDiSpeed.
+// Note:
+// This is not a normal sketch and should not be used as model or example
+// of hd44780 library sketches.
+// This sketch is simple wrapper that declares the needed lcd object for the
+// hd44780 library sketch.
+// It is provided as a convenient way to run a pre-configured sketch for
+// the i/o class.
+// The source code for this sketch lives in hd44780 examples:
+// hd44780/examples/hd44780examples/LCDiSpeed/LCDiSpeed.ino
+// From IDE:
+// [File]->Examples-> hd44780/hd44780examples/LCDiSpeed
+//
+
+#include <Wire.h>		// bundled Wire library
+#include <IoAbstractionWire.h>	// from IoAbstration library
+#include <LiquidCrystalIO.h>	// from LiquidCrystalIO library
+
+// ugliness to allow this sketch to locate the hd44780 example sketch
+// note: hd44780.h is not needed, it is only included to get its directory on the include path
+#include <hd44780.h>
+#undef hd44780_h // undefine this so the example sketch does not think hd44780 is being used.
+
+// cols and rows don't have to be exact to still get accurate transfer numbers
+#define LCD_COLS 16
+#define LCD_ROWS 2
+
+// declare the lcd object
+// Note: The i2c address and pin mappings must match the backpack
+// The pin mapping selected matches the "LiquidCrystal_I2C" library
+// in the IDE library manager.
+const uint8_t i2cAddr = 0x27;
+const int rs=0, rw=1, en=2, db4=4, db5=5, db6=6, db7=7, bl=3;
+LiquidCrystal lcd(rs, rw, en, db4, db5, db6, db7, ioFrom8574(i2cAddr));
+
+// tell the hd44780 sketch the lcd object has been declared
+#define HD44780_LCDOBJECT
+
+// tell lcd hd44780 sketch to call Wire.begin()
+#define LCDISPEED_CALL_WIRE_BEGIN
+
+// tell lcd hd44780 sketch to call custom customLCDinit() for initialization
+#define LCDISPEED_CALL_CUSTOM_LCDINIT
+
+void custom_LCDinit(void);
+// include the hd44780 library LCDiSpeed sketch source code
+#include <examples/hd44780examples/LCDiSpeed/LCDiSpeed.ino>
+
+// have to use custom initialzation for this library
+void custom_LCDinit(void)
+{
+	Wire.begin();
+	lcd.configureBacklightPin(bl); // assumes active HIGH
+	lcd.begin(LCD_COLS, LCD_ROWS);
+	lcd.backlight();
+}

libraries/hd44780/examples/otherLibraries/LiquidCrystalIO/ioFrom8574/hd44780examples/LCDiSpeed400/LCDiSpeed400.ino

@@ -0,0 +1,68 @@
+// ----------------------------------------------------------------------------
+// LCDiSpeed - LCD Interface Speed test: LiquidCrystalIO with ioFrom8574
+// ----------------------------------------------------------------------------
+// NOTE: this also requires the IoAbstration library
+//
+// This sketch is a wrapper sketch for the hd44780 library example LCDiSpeed.
+// Note:
+// This is not a normal sketch and should not be used as model or example
+// of hd44780 library sketches.
+// This sketch is simple wrapper that declares the needed lcd object for the
+// hd44780 library sketch.
+// It is provided as a convenient way to run a pre-configured sketch for
+// the i/o class.
+// The source code for this sketch lives in hd44780 examples:
+// hd44780/examples/hd44780examples/LCDiSpeed/LCDiSpeed.ino
+// From IDE:
+// [File]->Examples-> hd44780/hd44780examples/LCDiSpeed
+//
+
+#include <Wire.h>		// bundled Wire library
+#include <IoAbstractionWire.h>	// from IoAbstration library
+#include <LiquidCrystalIO.h>	// from LiquidCrystalIO library
+
+// ugliness to allow this sketch to locate the hd44780 example sketch
+// note: hd44780.h is not needed, it is only included to get its directory on the include path
+#include <hd44780.h>
+#undef hd44780_h // undefine this so the example sketch does not think hd44780 is being used.
+
+#if ARDUINO < 157
+#error "This sketch Requires Arduino 1.5.7 or higher"
+#endif
+
+// NOTE: uses API that only works on IDE 1.5.7 and up
+#define WIRECLOCK 400000L // tell hd44780 example to use this i2c clock rate
+
+// cols and rows don't have to be exact to still get accurate transfer numbers
+#define LCD_COLS 16
+#define LCD_ROWS 2
+
+// declare the lcd object
+// Note: The i2c address and pin mappings must match the backpack
+// The pin mapping selected matches the "LiquidCrystal_I2C" library
+// in the IDE library manager.
+const uint8_t i2cAddr = 0x27;
+const int rs=0, rw=1, en=2, db4=4, db5=5, db6=6, db7=7, bl=3;
+LiquidCrystal lcd(rs, rw, en, db4, db5, db6, db7, ioFrom8574(i2cAddr));
+
+// tell the hd44780 sketch the lcd object has been declared
+#define HD44780_LCDOBJECT
+
+// tell lcd hd44780 sketch to call Wire.begin()
+#define LCDISPEED_CALL_WIRE_BEGIN
+
+// tell lcd hd44780 sketch to call custom customLCDinit() for initialization
+#define LCDISPEED_CALL_CUSTOM_LCDINIT
+
+void custom_LCDinit(void);
+// include the hd44780 library LCDiSpeed sketch source code
+#include <examples/hd44780examples/LCDiSpeed/LCDiSpeed.ino>
+
+// have to use custom initialzation for this library
+void custom_LCDinit(void)
+{
+	Wire.begin();
+	lcd.configureBacklightPin(bl); // assumes active HIGH
+	lcd.begin(LCD_COLS, LCD_ROWS);
+	lcd.backlight();
+}

libraries/hd44780/examples/otherLibraries/LiquidCrystalIO/ioUsingArduino/hd44780examples/LCDiSpeed/LCDiSpeed.ino

@@ -0,0 +1,43 @@
+// ----------------------------------------------------------------------------
+// LCDiSpeed - LCD Interface Speed test: LiquidCrystalIO with ioUsingArduino
+// ----------------------------------------------------------------------------
+// NOTE: this also requires the IoAbstration library
+//
+// This sketch is a wrapper sketch for the hd44780 library example LCDiSpeed.
+// Note:
+// This is not a normal sketch and should not be used as model or example
+// of hd44780 library sketches.
+// This sketch is simple wrapper that declares the needed lcd object for the
+// hd44780 library sketch.
+// It is provided as a convenient way to run a pre-configured sketch for
+// the i/o class.
+// The source code for this sketch lives in hd44780 examples:
+// hd44780/examples/hd44780examples/LCDiSpeed/LCDiSpeed.ino
+// From IDE:
+// [File]->Examples-> hd44780/hd44780examples/LCDiSpeed
+//
+
+#include <LiquidCrystalIO.h>	// from LiquidCrystalIO library
+
+// ugliness to allow this sketch to locate the hd44780 example sketch
+// note: hd44780.h is not needed, it is only included to get its directory on the include path
+#include <hd44780.h>
+#undef hd44780_h // undefine this so the example sketch does not think hd44780 is being used.
+
+// cols and rows don't have to be exact to still get accurate transfer numbers
+#define LCD_COLS 16
+#define LCD_ROWS 2
+
+// declare Arduino pins used for LCD functions and the lcd object
+// this will use 4 bit mode using Arduino pins
+
+//const int rs=12, en=11, db4=5, db5=4, db6=3, db7=2; // IDE LiquidCrystal example pins
+const int rs=8, en=9, db4=4, db5=5, db6=6, db7=7; // lcd keypad shield pins
+LiquidCrystal lcd(rs, en, db4, db5, db6, db7);
+
+// tell the hd44780 sketch the lcd object has been declared
+#define HD44780_LCDOBJECT
+
+void custom_LCDinit(void);
+// include the hd44780 library LCDiSpeed sketch source code
+#include <examples/hd44780examples/LCDiSpeed/LCDiSpeed.ino>