一、编译步伐
步伐编译可以通过2种方式：pio左栏按钮、命令行；
1. Pio左栏按钮：
点下按钮编译后，会自动弹出终端窗口表现编译过程。
2. 命令行方式：
在“终端”通过命令行进行的工程编译。命令：pio run -e debug -v
使用如图：
不管使用上边的哪种方式，编译和烧录成功时，会有success的提示如下：
.
二、烧录步伐（和ve设置）
注意：AG32烧录步伐和烧录VE设置是分开的。
注：这里描述所说的“烧录VE设置”，其实就是前文中提到的烧录logic.bin（cpld部分的bin）。
步伐有改动，就编译后烧录步伐；VE有改动，就烧录VE。
两者相互独立，各烧各的。烧录没有先后顺序之分。两者的烧录接线都相同，只是按钮差别。
新开发板的第一次烧录，必须先烧录VE，再烧录步伐。
烧录支持三种方式：daplink、jlink和串口。
daplink烧录：
daplink方式是官方推荐的烧录方式，官方提供的烧录工具属于这种范例。
1. 设置烧录方式：
如果使用daplink来烧录，需要在platformio.ini中进行相应设置。
设置方法：
修改upload_protocol项，使：upload_protocol = cmsis-dap-openocd
2. 烧录步伐：
烧录方法和上边的编译相似，也是2种方式：下边按钮、命令方式。
如下图（二选一）：
烧录命令：pio run -e release -t upload
3. 烧录ve文件：
在烧录ve设置时，只支持两种方式：左边栏和命令方式。
如下图：（二选一）
烧录命令：pio run -e release -t logic
注：烧录到flash的ve设置，就是在platformio.ini中指定的board_logic_ve项。
如样例中的：board_logic.ve = example_board.ve
4. 烧录效果提示：
在烧录固件大概ve设置完成时，都会有SUCCESS提示。
如果烧录失败，会有红色Error信息给出对应的失败缘故原由。
烧录中，最常见的报错是 “Error connecting DP: cannot read IDR”。
如果是新焊接的板子，需要查抄：芯片是否有虚焊、芯片供电、link接线管脚是否正常，是否对应；
如果是正常使用中突然出现，可以Boot0拉高，重新上电芯片，重新插拔烧录器，再尝试。
Jlink烧录：
Jlink烧录和daplink烧录有两点差异，其他均完全相同。
1. 在初次烧录前，需要先安装插件zadig-2.8.exe。
注：该插件是jlink正常驱动的插件。在安装该插件前，确保电脑上已经安装过jlink的驱动，并能正常使用jlink。
安装插件时，需要将jlink毗连到电脑，然后再安装。
该插件位于SDK解压后的根目次下。
安装方式参下图：
注：开发中如重装过电脑，或重新安装过jlink驱动，需要再次安装该驱动插件。
2. 在设置文件中修改烧录方式为：
upload_protocol = jlink-openocd
这里设置修改完后，烧录按钮（或命令），跟dap-link是完全一样的。
串口烧录：
1. 串口烧录前，要先使芯片进入烧录模式；
进入烧录模式的方法：boot1接地，boot0 接高。
2. 在platformio.ini的设置里，设置成串口烧录并指定PC使用的串口号；
设置方法：
修改upload_protocol项，使：upload_protocol = Serial
修改upload_port项，使：upload_port = COMx （x是编号）
烧录时的波特率可以在[env:serial] 中修改，如：upload_speed = 115200
（注：烧录时芯片端必须使用UART0）
3. 烧录步伐和烧录ve；
按钮方式，串口烧录和jlink烧录时相同（可参照上边jlink烧录的介绍）
命令方式，（把release换成serial）。
烧录步伐的命令：pio run -e serial -t upload
烧录ve的命令：pio run -e serial -t logic
4. 烧录成功后的反馈；
同jlink烧录相似，成功也会有SUCCESS提示；
烧录失败会有红色FAIL提示错误缘故原由。
总结下几个常用命令（如果使用命令的话）：
编译（debug）：pio run -e dev -v
#串口烧录ve设置：pio run -e serial -t logic
#串口烧录code：pio run -e serial -t upload
jlink烧录ve设置: pio run -e release -t logic
jlink烧录code: pio run -e release -t upload
注：这里的烧录VE，其实是烧录logic。更多信息请参考后边描述。
三、daplink（或jlink）仿真：
烧录完成后，如果要仿真跟踪代码时，可通过daplink或jlink的方式。
使用时，需要在platformio.ini中指定：
用daplink时：debug_tool = cmsis-dap-openocd
用jlink时：debug_tool = jlink-openocd
在仿真的操作上，两种方式完全相同。
按以下步调启动：
正常运行起来后，这个样子：
接下来就可以单步步伐了。debug调试中的快捷键和VS一致。
注：从SDK1.5.0之后（安装包为 AgRV_pio-1.5.0-win64-release），debug调试 除了当前的pio-debug外，还支持cortex-debug插件。具体使用方法，请参考 网盘文档《AG32下使用cotex插件调试步伐》
四、增长编译目次
在开发中，新增了c文件和h文件，怎么编译进来？
- 如果新增文件在原有路径下，则会被自动关联进来编译；
- 如果新增一个文件夹，则要把该文件夹参加到编译选项中；
如果文件夹下存放C文件：在src_filter中增长该文件夹
如果文件夹下存放h文件：在src_build_flags中增长该文件夹
举例：
在example项目里，只有一个src文件夹（里边存放全部.c和.h）。编译设置为：
src_dir = .
include_dir = ./src
build_src_filter = "-<*> +<./src/**/*.c>"
其中：
src_dir定义“.c文件编译时，查找路径的基路径”
include_dir定义“.h文件编译时，查找路径的基路径”
build_src_filter 定义 “.c文件从哪些路径下搜索”，星号代表通配，双星代表子目次通 配，+表现增长一个搜索路径，-表现去除一个搜索路径
如果要新增一个文件夹print（跟src同级），里边也有.c和.h，可以设置如下：
src_dir = .
include_dir = .
build_src_filter = "-<*> +<./src/**/*.c> +<./print/**/*.c>"
src_build_flags = -Isrc -Iprint
其中：
include_dir路径也退回到根路径下；
build_src_filter 参加print文件夹的选项；
src_build_flags 是新增的“设置头文件查找路径”的选项。每个头文件路径用 -I 来参加， 多个-I之间加空格。
注意：在build_src_filter和src_build_flags中，都是使用相对路径。他们是从src_dir/include_dir定义的基路径上再开始的。
如果工程含有c++的文件，只需在build_src_filter的选项中增长cpp选项，如：
build_src_filter = "-<*> +<./src/**/*.c> +<./src/**/*.cpp>"
五、脱机烧录：
脱机烧录前需要先编译出二合一的batch.bin（这个bin是code和ve整合后的bin）。
方式如下：
编译完成后，可以在工程路径下找到生成的 xxxx_release_batch.bin。
然后，运行PC下载工具（该工具在SDK安装路径下）：
下载方式可选4种：
挑选对应的方式。
然后点左边“Query Device ID”按钮，如果毗连正常的话，会表现正常ID：
（4种方式，毗连正常的话，都能获取到设备ID）
（注意，如果选串口方式，要boot1接地， boot0 接高）
然后，点右下角“download”按钮下载步伐。
如果成功，可以看到成功信息；
如果失败，会有红色报错信息。
六、更多：了解platformIO
这里描述下platformIO是什么。
在环境安装时，安装完VSCode后，首先下载的插件就是platformIO IDE。
它是VScode的一款第三方插件，这款插件本身就是一套IDE开发环境。
访问platformIO的官网就知道，它是一套开放的Iot集成环境平台，允许芯片厂商通过设置和对接，方便地搭建本身芯片的开发环境。
也就是说，VSCode + platformIO + 芯片厂商设置 = 该芯片的IDE编译环境。
在嵌入式开发中，大家比较熟悉的IDE会有 Keil、IAR。而上边构建出来的IDE环境就是雷同Keil、IAR的一整套可开发仿真的环境。只是这套环境比Keil和IAR更强大。
既然AG32芯片是基于platformIO平台的开发环境，那么项目中的设置就是围绕platformIO展开的，上边章节描述的platformio.ini设置（设置编译、烧录、仿真等的设置项）就是用在这里的。
扩展信息：
查看platformIO的官网：platformIO的定位是新一代的IoT集成开发环境。它是基于VSCode的一款插件。VSCode这款强大的文本编辑器辅以PlatformIO插件就可以化身为一款强大的MCU开发环境，支持绝大多数盛行的单片机平台。
我们知道，嵌入式Iot开发中，最让人不舒服的就是差别厂家的芯片要使用差别的集成开发环境。比方：STM32要使用Keil或IAR，Arduino默认使用自家Arduino开发环境，ESP32要使用linux环境大概在windows下部署eclipse再用交叉编译。那么，有没有一个IDE可以大一统起来，集成大多数常用的芯片和模块的开发任务，只要设置完成之后就一劳永逸的呢？没错，那就是 PlatformIO。PlatformIO 试图整合起目前所有主流的硬件平台：TI/ST/EspressIf/Intel/Silicon/… 等，而且提供更便利的接口和更友好的交互，以提高开发服从。
关于platformIO，有兴趣可以去官网获取更多的信息：https://platformio.org/
前边说到，每一款芯片在PlatformIO中需要设置，按照PlatformIO的格式设置后，才气被正常使用（platformio.ini有大量的尺度的控制选项，可进入官网查看）。
官方设置：https://docs.platformio.org/en/latest/projectconf/index.html#projectconf
在实际使用中，除了官方尺度设置（编译、烧录）外，芯片方也会在这个开放平台上自定义一些本身特有的设置项。
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。 |
