Skip to main content

jz_debug — JZ 仿真器调试核心

Python 包:USB 协议 / 烧录 / 调试会话 / DAP(VS Code)。

环境

  • Python 3.10+
  • pip install -r requirements-jz-debug.txt
  • Windows:需 libusbK 驱动(JZ-IDE INF,VID=0x8235 PID=0x584A)

与 JZ-IDE 互斥

同一时刻只能有一个程序占用仿真器。 使用本工具前请关闭 JZ-IDE;用完后关闭本工具再开 IDE。

离线测试(无需硬件)

python -m jz_debug.tools.extract_fixtures
python -m pytest jz_debug/tests -q

实机冒烟

python -m jz_debug.tools.smoke_usb

应打印:EV1.6.3-250609

命令行烧录

python -m jz_debug.tools.program codes\V2_0_0_20260525_JZ8P1520\Main.xbin

调试 REPL

python -m jz_debug.tools.debug_repl --sim --xbin codes\V2_0_0_20260525_JZ8P1520\Main.xbin --list codes\V2_0_0_20260525_JZ8P1520\Main.list
python -m jz_debug.tools.debug_repl --xbin codes\...\Main.xbin

DAP(VS Code)

python -m jz_debug.dap

扩展见 vscode-jz-debug/

模块

说明
protocol/ 纯协议,零 I/O
usb/ pyusb 设备
flash/ 镜像 + 烧录状态机
session/ HardwareBackend / SimBackend
symbols/ list 行映射
dap/ Debug Adapter

Release files for jz-debug 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jz-debug 0.1.0
File Size Uploaded
jz_debug-0.1.0.tar.gz 54.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for jz-debug 0.1.0
File Interpreter ABI Platform
jz_debug-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 107.9 kB

Release files / jz_debug-0.1.0.tar.gz

Download URL jz_debug-0.1.0.tar.gz
Size 54.7 kB
Tags Source
SHA-256 checksum
How to use checksums
5615fad4e2a5995ac6e21a8cb1955528b710c8b067a3af0e2a3b85e55a609e47
BLAKE2b-256 checksum
How to use checksums
1ce2d6ef6585ffdc62a1b624a31cb200f412c50ef550ab959c136cd3961567ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.0

Release files / jz_debug-0.1.0-py3-none-any.whl

Download URL jz_debug-0.1.0-py3-none-any.whl
Size 53.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
19af08317d61f224557cab5a8f60c3c27c653e621b4578e84830453667eb8d31
BLAKE2b-256 checksum
How to use checksums
0e50e1aa0cf8aac717acfab4e925d919960c30c6b86201462e5bb5628636a3ed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.0

Release history Release notifications | RSS feed

0.2.0

2 release files

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page