腾讯云 FPGA 云服务器 - FPGA 镜像在线烧录
文档简介:
操作场景:
本文介绍如何使用 在线烧录 FPGA 镜像 API 接口进行 FPGA 镜像在线烧录。
操作场景
本文介绍如何使用 在线烧录 FPGA 镜像 API 接口进行 FPGA 镜像在线烧录。
操作步骤
配置存储桶
1. 参考 创建存储桶,创建一个用于存放 FPGA 镜像文件的存储桶。
2. 单击存储桶 ID,进入存储桶配置页面。
3. 选择左侧菜单栏中的权限管理 > Policy权限设置,单击 Policy权限设置中的添加策略。如下图所示:


4. 在弹出的添加策略窗口中进行配置:
4.1 在选择模板步骤中,进行以下配置。如下图所示:


被授权用户:选择指定用户。
资源范围:选择整个存储桶。
选择模板:选择只读对象(含列出对象列表)。
4.2 单击下一步,完成权限配置。
4.3 在配置策略步骤中,进行以下配置。如下图所示:


效力:选择允许。
用户:选择云服务 - 腾讯云 CVM。
资源:选择整个存储桶。
操作:选择读操作(含列出对象列表)。
5. 单击完成,完成权限配置。
上传镜像文件并获取 COS URL
1. 参考 上传对象,将需烧录的 FPGA 镜像文件上传到已配置的存储桶。
注意
目前仅支持 xclbin 格式的 FPGA 镜像文件。
2. 单击已上传的镜像文件所在行右侧的详情,进入对象详情页。
3. “基本信息”的“对象地址”即为需获取的 COS URL。如下图所示:


进行烧录
通过 API Explorer 工具、命令行工具 TCCLI 或其他工具调用腾讯云 在线烧录 FPGA 镜像 API 接口进行烧
注意事项:
可调用 查看实例列表 接口,通过返回字段 LatestOperation 及 OperationState(当 LatestOperation 为 ProgramFpgaImage 时,OperationState 表示当前的烧录情况),获取 FPGA 镜像烧录流程的状态。
说明
由于 查看实例列表 接口仅支持查询实例最近一次的操作状态,若您在发起镜像烧录后进行了其他实例操作,则可能无法获取镜像烧录流程的状态。后续可使用云审计查看镜像烧录状态,详情请参见 查看操作记录事件详情。
由于目前 xilinx FPGA 卡的 user pf 和 mgmt pf 不互通,在发起烧录流程之后,还需要在子机内部执行以下命令,重新加载 xocl 驱动。
modprobe -r xocl && modprobe xocl
在线烧录示例
1. 获取调用接口所需信息。
待烧录的实例 ID
FPGA 镜像 COS URL
FPGA 卡的 DBDF 号,可通过在实例内部执行 lspci -v -D | grep -i xilinx 命令获取。
2. 使用 API Explorer 工具 对实例发起在线烧录。
在页面中填写相关参数后,单击发送请求发起 API 调用。如下图所示:


1. 参考 安装 TCCLI,安装并配置命令行工具。
2. 获取调用接口所需信息。
待烧录的实例 ID
FPGA 镜像 COS URL
FPGA 卡的 DBDF 号,可通过在实例内部执行 lspci -v -D | grep -i xilinx 命令获取。
3. 执行命令发起烧录。示例如下:
tccli cvm ProgramFpgaImage \--InstanceId ins-abcdefgh \--FPGAUrl https://test-123456789.cos.ap-guangzhou.myqcloud.com/01_kernel_c.xclbin \--DBDFs ‘[“0000:00:08.0”]’