Quick Start (Source Code Porting)

This document uses the source code porting CLI tool as an example to describe how to use the DevKit to scan and analyze software packages and quickly complete porting. It is intended for development engineers who need to port projects written in C, C++, ASM, Fortran, Go, or interpreted languages from x86 environments to the Kunpeng platform.

1. Obtain the source code. Download the source package smartdenovo-master.zip from GitHub.
2. Upload the source package to the user-defined directory (for example, /home/devkit_demo) on the Kunpeng server where the Kunpeng DevKit CLI is deployed. Then extract the package.

   cd /home/devkit_demo/ && unzip smartdenovo-master.zip

3. Scan the source code. Use the DevKit CLI to scan the uploaded source package.

   devkit porting src-mig -i /home/devkit_demo/smartdenovo-master -b make -c make

   

   -i: Path to the folder or package of the source code to be scanned.

   -b: specifies the build tool as make.

   -c: specifies the source code build command as make.

   The following information is displayed. The tool generates JSON, CSV, HTML, and .patch reports.

   

   You can directly use the .patch file generated by the tool to apply source code modifications to source files. For details, see Source Code SQL Writeback Patch.

   cd /home/devkit_demo/smartdenovo-master
   patch -p1 < /home/devkit_demo/Code_Porting_20260XXXXXXXXX_hAsnsZ.patch

   

4. View the source code porting report (HTML format).
   On the Source Code Porting Report tab page, locate the row for the line of code to be ported and click Expand in the Handling Suggestions column. See Figure 1.

   Figure 1 Viewing suggested source code
   

   The porting report indicates that two files must be modified. View the modification suggestion for each file and modify the source code based on the suggestions.

5. Modify the source code.
   1. Modify the Makefile.

      Modify the Makefile based on the source code processing suggestions in the source code porting report. See Figure 2.

      Figure 2 Suggestions for porting the Makefile source code
      

      According to the preceding suggestions, add the -march=armv8.2-a -fsigned-char option to the CFLAGS variable in the makefile, and delete the -mpopcnt and -mssse3 options of the CFLAGS variable. After obtaining and installing the Kunpeng System Library (BoostKit-ksl installation package), add -I /usr/local/ksl/include/ -L /usr/local/ksl/lib/ -lavx2ki to the GLIBS variable.

      Figure 3 shows the modified code (x86_64 and AArch64 are distinguished from each other).

      Figure 3 Updated Makefile
      
   2. Modify the ksw.c file.

      Modify the ksw.c file based on the source code processing suggestions in the source code porting report. See Figure 4.

      Figure 4 Suggestions for porting the ksw.c file
      

      According to the suggestion, set the branch definitions contained in the header files for x86 and AArch64. This ensures that the code is adapted to both x86 and AArch64. The following information is displayed (using GCC 4.8.5 as an example):

      Add lines 1 to 3 and replace line 31 with lines 31 to 33.

      1    #if defined(__aarch64__)
      2       #include "avx2ki.h"
      3    #endif
      ...
      31   #if defined(__x86_64__)
      32      #include <emmintrin.h>
      33   #endif

6. Perform the verification.
   1. Go to the source code directory and run the following command to complete the compilation. See Figure 5. If the compilation fails, see Troubleshooting Cases.

      1	make clean && make

      Figure 5 make command
      
   2. After the compilation, run the following command to perform the installation and check the installation result. See Figure 6.

      1	make install

      Figure 6 Verifying the installation
      

      The preceding information indicates that the SMARTdenovo software has been installed on the Kunpeng platform.