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.2.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.2.0
File Size Uploaded
jz_debug-0.2.0.tar.gz 55.8 kB Details

Built distribution (wheel)

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

Total release size: 109.4 kB

Release files / jz_debug-0.2.0.tar.gz

Download URL jz_debug-0.2.0.tar.gz
Size 55.8 kB
Tags Source
SHA-256 checksum
How to use checksums
d4349b4d8d5528d034d09c0e63938915fbbc778452f662d847461e9f03a52bab
BLAKE2b-256 checksum
How to use checksums
975d6815792d469a65cc238181096ca3d1dc9b7f387ee0d1b2b49d90a4ff1808
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.2.0-py3-none-any.whl

Download URL jz_debug-0.2.0-py3-none-any.whl
Size 53.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cc65a23f713865df94e821c9455bece0d41a3bb800cd3d696bd5ca1151eaf668
BLAKE2b-256 checksum
How to use checksums
45509fc9632b30129a54b584abf3fd5fca795b3baaca52020c9cb038929a6e74
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

This release

0.2.0 This release

2 release files

0.1.0

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