Function ziAPIGetComplexData#

Defined in File ziAPI.h

ZIResult_enum ziAPIGetComplexData(ZIConnection conn, const char *path, ZIDoubleData *real, ZIDoubleData *imag)#

gets the complex double-type value of the specified node

This function retrieves the numerical value of the specified node as an complex double-type value. The value first found is returned if more than one value is available (a wildcard is used in the path).

// Copyright [2018] Zurich Instruments AG

#include <algorithm>
#include <cstdlib>
#include <ctime>
#include <iostream>
#include <map>
#include <string>

#include "ziAPI.h"
#include "ziUtils.hpp"

void setDemodRate(
    ZIConnection conn,
    const char** deviceAddress,
    uint32_t index,
    ZIDoubleData rate)
{
  char nodePath[1024];
  snprintf(
      nodePath, sizeof(nodePath), "/%s/demods/%d/rate", *deviceAddress, index);
  checkError(ziAPISetValueD(conn, nodePath, rate));
}

ZIDoubleData getDemodRate(
    ZIConnection conn, const char** deviceAddress, uint32_t index)
{
  ZIDoubleData rate;
  char nodePath[1024];
  snprintf(
      nodePath, sizeof(nodePath), "/%s/demods/%d/rate", *deviceAddress, index);
  checkError(ziAPIGetValueD(conn, nodePath, &rate));
  return rate;
}

int main()
{
  // The device address of the device to run the example on.
  const char* deviceAddress = ziUtilsGetEnv("LABONE_DEVICE", "dev2123");
  printf("ENV LABONE_DEVICE=%s\n", deviceAddress);

  // Address of the data server.
  const char* dataServer = ziUtilsGetEnv("LABONE_SERVER", "localhost");

  // Port of the data server.
  const uint16_t port = 8004;

  // Over which interface the connection to the
  // device should be established. Can be either
  // - 1: "1GbE" - Ethernet
  // - 2: "USB" - USB
  // - 3: "PCIe" - PCIe
  const char* deviceInterface = "1GbE";

  ZIConnection conn = nullptr;

  if (isError(ziAPIInit(&conn)))
  {
    return 1;
  }

  ziAPISetDebugLevel(0);
  ziAPIWriteDebugLog(0, "Logging enabled.");

  try
  {
    checkError(
        ziAPIConnectEx(conn, dataServer, port, ZI_API_VERSION_6, nullptr));
    ziApiServerVersionCheck(conn);
    checkError(
        ziAPIConnectDevice(conn, deviceAddress, deviceInterface, nullptr));

    // Set a device configuration.
    uint32_t index = 0;
    ZIDoubleData rate = 10e3;
    setDemodRate(conn, &deviceAddress, index, rate);

    // Read it back.
    rate = getDemodRate(conn, &deviceAddress, index);
    std::cout << "[INFO] "
              << "Device " << deviceAddress << " demod " << index
              << " has rate " << rate << ".\n";

    ziAPIDisconnect(conn);
  }
  catch (std::runtime_error& e)
  {
    char extErrorMessage[1024] = "";
    ziAPIGetLastError(conn, extErrorMessage, 1024);
    fprintf(stderr, "[ERROR] %s\ndetails: `%s`\n.", e.what(), extErrorMessage);
    return 1;
  }
  catch (...)
  {
    // Ensure all exceptions are caught.
    fprintf(stderr, "[ERROR] Unexpected error\n.");
    return 1;
  }

  ziAPIDestroy(conn);
  return 0;
}