Arduino 巨集:完整指南(含範例)

  • Arduino 中的巨集可讓您在編譯之前優化程式碼和記憶體。
  • 使用#define 可讓您建立自適應函數、常數和結構。
  • 進階巨集可讓您連接識別碼並存取 PROGMEM。
  • 規範地使用宏可以提高效率,同時又不犧牲可讀性。

Arduino 核心 Zephyr OS beta-1

Arduino 的出現徹底改變了電子領域,因為它讓創建功能原型和專案變得輕而易舉。然而,對於那些想要進一步提升程式設計技能、優化資源、保持程式碼簡潔並提高效率的人來說,巨集就成了關鍵工具。

本文將深入探討Arduino 中巨集的使用:巨集的定義、使用方法、優點和限制。我們將匯集來自最佳線上資源的全面實用訊息,並以清晰易懂、與時俱進的方式重新撰寫,力求使其真正具有實用價值。

Arduino 中的巨集是什麼?

巨集是 C/C++ 中的預處理器指令,允許你在程式碼編譯之前替換文字。與傳統函數執行指令不同,巨集會取代部分原始程式碼,從而直接影響最終二進位程式碼的產生方式。

預處理器在實際編譯之前運行,負責應用這些替換。在 Arduino 中,這允許您定義常數、有條件地包含文件,甚至創建節省時間和記憶體的小型內聯函數。

基本範例: 像這樣的定義 #define LED_PIN 13 導致所有代碼被自動替換 LED_PIN 由 13 編譯之前。

這看似微不足道,但它提供了一種編寫更靈活、更易於維護的程式碼的有效方法。

使用巨集的優點

在 Arduino 專案中實現巨集可以帶來許多具體的好處:

  • 提高程式碼可讀性: 透過重複使用符號名稱,可以更容易理解每​​個元素的用途。
  • 優化性能: 透過不產生函數調用,巨集可以更快地執行操作。
  • 減少記憶體使用量: 在資源有限的董事會中尤其有用,例如 Arduino UNO.
  • 允許有條件的調整: 根據所使用的 Arduino 板的類型,可以編譯不同的程式碼片段。

基本巨集:使用#define

#define指令是最常用的指令。它既可以用來定義常數值,也可以用來建立在預編譯時自動注入的函數。

範例 1:定義一個引腳

#define PINLED 13

void setup() {
  pinMode(PINLED, OUTPUT);
}

void loop() {
  digitalWrite(PINLED, HIGH);
  delay(500);
  digitalWrite(PINLED, LOW);
  delay(500);
}

範例 2:巨集作為內聯函數

int itemCounter = 0;
#define COUNT_ITEM() do { itemCounter++; } while(0)

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

void loop() {
  Serial.println(itemCounter);
}

如您所見,使用do { … } while(0)模式可確保即使在條件結構中使用宏,其行為也安全。

## 運算子和巨集連接

## 運算子是一個強大的預處理器工具,可用於連接識別碼。當需要動態產生變數名稱時,這非常有用。

實際示例:

#define GENERAR_VARIABLE(no) \
  int var##no = no;

void setup() {
  GENERAR_VARIABLE(3); // crea int var3 = 3
}

重要警告:此運算子並非與所有 Arduino 開發板型號完全相容。例如,它可能在 Uno 或 Esplora 上運作良好,但在 Mega 上則可能無法正常運作。此外,您不能直接使用 ## 在其他巨集中巢狀建立巨集。

巨集和記憶體節省

在 Arduino 中使用巨集的一個主要優點是節省 RAM。 Arduino的 RAM 容量有限,因此直接將文字字串載入到 RAM 中可能會成為一個嚴重的問題。

避免這種情況的一種高級技術是使用FORCE_INLINE並從程式記憶體 (PROGMEM) 載入字串:

#include <HardwareSerial.h>
#define MYSERIAL Serial
#define FORCE_INLINE __attribute__((always_inline)) inline

FORCE_INLINE void printFromFlash(const char *str) {
  char ch = pgm_read_byte(str);
  while (ch) {
    MYSERIAL.write(ch);
    ch = pgm_read_byte(++str);
  }
}

#define SERIAL_LOG(x) (MYSERIAL.print(x))
#define SERIAL_LOGLN(x) (MYSERIAL.println(x))

使用這些巨集可能會影響專案的正常運行,特別是在具有顯示器或多個感測器的應用程式中。

宏與函數結合

巨集也可以根據作為參數傳遞的類型來動態呼叫函數。一個清晰且非常生動的例子是:

#define FUNC_LENTA(tipo) \
  { funcion_##tipo##_lenta(); }

#define FUNC_RAPIDA(tipo) \
  { funcion_##tipo##_rapida(); }

void funcion_caminar_lenta() {
  Serial.println("Andando despacio");
}

void funcion_caminar_rapida() {
  Serial.println("Andando rápido");
}

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

void loop() {
  FUNC_RAPIDA(caminar);
}

多虧了 ## 運算子和宏,我們可以避免重複結構並集中動態邏輯。

帶有輸出參數的宏

也可以使用巨集來封裝小物件或轉換:

#define BOOL_OUT() (bool){false}
#define NUM_OUT(a,b) (float){a+b}
#define STR_OUT(msg) (String){msg}

void loop() {
  Serial.println(BOOL_OUT());
  Serial.println(NUM_OUT(1.2, 3.4));
  Serial.println(STR_OUT("Mensaje"));
}

使用宏的良好做法和預防措施

過度或不謹慎地使用宏會導致難以除錯的錯誤。例如,進行錯誤的替換或定義與外部庫名稱衝突的名稱。

避免問題的一些基本規則:

  • 避免不必要的空格或換行符 在宏內。
  • 不包括評論 在使用多行的複雜巨集中。
  • 使用唯一名稱 或使用前綴(例如項目名稱)以避免衝突。
  • 用真正的常數或函數取代宏 只要有可能。現代 C++ 允許更清潔、更安全的替代方案。

另一方面,過度使用宏會降低程式碼的清晰度。目標應該是在不影響可維護性的前提下提高效率和模組化。

條件指令和自適應編譯

可擴展專案中最實用的功能之一是使用巨集來有條件地產生程式碼,這在您希望同一個草圖在不同的電路板上運行時非常有用。

典型範例:

#ifdef ARDUINO_MEGA
  #define LEDPIN 53
#else
  #define LEDPIN 13
#endif

它也可用於控制偵錯或使用#pragma message顯示編譯器訊息,甚至在某些條件下使用#error產生錯誤。

內部編譯器宏

用於 AVR(Arduino 使用)的 GCC 預處理器包含幾個特殊的宏,可以提供系統訊息,這在開發過程中非常有用:

  • __線__:目前行號。
  • __文件__:目前文件的名稱。
  • __TIME__ 和 __DATE__:編譯時間和日期。
  • __func__:目前函數的名稱。

它們允許版本控制、日誌結構,並且無需侵入主代碼即可促進維護和錯誤追蹤。

巨集為 Arduino 專案提供了一種強大且靈活的方式來建立專案結構。它們允許您定義常數、節省記憶體、使程式碼適應運行時環境,並創建可重複使用的程式碼區塊而無需重複編寫程式碼。然而,使用宏需要嚴謹的語法、清晰的思路和豐富的知識,以避免細微的錯誤或降低程式碼的可讀性。如果運用得當,巨集對於中高階開發人員來說將是一項寶貴的優勢。


在 Google 中將其新增為首選來源