f1实例OpenCL开发最佳实践

本文介绍如何在f1实例上使用OpenCL（Open Computing Language）制作镜像文件，并烧写到FPGA芯片中。

说明：

• 本文所述所有操作都必须由同一个账号在同一地域里执行。
• 强烈建议您使用RAM用户操作FaaS实例。为了防止意外操作，您需要让RAM用户仅执行必要的操作。在操作FPGA镜像及下载时，因为您需要从指定的OSS Bucket下载原始DCP工程，所以您必须为FaaS管理账号创建一个角色，并授予临时权限，让FaaS管理账号访问指定的OSS Bucket。如果需要对IP加密，必须授予RAM用户KMS相关权限。如果需要做权限检查，必须授予查看用户资源的权限。

前提条件

• 创建f1实例，确认实例能访问公网，并且实例所在安全组中已经添加规则放行SSH（22）端口的访问。

  说明：f1实例只能使用镜像市场的FaaS F1基础镜像。详细信息，请参见 创建f1实例。

• 您已经 登录ECS管理控制台，在f1实例的详情页上，获取实例ID。

• 您必须先 开通OSS服务，并 创建一个OSS Bucket 用于上传您的文件。Bucket与f1实例必须属于同一个账号、同一个地域。

• 如果需要加密文件，开通密钥管理服务（KMS）。

• 使用RAM用户操作FPGA，必须完成以下操作：

  • 创建RAM用户 并 授权。
  • 创建RAM角色 并 授权。
  • 获取AccessKey ID和AccessKey Secret。

操作步骤

按以下步骤在f1实例上使用OpenCL Example制作镜像文件，并烧写到FPGA芯片中。

第 1 步. 远程连接实例

远程连接Linux实例。

第 2 步. 安装基础环境

运行以下脚本安装基础环境。

1. source /opt/dcp1_0/script/f1_env_set.sh

第 3 步. 下载官方的OpenCL Example

按以下步骤下载官方的OpenCL Example。

1. 创建并切换到/opt/tmp目录。

   1. mkdir -p /opt/tmp
   2. cd /opt/tmp

   此时，您在/opt/tmp目录下。
   

2. 依次执行以下命令下载并解压Example文件。

   1. wget https://www.altera.com/content/dam/altera-www/global/en_US/others/support/examples/download/exm_opencl_matrix_mult_x64_linux.tgz
   2. tar -zxvf exm_opencl_matrix_mult_x64_linux.tgz

   解压后的目录如下图所示。