# asn.1 tool

**Repository Path**: dybinx/asn.1-tool

## Basic Information

- **Project Name**: asn.1 tool
- **Description**: 这是一款全网编解码性能最好，功能最齐全的3G、4G、5G编解码软件，它可以让编解码变的更简单，更轻松的定位解码码流错误的具体位置。
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 1
- **Created**: 2024-09-02
- **Last Updated**: 2025-07-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: asn1, tool, 3G, 4G, 5g

## README

# asn.1 tool

## 介绍
解码3G、4G、5G消息码流，包括终端和基站的接入层消息。

## 联系方式
有合作需求或者技术上的问题，请邮件联系：easy_codec@126.com

## 更新策略
关于data文件的更新：
安装3GPP发布ec文件，即每年3月，6月，9月，12月发布；在更新最新的版本之前，每个月月底更新ec文件。

## 版本更新说明
更新到7.6.1
更新内容：
支持R18版本的消息编解码

更新到7.6.1
更新内容如下：
1.添加提示信息；
2.解决针对某些PC机出现重复认证的问题

更新到7.6.0
使用新的生成key的算法

更新到7.5.0
添加3g空口相关的协议

更新版本到7.4.1
解决UTF8String和VisibleString编码不正确的问题

版本更新到：7.4.0
更新内容
增加LTE的M2AP和XwAP两个接口
data文件加的ec文件重新更新，只使用于7.4.0版本工具或者后续版本。


## 安装教程

目前工具只支持Windows系统。

点击EasyCodec.msi直接安装。

## 使用说明

它是一款具有编码和解码的工具，它是一款覆盖基站和终端多种接口消息的编码和解码工具，它还是一款编码和解码分析工具，通过它，你可以清晰的了解码流的每一位代表的含义。

## 操作效果

先看一下这个工具的操作，给大家一个直观感受。

![asn1-tool](./README.assets/asn1-tool.gif)

## **界面功能划分**

界面功能划分如下图所示：

![asn1-tool](./README.assets/asn1-tool.jpg)

## **广泛的协议支持**

工具支持4G、5G空口，S1AP，X2AP、F1AP、NGAP、E1AP、XNAP等协议消息的编解码。



## **一目了然的IE类型**

每条IE都会有一个图标，标识每个IE的ANS.1类型，具体的图标含义如下：



- <img src="./README.assets/booleanType.png" alt="img" style="zoom:10%;" />  boolean类型
- <img src="./README.assets/choiceType.png" alt="img" style="zoom:10%;" />  choice类型
- <img src="./README.assets/enumeratedType.png" alt="img" style="zoom:10%;" />  enumerated类型
- <img src="./README.assets/integerType.png" alt="img" style="zoom:10%;" />  integer类型
- <img src="./README.assets/numericStringType.png" alt="img" style="zoom:10%;" />  numericString类型
- <img src="./README.assets/nullType.png" alt="img" style="zoom:10%;" />  null类型
- <img src="./README.assets/objectIdentifierType.png" alt="img" style="zoom:10%;" />  object identifier类型
- <img src="./README.assets/octetstringType.png" alt="img" style="zoom:10%;" />  octetstring类型
- <img src="./README.assets/openType.png" alt="img" style="zoom:10%;" />  open type类型
- <img src="./README.assets/printableStringType.png" alt="img" style="zoom:10%;" />  printable string类型
- <img src="./README.assets/realType.png" alt="img" style="zoom:10%;" />  real类型
- <img src="./README.assets/sequenceType.png" alt="img" style="zoom:10%;" />  sequence类型
- <img src="./README.assets/sequenceOfType.png" alt="img" style="zoom:10%;" />  sequence of类型
- <img src="./README.assets/setType.png" alt="img" style="zoom:10%;" />  set类型
- <img src="./README.assets/visibleStringType.png" alt="img" style="zoom:10%;" />  visible string类型
- <img src="./README.assets/bitstringType.png" alt="img" style="zoom:10%;" />  bitstring类型



## **方便快捷的输入方式**

![inputArea](./README.assets/inputArea.png)

元素显示区的第二列可以输入不同类型的值，根据ASN.1的类型不同，输入数值的方式会有些差异。

点击需要修改的IE项，输入的过程中，状态栏会显示输入值的合法性。

输入值分为两种，通过下拉菜单选择的输入值，即可选择值；以及输入数字的输入值，即非选择值。

选择值，在选择之后，下方显示的码流会做相应的改变；非选择值，在输入之后，需要点击其他非输入区位置，之后下方先生的码流才会做相应的改变。



## **强大的搜索功能**

![search](./README.assets/search.png)

支持各种查找功能，并且在输入关键字的时候可以对历史关键字进行自动匹配和补齐。如下：

<img src="./README.assets/searchMore.png" alt="image-20240128001539889" style="zoom:25%;" />

## 支持任意添加想要的ASN.1文件

可以根据需要添加不同协议版本的ASN.1文件，并保持在安装目录的data文件夹下。ASN.1文件的获取可以联系开发者。

<img src="./README.assets/fileList.png" alt="image-20240128002126617" style="zoom:50%;" />

将ASN.1文件放入data文件夹之后，重启程序，相应的协议文件即可在工具的“协议选择”下拉菜单中看到。

![image-20240128004542690](./README.assets/specName.png)