安装编程框架开发态软件包

本节介绍FlexDA编程框架的安装步骤。

在安装FlexDA编程框架前，请确保安装目录所在磁盘分区有足够的空间进行后续的安装部署和开发编译。请至少预留1GB空间。
FlexDA编程框架的安装和使用不依赖特殊权限，本节以root用户为例进行介绍，Linux普通用户账号可使用同样的过程进行安装和使用，但用户至少需要有常规命令的执行权限，如cmake、aarch64-none-elf-gcc等。

获取软件包

按照获取软件包获取压缩包Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz，并解压，其结构如下所示。
```
├── Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz
├── Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz.cms
├── Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz.crl
├── Software License Agreement.txt
└── 软件许可协议.txt
```
- 安装包压缩文件：Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz
- 签名文件：Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz.cms和Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz.crl

取其中的Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz，并解压，其结构如下所示。

├── flexda_ctl.sh
├── SP925D
     ├── FlexDA_Devtools-{version}-Linux-Kunpeng.run
     ├── FlexDA_Devtools-{version}-Linux-Kunpeng.run.cms
     ├── FlexDA_Devtools-{version}-Linux-Kunpeng.run.crl
     ├── Software License Agreement.txt
     └── 软件许可协议.txt
└──windows
     ├── FlexDA_Devtools-{version}-Linux-Kunpeng.run
     └── FlexDA-Kit.vsix

针对OVS特性，可以获取的软件包如下：

OVS的ARM软件包：SP925D/FlexDA_Devtools-{version}-Linux-Kunpeng.run

阅读用户协议

按照获取软件包步骤解压FlexDA软件包后，软件包中包含用户协议文件《软件许可协议.txt》（英文版为《Software License Agreement.txt》），请用户在安装部署FlexDA前务必审慎阅读、充分理解《协议》各条款内容，继续安装代表用户已理解并接受《协议》。

安装方式一：通过软件包安装编程框架

本小节以OVS特性为例进行介绍，操作系统及软件要求请参考开发环境部署。

获取软件包FlexDA_Devtools-{version}-Linux-Kunpeng.run，并上传至编译服务器可执行路径下（例如“/home/workspace”）。
- 安装路径中不得有特殊字符（; | & $ > < ` ! # ? * { } [ ] ~ , ' "）或空格。
- 安装路径长度不得超过系统要求最大长度（通常为4096个字符），否则将导致flexda_sdk无法成功编译生成固件。
进入软件包的所在路径，执行以下命令添加对软件包的可执行权限。
```
chmod u+x FlexDA_Devtools-{version}-Linux-Kunpeng.run
```

执行以下命令，校验软件包的一致性和完整性。

./FlexDA_Devtools-{version}-Linux-Kunpeng.run --check

打印如下内容，表示软件包满足一致性和完整性。

Verifying the integrity of the software package...
The software package SHA256 check succeeded.

安装FlexDA编程框架。

执行安装命令。
- 若安装在当前路径下，直接执行以下命令安装FlexDA编程框架。
```
./FlexDA_Devtools-{version}-Linux-Kunpeng.run --install
```
- 若安装在自定义路径下，执行以下命令先创建目录，再执行安装命令。
```
mkdir -p {自定义安装路径}
./FlexDA_Devtools-{version}-Linux-Kunpeng.run --install {自定义安装路径}
```
  - 若{自定义安装路径}已存在flexda_sdk文件夹，执行安装命令时将发生以下报错。
```
ERROR: The directory 'flexda_sdk' already exists.
```
  - 需要强制安装，请添加‘--force’选项。
```
./FlexDA_Devtools-{version}-Linux-Kunpeng.run --install {自定义安装路径} --force
```
    强制安装时会覆盖flexda_sdk文件夹。
```
WARN: flexda_sdk directory will be overwritten.
```

打印如下内容，请在30s内输入“Y”或“YES”（不区分大小写）接受协议继续安装，输入其他任意字符中止安装。

=======================================================================================
                FlexDA Software License Agreement Acknowledgment
=======================================================================================
Important Notice: By proceeding with the installation or upgrade, you acknowledge that 
you have read, understood, and agree to abide by the End User License Agreement (EULA) 
and related terms for the FlexDA software.

For the full text of the license agreement, please refer to:
- The LICENSE file included in the installation package
=======================================================================================

Are you sure you want to continue? (Enter Y to agree and proceed, enter N to cancel the operation) [Y/N]:
Will be automatically canceled in 30 seconds...

打印如下内容，表示安装成功。

Install success !

执行以下命令，检查安装是否生效。

{自定义安装路径}/flexda_sdk/tools/compiler/flexdacc -v

打印如下内容，表示已安装成功。

flexdacc version: {version}(release)

安装方式二：通过脚本安装编程框架

除了直接使用run包安装外，软件包里还提供了快速安装脚本flexda_ctl.sh。

校验软件包的一致性和完整性。
```
bash flexda_ctl.sh {板卡型号} --check
```
其中{板卡型号}为SP925D，SP925D对应OVS特性。

打印如下内容，表示软件包满足一致性和完整性。
```
Verifying the integrity of the software package...
The software package SHA256 check succeeded.
```

安装FlexDA编程框架。

执行安装脚本。
- 若安装在当前路径下，直接执行以下命令安装FlexDA编程框架至对应目录。
```
bash flexda_ctl.sh {板卡型号} --install
```
  例如，执行以下命令，使用脚本安装OVS至SP925D目录下。
```
bash flexda_ctl.sh SP925D --install
```
- 若安装在自定义路径下，执行以下命令先创建目录，再执行安装命令。
```
mkdir -p {自定义安装路径}
bash flexda_ctl.sh {板卡型号} --install {自定义安装路径}
```
  - 若{自定义安装路径}已存在flexda_sdk文件夹，执行安装命令时将发生以下报错。
```
ERROR: The directory 'flexda_sdk' already exists.
```
  - 需要强制安装，请添加‘--force’选项。
```
bash flexda_ctl.sh {板卡型号} --install {自定义安装路径} --force
```
    强制安装时会覆盖flexda_sdk文件夹。
```
WARN: flexda_sdk directory will be overwritten.
```

打印如下内容，请在30s内输入“Y”或“YES”(不区分大小写)接受协议继续安装，输入其他任意字符中止安装。

=======================================================================================
                FlexDA Software License Agreement Acknowledgment
=======================================================================================
Important Notice: By proceeding with the installation or upgrade, you acknowledge that 
you have read, understood, and agree to abide by the End User License Agreement (EULA) 
and related terms for the FlexDA software.

For the full text of the license agreement, please refer to:
- The LICENSE file included in the installation package
=======================================================================================

Are you sure you want to continue? (Enter Y to agree and proceed, enter N to cancel the operation) [Y/N]:
Will be automatically canceled in 30 seconds...

打印如下内容，表示安装成功。

Install success !

父主题： OVS场景编程