量子控制实时系统ARTIQ零基础入门指南

ARTIQ是面向量子信息实验的先进实时控制系统，提供亚微秒级时间精度的实验调度能力，支持复杂量子态操控与多通道数据采集。作为开源解决方案，其核心优势在于硬件抽象层设计、动态实验流程编排及精确时序控制，广泛应用于原子物理、量子计算等前沿研究领域。

环境配置指南

源码获取与依赖安装

git clone https://gitcode.com/gh_mirrors/ar/artiq
cd artiq
pip install -r requirements.txt

系统需满足Python 3.8+环境，推荐使用虚拟环境隔离依赖。编译前需安装LLVM 11+工具链及Rust开发环境，具体版本要求参见doc/manual/installing.rst。

💡 提示：国内用户可配置PyPI镜像加速依赖下载，编译过程中若出现llvm-config找不到的错误，需手动设置LLVM路径环境变量。

编译与验证

python setup.py build
python setup.py install
artiq_run --version

成功安装后，执行artiq_run --version应显示版本信息。编译产物位于build/lib目录，包含核心运行时组件与设备驱动模块。

硬件连接步骤

设备拓扑规划

ARTIQ支持级联式硬件架构，典型配置包括：

• 主控制器（KC705/Kasli）通过DRTIO协议连接从节点
• 模拟/数字转换模块通过RTIO总线交互
• 实验装置通过专用接口板连接

物理连接规范

1. 使用SFP+线缆连接主从控制器，确保光纤链路损耗<3dB
2. 按设备手册连接时钟同步信号线（推荐使用GPSDO）
3. 模拟输入输出模块需通过50Ω同轴电缆连接实验装置
4. 所有电源连接完成后，先开启控制主机再启动外围设备

💡 提示：初次连接建议使用examples/kasli/device_db.py作为模板配置，通过artiq_coremgmt工具检测设备连通性。

核心功能模块解析

实时内核系统

artiq/kernel/模块实现了时间确定性执行环境，支持：

• 纳秒级精度时序控制
• 硬件加速的数值计算
• 多通道并行操作调度

内核代码通过LLVM编译为专用指令集，运行于FPGA嵌入式处理器，确保实验序列的精确执行。

实验调度框架

artiq/master/提供分布式实验管理能力：

• 基于优先级的任务队列
• 实验资源冲突检测
• 多用户并发控制
• 实验结果自动归档

调度器通过TCP/IP协议与前端交互，支持远程提交与监控实验任务。

设备抽象层

artiq/coredevice/包含标准化硬件接口：

• AD/DA转换器驱动（AD9910, DAC34H84等）
• 射频合成器控制（ADF5356, TRF372017）
• 时序逻辑模块（RTIO, DMA）
• 辅助外设（I2C, SPI总线控制器）

设备配置通过Python字典定义，支持热插拔与动态重配置。

💡 提示：开发自定义设备驱动时，建议继承CoreDevice基类并实现init()与close()方法，确保资源正确释放。

配置文件参数详解

主配置文件（artiq-master.conf）

参数名	类型	默认值	说明
port	int	3250	主控制器监听端口
log_level	str	"INFO"	日志输出级别
db_path	str	"~/artiq_db"	实验数据库路径
max_workers	int	4	并发工作进程数
default_priority	int	50	默认实验优先级

设备数据库（device_db.py）

典型设备定义示例：

device_db = {
    "core": {
        "type": "local",
        "module": "artiq.coredevice.core",
        "class": "Core",
        "arguments": {"host": "192.168.1.100"}
    },
    "dds0": {
        "type": "local",
        "module": "artiq.coredevice.ad9910",
        "class": "AD9910",
        "arguments": {"channel": 0, "sysclk": 1e9}
    }
}

💡 提示：使用artiq_ddb_template.py工具可生成基础配置，通过artiq_coremgmt scan命令自动发现连接的硬件设备。

快速入门实验流程

实验脚本编写

创建基础实验文件demo.py：

from artiq.experiment import *

class QuantumDemo(EnvExperiment):
    def build(self):
        self.setattr_device("core")
        self.setattr_device("dds0")
        
    @kernel
    def run(self):
        self.core.reset()
        self.dds0.init()
        self.dds0.set(100*MHz)
        self.dds0.sw.on()
        delay(1*ms)
        self.dds0.sw.off()

执行与监控

artiq_run demo.py --device-db device_db.py

实验过程可通过artiq_dashboard实时监控，包括：

• 设备状态指示灯
• 实时波形显示
• 错误日志输出
• 实验进度跟踪

💡 提示：使用@rpc装饰器可实现内核与主机间数据交互，通过artiq_client工具可远程控制实验执行。

进阶功能与扩展

子内核与分布式执行

通过artiq/compiler/transforms/interleaver.py实现任务并行：

@kernel
def parallel_task():
    with parallel:
        with sequential:
            # 通道A操作序列
        with sequential:
            # 通道B操作序列

自定义设备支持

开发新设备驱动步骤：

1. 创建设备类继承HasEnvironment
2. 实现init()方法进行硬件初始化
3. 添加RTIO事件处理逻辑
4. 编写单元测试验证功能

数据可视化集成

实验数据可通过artiq/applets/模块实时可视化：

• 调用plot_xy绘制扫描曲线
• 使用histogram显示统计分布
• 通过image组件展示相机数据

💡 提示：自定义applet可继承Applet类，重写data_changed方法实现定制化数据处理。

常见问题解决

时序精度问题

• 检查系统时钟同步状态：artiq_coremgmt clock
• 减少内核代码中的条件分支
• 使用rtio_log分析事件时间戳偏差

设备通信故障

• 验证USB/以太网连接：lsusb/ping
• 检查设备固件版本：artiq_coremgmt ident
• 重置设备状态：artiq_coremgmt reset

编译错误处理

• 确保LLVM版本兼容性
• 清理构建缓存：python setup.py clean
• 检查Rust工具链配置：rustup show

完整故障排除指南参见doc/manual/faq.rst。