ARTIQ manual

Overview

• Introduction
• ARTIQ Releases
  • Release notes

Setting up ARTIQ

• Installing ARTIQ
  • Installing via Nix (Linux)
  • Installing via MSYS2 (Windows)
  • Installing via Conda [DEPRECATED]
  • Upgrading ARTIQ
• (Re)flashing your core device
  • Obtaining board binaries
  • Installing and configuring OpenOCD
  • Writing the flash
  • Connecting to the UART log
• Networking and configuration
  • Setting up core device networking
  • Configuring the core device
• Developing ARTIQ

Tutorials

• ARTIQ Real-Time I/O Concepts
  • Timeline and terminology
  • Output errors and exceptions
  • Input channels and events
  • Event spreading
  • Seamless handover
  • Synchronization
• Getting started with the core language
  • Connecting to the core device
  • Host/core device interaction (RPC)
  • Real-time Input/Output (RTIO)
  • Parallel and sequential blocks
  • RTIO analyzer
  • Direct Memory Access (DMA)
• Getting started with the management system
  • Starting your first experiment with the master
  • Adding an argument
  • Interactive arguments
  • Setting up Git integration
  • Datasets
  • Applets
  • RTIO analyzer and the dashboard
  • Non-RTIO devices and the controller manager
  • The ARTIQ session
• Using DRTIO and subkernels
  • Using DRTIO
  • Distributed Direct Memory Access (DDMA)
  • Subkernels

ARTIQ components

• Environment
  • The device database
  • Arguments
  • Datasets
• Compiler
  • ARTIQ Python code
  • Pitfalls
  • Flags and optimizations
• Management system
  • Components
  • Git integration
  • Experiment scheduling
  • Scheduler API reference
  • Client control broadcasts (CCBs)
  • Applet request interfaces
  • Applet entry area
• DRTIO system
  • Terminology
  • The routing table
  • Internal details
• Core device
  • Flash storage
  • Common configuration commands
  • Board details
  • Clocking

Network devices

• Developing a Network Device Support Package (NDSP)
  • Components of a NDSP
  • The driver and controller
  • The client
  • Integration with ARTIQ experiments
  • Remote execution support
  • Command-line arguments
  • Logging
  • Additional guidelines
  • Hosting your code
• List of available NDSPs
• Default network ports

References

• Main front-end tool reference
  • artiq.frontend.artiq_run
  • artiq.frontend.artiq_master
  • artiq.frontend.artiq_client
  • artiq.frontend.artiq_dashboard
  • artiq.frontend.artiq_session
• Core language reference
  • artiq.language.core module
  • artiq.language.environment module
  • artiq.language.scan module
  • artiq.language.units module
• Core drivers reference
  • System drivers
  • Digital I/O drivers
  • RF generation drivers
  • DAC/ADC drivers
  • Miscellaneous
• Utilities
  • ARTIQ Firmware Service (AFWS) client
  • Static compiler
  • Flash storage image generator
  • Flashing/Loading tool
  • Core device management tool
  • Core device logging controller
  • Device database template generator
  • ARTIQ RTIO monitor
  • Moninj proxy
  • RTIO channel name map tool
  • Core device RTIO analyzer tool
  • Core device RTIO analyzer proxy
  • DRTIO routing table manipulation tool

Addenda

• FAQ
  • How do I …
  • find ARTIQ examples?
  • prevent my first RTIO command from causing an underflow?
  • organize datasets in folders?
  • organize experiment windows in the dashboard?
  • write a generator feeding a kernel feeding an analyze function?
  • create and use variable lengths arrays in kernels?
  • execute multiple slow controller RPCs in parallel without losing time?
  • write part of my experiment as a coroutine/asyncio task/generator?
  • determine the pyserial URL to attach to a device by its serial number?
  • run unit tests?
  • find the dashboard and browser configuration files are stored?