asm2hex

README

ASM2HEX

ASM2HEX是一款用Go语言编写的,基于Fyne框架开发的汇编语言与十六进制机器码相互转换的图形化工具。它支持ARM64、ARM和Thumb三种指令集。

支持的汇编指令集

下表列出了当前版本支持的汇编指令集以及对应的汇编器(Keystone)和反汇编器(Capstone)的支持情况:

指令集	架构	汇编(Keystone)	反汇编(Capstone)
ARM	ARM	✓	✓
ARM64	ARM64	✓	✓
MIPS	MIPS	✓	✓
X86	X86	✓	✓
PPC	PPC	✓	✓
SPARC	SPARC	✓	✓
SystemZ	SYSTEMZ	✓	✓
Hexagon	HEXAGON	✓	✗
EVM	EVM	✓	✓
XCORE	XCORE	✗	✓
M68K	M68K	✗	✓
TMS320C64X	TMS320C64X	✗	✓
M680X	M680X	✗	✓
MOS65XX	MOS65XX	✗	✓
WASM	WASM	✗	✓
BPF	BPF	✗	✓
RISCV	RISCV	✗	✓
SH	SH	✗	✓
TriCore	TRICORE	✗	✓

✓ 表示支持该指令集,✗ 表示不支持该指令集。

v1.2.0 版本更新说明

新增功能

• 增加了对多种指令集，架构汇编、反汇编的支持,现在可以在主界面上选择。
• 支持多种汇编指令集,包括 ARM、ARM64、MIPS、X86、PPC、SPARC、SystemZ、Hexagon 和 EVM。
• 提供了统一的接口,可以方便地进行汇编和反汇编操作。

改进

• 优化了代码结构,提高了代码的可读性和可维护性。
• 改进了错误处理机制,提供更友好的错误提示信息。
• 发布了 github actions 自动化构建流程,保证了代码质量和稳定性。

修复

• 修复了一些潜在的 bug 和稳定性问题。

其他

• 更新了文档和示例代码,方便用户快速上手使用。

希望这次更新能够为用户带来更好的使用体验,如果您在使用过程中遇到任何问题或有任何建议,欢迎向我们反馈。

Full Changelog

功能特点

• 支持ARM64、ARM和Thumb指令集的汇编语言与十六进制机器码的双向转换
• 可自定义偏移地址,支持大端和小端两种字节序
• 使用Keystone作为汇编引擎,Capstone作为反汇编引擎,转换准确可靠
• 基于Fyne框架开发的现代化图形界面,操作简单直观
• 跨平台支持,可在Windows、macOS和Linux等多种操作系统上运行

安装方法

1. 安装Go语言开发环境。

2. 获取ASM2HEX的源代码:

   git clone https://github.com/suifei/asm2hex.git
   

3. 进入项目目录,下载依赖包:

   cd asm2hex
   go get ./...
   

4. 编译生成可执行文件:

   COMPILE.MD

现在可以直接运行生成的可执行文件,享受ASM2HEX带来的便利!

使用说明

1. 在左侧的输入框中输入汇编指令或十六进制机器码。多条指令/数据可以分行输入。

2. 在偏移量输入框中可以指定初始地址的偏移量。偏移量需要以十六进制格式输入。

3. 点击"0x"选框,可以控制十六进制机器码是否包含"0x"前缀。

4. 点击"GDB/LLDB"选框可以控制字节序,勾选表示使用大端字节序,未勾选则使用小端字节序。

5. 点击"转换"按钮,ASM2HEX会自动完成转换,并将结果实时显示在右侧的ARM64、ARM和Thumb三个选项卡中。

6. 可以通过"清除"按钮清空输入输出,方便进行下一次转换。

7. "切换模式"按钮可以切换工具当前的工作模式。默认模式是汇编转十六进制,切换后即成为十六进制转汇编模式。

8. 单击每个选项卡右上角的复制图标,即可将该选项卡的内容复制到剪贴板,方便使用。

致谢

ASM2HEX的开发得益于以下开源项目:

• Fyne : 基于Go的跨平台图形界面框架

• Keystone: 轻量级的多架构汇编引擎

• Capstone: 多架构支持的反汇编引擎

• 特别感谢 armconverter.com 提供的在线工具,为ASM2HEX提供了灵感。

感谢这些优秀项目的贡献者和维护者!

许可证

ASM2HEX采用MIT许可证进行发布,详情参见LICENSE文件。

行为准则

在参与 ASM2HEX 项目时,请遵循我们的 行为准则。我们致力于维护一个友好、包容的社区环境,所有参与者都应该感到受欢迎和尊重。

再次感谢你的贡献!如果你有任何问题或需要进一步的帮助,请随时联系我们。

联系方式

如果您在使用过程中遇到任何问题,或者有任何建议和反馈,欢迎通过以下方式联系我:

• 邮箱: c3VpZmUgQGdtYWlsIGRvdGNvbQ==
• QQ群: 555354813
• GitHub: https://github.com/suifei/asm2hex
• 论坛: pediy 52pojie
• 下载: 国内地址1
• 分流: 国内地址1

希望ASM2HEX能够成为您的汇编开发和学习的得力助手!

---

英文版 README.md

ASM2HEX

ASM2HEX is a graphical tool for bidirectional conversion between assembly language and hexadecimal machine code, written in Go and based on the Fyne framework. It supports three instruction sets: ARM64, ARM, and Thumb.

Features

• Supports bidirectional conversion between assembly language and hexadecimal machine code for ARM64, ARM, and Thumb instruction sets
• Customizable offset address, supporting both big-endian and little-endian byte orders
• Uses Keystone as the assembly engine and Capstone as the disassembly engine for accurate and reliable conversion
• Modern graphical interface developed based on the Fyne framework, simple and intuitive to operate
• Cross-platform support, can run on various operating systems such as Windows, macOS, and Linux

Installation

1. Install the Go language development environment.

2. Get the source code of ASM2HEX:

   git clone https://github.com/suifei/asm2hex.git
   

3. Enter the project directory and download the dependency packages:

   cd asm2hex
   go get ./...
   

4. Compile to generate the executable file:

   COMPILE.MD

Now you can directly run the generated executable file and enjoy the convenience brought by ASM2HEX!

Usage

1. Enter assembly instructions or hexadecimal machine code in the input box on the left. Multiple instructions/data can be entered in separate lines.

2. You can specify the offset of the initial address in the offset input box. The offset needs to be entered in hexadecimal format.

3. Click the "0x" checkbox to control whether the hexadecimal machine code includes the "0x" prefix.

4. Click the "GDB/LLDB" checkbox to control the byte order. Checking it indicates using big-endian byte order, while unchecking it uses little-endian byte order.

5. Click the "Convert" button, and ASM2HEX will automatically complete the conversion and display the results in real-time in the ARM64, ARM, and Thumb tabs on the right.

6. You can clear the input and output using the "Clear" button, making it convenient for the next conversion.

7. The "Toggle Mode" button can switch the current working mode of the tool. The default mode is assembly to hexadecimal, and after switching, it becomes hexadecimal to assembly mode.

8. Click the copy icon in the upper right corner of each tab to copy the content of that tab to the clipboard for easy use.

Acknowledgements

The development of ASM2HEX has benefited from the following open-source projects:

• Fyne: Cross-platform graphical interface framework based on Go
• Keystone: Lightweight multi-architecture assembly engine
• Capstone: Disassembly engine with multi-architecture support
• Special thanks to the online tool provided by armconverter.com, which inspired the development of ASM2HEX.

Thanks to the contributors and maintainers of these excellent projects!

License

ASM2HEX is released under the MIT license. For details, see the LICENSE file.

Code of Conduct

When participating in the ASM2HEX project, please follow our Code of Conduct. We are committed to maintaining a friendly and inclusive community environment where all participants should feel welcome and respected.

Thank you again for your contribution! If you have any questions or need further assistance, please feel free to contact us.

Contact

If you encounter any problems during use or have any suggestions and feedback, please feel free to contact me through the following ways:

• Email: c3VpZmUgQGdtYWlsIGRvdGNvbQ==
• QQ Group: 555354813
• GitHub: https://github.com/suifei/asm2hex

I hope ASM2HEX can become a powerful assistant for your assembly development and learning!