使用 86Duino DOS SDK 撰寫程式

86Duino DOS SDK 位於 DuinOS 的 86DUINO 目錄下,提供支援 86Duino 硬體功能的 C++ 函式庫,可讓您在一般 C++ 程式中使用相容 Arduino 的 API 存取 86Duino 的 I/O 介面,並在 DJGPP 環境內編譯出可在 86Duino 上執行的 DOS 程式。

注意使用 86Duino DOS SDK 的 C++ 程式必須遵循 C++ 語法規定撰寫,因此程式寫法與 86Duino 的 sketch 程式寫法略有不同。以下面 86Duino 的 Blink sketch 範例程式為例:

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

void loop() {
  digitalWrite(13, HIGH); 
  delay(1000);
  digitalWrite(13, LOW);
  delay(1000);
}

若要改為使用 86Duino DOS SDK 的標準 C++ 程式,應改寫成:

#include "Arduino.h"

int main(void)
{
  pinMode(13, OUTPUT);

  while(1)
  {
    digitalWrite(13, HIGH); 
    delay(1000);
    digitalWrite(13, LOW);
    delay(1000);	
  }		      

  return 0;
}

由上例子可以看到,只要 include 標頭檔 Arduino.h,即可在標準 C++ 程式內直接使用 86Duino 的 Standard API 函式。在 86DUINO\EXAMPLE 目錄內我們放了一個使用 86Duino DOS SDK 的簡易 C++ 範例程式碼,提供給使用者參考;同目錄下的 Makefile 可用來編譯出範例程式的 DOS 執行檔(直接在該目錄下鍵入 make 即可編譯出名為 86Duino.exe 的執行檔),使用者可研究它的內容,來瞭解如何以 DJGPP 編譯使用 86Duino DOS SDK 的 C++ 程式。

如果您修改了 86DUINO\EXAMPLE 目錄下範例程式,並在程式中呼叫了 86Duino Coding IDE 內建的函式庫,您必須也同時修改 Makefile,將使用到的函式庫也加入編譯流程中。例如,假設您修改範例程式額外呼叫了 EEPROM 函式庫,您應打開 Makefile,找到開頭為 THIRD_LIB_NAME 的那一行:

sd_reader

然後在 := 右邊(除了原本的 TimerOne 之外)加上 EEPROM。注意,您呼叫的函式庫可能會在内部調用其它函式庫的功能,在這種情況下,您應該在 THIRD_LIB_NAME := 後面將所有被調用到的函式庫加上去,下表列出 86Duino 內建的函式庫裡,所有會互相依賴的函式庫:

函式庫名稱 被調用的函式庫
TFT SPI
FreeIMU1 Wire
Adafruit_CC3000 SPI
SpiderL3S SPI
RF24 SPI
Mirf SPI
RadioHead SPI

此外,有些函式庫還會在内部調用安裝在 DuinOS 的 DJGPP 環境內的外部函式庫(例如:SwsSock 或 Allegro 函式庫),這種情況下,您還必須在 Makefile 內找到開頭為 EXTEN_LIB 的那一行,在 := 右邊加上所有連結外部函式庫的編譯參數:

sd_reader

下表列出所有 86Duino 內建的函式庫裡,會額外調用外部函式庫的內建函式庫:

函式庫名稱 連結外部函式庫的編譯參數
Ethernet -lswsk
Rosserial86 -lswsk
USBHost -lalleg

關於最新 DuinOS 的 86Duino DOS SDK 裡支援的 86Duino Standard API 及內建函式庫完整列表,請參閱此連結


黑客天地主頁面

The text of the 86Duino reference is licensed under a Creative Commons Attribution-ShareAlike 3.0 License.