// ----------------------------------------------------------------------------
// 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();
}