Arduino LiquidCrystal库函数的语法及其命令设置.docx
《Arduino LiquidCrystal库函数的语法及其命令设置.docx》由会员分享，可在线阅读，更多相关《Arduino LiquidCrystal库函数的语法及其命令设置.docx（12页珍藏版）》请在冰豆网上搜索。
ArduinoLiquidCrystal库函数的语法及其命令设置
ArduinoLiquidCrystal库函数的语法及其命令设置
Function
∙1LiquidCrystal（）
∙2begin（）
∙3clear（）
∙4home（）
∙5setCursor（）
∙6write（）
∙7print（）
∙8cursor（）
∙9noCursor（）
∙10blink（）
∙11noBlink（）
∙12display（）
∙13noDisplay（）
∙14scrollDisplayLeft（）
∙15scrollDisplayRight（）
∙16autoscroll（）
∙17noAutoscroll（）
∙18leftToRight（）
∙19rightToLeft（）
∙20createChar（）
1LiquidCrystal（）
内容
创建一个LiquidCrystal的实例（构造函数）.可使用4线或8线方式作为数据线（请注意,还需要指令线）.若采用四线方式,将d0-d3悬空不连接.RW引脚可接地而不用接在Arduino的某个引脚上;如果这样接,省略在函数中的rw参数.
语法
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）
参数设置
rs:
rs连接的Arduino的引脚编号
rw:
rw连接的Arduino的引脚编号
enable:
enable连接的Arduino的引脚编号
d0,d1,d2,d3,d4,d5,d6,d7:
连接的Arduino的引脚编号
例子
#include
LiquidCrystallcd（12,11,10,5,4,3,2）;
voidsetup（）
{
lcd.print（"hello,world!
"）;
}
voidloop（）{}
2begin（）
内容
指定显示屏的尺寸（宽度和高度）。
语句
lcd.begin（cols,rows）
参数设置
lcd:
液晶类型的名称变量
cols:
显示器可以显示的列数（1602是16列）
rows:
显示器可以显示的行数（1602是2行）
3clear（）
简介
清楚LCD屏幕上内容,并将光标置于左上角。
语法
lcd.clear（）
参数
LCD：
LiquidCrystal类的对象
4home（）
内容
将光标定位在屏幕左上角.就是说,接下来的字符从屏幕左上角开始显示.如果同时要清楚屏幕上的内容,请使用clear（）函数代替.
语法
lcd.home（）
参数设置
lcd:
avariableoftypeLiquidCrystal
5setCursor（）
简介
将光标定位在特定的位置。
语法
lcd.setCursor（col,row）
参数
LCD：
一个LiquidCrystal类型的变量
col:
你要显示光标的列（从0开始计数）
row:
你要显示光标的行（从0开始计数）
6write（）
简介
向LCD写一个字符。
语法
lcd.write（data）
参数
lcd:
一个类型为LiquidCrystal的变量（LiquidCrystal是一个类）。
data:
你要显示的字符（仅限英文和数字和你自己定义的字符）。
返回值
byte
write（）将返回写入的字节数，虽然读这个数字是可选
示例
#include
LiquidCrystallcd（12,11,10,5,4,3,2）;
voidsetup（）
{
Serial.begin（9600）;
}
voidloop（）
{
if（Serial.available（））{
lcd.write（Serial.read（））;
}
}
7print（）
内容
将文本显示在LCD上.
语法
lcd.print（data）
lcd.print（data,BASE）
参数
lcd:
液晶类型的名称变量
data:
要显示的数据,可以是char,byte,int,long或者string类型的
BASE（optional）:
数制（可选的）,BIN,DEC,OCT,HEX分别将数字以二进制,十进制,八进制,十六进制方式显示出来.
返回值
byte
这个返回值通常是用不到的
示例
#include
LiquidCrystallcd（12,11,10,5,4,3,2）;
voidsetup（）
{
lcd.print（"hello,world!
"）;
}
voidloop（）{}
8cursor（）
内容
显示光标.（光标所在的位置,就是下一个字符将会被显示的位置）
语句
lcd.cursor（）
参数设置
lcd:
液晶类型的名称变量
例子
∙cursor（）andnoCursor（）
9noCursor（）
内容
隐藏光标。
语法
lcd.noCursor（）
参数
lcd:
液晶类型的名称变量
例子
∙cursor（）andnoCursor（）
10blink（）
内容
显示闪烁的光标。
如果和cursor（）一起使用,最终结果将取决于您使用的LCD屏幕.
语法
lcd.blink（）
参数设置
lcd:
液晶类型的名称变量
例子
∙blink（）andnoBlink（）
11noBlink（）
内容
关闭光标闪烁功能.
语句
lcd.noBlink（）
参数设置
lcd:
液晶类型的名称变量
例子
12display（）
内容
调用noDisplay（）隐藏LCD上显示内容后,调用本函数恢复显示.
语法
lcd.display（）
参数
lcd:
液晶类型的名称变量
例子
∙display（）andnoDisplay（）
∙blink（）andnoBlink（）
13noDisplay（）
内容
关闭液晶显示,但原先显示的内容不会丢失.可使用display（）恢复显示.
语法
lcd.noDisplay（）
参数
lcd:
液晶类型的名称变量
例子
∙display（）andnoDisplay（）
14scrollDisplayLeft（）
简介
使屏幕上内容（光标及文字）向左滚动一个字符。
语法
lcd.scrollDisplayLeft（）
参数
lcd:
一个LiquidCrystal类的对象
例子
∙scrollDisplayLeft（）andscrollDisplayRight（）
15scrollDisplayRight（）
简介
使屏幕上内容（光标及文字）向右滚动一个字符。
语法
lcd.scrollDisplayRight（）
参数
lcd:
一个LiquidCrystal类的对象
例子
∙scrollDisplayLeft（）andscrollDisplayRight（）
16autoscroll（）
简介
打开液晶显示屏的自动滚动,将会使得当一个字符输出到LCD时,令先前的文本移动一个位置.如果当前写入方向为由左到右（默认方向）,文本向左滚动.反之,文本向右滚动.它的功能可以理解为,当输出单个字符时,会使得字符总是输出在LCD上的同一个位置.
语法
lcd.autoscroll（）
参数
lcd:
avariableoftypeLiquidCrystal
17noAutoscroll（）
简介
关闭自动滚动功能。
（后输入的字符可能无法显示）
语法
lcd.noAutoscroll（）
参数
LCD：
LiquidCrystal类的对象
18leftToRight（）
内容
默认的方向,将文本从左到右写入屏幕.这意味着,后续字符的显示将是从左向右的,但是这不会影响先前已经显示的字符.
语法
lcd.leftToRight（）
参数设置
lcd:
avariableoftypeLiquidCrystal
19rightToLeft（）
简介
设置文本写入LCD的方向为从右向左（默认是从左向右）。
这意味着，后续字符将会由右至左写入，但不影响先前的文本的显示。
语法
lcd.rightToLeft（）
参数
lcd:
一个LiquidCrystal类的对象
20createChar（）
内容
创建用户自定义的字符.共可创建8个用户自定义字符,编号从0到7.字符外观由一个8字节数组定义,每行占用一个字节.最低的5个有效位决定像素点所在的行.若要在屏幕显示自定义字符,请使用write（）函数.（参数为字符的编号0-7）
语法
lcd.createChar（num,data）
参数设置
lcd:
avariableoftypeLiquidCrystal
num:
所创建字符的编号（0-7）
data:
字符的像素数据
例子
#include
LiquidCrystallcd（12,11,5,4,3,2）;
bytesmiley[8]={
B00000,
B10001,
B00000,
B00000,
B10001,
B01110,
B00000,
};
voidsetup（）{
lcd.createChar（0,smiley）;
lcd.begin（16,2）;
lcd.write（0）;
}
voidloop（）{}
整理：
付天国
日期：
2012-12-12
升级会员 