fionaadrelia7-Slave/ASMTOOL

# 🎀 asmtool

``` ⊹₊ ⋆ (｡•ᴗ•｡)♡ /づ 🌸 reverse • dump • fuzz • explore ``` **一个用于折腾 ASMedia USB Storage Controller 的小工具。** 支持 Dump XRAM、读取 Flash、fuzz SCSI opcode、ATA Pass-Through、spoof descriptor，以及其他各种逆向工程实验。 纯粹是为了学习、探索，以及满足按捺不住的好奇心而作。

## 🌷 关于 `asmtool` 是一套基于 Python 的实用工具集，用于与 ASMedia USB Storage Bridge 进行底层交互。 这个项目起初只是随便玩玩。 后来加了一个功能。 然后又加了一个。 然后突然间，Python 文件的长度就像明早截止的毕业论文一样长了。 于是就变成了现在这样。 ## ✨ 功能 ### 🌸 设备 * 扫描 USB Bridge * 设备信息 * SMART 信息 * USB 端口检测 * WWN 检测 * USB Descriptor Dump ### 🌼 XRAM * 读取 XRAM * 写入 XRAM * Dump 完整 XRAM * 快照 * 对比快照 * 实时监控 * 特征搜索 ### 🌷 Flash * 读取 Flash * Dump Flash * 写入 Flash * Firmware 注入 * 回读校验 ### 🍓 逆向工程 * SCSI Opcode Fuzzer * 配置探测 * ATA Pass Through * NVMe Pass Through * HPA 探测 * DCO 探测 * 完整侦察 ### 🎀 身份伪装 * WWN Spoof * 序列号 Spoof * 厂商 Spoof * 产品 Spoof ### 🧸 研究 * 泄漏测试 * 过滤器测试 * USB Descriptor 分析 * BadUSB 枢纽实验 * Controller 重置 * 自动备份 ## 💕 ## 为什么会有这个项目？ 因为有时候好奇心比理智更强大。 ``` "Hmm ini opcode kalau dikirim bakal apa ya?" ↓ coba ↓ device masih hidup ↓ nambah fitur ↓ coba lagi ↓ 3000+ baris python ``` 人类果然是很有趣的生物。 # 📦 环境要求 * Linux * Python 3 * Root 权限 * smartctl * sg utilities * lsusb 安装依赖： ``` sudo pacman -S smartmontools sg3_utils usbutils ``` 或者 ``` sudo apt install smartmontools sg3-utils usbutils ``` # 🌸 示例 扫描设备： ``` python asmtool.py scan ``` 设备信息： ``` python asmtool.py info ``` Dump XRAM： ``` python asmtool.py xram-dump ``` Fuzz opcode： ``` python asmtool.py scsi-fuzz ``` Dump Flash： ``` python asmtool.py flash-dump ``` # 🌼 项目理念 这个项目不是为了： ❌ 大规模 exploit ❌ 让你自动变成黑客 ❌ 让笔记本电脑的 RGB 灯效更酷炫 这个项目是为了： ✅ 学习 ✅ 逆向工程 ✅ 实验 ✅ 个人记录 ✅ 满足好奇心 # 🎨 结构 ``` asmtool.py ├── Device Scanner ├── SG_IO Wrapper ├── ATA Pass Through ├── NVMe Pass Through ├── XRAM Module ├── Flash Module ├── Spoof Module ├── Recon Module ├── Diff Module ├── Watch Module ├── Fuzzer └── Utility ``` # ⚠️ 温馨的小提示 某些功能可能会： * 修改 XRAM * 修改 Flash * 修改 Descriptor * 修改身份信息 * 重置 Controller 如果盲目滥用： ``` USB sebelum eksperimen: ( •ᴗ• ) USB sesudah eksperimen: ☠️ ``` 在尝试任何操作之前，请务必备份。 幸运的是，asmtool 已经在一些关键操作中准备了自动备份功能。 # 🌱 状态 ``` ██████████░░░░░░░░ lagi berkembang pelan-pelan ✨ ``` 还有很多想要添加的内容。 还有很多尚未理解的 opcode。 还有很多厂商从未公开的文档。 而这正是其中的乐趣所在。 # ☁️ 随笔 这个项目中的代码混合了： * 好奇心 * 个人记录 * 不断试错 * 咖啡 * stackoverflow * AI * 以及凌晨 2 点的冲动决定 如果你发现有些地方很奇怪， 那很可能是故意的。 也可能不是。 # 💗 许可协议 随便用，随便学，随便改，随便拆。 重要的是要明白你正在运行的东西是什么。 因为最危险的命令不是 `rm -rf /`。 而是那些你根本不明白它在干什么的命令。

``` ∧,,,∧ ( ̳• · • ̳) / づ♡ happy reversing ✿ ``` *"带着一点过度泛滥的好奇心制作。"*

标签：USB设备, 云资产清单, 固件提取, 硬件分析, 逆向工具, 逆向工程