使用f1 RTL

本文描述如何使用f1 RTL（Register Transfer Level）。

说明：

• 本文所述所有操作都必须由同一个账号在同一地域里执行。
• 强烈建议您使用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。

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

1. cd /opt/dcp1_0/hw/samples/dma_afu
2. run.sh

说明：编译时间较长，请耐心等待。

1. 
   运行命令初始化 faascmd。#如果需要，添加环境变量及运行权限
2. export PATH=$PATH:/opt/dcp1_0/script/
3. chmod +x /opt/dcp1_0/script/faascmd
4. # 将hereIsYourSecretId替换为您的AccessKey ID，hereIsYourSecretKey替换为您的AccessKey Secret
5. faascmd config --id=hereIsYourSecretId --key=hereIsYourSecretKey
6. # 将hereIsYourBucket换为华东1地域里OSS Bucket名称
7. faascmd auth --bucket=hereIsYourBucket

1. faascmd upload_object --object=dma_afu.gbs --file=dma_afu.gbs

1. #  将hereIsYourImageName替换为您的镜像名称
2. faascmd create_image --object=dma_afu.gbs --fpgatype=intel --name=hereIsYourImageName  --tags=hereIsYourImageTag --encrypted=false --shell=V0.11

1. 
   查看镜像是否制作成功：运行命令 faascmd list_images。返回结果里，如果出现"State":"success"，表示镜像制作成功。请记录返回结果里显示的FpgaImageUUID，稍后会用到。
   [url=http://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/pic/61412/cn_zh/1516934679202/faascmd_listImages.png][/url]

   
   说明：如果没有开启Huge pages，运行以下命令启用Huge pages。[list=1]

2. sudo bash -c "echo 20 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages"