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/core/A2DConverter.h>
 
#include <nidas/util/InvalidParameterException.h>
 
// change this later to a const or something
#define NUM_GPDAQ_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);
 
    void init();
 
    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);
 
    void validate();
 
    int getMaxNumChannels() const { return NUM_GPDAQ_A2D_CHANNELS; }
 
    int getGain(int ichan) const;
 
    int getBipolar(int ichan) const;
 
    void getDefaultConversion(int ichan, float& intercept, float& slope) const;
 
    void setOutputMode(OutputMode mode) { _outputMode = mode; }
 
    OutputMode getOutputMode() const { return _outputMode; }
 
protected:
 
    A2DConverter* _initialConverter;
 
    A2DConverter* _finalConverter;
 
    void readConfig();
 
    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 _ivarByChan[NUM_GPDAQ_A2D_CHANNELS];
 
    int _ifsr[NUM_GPDAQ_A2D_CHANNELS];
 
    // We will need these to map to cal files.
    // int _gains[NUM_GPDAQ_A2D_CHANNELS];     // map _ifsr to this; 0->1, 1->2
 
    int _ipol[NUM_GPDAQ_A2D_CHANNELS];
 
    // int _bipolar[NUM_GPDAQ_A2D_CHANNELS];   // true
 
    int _calset;        // Diagnostic (auto_cal) channels, toggle bit per channel.
    int _voltage;       // Diagnostic (auto_cal) voltage, -99 = normal operation.
 
    std::map<std::string, int> configStatus;
 
    size_t _shortPacketCnt;
    size_t _badCkSumCnt;
    size_t _largeTimeStampOffset;
 
    int headerLines;
 
    void executeXmlRpc(XmlRpc::XmlRpcValue& params, XmlRpc::XmlRpcValue& result)
        throw();
 
    void getA2DSetup(XmlRpc::XmlRpcValue& params, XmlRpc::XmlRpcValue& result)
        throw();
 
    void testVoltage(XmlRpc::XmlRpcValue& params, XmlRpc::XmlRpcValue& result)
        throw();
 
private:
 
    A2D_Serial(const A2D_Serial&);
 
    A2D_Serial& operator=(const A2D_Serial&);
 
};
 
}}}                     // namespace nidas namespace dynld namespace raf
 
#endif