Name: 在 Arduino IDE 中添加文件 (Adding a file in Arduino IDE)
Uploaded: 2025-05-24T05:42:25.000Z
Duration: 10 min 49 s

情態副詞

As I mentioned, Arduino is not only used in the Artmail context, but can also be utilized across various hardware platforms.

如前所述，Arduino 不僅用於 Artmail，還可用於各種硬件平臺。

Among these, there are Arduino-specific APIs and commands.

其中包括 Arduino 專用的應用程序接口和命令。

程度副詞

Aside from those commands, it's just like any regular C or C++ project.

除了這些命令外，它與任何普通的 C 或 C++ 項目一樣。

So, here I will show you how to add the desired header files or source code files while writing the code.

是以，在這裡我將向你展示如何在編寫代碼時添加所需的頭文件或源代碼文件。

First, let's assume that I will input the code to make the LED blink.

首先，假設我將輸入使 LED 閃爍的代碼。

First, you need to set the device as the output.

首先，您需要將設備設置為輸出。

This is an important step to ensure that the device functions correctly, once you have done that.

這是確保設備正常運行的重要步驟。

This might seem counterintuitive, but it is necessary for the following steps.

這似乎有違直覺，但對於以下步驟來說卻是必要的。

After turning it off, you can proceed to set it up in the desired manner.

關閉後，您就可以按所需方式進行設置了。

For instance, you can configure it to operate in a specific mode or adjust its settings to suit your needs.

例如，您可以將其配置為在特定模式下運行，或調整其設置以滿足您的需求。

Now, I will demonstrate how to set the blinking delay.

現在，我將演示如何設置閃爍延遲。

This is done by defining a macro constant, which in this case will be set to 0.5 seconds.

這是通過定義一個宏常量來實現的，在本例中將設置為 0.5 秒。

This means that the device will blink at intervals of half a second, providing a clear and consistent signal.

這意味著設備將以半秒的間隔閃爍，提供清晰一致的信號。

When setting values like this, if there are many macro constants being used, you can organize them in another header file and reference them in the main code.

在設置這樣的值時，如果要使用很多宏常量，可以將它們整理到另一個頭文件中，然後在主代碼中引用。

This approach helps in keeping the main code clean and more manageable.

這種方法有助於保持主代碼的整潔和易於管理。

In my case, I press the new tab button here and enter the file name below, then check settings.

在這種情況下，我按下這裡的新建標籤按鈕，然後輸入下面的文件名，然後檢查設置。

From there, you can copy the macro constants directly and input them here.

在這裡，您可以直接複製宏常量並將其輸入。

This way, you can organize the code more As a reference, I will create a function for this.

作為參考，我將為此創建一個函數。

I will call it the blink function, so that instead of just inputting values, I can make it more flexible by adding variables.

我將把它稱為 "閃爍 "函數，這樣就不只是輸入數值，還可以通過添加變量使其更加靈活。

The blink function will allow for more dynamic control over the values, making the code more adaptable to different scenarios.

閃爍功能將允許對數值進行更動態的控制，使代碼更能適應不同的場景。

For example, if you need to change the blink rate, you can simply adjust the variable rather than hard coding the value.

例如，如果需要更改閃爍率，只需調整變量即可，而無需對數值進行硬編碼。

This method not only saves time, but also reduces the risk of errors.

這種方法不僅能節省時間，還能降低出錯的風險。

Additionally, organizing macro constants in a separate header file makes it easier to maintain and update the code.

此外，在單獨的頭文件中組織宏常量也更便於維護和更新代碼。

If any changes are needed, you only have to update the header file and the changes will be reflected throughout the main code.

如果需要更改，只需更新頭文件，更改內容就會反映在整個主代碼中。

This practice is particularly useful in large projects where multiple files and constants are involved.

在涉及多個文件和常量的大型項目中，這種做法尤其有用。

By keeping the code organized and modular, you can improve readability and maintainability, which are crucial for long-term project success.

通過保持代碼的條理性和模塊化，可以提高可讀性和可維護性，這對項目的長期成功至關重要。

I created a function called blink() that makes the LED blink as many times as the variable you input.

我創建了一個名為 blink() 的函數，它能讓 LED 按照你輸入的變量閃爍多少次。

For example, it blinks 5 times, waits for about approximately 3 seconds, and successfully compiles without errors.

例如，它閃爍 5 次，等待約 3 秒鐘，然後成功編譯，沒有錯誤。

This is how I created this particular function in detail.

這就是我創建這個特殊函數的詳細過程。

However, if you are dealing with hardware components such as an LED light, a motor device, and a switch, all within one Arduino project, I prefer not to clutter up the main code with everything altogether.

不過，如果您要在一個 Arduino 項目中處理 LED 燈、電機設備和開關等硬件組件，我建議您不要把所有代碼都放在主代碼中。

Instead, I break it down into separate libraries for better organization.

相反，我將其分解成不同的庫，以便更好地組織。

The actual code for controlling each specific piece of hardware is contained within those individual libraries, while only what is necessary for initialization purposes and commands to control said hardware remains in the main code itself.

控制每個特定硬件的實際代碼都包含在這些單獨的庫中，而只有初始化和控制所述硬件的命令所需的代碼才保留在主代碼中。

For instance, in case of handling an LED specifically, I would create a separate dedicated library just for LEDs.

例如，如果要專門處理 LED，我會為 LED 創建一個單獨的專用庫。

Let me show you exactly how it's done step by step.

讓我一步步向你展示具體的操作方法。

First off, I'll create an initial header file specifically tailored towards managing our LED component, and then proceed from there.

首先，我將創建一個初始頭文件，專門用於管理我們的 LED 組件，然後再從頭開始。

This is now a header for the library, which means it serves as a crucial part of the library's structure and functionality.

它現在是圖書館的頭文件，這意味著它是圖書館結構和功能的重要組成部分。

A header file in a library is essential because it defines the interface to the library's functionality, making it easier for other parts of the program to interact with the library.

程序庫中的頭文件至關重要，因為它定義了程序庫功能的接口，使程序的其他部分更容易與程序庫交互。

Therefore, I will input it as macro constants, which are essentially predefined values that can be used throughout the code to ensure consistency and ease of maintenance.

是以，我將以宏常量的形式輸入，宏常量本質上是一種預定義值，可以在整個代碼中使用，以確保一致性和易於維護。

Macro constants are beneficial because they allow for easy updates and changes.

宏常量的好處是便於更新和更改。

If a value needs to be modified, it can be done in one place rather than throughout the entire code base.

如果需要修改一個值，可以在一個地方完成，而不是在整個代碼庫中。

Since Arduino is based on C++, a language that supports object-oriented programming and other advanced features, I will also input these macro constants.

由於 Arduino 以 C++ 為基礎，而 C++ 語言支持面向對象編程和其他高級功能，是以我也將輸入這些宏常量。

However, I will do it in C code, which is a procedural programming language that is simpler and more straightforward for this purpose.

不過，我將用 C 代碼來實現這一目的，因為 C 代碼是一種程序化編程語言，更加簡單明瞭。

Using C code for macro constants can be advantageous because it provides better control over the hardware and can lead to more efficient code execution.

在宏常量中使用 C 代碼可能更有優勢，因為這樣可以更好地控制硬件，並提高代碼執行效率。

Similarly, I will prefer to do it this way because it allows for better control and understanding of the code.

同樣，我也更願意這樣做，因為這樣可以更好地控制和理解代碼。

Earlier, I provided these macro constants here, but I will remove them and name them ledpin, then ledblink, and then lednip, and so on.

之前，我在這裡提供了這些宏常量，但我將刪除它們，並將其命名為 ledpin、ledblink 和 lednip，以此類推。

This naming convention helps in clearly identifying the purpose of each constant, making the code more readable and easier to debug.

這種命名約定有助於明確每個常量的用途，使代碼更易讀、更易調試。

By organizing the constants in this manner, we can ensure that the code remains clean and efficient, which is essential for the smooth operation of the library.

通過以這種方式組織常量，我們可以確保代碼保持簡潔高效，這對程序庫的順利運行至關重要。

Clean and efficient code is crucial because it reduces the likelihood of errors, makes the code base easier to maintain, and improves overall performance.

簡潔高效的代碼至關重要，因為它能降低出錯的可能性，使代碼庫更易於維護，並提高整體性能。

So, having created the header for our project, let's take a moment to first remove the existing settings that are currently in place.

是以，在為我們的項目創建了頁眉後，讓我們先花點時間移除當前的現有設置。

After that, we will proceed to make the LED header appear on the screen.

之後，我們將使 LED 燈頭出現在螢幕上。

This step is crucial as it ensures that the LED header is properly displayed and functions correctly.

這一步至關重要，因為它可以確保 LED 標頭正確顯示並正常工作。

Now, if you click the right tab over here, there is a delete option.

現在，如果你點擊右邊的標籤，這裡有一個刪除選項。

Press the delete key to remove the settings header file that was just added to your project.

按刪除鍵刪除剛剛添加到項目中的設置頭文件。

After you have done that, click here to open a new tab which will contain the ledc file.

完成後，單擊此處打開一個包含 ledc 文件的新標籤頁。

In addition to the ledc file, you will also find the led header file and the include arduino header file here.

除了 ledc 文件，您還可以在這裡找到 led 頭文件和 include arduino 頭文件。

Make sure to include the arduino header for the led header now.

現在請確保將 arduino 接頭包含在 LED 接頭中。

This step is crucial for the proper functioning of the led header file.

這一步對 led 頭文件的正常運行至關重要。

By following these steps, you ensure that all necessary files are correctly added and configured in your project.

通過這些步驟，可以確保在項目中正確添加和配置所有必要的文件。

Remember, the order of these actions is important to avoid any potential issues.

請記住，這些操作的順序對於避免任何潛在問題非常重要。

To simply call arduino commands here, you need to add the arduino header file.

要在這裡簡單地調用 arduino 命令，需要添加 arduino 頭文件。

In my particular case, as I had done earlier in the process, once everything is meticulously organized and set up in this specific manner, we will proceed to have the led blink here.

在我的具體案例中，就像我之前所做的那樣，一旦一切都按照這種特定的方式進行了精心組織和設置，我們就可以讓 LED 在這裡閃爍了。

The led should blink exactly five times, no more and no less.

指示燈應準確閃爍五次，不能多也不能少。

However, during my attempt, I encountered a compilation error.

不過，在嘗試過程中，我遇到了一個編譯錯誤。

The error message stated uint8t unknown type.

錯誤信息顯示 uint8t 類型未知。

This error typically occurs when the compiler does not recognize the uint8t type, which is supposed to represent an unsigned 8-bit integer.

這種錯誤通常發生在編譯器無法識別 uint8t 類型時，該類型本應表示無符號 8 位整數。

This type is often used in embedded systems programming to ensure that variables use a specific amount of memory.

這種類型通常用於嵌入式系統編程，以確保變量使用特定數量的內存。

The issue might be due to a missing library or an incorrect include statement in the code.

問題可能是由於代碼中缺少庫或包含語句不正確造成的。

To resolve this, one would need to ensure that the correct header files are such as stdint h, which defines uint8t.

要解決這個問題，需要確保使用正確的頭文件，例如定義了 uint8t 的 stdint h。

Additionally, it is important to check the compiler settings and make sure that it supports the C standard that includes this type definition.

此外，檢查編譯器設置並確保其支持包含該類型定義的 C 標準也很重要。

This kind of error can be quite common when working with different compilers or when porting code from one environment to another.

在使用不同的編譯器或將代碼從一個環境移植到另一個環境時，這種錯誤很常見。

It is always a good practice to double check the documentation and ensure that dependencies are correctly referenced in the project setup.

仔細檢查文檔並確保在項目設置中正確引用了依賴項，始終是一種良好的做法。

By addressing these potential issues, the compilation error can be resolved, allowing the LED to blink as intended.

通過解決這些潛在問題，編譯錯誤可以得到解決，從而使 LED 燈按照預期閃爍。

然後，在這裡對代碼進行了清理。

In the main code, we include the LED library and the LED header.

在主代碼中，我們包含了 LED 庫和 LED 頭文件。

Then, we only execute the initialization related to that library during the initial setup.

然後，我們只在初始設置時執行與該庫相關的初始化。

However, if you look at the code file, you'll see that we set the LED pin output, turn it off once, and then in the actual operation part, we simply call the commands.

不過，如果查看代碼文件，就會發現我們設置了 LED 引腳輸出，並關閉了一次，然後在實際操作部分，我們只需調用命令即可。

In reality, the LED code file handles the repetition based on the count, turning it on and off.

實際上，LED 代碼文件會根據計數來處理重複，打開或關閉它。

Additionally, the macro constants are managed separately in the header file.

此外，宏常量在頭文件中單獨管理。

This time, we explored adding files in the Arduino IDE.

這一次，我們探索在 Arduino IDE 中添加文件。

As I mentioned earlier, aside from the basic Arduino API and Arduino commands, the rest is the same as a typical C and C++ project.

正如我前面提到的，除了基本的 Arduino API 和 Arduino 命令外，其餘與典型的 C 和 C++ 項目相同。

It's just that adding headers and using source code is the same, even though it might be slightly different from the Visual Studio code, Visual Studio, or other C editors you are already using.

儘管與 Visual Studio 代碼、Visual Studio 或其他已在使用的 C 編輯器可能略有不同，但添加頭文件和使用源代碼是一樣的。

In the next session, I will further explain how to create libraries.

下一課，我將進一步講解如何創建庫。