3步掌握ARTIQ：从安装到量子实验控制全指南

核心架构解析

ARTIQ系统采用分层架构设计，各模块协同实现量子实验的精确控制：

• 核心控制层

  • artiq/coredevice/：硬件设备驱动库，包含AD9910波形发生器、Urukul DDS等核心设备控制逻辑
  • artiq/rtio/：实时输入输出子系统，处理时间关键型操作的精确调度
  • artiq/gateware/：FPGA逻辑设计，实现硬件加速的实时信号处理

• 实验管理层

  • artiq/master/：实验调度器与资源管理器，协调多个实验任务的执行
  • artiq/compiler/：内核编译器，将实验逻辑转换为硬件可执行代码
  • artiq/dashboard/：图形化控制界面，提供实验监控与参数调整功能

• 支撑工具层

  • artiq/frontend/：命令行工具集，包括设备管理、固件烧写等实用程序
  • artiq/examples/：实验模板库，提供多种典型量子实验的参考实现
  • artiq/test/：系统测试套件，确保各模块功能正确性

[建议添加架构关系图]：展示核心模块间数据流向，特别是RTIO子系统与硬件设备的交互流程

启动流程指南

1. 环境准备与安装

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/ar/artiq
cd artiq

# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows

# 安装依赖与ARTIQ
pip install -e .

2. 硬件配置与连接

• 连接ARTIQ核心设备至主机USB/以太网接口
• 执行设备检测命令验证连接：

  artiq_coremgmt discovery
  

• 常见故障排除：
  • 设备未检测到：检查USB驱动或网络配置
  • 权限错误：添加用户到dialout组或使用sudo权限

3. 实验启动操作链

1. 编写实验脚本（参考examples/no_hardware/repository/simple_simulation.py）
2. 启动ARTIQ主服务：

   artiq_master
   

3. 在新终端启动控制面板：

   artiq_dashboard
   

4. 在控制面板中加载实验脚本并点击"运行"按钮

图1：ARTIQ实验参数配置矩阵界面，展示多通道参数实时监控与调整功能

配置策略详解

设备数据库配置

文件作用：定义硬件资源映射关系，使实验代码可通过逻辑名称访问物理设备
关键参数：

• core_addr：核心设备网络地址
• ttl_out：TTL输出通道映射
• dds：直接数字合成器配置

配置示例（device_db.py）：

device_db = {
    "core": {
        "type": "local",
        "module": "artiq.coredevice.core",
        "class": "Core",
        "arguments": {"host": "192.168.1.50", "port": 1380}
    },
    "urukul0": {
        "type": "local",
        "module": "artiq.coredevice.urukul",
        "class": "Urukul",
        "arguments": {"sysclk": 1e9, "refclk": None}
    }
}

实验参数配置

适用场景：单次实验的动态参数调整
实现方式：

• 通过artiq.experiment模块的Argument装饰器定义
• 在控制面板中图形化调整
• 支持数值范围限制与单位标注

系统级配置

配置文件：artiq-master.conf
核心设置：

• 网络端口与安全策略
• 日志记录级别与存储路径
• 数据库连接参数

配置方式对比：

配置方式	适用场景	优势
本地配置文件	单节点部署	简单直观，易于维护
数据库配置	多节点集群	集中管理，实时更新
环境变量	容器化部署	与部署平台无缝集成

图2：量子比特操控时序示意图，展示ARTIQ系统实现的精确门操作序列

最佳实践总结

1. 配置管理：采用版本控制跟踪设备数据库变更，确保实验可复现性
2. 性能优化：将时间关键代码放入@kernel装饰的函数中，利用硬件加速
3. 故障排查：通过artiq_coreanalyzer工具分析RTIO事件时序，定位同步问题
4. 实验设计：基于examples目录中的模板开发，逐步扩展功能

完整文档请参考项目doc/manual/目录，包含详细API参考与高级功能说明。