Skip to content

molqzone/pxlobster

Repository files navigation

PXLobster

中文 | English

License Language GitHub Stars GitHub Forks GitHub Issues

PXLobster 是一个面向 PXLogic 逻辑分析仪的命令行上位机程序。

特性

  • 设备扫描:--scan
  • 固件/位流注入:--prime-fw
  • 采集停止:--stop
  • 采集输出:bin / sr
  • 目标控制:--samples(字节)或 --time(毫秒)
  • 触发配置:-t/--triggers
  • 管道输出:--stdout(仅 bin

构建

环境要求:

  • Zig 0.16.0+
  • Linux / macOS: 系统 libusb-1.0 运行库
  • Windows: 无需额外安装 libusb-1.0.dll,发布资产为自包含 EXE

Linux udev 放行

如果在 Linux 下遇到无权限访问设备,可安装 udev 规则:

sudo cp packaging/udev/99-pxlobster.rules /etc/udev/rules.d/99-pxlobster.rules
sudo udevadm control --reload-rules
sudo udevadm trigger

然后重新插拔设备,或重新登录当前会话。

用法

pxlobster --version
pxlobster [--verbose] --scan
pxlobster [--verbose] --prime-fw
pxlobster [--verbose] --stop
pxlobster [--verbose] -o <path> --format <bin|sr> [--samples <bytes>|--time <ms>] [--decode-cross] [--mode <buffer|stream|loop>] [-t <spec>] [--samplerate <hz>]
pxlobster [--verbose] --stdout --format <bin> [--samples <bytes>|--time <ms>] [--decode-cross] [--mode <buffer|stream|loop>] [-t <spec>] [--samplerate <hz>]

常用示例:

# 查看版本
pxlobster --version

# 扫描设备
pxlobster --scan

# 注入固件
pxlobster --prime-fw

# 停止活动采集
pxlobster --stop

# 采集到 bin 文件
pxlobster -o /tmp/capture.bin --format bin --samples 65536

# 采集到 sr 文件
pxlobster -o /tmp/capture.sr --format sr --samples 1048576 --samplerate 25000000

# stdout 管道输出(bin)
pxlobster --stdout --format bin --samples 65536 > /tmp/capture_stdout.bin

注意:

  • --format 必须显式指定
  • --samples--time 互斥
  • --stdout--output-file 互斥
  • --stdout 仅支持 --format bin
  • --version 与其他命令模式互斥

License

本项目采用 GNU General Public License v3.0(GPL-3.0)许可证,详见 LICENSE

About

A third-party CLI host software for PXLogic logic analyzers.

Resources

License

Stars

Watchers

Forks

Contributors

Languages