# Wireshark 自定义协议解析插件

激光雷达点云数据使用 UDP 协议发送，默认端口是 51180。为了方便对点云数据进行抓包分析、提高开发调试效率，我们提供了一个 [Asensing_parser.lua](../_static/files/Asensing_parser.lua) 插件，可在 Wireshark 软件加载，实时解析自定义的点云协议数据。

Asensing_parser.lua 是由 Lua 脚本编写的，Wireshark 软件自带 Lua 解析器，因此你只需要安装较新版本的 Wireshark 软件即可使解析插件生效。我们在 Windows 10、Ubuntu 20.04 操作系统使用 Wireshark 3.2.x 和 3.6.x 版本测试过，如果你使用的环境运行异常，欢迎将问题反馈给我们或者帮我们修复它。

## 使用方法

首先需要安装 Wireshark 软件，并确保你所安装的 Wireshark 支持 Lua。

然后将 Asensing_parser.lua 脚本安装到 Wireshark 的安装目录。

- 对于 Linux 系统，请将 Asensing_parser.lua 脚本复制到 /usr/share/wireshark/ 目录；
- 对于 Windows 系统，请将 Asensing_parser.lua 脚本复制到 C:\Program Files\Wireshark\ 目录；

Wireshark 在启动时会加载 init.lua 脚本（Linux 系统位于 ），在 init.lua 脚本末尾添加下面一行：

```lua
dofile(DATA_DIR.."Asensing_parser.lua")
```

注意，不同系统中 init.lua 的路径有所不同

- Linux 系统：/etc/wireshark/init.lua 或 /usr/share/wireshark/init.lua（软链接）
- Windows 系统：C:\Program Files\Wireshark\init.lua

然后重新启动 Wireshark 即可生效。

## 运行效果

加载 Asensing_parser.lua 解析脚本前，Wireshark 抓包时的显示效果如下图所示。

![](./images/wireshark-before-using-plugin.png)

加载 Asensing_parser.lua 解析脚本后，Wireshark 抓包时的显示效果如下图所示。

![](./images/wireshark-after-using-plugin.png)