A2D_Serial.h

Go to the documentation of this file.

// -*- mode: C++; indent-tabs-mode: nil; c-basic-offset: 4; tab-width: 4; -*-
// vim: set shiftwidth=4 softtabstop=4 expandtab:
/*
 ********************************************************************
 ** NIDAS: NCAR In-situ Data Acquistion Software
 **
 ** 2008, Copyright University Corporation for Atmospheric Research
 **
 ** This program is free software; you can redistribute it and/or modify
 ** it under the terms of the GNU General Public License as published by
 ** the Free Software Foundation; either version 2 of the License, or
 ** (at your option) any later version.
 **
 ** This program 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.  See the
 ** GNU General Public License for more details.
 **
 ** The LICENSE.txt file accompanying this software contains
 ** a copy of the GNU General Public License. If it is not found,
 ** write to the Free Software Foundation, Inc.,
 ** 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 **
 ********************************************************************
*/

#ifndef _nidas_dynld_raf_a2d_serial_h_
#define _nidas_dynld_raf_a2d_serial_h_

#include <nidas/core/SerialSensor.h>

#include <nidas/util/InvalidParameterException.h>


// change this later to a const or something
#define NUM_A2D_CHANNELS    4


namespace nidas { namespace dynld { namespace raf {

using namespace nidas::core;

class A2D_Serial : public SerialSensor
{

public:
    enum OutputMode { Counts, Volts, Engineering };

    A2D_Serial();
    ~A2D_Serial();

    void open(int flags) throw(nidas::util::IOException);

    void init() throw(nidas::util::InvalidParameterException);

    virtual Sample* nextSample()
    {
        Sample *samp = SerialSensor::nextSample();

        if (samp) {
            const char *input = (const char *)samp->getConstVoidDataPtr();
            if (input[0] == 'H')      // header packet
                extractStatus(input, samp->getDataByteLength());
        }
        return samp;
    }

    void extractStatus(const char *msg, int len);

    void printStatus(std::ostream& ostr) throw();


    bool process(const Sample* samp,std::list<const Sample*>& results)
        throw();

    void validate() throw(nidas::util::InvalidParameterException);

    int getMaxNumChannels() const { return NUM_A2D_CHANNELS; }

    int getGain(int ichan) const;

    int getBipolar(int ichan) const;

    virtual void setConversionCorrection(int ichan, const float d[],
        int n) throw(nidas::util::InvalidParameterException);

    void setOutputMode(OutputMode mode) { _outputMode = mode; }

    OutputMode getOutputMode() const { return _outputMode; }


protected:
    void readConfig() throw(nidas::util::IOException);

    void parseConfigLine(const char *data);

    void dumpConfig() const;


    bool checkCkSum(const Sample *samp, const char *data);

    bool samplingChannel(int channel) const;

    void readCalFile(dsm_time_t tt) throw();

    float applyCalibration(float value, const std::vector<float> &cals) const;


    int _nVars;

    size_t _sampleRate;

    size_t _deltaT;     // in usecs

    size_t _staticLag;  // in usecs.

    int _boardID;   // serial number
    bool _haveCkSum;    // Will packets have checksum

    CalFile *_calFile;

    OutputMode _outputMode;

    size_t _havePPS;

    int _channels[NUM_A2D_CHANNELS];

    // read these in from XML, use to validate against
    int _ifsr[NUM_A2D_CHANNELS];        // 0 = +-10, 1 = +-5 Vdc
    int _ipol[NUM_A2D_CHANNELS];

    // We will need these to map to cal files.
    int _gains[NUM_A2D_CHANNELS];       // map _ifsr to this; 0->1, 1->2
    int _polarity[NUM_A2D_CHANNELS];    // true


    std::map<std::string, int> configStatus;

    // A/D calibration coefficients
    std::vector<float> _polyCals[NUM_A2D_CHANNELS];

    size_t _shortPacketCnt;
    size_t _badCkSumCnt;
    size_t _largeTimeStampOffset;

int headerLines;

private:

    A2D_Serial(const A2D_Serial&);

    A2D_Serial& operator=(const A2D_Serial&);

};

}}}                     // namespace nidas namespace dynld namespace raf

#endif