九九物联 ( 深圳 ) 有限公司 AmebaZII SDK 上手指南第 1 章开发环境搭建本章介绍如何在 windows 系统下搭建 SDK 开发环境, 包括 IDE 的安装, 驱动安装和调试工具软件的安装 1.1 IAR8.32 的安装和注册我们提供的 SDK 是基于 IAR

Size: px

Start display at page:

Download "九九物联 ( 深圳 ) 有限公司 AmebaZII SDK 上手指南第 1 章开发环境搭建本章介绍如何在 windows 系统下搭建 SDK 开发环境, 包括 IDE 的安装, 驱动安装和调试工具软件的安装 1.1 IAR8.32 的安装和注册我们提供的 SDK 是基于 IAR"

郁兹凌
4 years ago
Views:

第 1 章开发环境搭建本章介绍如何在 windows 系统下搭建 SDK 开发环境, 包括 IDE 的安装, 驱动安装和调试工具软件的安装 1.1 IAR8.32 的安装和注册我们提供的 SDK 是基于 IAR 8.32.1 版本的工程, 需要安装 8.32.1 或更高的软件版本才能正常打开和编译, 低版本的 IAR 打开工程编译会出错 1.

1 第 1 章开发环境搭建本章介绍如何在 windows 系统下搭建 SDK 开发环境, 包括 IDE 的安装, 驱动安装和调试工具软件的安装 1.1 IAR8.32 的安装和注册我们提供的 SDK 是基于 IAR 版本的工程, 需要安装或更高的软件版本才能正常打开和编译, 低版本的 IAR 打开工程编译会出错下载 IAR8 登录 IAR 官网下载, 官网地址点击箭头处下载按钮进行下载 ( 当前最新版本是 8.40) 1 / 16 更多精彩请访问

2 1.1.2 安装和注册 IAR8 软件安装过程比较简单, 打开下载的安装包, 按照提示进行安装即可安装过程中需要注意, 选择安装路径的时候不要有中文按照自己的需求选择要安装的驱动包, 安装驱动时不要将下载器插入电脑安装完成后先不用注册, 进入软件后进行注册 2 / 16 更多精彩请访问

3 到此软件安装步骤完成, 打开安装完成的软件, 下面需要完成的是注册 License, 软件不注册只有 30 天的试用时间, 工具栏中的 Help->License Manager 进行注册支持正版软件, 如仅用于学习用途, 可自行百度一下注册方法 1.2 JLINK 驱动安装 AmebaZ II 的 SDK 支持 JLINK 的 SWD 接口在线调试代码和下载程序, 方便对 SDK 进行二次开发使用 JLINK 进行调试先要安装 JLINK 驱动,JLINK 驱动官方下载地址 : Pack 本文档是在 v6.40 版本上进行调试的注意 : 由于 AmebaZ II 是 Cortex-M33 的内核,JLINK 的硬件版本要在 V9 及以上才支持, 低版本的 JLINK 不支持 Cortex-M33 安装好 JLINK 驱动后打开电脑的设备管理器, 可以看到 JLINK 3 / 16 更多精彩请访问

4 设备, 如下图 : 软件安装完成后打开 IAR 工程配置好相关选项即可用 JLINK 在线调试代码和下载程序到 FLASH 1.3 辅助开发调试工具介绍串口调试助手 SDK 中系统的 debug 信息通过 log 串口输出, 有完善的 log 输出接口给用户使用, 方便在开发过程中输出用户自己的调试 log, 遇到 bug 时快速定位把模块的 debug 串口通过 TTL 电平转换工具接到 PC 端, 在 PC 端打开串口调试工具即可看到模块的 log 信息在开发阶段也可以通过串口助手从 PC 端给模块发送 AT 指令进行指令集的开发比较好用的串口工具是 SecureCRT, 支持日志自动保存到文件, 时间戳等功能 SecureCRT 工具可以自行在网上下载安装, 使用方法也比较简单, 设置好串口参数, 连接上目标串口即可 TCP/UDP 网络助手在 wifi 模块的 SDK 开发过程中离不开网络的测试, 频繁的测试 TCP/UDP 连接和数据的收发, 验证 WIFI 的性能, 需要 PC 端的软件来配合调试常用的 PC 端工具软件有 NetAssist NetAssist 是一款简易的网络测试工具, 不用安装, 下 4 / 16 更多精彩请访问

5 载后直接打开使用支持 TCP/UDP Server,TCP/UDP Client, 跟 WIFI 模块建立 TCP/UDP 连接后进行数据收发工欲善其事必先利其器, 到此我们的 SDK 的开发和调试环境基本建立起来了, 下一章开始我们的 SDK 开发之旅 5 / 16 更多精彩请访问

6 第 2 章 SDK 介绍 2.1 SDK 工程文件夹介绍 component: 包含 FreeRTOS,Lwip 协议栈, 蓝牙,mqtt 协议,AT 指令集和上层的 API, 所有的源码都放在这个文件夹, 根据子文件件的命名可以清晰的找到各个部分的代码 doc:doc 文件夹里包含了 API 的说明文档, 原厂的 AT 指令集和各功能模块的说明文档, 用户可以查阅里面的相关文档来熟悉 SDK 的各个功能模块的实现和配置 project: 该文件夹包含 IAR 工程的配置文件, 编译输出文件和模块外设的使用参考例程代码 2.1 SDK IAR 工程结构介绍打开 IAR 软件 (8.32 以上的版本 ), 加载 IAR 的工程文件 Project_is.eww, 工程文件在 SDK 中的路径为 project\realtek_amebaz2_v0_example\ewarm-release 打开工程后目录结构如下图 : 6 / 16 更多精彩请访问

7 @ERAM 目录根据用户的需求, 将关键代码放置到这两个目录, 具体的说明参照文档 AN0500 的章节 amazon: 连接亚马逊云服务的 demo 源码 bluetooth: 蓝牙配网,GATT 服务的例程和蓝牙协议栈的相关代码 cmsis: 进入 main 函数前的相关初始代码 console: 指令集 API 函数集合, 包括 WIFI 指令, 蓝牙指令,log 串口指令, 系统设置相关指令 lib: 原厂封装的 wlan 等应用库, 包含 wlan, 蓝牙 gap,http 等, 不提供源代码, 以封装库的形式给用户调用 network: 网络部分相关的源代码, 包含 lwip,http,google demo,ssl 加密等 os:freertos 系统源码 peripheral: 外围接口操作 API, 包含 i2c,sdio,gpio,timer,pwm,efuse 和串口等使用 MCU 的外围接口需要调用对应文件的 API user:main 函数入口文件, 包含控制台初始化入口, 网络初始化入口和应用入口函数 example_entry 的调用 utilities: 功能模块的入口代码, 每个源文件对应一个功能模块, 通过配置头文件 platform_opt.h 中的宏定义来开启对应的功能 output: 编译产生的.o 文件,.map 文件 7 / 16 更多精彩请访问

$2.1 编译 SDK 2.1.1 打开 SDK 工程打开 IAR 软件, 加载工程文件 file->open workspace 加载 project\realtek_amebaz2_v0_example\ewarm-release 路径下的 Project_is.eww 文件即可打开 SDK 工程 2.1.2 编译 SDK 首次打开工程先 clean 以前编译的信息 project->clean, 清除旧的编译信息之后 project->make 开始 SDK 的编译工作, 编译完成后, 在以下目录生成可执行的 bin 文件 project\realtek_amebaz2_v0_example\ewarm-release\debug\exe 生成的 bin 文件有 bootloader.$

8 2.1 编译 SDK 打开 SDK 工程打开 IAR 软件, 加载工程文件 file->open workspace 加载 project\realtek_amebaz2_v0_example\ewarm-release 路径下的 Project_is.eww 文件即可打开 SDK 工程编译 SDK 首次打开工程先 clean 以前编译的信息 project->clean, 清除旧的编译信息之后 project->make 开始 SDK 的编译工作, 编译完成后, 在以下目录生成可执行的 bin 文件 project\realtek_amebaz2_v0_example\ewarm-release\debug\exe 生成的 bin 文件有 bootloader.bin,firmware_is.bin,flash_is.bin 和 partition.bin partition.bin : 存放分区列表信息,boot image 和 firmware iamge 的地址信息 bootloader.bin: 模块的启动引导文件, 模块启动时执行 bootloader.bin 对硬件底层进行初始化和分区跳转,boot 文件由原厂提供, 不需要修改 firmware_is.bin: 是应用固件, 执行完 boot 程序之后跳转到应用固件执行 flash_is.bin: 合成固件, 将 bootloader.bin,firmware_is.bin 和 partition.bin 8 / 16 更多精彩请访问

合成一个 bin 文件, 可以用 PG Tool 下载到 flash 中 2.1.3

9 合成一个 bin 文件, 可以用 PG Tool 下载到 flash 中固件下载用 JLINK 下载固件 SDK 支持 JLINK 的 SWD 方式下载固件, 首先将 JLINK 连接到电脑上, 用杜邦线将开发板的 SWD 下载调试接口 J35 与 JLINK 的 SWD 接口按照下图进行连接 : JLINK 引脚开发板 J35 引脚 VCC 3.3V GND SWDIO SWCLK GND DATA CLK 9 / 16 更多精彩请访问

log 串口看板子输出的 log 信息硬件连接完成之后打开安装好的 JLINK 软件 (

10 实物连接图如下 : 连接上 JLINK 之后还要用 micro usb 线将开发板的 CON3 接口连接到电脑, 电脑自动识别安装串口驱动, 在电脑端打开串口软件 SecureCRT 并连接开发板的 log 串口看板子输出的 log 信息硬件连接完成之后打开安装好的 JLINK 软件 ( 上一章介绍了怎么安装 ), 打开 GDB Server, 如下图所示 : 10 / 16 更多精彩请访问

11 打开后按照下图配置软件 : 配置好之后点击 OK, 确认 JLINK 和开发板连接上, 如下图所示 : 11 / 16 更多精彩请访问

注意 : 上图红色框框 J-Link:Connected 表示 PC 端已经连接上了 JLINK Device:Cortex-M33(Halted) 表示 JLINK 已经连接上开发板, 这两项如果不是显示以上内容则表示连接不成功, 检查硬件连接和软件设置连接好 PC->JLINK-> 开发板之后就可以在 IAR 中进行固件下载了,

12 注意 : 上图红色框框 J-Link:Connected 表示 PC 端已经连接上了 JLINK Device:Cortex-M33(Halted) 表示 JLINK 已经连接上开发板, 这两项如果不是显示以上内容则表示连接不成功, 检查硬件连接和软件设置连接好 PC->JLINK-> 开发板之后就可以在 IAR 中进行固件下载了, 下载流程如下 :Project->Download-> Download active application, 如下图 : 点击 Download active application 之后如果代码有修改, 会先编译代码生成新的 bin 文件, 等待编译完成之后开始下载, 下载过程如下图 : 12 / 16 更多精彩请访问

13 用 PG tool 下载固件 Ameba-ZII 也可使用原厂提供的下载工具 PG tool 进行固件一键下载, 方便快捷, 软件界面如下 : 13 / 16 更多精彩请访问

软件设置 : Firmware 区 : 加载需要烧写的 bin 文件 Program flash memory: 选择烧写模式为 flash UART Setting: 选择串口端口号并设置串口参数, 端口号为开发板的 log 串口连接上 PC 的端口号, 在 PC 的设备管理器中可以看到波特率为 1000000, 无流控和校验 Flash Option: 设置 flash 参数,Flash

14 软件设置 : Firmware 区 : 加载需要烧写的 bin 文件 Program flash memory: 选择烧写模式为 flash UART Setting: 选择串口端口号并设置串口参数, 端口号为开发板的 log 串口连接上 PC 的端口号, 在 PC 的设备管理器中可以看到波特率为 , 无流控和校验 Flash Option: 设置 flash 参数,Flash IO 为 One IO,Flash Pin 不同的芯片设置不一样, 芯片型号对应 IO 设置如下图 : 软件设置好后按照以下流程进行烧写 : 第一步 : 开发板用 micro usb 线将开发板的 CON3 与 PC 端的 USB 口连接, 连接好后开发板上的 D1 和 D2 亮, 在电脑的设备管理器中能看到连接上的端口 J34 和 J33 用跳线帽按照下图跳线 : 14 / 16 更多精彩请访问

第二步 : 按下 UART DOWNLOAD Button 和 REST Button 后先松开 REST Button 再松开 UART DOWNLOAD Button, 让开发板进入下载模式, 在 PC 端用串口软件查看开发板的 log 信息,log 信息为下图所示表示已经进入下载模式 : 注意 : 看到以上打印信息后,

15 第二步 : 按下 UART DOWNLOAD Button 和 REST Button 后先松开 REST Button 再松开 UART DOWNLOAD Button, 让开发板进入下载模式, 在 PC 端用串口软件查看开发板的 log 信息,log 信息为下图所示表示已经进入下载模式 : 注意 : 看到以上打印信息后, 要把串口助手关闭, 不关闭的话串口被占用,PG tool 无法打开串口进行下载第三步 : 在 PG tool 中加载编译生成的 flash_is.bin 文件, 选择 Program flash memory, 点击 Download 按钮开始下载固件, 如下图 : 15 / 16 更多精彩请访问

16 下载成功后信息提示框中显示如下 : 下载失败显示如下 : 到此 SDK 的编译和固件的下载工作已经完成, 下一章将介绍 SDK 的代码框架, 如何开发 AT 指令集和蓝牙相关功能 16 / 16 更多精彩请访问

微雪电子 Open103Z 实验手册 Open103Z 实验手册目录准备工作 BitIO-Pushbutton... 3 ADC+DMA... 4 CAN-LoopBack... 5 DAC... 6 DS18B GPIO_Key_L

微雪电子 Open103Z 实验手册 Open103Z 实验手册目录准备工作 BitIO-Pushbutton... 3 ADC+DMA... 4 CAN-LoopBack... 5 DAC... 6 DS18B GPIO_Key_L 目录准备工作... 3 8BitIO-Pushbutton... 3 ADC+DMA... 4 CAN-LoopBack... 5 DAC... 6 DS18B20... 7 GPIO_Key_LED... 8 I2C... 9 LCD-HY32D_FSMC... 10 Nand Flash...11 NorFlash... 12 PS2... 13 RTC... 14 SD_FatFS... 15

九九物联 ( 深圳 ) 有限公司 AmebaZII SDK 上手指南 第 1 章开发环境搭建 本章介绍如何在 windows 系统下搭建 SDK 开发环境, 包括 IDE 的安装, 驱动 安装和调试工具软件的安装 1.1 IAR8.32 的安装和注册 我们提供的 SDK 是基于 IAR

九九物联 ( 深圳 ) 有限公司 AmebaZII SDK 上手指南第 1 章开发环境搭建本章介绍如何在 windows 系统下搭建 SDK 开发环境, 包括 IDE 的安装, 驱动安装和调试工具软件的安装 1.1 IAR8.32 的安装和注册我们提供的 SDK 是基于 IAR