XGM-dev 0.0.3

XGM设备驱动程序包，包含三个不同设备的驱动程序

XGM_dev

XGM设备驱动程序包，包含三个不同设备的驱动程序。

版本

当前版本：0.0.3

包含的设备驱动

本包包含以下三个设备的驱动程序：

1. systemq_qa - QA版本设备驱动
2. systemq_xy - XY版本设备驱动
3. systemq_z - Z版本设备驱动

安装

⚠️ 重要提示

由于 quark 和 quarkstudio 的某些依赖项存在兼容性问题（特别是 twiceredis），推荐使用方案1或方案2。

方案1：跳过依赖安装（推荐）

如果您的环境中已经安装了 quark 或 quarkstudio：

# 只安装基础包，不安装依赖
pip install XGM_dev --no-deps

# 然后手动安装必需的依赖
pip install numpy waveforms

# 确保您已有 quark 环境（代码需要 from quark.driver import BaseDriver）
# 如果还没有，请从您的私有源或其他方式安装

方案2：基础安装（只安装核心依赖）

# 基础安装，只包含 numpy 和 waveforms
pip install XGM_dev

注意：这种方式不会自动安装 quark 或 quarkstudio，您需要单独安装它们。

方案3：尝试完整安装（可能失败）

# 尝试安装所有依赖（如果遇到错误，请使用方案1或方案2）
pip install XGM_dev[quark]
# 或
pip install XGM_dev[quarkstudio]
# 或
pip install XGM_dev[full]

依赖

必需依赖（自动安装）

• numpy - 数值计算库
• waveforms - 波形处理库

运行时必需但需单独安装

• quark 或 quarkstudio[remote] - 用于驱动基类 BaseDriver
  • 代码中使用：from quark.driver import BaseDriver
  • 这些依赖在安装时可能会失败（由于 twiceredis 的兼容性问题）
  • 请使用方案1，或从您的私有源/本地环境安装

依赖问题解决指南

问题描述

安装时可能遇到以下错误：

SyntaxError: Missing parentheses in call to 'print'
error: metadata-generation-failed

这是因为 quark/quarkstudio 的依赖项 twiceredis 使用了 Python 2 语法，在 Python 3 环境下无法安装。

✅ 推荐解决方案

方案1：跳过依赖安装（最简单）

# 1. 只安装基础包，跳过所有依赖
pip install XGM_dev --no-deps

# 2. 安装核心依赖
pip install numpy waveforms

# 3. 使用环境中已有的 quark（如果已安装）
# 验证：python -c "from quark.driver import BaseDriver; print('OK')"

方案2：从私有源安装 quark

# 1. 安装基础包
pip install XGM_dev --no-deps
pip install numpy waveforms

# 2. 从您的私有源或修复后的源安装 quark
pip install quark --index-url <您的私有源URL>

方案3：使用本地已修复的包

如果您有修复后的 quark 包：

pip install XGM_dev --no-deps
pip install numpy waveforms
pip install path/to/fixed/quark

验证安装

安装后验证是否可以正常导入：

# 测试基础包
from systemq_qa.XGM_QA24 import Driver as QADriver
print("✅ systemq_qa 导入成功")

# 测试 quark（必需）
from quark.driver import BaseDriver
print("✅ quark 导入成功")

使用

安装后，可以导入相应的驱动模块：

from systemq_qa.XGM_QA24 import Driver as QADriver
from systemq_xy.XGM_MDS24 import Driver as XYDriver
from systemq_z.XGM_MDS24 import Driver as ZDriver

许可证

[添加许可证信息]

作者

XGM Device Driver Team