X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=src%2FNetwork%2Fnet_ctrls.hxx;h=30eaf01c236ccba9544e05bf84653f74de0f7e09;hb=ff408dc540b0944061b0b88bdad93b5de17dbab9;hp=f110c356c9ba12f9f1b1fcb021ac2ca58f661ad1;hpb=6d0456df08db5cf247b8fb5b62831aaa16147aa8;p=flightgear.git diff --git a/src/Network/net_ctrls.hxx b/src/Network/net_ctrls.hxx index f110c356c..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 + +// 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. -#ifndef __cplusplus -# error This library requires C++ -#endif +// !!! 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. + */ -const int FG_NET_CTRLS_VERSION = 15; +#define RESERVED_SPACE 25 +const uint32_t FG_NET_CTRLS_VERSION = 27; // Define a structure containing the control parameters @@ -39,72 +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 + double spoilers; + double speedbrake; // Aero control faults - bool flaps_power; // true = power available + 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 - bool engine_ok[FG_MAX_ENGINES]; - bool mag_left_ok[FG_MAX_ENGINES]; - bool mag_right_ok[FG_MAX_ENGINES]; - bool spark_plugs_ok[FG_MAX_ENGINES]; // false = fouled plugs - int oil_press_status[FG_MAX_ENGINES]; // 0 = normal, 1 = low, 2 = full fail - bool fuel_pump_ok[FG_MAX_ENGINES]; + 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; + 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 degs. + // hazards + uint32_t icing; // icing status could me much + // more complex but I'm + // starting simple here. + // simulation control - int speedup; // integer speedup multiplier - int freeze; // 0=normal + 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. };