Arm DesignStart FPGA云平台开发环境搭建与调试指南

1. Arm DesignStart FPGA云平台开发环境搭建

1.1 AWS EC2 F1实例配置要点

在AWS控制台启动实例时，必须选择"DesignStart FPGA on Cloud with ArmDS Software Debug Enabled 1.0" AMI镜像。这个预配置镜像包含以下关键组件：

• Cortex-M33双核硬件描述文件（预合成比特流）
• Arm Development Studio调试服务端组件
• 虚拟UART通信模块
• 预加载工具链和示例工程

安全组配置需要开放两个关键端口：

• TCP 3010：用于RDDI调试协议通信
• TCP 22：SSH管理通道

建议采用最小权限原则，将源IP范围限定为开发者办公网络IP段。实际操作中，在EC2控制台的"安全组"→"入站规则"中添加如下规则：

类型 协议 端口范围 源 自定义TCP TCP 3010 Your.IP.Address/32 SSH TCP 22 Your.IP.Address/32

1.2 本地Arm DS开发环境准备

开发主机需要满足：

• Arm Development Studio 2019.1或更高版本
• 有效的许可证文件（浮动或节点锁定）
• 至少4GB可用磁盘空间（用于存放配置数据库）

配置数据库导入步骤：

1. 通过SCP下载AWS实例中的配置数据库：

scp -r -i "your_key.pem" ec2-user@your-instance-ip:/home/ec2-user/developmentstudio-workspace/AWS_M33x2_Bronze ./

2. 在Arm DS中选择File → Import → General → Existing Projects into Workspace
3. 勾选"Copy projects into workspace"选项
4. 最后在Preferences → Arm DS → Configuration Database中重建数据库索引

注意：每次启动新实例时，AWS会分配新的公网IP，需相应更新调试配置中的服务器地址。

2. FPGA映像加载与调试通道建立

2.1 FPGA映像加载流程

在SSH连接到AWS实例后，需按顺序执行以下操作：

1. 清除现有FPGA映像：

sudo fpga-clear-local-image -S 0

2. 加载Arm提供的预验证映像：

sudo fpga-load-local-image -S 0 -I agfi-04868158ad82abd7e

3. 在另一个终端启动虚拟UART：

sudo ~/vUART/uart 0x000 0x004 0x008 ./uart_log.txt 1

4. 在主终端启动调试服务器：

sudo bash cd /opt/arm/developmentstudio-2019.1/sw/debughw/debug_server export LD_LIBRARY_PATH=$PWD ./rddidap_serverd -log -rddi_dap_dll ./librddi_3rd_party_probe_aws.so -debuglog

2.2 调试配置关键参数

在Arm DS中创建调试配置时，需要特别注意以下参数设置：

配置项	推荐值	作用说明
Target Connection	AWS Virtual Debug	指定使用AWS虚拟调试接口
Server Address	your-instance-public-ip	AWS实例当前公网IP
Probe Type	none	使用软件调试模式
Debug from Symbol	main	从main函数开始调试
RO Base Address	0x80000000	Cortex-M33默认ROM起始地址

调试连接字符串格式：

server=<实例IP>;probe=none

3. 应用开发与调试实战

3.1 Hello World示例工程构建

创建新工程的详细步骤：

1. 选择File → New → C Project
2. 项目类型选择：Executable → Hello World ANSI C Project
3. 工具链选择：Arm Compiler 6
4. 关键编译参数配置：
   • Target CPU: Cortex-M33
   • FPU: None (本平台不支持硬件浮点)
   • RO Base: 0x80000000
   • RW Base: 0x20000000

工程属性中需要检查的构建变量：

CPU_TYPE = cortex-m33 CFLAGS = -mcpu=$(CPU_TYPE) -mthumb -O0 -g LDFLAGS = -Wl,--ro-base=0x80000000 -Wl,--rw-base=0x20000000

3.2 TF-M可信固件开发要点

3.2.1 环境准备特殊要求

由于TF-M对编译器版本的敏感性，需要额外安装Arm Compiler 6.12：

1. 从Arm官网下载AC6.12安装包
2. 在Arm DS中添加新工具链路径
3. 设置项目属性→C/C++ Build→Tool Chain Editor
   • Current toolchain: Arm Compiler 6.12
   • Current builder: Gnu Make Builder

3.2.2 多镜像加载技巧

TF-M需要分别加载bootloader和主固件：

sudo ~/preloader/preload_software -S 0 \ -b mcuboot.bin 0x10000000 \ -b tfm_sign.bin 0x10080000

内存布局关键地址：

• 0x10000000: MCUboot起始地址
• 0x10080000: TF-M主镜像起始地址
• 0x20000000: SRAM起始地址

4. 高级调试技巧与问题排查

4.1 多核调试实战

当需要调试双Cortex-M33核心时：

1. 使用特殊的多核启动固件：

./preload_software -S 0 -p MultiCore_Bringup.elf

2. 在Arm DS中创建两个调试配置：

   • 配置1：连接Cortex-M33 #0
   • 配置2：连接Cortex-M33 #1

3. 调试会话管理技巧：

   • 先连接核心0，设置断点
   • 再连接核心1，避免时序冲突
   • 使用Semihosting查看各核状态

4.2 常见问题解决方案

问题1：无法建立调试连接

• 检查AWS安全组3010端口是否开放
• 确认debug_server进程正在运行（ps -ef | grep rddidap）
• 验证实例IP是否变更（EC2控制台→实例→描述）

问题2：调试时程序跑飞

• 在main()开始处添加死循环：

volatile int debug_flag = 1; while(debug_flag) {}

• 连接调试器后手动修改debug_flag值为0
• 检查向量表是否正确加载（readelf -S your_elf.axf）

问题3：虚拟UART无输出

• 确认uart进程正在运行
• 检查内存映射地址是否正确（0x0, 0x4, 0x8）
• 尝试调整uart命令最后一个参数（0/1切换输出模式）

5. 性能优化与生产部署

5.1 FPGA时序约束优化

通过AWS CLI获取时序报告：

aws ec2 describe-fpga-image-attribute \ --fpga-image-id agfi-04868158ad82abd7e \ --attribute loadPermission

关键时序参数建议：

• 时钟偏移：±0.5ns以内
• 建立时间余量：>1.2ns
• 保持时间余量：>0.8ns

5.2 生产映像部署流程

1. 生成Amazon FPGA映像(AFI)：

aws ec2 create-fpga-image \ --input-storage-location Bucket=my-bucket,Key=design/checkpoint.tar \ --logs-storage-location Bucket=my-bucket,Key=logs/

2. 查询AFI状态：

aws ec2 describe-fpga-images --fpga-image-ids afi-1234567890abcdef0

3. 全局部署：

aws ec2 modify-fpga-image-attribute \ --fpga-image-id afi-1234567890abcdef0 \ --load-permission Add=[{Group=all}]

实际开发中发现，通过合理设置Arm DS中的优化等级（-O2）和链接器脚本调整，可以将Cortex-M33的性能提升约30%。特别是在中断密集的应用场景中，建议将关键ISR函数放在ITCM区域执行，实测可降低中断延迟约15个时钟周期。