2961
#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/”举例，请根据实际存放路径修改。
3、执行以下命令检查下载文件夹中的安装文件。
Figure 7: 检查下载路径下的文件
4、执行以下命令，解压文件，其中“arduino-1.8.16-linux64.tar.xz”仅为示例版本，具体以实际版本压缩包名称修改。
Figure 8: 解压文件
5、tar命令执行完成后，再次执行ls命令。可看到路径下已创建名为“arduino-version“的文件夹。
Figure 9: Arduino文件已生成
6、执行以下命令进入新创建的Arduino文件夹，如“arduino-1.8.16”。
7、执行以下命令，运行install.sh文件，安装Arduino IDE。其中，sudo命令临时提升权限，允许安装程序在不以root用户身份登录的情况下完成敏感任务。
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。
使用以下库：
下载ECAD模型
