ESP32-Bit-Pirate命令速查手册：常用指令与快捷键汇总

ESP32-Bit-Pirate命令速查手册：常用指令与快捷键汇总

【免费下载链接】ESP32-Bit-PirateA Hardware Hacking Tool with Web-Based CLI That Speaks Every Protocol项目地址: https://gitcode.com/GitHub_Trending/es/ESP32-Bit-Pirate

ESP32-Bit-Pirate是一款功能强大的硬件黑客工具，它提供了基于Web的CLI界面，支持多种协议。本手册汇总了其常用指令与快捷键，帮助用户快速掌握操作技巧，提升硬件调试效率。

一、基础操作指令 🚀

1.1 模式切换指令

• mode <protocol>：切换到指定协议模式，如mode i2c进入I2C模式，mode uart进入UART模式。支持的协议包括SPI、I2C、UART、DIO、LoRa等。
• mode：不带参数时，列出所有可用模式并提示用户选择。

1.2 帮助与信息指令

• help或h或?：显示当前模式下的可用命令列表及简要说明。例如在I2C模式下执行help，将显示I2C相关的所有命令。
• status：查看设备当前状态，包括连接模式、引脚配置、协议参数等。
• sysinfo：显示系统信息，如固件版本、内存使用情况、GPIO分配等。

图1：ESP32-Bit-Pirate的Serial CLI界面，展示了命令输入和执行结果

二、协议操作指令 🔌

2.1 I2C协议指令

• scan：扫描I2C总线上的设备地址，显示所有响应的从设备地址。
• read <addr> [reg]：从指定I2C地址（addr）的寄存器（reg，可选）读取数据。例如read 0x50 0x00读取地址0x50的0x00寄存器数据。
• write <addr> [reg] [val]：向指定I2C地址的寄存器写入数据。例如write 0x50 0x00 0xAA向地址0x50的0x00寄存器写入0xAA。

2.2 SPI协议指令

• read：读取SPI设备数据。
• write <data>：向SPI设备写入数据，支持十六进制格式，如write 0x01 0x02。
• sniff：监听SPI总线通信，捕获主从设备之间的数据流。

2.3 UART协议指令

• bridge：建立UART桥接，转发终端输入到UART设备，并显示设备返回数据。
• at：进入AT指令模式，用于与支持AT指令的设备（如Modem）通信。
• set <baudrate>：设置UART波特率，如set 115200。

三、系统管理指令 ⚙️

3.1 配置与重置

• config：配置当前模式的参数，如引脚分配、通信速率等。
• reset：重置当前模式或设备，恢复默认配置。
• save：保存当前配置到NVS（非易失性存储），重启后生效。

3.2 文件系统操作

• ls：列出LittleFS文件系统中的文件。
• cat <file>：查看指定文件内容，如cat /config.txt。
• rm <file>：删除文件（注意：此命令需谨慎使用）。

图2：ESP32-Bit-Pirate的Web CLI界面，可通过浏览器访问和操作

四、高级功能指令 🛠️

4.1 逻辑分析与监控

• logic <gpio>：对指定GPIO引脚进行逻辑分析，绘制波形图。例如logic 4监控GPIO4的电平变化。
• analogic <gpio>：采集指定GPIO引脚的模拟信号，显示电压变化。
• sniff <gpio>：监听指定GPIO引脚的信号，记录电平跳变事件。

4.2 无线功能指令

• wifi connect <ssid> <password>：连接到指定WiFi网络。
• ble scan：扫描周围的蓝牙设备。
• lora send <data>：通过LoRa模块发送数据，如lora send "Hello, LoRa!"。

五、快捷键与操作技巧 ⌨️

5.1 常用快捷键

• Tab：自动补全命令或文件名。
• ↑/↓：切换命令历史记录。
• Ctrl+C：终止当前正在执行的命令。
• Enter：确认并执行命令；在部分监听模式下（如logic、sniff），按Enter停止操作。

5.2 命令组合与管道

• ||：命令管道，依次执行多个命令。例如scan || read 0x50先扫描I2C设备，再读取地址0x50的数据。
• repeat <n> <command>：重复执行命令n次。例如repeat 3 send 0xAA发送3次0xAA。

六、移动设备操作 📱

ESP32-Bit-Pirate支持通过移动设备访问Web界面，实现便捷的无线操作。在移动终端上，命令使用方式与桌面端一致，同时适配触控操作，方便现场调试。

图3：ESP32-Bit-Pirate的移动设备Web界面，适合现场调试场景

七、常见问题解决 ❓

7.1 命令执行失败

• 检查当前模式是否正确，例如I2C命令需在I2C模式下执行。
• 确认设备接线是否正确，引脚是否冲突。
• 使用status命令查看设备状态，排查配置问题。

7.2 忘记命令语法

• 执行help查看当前模式下的命令列表及用法。
• 使用help <command>查看指定命令的详细说明，如help i2c read。

通过本手册，您可以快速掌握ESP32-Bit-Pirate的常用指令和操作技巧。如需更详细的协议说明或高级功能，可参考项目源码中的控制器模块（如src/Controllers/I2cController.cpp、src/Controllers/SpiController.cpp）或官方文档。

【免费下载链接】ESP32-Bit-PirateA Hardware Hacking Tool with Web-Based CLI That Speaks Every Protocol项目地址: https://gitcode.com/GitHub_Trending/es/ESP32-Bit-Pirate