acq400_asyn_common.h

/*
 * acq400_asyn_common.h
 *
 *  Created on: 21 Feb 2025
 *      Author: pgm
 */
 
#ifndef ACQ400IOCAPP_SRC_ACQ400_ASYN_COMMON_H_
#define ACQ400IOCAPP_SRC_ACQ400_ASYN_COMMON_H_
 
#include <epicsExport.h>
#include <epicsTypes.h>
#include <epicsTime.h>
#include <epicsThread.h>
#include <epicsString.h>
#include <epicsTimer.h>
#include <epicsMutex.h>
#include <epicsEvent.h>
#include <iocsh.h>
 
#include <vector>
#include <split2.h>
 
#include "asynPortDriver.h"
#include "acq400_asynPortDriver.h"
#include "acq-util.h"
#include <unistd.h>
#include <stdio.h>
#include <string.h>
 
/* fix printf compiler warning */
#ifdef __arm__
#define FMTSZT "%u"
#define FML    ""
#else
#define FMTSZT "%lu"
#define FML    "l"
#endif
 
/** SP32 : Scratch Pad 32 bit values, up to 16 values, index 0..7 usable. @@todo
 * @brief : the Scratch Pad appends padding/metadata to each sample
 * WRV detail : 4 bit "seconds", 28 bit "ticks" with 25ns resolution;
 * match seconds to WRS to get a full timestamp.
 */
namespace SP32 {
const int SP0 = 0; /**< Sample Count, inserted by HW */
const int SP1 = 1; /**< usec count, inserted by HW   */
const int SP2 = 2; /**< WRV : White Rabbit Vernier time, inserted by HW. */
const int SP3 = 3; /**< WRS : White Rabbit Seconds, inserted by SW.      */
}
#define SP0 0
#define SP1 1
#define SP2 2
#define SP3 3
 
typedef short AI16_t;
typedef unsigned long DI32_t;
typedef unsigned long DO32_t;
typedef unsigned long SP32_t;
 
std::vector<int> csv2int(const char* csv);
 
bool epicsTimeDiffLessThan(epicsTimeStamp& t1, epicsTimeStamp& t0, double tgts);
bool epicsTimeDiffGreaterThan(epicsTimeStamp& t1, epicsTimeStamp& t0, double tgts);
 
#define TICKSPERUS  40
#define USPS        1000000
 
 
epicsInt64 getWrTsUs(unsigned wrse, unsigned wrv);
/**< create full Timestamp from <wrse> White Rabbit Seconds from Epoch and
 * <wrv> : White Rabbit Vernier, the coded output from the WR firmware.
 */
 
#define NSPERTICK   25
#define NSPS        1000000000
 
epicsInt64 getWrTsNs(unsigned wrse, unsigned wrv);
/**< create full Timestamp from <wrse> White Rabbit Seconds from Epoch and
 * <wrv> : White Rabbit Vernier, the coded output from the WR firmware.
 * wrv max = 40e6. 40e6 * 25 = 0x369aca00 -> fits a u32
 * .. our 28 bit vernier is good to 250MHz.
 */
 
epicsInt64 getWrTs(unsigned wrse, unsigned wrv);
 
 
const char* getenv_default(const char* key, const char* def = "echo undefined");
 
#endif /* ACQ400IOCAPP_SRC_ACQ400_ASYN_COMMON_H_ */