环境搭建

下载安装 Arduino IDE

  1. 前往 Arduino 官方网站下载相应操作系统的安装程序： Arduino IDE

备注

如果下载速度慢或下载失败，可以访问 Arduino 中文社区 ，使用网盘下载社区提供的安装包。

  1. 运行安装程序，安装过程建议使用默认设置，并选择 纯英文路径 进行安装。

备注

安装路径包含中文字符可能导致异常。

了解 Arduino IDE 界面

Arduino IDE 界面如下图所示：

../_images/ide_if_cn.svg

设置 Arduino IDE （可选）

  • 首次启动时，IDE 可能会自动下载并安装 Arduino 内置核心库文件和驱动。若操作系统弹出驱动安装或网络安全提示，建议允许。在此期间，输出窗口会显示下载安装信息，如下图所示，属于正常现象，等待安装完成即可，无需处理。

../_images/ide_first_open.png

  • Arduino IDE 默认显示英文界面，但支持切换到中文。点击 File > Preferences... 打开 Settings ，将 Language 选择为 中文(简体)，然后点击 OK，如下图所示。Arduino IDE 将自动重启并切换为中文界面。

../_images/file_preferences_language.png

  • 如果想要修改项目文件夹地址，可以通过 文件 > 首选项... 的 项目文件夹地址 修改，如下图所示。

../_images/file_preferences_sketch_folder.png

  • 此外，还可设置字体大小、界面缩放、主题风格、显示详细输出等。

安装 Ameba 开发板库

要使用 Arduino IDE 对 Ameba 开发板进行开发，需要安装 Ameba 开发板库。

备注

如果通过 Arduino IDE 安装失败，可以尝试手动安装

  1. 打开 Arduino IDE，点击 文件 > 首选项... ，将以下 URL 粘贴到 其他开发板管理器地址 字段中

https://github.com/Kyderio/arduino_test/raw/master/Arduino_package/package_realtek_test_index.json
../_images/additional_boards_manager_urls_cn.png

  1. 进入 工具 > 开发板 > 开发板管理器... 或点击侧边栏的 开发板管理器图标 ，在搜索框中输入 realtek，从搜索结果中找到 Realtek Ameba EVB，从下拉菜单中选择所需版本，然后点击 安装，如下图所示。Arduino IDE 将开始下载安装所需文件。

../_images/boards_manager_install_cn.png

选择开发板

开发板库安装完成后，通过 工具 > 开发板 > Realtek Ameba EVB > EV721FC0 (RTL8721FCM) 选择开发板（例如 EV721FC0），如下图所示：

../_images/select_board_cn.png

安装库（可选）

Arduino 的“库（Library）”是一系列为实现各类特定功能封装的代码集合，可在多个项目中重复调用，避免重复编写复杂代码。库通常集成了专用算法、硬件驱动、通信协议等功能模块，开发者可直接调用，快速实现传感器控制、屏幕显示、网络通信等各类功能需求。 所有库均可在 Arduino 库参考手册 中查阅。

  1. 在菜单栏中点击 工具 > 管理库... 或点击侧边栏的 库管理图标 。

  2. 在搜索框中输入库名称，相关的库会显示在搜索结果中。查看库的描述和作者信息，找到需要的库。从下拉菜单中选择所需版本，然后点击 安装，如下图所示：

../_images/lib_manager_install_cn.png

  1. Arduino IDE 会自动在 项目文件夹 下新建一个 libraries 文件夹，来存放下载的库。如果想要修改存放地址，请参考 修改项目文件夹地址。

设置硬件环境

  1. Ameba 开发板采用多功能复合接口设计，将供电、程序上传与日志打印功能集成至单一接口，大幅简化硬件连接流程。查看对应 开发板指南 确认 USB Type-C 接口位置。通过 USB Type-C 转 Type-A 线缆将开发板连接到电脑。

备注

如果是第一次将开发板连接到电脑，USB 驱动将自动安装。如果在连接开发板到电脑时遇到驱动问题，请手动安装 USB 驱动。

  1. Ameba 开发板在上传程序前需要进入 上传模式。 进入上传模式 需要操作 DOWNLOAD 按键和 CHIP_EN 按键。查看对应 开发板指南 确认按键位置。

设置端口

点击 工具 > 端口，从下拉菜单中选择相应的端口，如下图所示：

../_images/select_port_cn.png

快速开始

Arduino IDE 提供了许多内置示例，这些示例可以直接在开发板上编译、上传和运行。这里以 Blink 示例作为第一个尝试。

Arduino 程序结构

  1. 打开 文件 > 示例 > 01.Basics > Blink，如下图所示：

../_images/file_examples_basics_blink_cn.png

  1. Arduino IDE 会打开一个新窗口，其中包含完整的示例代码，如下图所示：

../_images/blink_sketch_cn.png

  1. 代码解析

函数

解析

setup()

核心函数 ，用来初始化变量、引脚模式、开始使用库等。

只会在开发板开机或重置后运行一次。

loop()

核心函数 ，程序的主体部分。

在 setup() 函数执行完成后无限循环执行。

pinMode(pin, mode)

设置指定引脚的工作模式。

此示例中将 LED_BUILTIN 引脚设置为输出模式。

digitalWrite(pin, value)

向输出引脚输出值。

此示例中向输出引脚输出高电平（打开 LED）和低电平（关闭 LED）。

delay(ms)

经过指定参数（毫秒）的时间，当前程序才会执行下一行。

此示例中输出引脚输出值后等待 1 秒再改变输出值，实现 LED 亮 1 秒、暗 1 秒的功能。

备注

开发板库会为每块开发板设定一根引脚作为 LED_BUILTIN，请结合 开发板库中的代码定义 和对应 开发板指南 确定引脚位置。

更多关于 Arduino API 使用说明可查阅官方文档： Arduino 编程语言

编译

  1. 编译示例代码，点击 项目 > 验证/编译，如下图所示：

../_images/blink_sketch_verify_compile_cn.png

  1. Arduino IDE 会在 IDE 窗口的底部区域显示编译信息。编译完成后，将看到如下信息：

../_images/compiling_done_cn.png

进入上传模式

上传程序到开发板，首先需要按照下面的步骤使开发板进入 上传模式。

  1. 按住 DOWNLOAD 按键。

  2. 按下并松开 CHIP_EN 按键。

  3. 松开 DOWNLOAD 按键。

备注

查看对应 开发板指南 确认按键位置。

上传

  1. 点击 项目 > 上传，如下图所示：

../_images/blink_sketch_upload_cn.png

  1. Arduino IDE 会先编译然后上传。

  2. 同样，在上传过程中，IDE 会显示信息。上传完成后，会显示如下信息：

../_images/uploading_done_cn.png

备注

如果 Linux 用户在上传时遇到如下图所示的 Permission denied ，请参考 Arduino 官方文档：How to upload a sketch with the Arduino IDE 2 。

../_images/upload_usb_permission_denied_linux.png

运行

这个示例使 LED 闪烁，通常每块开发板都会有一根 LED_BUILTIN 引脚和 LED 相连。如果开发板的 LED_BUILTIN 引脚没有连接 LED，可以如下图所示连接 LED。建议在 LED 和 GND 之间串联一个阻值合适的电阻。按下并松开 CHIP_EN 按键，就可以看到 LED 闪烁了。

../_images/ev721fc0_led_resistance.png

备注

这里以 EV721FCO 开发板为例，不同开发板 LED_BUILTIN 对应的引脚可能不同。