(Optional) Compiling Source Code

Prerequisites

All operations of source code compilation are performed as user root.

Procedure

1. Obtain the .run package. For details, see Obtaining Software Packages.
2. Install the .run installation package to the default directory or a specified directory. The default directory /usr/local/HiAI/ is used as an example. For details about how to install the .run installation package, see Installing the Driver.
   Figure 9-5 shows the directory structure of the decompressed package.

   Figure 9-5 Directory structure of the decompressed package
   

   • install.sh: After the source code compilation is complete, run this script to copy the compiled file to the installation directory of the .run installation package.
   • readme.txt: compilation description document.
   • source.tar.gz: source code package.

Prerequisites

• The software to be installed before source code compilation is as follows, but is not limited to the following software. You can install the software as prompted.
  • Ubuntu (Due to PDF document format restrictions, if a command line is wrapped, copy the command to Word or Notepad, replace the line wrap point with a space to merge the lines into one, and copy it back to the server for execution.)

    apt-get install gcc linux-headers-$(uname -r) g++ texinfo flex bison autoconf automake libtool libsysfs-dev

  • CentOS (Due to PDF document format restrictions, if a command line is wrapped, copy the command to Word or Notepad, replace the line wrap point with a space to merge the lines into one, and copy it back to the server for execution.)

    yum install gcc linux-headers-$(uname -r) g++ texinfo flex bison autoconf automake libtool libsysfs

Procedure

To compile source code, you need to decompress the source code package, compile the source code, and specify the compilation tool chain and kernel source code directory. The procedure is as follows:

1. Run the cd /usr/local/HiAI/source command to go to the directory of the source code package.
2. Run the tar zxvf source.tar.gz command to decompress the source code package source.tar.gz.
3. Run the cd source command to go to the source code directory.
4. This step applies only to the Ubuntu OS.

   Run the following command to configure the user email address and user name:

   git config --global user.email "you@example.com"
   git config --global user.name "Your Name"

5. Run the source code compilation command make ARCH=? KERNEL_DIR=? O=?.

   Parameters are described as follows:

   • ARCH: compilation platform, Arm64 by default.
   • KERNEL_DIR: kernel root directory, which needs to be specified for the compilation driver ko. This directory must contain the .config file and include directory.
   • O: output directory of compilation results. The value can be an absolute directory or a relative directory. The default value is the out folder in the current directory.

   Example:

   • Compilation command on the Ubuntu x86 OS: (The following is a command. Due to the restriction of the PDF file format, the command that exceeds one line will be automatically wrapped. Therefore, you need to manually combine the following command into one line and then copy the line to the server for execution.)

     make ARCH=x86 HOST_OS=Ubuntu KERNEL_DIR=/usr/src/linux-headers-`uname -r`

   • Compilation command on the CentOS x86 OS:

     make ARCH=x86 HOST_OS=CentOS KERNEL_DIR=/usr/src/kernels/`uname -r`

   • Compilation command on the CentOS Arm OS: (The following is a command. Due to the restriction of the PDF file format, the command that exceeds one line will be automatically wrapped. Therefore, you need to manually combine the following command into one line and then copy the line to the server for execution.)

     make ARCH=arm64 HOST_OS=CentOS KERNEL_DIR=/usr/src/kernels/`uname -r` CROSS_COMPILE=/usr/bin/

     In the preceding command, /usr/bin/ is the local GCC path in the Arm environment.

   • CROSS_COMPILE: indicates the cross compilation GCC. This parameter needs to be specified during cross compilation and compilation in the Arm environment.
   • HOST_OS: indicates the OS on which the compiled image runs. Currently, CentOS and Ubuntu (default) are supported.
   • uname -r: indicates that the current kernel version is used for source code compilation. Before running the compilation command, run make clean to clear the files generated by the last make command.

6. If the page shown in Figure 9-6 is displayed, the compilation is successful.
   Figure 9-6 Compilation result
   

Prerequisites

You have decompressed and compiled the installation package. For details, see Compiling Source Code.

Procedure

1. Run the install.sh script in the source directory to install the compilation file to the .run installation package directory.

   Installation command: ./install.sh compile_out_dir

   compile_out_dir is the output directory of source code compilation results.

   • If the O parameter is set during the compilation, the value of compile_out_dir must consistent with the value of the O parameter.
   • If the default directory is used, the value is /out/release_imags.

   If the following information is displayed, the Installation is successful:

   compiler files install success

2. Run the reboot command to restart the host OS.