mcpField
H
hardware-security

hardware-security

github.com/zhaoxuya520Security43.7k1.2k installsUpdated 5w ago
Repository

About hardware-security

hardware-security is a skill for assessing embedded-device interfaces, intended for security practitioners authorized to inspect hardware. It guides debug-interface identification, boot-log access, and firmware extraction, with emphasis on physical authorization, electrical safety, and non-destructive probing.

Key features

  1. 01Identify UART, JTAG, and SWD interfaces
  2. 02Read boot logs and console output
  3. 03Assess whether debug interfaces are locked
  4. 04Extract and hand off firmware images
  5. 05Record pinouts and voltage levels

Use cases

  1. 01Check a device for exposed debug interfaces
  2. 02Assess boot consoles and root shells
  3. 03Extract firmware for further analysis

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zhaoxuya520/reverse-skill --skill hardware-security

After installing, type/hardware-securityin Claude Code to confirm it loaded.

Bundled filesreferences/debug-interface-triage.md

Details

From the project README

Hardware / Embedded Interface Security

ACTION REQUIRED（读完后立刻执行）

  1. NOW: 确认物理接触授权与设备归属
  2. NOW: ESD/电源安全；默认只读探测
  3. NEXT: 联合 firmware-pentest 做镜像分析
  4. ACT: 外壳与调试接口识别 → consoles → 提取

适用场景

  • UART / JTAG / SWD 调试口发现
  • 启动日志、root shell、引导打断
  • 配合拆机提取 Flash
  • 安全启动/加密 Flash 的可行性评估（非破坏性优先）

工作流

□ 拆解授权设备；拍照标注测试点
□ 万用表找 GND/VCC/TX/RX；逻辑电平 1.8/3.3/5V
□ USB-TTL 只读日志；记录波特率
□ JTAG：枚举 IDCODE；评估是否锁定
□ 提取镜像 → 交接 firmware-pentest / ghidra

工具链

工具用途
USB-TTL / logic analyzerUART
J-Link / CMSIS-DAP调试
bus pirate / flipper（实验室）多协议
binwalk / flashrom提取

参考

  • references/debug-interface-triage.md
  • ../firmware-pentest/ ../ot-ics/

路由上下文

上游: MASTER R34
MUST NOT: 未授权拆机/损坏他人设备

任务完成自检

  • 是否记录接口电平与引脚图？
  • 镜像是否哈希保全？
  • Checklist？

Comments

Markdown supported