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中选择您的调试选项
