FINN快速安装教程——非root权限下运行Docker和XILINX环境配置

@Boom Clap

已于 2024-06-18 19:19:50 修改

阅读量862

点赞数 38

分类专栏： FINN+FPGA 文章标签： docker 容器运维 fpga开发

于 2024-06-15 19:30:07 首次发布

本文链接：https://blog.csdn.net/qq_46589863/article/details/139700801

版权

FINN+FPGA 专栏收录该内容

3 篇文章 0 订阅

订阅专栏

4. 正确设置FINN_XILINX_PATH和FINN_XILINX_VERSION环境变量

（1）配置XILINX环境变量

参考链接：

FINN快速安装教程——安装Ubuntu22.04 LTS系统-CSDN博客

FINN快速安装教程——下载安装 Vitis/Vivado 2022.2软件-CSDN博客

三. 环境安装详细步骤

该部分根据FINN编译器的“阅读文档”（FINN — FINN documentation）展开。打开链接，点击左侧导航栏，找到Getting Started-->Quickstart。

1. Ubuntu22.04 LTS系统的安装教程

2. 下载安装 Vitis/Vivado 2022.2软件

1、2 已在主页FINN+FPGA专栏完结。接下来是环境安装详细步骤3、4：

3. 能够在非root权限下运行Docker

4. 正确设置FINN_XILINX_PATH和FINN_XILINX_VERSION环境变量

3. 非root权限下运行Docker

默认情况下，Docker 命令会使用 Unix socket 与 Docker 引擎通讯。而只有 root 用户和Docker 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 root 用户。因此，更好地做法是将需要使用 Docker 的用户加入 Docker 用户组。

（1）安装Docker

在Ubuntu系统中安装Docker时，官方推荐Ubuntu系统最好是64位的，可以在终端执行 uname -a 命令来查看当前系统是否为64位操作系统。以下操作均在命令终端执行。

以下是具体步骤：

1. 安装前先卸载操作系统默认安装的Docker

sudo apt-get remove docker docker-engine docker.io containerd runc

2. 准备安装

#安装必要支持
sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release
#添加 Docker 官方 GPG key
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

#添加 apt 源:
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

#更新源
sudo apt update
sudo apt-get update

3. 安装Docker

#安装最新版本的Docker
sudo apt install docker-ce docker-ce-cli containerd.io
#等待安装完成

#查看Docker版本
sudo docker version

#查看Docker运行状态
sudo systemctl status docker

4. 安装 Docker 命令补全工具

sudo apt-get install bash-completion

sudo curl -L https://raw.githubusercontent.com/docker/docker-ce/master/components/cli/contrib/completion/bash/docker -o /etc/bash_completion.d/docker.sh

source /etc/bash_completion.d/docker.sh

5. 验证Docker是否安装成功

#查看安装的 Docker 版本，成功安装会出现版本号
sudo docker version

（2）添加国内镜像源

国内使用Docker下载镜像时会出现网速慢的问题，所以需要添加国内镜像源。这里添加4个国内镜像源，分别是Docker官网国内源、网易、中科大以及阿里云的镜像源，可以自行按需添加。

1. 创建daemon.json文件，并添加镜像地址

运行 sudo vim /etc/docker/daemon.json 来创建daemon.json文件(报错可能是 vim 插件未安装)

#安装 vim 命令行输入：
sudo apt install vim
#若依赖关系报错，则将vim-common依赖删除，输入：
sudo apt purge vim-common
#再次输入sudo apt install vim即可安装，输入Y同意，等待安装完成。
sudo apt install vim

然后将以下内容复制到 daemon.json 文件中。进入后，按 “i” 编辑写入镜像源，“esc”退出编辑，“:wq”退出保存。

{
    "registry-mirrors": [
        "https://docker.mirrors.ustc.edu.cn"
    ]
}

上面我只添加了"https://docker.mirrors.ustc.edu.cn"（推荐）。如有需要，可在上述基础上添加其他镜像，如下所示。注意：https://3frzt237.mirror.aliyuncs.com是我自己的阿里云加速器地址，想使用自己的阿里云加速器地址，请到阿里云申请。链接如下：容器镜像服务 (aliyun.com)

{
    "registry-mirrors": [
        "https://registry.docker-cn.com",
        "http://hub-mirror.c.163.com",
        "https://3frzt237.mirror.aliyuncs.com"
    ]
}

2. 重启Docker

sudo service docker restart

3. 查看添加的国内源是否生效

sudo docker info | grep Mirrors -A 4

（3）非root权限下运行Docker

1. 添加docker组

sudo groupadd docker

2. 将当前用户加入到docker组

sudo usermod -aG docker $USER
#如果出错用 sudo gpasswd -a %USER docker 试试

3. 新建docker组内元素，使权限生效

newgrp docker

4. 验证是否成功，使用docker拉取“hello-world”镜像

docker run hello-world

5. 最后一步更新.bashrc文件

我们需要编辑 ~/.bashrc文件，并在文件末尾增加如下一行,如果不在.bashrc文件中增加下面这一行命令

#如果没有此行命令，你会发现，当你每次打开新的终端
#你都必须先执行一次 “newgrp docker” 命令
#否则当前用户还是不可以执行docker命令
groupadd -f docker

4. 正确设置FINN_XILINX_PATH和FINN_XILINX_VERSION环境变量

（1）配置XILINX环境变量

1. 打开新的命令终端，输入：

gedit ~/.bashrc

2. 编辑环境变量

打开该文件，键盘按“i”开始编辑，找到最后一行新加入如下代码。按“esc”退出编辑，输入“:wq”保存关闭文件夹。

source [your_path]/Xilinx/Vivado/2022.2/settings64.sh
source [your_path]/Xilinx/Vitis_HLS/2022.2/settings64.sh
source [your_path]/Xilinx/Vitis/2022.2/settings64.sh
#上面是前期XILINX工具配置，在FINN+FPGA专栏，FINN快速安装教程——下载安装 Vitis/Vivado 2022.2软件。


#下面的是配置FINN项目地址，Vitis版本和PYNQ板型号，我在这一次提前配好。
export FINN_HOST_BUILD_DIR=/home/x/Xilinx/maven/finn0.10/finn/build
export FINN_XILINX_PATH=/home/x/Xilinx
export FINN_XILINX_VERSION=2022.2
export PYNQ_BOARD=Pynq-Z2

#注意：/home/x/Xilinx/maven/finn0.10/finn/build 
#是FINN的项目地址，大家请根据自己在github下载的FINN项目路径配置。

3. 将该文件保存，并更新