Skip to content

Design notes for a generic communication protocol to control experiments and measurement hardware

License

Notifications You must be signed in to change notification settings

pymeasure/leco-protocol

Repository files navigation

LECO - Laboratory Experiment Control Protocol

Design notes for a generic communication protocol to control experiments and measurement hardware.

Introduction

This initiative was born out of a desire of PyMeasure developers, contributors and users to achieve improved and more flexible experiment orchestration/execution, and to achieve (better) interoperation with other instrument control libraries.

LECO is meant to be a specification for a (programming-language-independent) protocol to enable users to run experiments with a number of hardware devices, including logging, data storage, plotting, and GUI.

PyMeasure is an obvious candidate for working with this protocol, and as such will influence the design somewhat, but we will take pains to make sure the protocol will be agnostic to the actual interface package (or language) used. The authors draw on their varied experience setting up such solutions in a number of research laboratories.

Overview

This is an overview over the LECO protocol. See the documentation for a more exhaustive description of the protocol and its elements.

Communication happens via messages (using zeromq) between participants (called Component) in a single application or distributed over the network.

There exist two different communication protocols in LECO.

  1. The control protocol allows to exchange messages between any two Components in a LECO network, which is useful for controlling devices. The default implementation uses remote procedure calls according to JSON-RPC.
  2. The data protocol is a broadcasting protocol to send information to all those, who want to receive it, which is useful for regular measurement data or for log entries. It allows to implement event notifications.

A LECO network needs at least one Coordinator (server), which routes the messages among the connected Components.

Each Component has a name unique in the network, by which it may be addressed. This name consists of the name of the Coordinator (Namespace) they are connected to and their own name. For example N1.component1 is the full name of component1 connected to the Coordinator of the Namespace N1. That Coordinator itself is called N1.COORDINATOR, as Coordinators are always called COORDINATOR.

Implementations

There are LECO implementations in the following languages:

  • Python: PyLECO, a complete suite of Coordinators and Component building blocks.