Installing the Devtools Package of the Programming Framework

This section describes how to install the FlexDA programming framework.

Before installing the FlexDA programming framework, ensure that the drive partition where the installation directory is located has sufficient space for subsequent installation, deployment, development, and compilation. At least 1 GB space must be reserved.
The installation and use of FlexDA do not require special permissions. This section uses the root user as an example. The procedure is the same for a common Linux user who must have, at a minimum, execute permissions for standard commands, such as cmake and aarch64-none-elf-gcc.

Obtaining the Software Package

Obtain the Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz package according to Software Packages and decompress it. The directory structure is as follows:
```
├── 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
```
- Installation package: Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz
- Signature files: Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz.cms and Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz.crl

Decompress the extracted Data-Acceleration-Kit-Virtualization_{version}_FlexDA-Devtools.tar.gz package. The directory structure is as follows:

├── 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

For the OVS feature, you can obtain the following software package:

OVS software package (Arm): SP925D/FlexDA_Devtools-{version}-Linux-Kunpeng.run

Reading the User Agreement

The FlexDA software package contains the Software License Agreement. Before installing and deploying FlexDA, read and understand the terms of the agreement. If you continue the installation, it means that you have understood and accepted the agreement.

Method 1: Installing the Programming Framework Using a Software Package

This section uses the OVS feature as an example. For details about the OS and software requirements, see Deploying the Development Environment.

Obtain the FlexDA_Devtools-{version}-Linux-Kunpeng.run software package and upload it to an executable path (for example, /home/workspace) on the compilation server.
- The installation path cannot contain spaces or special characters ; | & $ > < ` ! # ? * { } [ ] ~ , ' "
- The length of the installation path cannot exceed 4096 characters. Otherwise, flexda_sdk cannot properly compile or generate firmware.
Go to the directory where the software package is stored and run the following command to add the execute permission on the software package:
```
chmod u+x FlexDA_Devtools-{version}-Linux-Kunpeng.run
```

Verify the software package integrity.

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

If the following information is displayed, the software package meets the integrity requirements.

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

Install the FlexDA programming framework.

Perform the installation.
- To install it in the current path, run the following command:
```
./FlexDA_Devtools-{version}-Linux-Kunpeng.run --install
```
- To install it in a custom path, create a directory and then run the installation command.
```
mkdir -p {Custom installation path}
./FlexDA_Devtools-{version}-Linux-Kunpeng.run --install {Custom installation path}
```
- If a flexda_sdk folder exists in {Custom installation path}, the following error information is displayed during the installation:
```
ERROR: The directory 'flexda_sdk' already exists.
```
- If forced installation is required, add the --force option.
```
./FlexDA_Devtools-{version}-Linux-Kunpeng.run --install {Custom installation path} --force
```
  In forced installation, the flexda_sdk folder will be overwritten.
```
WARN: flexda_sdk directory will be overwritten.
```

When the following information is displayed, enter Y or YES (case insensitive) within 30s to accept the agreement and continue the installation. Entering any other character will stop the installation.

=======================================================================================
                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...

The installation is successful if the following information is displayed:

           
                Install success !

Check whether the installation takes effect.
```
{Custom installation path}/flexda_sdk/tools/compiler/flexdacc -v
```
The installation is successful if the following information is displayed:
```
flexdacc version: {version}(release)
```

Method 2: Installing the Programming Framework Using a Script

In addition to the .run package, the software package contains a quick installation script flexda_ctl.sh.

Verify the software package consistency.
```
bash flexda_ctl.sh {Board model} --check
```
{Board model} is SP925D, which corresponds to the OVS feature.

If the following information is displayed, the software package meets the integrity requirements.
```
Verifying the integrity of the software package...
The software package SHA256 check succeeded.
```

Install the FlexDA programming framework.

Run the installation script.
- To install it in the current path, run the following command:
```
bash flexda_ctl.sh {Board model} --install
```
  For example, run the following command to install OVS in the SP925D directory:
```
bash flexda_ctl.sh SP925D --install
```
- To install it in a custom path, create a directory and then run the installation command.
```
mkdir -p {Custom installation path}
bash flexda_ctl.sh {Board model} --install {Custom installation path}
```
- If a flexda_sdk folder exists in {Custom installation path}, the following error information is displayed during the installation:
```
ERROR: The directory 'flexda_sdk' already exists.
```
- If forced installation is required, add the --force option.
```
bash flexda_ctl.sh {Board model} --install {Custom installation path} --force
```
  In forced installation, the flexda_sdk folder will be overwritten.
```
WARN: flexda_sdk directory will be overwritten.
```

=======================================================================================
                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...

The installation is successful if the following information is displayed:

          
               Install success !

Parent topic: OVS Programming