---
title: 编译工具使用
description: "编译工具hiasn1cli，位于“/usr/local/ksl/bin”下。用户可以使用它来解析ASN.1脚本，并将ASN.1脚本转换为C语言代码的中间文件（包含多个源文件和头文件）。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/252RC1/accel/kunpengaccel_ksl_16_0153.html
sourcePath: /source/zh/kunpengboostkithistory/252RC1/accel/kunpengaccel_ksl_16_0153.html
indexId: d480e89a736cd07efaaaa6e77d894980e7812d6273e8b9ed7bb6d518e368e15176
---
# 编译工具使用

编译工具hiasn1cli，位于“/usr/local/ksl/bin”下。用户可以使用它来解析ASN.1脚本，并将ASN.1脚本转换为C语言代码的中间文件（包含多个源文件和头文件）。

在本章节的示例中，将展示如何使用编译工具hiasn1cli将.asn文件转换为C语言源码文件。

#### 获取帮助

执行以下命令获取命令相关帮助。

```
./hiasn1cli --help
```

输出如下回显信息。

```
ASN.1 Compiler, hiasn1cli 2.3.0
Copyright (c) 2023-2024 Huawei Technologies Co., Ltd.

USAGE:
    hiasn1cli [OPTIONS] [SUBCOMMANDS] ...

OPTIONS:
    -v, --version
        Display version information.
    -h, --help
        Display this help information.
    -i, --input <files>
        Select ASN.1 files, such as -i a.asn b.asn, or use wildcards, such as -i *.asn
    --merge <directory name>
        Merge and compile all input ASN.1 files to generate target files.
        Multi-level directories is supported, for example, a/b/c, the final output directory is exports/a/b/c.
        Each ASN.1 file is compiled and exported independently without merging.
    -m, --method <aper|uper|ber|der|xer>
        Specifies the codec method.

SUBCOMMANDS:
    cc       Compiling ASN.1 files into C code.
```


#### 子参数

该工具还有一系列子参数，例如cc子参数的帮助信息可执行以下命令查看。

```
./hiasn1cli cc --help
```

输出如下回显信息。

```
Compiling ASN.1 files into C code.

USAGE:
    hiasn1cli [OPTIONS] cc [FLAGS]

FLAGS:
    -h, --help      Display this subcommand help information.
    --values        Generate definitions for all values.
    --testcases     Generate the C file and header file for testing based on the defined values, depending on --values.
    --static-array  Define arrays using static array. Dynamic array are used by default.
    --prefix        Add prefix to files and types.
```


#### 示例

将一个ASN.1脚本test.asn转换成BER模式的C代码文件。

1. 新建测试目录“test_demo”后进入该目录。
  1 2 mkdir test_demo cd test_demo

2. 在“test_demo”目录下新建一个test.asn文件。
  1 vim test.asn

3. 按“i”进入编辑模式，填入如下脚本内容：

```
MyModule DEFINITIONS AUTOMATIC TAGS ::= BEGIN
OctStrType ::= OCTET STRING(SIZE(0..3))
MyType ::= SEQUENCE {
boolType BOOLEAN,
intType INTEGER(0..128),
enumType ENUMERATED { a, b },
bitStrType BIT STRING(SIZE(24)),
seqOfType SEQUENCE OF OctStrType,
choiceType CHOICE {
a INTEGER(0..3),
b BOOLEAN
},
oidType OBJECT IDENTIFIER
}
END
```


4. 按“Esc”键，输入:wq!，按“Enter”保存并退出编辑。
5. 使用hiasn1cli命令进行转换。
```
/usr/local/ksl/bin/hiasn1cli -i test.asn -m aper cc
```

生成的代码文件位于“test_demo/exports”目录。```
exports 
└── test 
    ├── codec_index.h 
    ├── codec_interfaces.h 
    └── codec_tables.c
```


  - codec_index.h：定义了各个数据单元的唯一标识，在后续的编解码接口中需要使用到它们。
  - codec_interfaces.h：提供了抽象语法中数据描述的C程序接口。
  - codec_tables.c：定义了用于描述各个数据类型的静态变量。
若指定了--values --testcases参数还会生成codec_testcases.h、codec_values.c、codec_values.h三个文件，用于定义和声明脚本中定义的值，并生成测试用例。
若指定了--static-array参数，将会使用静态数组的方式定义数组，默认情况下是以动态数组的方式。