Multi Value Registers (1D Register Accessors)

Registers can have more than one value, so they are a one-dimensional "array" of data.

Like the ScalarRegisterAccessor, the OneDRegisterAccessor is a buffering accessor which is synchronised via read() and write() with the hardware. Access to data member works like a std::vector, incl. [] operator and iterators.

// SPDX-FileCopyrightText: Deutsches Elektronen-Synchrotron DESY, MSK, ChimeraTK Project <chimeratk-support@desy.de>
// SPDX-License-Identifier: LGPL-3.0-or-later
 
#include <ChimeraTK/Device.h>
#include <ChimeraTK/Utilities.h>
 
#include <iostream>
 
int main() {
  ChimeraTK::setDMapFilePath("example.dmap");
 
  ChimeraTK::Device myDevice("MY_DEVICE");
  myDevice.open();
 
  /*
   * The device contains a register called CLOCKS in the BOARD section.
   * It contains 4 values for 4 different clocks.
   */
  ChimeraTK::OneDRegisterAccessor<double> clocks = myDevice.getOneDRegisterAccessor<double>("BOARD/CLOCKS");
  std::cout << "The clocks register has " << clocks.getNElements() << " elements." << std::endl;
 
  /*
   * Read data for the whole register from the hardware
   */
  clocks.read();
 
  /*
   * The OneDRegisterAccessor behaves like a std::vector, incl. [] operator
   * and iterators.
   */
  for(size_t i = 0; i < clocks.getNElements(); ++i) {
    clocks[i] = 42 + i;
  }
  std::cout << "Clocks are";
  for(auto clockValue : clocks) {
    std::cout << " " << clockValue;
  }
  std::cout << std::endl;
 
  /*
   * Write all values of the CLOCKS register to the hardware.
   */
  clocks.write();
 
  myDevice.close();
 
  return 0;
}

Next topic: 2D Register Accessors