MMDevice.h

Go to the documentation of this file.

 
// FILE:          MMDevice.h
// PROJECT:       Micro-Manager
// SUBSYSTEM:     MMDevice - Device adapter kit
//-----------------------------------------------------------------------------
// DESCRIPTION:   The interface to the Micro-Manager devices. Defines the
//                plugin API for all devices.
//
// AUTHOR:        Nenad Amodaj, nenad@amodaj.com, 06/08/2005
//
// COPYRIGHT:     University of California, San Francisco, 2006-2014
//                100X Imaging Inc, 2008
//
// LICENSE:       This file is distributed under the BSD license.
//                License text is included with the source distribution.
//
//                This file is distributed in the hope that it will be useful,
//                but WITHOUT ANY WARRANTY; without even the implied warranty
//                of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
//
//                IN NO EVENT SHALL THE COPYRIGHT OWNER OR
//                CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
//                INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES.
 
#pragma once
 
// Device Interface Version — see README.md for the full versioning policy.
// Must be incremented for any binary-incompatible change.
#define DEVICE_INTERFACE_VERSION 75
 
// N.B. Method parameters and return values in Device and its derived
// classes must be POD types or pointers (no std::string, etc.) to
// maintain binary compatibility across compilers and runtimes.
 
#include "MMDeviceConstants.h"
#include "DeviceUtils.h"
#include "DeviceThreads.h"
 
#include <climits>
#include <cstdlib>
#include <cstring>
#include <iomanip>
#include <sstream>
#include <string>
#include <vector>
 
 
namespace MM {
 
   // forward declaration for the MMCore callback class
   class Core;
 
   class MMTime
   {
         long long microseconds_;
 
      public:
         MMTime() : microseconds_(0LL) {}
 
         explicit MMTime(double uSecTotal) :
            microseconds_(static_cast<long long>(uSecTotal))
         {}
 
         explicit MMTime(long sec, long uSec) :
            microseconds_(sec * 1'000'000LL + uSec)
         {}
 
         static MMTime fromUs(long long us)
         {
            // Work around our lack of a constructor that directly sets the
            // internal representation.
            // (Note that we cannot add a constructor from 'long long' because
            // many existing uses would then get an error (ambiguous with the
            // 'double' overload).)
            MMTime ret;
            ret.microseconds_ = us;
            return ret;
         }
 
         static MMTime fromMs(double ms)
         {
            return MMTime(ms * 1000.0);
         }
 
         static MMTime fromSeconds(long secs)
         {
            return MMTime(secs, 0);
         }
 
         MMTime operator+(const MMTime &other) const
         {
            return fromUs(microseconds_ + other.microseconds_);
         }
 
         MMTime operator-(const MMTime &other) const
         {
            return fromUs(microseconds_ - other.microseconds_);
         }
 
         bool operator>(const MMTime &other) const
         {
            return microseconds_ > other.microseconds_;
         }
 
         bool operator>=(const MMTime &other) const
         {
            return microseconds_ >= other.microseconds_;
         }
 
         bool operator<(const MMTime &other) const
         {
            return microseconds_ < other.microseconds_;
         }
 
         bool operator<=(const MMTime &other) const
         {
            return microseconds_ <= other.microseconds_;
         }
 
         bool operator==(const MMTime &other) const
         {
            return microseconds_ == other.microseconds_;
         }
 
         bool operator!=(const MMTime &other) const
         {
            return !(*this == other);
         }
 
         double getMsec() const
         {
            return microseconds_ / 1000.0;
         }
 
         double getUsec() const
         {
            return static_cast<double>(microseconds_);
         }
 
         std::string toString() const {
            long long absUs = std::abs(microseconds_);
            long long seconds = absUs / 1'000'000LL;
            long long fracUs = absUs - seconds * 1'000'000LL;
            const char *sign = microseconds_ < 0 ? "-" : "";
 
            using namespace std;
            ostringstream s;
            s << sign << seconds << '.' <<
                  setfill('0') << right << setw(6) << fracUs;
            return s.str();
         }
   };
 
 
   class TimeoutMs
   {
   public:
      // arguments:  MMTime start time, millisecond interval time
      explicit TimeoutMs(const MMTime startTime, const unsigned long intervalMs) :
         startTime_(startTime),
         interval_(0, 1000*intervalMs)
      {
      }
      explicit TimeoutMs(const MMTime startTime, const MMTime interval) :
         startTime_(startTime),
         interval_(interval)
      {
      }
 
      bool expired(const MMTime tnow)
      {
         MMTime elapsed = tnow - startTime_;
         return ( interval_ < elapsed );
      }
 
   private:
      MMTime startTime_; // start time
      MMTime interval_; // interval in milliseconds
   };
 
 
   class Device {
   public:
      Device() {}
      virtual ~Device() {}
 
      virtual unsigned GetNumberOfProperties() const = 0;
      virtual int GetProperty(const char* name, char* value) const = 0;
      virtual int SetProperty(const char* name, const char* value) = 0;
      virtual bool HasProperty(const char* name) const = 0;
      virtual bool GetPropertyName(unsigned idx, char* name) const = 0;
      virtual int GetPropertyReadOnly(const char* name, bool& readOnly) const = 0;
      virtual int GetPropertyInitStatus(const char* name, bool& preInit) const = 0;
      virtual int HasPropertyLimits(const char* name, bool& hasLimits) const = 0;
      virtual int GetPropertyLowerLimit(const char* name, double& lowLimit) const = 0;
      virtual int GetPropertyUpperLimit(const char* name, double& hiLimit) const = 0;
      virtual int GetPropertyType(const char* name, MM::PropertyType& pt) const = 0;
      virtual unsigned GetNumberOfPropertyValues(const char* propertyName) const = 0;
      virtual bool GetPropertyValueAt(const char* propertyName, unsigned index, char* value) const = 0;
      virtual int IsPropertySequenceable(const char* name, bool& isSequenceable) const = 0;
      virtual int GetPropertySequenceMaxLength(const char* propertyName, long& nrEvents) const = 0;
      virtual int StartPropertySequence(const char* propertyName) = 0;
      virtual int StopPropertySequence(const char* propertyName) = 0;
      virtual int ClearPropertySequence(const char* propertyName) = 0;
      virtual int AddToPropertySequence(const char* propertyName, const char* value) = 0;
      virtual int SendPropertySequence(const char* propertyName) = 0;
 
      virtual bool GetErrorText(int errorCode, char* errMessage) const = 0;
      virtual bool Busy() = 0;
      virtual double GetDelayMs() const = 0;
      virtual void SetDelayMs(double delay) = 0;
      virtual bool UsesDelay() = 0;
 
      virtual void SetLabel(const char* label) = 0;
      virtual void GetLabel(char* name) const = 0;
      virtual void SetModuleName(const char* moduleName) = 0;
      virtual void GetModuleName(char* moduleName) const = 0;
      virtual void SetDescription(const char* description) = 0;
      virtual void GetDescription(char* description) const = 0;
 
      virtual int Initialize() = 0;
      virtual int Shutdown() = 0;
 
      virtual DeviceType GetType() const = 0;
      virtual void GetName(char* name) const = 0;
      virtual void SetCallback(Core* callback) = 0;
 
      //device discovery API
      virtual bool SupportsDeviceDetection(void) = 0;
      virtual MM::DeviceDetectionStatus DetectDevice(void) = 0;
 
      // hub-peripheral relationship
      virtual void SetParentID(const char* parentId) = 0;
      virtual void GetParentID(char* parentID) const = 0;
      // virtual void SetID(const char* id) = 0;
      // virtual void GetID(char* id) const = 0;
   };
 
   class Generic : public Device
   {
   public:
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
   };
 
   class Camera : public Device {
   public:
      Camera() {}
      virtual ~Camera() {}
 
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      // Camera API
      virtual int SnapImage() = 0;
      virtual const unsigned char* GetImageBuffer() = 0;
      virtual const unsigned char* GetImageBuffer(unsigned channelNr) = 0;
      virtual const unsigned int* GetImageBufferAsRGB32() = 0;
      virtual unsigned GetNumberOfComponents() const = 0;
 
      virtual int unsigned GetNumberOfChannels() const = 0;
      virtual int GetChannelName(unsigned channel, char* name) = 0;
      virtual long GetImageBufferSize() const = 0;
      virtual unsigned GetImageWidth() const = 0;
      virtual unsigned GetImageHeight() const = 0;
      virtual unsigned GetImageBytesPerPixel() const = 0;
      virtual unsigned GetBitDepth() const = 0;
      virtual int GetBinning() const = 0;
      virtual int SetBinning(int binSize) = 0;
      virtual void SetExposure(double exp_ms) = 0;
      virtual double GetExposure() const = 0;
      virtual int SetROI(unsigned x, unsigned y, unsigned xSize, unsigned ySize) = 0;
      virtual int GetROI(unsigned& x, unsigned& y, unsigned& xSize, unsigned& ySize) = 0;
      virtual int ClearROI() = 0;
      virtual bool SupportsMultiROI() = 0;
      virtual bool IsMultiROISet() = 0;
      virtual int GetMultiROICount(unsigned& count) = 0;
      virtual int SetMultiROI(const unsigned* xs, const unsigned* ys,
              const unsigned* widths, const unsigned* heights,
              unsigned numROIs) = 0;
      virtual int GetMultiROI(unsigned* xs, unsigned* ys, unsigned* widths,
              unsigned* heights, unsigned* length) = 0;
      virtual int StartSequenceAcquisition(long numImages, double interval_ms, bool stopOnOverflow) = 0;
      virtual int StartSequenceAcquisition(double interval_ms) = 0;
      virtual int StopSequenceAcquisition() = 0;
      virtual bool IsCapturing() = 0;
 
      virtual void GetTags(char* serializedMetadata) = 0;
 
      virtual void AddTag(const char* key, const char* deviceLabel, const char* value) = 0;
 
      virtual void RemoveTag(const char* key) = 0;
 
      virtual int IsExposureSequenceable(bool& isSequenceable) const = 0;
 
      // Sequence functions
      // Sequences can be used for fast acquisitions, synchronized by TTLs rather than
      // computer commands.
      // Sequences of exposures can be uploaded to the camera.  The camera will cycle through
      // the uploaded list of exposures (triggered by either an internal or
      // external trigger).  If the device is capable (and ready) to do so isSequenceable will
      // be true. If your device can not execute this (true for most cameras)
      // simply set IsExposureSequenceable to false
      virtual int GetExposureSequenceMaxLength(long& nrEvents) const = 0;
      virtual int StartExposureSequence() = 0;
      virtual int StopExposureSequence() = 0;
      // Remove all values in the sequence
      virtual int ClearExposureSequence() = 0;
      // Add one value to the sequence
      virtual int AddToExposureSequence(double exposureTime_ms) = 0;
      // Signal that we are done sending sequence values so that the adapter can send the whole sequence to the device
      virtual int SendExposureSequence() const = 0;
   };
 
   class Shutter : public Device
   {
   public:
      Shutter() {}
      virtual ~Shutter() {}
 
      // Device API
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      // Shutter API
      virtual int SetOpen(bool open = true) = 0;
      virtual int GetOpen(bool& open) = 0;
      virtual int Fire(double deltaT) = 0;
   };
 
   class Stage : public Device
   {
   public:
      Stage() {}
      virtual ~Stage() {}
 
      // Device API
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      // Stage API
      virtual int SetPositionUm(double pos) = 0;
      virtual int SetRelativePositionUm(double d) = 0;
      virtual int Move(double velocity) = 0;
      virtual int Stop() = 0;
      virtual int Home() = 0;
      virtual int SetAdapterOriginUm(double d) = 0;
      virtual int GetPositionUm(double& pos) = 0;
      virtual int SetPositionSteps(long steps) = 0;
      virtual int GetPositionSteps(long& steps) = 0;
      virtual int SetOrigin() = 0;
      virtual int GetLimits(double& lower, double& upper) = 0;
 
      virtual int UsesOnStagePositionChanged(bool& result) const = 0;
 
      virtual int GetFocusDirection(FocusDirection& direction) = 0;
 
      virtual int IsStageSequenceable(bool& isSequenceable) const = 0;
 
      virtual int IsStageLinearSequenceable(bool& isSequenceable) const = 0;
 
      // Check if a stage has continuous focusing capability (positions can be set while continuous focus runs).
      virtual bool IsContinuousFocusDrive() const = 0;
 
      // Sequence functions
      // Sequences can be used for fast acquisitions, synchronized by TTLs rather than
      // computer commands.
      // Sequences of positions can be uploaded to the stage.  The device will cycle through
      // the uploaded list of states (triggered by an external trigger - most often coming
      // from the camera).  If the device is capable (and ready) to do so isSequenceable will
      // be true. If your device can not execute this (true for most stages)
      // simply set isSequenceable to false
      virtual int GetStageSequenceMaxLength(long& nrEvents) const = 0;
      virtual int StartStageSequence() = 0;
      virtual int StopStageSequence() = 0;
      virtual int ClearStageSequence() = 0;
      virtual int AddToStageSequence(double position) = 0;
      virtual int SendStageSequence() = 0;
 
      virtual int SetStageLinearSequence(double dZ_um, long nSlices) = 0;
   };
 
   class XYStage : public Device
   {
   public:
      XYStage() {}
      virtual ~XYStage() {}
 
      // Device API
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      // XYStage API
      // it is recommended that device adapters implement the  "Steps" methods
      // taking long integers but leave the default implementations (in
      // DeviceBase.h) for the "Um" methods taking doubles. The latter utilize
      // directionality and origin settings set by user and operate via the
      // "Steps" methods. The step size is the inherent minimum distance/step
      // and should be defined by the adapter.
      virtual int SetPositionUm(double x, double y) = 0;
      virtual int SetRelativePositionUm(double dx, double dy) = 0;
      virtual int SetAdapterOriginUm(double x, double y) = 0;
      virtual int GetPositionUm(double& x, double& y) = 0;
      virtual int GetLimitsUm(double& xMin, double& xMax, double& yMin, double& yMax) = 0;
      virtual int Move(double vx, double vy) = 0;
 
      virtual int SetPositionSteps(long x, long y) = 0;
      virtual int GetPositionSteps(long& x, long& y) = 0;
      virtual int SetRelativePositionSteps(long x, long y) = 0;
      virtual int Home() = 0;
      virtual int Stop() = 0;
 
      virtual int UsesOnXYStagePositionChanged(bool &result) const = 0;
 
      virtual int SetOrigin() = 0;
 
      virtual int SetXOrigin() = 0;
 
      virtual int SetYOrigin() = 0;
 
      virtual int GetStepLimits(long& xMin, long& xMax, long& yMin, long& yMax) = 0;
      virtual double GetStepSizeXUm() = 0;
      virtual double GetStepSizeYUm() = 0;
      virtual int IsXYStageSequenceable(bool& isSequenceable) const = 0;
      // Sequence functions
      // Sequences can be used for fast acquisitions, synchronized by TTLs rather than
      // computer commands.
      // Sequences of positions can be uploaded to the XY stage.  The device will cycle through
      // the uploaded list of states (triggered by an external trigger - most often coming
      // from the camera).  If the device is capable (and ready) to do so isSequenceable will
      // be true. If your device can not execute this (true for most XY stages
      // simply set isSequenceable to false
      virtual int GetXYStageSequenceMaxLength(long& nrEvents) const = 0;
      virtual int StartXYStageSequence() = 0;
      virtual int StopXYStageSequence() = 0;
      virtual int ClearXYStageSequence() = 0;
      virtual int AddToXYStageSequence(double positionX, double positionY) = 0;
      virtual int SendXYStageSequence() = 0;
 
   };
 
   class State : public Device
   {
   public:
      State() {}
      virtual ~State() {}
 
      // MMDevice API
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      // MMStateDevice API
      virtual int SetPosition(long pos) = 0;
      virtual int SetPosition(const char* label) = 0;
      virtual int GetPosition(long& pos) const = 0;
      virtual int GetPosition(char* label) const = 0;
      virtual int GetPositionLabel(long pos, char* label) const = 0;
      virtual int GetLabelPosition(const char* label, long& pos) const = 0;
      virtual int SetPositionLabel(long pos, const char* label) = 0;
      virtual unsigned long GetNumberOfPositions() const = 0;
      virtual int SetGateOpen(bool open = true) = 0;
      virtual int GetGateOpen(bool& open) = 0;
   };
 
   class Serial : public Device
   {
   public:
      Serial() {}
      virtual ~Serial() {}
 
      // MMDevice API
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      // Serial API
      virtual PortType GetPortType() const = 0;
      virtual int SetCommand(const char* command, const char* term) = 0;
      virtual int GetAnswer(char* txt, unsigned maxChars, const char* term) = 0;
      virtual int Write(const unsigned char* buf, unsigned long bufLen) = 0;
      virtual int Read(unsigned char* buf, unsigned long bufLen, unsigned long& charsRead) = 0;
      virtual int Purge() = 0;
   };
 
   class AutoFocus : public Device
   {
   public:
      AutoFocus() {}
      virtual ~AutoFocus() {}
 
      // MMDevice API
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      // AutoFocus API
      virtual int SetContinuousFocusing(bool state) = 0;
      virtual int GetContinuousFocusing(bool& state) = 0;
      virtual bool IsContinuousFocusLocked() = 0;
      virtual int FullFocus() = 0;
      virtual int IncrementalFocus() = 0;
      virtual int GetLastFocusScore(double& score) = 0;
      virtual int GetCurrentFocusScore(double& score) = 0;
      virtual int AutoSetParameters() = 0;
      virtual int GetOffset(double &offset) = 0;
      virtual int SetOffset(double offset) = 0;
   };
 
   class ImageProcessor : public Device
   {
      public:
         ImageProcessor() {}
         virtual ~ImageProcessor() {}
 
      // MMDevice API
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      // image processor API
      virtual int Process(unsigned char* buffer, unsigned width, unsigned height, unsigned byteDepth) = 0;
 
 
   };
 
   class SignalIO : public Device
   {
   public:
      SignalIO() {}
      virtual ~SignalIO() {}
 
      // MMDevice API
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      // signal io API
      virtual int SetGateOpen(bool open = true) = 0;
      virtual int GetGateOpen(bool& open) = 0;
      virtual int SetSignal(double volts) = 0;
      virtual int GetSignal(double& volts) = 0;
      virtual int GetLimits(double& minVolts, double& maxVolts) = 0;
 
      virtual int IsDASequenceable(bool& isSequenceable) const = 0;
 
      // Sequence functions
      // Sequences can be used for fast acquisitions, synchronized by TTLs rather than
      // computer commands.
      // Sequences of voltages can be uploaded to the DA.  The device will cycle through
      // the uploaded list of voltages (triggered by an external trigger - most often coming
      // from the camera).  If the device is capable (and ready) to do so isSequenceable will
      // be true. If your device can not execute this simply set isSequenceable to false
      virtual int GetDASequenceMaxLength(long& nrEvents) const = 0;
      virtual int StartDASequence() = 0;
      virtual int StopDASequence() = 0;
      virtual int ClearDASequence() = 0;
 
      virtual int AddToDASequence(double voltage) = 0;
      virtual int SendDASequence() = 0;
 
   };
 
   class Magnifier : public Device
   {
   public:
      Magnifier() {}
      virtual ~Magnifier() {}
 
      // MMDevice API
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      virtual double GetMagnification() = 0;
   };
 
 
   class SLM : public Device
   {
   public:
      SLM() {}
      virtual ~SLM() {}
 
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      // SLM API
      virtual int SetImage(unsigned char * pixels) = 0;
 
      virtual int SetImage(unsigned int * pixels) = 0;
 
      virtual int DisplayImage() = 0;
 
      virtual int SetPixelsTo(unsigned char intensity) = 0;
 
      virtual int SetPixelsTo(unsigned char red, unsigned char green, unsigned char blue) = 0;
 
      virtual int SetExposure(double interval_ms) = 0;
 
      virtual double GetExposure() = 0;
 
      virtual unsigned GetWidth() = 0;
 
      virtual unsigned GetHeight() = 0;
 
      virtual unsigned GetNumberOfComponents() = 0;
 
      virtual unsigned GetBytesPerPixel() = 0;
 
      // SLM Sequence functions
      // Sequences can be used for fast acquisitions, synchronized by TTLs rather than
      // computer commands.
      // Sequences of images can be uploaded to the SLM.  The SLM will cycle through
      // the uploaded list of images (perhaps triggered by an external trigger or by
      // an internal clock.
      // If the device is capable (and ready) to do so IsSLMSequenceable will return
      // be true. If your device can not execute sequences, IsSLMSequenceable returns false.
 
      virtual int IsSLMSequenceable(bool& isSequenceable) const = 0;
 
      virtual int GetSLMSequenceMaxLength(long& nrEvents) const = 0;
 
      virtual int StartSLMSequence() = 0;
 
      virtual int StopSLMSequence() = 0;
 
      virtual int ClearSLMSequence() = 0;
 
      virtual int AddToSLMSequence(const unsigned char * const pixels) = 0;
 
      virtual int AddToSLMSequence(const unsigned int * const pixels) = 0;
 
      virtual int SendSLMSequence() = 0;
 
   };
 
   class Galvo : public Device
   {
   public:
      Galvo() {}
      virtual ~Galvo() {}
 
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
   //Galvo API:
 
      virtual int PointAndFire(double x, double y, double time_us) = 0;
      virtual int SetSpotInterval(double pulseInterval_us) = 0;
      virtual int SetPosition(double x, double y) = 0;
      virtual int GetPosition(double& x, double& y) = 0;
      virtual int SetIlluminationState(bool on) = 0;
      virtual double GetXRange() = 0;
      virtual double GetXMinimum() = 0;
      virtual double GetYRange() = 0;
      virtual double GetYMinimum() = 0;
      virtual int AddPolygonVertex(int polygonIndex, double x, double y) = 0;
      virtual int DeletePolygons() = 0;
      virtual int RunSequence() = 0;
      virtual int LoadPolygons() = 0;
      virtual int SetPolygonRepetitions(int repetitions) = 0;
      virtual int RunPolygons() = 0;
      virtual int StopSequence() = 0;
      virtual int GetChannel(char* channelName) = 0;
   };
 
   class Hub : public Device
   {
   public:
      Hub() {}
      virtual ~Hub() {}
 
      // MMDevice API
      virtual DeviceType GetType() const { return Type; }
      static const DeviceType Type;
 
      virtual int DetectInstalledDevices() = 0;
 
      virtual void ClearInstalledDevices() = 0;
 
      virtual unsigned GetNumberOfInstalledDevices() = 0;
 
      virtual Device* GetInstalledDevice(int devIdx) = 0;
   };
 
   class PressurePump : public Device
   {
   public:
       PressurePump() {}
       virtual ~PressurePump() {}
 
       // MMDevice API
       virtual DeviceType GetType() const { return Type; }
       static const DeviceType Type;
 
       virtual int Stop() = 0;
 
       virtual int Calibrate() = 0;
 
       virtual bool RequiresCalibration() = 0;
 
       virtual int SetPressureKPa(double pressureKPa) = 0;
 
       virtual int GetPressureKPa(double& pressureKPa) = 0;
   };
 
   class VolumetricPump : public Device
   {
   public:
       VolumetricPump() {}
       virtual ~VolumetricPump() {}
 
       // MMDevice API
       virtual DeviceType GetType() const { return Type; }
       static const DeviceType Type;
 
       virtual int Home() = 0;
 
       virtual int Stop() = 0;
 
       virtual bool RequiresHoming() = 0;
 
       virtual int InvertDirection(bool inverted) = 0;
 
       virtual int IsDirectionInverted(bool& inverted) = 0;
 
       virtual int SetVolumeUl(double volUl) = 0;
 
       virtual int GetVolumeUl(double& volUl) = 0;
 
       virtual int SetMaxVolumeUl(double volUl) = 0;
 
       virtual int GetMaxVolumeUl(double& volUl) = 0;
 
       virtual int SetFlowrateUlPerSecond(double flowrate) = 0;
 
       virtual int GetFlowrateUlPerSecond(double& flowrate) = 0;
 
       virtual int Start() = 0;
 
       virtual int DispenseDurationSeconds(double durSec) = 0;
 
       virtual int DispenseVolumeUl(double volUl) = 0;
   };
 
 
   class Core
   {
   public:
      Core() {}
      virtual ~Core() {}
 
      virtual int LogMessage(const Device* caller, const char* msg, bool debugOnly) const = 0;
      virtual Device* GetDevice(const Device* caller, const char* label) = 0;
      virtual int GetDeviceProperty(const char* deviceName, const char* propName, char* value) = 0;
      virtual int SetDeviceProperty(const char* deviceName, const char* propName, const char* value) = 0;
 
      virtual void GetLoadedDeviceOfType(const Device* caller, MM::DeviceType devType, char* pDeviceName, const unsigned int deviceIterator) = 0;
 
      virtual int SetSerialProperties(const char* portName,
                                      const char* answerTimeout,
                                      const char* baudRate,
                                      const char* delayBetweenCharsMs,
                                      const char* handshaking,
                                      const char* parity,
                                      const char* stopBits) = 0;
      virtual int SetSerialCommand(const Device* caller, const char* portName, const char* command, const char* term) = 0;
      virtual int GetSerialAnswer(const Device* caller, const char* portName, unsigned long ansLength, char* answer, const char* term) = 0;
      virtual int WriteToSerial(const Device* caller, const char* port, const unsigned char* buf, unsigned long length) = 0;
      virtual int ReadFromSerial(const Device* caller, const char* port, unsigned char* buf, unsigned long length, unsigned long& read) = 0;
      virtual int PurgeSerial(const Device* caller, const char* portName) = 0;
      virtual MM::PortType GetSerialPortType(const char* portName) const = 0;
 
      virtual int OnPropertiesChanged(const Device* caller) = 0;
      virtual int OnPropertyChanged(const Device* caller, const char* propName, const char* propValue) = 0;
      virtual int OnStagePositionChanged(const Device* caller, double pos) = 0;
      virtual int OnXYStagePositionChanged(const Device* caller, double xPos, double yPos) = 0;
      virtual int OnExposureChanged(const Device* caller, double newExposure) = 0;
      virtual int OnSLMExposureChanged(const Device* caller, double newExposure) = 0;
      virtual int OnMagnifierChanged(const Device* caller) = 0;
      virtual int OnShutterOpenChanged(const Device* caller, bool open) = 0;
 
      // Deprecated: Return value overflows in ~72 minutes on Windows.
      // Prefer std::chrono::steady_clock for time delta measurements.
      virtual unsigned long GetClockTicksUs(const Device* caller) = 0;
 
      // Returns monotonic MMTime suitable for time delta measurements.
      // Time zero is not fixed and may change on every launch.
      // Prefer std::chrono::steady_clock::now() in new code.
      virtual MM::MMTime GetCurrentMMTime() = 0;
 
      // sequence acquisition
      virtual int AcqFinished(const Device* caller, int statusCode) = 0;
      virtual int PrepareForAcq(const Device* caller) = 0;
 
      virtual int InsertImage(const Device* caller, const unsigned char* buf,
         unsigned width, unsigned height, unsigned bytePerPixel, unsigned nComponents,
         const char* serializedMetadata = nullptr) = 0;
 
      virtual int InsertImage(const Device* caller, const unsigned char* buf,
         unsigned width, unsigned height, unsigned bytePerPixel,
         const char* serializedMetadata = nullptr) = 0;
 
      virtual bool InitializeImageBuffer(unsigned channels, unsigned slices, unsigned int w, unsigned int h, unsigned int pixDepth) = 0;
 
      // These functions violate the separation between device adapters and
      // will be removed as soon as we remove all uses. Never use in new code.
      MMDEVICE_DEPRECATED virtual int GetFocusPosition(double& pos) = 0;
      MMDEVICE_DEPRECATED virtual MM::SignalIO* GetSignalIODevice(const MM::Device* caller, const char* deviceName) = 0;
 
      virtual MM::Hub* GetParentHub(const MM::Device* caller) const = 0;
   };
 
} // namespace MM