Arduino入门教程—补充二 如何编写扩展库

AllBlue

如何编写扩展库

Arduino扩展库的使用可以使得代码变的更简洁，编程也当然会更加容易。今天我们就学习一下如何编写一个属于自己的Arduino扩展库！！

首先，我们看一段代码：

1. int pin = 13;
   
2. 
   
3. void setup()
   
4. {
   
5.   pinMode(pin, OUTPUT);
   
6. }
   
7. 
   
8. void loop()
   
9. {
   
10.   dot(); dot(); dot();
    
11.   dash(); dash(); dash();
    
12.   dot(); dot(); dot();
    
13.   delay(3000);
    
14. }
    
15. 
    
16. void dot()
    
17. {
    
18.   digitalWrite(pin, HIGH);
    
19.   delay(250);
    
20.   digitalWrite(pin, LOW);
    
21.   delay(250);
    
22. }
    
23. 
    
24. void dash()
    
25. {
    
26.   digitalWrite(pin, HIGH);
    
27.   delay(1000);
    
28.   digitalWrite(pin, LOW);
    
29.   delay(250);
    
30. }

复制代码

在控制板运行它，它作用就是，控制板上的13脚连接的LED闪烁，发出SOS的求救信号！

了解这段代码后，就让我们来将它改写成函数库吧！！

一般扩展库包含几个文件：头文件（扩展名为*.h*），源代码文件（扩展名为*.cpp*）和关键字文件（.txt文件），有时候还会添加一个测试程序，如下图（图为Arduino官方扩展库EEPROM）：

好的，下面我们就来一步步实现它吧！第一步：编写头文件，创建一个.h文件（可以直接用Arduino IDE 创建，创建时要加后缀名，不然默认为pde格式）并命名为Morse.h，然后添加以下代码：

1. /*
   
2.   在这里加上一些关于作者、用途、日期、协议等注释
   
3.   例如：
   
4.     Morse.h — 用于多个LED闪烁变化的库。
   
5.     2013.7创建，创建者：TSRobot
   
6.     公共领域
   
7. */
   
8. #ifndef Morse_h //防止多次引用头文件
   
9. #define Morse_h
   
10. 
    
11. #include "Arduino.h"
    
12. 
    
13. class Morse
    
14. {
    
15.   public:        //共有部分
    
16.     Morse(int pin);
    
17.     void dot();
    
18.     void dash();
    
19. 
    
20.   private:        //私有部分(用户无权使用)
    
21.     int _pin;
    
22. };
    
23. 
    
24. #endif

复制代码

接下来，第二步：编写源代码文件，创建一个.cpp 文件并命名为Morse.cpp，添加以下代码：

1. /*
   
2.   在这里加上一些关于作者、用途、日期、协议等注释
   
3.   例如：
   
4.     Morse.cpp — 用于多个LED闪烁变化的库。
   
5.     2013.7创建，创建者：TSRobot
   
6.     公共领域
   
7. */
   
8. 
   
9. #include "Arduino.h"
   
10. #include "Morse.h"
    
11. 
    
12. Morse::Morse(int pin)        //构造函数
    
13. {
    
14.   pinMode(pin, OUTPUT);
    
15.   _pin = pin;        //保存为私有变量，以便下面的函数调用
    
16. }
    
17. 
    
18. //工作方式，和直接写的代码很相似，只是名字有区别
    
19. void Morse::dot()
    
20. {
    
21.   digitalWrite(_pin, HIGH);
    
22.   delay(250);
    
23.   digitalWrite(_pin, LOW);
    
24.   delay(250);  
    
25. }
    
26. 
    
27. void Morse::dash()
    
28. {
    
29.   digitalWrite(_pin, HIGH);
    
30.   delay(1000);
    
31.   digitalWrite(_pin, LOW);
    
32.   delay(250);
    
33. }

复制代码

第三步：写出关键字，创建一个keywords.txt文件，添加如下关键字：

       Morse   KEYWORD1

       dash    KEYWORD2

       dot     KEYWORD2

其中最关键的是：每行关键字的后面跟的是Tab键（而不是空格）；关键字的作用其实就是然软件认识这个字，然后以特别的颜色显示出来，如下图：

下面就将这三个文件保存到一个名为Morse的文件夹中，然后将它放到Arduino文件夹的library文件夹中，然后从新启动软件，这样库文件就可以使用了。

下面，我们就来调用一下它：

1. #include <Morse.h>
   
2. 
   
3. Morse morse(13);
   
4. 
   
5. void setup()
   
6. {
   
7. }
   
8. 
   
9. void loop()
   
10. {
    
11.   morse.dot(); morse.dot(); morse.dot();
    
12.   morse.dash(); morse.dash(); morse.dash();
    
13.   morse.dot(); morse.dot(); morse.dot();
    
14.   delay(3000);
    
15. }

复制代码

上面的程序和之前的程序功能上是相同的，大家可以对比一下有何不同；

当然如果你还想添加别的引脚，也是可以的，只要再创建一个构造函数就可以了，例如：

1. Morse morse(13);
   
2. Morse morse2(12);

复制代码

这样的话，12引脚也就可以使用了，使用下面代码后，_pin就变为12脚了：

1. morse2.dot()

复制代码

大家也可以将上面调用的例子，保存在刚才的文件夹中，这样别人使用你的库文件时，就会大概了解用法了哦~~~

官方教程地址：
Writing a Library for Arduino

cys

学习了，受益。

AllBlue

cys 发表于 2015-6-24 17:07
学习了，受益。

多谢支持

tiantianyouyou

编写扩展库，这个很好，学习了