source: src/mlx/fsuipc.py@ 316:522039ad9f41

Last change on this file since 316:522039ad9f41 was 315:baa139ef7784, checked in by István Váradi <ivaradi@…>, 12 years ago

The in-flight stage messages can be controlled separately

File size: 74.2 KB
Line 
1
2import fs
3import const
4import util
5import acft
6
7import threading
8import os
9import time
10import calendar
11import sys
12import codecs
13
14if os.name == "nt" and "FORCE_PYUIPC_SIM" not in os.environ:
15 import pyuipc
16else:
17 import pyuipc_sim as pyuipc
18
19#------------------------------------------------------------------------------
20
21## @package mlx.fsuipc
22#
23# The module towards FSUIPC.
24#
25# This module implements the simulator interface to FSUIPC.
26#
27# The \ref Handler class is thread handling the FSUIPC requests. It can be
28# given read, periodic read and write, requests, that are executed
29# asynchronously, and a callback function is called with the result. This class
30# is used internally within the module.
31#
32# The \ref Simulator class is the actual interface to the flight simulator, and
33# an instance of it is returned by \ref mlx.fs.createSimulator. This object can
34# be used to connect to the simulator and disconnect from it, to query various
35# data and to start and stop the monitoring of the data.
36#
37# \ref AircraftModel is the base class of the aircraft models. A "model" is a
38# particular implementation of an aircraft, such as the PMDG Boeing 737NG in
39# Flight Simulator 2004. Since each type and each model has its peculiarities
40# (e.g. the different engine and fuel tank configurations), each aircraft type
41# has a generic model, that should work for most of the time. However, certain
42# models may implement various controls, gauges, etc. differently, and such
43# peculiarites can be handled in a specific subclass of \ref
44# AircraftModel. These subclasses should be registered as special ones, and if
45# the simulator detects that the aircraft's model became known or has changed,
46# it will check these special models before resorting to the generic ones.
47#
48# The models are responsible also for querying certain parameters, such as the
49# fuel tank configuration. While ideally it should be specific to a type only,
50# it is possible that the model contains different tanks, in which case some
51# tricks may be needed. See the \ref DC3Model "DC-3 (Li-2)" aircraft as an
52# example.
53
54#------------------------------------------------------------------------------
55
56## The mapping of tank types to FSUIPC offsets
57_tank2offset = { const.FUELTANK_CENTRE : 0x0b74,
58 const.FUELTANK_LEFT : 0x0b7c,
59 const.FUELTANK_RIGHT : 0x0b94,
60 const.FUELTANK_LEFT_AUX : 0x0b84,
61 const.FUELTANK_RIGHT_AUX : 0x0b9c,
62 const.FUELTANK_LEFT_TIP : 0x0b8c,
63 const.FUELTANK_RIGHT_TIP : 0x0ba4,
64 const.FUELTANK_EXTERNAL1 : 0x1254,
65 const.FUELTANK_EXTERNAL2 : 0x125c,
66 const.FUELTANK_CENTRE2 : 0x1244 }
67
68#------------------------------------------------------------------------------
69
70class Handler(threading.Thread):
71 """The thread to handle the FSUIPC requests."""
72 @staticmethod
73 def fsuipc2VS(data):
74 """Convert the given vertical speed data read from FSUIPC into feet/min."""
75 return data*60.0/const.FEETTOMETRES/256.0
76
77 @staticmethod
78 def fsuipc2radioAltitude(data):
79 """Convert the given radio altitude data read from FSUIPC into feet."""
80 return data/const.FEETTOMETRES/65536.0
81
82 @staticmethod
83 def fsuipc2Degrees(data):
84 """Convert the given data into degrees."""
85 return data * 360.0 / 65536.0 / 65536.0
86
87 @staticmethod
88 def fsuipc2PositiveDegrees(data):
89 """Convert the given data into positive degrees."""
90 degrees = Handler.fsuipc2Degrees(data)
91 if degrees<0.0: degrees += 360.0
92 return degrees
93
94 @staticmethod
95 def fsuipc2IAS(data):
96 """Convert the given data into indicated airspeed."""
97 return data / 128.0
98
99 @staticmethod
100 def _callSafe(fun):
101 """Call the given function and swallow any exceptions."""
102 try:
103 return fun()
104 except Exception, e:
105 print >> sys.stderr, str(e)
106 return None
107
108 # The number of times a read is attempted
109 NUM_READATTEMPTS = 3
110
111 # The number of connection attempts
112 NUM_CONNECTATTEMPTS = 3
113
114 # The interval between successive connect attempts
115 CONNECT_INTERVAL = 0.25
116
117 @staticmethod
118 def _performRead(data, callback, extra, validator):
119 """Perform a read request.
120
121 If there is a validator, that will be called with the return values,
122 and if the values are wrong, the request is retried at most a certain
123 number of times.
124
125 Return True if the request has succeeded, False if validation has
126 failed during all attempts. An exception may also be thrown if there is
127 some lower-level communication problem."""
128 attemptsLeft = Handler.NUM_READATTEMPTS
129 while attemptsLeft>0:
130 values = pyuipc.read(data)
131 if validator is None or \
132 Handler._callSafe(lambda: validator(values, extra)):
133 Handler._callSafe(lambda: callback(values, extra))
134 return True
135 else:
136 attemptsLeft -= 1
137 return False
138
139 class Request(object):
140 """A simple, one-shot request."""
141 def __init__(self, forWrite, data, callback, extra, validator = None):
142 """Construct the request."""
143 self._forWrite = forWrite
144 self._data = data
145 self._callback = callback
146 self._extra = extra
147 self._validator = validator
148
149 def process(self, time):
150 """Process the request.
151
152 Return True if the request has succeeded, False if data validation
153 has failed for a reading request. An exception may also be thrown
154 if there is some lower-level communication problem."""
155 if self._forWrite:
156 pyuipc.write(self._data)
157 Handler._callSafe(lambda: self._callback(True, self._extra))
158 return True
159 else:
160 return Handler._performRead(self._data, self._callback,
161 self._extra, self._validator)
162
163 def fail(self):
164 """Handle the failure of this request."""
165 if self._forWrite:
166 Handler._callSafe(lambda: self._callback(False, self._extra))
167 else:
168 Handler._callSafe(lambda: self._callback(None, self._extra))
169
170 class PeriodicRequest(object):
171 """A periodic request."""
172 def __init__(self, id, period, data, callback, extra, validator):
173 """Construct the periodic request."""
174 self._id = id
175 self._period = period
176 self._nextFire = time.time()
177 self._data = data
178 self._preparedData = None
179 self._callback = callback
180 self._extra = extra
181 self._validator = validator
182
183 @property
184 def id(self):
185 """Get the ID of this periodic request."""
186 return self._id
187
188 @property
189 def nextFire(self):
190 """Get the next firing time."""
191 return self._nextFire
192
193 def process(self, time):
194 """Check if this request should be executed, and if so, do so.
195
196 time is the time at which the request is being executed. If this
197 function is called too early, nothing is done, and True is
198 returned.
199
200 Return True if the request has succeeded, False if data validation
201 has failed. An exception may also be thrown if there is some
202 lower-level communication problem."""
203 if time<self._nextFire:
204 return True
205
206 if self._preparedData is None:
207 self._preparedData = pyuipc.prepare_data(self._data)
208 self._data = None
209
210 isOK = Handler._performRead(self._preparedData, self._callback,
211 self._extra, self._validator)
212
213 if isOK:
214 while self._nextFire <= time:
215 self._nextFire += self._period
216
217 return isOK
218
219 def fail(self):
220 """Handle the failure of this request."""
221 pass
222
223 def __cmp__(self, other):
224 """Compare two periodic requests. They are ordered by their next
225 firing times."""
226 return cmp(self._nextFire, other._nextFire)
227
228 def __init__(self, connectionListener,
229 connectAttempts = -1, connectInterval = 0.2):
230 """Construct the handler with the given connection listener."""
231 threading.Thread.__init__(self)
232
233 self._connectionListener = connectionListener
234 self._connectAttempts = connectAttempts
235 self._connectInterval = connectInterval
236
237 self._requestCondition = threading.Condition()
238 self._connectionRequested = False
239 self._connected = False
240
241 self._requests = []
242 self._nextPeriodicID = 1
243 self._periodicRequests = []
244
245 self.daemon = True
246
247 def requestRead(self, data, callback, extra = None, validator = None):
248 """Request the reading of some data.
249
250 data is a list of tuples of the following items:
251 - the offset of the data as an integer
252 - the type letter of the data as a string
253
254 callback is a function that receives two pieces of data:
255 - the values retrieved or None on error
256 - the extra parameter
257
258 It will be called in the handler's thread!
259 """
260 with self._requestCondition:
261 self._requests.append(Handler.Request(False, data, callback, extra,
262 validator))
263 self._requestCondition.notify()
264
265 def requestWrite(self, data, callback, extra = None):
266 """Request the writing of some data.
267
268 data is a list of tuples of the following items:
269 - the offset of the data as an integer
270 - the type letter of the data as a string
271 - the data to write
272
273 callback is a function that receives two pieces of data:
274 - a boolean indicating if writing was successful
275 - the extra data
276 It will be called in the handler's thread!
277 """
278 with self._requestCondition:
279 request = Handler.Request(True, data, callback, extra)
280 #print "fsuipc.Handler.requestWrite", request
281 self._requests.append(request)
282 self._requestCondition.notify()
283
284 @staticmethod
285 def _readWriteCallback(data, extra):
286 """Callback for the read() and write() calls below."""
287 extra.append(data)
288 with extra[0] as condition:
289 condition.notify()
290
291 def requestPeriodicRead(self, period, data, callback, extra = None,
292 validator = None):
293 """Request a periodic read of data.
294
295 period is a floating point number with the period in seconds.
296
297 This function returns an identifier which can be used to cancel the
298 request."""
299 with self._requestCondition:
300 id = self._nextPeriodicID
301 self._nextPeriodicID += 1
302 request = Handler.PeriodicRequest(id, period, data, callback,
303 extra, validator)
304 self._periodicRequests.append(request)
305 self._requestCondition.notify()
306 return id
307
308 def clearPeriodic(self, id):
309 """Clear the periodic request with the given ID."""
310 with self._requestCondition:
311 for i in range(0, len(self._periodicRequests)):
312 if self._periodicRequests[i].id==id:
313 del self._periodicRequests[i]
314 return True
315 return False
316
317 def connect(self):
318 """Initiate the connection to the flight simulator."""
319 with self._requestCondition:
320 if not self._connectionRequested:
321 self._connectionRequested = True
322 self._requestCondition.notify()
323
324 def disconnect(self):
325 """Disconnect from the flight simulator."""
326 with self._requestCondition:
327 self._requests = []
328 if self._connectionRequested:
329 self._connectionRequested = False
330 self._requestCondition.notify()
331
332 def clearRequests(self):
333 """Clear the outstanding one-shot requests."""
334 with self._requestCondition:
335 self._requests = []
336
337 def run(self):
338 """Perform the operation of the thread."""
339 while True:
340 self._waitConnectionRequest()
341
342 if self._connect()>0:
343 self._handleConnection()
344
345 self._disconnect()
346
347 def _waitConnectionRequest(self):
348 """Wait for a connection request to arrive."""
349 with self._requestCondition:
350 while not self._connectionRequested:
351 self._requestCondition.wait()
352
353 def _connect(self, autoReconnection = False, attempts = 0):
354 """Try to connect to the flight simulator via FSUIPC
355
356 Returns True if the connection has been established, False if it was
357 not due to no longer requested.
358 """
359 while self._connectionRequested:
360 if attempts>=self.NUM_CONNECTATTEMPTS:
361 self._connectionRequested = False
362 if autoReconnection:
363 Handler._callSafe(lambda:
364 self._connectionListener.disconnected())
365 else:
366 Handler._callSafe(lambda:
367 self._connectionListener.connectionFailed())
368 return 0
369
370 try:
371 attempts += 1
372 pyuipc.open(pyuipc.SIM_ANY)
373 description = "(FSUIPC version: 0x%04x, library version: 0x%04x, FS version: %d)" % \
374 (pyuipc.fsuipc_version, pyuipc.lib_version,
375 pyuipc.fs_version)
376 if not autoReconnection:
377 fsType = const.SIM_MSFSX \
378 if pyuipc.fs_version == pyuipc.SIM_FSX \
379 else const.SIM_MSFS9
380
381 Handler._callSafe(lambda:
382 self._connectionListener.connected(fsType,
383 description))
384 self._connected = True
385 return attempts
386 except Exception, e:
387 print "fsuipc.Handler._connect: connection failed: " + str(e) + \
388 " (attempts: %d)" % (attempts,)
389 if attempts<self.NUM_CONNECTATTEMPTS:
390 time.sleep(self.CONNECT_INTERVAL)
391
392 def _handleConnection(self):
393 """Handle a living connection."""
394 with self._requestCondition:
395 while self._connectionRequested:
396 self._processRequests()
397 self._waitRequest()
398
399 def _waitRequest(self):
400 """Wait for the time of the next request.
401
402 Returns also, if the connection is no longer requested.
403
404 Should be called with the request condition lock held."""
405 while self._connectionRequested:
406 timeout = None
407 if self._periodicRequests:
408 self._periodicRequests.sort()
409 timeout = self._periodicRequests[0].nextFire - time.time()
410
411 if self._requests or \
412 (timeout is not None and timeout <= 0.0):
413 return
414
415 self._requestCondition.wait(timeout)
416
417 def _disconnect(self):
418 """Disconnect from the flight simulator."""
419 print "fsuipc.Handler._disconnect"
420 if self._connected:
421 pyuipc.close()
422 self._connected = False
423
424 def _processRequest(self, request, time, attempts):
425 """Process the given request.
426
427 If an exception occurs or invalid data is read too many times, we try
428 to reconnect.
429
430 This function returns only if the request has succeeded, or if a
431 connection is no longer requested.
432
433 This function is called with the request lock held, but is relased
434 whole processing the request and reconnecting."""
435 self._requestCondition.release()
436
437 #print "fsuipc.Handler._processRequest", request
438
439 needReconnect = False
440 try:
441 try:
442 if not request.process(time):
443 print "fsuipc.Handler._processRequest: FSUIPC returned invalid data too many times, reconnecting"
444 needReconnect = True
445 except Exception as e:
446 print "fsuipc.Handler._processRequest: FSUIPC connection failed (" + \
447 str(e) + "), reconnecting (attempts=%d)." % (attempts,)
448 needReconnect = True
449
450 if needReconnect:
451 with self._requestCondition:
452 self._requests.insert(0, request)
453 self._disconnect()
454 return self._connect(autoReconnection = True, attempts = attempts)
455 else:
456 return 0
457 finally:
458 self._requestCondition.acquire()
459
460 def _processRequests(self):
461 """Process any pending requests.
462
463 Will be called with the request lock held."""
464 attempts = 0
465 while self._connectionRequested and self._periodicRequests:
466 self._periodicRequests.sort()
467 request = self._periodicRequests[0]
468
469 t = time.time()
470
471 if request.nextFire>t:
472 break
473
474 attempts = self._processRequest(request, t, attempts)
475
476 while self._connectionRequested and self._requests:
477 request = self._requests[0]
478 del self._requests[0]
479
480 attempts = self._processRequest(request, None, attempts)
481
482 return self._connectionRequested
483
484#------------------------------------------------------------------------------
485
486class Simulator(object):
487 """The simulator class representing the interface to the flight simulator
488 via FSUIPC."""
489 # The basic data that should be queried all the time once we are connected
490 timeData = [ (0x0240, "H"), # Year
491 (0x023e, "H"), # Number of day in year
492 (0x023b, "b"), # UTC hour
493 (0x023c, "b"), # UTC minute
494 (0x023a, "b") ] # seconds
495
496 normalData = timeData + \
497 [ (0x3d00, -256), # The name of the current aircraft
498 (0x3c00, -256), # The path of the current AIR file
499 (0x1274, "h") ] # Text display mode
500
501 flareData1 = [ (0x023a, "b"), # Seconds of time
502 (0x31e4, "d"), # Radio altitude
503 (0x02c8, "d") ] # Vertical speed
504
505 flareStartData = [ (0x0e90, "H"), # Ambient wind speed
506 (0x0e92, "H"), # Ambient wind direction
507 (0x0e8a, "H") ] # Visibility
508
509 flareData2 = [ (0x023a, "b"), # Seconds of time
510 (0x0366, "H"), # On the ground
511 (0x02c8, "d"), # Vertical speed
512 (0x030c, "d"), # Touch-down rate
513 (0x02bc, "d"), # IAS
514 (0x0578, "d"), # Pitch
515 (0x057c, "d"), # Bank
516 (0x0580, "d") ] # Heading
517
518 TIME_SYNC_INTERVAL = 3.0
519
520 @staticmethod
521 def _getTimestamp(data):
522 """Convert the given data into a timestamp."""
523 timestamp = calendar.timegm(time.struct_time([data[0],
524 1, 1, 0, 0, 0, -1, 1, 0]))
525 timestamp += data[1] * 24 * 3600
526 timestamp += data[2] * 3600
527 timestamp += data[3] * 60
528 timestamp += data[4]
529
530 return timestamp
531
532 @staticmethod
533 def _appendHotkeyData(data, offset, hotkey):
534 """Append the data for the given hotkey to the given array, that is
535 intended to be passed to requestWrite call on the handler."""
536 data.append((offset + 0, "b", ord(hotkey.key)))
537
538 modifiers = 0
539 if hotkey.ctrl: modifiers |= 0x02
540 if hotkey.shift: modifiers |= 0x01
541 data.append((offset + 1, "b", modifiers))
542
543 data.append((offset + 2, "b", 0))
544
545 data.append((offset + 3, "b", 0))
546
547 def __init__(self, connectionListener, connectAttempts = -1,
548 connectInterval = 0.2):
549 """Construct the simulator.
550
551 The aircraft object passed must provide the following members:
552 - type: one of the AIRCRAFT_XXX constants from const.py
553 - modelChanged(aircraftName, modelName): called when the model handling
554 the aircraft has changed.
555 - handleState(aircraftState): handle the given state.
556 - flareStarted(windSpeed, windDirection, visibility, flareStart,
557 flareStartFS): called when the flare has
558 started. windSpeed is in knots, windDirection is in degrees and
559 visibility is in metres. flareStart and flareStartFS are two time
560 values expressed in seconds that can be used to calculate the flare
561 time.
562 - flareFinished(flareEnd, flareEndFS, tdRate, tdRateCalculatedByFS,
563 ias, pitch, bank, heading): called when the flare has
564 finished, i.e. the aircraft is on the ground. flareEnd and flareEndFS
565 are the two time values corresponding to the touchdown time. tdRate is
566 the touch-down rate, tdRateCalculatedBySim indicates if the data comes
567 from the simulator or was calculated by the adapter. The other data
568 are self-explanatory and expressed in their 'natural' units."""
569 self._fsType = None
570 self._aircraft = None
571
572 self._handler = Handler(self,
573 connectAttempts = connectAttempts,
574 connectInterval = connectInterval)
575 self._connectionListener = connectionListener
576 self._handler.start()
577
578 self._scroll = False
579
580 self._syncTime = False
581 self._nextSyncTime = -1
582
583 self._normalRequestID = None
584
585 self._monitoringRequested = False
586 self._monitoring = False
587
588 self._aircraftName = None
589 self._aircraftModel = None
590
591 self._flareRequestID = None
592 self._flareRates = []
593 self._flareStart = None
594 self._flareStartFS = None
595
596 self._hotkeyLock = threading.Lock()
597 self._hotkeys = None
598 self._hotkeySetID = 0
599 self._hotkeySetGeneration = 0
600 self._hotkeyOffets = None
601 self._hotkeyRequestID = None
602 self._hotkeyCallback = None
603
604 self._latin1decoder = codecs.getdecoder("iso-8859-1")
605 self._fuelCallback = None
606
607 def connect(self, aircraft):
608 """Initiate a connection to the simulator."""
609 self._aircraft = aircraft
610 self._aircraftName = None
611 self._aircraftModel = None
612 self._handler.connect()
613 if self._normalRequestID is None:
614 self._nextSyncTime = -1
615 self._startDefaultNormal()
616
617 def reconnect(self):
618 """Initiate a reconnection to the simulator.
619
620 It does not reset already set up data, just calls connect() on the
621 handler."""
622 self._handler.connect()
623
624 def requestZFW(self, callback):
625 """Send a request for the ZFW."""
626 self._handler.requestRead([(0x3bfc, "d")], self._handleZFW, extra = callback)
627
628 def requestWeights(self, callback):
629 """Request the following weights: DOW, ZFW, payload.
630
631 These values will be passed to the callback function in this order, as
632 separate arguments."""
633 self._handler.requestRead([(0x13fc, "d")], self._handlePayloadCount,
634 extra = callback)
635
636 def requestTime(self, callback):
637 """Request the time from the simulator."""
638 self._handler.requestRead(Simulator.timeData, self._handleTime,
639 extra = callback)
640
641 def startMonitoring(self):
642 """Start the periodic monitoring of the aircraft and pass the resulting
643 state to the aircraft object periodically."""
644 assert not self._monitoringRequested
645 self._monitoringRequested = True
646
647 def stopMonitoring(self):
648 """Stop the periodic monitoring of the aircraft."""
649 assert self._monitoringRequested
650 self._monitoringRequested = False
651
652 def startFlare(self):
653 """Start monitoring the flare time.
654
655 At present it is assumed to be called from the FSUIPC thread, hence no
656 protection."""
657 #self._aircraft.logger.debug("startFlare")
658 if self._flareRequestID is None:
659 self._flareRates = []
660 self._flareRequestID = self._handler.requestPeriodicRead(0.1,
661 Simulator.flareData1,
662 self._handleFlare1)
663
664 def cancelFlare(self):
665 """Cancel monitoring the flare time.
666
667 At present it is assumed to be called from the FSUIPC thread, hence no
668 protection."""
669 if self._flareRequestID is not None:
670 self._handler.clearPeriodic(self._flareRequestID)
671 self._flareRequestID = None
672
673 def sendMessage(self, message, duration = 3,
674 _disconnect = False):
675 """Send a message to the pilot via the simulator.
676
677 duration is the number of seconds to keep the message displayed."""
678
679 print "fsuipc.Simulator.sendMessage:", message
680
681 if self._scroll:
682 if duration==0: duration = -1
683 elif duration == 1: duration = -2
684 else: duration = -duration
685
686 data = [(0x3380, -1 - len(message), message),
687 (0x32fa, 'h', duration)]
688
689 #if _disconnect:
690 # print "fsuipc.Simulator.sendMessage(disconnect)", message
691
692 self._handler.requestWrite(data, self._handleMessageSent,
693 extra = _disconnect)
694
695 def getFuel(self, callback):
696 """Get the fuel information for the current model.
697
698 The callback will be called with a list of triplets with the following
699 items:
700 - the fuel tank identifier
701 - the current weight of the fuel in the tank (in kgs)
702 - the current total capacity of the tank (in kgs)."""
703 if self._aircraftModel is None:
704 self._fuelCallback = callback
705 else:
706 self._aircraftModel.getFuel(self._handler, callback)
707
708 def setFuelLevel(self, levels):
709 """Set the fuel level to the given ones.
710
711 levels is an array of two-tuples, where each tuple consists of the
712 following:
713 - the const.FUELTANK_XXX constant denoting the tank that must be set,
714 - the requested level of the fuel as a floating-point value between 0.0
715 and 1.0."""
716 if self._aircraftModel is not None:
717 self._aircraftModel.setFuelLevel(self._handler, levels)
718
719 def enableTimeSync(self):
720 """Enable the time synchronization."""
721 self._nextSyncTime = -1
722 self._syncTime = True
723
724 def disableTimeSync(self):
725 """Enable the time synchronization."""
726 self._syncTime = False
727 self._nextSyncTime = -1
728
729 def listenHotkeys(self, hotkeys, callback):
730 """Start listening to the given hotkeys.
731
732 callback is function expecting two arguments:
733 - the ID of the hotkey set as returned by this function,
734 - the list of the indexes of the hotkeys that were pressed."""
735 with self._hotkeyLock:
736 assert self._hotkeys is None
737
738 self._hotkeys = hotkeys
739 self._hotkeySetID += 1
740 self._hotkeySetGeneration = 0
741 self._hotkeyCallback = callback
742
743 self._handler.requestRead([(0x320c, "u")],
744 self._handleNumHotkeys,
745 (self._hotkeySetID,
746 self._hotkeySetGeneration))
747
748 return self._hotkeySetID
749
750 def clearHotkeys(self):
751 """Clear the current hotkey set.
752
753 Note that it is possible, that the callback function set either
754 previously or after calling this function by listenHotkeys() will be
755 called with data from the previous hotkey set.
756
757 Therefore it is recommended to store the hotkey set ID somewhere and
758 check that in the callback function. Right before calling
759 clearHotkeys(), this stored ID should be cleared so that the check
760 fails for sure."""
761 with self._hotkeyLock:
762 if self._hotkeys is not None:
763 self._hotkeys = None
764 self._hotkeySetID += 1
765 self._hotkeyCallback = None
766 self._clearHotkeyRequest()
767
768 def disconnect(self, closingMessage = None, duration = 3):
769 """Disconnect from the simulator."""
770 assert not self._monitoringRequested
771
772 print "fsuipc.Simulator.disconnect", closingMessage, duration
773
774 self._stopNormal()
775 self.clearHotkeys()
776 if closingMessage is None:
777 self._handler.disconnect()
778 else:
779 self.sendMessage(closingMessage, duration = duration,
780 _disconnect = True)
781
782 def connected(self, fsType, descriptor):
783 """Called when a connection has been established to the flight
784 simulator of the given type."""
785 self._fsType = fsType
786 with self._hotkeyLock:
787 if self._hotkeys is not None:
788 self._hotkeySetGeneration += 1
789
790 self._handler.requestRead([(0x320c, "u")],
791 self._handleNumHotkeys,
792 (self._hotkeySetID,
793 self._hotkeySetGeneration))
794 self._connectionListener.connected(fsType, descriptor)
795
796 def connectionFailed(self):
797 """Called when the connection could not be established."""
798 with self._hotkeyLock:
799 self._clearHotkeyRequest()
800 self._connectionListener.connectionFailed()
801
802 def disconnected(self):
803 """Called when a connection to the flight simulator has been broken."""
804 with self._hotkeyLock:
805 self._clearHotkeyRequest()
806 self._connectionListener.disconnected()
807
808 def _startDefaultNormal(self):
809 """Start the default normal periodic request."""
810 assert self._normalRequestID is None
811 self._normalRequestID = \
812 self._handler.requestPeriodicRead(1.0,
813 Simulator.normalData,
814 self._handleNormal,
815 validator = self._validateNormal)
816
817 def _stopNormal(self):
818 """Stop the normal period request."""
819 assert self._normalRequestID is not None
820 self._handler.clearPeriodic(self._normalRequestID)
821 self._normalRequestID = None
822 self._monitoring = False
823
824 def _validateNormal(self, data, extra):
825 """Validate the normal data."""
826 return data[0]!=0 and data[1]!=0 and len(data[5])>0 and len(data[6])>0
827
828 def _handleNormal(self, data, extra):
829 """Handle the reply to the normal request.
830
831 At the beginning the result consists the data for normalData. When
832 monitoring is started, it contains the result also for the
833 aircraft-specific values.
834 """
835 timestamp = Simulator._getTimestamp(data)
836
837 createdNewModel = self._setAircraftName(timestamp, data[5], data[6])
838 if self._fuelCallback is not None:
839 self._aircraftModel.getFuel(self._handler, self._fuelCallback)
840 self._fuelCallback = None
841
842 self._scroll = data[7]!=0
843
844 if self._monitoringRequested and not self._monitoring:
845 self._stopNormal()
846 self._startMonitoring()
847 elif self._monitoring and not self._monitoringRequested:
848 self._stopNormal()
849 self._startDefaultNormal()
850 elif self._monitoring and self._aircraftModel is not None and \
851 not createdNewModel:
852 aircraftState = self._aircraftModel.getAircraftState(self._aircraft,
853 timestamp, data)
854
855 self._checkTimeSync(aircraftState)
856
857 self._aircraft.handleState(aircraftState)
858
859 def _checkTimeSync(self, aircraftState):
860 """Check if we need to synchronize the FS time."""
861 if not self._syncTime or aircraftState.paused or \
862 self._flareRequestID is not None:
863 self._nextSyncTime = -1
864 return
865
866 now = time.time()
867 seconds = time.gmtime(now).tm_sec
868
869 if seconds>30 and seconds<59:
870 if self._nextSyncTime > (now - 0.49):
871 return
872
873 self._handler.requestWrite([(0x023a, "b", int(seconds))],
874 self._handleTimeSynced)
875
876 #print "Set the seconds to ", seconds
877
878 if self._nextSyncTime<0:
879 self._nextSyncTime = now
880
881 self._nextSyncTime += Simulator.TIME_SYNC_INTERVAL
882 else:
883 self._nextSyncTime = -1
884
885 def _handleTimeSynced(self, success, extra):
886 """Callback for the time sync result."""
887 pass
888
889 def _setAircraftName(self, timestamp, name, airPath):
890 """Set the name of the aicraft and if it is different from the
891 previous, create a new model for it.
892
893 If so, also notifty the aircraft about the change.
894
895 Return if a new model was created."""
896 aircraftName = (name, airPath)
897 if aircraftName==self._aircraftName:
898 return False
899
900 print "fsuipc.Simulator: new aircraft name and air file path: %s, %s" % \
901 (name, airPath)
902
903 self._aircraftName = aircraftName
904 needNew = self._aircraftModel is None
905 needNew = needNew or\
906 not self._aircraftModel.doesHandle(self._aircraft, aircraftName)
907 if not needNew:
908 specialModel = AircraftModel.findSpecial(self._aircraft, aircraftName)
909 needNew = specialModel is not None and \
910 specialModel is not self._aircraftModel.__class__
911
912 if needNew:
913 self._setAircraftModel(AircraftModel.create(self._aircraft, aircraftName))
914
915
916 self._aircraft.modelChanged(timestamp, self._latin1decoder(name)[0],
917 self._aircraftModel.name)
918
919 return needNew
920
921 def _setAircraftModel(self, model):
922 """Set a new aircraft model.
923
924 It will be queried for the data to monitor and the monitoring request
925 will be replaced by a new one."""
926 self._aircraftModel = model
927
928 if self._monitoring:
929 self._stopNormal()
930 self._startMonitoring()
931
932 def _startMonitoring(self):
933 """Start monitoring with the current aircraft model."""
934 data = Simulator.normalData[:]
935 self._aircraftModel.addMonitoringData(data, self._fsType)
936
937 self._normalRequestID = \
938 self._handler.requestPeriodicRead(1.0, data,
939 self._handleNormal,
940 validator = self._validateNormal)
941 self._monitoring = True
942
943 def _addFlareRate(self, data):
944 """Append a flare rate to the list of last rates."""
945 if len(self._flareRates)>=3:
946 del self._flareRates[0]
947 self._flareRates.append(Handler.fsuipc2VS(data))
948
949 def _handleFlare1(self, data, normal):
950 """Handle the first stage of flare monitoring."""
951 #self._aircraft.logger.debug("handleFlare1: " + str(data))
952 if Handler.fsuipc2radioAltitude(data[1])<=50.0:
953 self._flareStart = time.time()
954 self._flareStartFS = data[0]
955 self._handler.clearPeriodic(self._flareRequestID)
956 self._flareRequestID = \
957 self._handler.requestPeriodicRead(0.1,
958 Simulator.flareData2,
959 self._handleFlare2)
960 self._handler.requestRead(Simulator.flareStartData,
961 self._handleFlareStart)
962
963 self._addFlareRate(data[2])
964
965 def _handleFlareStart(self, data, extra):
966 """Handle the data need to notify the aircraft about the starting of
967 the flare."""
968 #self._aircraft.logger.debug("handleFlareStart: " + str(data))
969 if data is not None:
970 windDirection = data[1]*360.0/65536.0
971 if windDirection<0.0: windDirection += 360.0
972 self._aircraft.flareStarted(data[0], windDirection,
973 data[2]*1609.344/100.0,
974 self._flareStart, self._flareStartFS)
975
976 def _handleFlare2(self, data, normal):
977 """Handle the first stage of flare monitoring."""
978 #self._aircraft.logger.debug("handleFlare2: " + str(data))
979 if data[1]!=0:
980 flareEnd = time.time()
981 self._handler.clearPeriodic(self._flareRequestID)
982 self._flareRequestID = None
983
984 flareEndFS = data[0]
985 if flareEndFS<self._flareStartFS:
986 flareEndFS += 60
987
988 tdRate = Handler.fsuipc2VS(data[3])
989 tdRateCalculatedByFS = True
990 if tdRate==0 or tdRate>1000.0 or tdRate<-1000.0:
991 tdRate = min(self._flareRates)
992 tdRateCalculatedByFS = False
993
994 self._aircraft.flareFinished(flareEnd, flareEndFS,
995 tdRate, tdRateCalculatedByFS,
996 Handler.fsuipc2IAS(data[4]),
997 Handler.fsuipc2Degrees(data[5]),
998 Handler.fsuipc2Degrees(data[6]),
999 Handler.fsuipc2PositiveDegrees(data[7]))
1000 else:
1001 self._addFlareRate(data[2])
1002
1003 def _handleZFW(self, data, callback):
1004 """Callback for a ZFW retrieval request."""
1005 zfw = data[0] * const.LBSTOKG / 256.0
1006 callback(zfw)
1007
1008 def _handleTime(self, data, callback):
1009 """Callback for a time retrieval request."""
1010 callback(Simulator._getTimestamp(data))
1011
1012 def _handlePayloadCount(self, data, callback):
1013 """Callback for the payload count retrieval request."""
1014 payloadCount = data[0]
1015 data = [(0x3bfc, "d"), (0x30c0, "f")]
1016 for i in range(0, payloadCount):
1017 data.append((0x1400 + i*48, "f"))
1018
1019 self._handler.requestRead(data, self._handleWeights,
1020 extra = callback)
1021
1022 def _handleWeights(self, data, callback):
1023 """Callback for the weights retrieval request."""
1024 zfw = data[0] * const.LBSTOKG / 256.0
1025 grossWeight = data[1] * const.LBSTOKG
1026 payload = sum(data[2:]) * const.LBSTOKG
1027 dow = zfw - payload
1028 callback(dow, payload, zfw, grossWeight)
1029
1030 def _handleMessageSent(self, success, disconnect):
1031 """Callback for a message sending request."""
1032 #print "fsuipc.Simulator._handleMessageSent", disconnect
1033 if disconnect:
1034 self._handler.disconnect()
1035
1036 def _handleNumHotkeys(self, data, (id, generation)):
1037 """Handle the result of the query of the number of hotkeys"""
1038 with self._hotkeyLock:
1039 if id==self._hotkeySetID and generation==self._hotkeySetGeneration:
1040 numHotkeys = data[0]
1041 print "fsuipc.Simulator._handleNumHotkeys: numHotkeys:", numHotkeys
1042 data = [(0x3210 + i*4, "d") for i in range(0, numHotkeys)]
1043 self._handler.requestRead(data, self._handleHotkeyTable,
1044 (id, generation))
1045
1046 def _setupHotkeys(self, data):
1047 """Setup the hiven hotkeys and return the data to be written.
1048
1049 If there were hotkeys set previously, they are reused as much as
1050 possible. Any of them not reused will be cleared."""
1051 hotkeys = self._hotkeys
1052 numHotkeys = len(hotkeys)
1053
1054 oldHotkeyOffsets = set([] if self._hotkeyOffets is None else
1055 self._hotkeyOffets)
1056
1057 self._hotkeyOffets = []
1058 numOffsets = 0
1059
1060 while oldHotkeyOffsets:
1061 offset = oldHotkeyOffsets.pop()
1062 self._hotkeyOffets.append(offset)
1063 numOffsets += 1
1064
1065 if numOffsets>=numHotkeys:
1066 break
1067
1068 for i in range(0, len(data)):
1069 if numOffsets>=numHotkeys:
1070 break
1071
1072 if data[i]==0:
1073 self._hotkeyOffets.append(0x3210 + i*4)
1074 numOffsets += 1
1075
1076 writeData = []
1077 for i in range(0, numOffsets):
1078 Simulator._appendHotkeyData(writeData,
1079 self._hotkeyOffets[i],
1080 hotkeys[i])
1081
1082 for offset in oldHotkeyOffsets:
1083 writeData.append((offset, "u", long(0)))
1084
1085 return writeData
1086
1087 def _handleHotkeyTable(self, data, (id, generation)):
1088 """Handle the result of the query of the hotkey table."""
1089 with self._hotkeyLock:
1090 if id==self._hotkeySetID and generation==self._hotkeySetGeneration:
1091 writeData = self._setupHotkeys(data)
1092 self._handler.requestWrite(writeData,
1093 self._handleHotkeysWritten,
1094 (id, generation))
1095
1096 def _handleHotkeysWritten(self, success, (id, generation)):
1097 """Handle the result of the hotkeys having been written."""
1098 with self._hotkeyLock:
1099 if success and id==self._hotkeySetID and \
1100 generation==self._hotkeySetGeneration:
1101 data = [(offset + 3, "b") for offset in self._hotkeyOffets]
1102
1103 self._hotkeyRequestID = \
1104 self._handler.requestPeriodicRead(0.5, data,
1105 self._handleHotkeys,
1106 (id, generation))
1107
1108 def _handleHotkeys(self, data, (id, generation)):
1109 """Handle the hotkeys."""
1110 with self._hotkeyLock:
1111 if id!=self._hotkeySetID or generation!=self._hotkeySetGeneration:
1112 return
1113
1114 callback = self._hotkeyCallback
1115 offsets = self._hotkeyOffets
1116
1117 hotkeysPressed = []
1118 for i in range(0, len(data)):
1119 if data[i]!=0:
1120 hotkeysPressed.append(i)
1121
1122 if hotkeysPressed:
1123 data = []
1124 for index in hotkeysPressed:
1125 data.append((offsets[index]+3, "b", int(0)))
1126 self._handler.requestWrite(data, self._handleHotkeysCleared)
1127
1128 callback(id, hotkeysPressed)
1129
1130 def _handleHotkeysCleared(self, sucess, extra):
1131 """Callback for the hotkey-clearing write request."""
1132
1133 def _clearHotkeyRequest(self):
1134 """Clear the hotkey request in the handler if there is any."""
1135 if self._hotkeyRequestID is not None:
1136 self._handler.clearPeriodic(self._hotkeyRequestID)
1137 self._hotkeyRequestID = None
1138
1139#------------------------------------------------------------------------------
1140
1141class AircraftModel(object):
1142 """Base class for the aircraft models.
1143
1144 Aircraft models handle the data arriving from FSUIPC and turn it into an
1145 object describing the aircraft's state."""
1146 monitoringData = [("paused", 0x0264, "H"),
1147 ("latitude", 0x0560, "l"),
1148 ("longitude", 0x0568, "l"),
1149 ("frozen", 0x3364, "H"),
1150 ("replay", 0x0628, "d"),
1151 ("slew", 0x05dc, "H"),
1152 ("overspeed", 0x036d, "b"),
1153 ("stalled", 0x036c, "b"),
1154 ("onTheGround", 0x0366, "H"),
1155 ("zfw", 0x3bfc, "d"),
1156 ("grossWeight", 0x30c0, "f"),
1157 ("heading", 0x0580, "d"),
1158 ("pitch", 0x0578, "d"),
1159 ("bank", 0x057c, "d"),
1160 ("ias", 0x02bc, "d"),
1161 ("mach", 0x11c6, "H"),
1162 ("groundSpeed", 0x02b4, "d"),
1163 ("vs", 0x02c8, "d"),
1164 ("radioAltitude", 0x31e4, "d"),
1165 ("altitude", 0x0570, "l"),
1166 ("gLoad", 0x11ba, "H"),
1167 ("flapsControl", 0x0bdc, "d"),
1168 ("flapsLeft", 0x0be0, "d"),
1169 ("flapsRight", 0x0be4, "d"),
1170 ("lights", 0x0d0c, "H"),
1171 ("pitot", 0x029c, "b"),
1172 ("parking", 0x0bc8, "H"),
1173 ("gearControl", 0x0be8, "d"),
1174 ("noseGear", 0x0bec, "d"),
1175 ("spoilersArmed", 0x0bcc, "d"),
1176 ("spoilers", 0x0bd0, "d"),
1177 ("altimeter", 0x0330, "H"),
1178 ("nav1", 0x0350, "H"),
1179 ("nav2", 0x0352, "H"),
1180 ("squawk", 0x0354, "H"),
1181 ("windSpeed", 0x0e90, "H"),
1182 ("windDirection", 0x0e92, "H"),
1183 ("visibility", 0x0e8a, "H"),
1184 ("cog", 0x2ef8, "f")]
1185
1186 specialModels = []
1187
1188 @staticmethod
1189 def registerSpecial(clazz):
1190 """Register the given class as a special model."""
1191 AircraftModel.specialModels.append(clazz)
1192
1193 @staticmethod
1194 def findSpecial(aircraft, aircraftName):
1195 for specialModel in AircraftModel.specialModels:
1196 if specialModel.doesHandle(aircraft, aircraftName):
1197 return specialModel
1198 return None
1199
1200 @staticmethod
1201 def create(aircraft, aircraftName):
1202 """Create the model for the given aircraft name, and notify the
1203 aircraft about it."""
1204 specialModel = AircraftModel.findSpecial(aircraft, aircraftName)
1205 if specialModel is not None:
1206 return specialModel()
1207 if aircraft.type in _genericModels:
1208 return _genericModels[aircraft.type]()
1209 else:
1210 return GenericModel()
1211
1212 @staticmethod
1213 def convertBCD(data, length):
1214 """Convert a data item encoded as BCD into a string of the given number
1215 of digits."""
1216 bcd = ""
1217 for i in range(0, length):
1218 digit = chr(ord('0') + (data&0x0f))
1219 data >>= 4
1220 bcd = digit + bcd
1221 return bcd
1222
1223 @staticmethod
1224 def convertFrequency(data):
1225 """Convert the given frequency data to a string."""
1226 bcd = AircraftModel.convertBCD(data, 4)
1227 return "1" + bcd[0:2] + "." + bcd[2:4]
1228
1229 def __init__(self, flapsNotches):
1230 """Construct the aircraft model.
1231
1232 flapsNotches is a list of degrees of flaps that are available on the aircraft."""
1233 self._flapsNotches = flapsNotches
1234
1235 @property
1236 def name(self):
1237 """Get the name for this aircraft model."""
1238 return "FSUIPC/Generic"
1239
1240 def doesHandle(self, aircraft, aircraftName):
1241 """Determine if the model handles the given aircraft name.
1242
1243 This default implementation returns False."""
1244 return False
1245
1246 def _addOffsetWithIndexMember(self, dest, offset, type, attrName = None):
1247 """Add the given FSUIPC offset and type to the given array and a member
1248 attribute with the given name."""
1249 dest.append((offset, type))
1250 if attrName is not None:
1251 setattr(self, attrName, len(dest)-1)
1252
1253 def _addDataWithIndexMembers(self, dest, prefix, data):
1254 """Add FSUIPC data to the given array and also corresponding index
1255 member variables with the given prefix.
1256
1257 data is a list of triplets of the following items:
1258 - the name of the data item. The index member variable will have a name
1259 created by prepending the given prefix to this name.
1260 - the FSUIPC offset
1261 - the FSUIPC type
1262
1263 The latter two items will be appended to dest."""
1264 for (name, offset, type) in data:
1265 self._addOffsetWithIndexMember(dest, offset, type, prefix + name)
1266
1267 def addMonitoringData(self, data, fsType):
1268 """Add the model-specific monitoring data to the given array."""
1269 self._addDataWithIndexMembers(data, "_monidx_",
1270 AircraftModel.monitoringData)
1271
1272 def getAircraftState(self, aircraft, timestamp, data):
1273 """Get an aircraft state object for the given monitoring data."""
1274 state = fs.AircraftState()
1275
1276 state.timestamp = timestamp
1277
1278 state.latitude = data[self._monidx_latitude] * \
1279 90.0 / 10001750.0 / 65536.0 / 65536.0
1280
1281 state.longitude = data[self._monidx_longitude] * \
1282 360.0 / 65536.0 / 65536.0 / 65536.0 / 65536.0
1283 if state.longitude>180.0: state.longitude = 360.0 - state.longitude
1284
1285 state.paused = data[self._monidx_paused]!=0 or \
1286 data[self._monidx_frozen]!=0 or \
1287 data[self._monidx_replay]!=0
1288 state.trickMode = data[self._monidx_slew]!=0
1289
1290 state.overspeed = data[self._monidx_overspeed]!=0
1291 state.stalled = data[self._monidx_stalled]!=0
1292 state.onTheGround = data[self._monidx_onTheGround]!=0
1293
1294 state.zfw = data[self._monidx_zfw] * const.LBSTOKG / 256.0
1295 state.grossWeight = data[self._monidx_grossWeight] * const.LBSTOKG
1296
1297 state.heading = Handler.fsuipc2PositiveDegrees(data[self._monidx_heading])
1298
1299 state.pitch = Handler.fsuipc2Degrees(data[self._monidx_pitch])
1300 state.bank = Handler.fsuipc2Degrees(data[self._monidx_bank])
1301
1302 state.ias = Handler.fsuipc2IAS(data[self._monidx_ias])
1303 state.mach = data[self._monidx_mach] / 20480.0
1304 state.groundSpeed = data[self._monidx_groundSpeed]* 3600.0/65536.0/1852.0
1305 state.vs = Handler.fsuipc2VS(data[self._monidx_vs])
1306
1307 state.radioAltitude = \
1308 Handler.fsuipc2radioAltitude(data[self._monidx_radioAltitude])
1309 state.altitude = data[self._monidx_altitude]/const.FEETTOMETRES/65536.0/65536.0
1310
1311 state.gLoad = data[self._monidx_gLoad] / 625.0
1312
1313 numNotchesM1 = len(self._flapsNotches) - 1
1314 flapsIncrement = 16383 / numNotchesM1
1315 flapsControl = data[self._monidx_flapsControl]
1316 flapsIndex = flapsControl / flapsIncrement
1317 if flapsIndex < numNotchesM1:
1318 if (flapsControl - (flapsIndex*flapsIncrement) >
1319 (flapsIndex+1)*flapsIncrement - flapsControl):
1320 flapsIndex += 1
1321 state.flapsSet = self._flapsNotches[flapsIndex]
1322
1323 flapsLeft = data[self._monidx_flapsLeft]
1324 state.flaps = self._flapsNotches[-1]*flapsLeft/16383.0
1325
1326 lights = data[self._monidx_lights]
1327
1328 state.navLightsOn = (lights&0x01) != 0
1329 state.antiCollisionLightsOn = (lights&0x02) != 0
1330 state.landingLightsOn = (lights&0x04) != 0
1331 state.strobeLightsOn = (lights&0x10) != 0
1332
1333 state.pitotHeatOn = data[self._monidx_pitot]!=0
1334
1335 state.parking = data[self._monidx_parking]!=0
1336
1337 state.gearControlDown = data[self._monidx_gearControl]==16383
1338 state.gearsDown = data[self._monidx_noseGear]==16383
1339
1340 state.spoilersArmed = data[self._monidx_spoilersArmed]!=0
1341
1342 spoilers = data[self._monidx_spoilers]
1343 if spoilers<=4800:
1344 state.spoilersExtension = 0.0
1345 else:
1346 state.spoilersExtension = (spoilers - 4800) * 100.0 / (16383 - 4800)
1347
1348 state.altimeter = data[self._monidx_altimeter] / 16.0
1349
1350 state.nav1 = AircraftModel.convertFrequency(data[self._monidx_nav1])
1351 state.nav2 = AircraftModel.convertFrequency(data[self._monidx_nav2])
1352 state.squawk = AircraftModel.convertBCD(data[self._monidx_squawk], 4)
1353
1354 state.windSpeed = data[self._monidx_windSpeed]
1355 state.windDirection = data[self._monidx_windDirection]*360.0/65536.0
1356 if state.windDirection<0.0: state.windDirection += 360.0
1357
1358 state.visibility = data[self._monidx_visibility]*1609.344/100.0
1359
1360 state.cog = data[self._monidx_cog]
1361
1362 return state
1363
1364#------------------------------------------------------------------------------
1365
1366class GenericAircraftModel(AircraftModel):
1367 """A generic aircraft model that can handle the fuel levels, the N1 or RPM
1368 values and some other common parameters in a generic way."""
1369
1370 def __init__(self, flapsNotches, fuelTanks, numEngines, isN1 = True):
1371 """Construct the generic aircraft model with the given data.
1372
1373 flapsNotches is an array of how much degrees the individual flaps
1374 notches mean.
1375
1376 fuelTanks is an array of const.FUELTANK_XXX constants about the
1377 aircraft's fuel tanks. They will be converted to offsets.
1378
1379 numEngines is the number of engines the aircraft has.
1380
1381 isN1 determines if the engines have an N1 value or an RPM value
1382 (e.g. pistons)."""
1383 super(GenericAircraftModel, self).__init__(flapsNotches = flapsNotches)
1384
1385 self._fuelTanks = fuelTanks
1386 self._fuelStartIndex = None
1387 self._numEngines = numEngines
1388 self._engineStartIndex = None
1389 self._isN1 = isN1
1390
1391 def doesHandle(self, aircraft, aircraftName):
1392 """Determine if the model handles the given aircraft name.
1393
1394 This implementation returns True."""
1395 return True
1396
1397 def addMonitoringData(self, data, fsType):
1398 """Add the model-specific monitoring data to the given array."""
1399 super(GenericAircraftModel, self).addMonitoringData(data, fsType)
1400
1401 self._fuelStartIndex = self._addFuelOffsets(data, "_monidx_fuelWeight")
1402
1403 self._engineStartIndex = len(data)
1404 for i in range(0, self._numEngines):
1405 self._addOffsetWithIndexMember(data, 0x088c + i * 0x98, "h") # throttle lever
1406 if self._isN1:
1407 self._addOffsetWithIndexMember(data, 0x2000 + i * 0x100, "f") # N1
1408 else:
1409 self._addOffsetWithIndexMember(data, 0x0898 + i * 0x98, "H") # RPM
1410 self._addOffsetWithIndexMember(data, 0x08c8 + i * 0x98, "H") # RPM scaler
1411
1412 def getAircraftState(self, aircraft, timestamp, data):
1413 """Get the aircraft state.
1414
1415 Get it from the parent, and then add the data about the fuel levels and
1416 the engine parameters."""
1417 state = super(GenericAircraftModel, self).getAircraftState(aircraft,
1418 timestamp,
1419 data)
1420
1421 (state.fuel, state.totalFuel) = \
1422 self._convertFuelData(data, index = self._monidx_fuelWeight)
1423
1424 state.n1 = [] if self._isN1 else None
1425 state.rpm = None if self._isN1 else []
1426 itemsPerEngine = 2 if self._isN1 else 3
1427
1428 state.reverser = []
1429 for i in range(self._engineStartIndex,
1430 self._engineStartIndex +
1431 itemsPerEngine*self._numEngines,
1432 itemsPerEngine):
1433 state.reverser.append(data[i]<0)
1434 if self._isN1:
1435 state.n1.append(data[i+1])
1436 else:
1437 state.rpm.append(data[i+1] * data[i+2]/65536.0)
1438
1439 return state
1440
1441 def getFuel(self, handler, callback):
1442 """Get the fuel information for this model.
1443
1444 See Simulator.getFuel for more information. This
1445 implementation simply queries the fuel tanks given to the
1446 constructor."""
1447 data = []
1448 self._addFuelOffsets(data)
1449
1450 handler.requestRead(data, self._handleFuelRetrieved,
1451 extra = callback)
1452
1453 def setFuelLevel(self, handler, levels):
1454 """Set the fuel level.
1455
1456 See the description of Simulator.setFuelLevel. This
1457 implementation simply sets the fuel tanks as given."""
1458 data = []
1459 for (tank, level) in levels:
1460 offset = _tank2offset[tank]
1461 value = long(level * 128.0 * 65536.0)
1462 data.append( (offset, "u", value) )
1463
1464 handler.requestWrite(data, self._handleFuelWritten)
1465
1466 def _addFuelOffsets(self, data, weightIndexName = None):
1467 """Add the fuel offsets to the given data array.
1468
1469 If weightIndexName is not None, it will be the name of the
1470 fuel weight index.
1471
1472 Returns the index of the first fuel tank's data."""
1473 self._addOffsetWithIndexMember(data, 0x0af4, "H", weightIndexName)
1474
1475 fuelStartIndex = len(data)
1476 for tank in self._fuelTanks:
1477 offset = _tank2offset[tank]
1478 self._addOffsetWithIndexMember(data, offset, "u") # tank level
1479 self._addOffsetWithIndexMember(data, offset+4, "u") # tank capacity
1480
1481 return fuelStartIndex
1482
1483 def _convertFuelData(self, data, index = 0, addCapacities = False):
1484 """Convert the given data into a fuel info list.
1485
1486 The list consists of two or three-tuples of the following
1487 items:
1488 - the fuel tank ID,
1489 - the amount of the fuel in kg,
1490 - if addCapacities is True, the total capacity of the tank."""
1491 fuelWeight = data[index] / 256.0
1492 index += 1
1493
1494 result = []
1495 totalFuel = 0
1496 for fuelTank in self._fuelTanks:
1497 capacity = data[index+1] * fuelWeight * const.LBSTOKG
1498 amount = data[index] * capacity / 128.0 / 65536.0
1499 index += 2
1500
1501 result.append( (fuelTank, amount, capacity) if addCapacities
1502 else (fuelTank, amount))
1503 totalFuel += amount
1504
1505 return (result, totalFuel)
1506
1507 def _handleFuelRetrieved(self, data, callback):
1508 """Callback for a fuel retrieval request."""
1509 (fuelData, _totalFuel) = self._convertFuelData(data,
1510 addCapacities = True)
1511 callback(fuelData)
1512
1513 def _handleFuelWritten(self, success, extra):
1514 """Callback for a fuel setting request."""
1515 pass
1516
1517#------------------------------------------------------------------------------
1518
1519class GenericModel(GenericAircraftModel):
1520 """Generic aircraft model for an unknown type."""
1521 def __init__(self):
1522 """Construct the model."""
1523 super(GenericModel, self). \
1524 __init__(flapsNotches = [0, 10, 20, 30],
1525 fuelTanks = [const.FUELTANK_LEFT, const.FUELTANK_RIGHT],
1526 numEngines = 2)
1527
1528 @property
1529 def name(self):
1530 """Get the name for this aircraft model."""
1531 return "FSUIPC/Generic"
1532
1533#------------------------------------------------------------------------------
1534
1535class B737Model(GenericAircraftModel):
1536 """Generic model for the Boeing 737 Classing and NG aircraft."""
1537 fuelTanks = [const.FUELTANK_LEFT, const.FUELTANK_CENTRE, const.FUELTANK_RIGHT]
1538
1539 def __init__(self):
1540 """Construct the model."""
1541 super(B737Model, self). \
1542 __init__(flapsNotches = [0, 1, 2, 5, 10, 15, 25, 30, 40],
1543 fuelTanks = B737Model.fuelTanks,
1544 numEngines = 2)
1545
1546 @property
1547 def name(self):
1548 """Get the name for this aircraft model."""
1549 return "FSUIPC/Generic Boeing 737"
1550
1551#------------------------------------------------------------------------------
1552
1553class PMDGBoeing737NGModel(B737Model):
1554 """A model handler for the PMDG Boeing 737NG model."""
1555 @staticmethod
1556 def doesHandle(aircraft, (name, airPath)):
1557 """Determine if this model handler handles the aircraft with the given
1558 name."""
1559 return aircraft.type in [const.AIRCRAFT_B736,
1560 const.AIRCRAFT_B737,
1561 const.AIRCRAFT_B738,
1562 const.AIRCRAFT_B738C] and \
1563 (name.find("PMDG")!=-1 or airPath.find("PMDG")!=-1) and \
1564 (name.find("737")!=-1 or airPath.find("737")!=-1) and \
1565 (name.find("600")!=-1 or airPath.find("600")!=-1 or \
1566 name.find("700")!=-1 or airPath.find("700")!=-1 or \
1567 name.find("800")!=-1 or airPath.find("800")!=-1 or \
1568 name.find("900")!=-1 or airPath.find("900")!=-1)
1569
1570 @property
1571 def name(self):
1572 """Get the name for this aircraft model."""
1573 return "FSUIPC/PMDG Boeing 737NG(X)"
1574
1575 def addMonitoringData(self, data, fsType):
1576 """Add the model-specific monitoring data to the given array."""
1577 self._fsType = fsType
1578
1579 super(PMDGBoeing737NGModel, self).addMonitoringData(data, fsType)
1580
1581 self._addOffsetWithIndexMember(data, 0x6202, "b", "_pmdgidx_switches")
1582
1583 if fsType==const.SIM_MSFSX:
1584 print "FSX detected, adding position lights switch offset"
1585 self._addOffsetWithIndexMember(data, 0x6500, "b",
1586 "_pmdgidx_lts_positionsw")
1587
1588 def getAircraftState(self, aircraft, timestamp, data):
1589 """Get the aircraft state.
1590
1591 Get it from the parent, and then check some PMDG-specific stuff."""
1592 state = super(PMDGBoeing737NGModel, self).getAircraftState(aircraft,
1593 timestamp,
1594 data)
1595 if data[self._pmdgidx_switches]&0x01==0x01:
1596 state.altimeter = 1013.25
1597
1598 if self._fsType==const.SIM_MSFSX:
1599 state.strobeLightsOn = data[self._pmdgidx_lts_positionsw]==0x02
1600
1601 return state
1602
1603#------------------------------------------------------------------------------
1604
1605class B767Model(GenericAircraftModel):
1606 """Generic model for the Boeing 767 aircraft."""
1607 fuelTanks = [const.FUELTANK_LEFT, const.FUELTANK_CENTRE, const.FUELTANK_RIGHT]
1608
1609 def __init__(self):
1610 """Construct the model."""
1611 super(B767Model, self). \
1612 __init__(flapsNotches = [0, 1, 5, 15, 20, 25, 30],
1613 fuelTanks = Boeing767Model.fuelTanks,
1614 numEngines = 2)
1615
1616 @property
1617 def name(self):
1618 """Get the name for this aircraft model."""
1619 return "FSUIPC/Generic Boeing 767"
1620
1621#------------------------------------------------------------------------------
1622
1623class DH8DModel(GenericAircraftModel):
1624 """Generic model for the Bombardier Dash 8-Q400 aircraft."""
1625 fuelTanks = [const.FUELTANK_LEFT, const.FUELTANK_RIGHT]
1626
1627 def __init__(self):
1628 """Construct the model."""
1629 super(DH8DModel, self). \
1630 __init__(flapsNotches = [0, 5, 10, 15, 35],
1631 fuelTanks = DH8DModel.fuelTanks,
1632 numEngines = 2)
1633
1634 @property
1635 def name(self):
1636 """Get the name for this aircraft model."""
1637 return "FSUIPC/Generic Bombardier Dash 8-Q400"
1638
1639#------------------------------------------------------------------------------
1640
1641class DreamwingsDH8DModel(DH8DModel):
1642 """Model handler for the Dreamwings Dash 8-Q400."""
1643 @staticmethod
1644 def doesHandle(aircraft, (name, airPath)):
1645 """Determine if this model handler handles the aircraft with the given
1646 name."""
1647 return aircraft.type==const.AIRCRAFT_DH8D and \
1648 (name.find("Dreamwings")!=-1 or airPath.find("Dreamwings")!=-1) and \
1649 (name.find("Dash")!=-1 or airPath.find("Dash")!=-1) and \
1650 (name.find("Q400")!=-1 or airPath.find("Q400")!=-1) and \
1651 airPath.find("Dash8Q400")!=-1
1652
1653 @property
1654 def name(self):
1655 """Get the name for this aircraft model."""
1656 return "FSUIPC/Dreamwings Bombardier Dash 8-Q400"
1657
1658 def getAircraftState(self, aircraft, timestamp, data):
1659 """Get the aircraft state.
1660
1661 Get it from the parent, and then invert the pitot heat state."""
1662 state = super(DreamwingsDH8DModel, self).getAircraftState(aircraft,
1663 timestamp,
1664 data)
1665 state.pitotHeatOn = not state.pitotHeatOn
1666
1667 return state
1668
1669#------------------------------------------------------------------------------
1670
1671class CRJ2Model(GenericAircraftModel):
1672 """Generic model for the Bombardier CRJ-200 aircraft."""
1673 fuelTanks = [const.FUELTANK_LEFT, const.FUELTANK_CENTRE, const.FUELTANK_RIGHT]
1674
1675 def __init__(self):
1676 """Construct the model."""
1677 super(CRJ2Model, self). \
1678 __init__(flapsNotches = [0, 8, 20, 30, 45],
1679 fuelTanks = CRJ2Model.fuelTanks,
1680 numEngines = 2)
1681
1682 @property
1683 def name(self):
1684 """Get the name for this aircraft model."""
1685 return "FSUIPC/Generic Bombardier CRJ-200"
1686
1687#------------------------------------------------------------------------------
1688
1689class F70Model(GenericAircraftModel):
1690 """Generic model for the Fokker F70 aircraft."""
1691 fuelTanks = [const.FUELTANK_LEFT, const.FUELTANK_CENTRE, const.FUELTANK_RIGHT]
1692
1693 def __init__(self):
1694 """Construct the model."""
1695 super(F70Model, self). \
1696 __init__(flapsNotches = [0, 8, 15, 25, 42],
1697 fuelTanks = F70Model.fuelTanks,
1698 numEngines = 2)
1699
1700 @property
1701 def name(self):
1702 """Get the name for this aircraft model."""
1703 return "FSUIPC/Generic Fokker 70"
1704
1705#------------------------------------------------------------------------------
1706
1707class DAF70Model(F70Model):
1708 """Model for the Digital Aviation F70 implementation on FS9."""
1709 @staticmethod
1710 def doesHandle(aircraft, (name, airPath)):
1711 """Determine if this model handler handles the aircraft with the given
1712 name."""
1713 return aircraft.type == const.AIRCRAFT_F70 and \
1714 (airPath.endswith("fokker70_2k4_v4.1.air") or
1715 airPath.endswith("fokker70_2k4_v4.3.air"))
1716
1717 @property
1718 def name(self):
1719 """Get the name for this aircraft model."""
1720 return "FSUIPC/Digital Aviation Fokker 70"
1721
1722 def getAircraftState(self, aircraft, timestamp, data):
1723 """Get the aircraft state.
1724
1725 Get it from the parent, and then invert the pitot heat state."""
1726 state = super(DAF70Model, self).getAircraftState(aircraft,
1727 timestamp,
1728 data)
1729 state.landingLightsOn = None
1730 state.nav2 = None
1731
1732 return state
1733
1734#------------------------------------------------------------------------------
1735
1736class DC3Model(GenericAircraftModel):
1737 """Generic model for the Lisunov Li-2 (DC-3) aircraft."""
1738 fuelTanks = [const.FUELTANK_LEFT, const.FUELTANK_CENTRE,
1739 const.FUELTANK_RIGHT]
1740 # fuelTanks = [const.FUELTANK_LEFT_AUX, const.FUELTANK_LEFT,
1741 # const.FUELTANK_RIGHT, const.FUELTANK_RIGHT_AUX]
1742
1743 def __init__(self):
1744 """Construct the model."""
1745 super(DC3Model, self). \
1746 __init__(flapsNotches = [0, 15, 30, 45],
1747 fuelTanks = DC3Model.fuelTanks,
1748 numEngines = 2, isN1 = False)
1749 self._leftLevel = 0.0
1750 self._rightLevel = 0.0
1751
1752 @property
1753 def name(self):
1754 """Get the name for this aircraft model."""
1755 return "FSUIPC/Generic Lisunov Li-2 (DC-3)"
1756
1757 def _convertFuelData(self, data, index = 0, addCapacities = False):
1758 """Convert the given data into a fuel info list.
1759
1760 It assumes to receive the 3 fuel tanks as seen above (left,
1761 centre and right) and converts it to left aux, left, right,
1762 and right aux. The amount in the left tank goes into left aux,
1763 the amount of the right tank goes into right aux and the
1764 amount of the centre tank goes into the left and right tanks
1765 evenly distributed."""
1766 (rawFuelData, totalFuel) = \
1767 super(DC3Model, self)._convertFuelData(data, index, addCapacities)
1768
1769 centreAmount = rawFuelData[1][1]
1770 if addCapacities:
1771 centreCapacity = rawFuelData[1][2]
1772 self._leftLevel = self._rightLevel = \
1773 centreAmount / centreCapacity / 2.0
1774 fuelData = [(const.FUELTANK_LEFT_AUX,
1775 rawFuelData[0][1], rawFuelData[0][2]),
1776 (const.FUELTANK_LEFT,
1777 centreAmount/2.0, centreCapacity/2.0),
1778 (const.FUELTANK_RIGHT,
1779 centreAmount/2.0, centreCapacity/2.0),
1780 (const.FUELTANK_RIGHT_AUX,
1781 rawFuelData[2][1], rawFuelData[2][2])]
1782 else:
1783 fuelData = [(const.FUELTANK_LEFT_AUX, rawFuelData[0][1]),
1784 (const.FUELTANK_LEFT, centreAmount/2.0),
1785 (const.FUELTANK_RIGHT, centreAmount/2.0),
1786 (const.FUELTANK_RIGHT_AUX, rawFuelData[2][1])]
1787
1788 return (fuelData, totalFuel)
1789
1790 def setFuelLevel(self, handler, levels):
1791 """Set the fuel level.
1792
1793 See the description of Simulator.setFuelLevel. This
1794 implementation assumes to get the four-tank representation,
1795 as returned by getFuel()."""
1796 leftLevel = None
1797 centreLevel = None
1798 rightLevel = None
1799
1800 for (tank, level) in levels:
1801 if tank==const.FUELTANK_LEFT_AUX:
1802 leftLevel = level if leftLevel is None else (leftLevel + level)
1803 elif tank==const.FUELTANK_LEFT:
1804 level /= 2.0
1805 centreLevel = (self._rightLevel + level) \
1806 if centreLevel is None else (centreLevel + level)
1807 self._leftLevel = level
1808 elif tank==const.FUELTANK_RIGHT:
1809 level /= 2.0
1810 centreLevel = (self._leftLevel + level) \
1811 if centreLevel is None else (centreLevel + level)
1812 self._rightLevel = level
1813 elif tank==const.FUELTANK_RIGHT_AUX:
1814 rightLevel = level if rightLevel is None \
1815 else (rightLevel + level)
1816
1817 levels = []
1818 if leftLevel is not None: levels.append((const.FUELTANK_LEFT,
1819 leftLevel))
1820 if centreLevel is not None: levels.append((const.FUELTANK_CENTRE,
1821 centreLevel))
1822 if rightLevel is not None: levels.append((const.FUELTANK_RIGHT,
1823 rightLevel))
1824
1825 super(DC3Model, self).setFuelLevel(handler, levels)
1826
1827#------------------------------------------------------------------------------
1828
1829class T134Model(GenericAircraftModel):
1830 """Generic model for the Tupolev Tu-134 aircraft."""
1831 fuelTanks = [const.FUELTANK_LEFT_TIP, const.FUELTANK_EXTERNAL1,
1832 const.FUELTANK_LEFT_AUX,
1833 const.FUELTANK_CENTRE,
1834 const.FUELTANK_RIGHT_AUX,
1835 const.FUELTANK_EXTERNAL2, const.FUELTANK_RIGHT_TIP]
1836
1837 def __init__(self):
1838 """Construct the model."""
1839 super(T134Model, self). \
1840 __init__(flapsNotches = [0, 10, 20, 30],
1841 fuelTanks = T134Model.fuelTanks,
1842 numEngines = 2)
1843
1844 @property
1845 def name(self):
1846 """Get the name for this aircraft model."""
1847 return "FSUIPC/Generic Tupolev Tu-134"
1848
1849#------------------------------------------------------------------------------
1850
1851class T154Model(GenericAircraftModel):
1852 """Generic model for the Tupolev Tu-134 aircraft."""
1853 fuelTanks = [const.FUELTANK_LEFT_AUX, const.FUELTANK_LEFT,
1854 const.FUELTANK_CENTRE, const.FUELTANK_CENTRE2,
1855 const.FUELTANK_RIGHT, const.FUELTANK_RIGHT_AUX]
1856
1857 def __init__(self):
1858 """Construct the model."""
1859 super(T154Model, self). \
1860 __init__(flapsNotches = [0, 15, 28, 45],
1861 fuelTanks = T154Model.fuelTanks,
1862 numEngines = 3)
1863
1864 @property
1865 def name(self):
1866 """Get the name for this aircraft model."""
1867 return "FSUIPC/Generic Tupolev Tu-154"
1868
1869 def getAircraftState(self, aircraft, timestamp, data):
1870 """Get an aircraft state object for the given monitoring data.
1871
1872 This removes the reverser value for the middle engine."""
1873 state = super(T154Model, self).getAircraftState(aircraft, timestamp, data)
1874 del state.reverser[1]
1875 return state
1876
1877#------------------------------------------------------------------------------
1878
1879class YK40Model(GenericAircraftModel):
1880 """Generic model for the Yakovlev Yak-40 aircraft."""
1881 fuelTanks = [const.FUELTANK_LEFT, const.FUELTANK_RIGHT]
1882
1883 def __init__(self):
1884 """Construct the model."""
1885 super(YK40Model, self). \
1886 __init__(flapsNotches = [0, 20, 35],
1887 fuelTanks = YK40Model.fuelTanks,
1888 numEngines = 2)
1889
1890 @property
1891 def name(self):
1892 """Get the name for this aircraft model."""
1893 return "FSUIPC/Generic Yakovlev Yak-40"
1894
1895#------------------------------------------------------------------------------
1896
1897_genericModels = { const.AIRCRAFT_B736 : B737Model,
1898 const.AIRCRAFT_B737 : B737Model,
1899 const.AIRCRAFT_B738 : B737Model,
1900 const.AIRCRAFT_B738C : B737Model,
1901 const.AIRCRAFT_B733 : B737Model,
1902 const.AIRCRAFT_B734 : B737Model,
1903 const.AIRCRAFT_B735 : B737Model,
1904 const.AIRCRAFT_DH8D : DH8DModel,
1905 const.AIRCRAFT_B762 : B767Model,
1906 const.AIRCRAFT_B763 : B767Model,
1907 const.AIRCRAFT_CRJ2 : B767Model,
1908 const.AIRCRAFT_F70 : F70Model,
1909 const.AIRCRAFT_DC3 : DC3Model,
1910 const.AIRCRAFT_T134 : T134Model,
1911 const.AIRCRAFT_T154 : T154Model,
1912 const.AIRCRAFT_YK40 : YK40Model }
1913
1914#------------------------------------------------------------------------------
1915
1916AircraftModel.registerSpecial(PMDGBoeing737NGModel)
1917AircraftModel.registerSpecial(DreamwingsDH8DModel)
1918AircraftModel.registerSpecial(DAF70Model)
1919
1920#------------------------------------------------------------------------------
Note: See TracBrowser for help on using the repository browser.