From e1d40982d34716e592ba9f6977d2c84fbb4e9abb Mon Sep 17 00:00:00 2001
From: marcoschwartz <marcolivier.schwartz@gmail.com>
Date: Thu, 20 Aug 2015 07:52:58 +0200
Subject: [PATCH] initial commit

---
 LiquidCrystal_I2C.cpp                    | 322 +++++++++++++++++++++++
 LiquidCrystal_I2C.h                      | 126 +++++++++
 LiquidCrystal_I2C.o                      | Bin 0 -> 41564 bytes
 examples/CustomChars/CustomChars.pde     |  70 +++++
 examples/HelloWorld/HelloWorld.pde       |  28 ++
 examples/SerialDisplay/SerialDisplay.pde |  34 +++
 keywords.txt                             |  46 ++++
 7 files changed, 626 insertions(+)
 create mode 100644 LiquidCrystal_I2C.cpp
 create mode 100644 LiquidCrystal_I2C.h
 create mode 100644 LiquidCrystal_I2C.o
 create mode 100644 examples/CustomChars/CustomChars.pde
 create mode 100644 examples/HelloWorld/HelloWorld.pde
 create mode 100644 examples/SerialDisplay/SerialDisplay.pde
 create mode 100644 keywords.txt

diff --git a/LiquidCrystal_I2C.cpp b/LiquidCrystal_I2C.cpp
new file mode 100644
index 0000000..4f1b787
--- /dev/null
+++ b/LiquidCrystal_I2C.cpp
@@ -0,0 +1,322 @@
+//YWROBOT
+//last updated on 21/12/2011
+//Tim Starling Fix the reset bug (Thanks Tim)
+//wiki doc http://www.dfrobot.com/wiki/index.php?title=I2C/TWI_LCD1602_Module_(SKU:_DFR0063)
+//Support Forum: http://www.dfrobot.com/forum/
+//Compatible with the Arduino IDE 1.0
+//Library version:1.1
+
+
+#include "LiquidCrystal_I2C.h"
+#include <inttypes.h>
+#if defined(ARDUINO) && ARDUINO >= 100
+
+#include "Arduino.h"
+
+#define printIIC(args)	Wire.write(args)
+inline size_t LiquidCrystal_I2C::write(uint8_t value) {
+	send(value, Rs);
+	return 0;
+}
+
+#else
+#include "WProgram.h"
+
+#define printIIC(args)	Wire.send(args)
+inline void LiquidCrystal_I2C::write(uint8_t value) {
+	send(value, Rs);
+}
+
+#endif
+#include "Wire.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_I2C::LiquidCrystal_I2C(uint8_t lcd_Addr,uint8_t lcd_cols,uint8_t lcd_rows)
+{
+  _Addr = lcd_Addr;
+  _cols = lcd_cols;
+  _rows = lcd_rows;
+  _backlightval = LCD_NOBACKLIGHT;
+}
+
+void LiquidCrystal_I2C::init(){
+	init_priv();
+}
+
+void LiquidCrystal_I2C::init_priv()
+{
+	Wire.begin();
+	_displayfunction = LCD_4BITMODE | LCD_1LINE | LCD_5x8DOTS;
+	begin(_cols, _rows);  
+}
+
+void LiquidCrystal_I2C::begin(uint8_t cols, uint8_t lines, uint8_t dotsize) {
+	if (lines > 1) {
+		_displayfunction |= LCD_2LINE;
+	}
+	_numlines = lines;
+
+	// for some 1 line displays you can select a 10 pixel high font
+	if ((dotsize != 0) && (lines == 1)) {
+		_displayfunction |= LCD_5x10DOTS;
+	}
+
+	// SEE PAGE 45/46 FOR INITIALIZATION SPECIFICATION!
+	// according to datasheet, we need at least 40ms after power rises above 2.7V
+	// before sending commands. Arduino can turn on way befer 4.5V so we'll wait 50
+	delay(50); 
+  
+	// Now we pull both RS and R/W low to begin commands
+	expanderWrite(_backlightval);	// reset expanderand turn backlight off (Bit 8 =1)
+	delay(1000);
+
+  	//put the LCD into 4 bit mode
+	// this is according to the hitachi HD44780 datasheet
+	// figure 24, pg 46
+	
+	  // we start in 8bit mode, try to set 4 bit mode
+   write4bits(0x03 << 4);
+   delayMicroseconds(4500); // wait min 4.1ms
+   
+   // second try
+   write4bits(0x03 << 4);
+   delayMicroseconds(4500); // wait min 4.1ms
+   
+   // third go!
+   write4bits(0x03 << 4); 
+   delayMicroseconds(150);
+   
+   // finally, set to 4-bit interface
+   write4bits(0x02 << 4); 
+
+
+	// set # lines, font size, etc.
+	command(LCD_FUNCTIONSET | _displayfunction);  
+	
+	// turn the display on with no cursor or blinking default
+	_displaycontrol = LCD_DISPLAYON | LCD_CURSOROFF | LCD_BLINKOFF;
+	display();
+	
+	// clear it off
+	clear();
+	
+	// Initialize to default text direction (for roman languages)
+	_displaymode = LCD_ENTRYLEFT | LCD_ENTRYSHIFTDECREMENT;
+	
+	// set the entry mode
+	command(LCD_ENTRYMODESET | _displaymode);
+	
+	home();
+  
+}
+
+/********** high level commands, for the user! */
+void LiquidCrystal_I2C::clear(){
+	command(LCD_CLEARDISPLAY);// clear display, set cursor position to zero
+	delayMicroseconds(2000);  // this command takes a long time!
+}
+
+void LiquidCrystal_I2C::home(){
+	command(LCD_RETURNHOME);  // set cursor position to zero
+	delayMicroseconds(2000);  // this command takes a long time!
+}
+
+void LiquidCrystal_I2C::setCursor(uint8_t col, uint8_t row){
+	int row_offsets[] = { 0x00, 0x40, 0x14, 0x54 };
+	if ( row > _numlines ) {
+		row = _numlines-1;    // we count rows starting w/0
+	}
+	command(LCD_SETDDRAMADDR | (col + row_offsets[row]));
+}
+
+// Turn the display on/off (quickly)
+void LiquidCrystal_I2C::noDisplay() {
+	_displaycontrol &= ~LCD_DISPLAYON;
+	command(LCD_DISPLAYCONTROL | _displaycontrol);
+}
+void LiquidCrystal_I2C::display() {
+	_displaycontrol |= LCD_DISPLAYON;
+	command(LCD_DISPLAYCONTROL | _displaycontrol);
+}
+
+// Turns the underline cursor on/off
+void LiquidCrystal_I2C::noCursor() {
+	_displaycontrol &= ~LCD_CURSORON;
+	command(LCD_DISPLAYCONTROL | _displaycontrol);
+}
+void LiquidCrystal_I2C::cursor() {
+	_displaycontrol |= LCD_CURSORON;
+	command(LCD_DISPLAYCONTROL | _displaycontrol);
+}
+
+// Turn on and off the blinking cursor
+void LiquidCrystal_I2C::noBlink() {
+	_displaycontrol &= ~LCD_BLINKON;
+	command(LCD_DISPLAYCONTROL | _displaycontrol);
+}
+void LiquidCrystal_I2C::blink() {
+	_displaycontrol |= LCD_BLINKON;
+	command(LCD_DISPLAYCONTROL | _displaycontrol);
+}
+
+// These commands scroll the display without changing the RAM
+void LiquidCrystal_I2C::scrollDisplayLeft(void) {
+	command(LCD_CURSORSHIFT | LCD_DISPLAYMOVE | LCD_MOVELEFT);
+}
+void LiquidCrystal_I2C::scrollDisplayRight(void) {
+	command(LCD_CURSORSHIFT | LCD_DISPLAYMOVE | LCD_MOVERIGHT);
+}
+
+// This is for text that flows Left to Right
+void LiquidCrystal_I2C::leftToRight(void) {
+	_displaymode |= LCD_ENTRYLEFT;
+	command(LCD_ENTRYMODESET | _displaymode);
+}
+
+// This is for text that flows Right to Left
+void LiquidCrystal_I2C::rightToLeft(void) {
+	_displaymode &= ~LCD_ENTRYLEFT;
+	command(LCD_ENTRYMODESET | _displaymode);
+}
+
+// This will 'right justify' text from the cursor
+void LiquidCrystal_I2C::autoscroll(void) {
+	_displaymode |= LCD_ENTRYSHIFTINCREMENT;
+	command(LCD_ENTRYMODESET | _displaymode);
+}
+
+// This will 'left justify' text from the cursor
+void LiquidCrystal_I2C::noAutoscroll(void) {
+	_displaymode &= ~LCD_ENTRYSHIFTINCREMENT;
+	command(LCD_ENTRYMODESET | _displaymode);
+}
+
+// Allows us to fill the first 8 CGRAM locations
+// with custom characters
+void LiquidCrystal_I2C::createChar(uint8_t location, uint8_t charmap[]) {
+	location &= 0x7; // we only have 8 locations 0-7
+	command(LCD_SETCGRAMADDR | (location << 3));
+	for (int i=0; i<8; i++) {
+		write(charmap[i]);
+	}
+}
+
+// Turn the (optional) backlight off/on
+void LiquidCrystal_I2C::noBacklight(void) {
+	_backlightval=LCD_NOBACKLIGHT;
+	expanderWrite(0);
+}
+
+void LiquidCrystal_I2C::backlight(void) {
+	_backlightval=LCD_BACKLIGHT;
+	expanderWrite(0);
+}
+
+
+
+/*********** mid level commands, for sending data/cmds */
+
+inline void LiquidCrystal_I2C::command(uint8_t value) {
+	send(value, 0);
+}
+
+
+/************ low level data pushing commands **********/
+
+// write either command or data
+void LiquidCrystal_I2C::send(uint8_t value, uint8_t mode) {
+	uint8_t highnib=value&0xf0;
+	uint8_t lownib=(value<<4)&0xf0;
+       write4bits((highnib)|mode);
+	write4bits((lownib)|mode); 
+}
+
+void LiquidCrystal_I2C::write4bits(uint8_t value) {
+	expanderWrite(value);
+	pulseEnable(value);
+}
+
+void LiquidCrystal_I2C::expanderWrite(uint8_t _data){                                        
+	Wire.beginTransmission(_Addr);
+	printIIC((int)(_data) | _backlightval);
+	Wire.endTransmission();   
+}
+
+void LiquidCrystal_I2C::pulseEnable(uint8_t _data){
+	expanderWrite(_data | En);	// En high
+	delayMicroseconds(1);		// enable pulse must be >450ns
+	
+	expanderWrite(_data & ~En);	// En low
+	delayMicroseconds(50);		// commands need > 37us to settle
+} 
+
+
+// Alias functions
+
+void LiquidCrystal_I2C::cursor_on(){
+	cursor();
+}
+
+void LiquidCrystal_I2C::cursor_off(){
+	noCursor();
+}
+
+void LiquidCrystal_I2C::blink_on(){
+	blink();
+}
+
+void LiquidCrystal_I2C::blink_off(){
+	noBlink();
+}
+
+void LiquidCrystal_I2C::load_custom_character(uint8_t char_num, uint8_t *rows){
+		createChar(char_num, rows);
+}
+
+void LiquidCrystal_I2C::setBacklight(uint8_t new_val){
+	if(new_val){
+		backlight();		// turn backlight on
+	}else{
+		noBacklight();		// turn backlight off
+	}
+}
+
+void LiquidCrystal_I2C::printstr(const char c[]){
+	//This function is not identical to the function used for "real" I2C displays
+	//it's here so the user sketch doesn't have to be changed 
+	print(c);
+}
+
+
+// unsupported API functions
+void LiquidCrystal_I2C::off(){}
+void LiquidCrystal_I2C::on(){}
+void LiquidCrystal_I2C::setDelay (int cmdDelay,int charDelay) {}
+uint8_t LiquidCrystal_I2C::status(){return 0;}
+uint8_t LiquidCrystal_I2C::keypad (){return 0;}
+uint8_t LiquidCrystal_I2C::init_bargraph(uint8_t graphtype){return 0;}
+void LiquidCrystal_I2C::draw_horizontal_graph(uint8_t row, uint8_t column, uint8_t len,  uint8_t pixel_col_end){}
+void LiquidCrystal_I2C::draw_vertical_graph(uint8_t row, uint8_t column, uint8_t len,  uint8_t pixel_row_end){}
+void LiquidCrystal_I2C::setContrast(uint8_t new_val){}
+
+	
\ No newline at end of file
diff --git a/LiquidCrystal_I2C.h b/LiquidCrystal_I2C.h
new file mode 100644
index 0000000..201be33
--- /dev/null
+++ b/LiquidCrystal_I2C.h
@@ -0,0 +1,126 @@
+//YWROBOT
+#ifndef LiquidCrystal_I2C_h
+#define LiquidCrystal_I2C_h
+
+#include <inttypes.h>
+#include "Print.h" 
+#include <Wire.h>
+
+// commands
+#define LCD_CLEARDISPLAY 0x01
+#define LCD_RETURNHOME 0x02
+#define LCD_ENTRYMODESET 0x04
+#define LCD_DISPLAYCONTROL 0x08
+#define LCD_CURSORSHIFT 0x10
+#define LCD_FUNCTIONSET 0x20
+#define LCD_SETCGRAMADDR 0x40
+#define LCD_SETDDRAMADDR 0x80
+
+// flags for display entry mode
+#define LCD_ENTRYRIGHT 0x00
+#define LCD_ENTRYLEFT 0x02
+#define LCD_ENTRYSHIFTINCREMENT 0x01
+#define LCD_ENTRYSHIFTDECREMENT 0x00
+
+// flags for display on/off control
+#define LCD_DISPLAYON 0x04
+#define LCD_DISPLAYOFF 0x00
+#define LCD_CURSORON 0x02
+#define LCD_CURSOROFF 0x00
+#define LCD_BLINKON 0x01
+#define LCD_BLINKOFF 0x00
+
+// flags for display/cursor shift
+#define LCD_DISPLAYMOVE 0x08
+#define LCD_CURSORMOVE 0x00
+#define LCD_MOVERIGHT 0x04
+#define LCD_MOVELEFT 0x00
+
+// flags for function set
+#define LCD_8BITMODE 0x10
+#define LCD_4BITMODE 0x00
+#define LCD_2LINE 0x08
+#define LCD_1LINE 0x00
+#define LCD_5x10DOTS 0x04
+#define LCD_5x8DOTS 0x00
+
+// flags for backlight control
+#define LCD_BACKLIGHT 0x08
+#define LCD_NOBACKLIGHT 0x00
+
+#define En B00000100  // Enable bit
+#define Rw B00000010  // Read/Write bit
+#define Rs B00000001  // Register select bit
+
+class LiquidCrystal_I2C : public Print {
+public:
+  LiquidCrystal_I2C(uint8_t lcd_Addr,uint8_t lcd_cols,uint8_t lcd_rows);
+  void begin(uint8_t cols, uint8_t rows, uint8_t charsize = LCD_5x8DOTS );
+  void clear();
+  void home();
+  void noDisplay();
+  void display();
+  void noBlink();
+  void blink();
+  void noCursor();
+  void cursor();
+  void scrollDisplayLeft();
+  void scrollDisplayRight();
+  void printLeft();
+  void printRight();
+  void leftToRight();
+  void rightToLeft();
+  void shiftIncrement();
+  void shiftDecrement();
+  void noBacklight();
+  void backlight();
+  void autoscroll();
+  void noAutoscroll(); 
+  void createChar(uint8_t, uint8_t[]);
+  void setCursor(uint8_t, uint8_t); 
+#if defined(ARDUINO) && ARDUINO >= 100
+  virtual size_t write(uint8_t);
+#else
+  virtual void write(uint8_t);
+#endif
+  void command(uint8_t);
+  void init();
+
+////compatibility API function aliases
+void blink_on();						// alias for blink()
+void blink_off();       					// alias for noBlink()
+void cursor_on();      	 					// alias for cursor()
+void cursor_off();      					// alias for noCursor()
+void setBacklight(uint8_t new_val);				// alias for backlight() and nobacklight()
+void load_custom_character(uint8_t char_num, uint8_t *rows);	// alias for createChar()
+void printstr(const char[]);
+
+////Unsupported API functions (not implemented in this library)
+uint8_t status();
+void setContrast(uint8_t new_val);
+uint8_t keypad();
+void setDelay(int,int);
+void on();
+void off();
+uint8_t init_bargraph(uint8_t graphtype);
+void draw_horizontal_graph(uint8_t row, uint8_t column, uint8_t len,  uint8_t pixel_col_end);
+void draw_vertical_graph(uint8_t row, uint8_t column, uint8_t len,  uint8_t pixel_col_end);
+	 
+
+private:
+  void init_priv();
+  void send(uint8_t, uint8_t);
+  void write4bits(uint8_t);
+  void expanderWrite(uint8_t);
+  void pulseEnable(uint8_t);
+  uint8_t _Addr;
+  uint8_t _displayfunction;
+  uint8_t _displaycontrol;
+  uint8_t _displaymode;
+  uint8_t _numlines;
+  uint8_t _cols;
+  uint8_t _rows;
+  uint8_t _backlightval;
+};
+
+#endif
diff --git a/LiquidCrystal_I2C.o b/LiquidCrystal_I2C.o
new file mode 100644
index 0000000000000000000000000000000000000000..bca78e0d24dfc30341ef0d5e91cf127ee829e126
GIT binary patch
literal 41564
zcmeHw37AyHxptjtW*in-22end0S1P3HU=0FBikSt^iCAx5_FiQhiRS7o@VoEWL4t|
zB1+t1T#&frsxe9yw`i{9CI(~Nq9%+{Z;aOk<Az)K-?!?kKGmmB&&<8a|NqbPKYzjL
z^VU~yef8B|=TuGi1(iz{dY-4O^VCVo_bIjKc%?QYuv`<ytFu+3@&<Tg`wr|K>3c-q
z0p5w;$vORVl*%ely?cKRLZu>ysYu^hy^rd>c%V`}M4qcuc0W)k%gOR0eS7yN#e?^d
za^YVzr|;r{$Mh-dJ-d%mxkc)jK1L7ZM%J^)3&<G1SGJ<o-hSZhK9u*Nyd0_y^+TY_
z1olmlEgop3{ZgbfqyJ#!e86Cj3iD{UAr4F-F6n)IuMwhRP_AOehJZiVkjnc|(P87X
zm52LzA2E<hhYW|jqE}gOrG_4wEI1<=<|`oeh-9MK$$Sh?k=cBV(9&EO;xms-GJ7Wr
zbYy?2lKdj?*nzY=UsuVfY*=CnZ!|-UbPS~=vA7G0ywZUKygYACFWNRXTa^yXLPHp*
zK`*5W8PO+<w<@y`HbFFHFCIwm#AFy0OoB&SZo(!zUW87On6QDV71_2!lZtzzY38B%
zmOx4sLMoLwObv0$M5BaG^;OW8a?e|=D`wg#R7^3dWx8p?O3m<@$LKm$59Fcc>#os5
z_nICWhkRstNEls%A6e%f#ZM1i0{tT^JJym=Sy_kBm(?TN+>9^R_;R&R$Bn$O7=-Ms
z^GP;3wPLTw@M;h=vB#0rL9Z9_jASGwCAgB3{4~kvG|3oBQuGw0amJ=e3ezOxDQR%+
znLx>EBgr)-H<6-<*VFhW8DA@Wy=XzNc@*?Efm6JV0DaD9e08Xi6*1hqK22V%<-3#e
zUMvM0Nn`JMKTxM48cTJ|zxjb~%rYI=4|Q+MF!uEY8C5!!pSrXsB?(Hx^gyb^zL5;m
zHW|Z&H7%)Owa=Odp-D$9oKBW^wa;)ZoS_3B^aFJ<x{M0V_`T0y0=8&o>cIVe;A#rQ
zyjjFL6MawzQV|lywr#@3`(a}6Y=(K2NqH|e0oBix+R-{tij%E{?VO49&(4a%JAh=9
z|Lm+L;OwkT2t^Ns&fmg6Q0vLjt<B5opS2M(?;(8jVW`*ZIehkNB7M*yM_vxkU>(8p
zOgI%XN_N)E_&kg$A5L<w?CBK$wkO7Ff~+yh8_Iy}R&uh&WJQd(&3Gf?J;!)^h&OJ$
z+2U<C-W>5JjQ0@nt~B0U@vbu7o{?c<@x>Tu`p_ce3ZK$3yd%83`~b#rT9&B-&-9aL
zyP`ECvhv<e(xh2<aV^inxMY&I@^xB1EKR;i%Q4~x_*ZNBacS}$T3(wbzeLN=O_N`t
z<yWQ2Z_@HR)8yaR@?Qky*$cG%<urMvmj5j%_jYP|FO0pZ<#4x_j}FSS7isydH2GpJ
zKQSox_GtN8Y4WGFd_$W2el5Q)O}<;p?@yCIs^!lm<))!<h_E%P`@8o^fWby39nE`L
z>&WV__92>g1ZEm(lA0v#?FCJ$2oD^i1FMpO>Il=m&6ME9(gOOJ@C|7JX3^?hpB7-|
zW$%HsfI&vpv&jH60E-3vP3Xs|p?WH^Mh-WWfw{?i?_*aKaiI=nNq8kmhK)MeL_HxH
zVA7VT<Nc^-CmA;CI1}}XWPlzK&9FGaYi&{9Si{(vWGKiR8kARH0v`1PB*6)Og0Ce5
zQ;K7viP{$#bn4hNn&dcRO`K%NM|Dm%6TMf+CJ^zKCdo<yUN-@&lL3Bemh!ftY)_@w
z(DzN~j{>1b8tXnbp-yf%^0Ot6%z7D74kOIYdXtcgt^7ye&lwf*utXfixCEX$j8n^K
z4##S?4I%KxXwDHVoN$P!&|Q!NvUOQo@)Pim?Ju%%!>FlY+*sb~$CdC_n-=8`h`WeV
z$i`qDQh6Ft#?!A&&1u}`#kP5>kd4YZus#fDu}xYB)-hNir|FtNf;Z0NiXx|Bo3~<{
zmm;d)=0%wzJCAkHRSR7c>DPAYfI@Z>>p<BYLSc)x4wMJeC?@R*p6-qfs*tVRIz$+R
z$FuSDyTvgn-nv?O6D5w(AinxZO;L0-@zth;Emwu?CDuWEJhS#mDcZ#++Qlc@#Ru&i
zO{|0VonhLIMU#{H<uGO);=G7Bsl`0GPI<#UJ${i_$S!3aBJ?~o7-0%Sz4uw5+7+^!
zS%(-$Wr*>yAA>#HI>czs5aVq>1_uf25aY=VF<!SZjFCyNS^B)ePy^r8#6r$-)<Nwj
z8PvXP)v7|yb=D!q_`c!A^MW6PGq81tu`WZ5M{Nva`lEV6Mm+r#!}ujJ<^4jh)3vrj
zPG8nR?-OZy%~MQ&-4sZ)eydp(a?xNNRQzX}3RTGUhIOFy>=(?hD&$hgI#4EuP`HY+
z4wQchp>V-w9Vqb-3fFqpfwDb>!eym(pzIEzaLr*ID6fQ2%2KubJ%qvqignO3s(*U9
zaLH;NC<{U;T+LVq%8C#Q7sS?qa!Ck<OCRe%xhI6e<+*jBJQG6U%HBFqJ`AC7(P$kg
z^9BSnT~^oHq`cK7LMqb(Y0|47j=eREmUWq@%GsDtgl8H*B5HcpA%%SGunsA#NlQT$
z@&U#=P_7T5aPe#%D363txbC(Nl-EKiTsT?>${;*$rVgE@4D|*jJD4iuGnjRVQlA#Z
zbnYTsK%IM4As15CLElAb`cxs;*Vch@XF5f{4(Ksw6IgiNyA~?5)O}bAdEO@<_rj-s
z2kh0&DsGFnu87w(=QqTfqV2^s@%ojqme%Uh>BWt}t83!X;zVm}6GB$Si<@G##VhLS
zii?W)pORQhUDL|?sG2`(S(PYSNJY!$CKWBSik8*2#t|Y(sJdCpQqr~oNZXI1(_V&@
zmes~umLXAV0uwJUnp#wrG$EM`DDj$j3`s4CowG7lKR>><JyFwCy|`??>JDjH80(Z+
zJgQWh!lJsiHii0cPt@bJUJ+iFYg`{~0LD_0(SXqIiqqpZGG<lWM8unyMN;A?MdPuW
zCPagbi&9<Fs4#<y<Zk_kiGOexceaCnmWIf!Syq|7`|2aNbryJgXMsCA3%sMVz+IgM
z{-CqKJ39-!tFyrClYxf^%HAoA_mail{R)bFlrd7K+V)fYDqu@6S)cidFoV|H7(Vme
z3_5+rU%O;HD-4?hdmk9E!q*wOGFiaZBzyNszs`_wI`fy^W<J_&=1;oKd>{kU&&hpV
zGVaR2NY88JqHYx39o<)VX*bk;zx(PAW^CVnaopH_bsM{3-L>6Tx2@aEOS)j%CZ1kD
zo4bhV7sI-4GdsG?e5KpW$hM3{YcuDYIyZw_%M6Y)!-OA{9}&<K4A0~rl0l#42k+J{
zd-roPOElRKTY<s5A7gsJX3GSFy9HSa`<1|7^gR@xX#Mc$|6h9RI<|Cd-MDUJ?Z#s_
z=3lh#t@Rh>ZV#8{Zs)&s9sXq`eerfZcl+L}_FeV<RR^!?w{7IMCNHOWUB_ER>pBh;
zJ>`Ak)vhO}f5#`@`psK9awiR)^pv;TqwFdDIdW^itp~Tfzh&Q+y<2j(8y%N<pA;>x
zA!j`-<o(L`4vgO8wN4@4@Vb$im~I?~T9ys9cAe)PR@|ewc6)1E{Uq{6wt28*d9lV~
zL+<uDZ_tmsPBnMCjlFl<zHOIz=XxvJ8v60y@_O<f>v*Q)CGXv>Uv7QTySv}RBfTyA
z*LO_W<27yVxqZ|%drE$n?R~Uw>)x$4kGb28_AkBY`j!i#8|#<*{tJuOFW<Z|x_qxL
z71l#^eRCRT12_#yPSa~9exuyK^y=4B&!&yBB*&&uj}+@SHcE=V^upo|;GY%3Z_dEq
z1b$PJ&os|=nESTv-S+fDe|l*Awf!DEaP^-a?f1yjkKW+@-7CH3=8k(iF77yVi+9!f
zD(|DuybITFI$V9UsCaJG8^!xO-s^X8<U9So8o7RbW54B%ztW{J{u*D$-mUw#=5DXm
z^|J2WYo&f_0{$<(0T(WpFtlW}=)IoxH;nQ2n|zy3*6BOmyb`tl()AZFzjWgX8%KjN
zx5WGC()F9*U-#y=cgXy$7u(Ex<9qEL>@h}Gr|+Box>c9`Z@qB;g@3htWBJ+Zm)HJQ
z=WSERWg87LpBp+ZhrdCzGYz(!-0kdBm+78L*#U3hhCSYj^>a4oYbINkZB=@$E+2E$
zAhi^4(BVA@=PB=kf<F1$Z)t}CFx<MJpKE_NyemH+MO}VZ{;u=|!}$R1>OU^vFAw;6
zG{NN;1^j%u>4pdWRe|te`gmWF5`R#@-&J@py`Vp+udDQf;s5OT!Tg-rMSg>PmbF{n
z!SJAeXMkT2@H4;G<tW)$5J8S=+2*z4wSU0<PkB~NF#i8sZgwhce0vY-&r!>^d1s{O
z!&415il>%an4^|&^J;vy6Xa8Z1(h1b@=_A0wo-dfH}jvP<;-nfwQs&nEyb1^E46n|
z)%$R{h4vn_)XE*5R`d^0g9UF@hNdDLQo_km;hD}+P20TY^uqXWS(%!YwJMW}puD@C
zD3jiQH2(i-z5lPIm!oR8d3EVcC!{qxo#%g7ZT+LA8f=wTpOYI0+R$LEOx-CYs#7Lb
zo2P0mwD<G`!iT^h?+fgDaAl*^ZoE04+biV7?yOm9?`st|>(iuRL~hZC5P2$tTk&B*
zEsERkAtCM2#DZv3&058c_ptCpO=4xc;#PV{=-JV=Z8i0ZyXYaIv6fh(y0#{c4S=>r
z#eMV;QhmH;b#-HFJa%qt3tyufGWXCkkyl0IiCA5d$_?=lDl#@78sjzX3B_IQ5K0^0
zjkhP_iaXdL;n6j1H7)hg_$l#NBC5D+9YShb+0-7bY^kYjiYjhXhfr2CetB&y(XO~H
z9l~gjw$v+bK!=3s*oxc8A%S(R&CRe;anCp`I3BG@MCW5$LUE5cgwfPmQ(s-TvOUq-
zTwMoVO<f`ySKRmwA-A;7U72WYuZy=fH7V}whHz?p1~+y?81dMO#>CRrCDDe2;>K<W
zr3qn6TTdiWabq`xVysvYYi~pAHB9dBcE!}Ga+f!RSlbk9Ia_gmH&b9WPDF8YHzd5J
zb)JsSjopx7t-G3Cl-s%?gu0dS_SU%Kj&8<KCeQuc5JF4qe4~Jyxgp_3y*7Y*xgm^t
zQ<RGPxFNwUty0#CySO0)b~t0g$=LV|AvCr&M-_KpL&EBsqG+SscMS=wt*JY^Nw)>=
zx`q%?_DKqNT|+3a&gXF3HH1?eT@h<h++Ym})PosDj8%#|rWpu&&_554Bxd;M<FRpk
z@TRkO6K;9_-Np#sGx6;M(s4$;{9%n!`piCLMIz^eC!M`l883GZwL_I^#|KKfpx?%`
zcgqXLxBl*i+jRJ#NoW1`j)7S_>$mrvA}^4;O;^1C|Mq{O1e|HE`t%cKEM48o?dgid
znt3Z58lv$^mAW1Pr*uYIKPu-aQMpRBwwxF}XJxcKf!*p=vAU>oRF-qPtgNb2?Xh#C
z)d|%SU0uDZriqkkdcS*`Hl?!a>y2kAcYY2}vb4mvys}ZPY>&n<(4H8ri^f*zbVJOX
znH-Z~Yju51qQ<va=Tjxt%&o7-frNIN6{2A(<^sfZhpup9X{nP1*w@tBvLau9tZZqI
zt!RnX=krf~!XulaYHU<`tz)K1ebykHURvJX7;8u@ZmEk$o1-lW7#Nr8TM}(qk!V!M
zo^W#h{7IAY_2CHQ+)Nq`D_iOkG0aX-Yb(CAJT+>iV>t~L+qvk-VEi;aAXhfRe5=Y$
zU}nv#nphJTUNBP^h?Il1U}mxwE2|c+idCkM+MOLNQO-(6X73i|t}5NUPPGOu#)5H8
zrAjo$+7+`_-LkUTHF`$ev@4h_i|6o~n3<eTk$>f{9;(@@l%1>5>Q_cpU30xz!>2Te
zrq<Ohv07y&HP_bCxanC7<E_n99&SKs3EF@x9xEHGGSW<oSrGMGOn2L6X{porQ65;U
zx3o9M5{X#Lii}42?HDoqHA#3LDo}{JWGZ7Zw-QQc=u%l~5^Qfr%SFd>%P52pQ>lGJ
zVYwI0)VoW|+yw`e+fh)r4;B8<6P}5gI?G(QBFEJ@{gx@s8PY09bGxBU+VtQ`B`q*R
z5zkB(D)c1BLOm2KB+eBivevFb*57WbDUB>p`qPvBQU>?RszzNuA;V;a?Rv1rJPA3e
z=nk$;V+UVVnITIvWNmH=CM1#487aAuvexU>40V$1kkDz?u1$6Irf;S-EtQ-r&|qbW
z>@3Iiv!B1Z43>?uRIE(-s2q6u4Y#ih4O+K?kjzdu;|>is%k^*-(@khbHKkKirgPJO
zLXw-NiwbIz&Dd?7Gn3O~rSiuc4zvDhJ>0(1Qs*Htvy~;b`1EWGRd#YH)veH7Vq{cO
zp-sn&0<0+NRC3l))i{~ju2}K5S6byV?YcQNqL@mK(R$*OmZ|hxkHp%xOzRC<(O@EE
z|4+6N7L*zK?Mz(9cOEz}+ZJ0BZK7S(e6<i>gk`0n;}9p@jKh6JN>9-X3Y4238IyB>
zo9zlaF;=4SJ8uudEt-y#lz80)jm{jU>RS_B>1D`8X^B5kBVy`H8&eFZCtVCIa#LKo
z@NKoK=2o0Bb=yXnI~QddR?134U!HU}S(dqF0Auaz8#nD~sIZio35DUjF>$D}K0@&)
zAH7q@dgyOj*{oM(Aw6?ua?pV#;q_5kO4afjEn^oiEp-eux@<=%El-_7un0tV(fvk`
z3(D!l8EmMqgC;cF?75X?SBW9ASlCh9v`3EgbG-W4t!au_Sk~3prEN$dmQGD+a44hD
zMxnS4Gz*3*zI9YM2A!zDvx`%mW`w9ReJ`W{_47!k##lNtWOgt;xe=|0D?!^6%@QQM
z!e>Z}WL?X0LU)doUeEbaFK(M_+A>tyOgrq#Je17NR9l6zP}WUB9u*Z{7R#F+d7KL=
z@M(Iw&Ddhg*{Bg3=tOuE(!RDiQB#Y1B5v-D7A2x<5~@f)#1+-zfvu=MTDx*Zbxmz;
zJi1C1#qoYzM6s5J))WD&R0Pyg6ke+H%UBcL;FTI)C#vMJv8WS@nfyCrq^yfOBl_cU
zr>x|PqBB<df}t~Zr*l(h5j*J!okk0cbf(rjDdp5fL6`LOaiZ%efd~JtBc#5_=#nq1
zlx{T4<np6Soz4K#B{%I6v&$HrO}Sl0E)CAUUB^gWT6E11OoZKt;LLv*wYrWFzW(Yu
zUg#4}m(h}o_b!?4b6S^V=YgzC?o9Vlt4p^3)Y2t2Ws2&O?XE()B%@*LM=L%occ)gJ
zC-*LOr#zo`%}y>2F|%~tyzJZ8F7+m7;VzjeZ%Vsl2j2;G9U=IlrOOz0z1W@dNLeCx
zsoAbQ3^Cry6$MrVOTQVij6q%4@X*)8DewO(r_RTp_ZhWjZPI|hsj~|YBf&Z~h0(UM
zwgnulW}Nj4_IF!W1Y}lZ)L>2Y-`F}h0$d)zv)eD_fw=Z?-YDVWPu8@{#4AK7x0t%(
zO$Nv6rb6oLZ6i5h$2b^J9Rm)}WLRf)@EeHimK(zgT3`o`)W?ANC#($PR#X)(8wXH*
zim!9K&iQ*v8}@aCx%wur$Dwr`z@R?<ZKc&$1I#$K{I=qowd@ul#L2Xl0lWG>x)k3Y
z1R3=)d8_X`z^=YKGU(eRad6YF&t<+o9MeeZyBpZm_b~L?tw=^>7~Ni6F7MF{ybl7r
z$20Kw#YC>YC%|*_Z_}L<;60Ur*AU?SIs@<O0B>&w`<@Q)ewTsQ1BC@@vVMP`fj2F{
zdmcR7CJ<fg;JpMqw;T#kZ)}%r2W&UC9n=T(y#jr9ix{+|zUqL!66oW%YEd8Cm(_P|
zK;PJW`yGxT!7-0?R|WJnL0<{v)He*5)wd_0@3ee>%Nn$#z9$0uZh$`9?uR@24g~bA
zhCaLX?dtn5pzi@kAGge{eWNi>xb=2B^x3U%SKkQm7{|KbKwlqtnBRO{R^O6<zIzZD
zrtjE*zLy+*qaA%~0{VUoeH@#tv-Qy)(Dw%P+43s@+1ht!KwtK#@b-6mK;M^+ed8Q`
ze+lU84Sja&o;F(h{v6Pkd%0hJ;~jlNVJPF+K5+!}4Wc4(R^K4-m?!H7Ir=6-X!E-`
zpsyJE!t7fR(3kJ%o9yU2H=ysB4EC)I=$q{5V|zugZa@5+f9A>N_ax{GYcD$k`YIfK
z>~~h*>j8b=%AoI00euS`ePxb5e)WTEUmf&?)yH7)XoGcCjy}%W*1iP+eXF6*=AChw
z7Tqxceajqu(-Cg<ofFV^KJ<mvZ&N^Dqoc3F(RX7&-{l$X+Y!*0aP-+VMjz<?bwJ-X
z=nE^qe-G$e=jh`&ZS(s{K;Io1?E4^~?=nZ<*BpHXD0~loTL<?*Us(B#1i`J}9ge;^
zj=paM^gW!xz9j*Dw>kReIr`QI^gRK6VdZyTK;ONNz6FlHdjk4i%#hz*0ewGr^euGs
zy%Ny(7wEG`oIp#q=NAI{_CTMVe-}CWdSTJ%!4JB2m6!~|>LVLGw?2AY;g9#6|80Aj
z8qjxg27N^VeZw7nOB{V?1oTCrkL}z#+D><BKwmlZk;nP+1YFj>O9T4O$zb1w0ey2E
zeN~RWp9l1<&!F$2fW9TrS0MJC=;(Vdpl>Vm?L@eBHot!j=xc+%mq22Em*TSd9frZ(
zt=}1AOu9jRgTZ4Q>lR(<udludq1Cr2pzmAIXWI_rTKnb)^sRwDTOX%7`pyx3S&R%<
z1ATa$Njj^qDWGo?^x5(|9c*jg)_}gVp%0>@v-<W3&juvG>##;ZXv^Y>K)Sn-ZUq8a
z&SwaZ`Fc5^Z|OLt-0#w|={_IO*Rc(MmWjHgzG_F`+W~z!Q}DN#7-Oxo`rZuad+B<=
zoNF9?2Lt-D@%2XQtP=1n{5+uV4d@$>a-n^7j=q6C{WuV-&6sr8SS9dV$nTi5Wl3J2
zo3Ngg@{7XHFqYpa(N_XY_Z7Zb_{P2l^OO2`;S6r_86Hqww?L`Mh-;lqmv^T+)jAB4
z9Vq9sAV(CPF2^}Wjo`9wd4p2F0M9zB&-(4%mG@8|9JF%YBgxzwX(YuGhDY=__8yar
z^ufV=;IBFU3BdY`hPCX2gIpt_h{b(ykaNE8J~+4#9^a;*JuGG4Mf95o*Y9K);)pI4
zH=IxIzKf_seGgDXITfY-{Q}|cj6yzZ(RUH^-N;EnM1SW%(hI&j12aBejyNuo@@9kK
zd=l|pL_Z<Aem>#(E|NUdY-ACY?*{@!)aZb}AmB%5cU;7LNn=tHG2g`H_$MbZK_umg
zl78C@3@xHq`@V}fErC*e8JQob{aj)CE}~LfOGK{(+;G3;Q5sQm{6OuW7x1$O`7WZ^
z`g|8ri}33V#$h-?yIkf60!32Z7|_2Y5Pm|yUls6k#`Il8&v>q%GnVfniZhPyB8oGH
z?;>gTab)*hM32m_zsC0fMfAw%iz136o9`lOh2mGUTF2gSnf2gKKZaTD4#Q_2`rmHx
zb1obOd!G@%3Gc1m6+g$gJoLw2()o?QuQFf1YsSDl)lV&!aE=6dNHLb;AE3UI;?L7x
zxyB@nzJcnE6#awLU<M?^2dksRp95JQ`Xk@}SjYUei=S)7JoL}&1K~FZ{Er9x&jtK^
z-$KVRF%SKFs56K&y-DIfQil&$RpKww{v%bZ_}M;3t9*4uihs2FH}O|#et~*H{3d_n
zRIUuEOe+uly;%Glsq)a@m!^bIR(y`9GvP(*X7MxqJoNXcQ~YJ>vlM>08X|MQNq@SU
zC4Q5Bh5A-X_$>8p@tgE!tD927zos5fi9biZo)SJ!<uV~S6Muo4AbykHLdEAPx-)U*
zp})7KgdeA_NbxUGd=8@HT%U&(`7<fuRmy(1snLI;8X;5CPR(DczUE9(<SY<>fe!zs
zS`i5USMf8MJoNwX2Ey+N_|s2t>!Ui=)hC@;d2DsH0;sB9WWf>*=FhLv_e67Bbv(L4
z<8!0&R_i&vyZbNI)%C47y41GTocA|g{@qeF4~=ws@*~qGP=-k67)W@a8~_Oq?CjiU
z%At?&=>Bn!4B^Rx9^v8XM?AuLogVH8kJ8Dpjtmh32Rg!8si!!=kv|~OM+5b7&+vHZ
z$2sg@RU}V3g&ZMIIb&`Qgd%}toRG7B8PX4&4XNkf@E#w-UuL#PaRjtJQ+o{jtxLG_
z<hhXW;N)SD@L=ZzNH`(w*he_6v$G!IG13lrWT2&<>c~I}9OcNwN<F`kffaseBLg|~
zq((S5c|0RL*gcaG&TtN5gcDLuUxZWqBNyS}Dd#N0DemEla7N%nML5YhMiEX(IXjVo
zl5$`ooMTT(goh@NMuZ2aoQDXf1P?)EU<FS;gwvek4tkKtFj1wPbbuy1Bqh%nhikV-
z9uOM%)4Mt*6p-Q1@yvTDPaajd&hX|d^(NM>eA*<w8bUrf5<h_T<0#^J_<$RW%ah02
z$;99kgHtMa3c~o5MEN+pG*}{dLqzFk9m>xKpHCLVTp!j59tC-$;1#f^S#TWpb%O84
zLVvU1S$Le@DtH;<UMsj4IJXME8TR}@Fn|2$$AVvg{+|iv9`RFx`J+cq3!Z>Q=N|;u
zp-lD(X3_nZ;1O64ejs=#?D<OYCXgb~#XMdL4u2Dgcn<Q*pD7}K6n2gh{CjZt6C;%O
zL|Rh?)2^9<k3(J-3O*k4C4z5-ol6BT#Cq*?!6UG!J4Z0fYO~;LBCttt1MIxfk>4t~
z2{!!Hkv}GQ9po<xJ_Kp~QSkSWua6x0=Yk)Dd;rRq`MMl794`1Mq&r3M@hFF>f^UFr
zCpq%d1oNlS)(W11bT1IhS1{K&@*4zCLs{*1<c|pE`?%*F`746CKL4BGzo0zzel~25
zLe>{H(f(biqd|g);XYCDS<qP`_(JfxhfF?Sb{#Kx1?=A>xDd8oDYypm?Sj{X|Cqz+
z5PS=CekPbdoW(vv{U4%?4;OqsY#1kaFZ53nJOY?|sN{cue4Qk?9(k!1JP-8}7tFLS
zaqvBY*=Bwun9s1!2|fV(Ulv>iJ?{wSbIacZ7b9Q%9X#5=bb1NC7x&?U&xZcdg3rRe
zTyQz^#b-Fi-3Xma1Q(+no+y|vu9+Wl#-MF5KJi>|&J%ne<QoL<2EJPGt0<rA1m6bz
zcME<G_xlC&cU_(oJQ8XBhv2!mzbcr0=+A<WM;<>CJPkH{F8EZ$?SnLE+v#Zkd4gXD
z*86>szlOLIMSc%-&KCRyY?vpQzhtvi@HB8v7d#Acn*<L<9^-;vK>2SH{0!??a1Hw1
z4TAH5ZxP%F_B<eX4s8CZ;N3`<`(?EMTyS0$JOgsJ1IpQ+|1NkTZ07SR<x|0D-4Oo}
zWj;$Ve;jCz;8wJs69uzho+kJh=sR2Rw~$s`@bi#w5_}5odd~{_`Asc1ihMHew+a3>
z^75eIuLD0U_!E@dbAk^++*bs@j57ID@O{947tFm5?gKF|dr`l`1y2E|Oz<19f2QDv
zk@qUW94Af@ycPPI1t(Be3Bl*Vo@)fJ1n1ub4?$TyE_f8`RPW8ehL^y3UF7(&O{Mol
zAio|u`{UB}0?y%rS0Il^3!V-6e8Jbj&Tk6l7`sgHw~;P?V1Rn)E)aYR@U?<3MBZ-{
zybopaW5L&e^E1J7q32V<{GGu8h(n#kM+j!y87Fug^ppzz6!}|7j5b1doM67^JDpfI
z3Dy$JYxVO5lXJOn#shN=;qm1N+`WQPUFzq=V$ZY0ToA#%Aefv#JDdZ=d77fW6iiMo
z%F*f>DtImOI9c#5;4UD>`9``$f>G^isc={(XAmP_RgkYB=1V5HvjvmC+TpJgek0_U
z5X<ZTD+H6zI<~gmD*Sbj?-KcJ)X&d|S!i&N3TD23EgahRw%~2J=b)ab^J?U4D6#&T
zMf82aj5|R%jJrrM<JJql9O<qmmMw{Y70kF735Ria2wn^MUBvpQ8qr4tqxq<xIs7My
zQHDDpe^&6lz^@Vy1Ayxgd>rsQ#K;TN`dIjTApczCp8@wk|Dn$P!1%gn{8SzQT%O=^
z;3J7e59fRGC!qaL7CH4y7x_0JpF=F$EeizmootoxY0qiG=Z~nKDRQ1KYZUplkjIHf
zAR^o<!9~Cugik$}3jfF8ZxK25Tqkm_>AolOpQ28GAo4FD=h)4B?ZEvfg1MIY6)_El
zds;BMtonm+nC_p6Q4T{<sechU)BQl?rI3F?JW{Js2L)44Z}fXxo`Z;?X94(Jb5l+|
zV?@qpfholKhzM6InEmKz;nSXl!fyrt>mq*v^?b6(dFJwTk-rC9>P3Dh<T2uWz7xk7
zE_fdBxx#rCoXy0eAcXslV7AZg#ITt*+$8+B!M|1H10esQ$g_ZdB=RWw$Ri>j4EY{n
z8UXhj!To_>5<d06Cj2SD|3y4T)7ATeIi!5y@OxnFWZ71N-<P<+@bd&y|B=M=js1nf
zZw9}Vc&y=16HNVc9sY5`-wggz;&Fz5s$kZ2y~A%7{ypHYCN4Dme-%vrMGk+9@P7&Z
zb;RQh|0cn-=T3+JBjNuM{D+Ar82;meSzk{({1=3ujlr~oc%tFIA(-W}-{F5I{1M<s
z5a>-Z{6hp&|3KpTraXreqx`vkA4fdd@FxnU{nH)(F~aAXb20H0!#`dy^`GYOYlY8q
zkWIuzhTkR_H+3Gd*t3}!_FNABmBht{zfCapf6w9X68`Pr-%ng(_zw!E{l6d<{l6xL
z{)fSTo|rEZ;Qk;OH}xj5@ZTc_|4r}@5X+YDmxB2mmy3DZ@&^!u{}uT8g7MSls#tIZ
zaJlfgem|YKoEBh=6%5ttEa9+EwG%@p_ma*ho~G$)y<qY$clg%`za9LWiKiR>ZGti6
zsCym$PlV6+22T*{-+ID33c=L>dx!t3@NWhGKZz@h{<j5_|B1stD14rQ?1A+Q%Zl@9
zKVszTL&%2`&op{Q2;K?r1mUwB%7i}vjbMhzr(rCaEAp9;FBJKHlz)}TxhHnA$WO!k
zQZ4do$YaE^4c{!d0O_t3KGWSGd_Lb?Mtqd9bBkbz)eR2+cH#4f@$M4&F3e?*;PNo;
z((NIJ?R3uwX3$H5VW#R3%=&suFr(}j%yK>;nC)Ca0d;aI)r%No0bQP8>K`VU`bP_<
z{)vLAzf3Uo&k{`i^8{1>5@HhIPH`~zmnp|h#fVY&bO{HaCzu?*zp!iCtq%UKU~+CH
zmbL2-9n9Y*ryNzS9wXL;fOVsTe=nGvKN8Ct^(_bUJssubd`>KD(QMSc#fJ(;usWPr
z)|~q91_bN(Gr;7OlOt<O{tc4F`dtm=<a~qjp#X5p99%D$_B07*8(T#zYsmG2Sq0w_
zJQ{ebV0QWM3g-FJ?+ZQ-_%32uLp~^&?Sa2gOF4D^yI^KP|N1%P1;8(eoYTag1atU$
zi&)l^`vp_y0l~VdBSYk{c=bCaU@qbED3>)P-zgB2KUy$tm?*daxJ+;n@N8mP2kQ4u
zf|rP#<;FdKayWONNjwq&uED`Af^|6yCVw4qJ^<Xsf>}OW1hdR{2<9+yv*3Bay98GO
z-%mUW0FHBy#lIAcn?7qmIc<26aw>=0CpZiEFM?^?`+`|kp9-dJ9>!C<?&>L+aR&%y
zy$ltM;Yp1W%<jYId9MHfZmM9$JxVasoiCW_eqAurJ(+kc0NfdZ88<4J={5^yx+?`U
z-3y4v0l;14;41~QOs*A78@^90YqK9X_&&kp|3onPPY{m>fa5$wOxyS#oS3$~BAB-E
z+y&*d?OkG7ryX!GD~fUyy*`&g%yjj8wuu06!^i<<TB8N$0_%5fkh2WSM9wnQ@84w2
zb}Z$B|3xs<Iz=#U`u&$(v&AS!$7EXP2xh+43TD3aIeKuIuS+SH_1iTLzDY3C+9?<}
zbuTeH9o%lgOzSbh%-0^l%opFulFxj-Oe|};Hy!-0V5ar4VBFL};t~KjzV|0)TKxnw
zUxy23zD5dWz9tZt0>G6DX55*AY3E$Qv~#gw+IbRj835e31arKq6O1Nd-VK67^V&sT
z4$QMHjJpJQqu?`vFDE7eZo7l^J448s-`hn_dw2$heA@F6v8?wVb?{Sy8F#N>#(hyR
z<Gx1Bi2#o0(ur9P9|&fde<qma>7iiA=>y!GSk{63k!@neJwh<k9V3|OP7=&?rx8~G
zz|C>6KBEpf)79@MftfDfQ<KlQwZyUxJWDXsiVG(HT*2gT5X?4kiC|8VR|(DszE1FX
z;9CTj0N*K?^W*)37XbfMFzfLbf|mmShu~$v&kC*wepzr6@Sg=IfZrDUZQ#EN-T?f$
z;ERE?dYb%R0o+UQRls?IuLB+?_-5eIf_DP*e6?M>a^HfOWyN=D#H^PEf>}OG1apey
zPhpc&0DLB~tZ5q@+#;CuwMsDcvmN9dYwD3<hX~Fj2Sw${!Bf^*&dHRRG3XG%v?=eK
zTC7ji=AB|Nn^E4W2D4q}4KsKU@#zNV6N`MjBWGK&a^^oz);u~c)*f{Exbg(k{ybTS
zxR|Q**pcDp;L6HJJ>X84m#=TS9a|2|-C}Kn#C7FbzsOzea;Q0v8G>{5(4RMvpQes&
zTJ+~l=4S}M$jDv&u1@AL=V-%WaU3Fe9B@{dDJQBRF2{WlE}O1vzt$=Bl1a`sWa~xq
zrS8bjk}-kpDo@5P&5^MvmmG`_Y)7m|;(XkPIGAnPwhb1CO-r|>H4wnf!DZ`R=S6I;
za^$BHi+s5wZ*=5sj{IC=snbowCHR251XrGn;nxrg=LTXHCLGJe_6z3G_6wbNDux?|
zD^JEo`txS-)AYmaGYqDl?DGt!p6v4tW?6Y(Gni#%pFLStRz99so*8MDm9yOJv)%$n
zzKB?!@0L1pmYaR1t9Rs$#PS@MaO7)<X&@ZS&8B-X@nA~vt{<0`?;t*mQtY+ivhrQT
zhf|9EL|j(Bn|KJN*jL46<$H*SQi}aJTvq-PF$){+4O~|K7O{*WA35>^#4?8T@O*wQ
z@dyOM4RYk%SF_J71&(|?u{@iUJMs$Rd?<li;K&ydk1}$79z*K)RLVyidA-ALBpzer
z2}iz$xWLFaIr58%#~S(7j(i6(2L`y?9QiKdLL+~`k?$rRZ{$xp@;$^8jQlxA{u1#-
zBY(q@zeOzT;g1~o0b&{Vc(%sYS1z%vZwEQ@A;dBs7C3VLJ(XRfmOJtaV(H7=1F-rR
z5z9JrsUts?7~>>ey(4cVE;n-hK1Awk4dpUEY;yP)6U!KQwIkm_EaTyAj(it!h0*_j
zBi~Id<HnPYd=IgVA<sGTmxyIOKy7xc=pmS6On(Ot63i~iYPMqttAv<*nq~29!Q@vF
z%b2iKFp^h|#8eE|go~K+b;L3zY!XcQ4r1xc99M~H@4b%v0Y|=vSo-*H1P{UeB?rGM
zcoFXV1>>eZ5_}}?UpV-n-~!xp*e0Q$n12I8%<4YO!NUa4ft-7Fc5Im<m}RWbVqwf7
zK3e1@z}&;L{F4Rufqa>RmkVZ7<Q|?KquK>?EpUN@HwtF4aBt7@uXi}NIC!UE4t?C)
zvt!*)1hYJU>EK@pX1mbmxMXa6P2|j@?&FXXzaw%EHQWod`tie;8dHA`+ba0P`kf~*
z+aUM+>=-*jFxw&b{H$Dm2Ma2Z@&%O3*t<wD<=oq|^5u@4dw5<x2ypF!*&g&cv3#Y7
zH;Vi?VEuh6kkj#RY`lEKxzo|3-))Ngrw&J-C4>9~h35{Dj|P50@Iv6XiAMpzy(gIM
zpZj@Mo+FrY?&n!K|3-(Ha_-yNxuaAt+X?sQ?A)<fFw5s;2cIT54|49$**WDL!PLWj
zI6J54_m-Gns7Iek6Rh7`0#gt7;p|*<pJ4L2-)85UUkRq1`)YQsc}+0o?>hJc!PK9P
zOxroAr(l)?_s{GcG)ge-*XP`14w^|hF!|gMvvbfl1T)<;99$!q>2g2J&P{6t<EHn$
z?A)}K@*=awznxg#pZq{D`TAWV2L!msDF<e{PdoT`f|>4{#4>07RWS4Q6>%8=oPK`@
zoDY0xwviL-_lJ-#0p^~T<xdbyIrq1$e74{U$n`rz#3eq~;d4*R&WY86X+QU_?3}n-
zFy)sL%bcj+4FYqGd@JQLC*C0#SyDf8@I!)`U;Pe{#=z~R95@$PzXJrO&V3>$|3krm
z>QjgRcfsUm!9eOEpL<kx&K)e6oKX%QEBH3Zxp!sxM+@dS#=R>muX5zvyRz~+N3PG{
z%|b-DRg?oW-3<=DP%y_3?orvfUcdLlyw7rjSb3aK;9Sgc*{%nM5X<vIJ~0E~Xt#YX
zVAHhE0w|i~TtA0c=J!R!GN)G&b725?DlWU8Urx*f;Tmz-xxS5<6BgVWTy{=eN6d){
z?qXba?$|=i!5MA`E<3j0Oq`DoxLvsH*my573kq&GE;|N3MqGdoxIMV+nDz|uI7($L
zA?x7|`0cp#7O|{*_Y+UV2iyT%c73Zj$8n;B%O#d|Y=7b+BOgL6V?sW0iII;dmOfrW
zEd9EIxZH5&5X+i#5wY~CDq`tJrxI5f{&HejLpBmi8*3wW*NT{X=-7trUS}>bI|Uq@
z6fvu~Ke4nQHU(nJhY&Lmj#WrZwfV&Iyvd>`rhGhc9zNh$WW<!SIPBVz*|vLy%#v+;
zvjx-MImFTq7YL?&5wWz%C4#BHidddEmkOr*RAOcVZW%6O%9j(%8ns?9`&J{dwBaVf
z$Kl>ajI|$K0v9p!v4&XM_IZNYq}LJ4nrf3^HkFHsrOjU^I2ZRV#IokOS}^51i1YCQ
zcLOdj-{kdX1w0BLaJS(irv1B!N8<zTZd}Cuale;%3_jo<z(qU=_ua$=_<;L4E@JW@
zBOZ$nxF>NDlfQ>p`qXa()6QpzrGGsqnDUp1$KwO;Rb0f>(?Kl#?hV1T|1DzagYO8Y
zJ^P96^QK_(4-ikr2i%vqh^b$(FGxS_A((vKf2Gg%p&Xd{bzheLJBV^%@^!y10e~A$
zIWYC-6HC7?5KKL~ze^vVOgZqGkn6r*4ggn9IWYNp9FV?0n{r^v=Mc*{ut0Dh$o2Rj
zV}kx05Mc84SWy80x0HNf%JsM*V}*Vm0p1Dua&lzcs29v;pvMy#Lz*ZDW;y&XWW{7_

literal 0
HcmV?d00001

diff --git a/examples/CustomChars/CustomChars.pde b/examples/CustomChars/CustomChars.pde
new file mode 100644
index 0000000..beea6d6
--- /dev/null
+++ b/examples/CustomChars/CustomChars.pde
@@ -0,0 +1,70 @@
+//YWROBOT
+//Compatible with the Arduino IDE 1.0
+//Library version:1.1
+#include <Wire.h>
+#include <LiquidCrystal_I2C.h>
+
+#if defined(ARDUINO) && ARDUINO >= 100
+#define printByte(args)  write(args);
+#else
+#define printByte(args)  print(args,BYTE);
+#endif
+
+uint8_t bell[8]  = {0x4,0xe,0xe,0xe,0x1f,0x0,0x4};
+uint8_t note[8]  = {0x2,0x3,0x2,0xe,0x1e,0xc,0x0};
+uint8_t clock[8] = {0x0,0xe,0x15,0x17,0x11,0xe,0x0};
+uint8_t heart[8] = {0x0,0xa,0x1f,0x1f,0xe,0x4,0x0};
+uint8_t duck[8]  = {0x0,0xc,0x1d,0xf,0xf,0x6,0x0};
+uint8_t check[8] = {0x0,0x1,0x3,0x16,0x1c,0x8,0x0};
+uint8_t cross[8] = {0x0,0x1b,0xe,0x4,0xe,0x1b,0x0};
+uint8_t retarrow[8] = {	0x1,0x1,0x5,0x9,0x1f,0x8,0x4};
+  
+LiquidCrystal_I2C lcd(0x27,20,4);  // set the LCD address to 0x27 for a 16 chars and 2 line display
+
+void setup()
+{
+  lcd.init();                      // initialize the lcd 
+  lcd.backlight();
+  
+  lcd.createChar(0, bell);
+  lcd.createChar(1, note);
+  lcd.createChar(2, clock);
+  lcd.createChar(3, heart);
+  lcd.createChar(4, duck);
+  lcd.createChar(5, check);
+  lcd.createChar(6, cross);
+  lcd.createChar(7, retarrow);
+  lcd.home();
+  
+  lcd.print("Hello world...");
+  lcd.setCursor(0, 1);
+  lcd.print(" i ");
+  lcd.printByte(3);
+  lcd.print(" arduinos!");
+  delay(5000);
+  displayKeyCodes();
+  
+}
+
+// display all keycodes
+void displayKeyCodes(void) {
+  uint8_t i = 0;
+  while (1) {
+    lcd.clear();
+    lcd.print("Codes 0x"); lcd.print(i, HEX);
+    lcd.print("-0x"); lcd.print(i+16, HEX);
+    lcd.setCursor(0, 1);
+    for (int j=0; j<16; j++) {
+      lcd.printByte(i+j);
+    }
+    i+=16;
+    
+    delay(4000);
+  }
+}
+
+void loop()
+{
+
+}
+
diff --git a/examples/HelloWorld/HelloWorld.pde b/examples/HelloWorld/HelloWorld.pde
new file mode 100644
index 0000000..458c6d8
--- /dev/null
+++ b/examples/HelloWorld/HelloWorld.pde
@@ -0,0 +1,28 @@
+//YWROBOT
+//Compatible with the Arduino IDE 1.0
+//Library version:1.1
+#include <Wire.h> 
+#include <LiquidCrystal_I2C.h>
+
+LiquidCrystal_I2C lcd(0x27,20,4);  // set the LCD address to 0x27 for a 16 chars and 2 line display
+
+void setup()
+{
+  lcd.init();                      // initialize the lcd 
+  lcd.init();
+  // Print a message to the LCD.
+  lcd.backlight();
+  lcd.setCursor(3,0);
+  lcd.print("Hello, world!");
+  lcd.setCursor(2,1);
+  lcd.print("Ywrobot Arduino!");
+   lcd.setCursor(0,2);
+  lcd.print("Arduino LCM IIC 2004");
+   lcd.setCursor(2,3);
+  lcd.print("Power By Ec-yuan!");
+}
+
+
+void loop()
+{
+}
diff --git a/examples/SerialDisplay/SerialDisplay.pde b/examples/SerialDisplay/SerialDisplay.pde
new file mode 100644
index 0000000..1fca4e1
--- /dev/null
+++ b/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.
+ * YWROBOT
+ *Compatible with the Arduino IDE 1.0
+ *Library version:1.1
+ */
+#include <Wire.h> 
+#include <LiquidCrystal_I2C.h>
+
+LiquidCrystal_I2C lcd(0x27,20,4);  // set the LCD address to 0x27 for a 16 chars and 2 line display
+
+void setup()
+{
+  lcd.init();                      // initialize the lcd 
+  lcd.backlight();
+  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/keywords.txt b/keywords.txt
new file mode 100644
index 0000000..8c450a9
--- /dev/null
+++ b/keywords.txt
@@ -0,0 +1,46 @@
+###########################################
+# Syntax Coloring Map For LiquidCrystal_I2C
+###########################################
+
+###########################################
+# Datatypes (KEYWORD1)
+###########################################
+
+LiquidCrystal_I2C	KEYWORD1
+
+###########################################
+# Methods and Functions (KEYWORD2)
+###########################################
+init	KEYWORD2
+begin	KEYWORD2
+clear	KEYWORD2
+home	KEYWORD2
+noDisplay	KEYWORD2
+display	KEYWORD2
+noBlink	KEYWORD2
+blink	KEYWORD2
+noCursor	KEYWORD2
+cursor	KEYWORD2
+scrollDisplayLeft	KEYWORD2
+scrollDisplayRight	KEYWORD2
+leftToRight	KEYWORD2
+rightToLeft	KEYWORD2
+shiftIncrement	KEYWORD2
+shiftDecrement	KEYWORD2
+noBacklight	KEYWORD2
+backlight	KEYWORD2
+autoscroll	KEYWORD2
+noAutoscroll	KEYWORD2
+createChar	KEYWORD2
+setCursor	KEYWORD2
+print	KEYWORD2
+blink_on	KEYWORD2
+blink_off	KEYWORD2
+cursor_on	KEYWORD2
+cursor_off	KEYWORD2
+setBacklight	KEYWORD2
+load_custom_character	KEYWORD2
+printstr	KEYWORD2
+###########################################
+# Constants (LITERAL1)
+###########################################