Reader's Digest

Digest your Internet

Arduino 语法

Written By: dch1 - Feb• 27•14

根据http://wiki.geek-workshop.com/doku.php?id=arduino:arduino_language_reference修改

#Arduino 语法

setup() 初始化函数

loop() 循环体函数

控制语句类似于C
//if if…else for switch case while do… while break continue return goto

扩展语法类似于C
//;(分号) {}(花括号) //(单行注释) /* */(多行注释) #define #include

算数运算符类似于C
//=(赋值运算符) +(加) -(减) *(乘) /(除) %(模)

比较运算符类似于C
//==(等于) !=(不等于) <(小于) >(大于) <=(小于等于) >=(大于等于)

布尔运算符类似于C
//&&(与) ||(或) !(非)

指针运算符类似于C
//* 取消引用运算符 & 引用运算符

位运算符类似于C
& (bitwise and) | (bitwise or) ^ (bitwise xor) ~ (bitwise not) << (bitshift left) >> (bitshift right)

复合运算符类似于C
++ (increment) — (decrement) += (compound addition) -= (compound subtraction) *= (compound multiplication) /= (compound division) &= (compound bitwise and) |= (compound bitwise or)

常量
constants 预定义的常量
BOOL true false

引脚电压定义,HIGH和LOW【当读取(read)或写入(write)数字引脚时只有两个可能的值: HIGH 和 LOW 】
HIGH(参考引脚)的含义取决于引脚(pin)的设置,引脚定义为INPUT或OUTPUT时含义有所不同。当一个引脚通过pinMode被设置为INPUT,并通过digitalRead读取(read)时。如果当前引脚的电压大于等于3V,微控制器将会返回为HIGH。 引脚也可以通过pinMode被设置为INPUT,并通过digitalWrite设置为HIGH。输入引脚的值将被一个内在的20K上拉电阻 控制 在HIGH上,除非一个外部电路将其拉低到LOW。 当一个引脚通过pinMode被设置为OUTPUT,并digitalWrite设置为HIGH时,引脚的电压应在5V。在这种状态下,它可以 输出电流 。例如,点亮一个通过一串电阻接地或设置为LOW的OUTPUT属性引脚的LED。
LOW的含义同样取决于引脚设置,引脚定义为INPUT或OUTPUT时含义有所不同。当一个引脚通过pinMode配置为INPUT,通过digitalRead设置为读取(read)时,如果当前引脚的电压小于等于2V,微控制器将返回为LOW。 当一个引脚通过pinMode配置为OUTPUT,并通过digitalWrite设置为LOW时,引脚为0V。在这种状态下,它可以 倒灌 电流。例如,点亮一个通过串联电阻连接到+5V,或到另一个引脚配置为OUTPUT、HIGH的的LED。

数字引脚(Digital pins)定义,INPUT和OUTPUT【数字引脚当作 INPUT 或 OUTPUT都可以 。用pinMode()方法使一个数字引脚从INPUT到OUTPUT变化】
Arduino(Atmega)引脚通过pinMode()配置为 输入(INPUT) 即是将其配置在一个高阻抗的状态。配置为INPUT的引脚可以理解为引脚取样时对电路有极小的需求,即等效于在引脚前串联一个100兆欧姆(Megohms)的电阻。这使得它们非常利于读取传感器,而不是为LED供电。
引脚通过pinMode()配置为 输出(OUTPUT) 即是将其配置在一个低阻抗的状态。
这意味着它们可以为电路提供充足的电流。Atmega引脚可以向其他设备/电路提供(提供正电流positive current)或倒灌(提供负电流negative current)达40毫安(mA)的电流。这使得它们利于给LED供电,而不是读取传感器。输出(OUTPUT)引脚被短路的接地或5V电路上会受到损坏甚至烧毁。Atmega引脚在为继电器或电机供电时,由于电流不足,将需要一些外接电路来实现供电。

整数常量
进制 例子 格式 备注
10(十进制) 123 无
2(二进制) B1111011 前缀’B’ 只适用于8位的值(0到255)字符0-1有效
8(八进制) 0173 前缀”0” 字符0-7有效
16(十六进制) 0x7B 前缀”0x” 字符0-9,A-F,A-F有效

小数是十进制数。这是数学常识。如果一个数没有特定的前缀,则默认为十进制。
二进制以2为基底,只有数字0和1是有效的。

‘u’ or ‘U’ 指定一个常量为无符号型。(只能表示正数和0) 例如: 33u
‘l’ or ‘L’ 指定一个常量为长整型。(表示数的范围更广) 例如: 100000L
‘ul’ or ‘UL’ 这个你懂的,就是上面两种类型,称作无符号长整型。 例如:32767ul

浮点常量
浮点数 被转换为 被转换为
10.0 10
2.34E5 2.34 * 10^5 234000
67E-12 67.0 * 10^-12 0.000000000067

数据类型类似于C
void boolean char unsigned char byte int unsigned int word
long unsigned long float double string – char array String – object array -(数组)

数据类型转换类似于C
char() byte() int() word() long() float()
word()
把一个值转换为word数据类型的值,或由两个字节创建一个字符。
word(x)
word(h, l)
参数
X:任何类型的值
H:高阶(最左边)字节
L:低序(最右边)字节

修饰符类似于C
static volatile const

辅助工具
sizeof()

数字 I/O
pinMode()
将指定的引脚配置成输出或输入【pinMode(pin, mode) pin:要设置模式的引脚 mode:INPUT或OUTPUT】
例子:
ledPin = 13 // LED连接到数字脚13
void setup()
{
pinMode(ledPin,OUTPUT); //设置数字脚为输出
}
void loop()
{
digitalWrite(ledPin,HIGH); //点亮LED
delay(1000); // 等待一秒
digitalWrite(ledPin, LOW); // 灭掉LED
delay(1000); //等待第二个
}

digitalWrite()
给一个数字引脚写入HIGH或者LOW。
如果一个引脚已经使用pinMode()配置为OUTPUT模式,其电压将被设置为相应的值,HIGH为5V(3.3V控制板上为3.3V),LOW为0V。
如果引脚配置为INPUT模式,使用digitalWrite()写入HIGH值,将使内部20K上拉电阻(详见数字引脚教程)。写入LOW将会禁用上拉。上拉电阻可以点亮一个LED让其微微亮,如果LED工作,但是亮度很低,可能是因为这个原因引起的。补救的办法是 使用pinMode()函数设置为输出引脚。
注意:数字13号引脚难以作为数字输入使用,因为大部分的控制板上使用了一颗LED与一个电阻连接到他。如果启动了内部的20K上拉电阻,他的电压将在1.7V左右,而不是正常的5V,因为板载LED串联的电阻把他使他降了下来,这意味着他返回的值总是LOW。如果必须使用数字13号引脚的输入模式,需要使用外部上拉下拉电阻。

digitalRead()
digitalRead(PIN)【pin:你想读取的引脚号(int),返回 HIGH 或 LOW】
例子:
ledPin = 13 // LED连接到13脚
int inPin = 7; // 按钮连接到数字引脚7
int val = 0; //定义变量存以储读值
void setup()
{
pinMode(ledPin, OUTPUT); // 将13脚设置为输出
pinMode(inPin, INPUT); // 将7脚设置为输入
}
void loop()
{
val = digitalRead(inPin); // 读取输入脚
digitalWrite(ledPin, val); //将LED值设置为按钮的值
}

模拟 I/O
analogReference()
analogReference(type)
配置用于模拟输入的基准电压(即输入范围的最大值)。选项有:
DEFAULT:默认5V(Arduino板为5V)或3.3伏特(Arduino板为3.3V)为基准电压。
INTERNAL:在ATmega168和ATmega328上以1.1V为基准电压,以及在ATmega8上以2.56V为基准电压(Arduino Mega无此选项)
INTERNAL1V1:以1.1V为基准电压(此选项仅针对Arduino Mega)
INTERNAL2V56:以2.56V为基准电压(此选项仅针对Arduino Mega)
EXTERNAL:以AREF引脚(0至5V)的电压作为基准电压。
type:使用哪种参考类型(DEFAULT, INTERNAL, INTERNAL1V1, INTERNAL2V56, 或者 EXTERNAL)
改变基准电压后,之前从anal??ogRead()读取的数据可能不准确。
不要在AREF引脚上使用使用任何小于0V或超过5V的外部电压。如果你使用AREF引脚上的电压作为基准电压,你在调用analogRead()前必须设置参考类型为EXTERNAL。否则,你将会削短有效的基准电压(内部产生)和AREF引脚,这可能会损坏您Arduino板上的单片机。
另外,您可以在外部基准电压和AREF引脚之间连接一个5K电阻,使你可以在外部和内部基准电压之间切换。请注意,总阻值将会发生改变,因为AREF引脚内部有一个32K电阻。这两个电阻都有分压作用。所以,例如,如果输入2.5V的电压,最终在在AREF引脚上的电压将为2.5 * 32 /(32 + 5)= 2.2V。

analogRead()
从指定的模拟引脚读取数据值。 Arduino板包含一个6通道(Mini和Nano有8个通道,Mega有16个通道),10位模拟数字转换器。这意味着它将0至5伏特之间的输入电压映射到0至1023之间的整数值。这将产生读数之间的关系:5伏特/ 1024单位,或0.0049伏特(4.9 mV)每单位。输入范围和精度可以使用analogReference()改变。 它需要大约100微秒(0.0001)来读取模拟输入,所以最大的阅读速度是每秒10000次。
analogRead(PIN)
引脚:从输入引脚(大部分板子从0到5,Mini和Nano从0到7,Mega从0到15)读取数值,返回从0到1023的整数值
例子:
int analogPin = 3; //电位器(中间的引脚)连接到模拟输入引脚3
//另外两个引脚分别接地和+5 V
int val = 0; //定义变量来存储读取的数值
void setup()
{
serial.begin(9600); //设置波特率(9600)
}
void loop()
{
val = analogRead(analogPin); //从输入引脚读取数值
serial.println(val); //显示读取的数值
}

analogWrite() – PWM
analogWrite(pin,value)
从一个引脚输出模拟值(PWM)。可用于让LED以不同的亮度点亮或驱动电机以不同的速度旋转。analogWrite()输出结束后,该引脚将产生一个稳定的特殊占空比方波,直到下次调用analogWrite()(或在同一引脚调用digitalRead()或digitalWrite())。PWM信号的频率大约是490赫兹。
在大多数arduino板(ATmega168或ATmega328),只有引脚3,5,6,9,10和11可以实现该功能。在aduino Mega上,引脚2到13可以实现该功能。老的Arduino板(ATmega8)的只有引脚9、10、11可以使用analogWrite()。在使用analogWrite()前,你不需要调用pinMode()来设置引脚为输出引脚。
analogWrite函数与模拟引脚、analogRead函数没有直接关系。
pin:用于输入数值的引脚。
value:占空比:0(完全关闭)到255(完全打开)之间。
例子:
int ledPin = 9; // LED连接到数字引脚9
int analogPin = 3; //电位器连接到模拟引脚3
int val = 0; //定义变量存以储读值
void setup()
{
pinMode(ledPin,OUTPUT); //设置引脚为输出引脚
}
void loop()
{
val = analogRead(analogPin); //从输入引脚读取数值
analogWrite(ledPin,val / 4); // 以val / 4的数值点亮LED(因为analogRead读取的数值从0到1023,而analogWrite输出的数值从0到255)
}

高级 I/O
tone()
在一个引脚上产生一个特定频率的方波(50%占空比)。持续时间可以设定,否则波形会一直产生直到调用noTone()函数。该引脚可以连接压电蜂鸣器或其他喇叭播放声音。
在同一时刻只能产生一个声音。如果一个引脚已经在播放音乐,那调用tone()将不会有任何效果。如果音乐在同一个引脚上播放,它会自动调整频率。
使用tone()函数会与3脚和11脚的PWM产生干扰(Mega板除外)。
注意:如果你要在多个引脚上产生不同的音调,你要在对下一个引脚使用tone()函数前对此引脚调用noTone()函数。
tone(pin, frequency)
tone(pin, frequency, duration)
pin:要产生声音的引脚
frequency: 产生声音的频率,单位Hz,类型unsigned int
duration:声音持续的时间,单位毫秒(可选),类型unsigned long

noTone()
停止由tone()产生的方波。如果没有使用tone()将不会有效果。
noTone(pin)
pin: 所要停止产生声音的引脚

shiftOut()
将一个数据的一个字节一位一位的移出。从最高有效位(最左边)或最低有效位(最右边)开始。依次向数据脚写入每一位,之后时钟脚被拉高或拉低,指示刚才的数据有效。
注意:如果你所连接的设备时钟类型为上升沿,你要确定在调用shiftOut()前时钟脚为低电平,如调用digitalWrite(clockPin, LOW)。
注意:这是一个软件实现;Arduino提供了一个硬件实现的SPI库,它速度更快但只在特定脚有效。
shiftOut(dataPin, clockPin, bitOrder, value)
dataPin:输出每一位数据的引脚(int)
clockPin:时钟脚,当dataPin有值时此引脚电平变化(int)
bitOrder:输出位的顺序,最高位优先或最低位优先
value: 要移位输出的数据(byte)
dataPin和clockPin要用pinMode()配置为输出。 shiftOut目前只能输出1个字节(8位),所以如果输出值大于255需要分两步。
//最高有效位优先串行输出
int data= 500;
//移位输出高字节
shiftOut(dataPin, clock, MSBFIRST, (data >> 8));
//移位输出低字节
shiftOut(data, clock, MSBFIRST, data);
//最低有效位优先串行输出
data = 500;
//移位输出低字节
shiftOut(dataPin, clock, LSBFIRST, data);
//移位输出高字节
shiftOut(dataPin, clock, LSBFIRST, (data >> 8));
例子:
相应电路,查看tutorial on controlling a 74HC595 shift register
//引脚连接到74HC595的ST_CP
int latchPin = 8;
//引脚连接到74HC595的SH_CP
int clockPin = 12;
// //引脚连接到74HC595的DS
int dataPin = 11;
void setup() {
//设置引脚为输出
pinMode(latchPin, OUTPUT);
pinMode(clockPin, OUTPUT);
pinMode(dataPin, OUTPUT);
}
void loop() {
//向上计数程序
for(J = 0; J <256; J + +){ //传输数据的时候将latchPin拉低 digitalWrite(latchpin, LOW); shiftOut(dataPin,clockPin,LSBFIRST,J); //之后将latchPin拉高以告诉芯片 //它不需要再接受信息了 digitalWrite(latchpin, HIGH); delay(1000); } } shiftIn() 将一个数据的一个字节一位一位的移入。从最高有效位(最左边)或最低有效位(最右边)开始。对于每个位,先拉高时钟电平,再从数据传输线中读取一位,再将时钟线拉低。 注意:这是一个软件实现;Arduino提供了一个硬件实现的SPI库,它速度更快但只在特定脚有效。 shiftIn(dataPin,clockPin,bitOrder) dataPin:输出每一位数据的引脚(int) clockPin:时钟脚,当dataPin有值时此引脚电平变化(int) bitOrder:输出位的顺序,最高位优先或最低位优先 pulseIn() 读取一个引脚的脉冲(HIGH或LOW)。例如,如果value是HIGH,pulseIn()会等待引脚变为HIGH,开始计时,再等待引脚变为LOW并停止计时。返回脉冲的长度,单位微秒。如果在指定的时间内无脉冲函数返回。 此函数的计时功能由经验决定,长时间的脉冲计时可能会出错。计时范围从10微秒至3分钟。(1秒=1000毫秒=1000000微秒) pulseIn(pin, value) pulseIn(pin, value, timeout) pin:你要进行脉冲计时的引脚号(int)。 value:要读取的脉冲类型,HIGH或LOW(int)。 timeout (可选):指定脉冲计数的等待时间,单位为微秒,默认值是1秒(unsigned long) 返回:脉冲长度(微秒),如果等待超时返回0(unsigned long) 例子: int pin = 7; unsigned long duration; void setup() { pinMode(pin, INPUT); } void loop() { duration = pulseIn(pin, HIGH);; } 时间 millis() 返回Arduino开发板从运行当前程序开始的毫秒数。这个数字将在约50天后溢出(归零) 例子: unsigned long time; void setup(){ Serial.begin(9600); } void loop(){ serial.print("Time:"); time = millis(); //打印从程序开始到现在的时间 serial.println(time); //等待一秒钟,以免发送大量的数据 delay(1000); } 参数 millis 是一个无符号长整数,试图和其他数据类型(如整型数)做数学运算可能会产生错误 micros() 返回 Arduino 开发板从运行当前程序开始的微秒数。这个数字将在约70分钟后溢出(归零)。在 16MHz 的 Arduino 开发板上(比如 Duemilanove 和 Nano),这个函数的分辨率为四微秒(即返回值总是四的倍数)。在 8MHz 的 Arduino 开发板上(比如 LilyPad),这个函数的分辨率为八微秒。 注意 :每毫秒是1,000微秒,每秒是1,000,000微秒。 例子: unsigned long time; void setup(){ Serial.begin(9600); } void loop(){ Serial.print(“Time:”); time = micros(); //打印从程序开始的时间 Serial.println(time); //等待一秒钟,以免发送大量的数据 delay(1000); } delay() 使程序暂停设定的时间(单位毫秒)。(一秒等于1000毫秒) 参数:ms:暂停的毫秒数(unsigned long) 例子: ledPin = 13 / / LED连接到数字13脚 void setup() { pinMode(ledPin, OUTPUT); // 设置引脚为输出 } void loop() { digitalWrite(ledPin, HIGH); // 点亮LED delay(1000); // 等待1秒 digitalWrite(ledPin, LOW); // 灭掉LED delay(1000); // 等待一秒 } 虽然创建一个使用delay()的闪烁LED很简单,并且许多例子将很短的delay用于消除开关抖动,delay()确实拥有很多显著的缺点。在delay函数使用的过程中,读取传感器值、计算、引脚操作均无法执行,因此,它所带来的后果就是使其他大多数活动暂停。其他操作定时的方法请参加millis()函数和它下面的例子。大多数熟练的程序员通常避免超过10毫秒的delay(),除非arduino程序非常简单。 但某些操作在delay()执行时任然能够运行,因为delay函数不会使中断失效。通信端口RX接收到得数据会被记录,PWM(analogWrite)值和引脚状态会保持,中断也会按设定的执行。 delayMicroseconds() 使程序暂停指定的一段时间(单位微秒)。一毫秒等于一千微秒,一秒等于1000000微秒。 目前,能够产生的最大的延时准确值是16383。这可能会在未来的Arduino版本中改变。对于超过几千微秒的延迟,你应该使用delay()代替。 例子: int outPin = 8; // digital pin 8 void setup() { pinMode(outPin,OUTPUT); //设置为输出的数字管脚 } void loop() { digitalWrite(outPin,HIGH); //设置引脚高电平 delayMicroseconds(50); // 暂停50微秒 digitalWrite(outPin, LOW); // 设置引脚低电平 delayMicroseconds(50); // 暂停50微秒 } 数学运算 min() max() abs() constrain(x,a,b)【将一个数约束在一个范围内】 map(value, fromLow, fromHigh, toLow, toHigh) value:需要映射的值 fromLow:当前范围值的下限 fromHigh:当前范围值的上限 toLow:目标范围值的下限 toHigh:目标范围值的上限 例子: void setup(){} void loop() { int val = analogRead(0); val = map(val, 0, 1023, 0, 255); analogWrite(9, val); } 数学实现 long map(long x, long in_min, long in_max, long out_min, long out_max) { return (x - in_min) * (out_max - out_min) / (in_max - in_min) + out_min; } pow(base, exponent) sqrt(x) 三角函数 sin() cos() tan() 随机数 randomSeed()【随机数种子】 random()【random(max),random(min, max)】 位操作 lowByte() 取一个变量(例如一个字)的低位(最右边)字节。 highByte() 提取一个字节的高位(最左边的),或一个更长的字节的第二低位。 bitRead() 读取一个数的位。bitRead(x, n) X:想要被读取的数 N:被读取的位,0是最重要(最右边)的位 该位的值(0或1) bitWrite() 在位上写入数字变量 bitWrite(x, n, b) X:要写入的数值变量 N:要写入的数值变量的位,从0开始是最低(最右边)的位 B:写入位的数值(0或1) bitSet() 为一个数字变量设置一个位 bitSet(x, n) X:想要设置的数字变量 N:想要设置的位,0是最重要(最右边)的位 bitClear() 清除一个数值型数值的指定位(将此位设置成 0) bitClear(x, n) X:指定要清除位的数值 N:指定要清除位的位置,从0开始,0 表示最右端位 bit() 计算指定位的值(0位是1,1位是2,2位4,以此类推) bit(n) 需要计算的位 设置中断函数 attachInterrupt() attachInterrupt(interrupt, function, mode) 当发生外部中断时,调用一个指定函数。当中断发生时,该函数会取代正在执行的程序。大多数的Arduino板有两个外部中断:0(数字引脚2)和1(数字引脚3)。 arduino Mege有四个外部中断:数字2(引脚21),3(20针),4(引脚19),5(引脚18) interrupt:中断引脚数 function:中断发生时调用的函数,此函数必须不带参数和不返回任何值。该函数有时被称为中断服务程序。 mode:定义何时发生中断以下四个contstants预定有效值: LOW 当引脚为低电平时,触发中断 CHANGE 当引脚电平发生改变时,触发中断 RISING 当引脚由低电平变为高电平时,触发中断 FALLING 当引脚由高电平变为低电平时,触发中断. 当中断函数发生时,delya()和millis()的数值将不会继续变化。当中断发生时,串口收到的数据可能会丢失。你应该声明一个变量来在未发生中断时储存变量。 在单片机自动化程序中当突发事件发生时,中断是非常有用的,它可以帮助解决时序问题。一个使用中断的任务可能会读一个旋转编码器,监视用户的输入。 如果你想以确保程序始终抓住一个旋转编码器的脉冲,从来不缺少一个脉冲,它将使写一个程序做任何事情都要非常棘手,因为该计划将需要不断轮询的传感器线编码器,为了赶上脉冲发生时。其他传感器也是如此,如试图读取一个声音传感器正试图赶上一按,或红外线槽传感器(照片灭弧室),试图抓住一个硬币下降。在所有这些情况下,使用一个中断可以释放的微控制器来完成其他一些工作。 例子: int pin = 13; volatile int state = LOW; void setup() { pinMode(pin, OUTPUT); attachInterrupt(0, blink, CHANGE); } void loop() { digitalWrite(pin, state); } void blink() { state = !state; } detachInterrupt() 关闭给定的中断 detachInterrupt(interrupt) interrupt: 中断禁用的数(0或者1) 开关中断 interrupts() 重新启用中断(使用noInterrupts()命令后将被禁用)。中断允许一些重要任务在后台运行,默认状态是启用的。禁用中断后一些函数可能无法工作,并传入信息可能会被忽略。中断会稍微打乱代码的时间,但是在关键部分可以禁用中断 noInterrupts() 禁止中断(重新使能中断interrupts())。中断允许在后台运行一些重要任务,默认使能中断。禁止中断时部分函数会无法工作,通信中接收到的信息也可能会丢失。 中断会稍影响计时代码,在某些特定的代码中也会失效 例子: void setup() void loop() { noInterrupts(); //关键的、时间敏感的代码放在这 interrupts(); //其他代码放在这 } 通讯 Serial 用于Arduino控制板和一台计算机或其他设备之间的通信。所有的Arduino控制板有至少一个串口(又称作为UART或USART)。它通过0(RX)和1(TX)数字引脚经过串口转换芯片连接计算机USB端口与计算机进行通信。因此,如果你使用这些功能的同时你不能使用引脚0和1作为输入或输出。 您可以使用Arduino IDE内置的串口监视器与Arduino板通信。点击工具栏上的串口监视器按钮,调用begin()函数(选择相同的波特率)。 Arduino Mega 有三个额外的串口:Serial 1使用19(RX)和18(TX),Serial 2使用17(RX)和16(TX),Serial3使用15(RX)和14(TX)。 若要使用这三个引脚与您的个人电脑通信,你需要一个额外的USB转串口适配器,因为这三个引脚没有连接到Mega上的USB转串口适配器。若要用它们来与外部的TTL串口设备进行通信,将TX引脚连接到您的设备的RX引脚,将RX引脚连接到您的设备的TX引脚,将GND连接到您的设备的GND。(不要直接将这些引脚直接连接到RS232串口;他们的工作电压在+/- 12V,可能会损坏您的Arduino控制板。) Arduino Leonardo板使用Serial 1通过0(RX)和1(TX)与viaRS-232通信,。Serial预留给使用Mouse and Keyboard libarariies的USB CDC通信 。更多信息,请参考Leonardo 开始使用页和硬件页。 函数: if (Serial) 表示指定的串口是否准备好 在Leonardo上,if(Serial)表示不论有无USB CDC,串行连接都是开放的。对于所有其他的情况,包括Leonardo上的if(Serial1),将一直返回true。 这来自于 Arduino 1.0.1 版本的介绍 对于所有的arduino板: if (Serial) Arduino Leonardo 特有: if (Serial1) Arduino Mega 特有: if (Serial1) if (Serial2) if (Serial3) available() 获取从串口读取有效的字节数(字符)。这是已经传输到,并存储在串行接收缓冲区(能够存储64个字节)的数据。 available()继承了 Stream类 Serial.available() 仅适用于Arduino Mega : Serial1.available() Serial2.available() Serial3.available() 例子: incomingByte = 0; //传入的串行数据 void setup() { Serial.begin(9600); // 打开串行端口,设置传输波特率为9600 bps } void loop() { //只有当你接收到数据时才会发送数据,: if (Serial.available() > 0) {
//读取传入的字节:
incomingByte = Serial.read();
//显示你得到的数据:
Serial.print(“I received: “);
Serial.println(incomingByte, DEC);
}
}

begin()
将串行数据传输速率设置为位/秒(波特)。与计算机进行通信时,可以使用这些波特率:300,1200,2400,4800,9600,14400,19200,28800,38400,57600或115200。当然,您也可以指定其他波特率 – 例如,引脚0和1和一个元件进行通信,它需要一个特定的波特率
Serial.begin(speed) 仅适用于Arduino Mega : Serial1.begin(speed) Serial2.begin(speed) Serial3.begin(speed)
speed: 位/秒 (波特) – long

end()
停用串行通信,使RX和TX引脚用于一般输入和输出。要重新使用串行通信, 需要 Serial.begin()语句
Serial.end()
仅适用于Arduino Mega: Serial1.end() Serial2.end() Serial3.end()

find()
Serial.find() 从串行缓冲器中读取数据,直到发现给定长度的目标字符串。如果找到目标字符串,该函数返回true,如果超时则返回false
Serial.flush() 继承了 Stream 类
Serial.find(target)
target : 要搜索的字符串(字符)

findUntil()
Serial.findUntil()从串行缓冲区读取数据,直到找到一个给定的长度或字符串终止位。
如果目标字符串被发现,该函数返回true,如果超时则返回false。
Serial.findUntil()继承了Stream类。
Serial.findUntil(target, terminal)
target : 要搜索的字符串(char) terminal : 在搜索中的字符串终止位 (char)

flush()
等待超出的串行数据完成传输。(在1.0及以上的版本中,flush()语句的功能不再是丢弃所有进入缓存器的串行数据。)
flush()继承了Stream类
Serial.flush()
仅 Arduino Mega 可以使用的语法:
Serial1.flush()
Serial2.flush()
Serial3.flush()

parseFloat()
查找传入的串行数据流中的下一个有效的浮点数。 parseFloat()继承了Stream类
Serial.parseFloat()
仅适用于Arduino Mega:
Serial1.parseFloat()
Serial2.parseFloat()
Serial3.parseFloat()

parseInt()
查找传入的串行数据流中的下一个有效的整数。 parseInt()继承了Stream类
Serial.parseInt()
仅适用于Arduino Mega:
Serial1.parseInt()
Serial2.parseInt()
Serial3.parseInt()

peek()
返回传入的串行数据的下一个字节(字符),而不是进入内部串行缓冲器调取。也就是说,连续调用 peek()将返回相同的字符,与调用read()方法相同。peek()继承自 Stream类
Serial.peek()
仅适用于Arduino Mega :
Serial1.peek()
Serial2.peek()
Serial3.peek()

print()
以人们可读的ASCII文本形式打印数据到串口输出。此命令可以采取多种形式。每个数字的打印输出使用的是ASCII字符。浮点型同样打印输出的是ASCII字符,保留到小数点后两位。Bytes型则打印输出单个字符。字符和字符串原样打印输出。Serial.print()打印输出数据不换行,Serial.println()打印输出数据自动换行处理。例如
Serial.print(78)输出为“78”
Serial.print(1.23456)输出为“1.23”
Serial.print(“N”)输出为“N”
Serial.print(“Hello world.”)输出为“Hello world.”
也可以自己定义输出为几进制(格式);可以是BIN(二进制,或以2为基数),OCT(八进制,或以8为基数),DEC(十进制,或以10为基数),HEX(十六进制,或以16为基数)。对于浮点型数字,可以指定输出的小数数位。例如
Serial.print(78,BIN)输出为“1001110”
Serial.print(78,OCT)输出为“116”
Serial.print(78,DEC)输出为“78”
Serial.print(78,HEX)输出为“4E”
Serial.println(1.23456,0)输出为“1”
Serial.println(1.23456,2)输出为“1.23”
Serial.println(1.23456,4)输出为“1.2346”
你可以通过基于闪存的字符串来进行打印输出,将数据放入F()中,再放入Serial.print()。例如 Serial.print(F(“Hello world”)) 若要发送一个字节,则使用 Serial.write()

Serial.print(val)
Serial.print(val,格式)
val:打印输出的值 – 任何数据类型
格式:指定进制(整数数据类型)或小数位数(浮点类型)
例子:
int x = 0; // 定义一个变量并赋值
void setup() {
Serial.begin(9600); // 打开串口传输,并设置波特率为9600
}
void loop() {
//打印标签
Serial.print(“NO FORMAT”); // 打印一个标签
Serial.print(“\t”); // 打印一个转义字符
Serial.print(“DEC”);
Serial.print(“\t”);
Serial.print(“HEX”);
Serial.print(“\t”);
Serial.print(“OCT”);
Serial.print(“\t”);
Serial.print(“BIN”);
Serial.print(“\t”);
for(x=0; x< 64; x++){ // 打印ASCII码表的一部分, 修改它的格式得到需要的内容 //打印多种格式: Serial.print(x); // 以十进制格式将x打印输出 - 与 "DEC"相同 Serial.print("\t"); // 横向跳格 Serial.print(x, DEC); // 以十进制格式将x打印输出 Serial.print("\t"); // 横向跳格 Serial.print(x, HEX); // 以十六进制格式打印输出 Serial.print("\t"); // 横向跳格 Serial.print(x, OCT); // 以八进制格式打印输出 Serial.print("\t"); // 横向跳格 Serial.println(x, BIN); // 以二进制格式打印输出 // 然后用 "println"打印一个回车 delay(200); // 延时200ms } Serial.println(""); // 打印一个空字符,并自动换行 } println() 打印数据到串行端口,输出人们可识别的ASCII码文本并回车 (ASCII 13, 或 '\r') 及换行(ASCII 10, 或 '\n')。此命令采用的形式与Serial.print ()相同 Serial.println(val) Serial.println(val, format) val: 打印的内容 - 任何数据类型都可以 format: 指定基数(整数数据类型)或小数位数(浮点类型) 例子: int analogValue = 0; // 定义一个变量来保存模拟值 void setup() { //设置串口波特率为9600 bps: Serial.begin(9600); } void loop() { //读取引脚0的模拟输入: analogValue = analogRead(0); //打印g各种格式: Serial.println(analogValue); //打印ASCII编码的十进制 Serial.println(analogValue, DEC); //打印ASCII编码的十进制 Serial.println(analogValue, HEX); //打印ASCII编码的十六进制 Serial.println(analogValue, OCT); //打印ASCII编码的八进制 Serial.println(analogValue, BIN); //打印一个ASCII编码的二进制 // 延时10毫秒: delay(10); } read() 读取传入的串口的数据。read() 继承自 Stream 类 serial.read() Arduino Mega独有: erial1.read() serial2.read() serial3.read() 例子: int incomingByte = 0; // 传入的串行数据 void setup() { Serial.begin(9600); // 打开串口,设置数据传输速率9600 } void loop() { // 当你接收数据时发送数据 if (Serial.available() > 0) {
// 读取传入的数据:
incomingByte = Serial.read();
//打印你得到的:
Serial.print(“I received: “);
Serial.println(incomingByte, DEC);
}
}

readBytes()
Serial.readBytes()从串口读字符到一个缓冲区。如果预设的长度读取完毕或者时间到了 (参见 Serial.setTimeout()),函数将终止.
Serial.readBytes()返回放置在缓冲区的字符数。返回0意味着没有发现有效的数据。
Serial.readBytes()继承自 Stream 类
Serial.readBytes(buffer, length)
buffer:用来存储字节(char[]或byte[])的缓冲区
length:读取的字节数(int)

readBytesUntil()
Serial.readBytesUntil()将字符从串行缓冲区读取到一个数组。如果检测到终止字符,或预设的读取长度读取完毕,或者时间到了 (参见 Serial.setTimeout())函数将终止。
Serial.readBytesUntil()返回读入数组的字符数。返回0意味着没有发现有效的数据。
Serial.readBytesUntil()继承自 Stream类
Serial.readBytesUntil(character, buffer, length)
character :要搜索的字符(char)
buffer :缓冲区来存储字节(char[]或byte[])
length:读的字节数(int)

setTimeout()
Serial.setTimeout()设置使用Serial.readBytesUntil() 或Serial.readBytes()时等待串口数据的最大毫秒值. 默认为1000毫秒。
Serial.setTimeout()继承自Stream 类
Serial.setTimeout(time)
time :以毫秒为单位的超时时间(long)

write()
写入二级制数据到串口。发送的数据以一个字节或者一系列的字节为单位。如果写入的数字为字符,需使用print()命令进行代替
Serial.write(val)
Serial.write(str)
Serial.write(buf, len)
Arduino Mega还支持:Serial1,Serial2,Serial3 (替代Serial)
val: 以单个字节形式发的值
str: 以一串字节的形式发送的字符串
buf: 以一串字节的形式发送的数组
len: 数组的长度
返回结果:
byte
write() 将返回写入的字节数,但是否使用这个数字是可选的

SerialEvent()

Stream

USB(仅适用于 Leonardo 和 Due)
键盘
鼠标

You can follow any responses to this entry through the RSS 2.0 feed. Responses are currently closed, but you can trackback from your own site.