Arduino 連接移植指南

Arduino 線路草圖和程式庫可以複製/貼到 Visual Studio 內的 Arduino 線路專案，並在 Raspberry Pi 2、Raspberry Pi 3 或 Minnowboard Max 上執行。 有時候需要對這些檔案進行些微的修改，使其與 Windows 環境更相容，或是您正在使用的面板。 本指南將涵蓋這些修改，以及部署 Arduino 連接專案時可能會遇到的常見問題。

移植

更新釘選

這可能不說，但許多草圖和程式庫 (特別是 arduino 防護) 可能包含 Arduino 裝置特定連接器針腳的參考。 您會想要自訂您的草圖，以針對您正在使用的裝置使用適當的連接器針腳，以及您使用的設定。

Arduino 連接最終需要實體連接器接腳編號，才能代表任何參考「針腳」的函式。 您可以直接使用這些數位，但我們也提供了一些預先定義的針腳名稱，對應到特定面板上的連接器針腳。

例如，Raspberry Pi 2 和 3 上的實體連接器針腳 29 也稱為 GPIO5 。 您可以使用下列其中一個命令，將 GPIO 針腳 5 設定為 Raspberry Pi 2 和 3 上的 HIGH 狀態：

pinMode( 29, OUTPUT );
digitalWrite( 29, HIGH );

或

pinMode( GPIO5, OUTPUT );
digitalWrite( GPIO5, HIGH );

預先定義的針腳名稱可以在 pins_arduino.h 中找到，並包含在每個 Arduino 線路專案中，但因為根據您建置的硬體設定，會有不同的實體連接器接腳可用，我們也在這裡包含一個表格來描述每個裝置可用的針腳名稱。

Raspberry Pi 2 和 3

Minnowboard Max

常見問題

在 Visual Studio 中找不到 「Arduino 連接應用程式」Visual C++ 專案範本

原因：未安裝適用于 Visual Studio 的 Windows IoT 專案範本擴充功能。

解決方案：您必須先安裝適用于 Windows IoT 專案範本的 Visual Studio 延伸模組，才能在 Visual Studio 中建立 Arduino 連接專案。 請前往 Windows IoT 核心版專案範本延伸模組頁面 ，從 Visual Studio 資源庫下載延伸模組！

錯誤：呼叫函式時找不到識別碼

原因：當叫用尚未在檔中宣告的函式時，連結器進程期間就會發生此錯誤。

解決方案：在 C++ 中，所有函式都必須在叫用之前宣告。 如果您已在草圖檔案中定義新的函式，則宣告或函式的整個實作必須高於任何嘗試叫用它 (通常位於檔頂端) 。

範例：

下列程式碼區塊會引發錯誤 「'myFunction'： 找不到識別碼」

void setup()
{

}

void loop()
{
    myFunction();
}

void myFunction()
{
    //do something
}

有兩個解決方案。 首先，您可以宣告函式高於任何調用。 一般而言，此宣告會在檔案頂端完成。

// Declare function here
void myFunction();

void setup()
{

}

void loop()
{
    myFunction();
}

// And, define the function here
void myFunction()
{
    //do something
}

或者，您可以將函式的整個實作移至任何調用上方。 這同時具有宣告和定義函式的效果。

void setup()
{
}

void myFunction()
{
    //do something
}

void loop()
{
    myFunction();
}

我的解決方案在初始化時無限停止回應

已知問題可能會導致 C++ 解決方案在初始化時無限停止回應 (死結) 。 如果您發現解決方案似乎永遠停止回應，而且您無法使用偵錯工具來「中斷」至 Arduino 連接應用程式之 setup () 或 loop () 區段中的任何語句，您可能會遇到這種問題。

原因：正在建立物件，或正在呼叫函式，這會導致解決方案完成初始化之前發生非同步動作。 這可能是由呼叫 API 函式的物件建構函式所造成，例如 pinMode 。

解決方案：將任何物件建構函式和函式呼叫從程式碼的初始化區段移至 setup() 區塊。

範例 1：

此草圖的執行會在初始化方案本身之前呼叫函 setPinModes() 式。 解決方案看起來將會執行，但會無限停止回應。

bool setPinModes();

int pin = GPIO5;
bool initialized = setPinModes();

void setup()
{

}

void loop()
{
    if( initialized )
    {
        //do something
    }
}

bool setPinModes()
{
    if( pin < 0 ) return false;
    pinMode( pin, OUTPUT );
    return true;
}

解決方案如下，我們只是將 的執行 setPinModes() 移至 函 setup() 式：

bool setPinModes();

int pin = GPIO5;
bool initialized;

void setup()
{
    initialized = setPinModes();
}

void loop()
{
    if( initialized )
    {
        //do something
    }
}

bool setPinModes()
{
    if( pin < 0 ) return false;
    pinMode( pin, OUTPUT );
    return true;
}

範例 2：

此草圖的執行會在呼叫 之前 setup() ，于堆疊上建立 物件。 由於物件在其建構函式中呼叫 pinMode ，這也會造成死結。 這是罕見的問題，但可能會發生來自特定程式庫的物件 (，例如 Arduino LiquidCrystal 程式庫) 。

class MyObject
{
public:
    MyObject()
    {
        pinMode( GPIO5, OUTPUT );
    }

    void doSomething()
    {
        //...
    }
};

MyObject myObject;

void setup()
{
}

void loop()
{
    myObject.doSomething();
}

解決方案如下。 我們已將物件變更為物件指標，並將物件的初始化 setup() 移至 。

class MyObject
{
public:
    MyObject()
    {
        pinMode( GPIO5, OUTPUT );
    }

    void doSomething()
    {
        //...
    }
};

MyObject *myObject;

void setup()
{
    myObject = new MyObject();
}

void loop()
{
    myObject->doSomething();
}

使用 Serial.print() 和 Serial.println()

許多 Arduino 草圖會在開啟) 或寫入 USB 或 tx/rx) (序列行時，使用 Serial 將資料列印至序列主控台 (。 在舊版的 Lightning SDK 中，未包含硬體 Serial 支援，因此我們提供了一個 Log() 函式，它會列印至 Visual Studio 中的偵錯工具輸出視窗。 Serial.print*() 或 Serial.write() 必須移除。

不過，從 Lightning SDK v1.1.0開始，我們新增 Hardware Serial 了支援，且已完全支援 或 Serial.print*()Serial.write() 函式。 因此，如果您要複製為 Arduino 建置的草圖，則不需要取代 Windows IoT 版草圖中的任何序列參考。

此外，我們已在附加偵錯工具時擴充 和 Serial.println() 的功能 Serial.print() ，以在附加偵錯工具時輸出至偵錯工具視窗，除了寫入硬體序列針腳之外。 偵錯輸出列印會設定為預設值，因為讀取該輸出是執行其草圖時大部分使用者想要的輸出。 不過，也可以停用該功能;例如，若要改善效能，只要呼叫 Serial.enablePrintDebugOutput(false); 以在您的草圖中停用它即可。 若要重新啟用它，請呼叫 Serial.enablePrintDebugOutput(true); 。 寫入硬體序列針腳不會受到這些呼叫的影響。

請注意，您不需要將任何周邊附加至 FTDI 之類的序列針腳，即可取得傳送至偵錯工具視窗的輸出。 不過，在偵錯應用程式時，您必須確定偵錯工具視窗已開啟。

專案範本已在 Windows IoT 核心專案範本擴充功能頁面上 更新，可使用現用的硬體 Serial 啟用。 不過，如果您的 Arduino 線路應用程式已使用較舊的專案範本版本建立，您必須 1) 將您的專案升級至最新的 Lightning SDK v1.1.0 或更新版本，而 2) 將必要的硬體序列裝置功能新增至 AppxManifest 才能使用 Serial 。

硬體序列裝置功能需求

Windows 10 IoT 核心版中的硬體序列功能需要將裝置功能宣告新增至 AppX 資訊清單。

Package.appxmanifest在方案總管中輸入檔案名，以尋找專案中的檔案。 然後，以滑鼠右鍵按一下檔案，然後選擇 [開啟方式...]。 選擇 [XML (文本) 編輯器]，然後按一下 [確定]。

在 appx 資訊清單檔案編輯器中 serialcommunication ，將 DeviceCapability 新增至您的專案，如下列 XML 程式碼片段所示：

<Capabilities>
  <Capability Name="internetClient" />

  <!-- General Arduino Wiring required capabilities -->
  <iot:Capability Name="lowLevelDevices" />
  <DeviceCapability Name="109b86ad-f53d-4b76-aa5f-821e2ddf2141"/>

  <!-- The serialcommunication capability is required to access Hardware Serial. -->
  <DeviceCapability Name="serialcommunication">
    <Device Id="any">
      <Function Type="name:serialPort"/>
    </Device>
  </DeviceCapability>

</Capabilities>

將您的專案升級至最新的閃電 SDK

Arduino 線路專案相依于 Lightning SDK Nuget 套件 ，以實作必要的 Arduino 線路函式和宣告，以及與 Lightning 驅動程式的介面。 最新的閃電 SDK 將包含最新的改善和錯誤修正。 若要升級至最新的 Lightning SDK，請遵循下列步驟：

• 在方案總管中，以滑鼠右鍵按一下您的專案，然後按一下 [管理 Nuget 套件...]
• 在 NuGet 套件管理員中，移至 [已安裝] 索引標籤。您應該會看到已安裝 Microsoft.IoT.Lightning 套件
• 可用的版本將會列在 [版本] 下拉式方塊內。
• 選擇最新版本，然後按一下 [更新] 以更新您的套件。
• 請注意，若要升級至發行前版本，請務必同時核取 [包含發行前版本] 核取方塊。