如何将Arduino的ino文件分解成多个.h和.cpp工程文件

最新推荐文章于 2025-07-09 17:32:50 发布
原创 最新推荐文章于 2025-07-09 17:32:50 发布 · 置顶 · 2.3w 阅读 · 143 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#Arduino #C/C++

如何将Arduino的ino文件分解成多个.h和.cpp工程文件

当用Arduino做复杂工程项目时，程序难免会变得很大。这时候要修改个别参数或函数的时候会变得麻烦，简而言之，项目程序管理难度增高了，程序代码维护会变得困难。这时候，就产生了将一个ino文件分解成多个功能相对独立的源文件，这样就便于针对性的管理代码了。

1. 需要做的准备

不是所有的代码都方便分解成多个cpp文件进行管理的，特别是编程时想到哪编到哪的，代码会异常的凌乱。这意味着，里面的函数关系，逻辑嵌套，变量使用等都是极度凌乱的。这样的代码很难分解开来。因此，如果着手做的是一个相对大的项目，一开始便要有整体规划代码的意识。

  • 一是以功能需求对应各个子函数，尽量一个函数只完成一个功能，避免功能上的嵌套；
  • 二是变量定义要清晰。
    在对整体的代码有了比较清晰的规划后，便可以着手分解代码了。

2.功能函数代码的分解

首先，你需要在原来工程文件夹下新建一个头文件，如 config.h，然后将Arduino的硬件接口定义放在这里面。然后，按照功能划分，分别建立各个功能的cpp文件，如 motion.cpp 文件中放置定义了各种运动的函数。然后将各个函数的声明写到 config.h 中。（原来一个ino文件时，软件会自动加函数声明，但现在需要自己加了）如：void trun_left(int, int); 。其他各种功能也是如此。但个函数都划分成多个cpp文件后，就要来处理全局变量的问题了。

3.全局变量的声明

因为在一个地方定义的变量很可能在其他地方使用，因此，全局变量就很关键了。原涞单个ino文件时，只要在 setup() ,上面定义的变量都默认是全局变量，但现在不行了，需要自己在声明。操作方式如下：

  • 在任一cpp中定义你需要的变量，建议定义在最关键的地方。如
最低0.47元/天 解锁文章

200万优质内容无限畅学
Arduino怎样实现分文件编程。多文件编程，多个c文件
UnableJOE的博客
04-26 8478
本文介绍如何拆分多个文件来编译，文章后面包含一个实际案例。项目文件夹内，必须包含1个ino，1个.h文件，多个.cpp文件。
将Arduino的ino文件分解成多个.h和.cpp工程文件
2301_76213535的博客
06-12 1960
在完成上面的步骤后，你还需要除了ino文件外的各个文件里都包含 #include"Arduino.h",否则程序里的HIGH,LOW,OUTPUT,pinMode之类的将无法识别。此外，你的各个cpp文件应该加上头文件 #include“config.h”,不用<>,而用双引号的原因是尖括号引用的是标准库，而这里是自定义的头文件等。经过上述步骤后，你的程序将由一个包含了setup(),loop()函数的ino文件，一个头文件config.h, 以及许多实现各种功能的cpp文件。这样的代码很难分解开来。
在vscode 中用PlatformIO开发Arduino多文件编程
最新发布
2301_80926782的博客
07-09 309
基于Arduino在vscode 中用PlatformIO开发ESP32的模块化操作
物联网不能错过的Arduino(多个包文件)
06-25
有了这些资料集合，单片机开发差不多全了 不能错过的Arduino图书.pdf Arduino一试就上手（第2版）.pdf Arduino与树莓派哪个是更适合 - 推酷.pdf Arduino从基础到实践.pdf ARDUINO开发实战指南 AVR篇.pdf Arduino开源设计_吴义满.pdf ARDUINo玩转电子制作.pdf Arduino电子设计实战指南.零基础篇.pdf Arduino高级开发权威指南（原书第2版）.pdf 深入浅出AVR单片机.pdf Arduino - Graph.pdf e络盟针对工业物联网应用供应一体_省略_angOHGreen开源硬件平台_.pdf Marvell开源KinomaJS应用框架加速物联网行业成长_.pdf wifi模块简单使用教程，如何将数据发送到电脑（esp8266 arduino库的使用） wifi.pdf [ARDUINO.ANDROID互动智作].〔美〕Simon.Monk.科学出版社.扫描版(简体).pdf [ARDUINO技术内幕].[美].Dale.Wheat.翁恺.译.扫描版.pdf 用Arduino和Yeelink打造智能家居.pdf 中文语音引擎EKHO在Raspberrypi上的应用实例_薛凯.pdf 以大数据与物联网为基础的仿生设计方法_陈阳.pdf 华为推出基于开源的物联网操作系统_.pdf 在物联网时代_开源该怎么玩_本刊编辑部.pdf 基于Wi_FiSoC的物联网平台设计_纪亚萍.caj 基于开源硬件和物联网云平台的远程控制应用_林巧生.pdf 基于微信和Arduino家用物联网系统开发_薛毛毛.pdf 挑战树莓派：谁才是Geek最爱的开发板.pdf 极客DIY：利用Arduino制作智能家居系统 - FreeBuf.pdf 爱上Arduino.pdf 物联网革命的三个阶段（联接未联接的，生成智能的联接，复杂子系统的自治）.pdf
Arduino将代码分割成多个文件
arslan-robot
09-17 3058
Arduino单个功能的调试往往会把代码都写在ino文件的setup和loop方法中，现实中一款完整的产品会有很多功能组成，需要遵循一定的结构设计规则做到复用性、模块化、解耦等，将功能按一定规则分割成多个文件，在Arduino ide中我们可以创建多个h文件和c/cpp文件来合理的设计分割功能模块。
Arduino IDE工程代码多文件编程和中文设置
weixin_46158019的博客
03-22 4457
Arduino IDE原生支持C++，因此你可以使用C++的特性，如头文件（.h文件）和源文件（.cpp或.ino文件），来组织程序代码。注意，Arduino IDE主要使用.ino文件作为源文件，但你也可以使用.cpp文件，并在IDE中手动设置编译选项。在Arduino IDE中编译和上传，将所有文件放在同一个文件夹中，并在Arduino IDE中打开主.ino文件。在主文件中包含头文件：在主Arduino文件（通常是.ino文件）中，包含创建的头文件。这样就可以在主文件中调用在头文件中声明的函数了。
arduino 多个程序一起工作程序
10-26
arduino 多个程序一起工作程序
arduino工程文件分解成子文件
01-10
对于大型Arduino项目而言，将单个`.ino`文件拆分为多个源文件有助于提高代码可读性和维护性。具体方法如下： #### 创建主文件 创建一个主要的 `.ino` 文件作为项目的入口点，在此文件中定义 `setup()` 和 `loop()` ...
yoRadio.ino
03-24
需要展示如何将功能拆分到不同的文件中，比如Radio.h和Radio.cpp，并在主.ino文件中包含这些头文件。 需要注意确保代码语法正确，特别是使用$...$和$$...$$格式的行内和独立公式，但当前问题可能不涉及数学公式，...
关于Arduino创建工程，.cpp和.h文件创建方法以及多个.ino文件链接方法
量子陷阱的博客
04-07 1万+
关于Arduino创建工程，.cpp和.h文件创建方法以及多个.ino文件链接方法 .cpp文件只能是这个名字，不能是.c 可以直接创建多个.ino文件，不需要.cpp文件
玩转 ESP32 + Arduino (二十三) 多文件系统及全局变量
finedayforu的博客
09-18 4705
之前的工程, 我们一直把所有的代码写在一个文件里, 写在我们来将它们分开 以一个读取sht20的温湿度数据并在串口上打印为例: 我们的规划是这样的 设置一个 config.h文件, 所有的硬件定义, 公共变量 ,都放在这里面,(也可以分多个.h ,然后集中引用过来) main.ino 文件包含入口函数 setup() 具体的函数文件写具体的功能, 文件格式 .ino(不用.cpp) 如果有全局变...
2019Arduino.ino
07-24
Arduino应用编程练兵一 【1】功课做足，准备硬件背景知识： 【2】硬件背景了解后，是时候安装软件开始编程了： 【3】是时候体会Arduino应用编程的有趣了：
arduino编程手册中文版
01-10
arduino编程手册中文版带目录
Arduino怎么建立一个包含很多.h和.cpp文件的工程
fucingman的博客
11-29 5822
在.ino文件里首先引入建立的.cpp和.h文件，可以采用相对路径，.\表示与.ino同一目录下，…如下，在头文件声明后，就可以调用刚才写的display_init（）和display_sensor（）了。之前用keil的时候，共同实现一个功能.c和.h文件都会放在一个文件夹里，所以想arduino有没有这样的管理方法，现在确定是有的。现在建立一个文件夹screen，把screen.cpp和screen.h放在screen文件夹里。对于新建的screen.cpp和screen.h文件，首先要在头文件声明。
Ardunino——面向对象语言学习篇5——.h文件和.cpp文件(制作Arduino类库)
weixin_42645653的博客
02-20 1万+
学习自：太极创客。 实践是检验真理的唯一标准，通过arduino进行实践学习C++或许是一个不错的选择。 前篇回顾   前篇学习了构造函数与析构函数，总体来说就是对象创建和消失时候要执行得函数。 前提知识 arduino中类库一般包含以下三部分： 一、src文件夹：     .cpp文件(源文件):定义类库及其成员。     .h文件(头文件):声明类库及其成员。 二、examples文件夹： 三、keywords.txt 创建.h文件和.cpp文件   可发现随着功能不断的添加，程序代码变得越来越多，全部
利用visual studio打开arduino工程的文件.ino文件的正确方式
热门推荐
棒棒的博客
04-26 1万+
正常情况下，利用官方自带的arduino IDE打开工程文件是双击.ino文件： 但arduino IDE不太好用，想在visio studio2017打开这个工程，怎么办？？ 在visio studio安装好arduino插件后，如果直接双击.ino文件，试图打开整个工程结果是只会采用默认设置的arduino IDE打开，可以右键选择其他打开方式，打开的.ino文件。 但这样与之相关的头文件和c/cpp文件没有导入： 如何正确打开呢？ 1，打开——>Arduino Project 2,找到需
arduino i2c 如何写16位寄存器_Arduino只是拿来玩的？你错了！教你用它自制一个非常实用的小产品|智能灌溉控制器...
weixin_39873208的博客
11-11 315
利用动态水循环，具有下雨探测，日出探测功能，智能灌溉你的院子或花园。一定要看文章最后哦，结尾有惊喜！部件和材料 Arduino NANO开发板 1块IO扩展板 1块IO扩展模块包 1套app和在线服务 Arduino IDE项目背景使用Arduino创建智能灌溉控制器智能灌溉您的院子或花园用动态水循环。如果正在下雨，或者自从上次浇水后就已经下雨了，不要再给院子浇水...
生成一个arduino的library的.c和.h文件
06-25
<think>我们正在创建一个Arduino库，需要生成对应的.c和.h文件。在Arduino中，库通常包括一个头文件（.h）和一个实现文件（.cpp），而不是.c文件，因为Arduino核心使用C++。但如果你需要C语言的文件，也可以创建，不过Arduino库通常使用C++。以下我将按照标准的Arduino库结构（C++）进行说明。步骤：1.创建库的目录结构。2.编写头文件（.h）。3.编写实现文件（.cpp）。4.添加示例和文档（可选）。注意：在ArduinoIDE中，库的目录结构通常如下：MyLibrary/|--src/(可选，用于更复杂的库，将源代码放在这里)||--MyLibrary.h||--MyLibrary.cpp|--examples/(示例代码)|--keywords.txt(可选，用于语法高亮)|--library.properties(库的元数据)但最简单的库可以只有两个文件：MyLibrary.h和MyLibrary.cpp，放在一个名为MyLibrary的文件夹中。下面我们创建一个简单的库，名为"BlinkLED"，它包含一个类`BlinkLED`，用于控制LED的闪烁。第一步：创建头文件BlinkLED.h这个文件将包含类的声明。第二步：创建实现文件BlinkLED.cpp这个文件包含成员函数的实现。第三步：将这两个文件放入一个名为BlinkLED的文件夹中，然后将整个文件夹放入Arduino的libraries目录下（或者通过ArduinoIDE导入库）。具体代码：1.头文件BlinkLED.h：```cpp#ifndefBlinkLED_h#defineBlinkLED_h#include<Arduino.h>classBlinkLED{public:BlinkLED(intpin);//构造函数，参数是LED连接的引脚voidbegin();//初始化voidblink(intdelayTime);//闪烁，参数是亮灭的时间（毫秒）private:int_pin;//存储LED引脚};#endif```2.实现文件BlinkLED.cpp：```cpp#include"BlinkLED.h"BlinkLED::BlinkLED(intpin){_pin=pin;}voidBlinkLED::begin(){pinMode(_pin,OUTPUT);}voidBlinkLED::blink(intdelayTime){digitalWrite(_pin,HIGH);delay(delayTime);digitalWrite(_pin,LOW);delay(delayTime);}```3.使用这个库的示例：在BlinkLED库的目录下创建examples文件夹，然后在其中创建一个名为BlinkExample的文件夹，再创建一个BlinkExample.ino文件：```cpp#include<BlinkLED.h>//使用13号引脚（大多数Arduino板上的内置LED）BlinkLEDled(13);voidsetup(){led.begin();}voidloop(){led.blink(1000);//每秒闪烁一次}```4.如果需要，可以添加library.properties文件（在库的根目录）：```name=BlinkLEDversion=1.0.0author=YourNamemaintainer=YourName<your.email@example.com>sentence=AlibrarytoblinkanLED.paragraph=Supportssettingtheblinkinterval.category=DeviceControlurl=https://example.comarchitectures=*includes=BlinkLED.h```5.导入库：将整个BlinkLED文件夹放入Arduino安装目录下的libraries文件夹中，或者通过ArduinoIDE的“项目”->“加载库”->“添加.ZIP库”来添加。注意：如果你确实需要C语言的库（而不是C++），那么你可以创建.c和.h文件，但是Arduino环境主要使用C++，所以通常使用类来封装。如果你写的是C风格的库，那么头文件中应该声明函数（而不是类），并在.c文件中实现。例如，一个C风格的BlinkLED库：BlinkLED.h:```c#ifndefBLINKLED_H#defineBLINKLED_H#ifdef__cplusplusextern"C"{#endifvoidblinkLED_setup(intpin);voidblinkLED_blink(intpin,intdelayTime);#ifdef__cplusplus}#endif#endif```BlinkLED.c:```c#include"BlinkLED.h"#include<Arduino.h>voidblinkLED_setup(intpin){pinMode(pin,OUTPUT);}voidblinkLED_blink(intpin,intdelayTime){digitalWrite(pin,HIGH);delay(delayTime);digitalWrite(pin,LOW);delay(delayTime);}```然后在Arduino草图中这样使用：```cpp#include"BlinkLED.h"#defineLED_PIN13voidsetup(){blinkLED_setup(LED_PIN);}voidloop(){blinkLED_blink(LED_PIN,1000);}```但是，请注意，在Arduino中，即使是C风格的库，也需要用C++编译器编译，所以使用`extern"C"`来避免C++的名称修饰。根据你的需求选择C++风格或C风格。引用说明：上述引用[1]中提到了创建多个文件（music.h,music.c,music_arduino.cpp）的情况，这类似于我们这里创建的库文件。引用[3]提到了一些关于内存限制的内容，我们在设计库时也要考虑目标平台的内存限制。现在，根据你的需求，你可以按照上述步骤创建自己的库文件。相关问题：1.如何在Arduino库中实现多个类？2.如何为Arduino库编写示例代码？3.Arduino库中如何处理平台特定的代码（例如ESP32和AVR）？4.如何发布Arduino库到ArduinoLibraryManager？5.如何测试Arduino库？</think>### 创建 Arduino 库的步骤指南 在 Arduino 中创建自定义库需要生成 **.h**（头文件）和 **.cpp**（实现文件），遵循以下步骤： #### 1. **创建库目录结构** ```bash MyLibrary/ ├── src/ # 源代码目录（可选但推荐） │ ├── MyLibrary.h # 头文件 │ └── MyLibrary.cpp # 实现文件 ├── examples/ # 示例代码目录 │ └── BasicDemo/ # 示例项目 │ └── BasicDemo.ino ├── library.properties # 库元数据文件 └── keywords.txt # 语法高亮配置（可选） ``` #### 2. **编写头文件 (.h)** 在 `MyLibrary.h` 中声明类和方法： ```cpp // MyLibrary.h #pragma once #include <Arduino.h> class MyLibrary { public: // 构造函数 MyLibrary(int pin); // 方法声明 void begin(); int readValue(); private: int _pin; // 私有变量 }; ``` #### 3. **编写实现文件 (.cpp)** 在 `MyLibrary.cpp` 中实现功能： ```cpp // MyLibrary.cpp #include "MyLibrary.h" MyLibrary::MyLibrary(int pin) { _pin = pin; // 初始化引脚 } void MyLibrary::begin() { pinMode(_pin, INPUT); // 设置引脚模式 } int MyLibrary::readValue() { return analogRead(_pin); // 读取模拟值 } ``` #### 4. **关键配置** - **library.properties**（库元数据）： ```ini name=MyLibrary version=1.0.0 author=YourName maintainer=your@email.com sentence=Short description. paragraph=Longer description. category=Sensors # 如 Sensors, Display, Communication 等 architectures=* # 支持所有架构 ``` - **keywords.txt**（语法高亮）： ```txt MyLibrary KEYWORD1 begin KEYWORD2 readValue KEYWORD2 ``` #### 5. **安装与使用** 1. 将 `MyLibrary` 文件夹复制到 Arduino IDE 的 `libraries` 目录（路径：`文档/Arduino/libraries`） 2. 重启 Arduino IDE 3. 在示例中调用库： ```cpp // BasicDemo.ino #include <MyLibrary.h> MyLibrary sensor(A0); // 实例化对象 void setup() { sensor.begin(); // 初始化 } void loop() { int val = sensor.readValue(); // 调用方法 } ``` ### 注意事项 1. **命名规范**： - 头文件使用 `.h`，实现文件使用 `.cpp`（Arduino 核心是 C++） - 类名与文件名保持一致（如 `MyLibrary.h` → `class MyLibrary`） 2. **内存优化**： - 避免全局变量，优先使用类成员变量[^3] - 精简代码，尤其针对内存有限的设备（如 Arduino Uno） 3. **兼容性**： - 使用 `#ifdef` 处理平台差异（例如 ESP32 与 AVR）： ```cpp #ifdef ESP32 // ESP32 专用代码 #endif ``` ### 常见问题解决 - **库未找到**：检查 `library.properties` 格式和库路径 - **编译错误**：确保 `.h` 和 `.cpp` 中的类名一致 - **内存不足**：简化代码逻辑，减少动态内存分配[^3] > 示例参考了 Arduino 官方库结构[^1]和 ESP32 摄像头库的实现方式[^2]。 --- ### 相关问题 1. 如何为 Arduino 库添加第三方依赖项？ 2. Arduino 库中如何实现中断处理？ 3. 如何将 Arduino 库发布到官方库管理器？ 4. 跨平台（ESP32/AVR）库开发需要注意什么？ 5. 如何通过 Arduino 库操作硬件寄存器？
评论 7
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值