X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=src%2FNetwork%2Fnet_ctrls.hxx;h=30eaf01c236ccba9544e05bf84653f74de0f7e09;hb=ff408dc540b0944061b0b88bdad93b5de17dbab9;hp=a1797b3f637296eab3f79665d331cb8792e8d114;hpb=2eaaddc52a2522f5b2756d3c7b2973b1d8921d83;p=flightgear.git diff --git a/src/Network/net_ctrls.hxx b/src/Network/net_ctrls.hxx index a1797b3f6..30eaf01c2 100644 --- a/src/Network/net_ctrls.hxx +++ b/src/Network/net_ctrls.hxx @@ -1,23 +1,10 @@ // net_ctrls.hxx -- defines a common net I/O interface to the flight // sim controls // -// Written by Curtis Olson, started July 2001. +// Written by Curtis Olson - http://www.flightgear.org/~curt +// Started July 2001. // -// Copyright (C) 2001 Curtis L. Olson - curt@flightgear.com -// -// 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. -// -// You should have received a copy of the GNU General Public License -// along with this program; if not, write to the Free Software -// Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +// This file is in the Public Domain, and comes with no warranty. // // $Id$ @@ -25,12 +12,26 @@ #ifndef _NET_CTRLS_HXX #define _NET_CTRLS_HXX +#include -#ifndef __cplusplus -# error This library requires C++ -#endif +// NOTE: this file defines an external interface structure. Due to +// variability between platforms and architectures, we only used fixed +// length types here. Specifically, integer types can vary in length. +// I am not aware of any platforms that don't use 4 bytes for float +// and 8 bytes for double. -const int FG_NET_CTRLS_VERSION = 11; +// !!! IMPORTANT !!! +/* There is some space reserved in the protocol for future use. + * When adding a new type, add it just before the "reserved" definition + * and subtract the size of this new type from the RESERVED_SPACE definition + * (1 for (u)int32_t or float and 2 for double). + * + * This way the protocol will be forward and backward compatible until + * RESERVED_SPACE becomes zero. + */ + +#define RESERVED_SPACE 25 +const uint32_t FG_NET_CTRLS_VERSION = 27; // Define a structure containing the control parameters @@ -39,51 +40,109 @@ class FGNetCtrls { public: - int version; // increment when data values change - enum { FG_MAX_ENGINES = 4, - FG_MAX_WHEELS = 3, - FG_MAX_TANKS = 4 + FG_MAX_WHEELS = 16, + FG_MAX_TANKS = 8 }; + uint32_t version; // increment when data values change + // Aero controls double aileron; // -1 ... 1 double elevator; // -1 ... 1 - double elevator_trim; // -1 ... 1 double rudder; // -1 ... 1 + double aileron_trim; // -1 ... 1 + double elevator_trim; // -1 ... 1 + double rudder_trim; // -1 ... 1 double flaps; // 0 ... 1 - bool flaps_power; // true = power available + double spoilers; + double speedbrake; + + // Aero control faults + uint32_t flaps_power; // true = power available + uint32_t flap_motor_ok; // Engine controls - int num_engines; // number of valid engines - int magnetos[FG_MAX_ENGINES]; - bool starter_power[FG_MAX_ENGINES]; // true = starter power + uint32_t num_engines; // number of valid engines + uint32_t master_bat[FG_MAX_ENGINES]; + uint32_t master_alt[FG_MAX_ENGINES]; + uint32_t magnetos[FG_MAX_ENGINES]; + uint32_t starter_power[FG_MAX_ENGINES];// true = starter power double throttle[FG_MAX_ENGINES]; // 0 ... 1 double mixture[FG_MAX_ENGINES]; // 0 ... 1 - bool fuel_pump_power[FG_MAX_ENGINES];// true = on + double condition[FG_MAX_ENGINES]; // 0 ... 1 + uint32_t fuel_pump_power[FG_MAX_ENGINES];// true = on double prop_advance[FG_MAX_ENGINES]; // 0 ... 1 + uint32_t feed_tank_to[4]; + uint32_t reverse[4]; + + + // Engine faults + uint32_t engine_ok[FG_MAX_ENGINES]; + uint32_t mag_left_ok[FG_MAX_ENGINES]; + uint32_t mag_right_ok[FG_MAX_ENGINES]; + uint32_t spark_plugs_ok[FG_MAX_ENGINES]; // false = fouled plugs + uint32_t oil_press_status[FG_MAX_ENGINES];// 0 = normal, 1 = low, 2 = full fail + uint32_t fuel_pump_ok[FG_MAX_ENGINES]; // Fuel management - int num_tanks; // number of valid tanks - bool fuel_selector[FG_MAX_TANKS]; // false = off, true = on + uint32_t num_tanks; // number of valid tanks + uint32_t fuel_selector[FG_MAX_TANKS]; // false = off, true = on + uint32_t xfer_pump[5]; // specifies transfer from array + // value tank to tank specified by + // int value + uint32_t cross_feed; // false = off, true = on // Brake controls - int num_wheels; // number of valid wheels - double brake[FG_MAX_WHEELS]; // 0 ... 1 + double brake_left; + double brake_right; + double copilot_brake_left; + double copilot_brake_right; + double brake_parking; // Landing Gear - bool gear_handle; // true=gear handle down; false= gear handle up + uint32_t gear_handle; // true=gear handle down; false= gear handle up // Switches - bool master_bat; - bool master_alt; - bool master_avionics; - - // Other values of use to a remote FDM + uint32_t master_avionics; + + // nav and Comm + double comm_1; + double comm_2; + double nav_1; + double nav_2; + + // wind and turbulance + double wind_speed_kt; + double wind_dir_deg; + double turbulence_norm; + + // temp and pressure + double temp_c; + double press_inhg; + + // other information about environment double hground; // ground elevation (meters) - double magvar; // local magnetic variation in degrees. - int speedup; // integer speedup multiplier + double magvar; // local magnetic variation in degs. + + // hazards + uint32_t icing; // icing status could me much + // more complex but I'm + // starting simple here. + + // simulation control + uint32_t speedup; // integer speedup multiplier + uint32_t freeze; // 0=normal + // 0x01=master + // 0x02=position + // 0x04=fuel + + // --- New since FlightGear 0.9.10 (FG_NET_CTRLS_VERSION = 27) + + // --- Add new variables just before this line. + + uint32_t reserved[RESERVED_SPACE]; // 100 bytes reserved for future use. };