利用 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();                       // 隱藏游標