❤️❤️❤️Arduino语法手册 完整版

Arduino该程序可分为结构、变量(变量与常量)、函数三个主要部分。

结构部分

2.1 if 2.2 if...else 2.3 for 2.4 switch case 2.5 while 2.6 do... while 2.7 break 2.8 continue 2.9 return 2.10 goto 

3.1;（分号） 3.2 (}(花括号) 3.3// (单行注释) 3.4/* */ (多行注释) 

5.1==（等于） 5.2 !=（不等于） 5.3 < （小于） 5.4 > （大于） 5.5 <=(小于等于) 5.6 >=(大于等于) 

6.1 && （与） 6.2|| （或） 

7.1*取消引用运算符 7.2 &引用运算符 

8.1 & （bitwise and） 8.2 | （bitwise or） 8.3 A （bitwise xor） 8.4 ~ （bitwise not） 8.5 ?（bitshift left） 8.6 ?（bitshift right） 

9.1    （increment） 9.2 - （decrement） 9.3  = （compound addition） 9.4 -= （compound subtraction） 9.5 *= （compound multiplication） 9.6 /= （compound division） 9.6 &= （compound bitwise and） 9.8 |= （compound bitwise or） 

变量部分

10.1 HIGH 1 LOW (引脚电压定义) 10.2 INPUT|OUTPUT （数字引脚（Digital 

11.1 void 11.2 boolean （布尔） 113 char (有号数据类型) 11.4 unsigned char (无符号数据类型) 11.5 byte (无符号数) 11.6 int （整型） 11.7unsigned int (无符号整形) 

函数部分

二十四、开关中断

24.1interrupts()(中断)
24.2nolnterrupts()(禁止中断)

二十五、通讯

25.1Serial
25.1.1if (Serial)
25.1.2Serial.available()
25.1.3SeriaLbegin()
25.1.4Serial.end()
25.1.5Serial.find()
25.1.6Serial.findUntil()
25.1.7Serial.flush()
25.1.8Serial.parseFloat()
25.1.9Serial.parselntf)
25.1.10Serial.peekO
25.1.11Serial.printO
25.1.12Serial.println()
25.1.13Serial.read()
25.1.14Serial.readBytes()
25.1.15Serial.readBytesUntil()
25.1.16Serial.setTimeout()
25.1.17Serial.write()
25.1.18Serial.SerialEvent()
25.2Stream

二十六、USB(仅适用于Leonardo和Due)

26.1Mouse (键盘)
26.2Keyboard (鼠标)

结构部分

一、结构

int buttonPin = 3;
void setup()
(
Serial.begin(9600);
pinMode(buttonPin, INPUT);
}
void loop()
(
//...
}

int buttonPin = 3; //setup中初始化串口和按键针脚.
void setup))
{ 
        
beginSerial(9600);
pinModefbuttonPin, INPUT);
}
//loop中每次都检査按钮，如果按钮被按下，就发送信息到串口
void loop()
{ 
        
if (digitalRead(buttonPin) == HIGH)
serialWriteCH');
else
serialWrite('L');
delay(lOOO);
二、结构控制
2.1 if

if (x > 120) digitalWrite(LEDpin, HIGH);
if (x > 120)
digitalWrite(LEDpinz HIGH);
if (x > 120)( digitalWrite(LEDpin, HIGH);}
if (x > 120){ 
        
digitalWrite(LEDpinlz HIGH);
digitalWrite(LEDpin2, HIGH);
}	//以上所有书写方式都正确

if (pinFivelnput < 500)
(
//执行A操作
}
else
(
//执行B操作
}

if (pinFivelnput < 500)
(
//执行A操作
}
else if (pinFivelnput >= 1000)
{ 
        
//执行B操作
}
else
(
//执行C操作
}

for(int x = 2;x< 100; x = x* 1.5)(
println(x);
生成：2,3,4,6,9,13,19,28,42,63,94 另一个例子，使用for循环使LED产生渐亮渐灭的效果：
void loop()
{ 
        
int x = l;
for (int i = 0; i > -1; i = i + x)
(
analogWrite(PWMpin/ i);
if(i == 255) x = -1;	//在峰值转变方向
delay(lO);
)
}

switch (var) (
case 1:
〃当var等于1时，执行一些语句
break;
case 2
〃当var等于2时，执行一些语句
break;
default:
〃如果没有任何匹配，执行default
//default可有可不有
}

switch (var) (
case label:
//声明
break;
case label:
//声明
break;
default:
//声明

参数
var:用于与下面的case中的标签进行比较的变量值
label:与变量进行比较的值
2.5 while
while循环
描述
while循环会无限的循环，直到括号内的判断语句变为假。必须要有能改变判断语句的 东西，要不然while循环将永远不会结束。这在您的代码表现为一个递增的变量，或一个外 部条件，如传感器的返回值。
语法
while(表达){
〃语句
}
参数
表达：为真或为假的一个计算结果
例子
var = 0;
while(var < 200)(
〃重复一件事200遍
var++
}
2. 6 do… while
do-while循环与while循环运行的方式是相近的，不过它的条件判断是在每个循环的 最后，所以这个语句至少会被运行一次，然后才被结束。
do
(
〃语句
Jwhile (测试条件);
例子

do
{ 
        
delay(50);〃等待传感器稳定
X = readSensors ( ) ; //检査传感器取值
Jwhile (X<100); 〃当x小于100时，继续运行

2. 7 break
   break用于退出do, for, while循环，能绕过一般的判断条件。它也能够用于退出switch 语句。
   例子

for (x = 0;x< 255; x ++)
{ 
        
digitalWrite(PWMpin/ x);
sens = analogRead(sensorPin);
if (sens>threshold)( // 超出探测范围
x = 0;
break;
}
delay(50);
}

2.8 continue
continue语句跳过当前循环中剩余的迭代部分(do, for或while )。它通过检査循环 条件表达式，并继续进行任何后续迭代。
例子

for (x = 0; x < 255; x ++)
(
if(x>40 &&x<120)(	//当x在40与120之间时，跳过后面两句，即迭代。
continue;
}
digitalWrite(PWMpin, x);
delay(50);
}

2. 9 return
   终止一个函数，如有返回值，将从此函数返回给调用函数。
   语法
   return;
   return value; //两种形式均可
   参数
   value：任何变量或常量的类型
   例子
   一个比较传感器输入阈值的函数

int checkSensor()(
if (analogRead(O) > 400) (
return 1;}
else(
return 0;
}
}

return关键字可以很方便的测试一段代码，而无需“comment out(注释掉)”大段的可 能存在bug的代码。
void loop(){
〃写入漂亮的代码来测试这里。
return;
〃剩下的功能异常的程序
//return后的代码永远不会被执行
}
2. 10 goto
程序将会从程序中已有的标记点开始运行 语法
label:
goto label; 〃从label处开始运行
提示
不要在C语言中使用goto编程，某些C编程作者认为goto语句永远是不必要的，但用 得好，它可以简化某些特定的程序。许多程序员不同意使用goto的原因是，通过毫无节制 地使用goto语句，很容易创建一个程序，这种程序拥有不确定的运行流程，因而无法进行 调试。
的确在有的实例中goto语句可以派上用场，并简化代码。例如在一定的条件用if语句 来跳出高度嵌入的for循环。
例子

for(byte r = 0; r < 255; r++)(
for(byte g = 255; g > -1; g-){ 
        
for(byte b = 0; b < 255; b++){ 
        
if (analogRead(O) > 250)(
goto bailout;
}
〃更多的语句...
}
}
}

bailout:
三、扩展语法
3.1:(分号)
用于表示一句代码的结束。
例子
int a = 13;
提示
在每一行忘记使用分号作为结尾，将导致一个编译错误。错误提示可能会清晰的指向缺 少分号的那行，也可能不会。如果弹出一个令人费解或看似不合逻辑的编译器错误，第一件 事就是在错误附近检査是否缺少分号。
3.2()(花括号)
大括号(也称为“括号”或“大括号”)是c编程语言中的一个重要组成部分。它们被 用来区分几个不同的结构，下面列出的，有时可能使初学者混乱。
左大括号“{”必须与一个右大括号“}”形成闭合。这是一个常常被称为括号平衡的条 件。在Arduino IDE (集成开发环境)中有一个方便的功能来检査大括号是否平衡。只需选 择一个括号，甚至单击紧接括号的插入点，就能知道这个括号的“伴侣括号”。
目前此功能稍微有些错误，因为IDE会经常会认为在注释中的括号是不正确的。
对于初学者，以及由BASIC语言转向学习C语言的程序员，经常不清楚如何使用括号。 毕竟，大括号还会在” return函数”、“endif条件句”以及“loop函数”中被使用到。
由于大括号被用在不同的地方，这有一种很好的编程习惯以避免错误：输入一个大括号 后，同时也输入另一个大括号以达到平衡。然后在你的括号之间输入回车，然后再插入语句。 这样一来，你的括号就不会变得不平衡了。
不平衡的括号常可导致许多错误，比如令人费解的编译器错误，有时很难在一个程序找 到这个错误。由于其不同的用法，括号也是一个程序中非常重要的语法,如果括号发生错误， 往往会极大地影响了程序的意义。
大括号中的主要用途
功能

void myfunction(datatype argument)(
statements(s)
}
循环
while (boolean expression)
{ 
        
statement(s)
}
do
{ 
        
statement(s)
}
while (boolean expression);
for (initialisation; termination condition; incrementing expr)
statement(s)
}

条件语句

if (boolean expression)
{ 
        
statement(s)
}
else if (boolean expression)
(
statement(s)
}
else
{ 
        
statement(s)
}

3.3// (单行注释)
Comments (注释)
注释用于提醒自己或他人程序是如何工作的。它们会被编译器忽略掉，也不会传送给处 理器，所以它们在Atmega芯片上不占用体积。注释的唯一作用就是使你自己理解或帮你 回忆你的程序是怎么工作的或提醒他人你的程序是如何工作的。编写注释有两种写法： 例子
x = 5; 〃这是一条注释斜杠后面本行内的所有东西是注释
/*这是多行注释■用于注释一段代码
if(gwb == 0)( //在多行注释内可使用单行注释
x = 3; /*但不允许使用新的多行注释■这是无效的
}
//别忘了注释的结尾符号■它们是成对出现的！
/
小提示
当测试代码的时候，注释掉一段可能有问题的代码是非常有效的方法。这能使这段代码 成为注释而保留在程序中，而编译器能忽略它们。这个方法用于寻找问题代码或当编译器提 示出错或错误很隐蔽时很有效。
3.4/ */ (多行注释)
Comments (注释)
注释用于提醒自己或他人程序是如何工作的。它们会被编译器忽略掉，也不会传送给处 理器，所以它们在Atmega芯片上不占用体积。注释的唯一作用就是使你自己理解或帮你 回忆你的程序是怎么工作的或提醒他人你的程序是如何工作的。编写注释有两种写法： 例子
x = 5; 〃这是一条注释斜杠后面本行内的所有东西是注释
/*这是多行注释■用于注释一段代码
if(gwb == 0)( //在多行注释内可使用单行注释
x = 3; /*但不允许使用新的多行注释■这是无效的
}
//别忘了注释的结尾符号■它们是成对出现的！
*/
小提示
当测试代码的时候，注释掉一段可能有问题的代码是非常有效的方法。这能使这段代码 成为注释而保留在程序中，而编译器能忽略它们。这个方法用于寻找问题代码或当编译器提 示出错或错误很隐蔽时很有效。
3. 5 ttdefine
#define是一个很有用的C语法，它允许程序员在程序编译之前给常量命名。在Arduino 中，定义的常量不会占用芯片上的任何程序内存空间。在编译时编译器会用事先定义的值来 取代这些常量。
然而这样做会产生一些副作用，例如，一个己被定义的常量名己经包含在了其他常量名 或者变量名中。在这种情况下，文本将被#defined定义的数字或文本所取代。
通常情况下，优先考虑使用const关键字替代ftdefine来定义常量。
Arduino拥有和C相同的语法规范。
语法
#define常量名 常量值 注意，#是必须的。
例子
#define ledPin 3
〃在编译时，编译器将使用数值3取代任何用到ledPin的地方。
提示
在#define声明后不能有分号。如果存在分号，编译器会抛出语义不明的错误，甚至关 闭页面。
#define ledPin 3; 〃这是一种错误写法
类似的，在#define声明中包含等号也会产生语义不明的编译错误从而导致关闭页面。
#define ledPin = 3 〃这是一种错误写法
3.6 ^include
include用于调用程序以外的库。这使得程序能够访问大量标准C库，也能访问用于 arduino的库。AVR C库(Arduino基于AVR标准语法)语法手册请点击这里。注意#include 和ftdefine -样，不能在结尾加分号，如果你加了分号编译器将会报错。
例子
此例包含了一个库，用于将数据存放在flash空间内而不是ram内。这为动态内存节约 了空间，大型表格査表更容易实现。
#include
prog_uintl6_t myConstants[] PROGMEM = {0, 21140, 702 , 9128, 0, 25764, 8456, 0,0,0,0,0,0,0,0,29810,8968,29762,29762,4500};
四、算数运算符
4.1 =（赋值运算符）
=赋值运算符（单等号）
赋值运算符（单等号）
将等号右边的数值赋值给等号左边的变量
在c语言中，单等号被称为赋值运算符，它与数学上的等号含义不同，赋值运算符告诉 单片机，将等号的右边的数值或计算表达式的结果，存储在等号左边的变量中。
例子
int sensVal; //声明一个名为sensVal的整型变量
senVal = analogRead （0）; 〃将模拟引脚。的输入电压存储在SensVal变量中 编程技巧
要确保赋值运算符（=符号）左侧的变量能够储存右边的数值。如果没有大到足以容纳 右边的值，存储在变量中的值将会发生错误。
不要混淆赋值运算符冋（单等号）与比较运算符［==］（双等号），认为这两个表达式是 相等的。
4. 2 + （加）
加，减，瓶除
描述
这些运算符返回两个操作数的和，差，乘积，商。这些运算是根据操作数的数据类型来计算 的，比如9和4都是int类型，所以9 / 4结果是2.这也就代表如果运算结果比数据类型所能 容纳的范围要大的话，就会出现溢出（例如.1加上一个整数int类型32,767结果变成 .32,768）。如果操作数是不同类型的，结果是”更大”的那种数据类型。如果操作数中的其中 一个是float类型或者double类型，就变成了浮点数运算。
例子

y = y + 3；
x = x - 7;
i=j*6;
r=r/5;
Syntax
result = valuel + value2;
result = valuel - value2;
result = valuel * value2;
result = valuel / value2;
Parameters:

valuel:任何常量或者变量，value2:任何常量或者变量
编程小提示
整型常量的默认值是int类型，所以一些整型常量（定义中）的计算会导致溢出.（比如：60 * 1000会得到一个负数结果.那么if（60*1000> 0） ,if得到的是一个false值。
在选择变量的数据类型时，一定要保证变量类型的范围要足够大，以至于能容纳下你的运 算结果。
要知道你的变量在哪个点会”翻身”，两个方向上都得注意.如:（0-1）或（0–32768）
一些数学上的分数处理，要用浮点数，但其缺点是:占用字节长度大,运算速度慢。
使用类型转换符，例如（int）myFloat将一个变量强制转换为int类型。
4.3 -（减）
详见4.2+ （加）
4. 4 * （乘）
详见4.2+ （加）
4.5/ （除）
详见4.2+ （加）
4.6% （取模）
描述
一个整数除以另一个数，其余数称为模。它有助于保持一个变量在一个特定的范围（例 如数组的大小）。
语法
结果=被除数％除数
参数
被除数：一个被除的数字
除数：一个数字用于除以其他数
返回
余数（模）
举例

X = 7%5;//X 为 2
X = 9%5； //X 为 4
X = 5%5； //X 为。
X = 4%5； //X 为 4

示例代码
/通过循环计算1到10的模/

int values[10];
int i = 0;
void setup （） { 
        
}
void loop（）
{ 
        
values [i] = analogRead （0）;
i= （i + 1） %10;〃取模运算
}

提示
模运算符对浮点数不起作用。
五、比较运算符
5.1 (等于)
if (条件判断语句)和、！=、<、> (比较运算符)
if语句与比较运算符一起用于检测某个条件是否达成,如某输入值是否在特定值之上等。 if语句的语法是：
if (someVariable > 50)
(
//执行某些语句
}
本程序测试someVariable变量的值是否大于50。当大于50时，执行一些语句。换句 话说，只要if后面括号里的结果(称之为测试表达式)为真，则执行大括号中的语句(称 之为执行语句块)；若为假，则跳过大括号中的语句。if语句后的大括号可以省略。若省略 大括号，则只有一条语句(以分号结尾)成为执行语句。

if (x > 120) digitalWritefLEDpin, HIGH);
if (x > 120)
digitalWrite(LEDpinz HIGH);
if (x > 120)( digitalWrite(LEDpin, HIGH);}
if (x > 120){ 
        
digitalWrite(LEDpinlz HIGH);
digitalWrite(LEDpin2, HIGH);
}	//以上所有书写方式都正确

在小括号里求值的表达式，需要以下操作符：
比较运算操作符：

• x==y (x 等于 y)
• x!=y (x不等于y)
• x< y (x 小于 y)
• x> y (x 大于 y)
• x<=y (x小于等于y)
• x>=y (x大于等于y)

警告
注意使用赋值运算符的情况(如if (x = 10))o 一个“=”表示的是赋值运算符，作用是 将x的值设为10 (将值10放入x变量的内存中)。两个表示的是比较运算符(如if (x== 10)),用于测试x和10是否相等。后面这个语句只有x是10时才为真，而前面赋 值的那个语句则永远为真。
这是因为C语言按以下规则进行运算if (x=10)： 10赋值给x (只要非0的数赋值的 语句，其赋值表达式的值永远为真)，因此x现在值为10。此时if的测试表达式值为10, 该值永远为真，因为非0值永远为真。所以，if(x = 10)将永远为真，这就不是我们运行if 所期待的结果。另外，x被赋值为10,这也不是我们所期待的结果。
if的另外一种分支条件控制结构是if…else形式。
5.2!=（不等于） 详见5.1==（等于）
5.3< （小于）
详见5.1==（等于）
5.4> （大于）
详见5.1=（等于）
5.5<=（小于等于） 详见5.1==（等于）
5.6>=（大于等于）
详见5.1==（等于）
六、布尔运算符
6.1 && （与）
布尔运算符
这些运算符可以用于if条件句中。
&& （逻辑与）
只有两个运算对象为“真”，才为“真”，如：

if （digitalRead⑵==HIGH && digitalRead⑶==HIGH）{ 
         // 读取两个开关的电平
//...
}

如果当两个输入都为高电平，则为“真”。
II （逻辑或）
只要一个运算对象为“真”，就为“真”，如：

if（x>0||y>0）{ 
        
//...
}

如果x或v是大于0,则为“真”。
!（逻辑非）
如果运算对象为“假”，则为“真”，例如

if（!x）{ 
        
//...
}

如果X为“假”，则为真（即如果x等于0）。
警告
千万不要误以为，符号为&（单符号）的位运算符”与”就是布尔运算符的“与”符号为
&& （双符号）。他们是完全不同的符号。
同样，不要混淆布尔运算符II （双竖）与位运算符“或”符号为I （单竖）。
位运算符~ （波浪号）看起来与布尔运算符not有很大的差别！（正如程序员说：“惊叹 号”或“bang”）,但你还是要确定哪一个运算符是你想要的。
举例

if （a >= 10 && a <= 20）{ 
        } 〃如果a的值在10至20之间，则为“真”

6.2 || （或）
详见6.1&& （与）
6.3 !（非）
详见6.1&& （与）
七、指针运算符
7.1取消引用运算符
指针运算符
& （取地址）和（取地址所指的值）
指针对C语言初学者来说是一个比较复杂的内容，但是编写大部分arduino代码时可以 不用涉及到指针。然而，操作某些数据结构时，使用指针能够简化代码，但是指针的操作知 识很难在工具书中找到，可以参考C语言相关工具书。
7.2&引用运算符
详见7.1*取消引用运算符
八、位运算符
8. 1 & （按位与）
按位与（&）
按位操作符对变量进行位级别的计算。它们能解决很多常见的编程问题。下面的材料大 多来自这个非常棒的按位运算指导。
说明和语法
下面是所有的运算符的说明和语法。进一步的详细资料，可参考教程。
按位与（&）
位操作符与在C + +中是一个&符，用在两个整型变量之间。按位与运算符对两侧的变量 的每一位都进行运算，规则是：如果两个运算元都是1,则结果为1,否则输出0.另一种表 达方式：
00 11运算元1
0101运算元2
0001 （运算元1&运算元2） ■返回结果
在Arduino中，int类型为16位，所以在两个int表达式之间使用&会进行16个并行按
位与计算。代码片段就像这样：

inta= 92;	〃二进制：0000000001011100
int b = 101;	// 二进制：0000000001100101
int c = a & b; // 结果： 0000000001000100,或 10 进制的 68

a和b的16位每位都进行按位与计算，计算结果存在c中，二进制结果是01000100, 十进制结果是68.
按位与最常见的作用是从整型变量中选取特定的位，也就是屏蔽。见下方的例子。 按位或(|)
按位或操作符在C++中是| °和&操作符类似，|操作符对两个变量的为一位都进行运算, 只是运算规则不同。按位或规则：只要两个位有一个为1则结果为1,否则为0o换句话说:
0011运算元1
0101运算元2
0111 (运算元1 |运算元2)-返回的结果
这里是一个按位或运算在C + +代码片段：

inta= 92;	〃二进制:0000000001011100
intb = 101;	〃二进制：0000000001100101
int c = a | b; // 结果： 0000000001111101,或十进制的 125

示例程序
按位与和按位或运算常用于端口的读取■修改•写入。在微控制器中，一个端口是一个8 位数字，它用于表示引脚状态。对端口进行写入能同时操作所有引脚。
PORTD是一个内置的常数，是指0,123,4,5,6,7数字引脚的输出状态。如果某一位为1, 着对应管脚为HIGH。(此引脚需要先用pinMode()命令设置为输出)因此如果我们这样写， PORTD=B00110001；则引脚2、3、7状态为HIGH。这里有个小陷阱，我们可能同时更改了 引脚0、1的状态，引脚0、1是Arduino串行通信端口，因此我们可能会干扰通信。
我们的算法的程序是：
读取PORT并用按位与清除我们想要控制的引脚
用按位或对PORTD和新的值进行运算

inti;	〃计数器
intj;
void setup()
DDRD = DDRD | B11111100; 〃设置引脚 2~7 的方向，0、1 脚不变(xx|00==xx)
〃效果和pinMode(pin,OUTPUT)设置2~7脚为输出一样
serial.begin (9600);
}
void loop ()	{ 
        
for (i=0; i<64; i++){ 
        
PORTD = PORTD & B00000011; 〃清除 2~7 位，0、1 保持不变(xx&ll==xx)
j = (i« 2);	〃将变量左移为• 2-7脚，避免0、1脚
PORTD = PORTD | j；	〃将新状态和原端口状态结合以控制LED脚
Serial.println(PORTD, BIN);// 输出掩盖以便调试
delay(lOO);
}

按位异或（八）
C++中有一个不常见的操作符叫按位异或，也叫做XOR （通常读作” eks-or“）。按位异 或操作符用’"表示。此操作符和按位或（| ）很相似，区别是如果两个位都为1则结果为0：
00 11运算元1
0101运算元2
0110 （运算元1人运算元2）-返回的结果
按位异或的另一种解释是如果两个位值相同则结果为0,否则为lo 下面是一个简单的代码示例：

intx = 12;	// 二进制:1100
inty = 10元器件数据手册、IC替代型号，打造电子元器件IC百科大全！