Ameba Z2 Amazon FreeRTOS Getting Started Guide

1. 开始使用 AmebaZ2

AmebaZ2 为 Realtek 所设计具备 Wi-Fi 功能开发板并使用 amazon-freertos sdk 1.4.7 版本。

1. 硬体要求
下面列出了测试 amazon-freertos 所需的硬体组件:

a. AmebaZ2 Dev Board Version DEV_2V0
需要使用 AmebaZ2 开发板来运行 amazon-freertos SDK。
目前的 demo board 版本是:DEV_2V0

b. J-Link/J-Trace Debug Probe
为了将软件编程和下载到 AmebaZ2 上,需要JLINK / JTRACE debugger。 有关 J-Link probe 的更多详细信息,请参考: https://www.segger.com/products/debug-probes/j-link/

2. 支持的开发环境
目前 IAR Embedded Workbench ver.8.30.1 支援 amazon-freertos 但仅适用于 Windows 操作系统。

3. 材料准备

  • 程式码
  • AmebaZ2 Dev Board DEV_2V0
  • IAR Embedded Workbench ver.8.30.1
  • Segger JLINK downloader

2. 准备 & 设置

要在 Ameba-ZII 上下载代码或调试,首先使用者需要确保已正确设置 debugger。 Ameba-ZII 支援 J-Link flahing 与 debugging 功能。由于 DEV_2V0 仅支持 JLINK debugger,因此我们将先介绍下列 JLINK 设置。

2.1. J-Link 设置
Ameba-ZII 支援 J-Link debugger。我们需要将 SWD connector 连接到 J-Link debugger。
连接如下所示。

注意: 为了能够调试由 Cortex-M33 驱动的 Ameba-ZII,使用者需要具有最新硬件版本​​的 J-Link debugger。 (点选 https://wiki.segger.com/Software_and_Hardware_Features_Overview ) 此说明文件为搭配带有硬件版本 V10 的 J-Link

实际开发板上的 SWD connector 如下图所示:

完成这些配置后,请将其连接到PC端

注意: 如果您使用虚拟机作为平台,请确保VM主机和客户端之间的USB连接设置正确,以便VM客户端可以检测到该设备。

2.2. Windows 设置
为了能够使用 J-Link debugger,需要首先安装 J-Link GDB server。 请参考 Windows 介紹 http://www.segger.com 且下载 “J-Link Software and Documentation Pack”
( https://www.segger.com/downloads/jlink )。 运行 “JLinkGDBServer.exe” 来设置 J-Link debugger 并确保配置与下面显示的匹配:

请检查并确保以下信息正确显示。

2.3. Serial Port 设置
透过 connector “CON3” 和 PC 之间连接 microUSB 将 AmebaZII 连接到 PC。在先前的介绍图中可以看到此 connector, 既作为Serial Port 也作为开发板的电源。

2.4. IAR Project 介紹
IAR IDE 为 Ameba-ZII 提供工具链。它允许使用者编写程序,编译并将其上传到您的开发板且支援逐步调试。
使用者可以访问 IAR Embedded Workbench 的官方网站,按照其说明安装IDE。另外,IAR Embedded Workbench 需要凭证,请参考: https://www.iar.com/iar-embedded-workbench/#!?currentTab=free-trials

注意: 请使用IAR版本8.30或以上

3. 构建与运行FreeRTOS范例

所有 amazon-freertos demo 文件都已放置到目录下: “amazon-freertos\demos\realtek\amebaz2\iar”

项目文件名为 “project_is.eww” 与 application_is.ewp 已预先配置了所有必需的档案,预构建和后构建脚本。

3.1.1 项目配置
1) 可以在档案 “platform_opts.h” 中启用或停用许多配置
2) 预设版本将运行baseline software及amazon-freertos范例
3) aws hello world 范例将默认运行

3.1.2 编译
1) 开启 amazon-freertos\demos\realtek\amebaz2\iar \Project_is.eww.
2) 在 Work Space 中确认 application_is,右键单击 application_is 并选择 “Rebuild All” 进行编译
3) 确保编译结果没有错误状况

3.1.3 生成 image binary
编译后,可以在EWARM-RELEASE \ Debug \ Exe 中看到 images partition.bin,bootloader.bin,firmware_is.bin 和 flash_is.bin。
1) partition.bin 存储 partition table,记录Boot image 和 firmware image的地址
2) bootloader.bin 为 bootloader image
3) firmware_is.bin 为 application image
4) flash_is.bin 链接 partition.bin,bootloader.bin 和 firmware_is.bin。使用者利用 PG tool 将 image 下载到开发板时需要选择flash_is.bin

3.1.4 Download
成功编译项目并生成flash_is.bin后:
1) 直接从IAR IDE下载 image binary 到 demo board(如下所示)

2) 成功下载image后,需要重置开发板才能运行应用程序并查看记录
3) 按下重置按钮后,开发板将启动并运行所选的范例程序

3.1.5 Debugging
1) IAR可用于调试。调试确认已内置到项目文件中
2) 打开IAR并到Project中选择您的调试选项

请先确认已安装QQ通讯软体