ardunio中自定义的库文件

news2024/10/6 5:58:21

1、Arduino的扩展库都是放在 libraries目录下的。完整路径为：C:\Users\41861\AppData\Local\Arduino15\libraries

所以我们需要在这个目录下创建一个文件夹，比如上面的例子是esp32上led灯控制程序，于是我创建了 m_led文件夹（前面加m是为了和官方库区分开，这只是我自己的习惯而已）。然后把写好的.cpp 和 .h文件拷贝到里面去，这样就OK了。

或者（把led.h和led.cpp复制到C:\Users\41861\AppData\Local\Arduino15\packages\esp32\hardware\esp32\2.0.6\cores\esp32路径下。不推荐这种写法，因为这种方法会跟系统库文件混合在一起，不方便管理）

2、编写led.h文件

/*******************
LED.h

*******************/

#ifndef _LED_H__
#define _LED_H__
//导入Arduino核心头文件
#include"Arduino.h"  

class LED
{
     private:
          byte pin;        //控制led使用的引脚
     
     public:
          LED(byte p , bool state=LOW );   //构造函数
          ~LED();          //析构函数
          byte getPin();   //获取控制的引脚          
          void on();      //打开LED
          void off();     //关闭LED
          bool getState();  //获取LED状态
          void disattach(); //释放引脚与LED的绑定，使得引脚可以控制其他的东西

};
#endif

3、编写led.cpp文件：

/*****************
LED.cpp

******************/

#include"LED.h"
#include"Arduino.h"

LED::LED(byte p,bool state):pin(p)
{  
   pinMode(pin,OUTPUT);
   digitalWrite(pin,state);
}
LED::~LED()
{
    disattach();
}         
void LED::on()
{
    digitalWrite(pin,HIGH);
}
void LED::off()
{
   digitalWrite(pin,LOW);
}

bool LED::getState()
{
    return digitalRead(pin);
}
void LED::disattach()        //引脚回收，恢复到上电状态
{
    digitalWrite(pin,LOW);
    pinMode(pin,INPUT);
}

4、创建一个my_led.ino文件(ardunio主文件名以.ino结尾)。在该文件中可以直接使用自定义的库了，引入自定义的库头文件 #inclue <led.h>

#include<led.h> //注意，由于LED控制模块已经是标准库了，所以使用尖括号<> 包含

LED led(7);
byte count =0;

void setup() {
   Serial.begin(9600);
}

void loop() {
   if(count<10){
     led.on();
     delay(300);
     Serial.println(led.getState(),DEC);
     
     led.off();
     delay(300);
     Serial.println(led.getState(),DEC);
     
     ++count;
     if(count==10)
        led.disattach();
   }
}

跟led.cpp 、 led.h 一起有个 keywords.txt文件，这个是什么用呢？其实它没有太大的实用性，只是为了配置自定义库的语法高亮。让我们自己的库能在IDE下显示不同的颜色而已。如果不配置，Arduino IDE不能渲染出颜色的。