src/Network/generic.hxx

   1 // generic.hxx -- generic protocol class
   2 //
   3 // Written by Curtis Olson, started November 1999.
   4 //
   5 // Copyright (C) 1999  Curtis L. Olson - http://www.flightgear.org/~curt
   6 //
   7 // This program is free software; you can redistribute it and/or
   8 // modify it under the terms of the GNU General Public License as
   9 // published by the Free Software Foundation; either version 2 of the
  10 // License, or (at your option) any later version.
  11 //
  12 // This program is distributed in the hope that it will be useful, but
  13 // WITHOUT ANY WARRANTY; without even the implied warranty of
  14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 // General Public License for more details.
  16 //
  17 // You should have received a copy of the GNU General Public License
  18 // along with this program; if not, write to the Free Software
  19 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  20 //
  21 // $Id$
  22
  23
  24 #ifndef _FG_SERIAL_HXX
  25 #define _FG_SERIAL_HXX
  26
  27
  28 #include <simgear/compiler.h>
  29
  30 #include <string>
  31
  32 #include "protocol.hxx"
  33
  34 using std::string;
  35
  36
  37 class FGGeneric : public FGProtocol {
  38
  39 public:
  40
  41     FGGeneric(vector<string>);
  42     ~FGGeneric();
  43
  44     bool gen_message();
  45     bool parse_message(int length);
  46
  47     // open hailing frequencies
  48     bool open();
  49
  50     void reinit();
  51
  52     // process work for this port
  53     bool process();
  54
  55     // close the channel
  56     bool close();
  57
  58     void setExitOnError(bool val) { exitOnError = val; }
  59     bool getExitOnError() { return exitOnError; }
  60 protected:
  61
  62     enum e_type { FG_BOOL=0, FG_INT, FG_FLOAT, FG_DOUBLE, FG_STRING, FG_FIXED };
  63
  64     typedef struct {
  65      // string name;
  66         string format;
  67         e_type type;
  68         double offset;
  69         double factor;
  70         double min, max;
  71         bool wrap;
  72         bool rel;
  73         SGPropertyNode_ptr prop;
  74     } _serial_prot;
  75
  76 private:
  77
  78     string file_name;
  79     string direction;
  80
  81     int length;
  82     char buf[ FG_MAX_MSG_SIZE ];
  83
  84     string preamble;
  85     string postamble;
  86     string var_separator;
  87     string line_separator;
  88     string var_sep_string;
  89     string line_sep_string;
  90     vector<_serial_prot> _out_message;
  91     vector<_serial_prot> _in_message;
  92
  93     bool binary_mode;
  94     enum {FOOTER_NONE, FOOTER_LENGTH, FOOTER_MAGIC} binary_footer_type;
  95     int binary_footer_value;
  96     int binary_record_length;
  97     enum {BYTE_ORDER_NEEDS_CONVERSION, BYTE_ORDER_MATCHES_NETWORK_ORDER} binary_byte_order;
  98
  99     bool gen_message_ascii();
 100     bool gen_message_binary();
 101     bool parse_message_ascii(int length);
 102     bool parse_message_binary(int length);
 103     void read_config(SGPropertyNode *root, vector<_serial_prot> &msg);
 104     bool exitOnError;
 105
 106     template<class T>
 107     static void updateValue(_serial_prot& prot, const T& val)
 108     {
 109       T new_val = (prot.rel ? getValue<T>(prot.prop) : 0)
 110                 + prot.offset
 111                 + prot.factor * val;
 112
 113       if( prot.max > prot.min )
 114       {
 115         if( prot.wrap )
 116           new_val = SGMisc<double>::normalizePeriodic(prot.min, prot.max, new_val);
 117         else
 118           new_val = SGMisc<T>::clip(new_val, prot.min, prot.max);
 119       }
 120
 121       setValue(prot.prop, new_val);
 122     }
 123
 124     // Special handling for bool (relative change = toggle, no min/max, no wrap)
 125     static void updateValue(_serial_prot& prot, bool val);
 126 };
 127
 128
 129 #endif // _FG_SERIAL_HXX
 130
 131