LiquidCrystal 函式說明 ㈠

利用 LiquidCrystal 函式庫建立一個 LiquidCrystal 資料形態的物件，LiquidCrystal() 函式的格式如下，可以使用 4 位元 ( d4 ~ d7 ) 或 8 位元 ( d0 ~ d7 ) 的資料線來控制 LCD 顯示器，其中 rs 為指令/資料暫存器選擇位元，rw 為讀/寫控制位元，enable 為致能位元，d0 ~ d7 為資料線。 例如下面範例中使用 Arduino 數位接腳 12、11、10 分別連接至 LCD 的 rs、rw、enable 接腳，Arduino 數位接腳 5、4、3、2 分別連接至 LCD 的 d4、d5、d6、d7。

格式：

LiquidCrystal( rs, enable, d4, d5, d6, d7 )
LiquidCrystal( rs, rw, enable, d4, d5, d6, d7 )
LiquidCrystal( rs, enable, d0, d1, d2, d3, d4, d5, d6, d7 )
LiquidCrystal( rs, rw, enable, d0, d1, d2, d3, d4, d5, d6, d7 )

範例：

include<LiquidCrystal.h>               // 使用 LiquidCrystal 函式库
LiquidCrystal lcd( 12,11,10,5,4,3,2 ); // 宣告 lcd 变数

☛ begin() 函式

begin() 函式的功能是用來指定 LCD 顯示器的總行數及總列數，有 cols、rows 等二個參數必須設定，cols 參數設定 LCD 的總行數，rows 參數設定 LCD 的總列數。 在使用 begin() 函式之前，必須先使用 LiquidCrystal() 函式宣告一個 LiquidCrystal 資料形態的物件。

格式：

lcd.begin( cols, rows )

範例：

include<LiquidCrystal.h>              // 使用 LiquidCrystal 函式庫

LiquidCrystal lcd(12,11,10,5,4,3,2);  // 宣告 lcd 變數
lcd.begin(16,2);                      // 使用 16 行 × 2 列的 LCD

☛ clear() 函式

clear() 函式的功能是用來清除 LCD，同時將游標移至左上角，不須設定任何參數。 在使用 clear() 函式之前，必須先使用 LiquidCrystal() 函式宣告一個 LiquidCrystal 資料形態的物件。

格式：

clear()

範例：

include<LiquidCrystal.h>              // 使用 LiquidCrystal 函式庫

LiquidCrystal lcd(12,11,10,5,4,3,2);  // 宣告 lcd 變數
lcd.clear();                          // 清除 LCD，游標移至左上角

☛ home() 函式

home() 函式的功能是將游標移至 LCD 左上角，不須設定任何參數。 在使用 home() 函式之前，必須先使用 LiquidCrystal() 函式宣告一個 LiquidCrystal 資料形態的物件。

格式：

home()

範例：

include<LiquidCrystal.h>              // 使用 LiquidCrystal 函式庫

LiquidCrystal lcd(12,11,10,5,4,3,2);  // 宣告 lcd 變數
lcd.home();                           // 游標移至 LCD 左上角

☛ setCursor() 函式

setCursor() 函式的功能是設定遊標的位置，有 col 及 row 二個參數必須設定，col 參數設定 LCD 遊標的行位置，row 參數設定 LCD 遊標的列位置，兩個參數都是由 0 開始。 在使用 setCursor() 函式之前， 必須先使用 LiquidCrystal() 函式宣告一個 LiquidCrystal 資料形態的物件。

格式：

setCursor( col, row )

範例：

include<LiquidCrystal.h>              // 使用 LiquidCrystal 函式庫

LiquidCrystal lcd(12,11,10,5,4,3,2);  // 宣告 lcd 變數
lcd.setCursor(0,1);                   // 設定游標停在第 0 行，第 1 列

☛ write() 函式

write() 函式的功能是將字元寫入 LCD 中，有一個參數 data 必須設定，data 參數是所要寫入 LCD 中的字元，write() 函式會傳回所寫入的位元組總數。 在使用 write() 函式之前，必須先使用 LiquidCrystal() 函式宣告一個 LiquidCrystal 資料形態的物件。

格式：

write( data )

範例：

include<LiquidCrystal.h>              // 使用 LiquidCrystal 函式庫

LiquidCrystal lcd(12,11,10,5,4,3,2);  // 宣告 lcd 變數
lcd.write("hello, world!");           // 寫入字元 “hello， world！”

☛ print() 函式

print() 函式的功能是將文字寫入 LCD 中，有 data 及 BASE 兩個參數可以設定，data 參數是所要寫入至 LCD 中的文字，data 可以是 char、byte、int、long 或 string 等資料形態，如果 data 是數值，可以使用 BASE 參數設定所要顯示數值的基數，有 BIN ( 二進 )、OCT ( 八進 )、DEC ( 十進 )、HEX ( 十六進 ) 等四種基數可以選擇。 print() 函式會傳回所寫入的位元組總數。 在使用 print() 函式之前，必須先使用 LiquidCrystal() 函式宣告一個 LiquidCrystal 資料形態的物件。

格式：

print( data )
print( data, BASE )

範例：

include<LiquidCrystal.h>              // 使用 LiquidCrystal 函式庫

LiquidCrystal lcd(12,11,10,5,4,3,2);  // 宣告 lcd 變數
lcd.print("hello, world!");           // 寫入字元 "hello, world!"
lcd.print(15,BIN);                    // 顯示 15 的二進位數值 1111
lcd.print(15,OCT);                    // 顯示 15 的八進位數值 17
lcd.print(15,DEC);                    // 顯示 15 的十進位數值 15
lcd.print(15,HEX);                    // 顯示 15 的十六進位數值 F

☛ cursor() / noCursor() 函式

cursor() 函式的功能是顯示遊標，noCursor() 函式的功能是隱藏遊標，兩者皆不須設定任何參數。 在使用 cursor() / noCursor() 函式之前，必須先使用 LiquidCrystal() 函式宣告一個 LiquidCrystal 資料形態的物件。

格式：

cursor() / noCursor()

範例：

include<LiquidCrystal.h>              // 使用 LiquidCrystal 函式庫

LiquidCrystal lcd(12,11,10,5,4,3,2);  // 宣告 lcd 變數
lcd.cursor();                         // 顯示游標
lcd.noCursor();                       // 隱藏游標