1 // Implementation of FGATC - ATC subsystem base class.
3 // Written by David Luff, started February 2002.
5 // Copyright (C) 2002 David C Luff - david.luff@nottingham.ac.uk
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.
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.
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.
30 #include <simgear/sound/soundmgr_openal.hxx>
31 #include <simgear/structure/exception.hxx>
33 #include <Main/globals.hxx>
34 #include <Main/fg_props.hxx>
45 runResponseCounter(false),
46 _runReleaseCounter(false),
50 // Transmission timing stuff
51 pending_transmission(""),
61 smgr = (SGSoundMgr *)globals->get_subsystem("soundmgr");
62 _sgr = smgr->find("atc", true);
68 // Derived classes wishing to use the response counter should
69 // call this from their own Update(...).
70 void FGATC::Update(double dt) {
71 if(runResponseCounter) {
72 //cout << responseCounter << '\t' << responseTime << '\n';
73 if(responseCounter >= responseTime) {
74 runResponseCounter = false;
76 //cout << "RESPOND\n";
78 responseCounter += dt;
82 if(_runReleaseCounter) {
83 if(_releaseCounter >= _releaseTime) {
85 _runReleaseCounter = false;
87 _releaseCounter += dt;
91 // Transmission stuff cribbed from AIPlane.cxx
94 //cout << "TUNED STATION FREQ CLEAR\n";
98 _transmitting = false;
100 if(_timeout > 0.0) { // allows count down to be avoided by initially setting it to zero
102 if(_timeout <= 0.0) {
105 // timed out - don't render.
113 _max_count = 5.0; // FIXME - hardwired length of message - need to calculate it!
115 //cout << "Transmission = " << pending_transmission << '\n';
117 //Render(pending_transmission, ident, false);
118 Render(pending_transmission);
120 // Run the callback regardless of whether on same freq as user or not.
121 //cout << "_callback_code = " << _callback_code << '\n';
123 ProcessCallback(_callback_code);
126 _transmitting = true;
127 } else if(_transmitting) {
128 if(_counter >= _max_count) {
129 //NoRender(plane.callsign); commented out since at the moment NoRender is designed just to stop repeating messages,
130 // and this will be primarily used on single messages.
131 _transmitting = false;
132 //if(tuned_station) tuned_station->NotifyTransmissionFinished(plane.callsign);
133 // TODO - need to let the plane the transmission is aimed at that it's finished.
134 // However, for now we'll just release the frequency since if we don't it all goes pear-shaped
135 _releaseCounter = 0.0;
137 _runReleaseCounter = true;
143 void FGATC::ReceiveUserCallback(int code) {
144 SG_LOG(SG_ATC, SG_WARN, "WARNING - whichever ATC class was intended to receive callback code " << code << " didn't get it!!!");
147 void FGATC::SetResponseReqd(const string& rid) {
150 respond = false; // TODO - this ignores the fact that more than one plane could call this before response
151 // Shouldn't happen with AI only, but user could confuse things??
153 runResponseCounter = true;
154 responseCounter = 0.0;
155 responseTime = 1.8; // TODO - randomize this slightly.
158 void FGATC::NotifyTransmissionFinished(const string& rid) {
159 //cout << "Transmission finished, callsign = " << rid << '\n';
163 runResponseCounter = true;
164 responseCounter = 0.0;
165 responseTime = 1.2; // TODO - randomize this slightly, and allow it to be dependent on the transmission and how busy the ATC is.
166 respond = false; // TODO - this ignores the fact that more than one plane could call this before response
167 // Shouldn't happen with AI only, but user could confuse things??
173 void FGATC::Transmit(int callback_code) {
174 SG_LOG(SG_ATC, SG_INFO, "Transmit called by " << ident << " " << _type << ", msg = " << pending_transmission);
176 _callback_code = callback_code;
180 void FGATC::ConditionalTransmit(double timeout, int callback_code) {
181 SG_LOG(SG_ATC, SG_INFO, "Timed transmit called by " << ident << " " << _type << ", msg = " << pending_transmission);
183 _callback_code = callback_code;
187 void FGATC::ImmediateTransmit(int callback_code) {
188 SG_LOG(SG_ATC, SG_INFO, "Immediate transmit called by " << ident << " " << _type << ", msg = " << pending_transmission);
190 //Render(pending_transmission, ident, false);
191 Render(pending_transmission);
192 // At the moment Render doesn't work except for ATIS
195 ProcessCallback(callback_code);
199 // Derived classes should override this.
200 void FGATC::ProcessCallback(int code) {
203 void FGATC::AddPlane(const string& pid) {
206 int FGATC::RemovePlane() {
210 void FGATC::SetData(ATCData* d) {
220 // Render a transmission
221 // Outputs the transmission either on screen or as audio depending on user preference
222 // The refname is a string to identify this sample to the sound manager
223 // The repeating flag indicates whether the message should be repeated continuously or played once.
224 void FGATC::Render(string& msg, const float volume,
225 const string& refname, const bool repeating) {
227 fgSetString("/sim/messages/atis", msg.c_str());
229 fgSetString("/sim/messages/atc", msg.c_str());
231 #ifdef ENABLE_AUDIO_SUPPORT
232 _voice = (_voiceOK && fgGetBool("/sim/sound/voice"));
234 string buf = _vPtr->WriteMessage((char*)msg.c_str(), _voice);
235 if(_voice && (volume > 0.05)) {
238 // >>> Beware: must pass a (new) object to the (add) method,
239 // >>> because the (remove) method is going to do a (delete)
240 // >>> whether that's what you want or not.
241 std::auto_ptr<unsigned char> ptr( (unsigned char*)buf.c_str() );
242 SGSoundSample *simple =
243 new SGSoundSample(ptr, buf.length(), 8000);
244 // TODO - at the moment the volume can't be changed
245 // after the transmission has started.
246 simple->set_volume(volume);
247 _sgr->add(simple, refname);
248 _sgr->play(refname, repeating);
249 } catch ( sg_io_exception &e ) {
250 SG_LOG(SG_GENERAL, SG_ALERT, e.getFormattedMessage());
254 #endif // ENABLE_AUDIO_SUPPORT
256 // first rip the underscores and the pause hints out of the string - these are for the convienience of the voice parser
257 for(unsigned int i = 0; i < msg.length(); ++i) {
258 if((msg.substr(i,1) == "_") || (msg.substr(i,1) == "/")) {
267 // Cease rendering a transmission.
268 void FGATC::NoRender(const string& refname) {
271 #ifdef ENABLE_AUDIO_SUPPORT
273 _sgr->remove(refname);
280 // Generate the text of a message from its parameters and the current context.
281 string FGATC::GenText(const string& m, int c) {
285 ostream& operator << (ostream& os, atc_type atc) {
287 case(AWOS): return(os << "AWOS");
288 case(ATIS): return(os << "ATIS");
289 case(GROUND): return(os << "GROUND");
290 case(TOWER): return(os << "TOWER");
291 case(APPROACH): return(os << "APPROACH");
292 case(DEPARTURE): return(os << "DEPARTURE");
293 case(ENROUTE): return(os << "ENROUTE");
294 case(INVALID): return(os << "INVALID");
296 return(os << "ERROR - Unknown switch in atc_type operator << ");
299 std::istream& operator >> ( std::istream& fin, ATCData& a )
322 return fin >> skipeol;
324 SG_LOG(SG_GENERAL, SG_ALERT, "Warning - unknown type \'" << tp << "\' found whilst reading ATC frequency data!\n");
326 return fin >> skipeol;
329 double lat, lon, elev;
331 fin >> lat >> lon >> elev >> f >> a.range >> a.ident;
332 a.geod = SGGeod::fromDegM(lon, lat, elev);
335 if(ch != '"') a.name += ch;
338 fin.unsetf(std::ios::skipws);
340 if((ch == '"') || (ch == 0x0A)) {
342 } // we shouldn't need the 0x0A but it makes a nice safely in case someone leaves off the "
345 fin.setf(std::ios::skipws);
346 //cout << "Comm name = " << a.name << '\n';
348 a.freq = (int)(f*100.0 + 0.5);
350 // cout << a.ident << endl;
352 // generate cartesian coordinates
353 a.cart = SGVec3d::fromGeod(a.geod);
354 return fin >> skipeol;