#Arduino IDE的下載

使用Arduino IDE對WisBlock進行編碼和編程。如果您還未安裝Arduino IDE，可在Arduino官網中下載。

警告：如果您所使用的操作系統為Windows 10：
請勿從Microsoft應用商店中安裝Arduino IDE。請從Arduino官網中安裝原始的Arduino IDE。Microsoft應用商店中的Arduino應用在使用第三方板支持包時存在問題。

如下圖所示，可以看到Arduino IDE當前版本為V1.8.13。Windows、Linux和Mac OS X都有多個可用版本，選擇正確的Arduino IDE版本并下載。

Figure 1: Arduino IDE 版本示意圖

#Arduino IDE的安裝

#Windows中的安裝

在Windows PC中安裝已下載的Arduino IDE。

1、單擊“I Agree”。

Figure 2: Arduino安裝許可協議

2、單擊“Next”。

Figure 3: Arduino安裝選項

3、單擊“Install”。

Figure 4: 安裝Arduino IDE

Figure 5: Arduino IDE安裝中

進度為100%后，Arduino IDE已成功安裝。

Figure 6: 成功安裝

#Linux中的安裝

在Linux操作系統中，首先需要檢查與系統的兼容性，選擇適合所使用系統的Arduino IDE版本，如32位、64位或ARM版本。

通過tarball安裝

tarball是linux下最方便的打包工具，是以tar指令來打包/壓縮或解壓文件。

1、將已下載的Arduino文件上傳至服務器（可使用終端工具，如XShell，Mobaxterm等）。

2、進入至Arduino文件放置路徑，以下僅以“/Desktop/Downloads/”舉例，請根據實際存放路徑修改。

cd /Desktop/Downloads/

3、執行以下命令檢查下載文件夾中的安裝文件。

ls

Figure 7: 檢查下載路徑下的文件

4、執行以下命令，解壓文件，其中“arduino-1.8.16-linux64.tar.xz”僅為示例版本，具體以實際版本壓縮包名稱修改。

tar xvf arduino-1.8.16-linux64.tar.xz

Figure 8: 解壓文件

5、tar命令執行完成后，再次執行ls命令。可看到路徑下已創建名為“arduino-version“的文件夾。

Figure 9: Arduino文件已生成

6、執行以下命令進入新創建的Arduino文件夾，如“arduino-1.8.16”。

cd arduino-1.8.16

7、執行以下命令，運行install.sh文件，安裝Arduino IDE。其中，sudo命令臨時提升權限，允許安裝程序在不以root用戶身份登錄的情況下完成敏感任務。

sudo ./install.sh

Figure 10: 安裝Arduino IDE

#Mac OS X中的安裝

在Mac OS X中，與Linux相同，沒有安裝過程。只是一個解壓過程，然后就能夠成功打開Arduino IDE 。

#Arduino IDE的界面簡介

Figure 11: Arduino IDE

打開Arduino IDE，如上圖所示，Arduino IDE主要有5個部分：

1、IDE選項菜單

選項菜單可以配置一些常規參數，如串口、線路板信息、庫、編輯參數等。

2、操作按鈕

操作按鈕有5個操作：

• Verify/Compile：驗證/編譯源代碼
• Upload：上傳編譯后代碼至WisBlock
• New：打開新的Arduino IDE窗口或現有的應用程序
• Save：保存當前應用程序

Figure 12: 操作按鈕

3、編碼區域

可以編輯源代碼，這些源代碼將在本區域稍后編譯并上載到WisBlock。

4、狀態區域

5、輸出信息區域

可以在此區域看到輸出信息，無論是失敗信息還是成功信息。

#Arduino IDE上的配置

Arduino IDE安裝成功后，并且已了解Arduino IDE的主要部分。可以在Arduino IDE上進行一些配置更改以便可以適配WisBlock。

1、打開Arduino IDE。

2、進入“File > Preferences”。

Figure 13: Preferences

3、單擊圖中圖標，編輯“Additional Board Manager URLs”，將WisBlock Core添加到Arduino板列表中。

Figure 14: 修改Additional Board Manager URLs

4、復制此URLhttps://raw.githubusercontent.com/RAKwireless/RAKwireless-Arduino-BSP-Index/main/package_rakwireless_index.json并粘貼至下圖所示區域。如果已存在其他鏈接，將上述鏈接粘貼至新的一行。完成后，單擊“OK”。

Figure 15: 添加RAKwireless WisBlock Core BSP

注意

如果您使用的是Linux，需要通過“pip”安裝“adafruit-nrfutil”。

sudo pip3 install adafruit-nrfutil 或 pip3 install --user adafruit-nrfutil

5、重啟Arduino IDE。

6、在“Tools”菜單中打開“Boards Manager”。

Figure 16: 打開Boards Manager

7、如下圖所示，在搜索欄中鍵入“RAK”。將會顯示出可添加到Arduino板列表中的可用RAKwireless WisBlock Core。選擇所使用的WisBlock Core并單擊“Install”。

Figure 17: 安裝WisBlock Core

8、完成BSP安裝后， 選擇將更新系統配置的任意RAK WisBlock模塊，以便為模塊使用正確的編譯器和設置。

Figure 18: 選擇RAKwireless WisBlock模塊

#示例和教程

#示例

選擇RAK板后，可以看到如下所有WisBlock模塊的示例。

Figure 19: 選擇WisBlock模塊示例

#編譯教程

選擇其中一個示例并進行編譯。

1、單擊進入“File -> Examples”菜單，如下圖所示，打開“LoRaWAN-OTAA”示例。

Figure 20: 選擇LoRa OTAA示例

2、在新打開的“LoRaWAN-OTAA”窗口的代碼行20中，可以看到所需安裝的“LPWAN”庫鏈接。

Figure 21: LPWAN庫鏈接

3、雙擊鏈接，打開“Library Manager”，頁面將會顯示所需的庫。

Figure 22: 打開Library Manager

4、單擊“Install”，安裝庫。安裝完成后可以關閉“Library Manager”窗口。

5、現在可以開始編譯示例代碼。在菜單欄中單擊“Verify/Compile”圖標。

Figure 23: 編譯示例

完成這些步驟后，已成功安裝LPWAN庫并已編譯您的第一個WisBlock解決方案。然而，要連接到LPWAN網關和LPWAN服務器，還需要執行一些的步驟。要了解如何配置節點的EUI和密鑰以及如何將節點注冊到網關和LPWAN服務器中，請在RAK Github WisBlock 庫中查看完整的教程。

有關示例和教程更多的信息，請訪問RAK Github WisBlock 庫。

#說明

此BSP基于Adafruits nRF52 BSP。它基于由Sandeep Mistry編寫的Arduino-nRF5，同時也基于Arduino SAMD Core。

使用以下庫：

• adafruit-nrfutil基于Nordic Semiconductor ASA公司的pc-nrfutil
• freeRTOS作為操作系統
• tinyusb作為USB協議棧
• nrfx用于外圍設備驅動程序
• littlefs用于內部文件系統