如何使用 C++ 创建自定义 Arduino 库

如果你需要在 Arduino 项目中使用自己编写的库，那么本教程将为你提供创建自定义 Arduino 库的步骤和技巧。

1. 创建库

首先需要创建一个新的 Arduino 库。你可以在 Arduino IDE 中使用“新建库”命令，也可以手动创建一个新的文件夹并添加一个名为 library.properties 的文件，library.properties 文件格式如下：

name=YOUR_LIBRARY_NAME
version=YOUR_LIBRARY_VERSION
author=YOUR_NAME
maintainer=YOUR_NAME
sentence=WHAT_YOUR_LIBRARY_DOES
paragraph=EXTENDED_DESCRIPTION
category=YOUR_CATEGORY
url=YOUR_GITHUB_HOME_PAGE
architectures=avr

2. 添加库文件

在库文件夹中，你需要创建头文件和源代码文件。库头文件应该命名为与库一样的名称，代码文件可以按照需要命名。

如下是一个例子：

// MyLibrary.h

#ifndef MyLibrary_h
#define MyLibrary_h

#include "Arduino.h"

class MyLibrary {
  public:
    void begin(); // 函数声明
    void doSomething();
  private:
    int _value; // 私有变量
};

#endif

// MyLibrary.cpp

#include "MyLibrary.h"

void MyLibrary::begin() {
  // 初始化
}

void MyLibrary::doSomething() {
  // 实现
}

3. 编写库的示例程序

库的示例程序可以帮助用户更好的理解如何使用自定义库，你需要在库文件夹中添加一个名为 examples 的文件夹，并在其中编写示例程序，示例程序文件要拓展名为 .ino。

示例程序代码如下：

#include "MyLibrary.h"

MyLibrary myLibrary;

void setup() {
  myLibrary.begin();
}

void loop() {
  myLibrary.doSomething();
}

4. 使用库

要使用自己编写的库，你需要将库文件夹放置在你的 Arduino IDE 的“libraries”文件夹下。之后你就能在 Arduino IDE 的“示例”菜单下找到你的库，并且可以在你的项目中使用它。

如下是一个例子：

#include "MyLibrary.h"

MyLibrary myLibrary;

void setup() {
  myLibrary.begin();
}

void loop() {
  myLibrary.doSomething();
}

结论

现在你已经学会了如何自定义创建Arduino 库，在自己的项目中使用它。希望这篇文章对你有所帮助。