[51] | 1 | # Simulator for the pyuipc module
|
---|
| 2 | #------------------------------------------------------------------------------
|
---|
| 3 |
|
---|
[52] | 4 | import const
|
---|
| 5 |
|
---|
[53] | 6 | import cmd
|
---|
| 7 | import threading
|
---|
| 8 | import socket
|
---|
[51] | 9 | import time
|
---|
[54] | 10 | import calendar
|
---|
[53] | 11 | import sys
|
---|
| 12 | import struct
|
---|
| 13 | import cPickle
|
---|
[57] | 14 | import math
|
---|
[51] | 15 |
|
---|
| 16 | #------------------------------------------------------------------------------
|
---|
| 17 |
|
---|
| 18 | # Version constants
|
---|
| 19 | SIM_ANY=0
|
---|
| 20 | SIM_FS98=1
|
---|
| 21 | SIM_FS2K=2
|
---|
| 22 | SIM_CFS2=3
|
---|
| 23 | SIM_CFS1=4
|
---|
| 24 | SIM_FLY=5
|
---|
| 25 | SIM_FS2K2=6
|
---|
| 26 | SIM_FS2K4=7
|
---|
| 27 |
|
---|
| 28 | #------------------------------------------------------------------------------
|
---|
| 29 |
|
---|
| 30 | # Error constants
|
---|
| 31 | ERR_OK=0
|
---|
| 32 | ERR_OPEN=1
|
---|
| 33 | ERR_NOFS=2
|
---|
| 34 | ERR_REGMSG=3
|
---|
| 35 | ERR_ATOM=4
|
---|
| 36 | ERR_MAP=5
|
---|
| 37 | ERR_VIEW=6
|
---|
| 38 | ERR_VERSION=7
|
---|
| 39 | ERR_WRONGFS=8
|
---|
| 40 | ERR_NOTOPEN=9
|
---|
| 41 | ERR_NODATA=10
|
---|
| 42 | ERR_TIMEOUT=11
|
---|
| 43 | ERR_SENDMSG=12
|
---|
| 44 | ERR_DATA=13
|
---|
| 45 | ERR_RUNNING=14
|
---|
| 46 | ERR_SIZE=15
|
---|
| 47 |
|
---|
| 48 | #------------------------------------------------------------------------------
|
---|
| 49 |
|
---|
| 50 | # The version of FSUIPC
|
---|
| 51 | fsuipc_version=0x0401
|
---|
| 52 | lib_version=0x0302
|
---|
| 53 | fs_version=SIM_FS2K4
|
---|
| 54 |
|
---|
| 55 | #------------------------------------------------------------------------------
|
---|
| 56 |
|
---|
| 57 | class FSUIPCException(Exception):
|
---|
| 58 | """FSUIPC exception class.
|
---|
| 59 |
|
---|
| 60 | It contains a member variable named errorCode. The string is a text
|
---|
| 61 | describing the error."""
|
---|
| 62 |
|
---|
| 63 | errors=["OK",
|
---|
| 64 | "Attempt to Open when already Open",
|
---|
| 65 | "Cannot link to FSUIPC or WideClient",
|
---|
| 66 | "Failed to Register common message with Windows",
|
---|
| 67 | "Failed to create Atom for mapping filename",
|
---|
| 68 | "Failed to create a file mapping object",
|
---|
| 69 | "Failed to open a view to the file map",
|
---|
| 70 | "Incorrect version of FSUIPC, or not FSUIPC",
|
---|
| 71 | "Sim is not version requested",
|
---|
| 72 | "Call cannot execute, link not Open",
|
---|
| 73 | "Call cannot execute: no requests accumulated",
|
---|
| 74 | "IPC timed out all retries",
|
---|
| 75 | "IPC sendmessage failed all retries",
|
---|
| 76 | "IPC request contains bad data",
|
---|
| 77 | "Maybe running on WideClient, but FS not running on Server, or wrong FSUIPC",
|
---|
| 78 | "Read or Write request cannot be added, memory for Process is full"]
|
---|
| 79 |
|
---|
| 80 | def __init__(self, errorCode):
|
---|
| 81 | """
|
---|
| 82 | Construct the exception
|
---|
| 83 | """
|
---|
| 84 | if errorCode<len(self.errors):
|
---|
| 85 | self.errorString = self.errors[errorCode]
|
---|
| 86 | else:
|
---|
| 87 | self.errorString = "Unknown error"
|
---|
| 88 | Exception.__init__(self, self.errorString)
|
---|
| 89 | self.errorCode = errorCode
|
---|
| 90 |
|
---|
| 91 | def __str__(self):
|
---|
| 92 | """
|
---|
| 93 | Convert the excption to string
|
---|
| 94 | """
|
---|
| 95 | return "FSUIPC error: %d (%s)" % (self.errorCode, self.errorString)
|
---|
| 96 |
|
---|
| 97 | #------------------------------------------------------------------------------
|
---|
| 98 |
|
---|
[52] | 99 | class Values(object):
|
---|
| 100 | """The values that can be read from 'FSUIPC'."""
|
---|
| 101 | # Fuel data index: centre tank
|
---|
| 102 | FUEL_CENTRE = 0
|
---|
| 103 |
|
---|
| 104 | # Fuel data index: left main tank
|
---|
| 105 | FUEL_LEFT = 1
|
---|
| 106 |
|
---|
| 107 | # Fuel data index: right main tank
|
---|
| 108 | FUEL_RIGHT = 2
|
---|
| 109 |
|
---|
| 110 | # Fuel data index: left aux tank
|
---|
| 111 | FUEL_LEFT_AUX = 3
|
---|
| 112 |
|
---|
| 113 | # Fuel data index: right aux tank
|
---|
| 114 | FUEL_RIGHT_AUX = 4
|
---|
| 115 |
|
---|
| 116 | # Fuel data index: left tip tank
|
---|
| 117 | FUEL_LEFT_TIP = 5
|
---|
| 118 |
|
---|
| 119 | # Fuel data index: right tip tank
|
---|
| 120 | FUEL_RIGHT_AUX = 6
|
---|
| 121 |
|
---|
| 122 | # Fuel data index: external 1 tank
|
---|
| 123 | FUEL_EXTERNAL_1 = 7
|
---|
| 124 |
|
---|
| 125 | # Fuel data index: external 2 tank
|
---|
| 126 | FUEL_EXTERNAL_2 = 8
|
---|
| 127 |
|
---|
| 128 | # Fuel data index: centre 2 tank
|
---|
| 129 | FUEL_CENTRE_2 = 9
|
---|
| 130 |
|
---|
| 131 | # The number of fuel tank entries
|
---|
| 132 | NUM_FUEL = FUEL_CENTRE_2 + 1
|
---|
| 133 |
|
---|
| 134 | # Engine index: engine #1
|
---|
| 135 | ENGINE_1 = 0
|
---|
| 136 |
|
---|
| 137 | # Engine index: engine #2
|
---|
| 138 | ENGINE_2 = 1
|
---|
| 139 |
|
---|
| 140 | # Engine index: engine #3
|
---|
| 141 | ENGINE_3 = 2
|
---|
| 142 |
|
---|
| 143 | @staticmethod
|
---|
[54] | 144 | def _readFrequency(frequency):
|
---|
[52] | 145 | """Convert the given frequency into BCD."""
|
---|
[54] | 146 | return Values._readBCD(int(frequency*100.0))
|
---|
[52] | 147 |
|
---|
| 148 | @staticmethod
|
---|
[54] | 149 | def _readBCD(value):
|
---|
[52] | 150 | """Convert the given value into BCD format."""
|
---|
| 151 | bcd = (value/1000) % 10
|
---|
| 152 | bcd <<= 4
|
---|
[53] | 153 | bcd |= (value/100) % 10
|
---|
[52] | 154 | bcd <<= 4
|
---|
| 155 | bcd |= (value/10) % 10
|
---|
| 156 | bcd <<= 4
|
---|
| 157 | bcd |= value % 10
|
---|
| 158 | return bcd
|
---|
| 159 |
|
---|
[54] | 160 | @staticmethod
|
---|
| 161 | def _writeFrequency(value):
|
---|
| 162 | """Convert the given value into a frequency."""
|
---|
| 163 | return (Values._writeBCD(value) + 10000) / 100.0
|
---|
| 164 |
|
---|
| 165 | @staticmethod
|
---|
| 166 | def _writeBCD(value):
|
---|
| 167 | """Convert the given BCD value into a real value."""
|
---|
[55] | 168 | bcd = (value>>12) & 0x0f
|
---|
[54] | 169 | bcd *= 10
|
---|
[55] | 170 | bcd += (value>>8) & 0x0f
|
---|
[54] | 171 | bcd *= 10
|
---|
[55] | 172 | bcd += (value>>4) & 0x0f
|
---|
[54] | 173 | bcd *= 10
|
---|
[55] | 174 | bcd += (value>>0) & 0x0f
|
---|
[54] | 175 |
|
---|
| 176 | return bcd
|
---|
| 177 |
|
---|
[52] | 178 | def __init__(self):
|
---|
| 179 | """Construct the values with defaults."""
|
---|
| 180 | self._timeOffset = 0
|
---|
| 181 | self.airPath = "C:\\Program Files\\Microsoft Games\\" \
|
---|
| 182 | "FS9\\Aircraft\\Cessna\\cessna172.air"
|
---|
| 183 | self.aircraftName = "Cessna 172SP"
|
---|
| 184 | self.flapsNotches = [0, 1, 2, 5, 10, 15, 25, 30, 40]
|
---|
| 185 | self.fuelCapacities = [10000.0, 5000.0, 5000.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0]
|
---|
| 186 |
|
---|
| 187 | self.paused = False
|
---|
| 188 | self.frozen = False
|
---|
| 189 | self.replay = False
|
---|
| 190 | self.slew = False
|
---|
| 191 | self.overspeed = False
|
---|
| 192 | self.stalled = False
|
---|
| 193 | self.onTheGround = True
|
---|
| 194 |
|
---|
| 195 | self.zfw = 50000.0
|
---|
| 196 |
|
---|
| 197 | self.fuelWeights = [0.0, 3000.0, 3000.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0]
|
---|
[56] | 198 | # Wikipedia: "Jet fuel", Jet A-1 density at 15*C .804kg/l -> 6.7 pounds/gallon
|
---|
| 199 | self.fuelWeight = 6.70970518
|
---|
[52] | 200 |
|
---|
| 201 | self.heading = 220.0
|
---|
| 202 | self.pitch = 0.0
|
---|
| 203 | self.bank = 0.0
|
---|
| 204 |
|
---|
| 205 | self.ias = 0.0
|
---|
| 206 | self.vs = 0.0
|
---|
[85] | 207 | self.tdRate = 0.0
|
---|
[52] | 208 |
|
---|
| 209 | self.radioAltitude = None
|
---|
| 210 | self.altitude = 513.0
|
---|
| 211 |
|
---|
| 212 | self.gLoad = 1.0
|
---|
| 213 |
|
---|
| 214 | self.flapsControl = 0.0
|
---|
| 215 | self.flaps = 0.0
|
---|
| 216 |
|
---|
| 217 | self.navLightsOn = True
|
---|
| 218 | self.antiCollisionLightsOn = False
|
---|
| 219 | self.landingLightsOn = False
|
---|
| 220 | self.strobeLightsOn = False
|
---|
| 221 |
|
---|
| 222 | self.pitot = False
|
---|
| 223 | self.parking = True
|
---|
| 224 |
|
---|
| 225 | self.noseGear = 1.0
|
---|
| 226 |
|
---|
| 227 | self.spoilersArmed = False
|
---|
| 228 | self.spoilers = 0.0
|
---|
| 229 |
|
---|
| 230 | self.altimeter = 1013.0
|
---|
| 231 |
|
---|
| 232 | self.nav1 = 117.3
|
---|
| 233 | self.nav2 = 109.5
|
---|
| 234 | self.squawk = 2200
|
---|
| 235 |
|
---|
| 236 | self.windSpeed = 8.0
|
---|
| 237 | self.windDirection = 300.0
|
---|
[85] | 238 | self.visibility = 10000
|
---|
[52] | 239 |
|
---|
| 240 | self.n1 = [0.0, 0.0, 0.0]
|
---|
| 241 | self.throttles = [0.0, 0.0, 0.0]
|
---|
| 242 |
|
---|
| 243 | def read(self, offset):
|
---|
| 244 | """Read the value at the given offset."""
|
---|
| 245 | try:
|
---|
| 246 | return self._read(offset)
|
---|
| 247 | except Exception, e:
|
---|
| 248 | print "failed to read offset %04x: %s" % (offset, str(e))
|
---|
| 249 | raise FSUIPCException(ERR_DATA)
|
---|
| 250 |
|
---|
| 251 | def _read(self, offset):
|
---|
| 252 | """Read the value at the given offset."""
|
---|
| 253 | if offset==0x023a: # Second of time
|
---|
| 254 | return self._readUTC().tm_sec
|
---|
| 255 | elif offset==0x023b: # Hour of Zulu time
|
---|
| 256 | return self._readUTC().tm_hour
|
---|
| 257 | elif offset==0x023c: # Minute of Zulu time
|
---|
| 258 | return self._readUTC().tm_min
|
---|
| 259 | elif offset==0x023e: # Day number on year
|
---|
| 260 | return self._readUTC().tm_yday
|
---|
| 261 | elif offset==0x0240: # Year in FS
|
---|
| 262 | return self._readUTC().tm_year
|
---|
| 263 | elif offset==0x0264: # Paused
|
---|
| 264 | return 1 if self.paused else 0
|
---|
| 265 | elif offset==0x029c: # Pitot
|
---|
| 266 | return 1 if self.pitot else 0
|
---|
| 267 | elif offset==0x02b4: # Ground speed
|
---|
| 268 | # FIXME: calculate TAS first, then from the heading and
|
---|
| 269 | # wind the GS
|
---|
| 270 | return int(self.ias * 65536.0 * 1852.0 / 3600.0)
|
---|
[57] | 271 | elif offset==0x02b8: # TAS
|
---|
| 272 | return int(self._getTAS() * 128.0)
|
---|
[52] | 273 | elif offset==0x02bc: # IAS
|
---|
| 274 | return int(self.ias * 128.0)
|
---|
| 275 | elif offset==0x02c8: # VS
|
---|
| 276 | return int(self.vs * const.FEETTOMETRES * 256.0 / 60.0)
|
---|
[85] | 277 | elif offset==0x030c: # TD rate
|
---|
| 278 | return int(self.tdRate * const.FEETTOMETRES * 256.0 / 60.0)
|
---|
[52] | 279 | elif offset==0x0330: # Altimeter
|
---|
| 280 | return int(self.altimeter * 16.0)
|
---|
| 281 | elif offset==0x0350: # NAV1
|
---|
[54] | 282 | return Values._readFrequency(self.nav1)
|
---|
[52] | 283 | elif offset==0x0352: # NAV2
|
---|
[54] | 284 | return Values._readFrequency(self.nav2)
|
---|
[52] | 285 | elif offset==0x0354: # Squawk
|
---|
[54] | 286 | return Values._readBCD(self.squawk)
|
---|
| 287 | elif offset==0x0366: # On the ground
|
---|
| 288 | return 1 if self.onTheGround else 0
|
---|
[52] | 289 | elif offset==0x036c: # Stalled
|
---|
| 290 | return 1 if self.stalled else 0
|
---|
| 291 | elif offset==0x036d: # Overspeed
|
---|
| 292 | return 1 if self.overspeed else 0
|
---|
| 293 | elif offset==0x0570: # Altitude
|
---|
| 294 | return long(self.altitude * const.FEETTOMETRES * 65536.0 * 65536.0)
|
---|
| 295 | elif offset==0x0578: # Pitch
|
---|
| 296 | return int(self.pitch * 65536.0 * 65536.0 / 360.0)
|
---|
| 297 | elif offset==0x057c: # Bank
|
---|
| 298 | return int(self.bank * 65536.0 * 65536.0 / 360.0)
|
---|
| 299 | elif offset==0x0580: # Heading
|
---|
| 300 | return int(self.heading * 65536.0 * 65536.0 / 360.0)
|
---|
| 301 | elif offset==0x05dc: # Slew
|
---|
| 302 | return 1 if self.slew else 0
|
---|
| 303 | elif offset==0x0628: # Replay
|
---|
| 304 | return 1 if self.replay else 0
|
---|
| 305 | elif offset==0x088c: # Engine #1 throttle
|
---|
| 306 | return self._getThrottle(self.ENGINE_1)
|
---|
| 307 | elif offset==0x0924: # Engine #2 throttle
|
---|
| 308 | return self._getThrottle(self.ENGINE_2)
|
---|
| 309 | elif offset==0x09bc: # Engine #3 throttle
|
---|
| 310 | return self._getThrottle(self.ENGINE_3)
|
---|
| 311 | elif offset==0x0af4: # Fuel weight
|
---|
| 312 | return int(self.fuelWeight * 256.0)
|
---|
| 313 | elif offset==0x0b74: # Centre tank level
|
---|
| 314 | return self._getFuelLevel(self.FUEL_CENTRE)
|
---|
| 315 | elif offset==0x0b78: # Centre tank capacity
|
---|
| 316 | return self._getFuelCapacity(self.FUEL_CENTRE)
|
---|
| 317 | elif offset==0x0b7c: # Left tank level
|
---|
| 318 | return self._getFuelLevel(self.FUEL_LEFT)
|
---|
| 319 | elif offset==0x0b80: # Left tank capacity
|
---|
| 320 | return self._getFuelCapacity(self.FUEL_LEFT)
|
---|
| 321 | elif offset==0x0b84: # Left aux tank level
|
---|
| 322 | return self._getFuelLevel(self.FUEL_LEFT_AUX)
|
---|
| 323 | elif offset==0x0b88: # Left aux tank capacity
|
---|
| 324 | return self._getFuelCapacity(self.FUEL_LEFT_AUX)
|
---|
| 325 | elif offset==0x0b8c: # Left tip tank level
|
---|
| 326 | return self._getFuelLevel(self.FUEL_LEFT_TIP)
|
---|
| 327 | elif offset==0x0b90: # Left tip tank capacity
|
---|
| 328 | return self._getFuelCapacity(self.FUEL_LEFT_TIP)
|
---|
| 329 | elif offset==0x0b94: # Right aux tank level
|
---|
[53] | 330 | return self._getFuelLevel(self.FUEL_RIGHT)
|
---|
[52] | 331 | elif offset==0x0b98: # Right aux tank capacity
|
---|
[53] | 332 | return self._getFuelCapacity(self.FUEL_RIGHT)
|
---|
[52] | 333 | elif offset==0x0b9c: # Right tank level
|
---|
[53] | 334 | return self._getFuelLevel(self.FUEL_RIGHT_AUX)
|
---|
[52] | 335 | elif offset==0x0ba0: # Right tank capacity
|
---|
[53] | 336 | return self._getFuelCapacity(self.FUEL_RIGHT_AUX)
|
---|
[52] | 337 | elif offset==0x0ba4: # Right tip tank level
|
---|
| 338 | return self._getFuelLevel(self.FUEL_RIGHT_TIP)
|
---|
| 339 | elif offset==0x0ba8: # Right tip tank capacity
|
---|
| 340 | return self._getFuelCapacity(self.FUEL_RIGHT_TIP)
|
---|
| 341 | elif offset==0x0bc8: # Parking
|
---|
| 342 | return 1 if self.parking else 0
|
---|
| 343 | elif offset==0x0bcc: # Spoilers armed
|
---|
| 344 | return 1 if self.spoilersArmed else 0
|
---|
| 345 | elif offset==0x0bd0: # Spoilers
|
---|
| 346 | return 0 if self.spoilers == 0 \
|
---|
| 347 | else int(self.spoilers * (16383 - 4800) + 4800)
|
---|
| 348 | elif offset==0x0bdc: # Flaps control
|
---|
| 349 | numNotchesM1 = len(self.flapsNotches) - 1
|
---|
| 350 | flapsIncrement = 16383.0 / numNotchesM1
|
---|
| 351 | index = 0
|
---|
| 352 | while index<numNotchesM1 and \
|
---|
[88] | 353 | self.flapsControl>self.flapsNotches[index]:
|
---|
[52] | 354 | index += 1
|
---|
[88] | 355 |
|
---|
[52] | 356 | if index==numNotchesM1:
|
---|
| 357 | return 16383
|
---|
| 358 | else:
|
---|
[88] | 359 | return int(index * flapsIncrement +
|
---|
| 360 | (self.flapsControl-self.flapsNotches[index]) *
|
---|
| 361 | flapsIncrement /
|
---|
[52] | 362 | (self.flapsNotches[index+1] - self.flapsNotches[index]))
|
---|
| 363 | elif offset==0x0be0 or offset==0x0be4: # Flaps left and right
|
---|
| 364 | return self.flaps * 16383.0 / self.flapsNotches[-1]
|
---|
| 365 | elif offset==0x0bec: # Nose gear
|
---|
| 366 | return int(self.noseGear * 16383.0)
|
---|
| 367 | elif offset==0x0d0c: # Lights
|
---|
| 368 | lights = 0
|
---|
| 369 | if self.navLightsOn: lights |= 0x01
|
---|
| 370 | if self.antiCollisionLightsOn: lights |= 0x02
|
---|
| 371 | if self.landingLightsOn: lights |= 0x04
|
---|
| 372 | if self.strobeLightsOn: lights |= 0x10
|
---|
| 373 | return lights
|
---|
[85] | 374 | elif offset==0x0e8a: # Visibility
|
---|
| 375 | return int(self.visibility * 100.0 / 1609.344)
|
---|
[52] | 376 | elif offset==0x0e90: # Wind speed
|
---|
| 377 | return int(self.windSpeed)
|
---|
| 378 | elif offset==0x0e92: # Wind direction
|
---|
| 379 | return int(self.windDirection * 65536.0 / 360.0)
|
---|
| 380 | elif offset==0x11ba: # G-Load
|
---|
| 381 | return int(self.gLoad * 625.0)
|
---|
| 382 | elif offset==0x11c6: # Mach
|
---|
| 383 | # FIXME: calculate from IAS, altitude and QNH
|
---|
| 384 | return int(self.ias * 0.05 * 20480.)
|
---|
| 385 | elif offset==0x1244: # Centre 2 tank level
|
---|
| 386 | return self._getFuelLevel(self.FUEL_CENTRE_2)
|
---|
| 387 | elif offset==0x1248: # Centre 2 tank capacity
|
---|
| 388 | return self._getFuelCapacity(self.FUEL_CENTRE_2)
|
---|
| 389 | elif offset==0x1254: # External 1 tank level
|
---|
| 390 | return self._getFuelLevel(self.FUEL_EXTERNAL_1)
|
---|
| 391 | elif offset==0x1258: # External 1 tank capacity
|
---|
| 392 | return self._getFuelCapacity(self.FUEL_EXTERNAL_1)
|
---|
| 393 | elif offset==0x125c: # External 2 tank level
|
---|
| 394 | return self._getFuelLevel(self.FUEL_EXTERNAL_2)
|
---|
| 395 | elif offset==0x1260: # External 2 tank capacity
|
---|
| 396 | return self._getFuelCapacity(self.FUEL_EXTERNAL_2)
|
---|
| 397 | elif offset==0x2000: # Engine #1 N1
|
---|
| 398 | return self.n1[self.ENGINE_1]
|
---|
| 399 | elif offset==0x2100: # Engine #2 N1
|
---|
| 400 | return self.n1[self.ENGINE_2]
|
---|
| 401 | elif offset==0x2200: # Engine #3 N1
|
---|
| 402 | return self.n1[self.ENGINE_3]
|
---|
[55] | 403 | elif offset==0x30c0: # Gross weight
|
---|
| 404 | return (self.zfw + sum(self.fuelWeights)) * const.KGSTOLB
|
---|
[52] | 405 | elif offset==0x31e4: # Radio altitude
|
---|
| 406 | # FIXME: if self.radioAltitude is None, calculate from the
|
---|
| 407 | # altitude with some, perhaps random, ground altitude
|
---|
| 408 | # value
|
---|
| 409 | radioAltitude = (self.altitude - 517) \
|
---|
| 410 | if self.radioAltitude is None else self.radioAltitude
|
---|
| 411 | return (radioAltitude * const.FEETTOMETRES * 65536.0)
|
---|
| 412 | elif offset==0x3364: # Frozen
|
---|
| 413 | return 1 if self.frozen else 0
|
---|
| 414 | elif offset==0x3bfc: # ZFW
|
---|
[53] | 415 | return int(self.zfw * 256.0 * const.KGSTOLB)
|
---|
[52] | 416 | elif offset==0x3c00: # Path of the current AIR file
|
---|
| 417 | return self.airPath
|
---|
| 418 | elif offset==0x3d00: # Name of the current aircraft
|
---|
| 419 | return self.aircraftName
|
---|
| 420 | else:
|
---|
| 421 | print "Unhandled offset: %04x" % (offset,)
|
---|
| 422 | raise FSUIPCException(ERR_DATA)
|
---|
[54] | 423 |
|
---|
| 424 | def write(self, offset, value):
|
---|
| 425 | """Write the value at the given offset."""
|
---|
| 426 | try:
|
---|
| 427 | return self._write(offset, value)
|
---|
| 428 | except Exception, e:
|
---|
| 429 | print "failed to write offset %04x: %s" % (offset, str(e))
|
---|
| 430 | raise FSUIPCException(ERR_DATA)
|
---|
| 431 |
|
---|
| 432 | def _write(self, offset, value):
|
---|
| 433 | """Write the given value at the given offset."""
|
---|
| 434 | if offset==0x023a: # Second of time
|
---|
| 435 | self._updateTimeOffset(5, value)
|
---|
| 436 | elif offset==0x023b: # Hour of Zulu time
|
---|
| 437 | self._updateTimeOffset(3, value)
|
---|
| 438 | elif offset==0x023c: # Minute of Zulu time
|
---|
| 439 | self._updateTimeOffset(4, value)
|
---|
| 440 | elif offset==0x023e: # Day number in the year
|
---|
| 441 | self._updateTimeOffset(7, value)
|
---|
| 442 | elif offset==0x0240: # Year in FS
|
---|
| 443 | self._updateTimeOffset(0, value)
|
---|
| 444 | elif offset==0x0264: # Paused
|
---|
| 445 | self.paused = value!=0
|
---|
| 446 | elif offset==0x029c: # Pitot
|
---|
| 447 | self.pitot = value!=0
|
---|
| 448 | elif offset==0x02b4: # Ground speed
|
---|
| 449 | # FIXME: calculate TAS using the heading and the wind, and
|
---|
| 450 | # then IAS based on the altitude
|
---|
| 451 | self.ias = value * 3600.0 / 65536.0 / 1852.0
|
---|
| 452 | elif offset==0x02bc: # IAS
|
---|
| 453 | self.ias = value / 128.0
|
---|
| 454 | elif offset==0x02c8: # VS
|
---|
| 455 | self.vs = value * 60.0 / const.FEETTOMETRES / 256.0
|
---|
[85] | 456 | if not self.onTheGround:
|
---|
| 457 | self.tdRate = self.vs
|
---|
[54] | 458 | elif offset==0x0330: # Altimeter
|
---|
| 459 | self.altimeter = value / 16.0
|
---|
| 460 | elif offset==0x0350: # NAV1
|
---|
| 461 | self.nav1 = Values._writeFrequency(value)
|
---|
| 462 | elif offset==0x0352: # NAV2
|
---|
| 463 | self.nav2 = Values._writeFrequency(value)
|
---|
| 464 | elif offset==0x0354: # Squawk
|
---|
| 465 | self.squawk = Values._writeBCD(value)
|
---|
[85] | 466 | elif offset==0x0366: # On the groud
|
---|
[54] | 467 | self.onTheGround = value!=0
|
---|
[85] | 468 | if not self.onTheGround:
|
---|
| 469 | self.tdRate = self.vs
|
---|
[54] | 470 | elif offset==0x036c: # Stalled
|
---|
| 471 | self.stalled = value!=0
|
---|
| 472 | elif offset==0x036d: # Overspeed
|
---|
| 473 | self.overspeed = value!=0
|
---|
| 474 | elif offset==0x0570: # Altitude
|
---|
| 475 | self.altitude = value / const.FEETTOMETRES / 65536.0 / 65536.0
|
---|
| 476 | elif offset==0x0578: # Pitch
|
---|
| 477 | self.pitch = value * 360.0 / 65536.0 / 65536.0
|
---|
| 478 | elif offset==0x057c: # Bank
|
---|
| 479 | self.bank = value * 360.0 / 65536.0 / 65536.0
|
---|
| 480 | elif offset==0x0580: # Heading
|
---|
| 481 | self.heading = value * 360.0 / 65536.0 / 65536.0
|
---|
| 482 | elif offset==0x05dc: # Slew
|
---|
| 483 | self.slew = value!=0
|
---|
| 484 | elif offset==0x0628: # Replay
|
---|
| 485 | self.replay = value!=0
|
---|
| 486 | elif offset==0x088c: # Engine #1 throttle
|
---|
| 487 | self._setThrottle(self.ENGINE_1, value)
|
---|
| 488 | elif offset==0x0924: # Engine #2 throttle
|
---|
| 489 | self._setThrottle(self.ENGINE_2, value)
|
---|
| 490 | elif offset==0x09bc: # Engine #3 throttle
|
---|
| 491 | self._setThrottle(self.ENGINE_3, value)
|
---|
| 492 | elif offset==0x0af4: # Fuel weight
|
---|
| 493 | self.fuelWeight = value / 256.0
|
---|
| 494 | elif offset==0x0b74: # Centre tank level
|
---|
| 495 | self._setFuelLevel(self.FUEL_CENTRE, value)
|
---|
| 496 | elif offset==0x0b78: # Centre tank capacity
|
---|
| 497 | self._setFuelCapacity(self.FUEL_CENTRE, value)
|
---|
| 498 | elif offset==0x0b7c: # Left tank level
|
---|
| 499 | self._setFuelLevel(self.FUEL_LEFT, value)
|
---|
| 500 | elif offset==0x0b80: # Left tank capacity
|
---|
| 501 | self._setFuelCapacity(self.FUEL_LEFT, value)
|
---|
| 502 | elif offset==0x0b84: # Left aux tank level
|
---|
| 503 | self._setFuelLevel(self.FUEL_LEFT_AUX, value)
|
---|
| 504 | elif offset==0x0b88: # Left aux tank capacity
|
---|
| 505 | self._setFuelCapacity(self.FUEL_LEFT_AUX, value)
|
---|
| 506 | elif offset==0x0b8c: # Left tip tank level
|
---|
| 507 | self._setFuelLevel(self.FUEL_LEFT_TIP, value)
|
---|
| 508 | elif offset==0x0b90: # Left tip tank capacity
|
---|
| 509 | self._setFuelCapacity(self.FUEL_LEFT_TIP, value)
|
---|
| 510 | elif offset==0x0b94: # Right aux tank level
|
---|
| 511 | self._setFuelLevel(self.FUEL_RIGHT, value)
|
---|
| 512 | elif offset==0x0b98: # Right aux tank capacity
|
---|
| 513 | self._setFuelCapacity(self.FUEL_RIGHT, value)
|
---|
| 514 | elif offset==0x0b9c: # Right tank level
|
---|
| 515 | self._setFuelLevel(self.FUEL_RIGHT_AUX, value)
|
---|
| 516 | elif offset==0x0ba0: # Right tank capacity
|
---|
| 517 | self._setFuelCapacity(self.FUEL_RIGHT_AUX, value)
|
---|
| 518 | elif offset==0x0ba4: # Right tip tank level
|
---|
| 519 | self._setFuelLevel(self.FUEL_RIGHT_TIP, value)
|
---|
| 520 | elif offset==0x0ba8: # Right tip tank capacity
|
---|
| 521 | self._setFuelCapacity(self.FUEL_RIGHT_TIP, value)
|
---|
| 522 | elif offset==0x0bc8: # Parking
|
---|
| 523 | self.parking = value!=0
|
---|
| 524 | elif offset==0x0bcc: # Spoilers armed
|
---|
| 525 | self.spoilersArmed = value!=0
|
---|
| 526 | elif offset==0x0bd0: # Spoilers
|
---|
| 527 | self.spoilters = 0 if value==0 \
|
---|
| 528 | else (value - 4800) / (16383 - 4800)
|
---|
| 529 | elif offset==0x0bdc: # Flaps control
|
---|
| 530 | numNotchesM1 = len(self.flapsNotches) - 1
|
---|
| 531 | flapsIncrement = 16383.0 / numNotchesM1
|
---|
[88] | 532 | index = int(value / flapsIncrement)
|
---|
[54] | 533 | if index>=numNotchesM1:
|
---|
| 534 | self.flapsControl = self.flapsNotches[-1]
|
---|
| 535 | else:
|
---|
| 536 | self.flapsControl = self.flapsNotches[index]
|
---|
[88] | 537 | self.flapsControl += (value - index * flapsIncrement) * \
|
---|
[54] | 538 | (self.flapsNotches[index+1] - self.flapsNotches[index]) / \
|
---|
| 539 | flapsIncrement
|
---|
| 540 | elif offset==0x0be0 or offset==0x0be4: # Flaps left and right
|
---|
| 541 | self.flaps = value * self.flapsNotches[-1] / 16383.0
|
---|
| 542 | elif offset==0x0bec: # Nose gear
|
---|
| 543 | self.noseGear = value / 16383.0
|
---|
| 544 | elif offset==0x0d0c: # Lights
|
---|
[83] | 545 | self.navLightsOn = (value&0x01)!=0
|
---|
| 546 | self.antiCollisionLightsOn = (value&0x02)!=0
|
---|
| 547 | self.landingLightsOn = (value&0x04)!=0
|
---|
| 548 | self.strobeLightsOn = (value&0x10)!=0
|
---|
[85] | 549 | elif offset==0x0e8a: # Visibility
|
---|
| 550 | self.visibility = value * 1609.344 / 100.0
|
---|
[54] | 551 | elif offset==0x0e90: # Wind speed
|
---|
| 552 | self.windSpeed = value
|
---|
| 553 | elif offset==0x0e92: # Wind direction
|
---|
| 554 | self.windDirection = value * 360.0 / 65536.0
|
---|
| 555 | elif offset==0x11ba: # G-Load
|
---|
| 556 | self.gLoad = value / 625.0
|
---|
| 557 | elif offset==0x11c6: # Mach
|
---|
| 558 | # FIXME: calculate IAS using the altitude and QNH
|
---|
| 559 | self.ias = value / 0.05 / 20480
|
---|
| 560 | elif offset==0x1244: # Centre 2 tank level
|
---|
| 561 | self._setFuelLevel(self.FUEL_CENTRE_2, value)
|
---|
| 562 | elif offset==0x1248: # Centre 2 tank capacity
|
---|
| 563 | self._setFuelCapacity(self.FUEL_CENTRE_2, value)
|
---|
| 564 | elif offset==0x1254: # External 1 tank level
|
---|
| 565 | self._setFuelLevel(self.FUEL_EXTERNAL_1, value)
|
---|
| 566 | elif offset==0x1258: # External 1 tank capacity
|
---|
| 567 | self._setFuelCapacity(self.FUEL_EXTERNAL_1, value)
|
---|
| 568 | elif offset==0x125c: # External 2 tank level
|
---|
| 569 | self._setFuelLevel(self.FUEL_EXTERNAL_2, value)
|
---|
| 570 | elif offset==0x1260: # External 2 tank capacity
|
---|
| 571 | self._setFuelCapacity(self.FUEL_EXTERNAL_2, value)
|
---|
| 572 | elif offset==0x2000: # Engine #1 N1
|
---|
| 573 | self.n1[self.ENGINE_1] = value
|
---|
| 574 | elif offset==0x2100: # Engine #2 N1
|
---|
| 575 | self.n1[self.ENGINE_2] = value
|
---|
| 576 | elif offset==0x2200: # Engine #3 N1
|
---|
| 577 | self.n1[self.ENGINE_3] = value
|
---|
[55] | 578 | elif offset==0x30c0: # Gross weight
|
---|
[54] | 579 | raise FSUIPCException(ERR_DATA)
|
---|
| 580 | elif offset==0x31e4: # Radio altitude
|
---|
| 581 | raise FSUIPCException(ERR_DATA)
|
---|
| 582 | elif offset==0x3364: # Frozen
|
---|
| 583 | self.frozen = value!=0
|
---|
| 584 | elif offset==0x3bfc: # ZFW
|
---|
| 585 | self.zfw = value * const.LBSTOKG / 256.0
|
---|
| 586 | elif offset==0x3c00: # Path of the current AIR file
|
---|
| 587 | self.airPath = value
|
---|
| 588 | elif offset==0x3d00: # Name of the current aircraft
|
---|
| 589 | self.aircraftName = value
|
---|
| 590 | else:
|
---|
| 591 | print "Unhandled offset: %04x" % (offset,)
|
---|
| 592 | raise FSUIPCException(ERR_DATA)
|
---|
[52] | 593 |
|
---|
| 594 | def _readUTC(self):
|
---|
| 595 | """Read the UTC time.
|
---|
| 596 |
|
---|
| 597 | The current offset is added to it."""
|
---|
| 598 | return time.gmtime(time.time() + self._timeOffset)
|
---|
| 599 |
|
---|
| 600 | def _getFuelLevel(self, index):
|
---|
| 601 | """Get the fuel level for the fuel tank with the given
|
---|
| 602 | index."""
|
---|
| 603 | return 0 if self.fuelCapacities[index]==0.0 else \
|
---|
[54] | 604 | int(self.fuelWeights[index] * 65536.0 * 128.0 / self.fuelCapacities[index])
|
---|
[52] | 605 |
|
---|
| 606 | def _getFuelCapacity(self, index):
|
---|
| 607 | """Get the capacity of the fuel tank with the given index."""
|
---|
[54] | 608 | return int(self.fuelCapacities[index] * const.KGSTOLB / self.fuelWeight)
|
---|
[52] | 609 |
|
---|
| 610 | def _getThrottle(self, index):
|
---|
| 611 | """Get the throttle value for the given index."""
|
---|
| 612 | return int(self.throttles[index] * 16383.0)
|
---|
[54] | 613 |
|
---|
| 614 | def _updateTimeOffset(self, index, value):
|
---|
| 615 | """Update the time offset if the value in the tm structure is replaced
|
---|
| 616 | by the given value."""
|
---|
| 617 | tm = self._readUTC()
|
---|
| 618 | tm1 = tm[:index] + (value,) + tm[(index+1):]
|
---|
| 619 | self._timeOffset += calendar.timegm(tm1) - calendar.timegm(tm)
|
---|
[52] | 620 |
|
---|
[54] | 621 | def _setThrottle(self, index, value):
|
---|
| 622 | """Set the throttle value for the given index."""
|
---|
| 623 | self.throttles[index] = value / 16383.0
|
---|
| 624 |
|
---|
| 625 | def _setFuelLevel(self, index, value):
|
---|
| 626 | """Set the fuel level for the fuel tank with the given index."""
|
---|
| 627 | self.fuelWeights[index] = self.fuelCapacities[index] * float(value) / \
|
---|
| 628 | 65536.0 / 128.0
|
---|
| 629 |
|
---|
| 630 | def _setFuelCapacity(self, index, value):
|
---|
| 631 | """Set the capacity of the fuel tank with the given index."""
|
---|
| 632 | self.fuelCapacities[index] = value * self.fuelWeight * const.LBSTOKG
|
---|
| 633 |
|
---|
[57] | 634 | def _getTAS(self):
|
---|
| 635 | """Calculate the true airspeed."""
|
---|
| 636 | pressure = 101325 * math.pow(1 - 2.25577e-5 * self.altitude *
|
---|
| 637 | const.FEETTOMETRES,
|
---|
| 638 | 5.25588)
|
---|
| 639 | temperature = 15 - self.altitude * 6.5 * const.FEETTOMETRES / 1000.0
|
---|
| 640 | temperature += 273.15 # Celsius -> Kelvin
|
---|
| 641 | airDensity = pressure / (temperature * 287.05)
|
---|
[88] | 642 | #print "pressure:", pressure, "temperature:", temperature, "airDensity:", airDensity
|
---|
[57] | 643 | return self.ias * math.sqrt(1.225 / airDensity)
|
---|
[54] | 644 |
|
---|
[52] | 645 | #------------------------------------------------------------------------------
|
---|
| 646 |
|
---|
| 647 | values = Values()
|
---|
| 648 |
|
---|
| 649 | #------------------------------------------------------------------------------
|
---|
| 650 |
|
---|
[59] | 651 | failOpen = False
|
---|
| 652 |
|
---|
| 653 | opened = False
|
---|
| 654 |
|
---|
| 655 | #------------------------------------------------------------------------------
|
---|
| 656 |
|
---|
[51] | 657 | def open(request):
|
---|
| 658 | """Open the connection."""
|
---|
[59] | 659 | global opened
|
---|
| 660 | if failOpen:
|
---|
| 661 | raise FSUIPCException(ERR_NOFS)
|
---|
| 662 | elif opened:
|
---|
| 663 | raise FSUIPCException(ERR_OPEN)
|
---|
| 664 | else:
|
---|
| 665 | time.sleep(0.5)
|
---|
| 666 | opened = True
|
---|
| 667 | return True
|
---|
[51] | 668 |
|
---|
| 669 | #------------------------------------------------------------------------------
|
---|
| 670 |
|
---|
| 671 | def prepare_data(pattern, forRead = True):
|
---|
| 672 | """Prepare the given pattern for reading and/or writing."""
|
---|
[59] | 673 | if opened:
|
---|
| 674 | return pattern
|
---|
| 675 | else:
|
---|
| 676 | raise FSUIPCException(ERR_OPEN)
|
---|
| 677 |
|
---|
[51] | 678 | #------------------------------------------------------------------------------
|
---|
| 679 |
|
---|
| 680 | def read(data):
|
---|
| 681 | """Read the given data."""
|
---|
[59] | 682 | if opened:
|
---|
| 683 | return [values.read(offset) for (offset, type) in data]
|
---|
| 684 | else:
|
---|
| 685 | raise FSUIPCException(ERR_OPEN)
|
---|
[51] | 686 |
|
---|
| 687 | #------------------------------------------------------------------------------
|
---|
| 688 |
|
---|
[54] | 689 | def write(data):
|
---|
| 690 | """Write the given data."""
|
---|
[59] | 691 | if opened:
|
---|
| 692 | for (offset, type, value) in data:
|
---|
| 693 | values.write(offset, value)
|
---|
| 694 | else:
|
---|
| 695 | raise FSUIPCException(ERR_OPEN)
|
---|
[54] | 696 |
|
---|
| 697 | #------------------------------------------------------------------------------
|
---|
| 698 |
|
---|
[51] | 699 | def close():
|
---|
| 700 | """Close the connection."""
|
---|
[59] | 701 | global opened
|
---|
| 702 | opened = False
|
---|
[51] | 703 |
|
---|
| 704 | #------------------------------------------------------------------------------
|
---|
[53] | 705 |
|
---|
| 706 | PORT=15015
|
---|
| 707 |
|
---|
| 708 | CALL_READ=1
|
---|
| 709 | CALL_WRITE=2
|
---|
| 710 | CALL_CLOSE=3
|
---|
[59] | 711 | CALL_FAILOPEN=4
|
---|
| 712 | CALL_QUIT = 99
|
---|
[53] | 713 |
|
---|
| 714 | RESULT_RETURNED=1
|
---|
| 715 | RESULT_EXCEPTION=2
|
---|
| 716 |
|
---|
| 717 | #------------------------------------------------------------------------------
|
---|
| 718 |
|
---|
| 719 | class Server(threading.Thread):
|
---|
| 720 | """The server thread."""
|
---|
| 721 | def __init__(self):
|
---|
| 722 | """Construct the thread."""
|
---|
| 723 | super(Server, self).__init__()
|
---|
| 724 | self.daemon = True
|
---|
| 725 |
|
---|
| 726 | def run(self):
|
---|
| 727 | """Perform the server's operation."""
|
---|
| 728 | serverSocket = socket.socket()
|
---|
| 729 |
|
---|
| 730 | serverSocket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
|
---|
| 731 | serverSocket.bind(("", PORT))
|
---|
| 732 |
|
---|
| 733 | serverSocket.listen(5)
|
---|
| 734 |
|
---|
| 735 | while True:
|
---|
| 736 | (clientSocket, clientAddress) = serverSocket.accept()
|
---|
| 737 | thread = threading.Thread(target = self._process, args=(clientSocket,))
|
---|
| 738 | thread.start()
|
---|
| 739 |
|
---|
| 740 | def _process(self, clientSocket):
|
---|
| 741 | """Process the commands arriving on the given socket."""
|
---|
| 742 | socketFile = clientSocket.makefile()
|
---|
| 743 | try:
|
---|
| 744 | while True:
|
---|
| 745 | (length,) = struct.unpack("I", clientSocket.recv(4))
|
---|
| 746 | data = clientSocket.recv(length)
|
---|
| 747 | (call, args) = cPickle.loads(data)
|
---|
| 748 | exception = None
|
---|
| 749 |
|
---|
| 750 | try:
|
---|
| 751 | if call==CALL_READ:
|
---|
| 752 | result = read(args[0])
|
---|
| 753 | elif call==CALL_WRITE:
|
---|
| 754 | result = write(args[0])
|
---|
[59] | 755 | elif call==CALL_CLOSE:
|
---|
| 756 | global opened
|
---|
| 757 | opened = False
|
---|
| 758 | result = None
|
---|
| 759 | elif call==CALL_FAILOPEN:
|
---|
| 760 | global failOpen
|
---|
| 761 | failOpen = args[0]
|
---|
| 762 | result = None
|
---|
[53] | 763 | else:
|
---|
| 764 | break
|
---|
| 765 | except Exception, e:
|
---|
| 766 | exception = e
|
---|
| 767 |
|
---|
| 768 | if exception is None:
|
---|
| 769 | data = cPickle.dumps((RESULT_RETURNED, result))
|
---|
| 770 | else:
|
---|
| 771 | data = cPickle.dumps((RESULT_EXCEPTION, exception))
|
---|
| 772 | clientSocket.send(struct.pack("I", len(data)) + data)
|
---|
| 773 | except Exception, e:
|
---|
| 774 | print >> sys.stderr, "pyuipc_sim.Server._process: failed with exception:", str(e)
|
---|
| 775 | finally:
|
---|
| 776 | try:
|
---|
| 777 | socketFile.close()
|
---|
| 778 | except:
|
---|
| 779 | pass
|
---|
| 780 | clientSocket.close()
|
---|
| 781 |
|
---|
| 782 | #------------------------------------------------------------------------------
|
---|
| 783 |
|
---|
| 784 | class Client(object):
|
---|
| 785 | """Client to the server."""
|
---|
| 786 | def __init__(self, serverHost):
|
---|
| 787 | """Construct the client and connect to the given server
|
---|
| 788 | host."""
|
---|
| 789 | self._socket = socket.socket()
|
---|
| 790 | self._socket.connect((serverHost, PORT))
|
---|
| 791 |
|
---|
| 792 | self._socketFile = self._socket.makefile()
|
---|
| 793 |
|
---|
| 794 | def read(self, data):
|
---|
| 795 | """Read the given data."""
|
---|
[54] | 796 | return self._call(CALL_READ, data)
|
---|
| 797 |
|
---|
| 798 | def write(self, data):
|
---|
| 799 | """Write the given data."""
|
---|
| 800 | return self._call(CALL_WRITE, data)
|
---|
| 801 |
|
---|
[59] | 802 | def close(self):
|
---|
| 803 | """Close the connection currently opened in the simulator."""
|
---|
| 804 | return self._call(CALL_CLOSE, None)
|
---|
| 805 |
|
---|
| 806 | def failOpen(self, really):
|
---|
| 807 | """Enable/disable open failure in the simulator."""
|
---|
| 808 | return self._call(CALL_FAILOPEN, really)
|
---|
| 809 |
|
---|
| 810 | def quit(self):
|
---|
| 811 | """Quit from the simulator."""
|
---|
| 812 | data = cPickle.dumps((CALL_QUIT, None))
|
---|
| 813 | self._socket.send(struct.pack("I", len(data)) + data)
|
---|
| 814 |
|
---|
[54] | 815 | def _call(self, command, data):
|
---|
| 816 | """Perform a call with the given command and data."""
|
---|
| 817 | data = cPickle.dumps((command, [data]))
|
---|
[53] | 818 | self._socket.send(struct.pack("I", len(data)) + data)
|
---|
| 819 | (length,) = struct.unpack("I", self._socket.recv(4))
|
---|
| 820 | data = self._socket.recv(length)
|
---|
| 821 | (resultCode, result) = cPickle.loads(data)
|
---|
| 822 | if resultCode==RESULT_RETURNED:
|
---|
| 823 | return result
|
---|
| 824 | else:
|
---|
[54] | 825 | raise result
|
---|
[53] | 826 |
|
---|
| 827 | #------------------------------------------------------------------------------
|
---|
| 828 | #------------------------------------------------------------------------------
|
---|
| 829 |
|
---|
| 830 | # FIXME: implement proper completion and history
|
---|
[55] | 831 | class CLI(cmd.Cmd):
|
---|
[53] | 832 | """The command-line interpreter."""
|
---|
[55] | 833 | @staticmethod
|
---|
| 834 | def str2bool(s):
|
---|
| 835 | """Convert the given string to a PyUIPC boolean value (i.e. 0 or 1)."""
|
---|
| 836 | return 1 if s in ["yes", "true", "on"] else 0
|
---|
| 837 |
|
---|
| 838 | @staticmethod
|
---|
| 839 | def bool2str(value):
|
---|
| 840 | """Convert the PyUIPC boolean value (i.e. 0 or 1) into a string."""
|
---|
| 841 | return "no" if value==0 else "yes"
|
---|
| 842 |
|
---|
| 843 | @staticmethod
|
---|
| 844 | def degree2pyuipc(degree):
|
---|
| 845 | """Convert the given degree (as a string) into a PyUIPC value."""
|
---|
| 846 | return int(float(degree) * 65536.0 * 65536.0 / 360.0)
|
---|
| 847 |
|
---|
| 848 | @staticmethod
|
---|
| 849 | def pyuipc2degree(value):
|
---|
| 850 | """Convert the given PyUIPC value into a degree."""
|
---|
| 851 | return valie * 360.0 / 65536.0 / 65536.0
|
---|
[56] | 852 |
|
---|
| 853 | @staticmethod
|
---|
| 854 | def fuelLevel2pyuipc(level):
|
---|
| 855 | """Convert the given percentage value (as a string) into a PyUIPC value."""
|
---|
| 856 | return int(float(level) * 128.0 * 65536.0 / 100.0)
|
---|
| 857 |
|
---|
| 858 | @staticmethod
|
---|
| 859 | def pyuipc2fuelLevel(value):
|
---|
| 860 | """Convert the PyUIPC value into a percentage value."""
|
---|
| 861 | return value * 100.0 / 128.0 / 65536.0
|
---|
| 862 |
|
---|
| 863 | @staticmethod
|
---|
| 864 | def fuelCapacity2pyuipc(capacity):
|
---|
| 865 | """Convert the given capacity value (as a string) into a PyUIPC value."""
|
---|
| 866 | return int(capacity)
|
---|
| 867 |
|
---|
| 868 | @staticmethod
|
---|
| 869 | def pyuipc2fuelCapacity(value):
|
---|
| 870 | """Convert the given capacity value into a PyUIPC value."""
|
---|
| 871 | return value
|
---|
| 872 |
|
---|
| 873 | @staticmethod
|
---|
| 874 | def throttle2pyuipc(throttle):
|
---|
| 875 | """Convert the given throttle value (as a string) into a PyUIPC value."""
|
---|
| 876 | return int(float(throttle) * 16384.0 / 100.0)
|
---|
| 877 |
|
---|
| 878 | @staticmethod
|
---|
| 879 | def pyuipc2throttle(value):
|
---|
| 880 | """Convert the given PyUIPC value into a throttle value."""
|
---|
| 881 | return value * 100.0 / 16384.0
|
---|
[55] | 882 |
|
---|
| 883 | def __init__(self):
|
---|
[53] | 884 | """Construct the CLI."""
|
---|
[55] | 885 | cmd.Cmd.__init__(self)
|
---|
[53] | 886 |
|
---|
[55] | 887 | self.use_rawinput = True
|
---|
[53] | 888 | self.intro = "\nPyUIPC simulator command prompt\n"
|
---|
| 889 | self.prompt = "PyUIPC> "
|
---|
| 890 |
|
---|
| 891 | self.daemon = True
|
---|
| 892 |
|
---|
[55] | 893 | self._client = Client("localhost")
|
---|
| 894 |
|
---|
| 895 | self._valueHandlers = {}
|
---|
| 896 | self._valueHandlers["year"] = (0x0240, "H", lambda value: value,
|
---|
| 897 | lambda word: int(word))
|
---|
| 898 | self._valueHandlers["yday"] = (0x023e, "H", lambda value: value,
|
---|
| 899 | lambda word: int(word))
|
---|
| 900 | self._valueHandlers["hour"] = (0x023b, "b", lambda value: value,
|
---|
| 901 | lambda word: int(word))
|
---|
| 902 | self._valueHandlers["min"] = (0x023c, "b", lambda value: value,
|
---|
| 903 | lambda word: int(word))
|
---|
| 904 | self._valueHandlers["sec"] = (0x023a, "b", lambda value: value,
|
---|
| 905 | lambda word: int(word))
|
---|
| 906 | self._valueHandlers["acftName"] = (0x3d00, -256, lambda value: value,
|
---|
| 907 | lambda word: word)
|
---|
| 908 | self._valueHandlers["airPath"] = (0x3c00, -256, lambda value: value,
|
---|
| 909 | lambda word: word)
|
---|
| 910 | self._valueHandlers["paused"] = (0x0264, "H", CLI.bool2str, CLI.str2bool)
|
---|
| 911 | self._valueHandlers["frozen"] = (0x3364, "H", CLI.bool2str, CLI.str2bool)
|
---|
| 912 | self._valueHandlers["replay"] = (0x0628, "d", CLI.bool2str, CLI.str2bool)
|
---|
| 913 | self._valueHandlers["slew"] = (0x05dc, "H", CLI.bool2str, CLI.str2bool)
|
---|
| 914 | self._valueHandlers["overspeed"] = (0x036d, "b", CLI.bool2str, CLI.str2bool)
|
---|
| 915 | self._valueHandlers["stalled"] = (0x036c, "b", CLI.bool2str, CLI.str2bool)
|
---|
| 916 | self._valueHandlers["onTheGround"] = (0x0366, "H", CLI.bool2str, CLI.str2bool)
|
---|
| 917 | self._valueHandlers["zfw"] = (0x3bfc, "d",
|
---|
| 918 | lambda value: value * const.LBSTOKG / 256.0,
|
---|
| 919 | lambda word: int(float(word) * 256.0 *
|
---|
| 920 | const.KGSTOLB))
|
---|
| 921 | self._valueHandlers["grossWeight"] = (0x30c0, "f",
|
---|
| 922 | lambda value: value * const.LBSTOKG,
|
---|
| 923 | lambda word: None)
|
---|
| 924 | self._valueHandlers["heading"] = (0x0580, "d",
|
---|
| 925 | CLI.pyuipc2degree, CLI.degree2pyuipc)
|
---|
| 926 | self._valueHandlers["pitch"] = (0x0578, "d",
|
---|
| 927 | CLI.pyuipc2degree, CLI.degree2pyuipc)
|
---|
| 928 | self._valueHandlers["bank"] = (0x057c, "d",
|
---|
| 929 | CLI.pyuipc2degree, CLI.degree2pyuipc)
|
---|
| 930 | self._valueHandlers["ias"] = (0x02bc, "d",
|
---|
| 931 | lambda value: value / 128.0,
|
---|
| 932 | lambda word: int(float(word) * 128.0))
|
---|
| 933 | self._valueHandlers["mach"] = (0x11c6, "H",
|
---|
| 934 | lambda value: value / 20480.0,
|
---|
| 935 | lambda word: int(float(word) * 20480.0))
|
---|
| 936 | self._valueHandlers["gs"] = (0x02b4, "d",
|
---|
| 937 | lambda value: value * 3600.0 / 65536.0 / 1852.0,
|
---|
| 938 | lambda word: int(float(word) * 65536.0 *
|
---|
| 939 | 1852.0 / 3600))
|
---|
[57] | 940 | self._valueHandlers["tas"] = (0x02b8, "d",
|
---|
| 941 | lambda value: value / 128.0,
|
---|
| 942 | lambda word: None)
|
---|
[55] | 943 | self._valueHandlers["vs"] = (0x02c8, "d",
|
---|
| 944 | lambda value: value * 60 /
|
---|
| 945 | const.FEETTOMETRES / 256.0,
|
---|
| 946 | lambda word: int(float(word) *
|
---|
| 947 | const.FEETTOMETRES *
|
---|
| 948 | 256.0 / 60.0))
|
---|
[85] | 949 | self._valueHandlers["tdRate"] = (0x030c, "d",
|
---|
| 950 | lambda value: value * 60 /
|
---|
| 951 | const.FEETTOMETRES / 256.0,
|
---|
| 952 | lambda word: int(float(word) *
|
---|
| 953 | const.FEETTOMETRES *
|
---|
| 954 | 256.0 / 60.0))
|
---|
[55] | 955 | self._valueHandlers["radioAltitude"] = (0x31e4, "d",
|
---|
| 956 | lambda value: value /
|
---|
| 957 | const.FEETTOMETRES /
|
---|
| 958 | 65536.0,
|
---|
| 959 | lambda word: int(float(word) *
|
---|
| 960 | const.FEETTOMETRES *
|
---|
| 961 | 65536.0))
|
---|
| 962 | self._valueHandlers["altitude"] = (0x0570, "l",
|
---|
| 963 | lambda value: value /
|
---|
| 964 | const.FEETTOMETRES / 65536.0 /
|
---|
| 965 | 65536.0,
|
---|
| 966 | lambda word: long(float(word) *
|
---|
| 967 | const.FEETTOMETRES *
|
---|
| 968 | 65536.0 * 65536.0))
|
---|
| 969 | self._valueHandlers["gLoad"] = (0x11ba, "H",
|
---|
| 970 | lambda value: value / 625.0,
|
---|
| 971 | lambda word: int(float(word) * 625.0))
|
---|
| 972 |
|
---|
| 973 | self._valueHandlers["flapsControl"] = (0x0bdc, "d",
|
---|
| 974 | lambda value: value * 100.0 / 16383.0,
|
---|
| 975 | lambda word: int(float(word) *
|
---|
| 976 | 16383.0 / 100.0))
|
---|
| 977 | self._valueHandlers["flaps"] = (0x0be0, "d",
|
---|
| 978 | lambda value: value * 100.0 / 16383.0,
|
---|
| 979 | lambda word: int(float(word) *
|
---|
| 980 | 16383.0 / 100.0))
|
---|
| 981 | self._valueHandlers["lights"] = (0x0d0c, "H",
|
---|
[83] | 982 | lambda value: value,
|
---|
| 983 | lambda word: int(word))
|
---|
[55] | 984 | self._valueHandlers["pitot"] = (0x029c, "b", CLI.bool2str, CLI.str2bool)
|
---|
| 985 | self._valueHandlers["parking"] = (0x0bc8, "H", CLI.bool2str, CLI.str2bool)
|
---|
| 986 | self._valueHandlers["noseGear"] = (0x0bec, "d",
|
---|
| 987 | lambda value: value * 100.0 / 16383.0,
|
---|
| 988 | lambda word: int(float(word) *
|
---|
| 989 | 16383.0 / 100.0))
|
---|
| 990 | self._valueHandlers["spoilersArmed"] = (0x0bcc, "d",
|
---|
| 991 | CLI.bool2str, CLI.str2bool)
|
---|
| 992 | self._valueHandlers["spoilers"] = (0x0bd0, "d",
|
---|
| 993 | lambda value: value,
|
---|
| 994 | lambda word: int(word))
|
---|
| 995 | self._valueHandlers["qnh"] = (0x0330, "H",
|
---|
| 996 | lambda value: value / 16.0,
|
---|
| 997 | lambda word: int(float(word)*16.0))
|
---|
| 998 | self._valueHandlers["nav1"] = (0x0350, "H",
|
---|
| 999 | Values._writeFrequency,
|
---|
| 1000 | lambda word: Values._readFrequency(float(word)))
|
---|
| 1001 | self._valueHandlers["nav2"] = (0x0352, "H",
|
---|
| 1002 | Values._writeFrequency,
|
---|
| 1003 | lambda word: Values._readFrequency(float(word)))
|
---|
| 1004 | self._valueHandlers["squawk"] = (0x0354, "H",
|
---|
| 1005 | Values._writeBCD,
|
---|
| 1006 | lambda word: Values._readBCD(int(word)))
|
---|
| 1007 | self._valueHandlers["windSpeed"] = (0x0e90, "H",
|
---|
| 1008 | lambda value: value,
|
---|
| 1009 | lambda word: int(word))
|
---|
| 1010 | self._valueHandlers["windDirection"] = (0x0e92, "H",
|
---|
| 1011 | lambda value: value * 360.0 / 65536.0,
|
---|
| 1012 | lambda word: int(int(word) *
|
---|
| 1013 | 65536.0 / 360.0))
|
---|
[56] | 1014 | self._valueHandlers["fuelWeight"] = (0x0af4, "H",
|
---|
| 1015 | lambda value: value / 256.0,
|
---|
| 1016 | lambda word: int(float(word)*256.0))
|
---|
| 1017 |
|
---|
| 1018 |
|
---|
| 1019 | self._valueHandlers["centreLevel"] = (0x0b74, "d", CLI.pyuipc2fuelLevel,
|
---|
| 1020 | CLI.fuelLevel2pyuipc)
|
---|
| 1021 | self._valueHandlers["centreCapacity"] = (0x0b78, "d",
|
---|
| 1022 | CLI.pyuipc2fuelCapacity,
|
---|
| 1023 | CLI.fuelCapacity2pyuipc)
|
---|
| 1024 | self._valueHandlers["leftMainLevel"] = (0x0b7c, "d", CLI.pyuipc2fuelLevel,
|
---|
| 1025 | CLI.fuelLevel2pyuipc)
|
---|
| 1026 | self._valueHandlers["leftMainCapacity"] = (0x0b80, "d",
|
---|
| 1027 | CLI.pyuipc2fuelCapacity,
|
---|
| 1028 | CLI.fuelCapacity2pyuipc)
|
---|
| 1029 | self._valueHandlers["leftAuxLevel"] = (0x0b84, "d", CLI.pyuipc2fuelLevel,
|
---|
| 1030 | CLI.fuelLevel2pyuipc)
|
---|
| 1031 | self._valueHandlers["leftAuxCapacity"] = (0x0b88, "d",
|
---|
| 1032 | CLI.pyuipc2fuelCapacity,
|
---|
| 1033 | CLI.fuelCapacity2pyuipc)
|
---|
| 1034 | self._valueHandlers["leftTipLevel"] = (0x0b8c, "d", CLI.pyuipc2fuelLevel,
|
---|
| 1035 | CLI.fuelLevel2pyuipc)
|
---|
| 1036 | self._valueHandlers["leftTipCapacity"] = (0x0b90, "d",
|
---|
| 1037 | CLI.pyuipc2fuelCapacity,
|
---|
| 1038 | CLI.fuelCapacity2pyuipc)
|
---|
| 1039 | self._valueHandlers["rightMainLevel"] = (0x0b94, "d", CLI.pyuipc2fuelLevel,
|
---|
| 1040 | CLI.fuelLevel2pyuipc)
|
---|
| 1041 | self._valueHandlers["rightMainCapacity"] = (0x0b98, "d",
|
---|
| 1042 | CLI.pyuipc2fuelCapacity,
|
---|
| 1043 | CLI.fuelCapacity2pyuipc)
|
---|
| 1044 | self._valueHandlers["rightAuxLevel"] = (0x0b9c, "d", CLI.pyuipc2fuelLevel,
|
---|
| 1045 | CLI.fuelLevel2pyuipc)
|
---|
| 1046 | self._valueHandlers["rightAuxCapacity"] = (0x0ba0, "d",
|
---|
| 1047 | CLI.pyuipc2fuelCapacity,
|
---|
| 1048 | CLI.fuelCapacity2pyuipc)
|
---|
| 1049 | self._valueHandlers["rightTipLevel"] = (0x0ba4, "d", CLI.pyuipc2fuelLevel,
|
---|
| 1050 | CLI.fuelLevel2pyuipc)
|
---|
| 1051 | self._valueHandlers["rightTipCapacity"] = (0x0ba8, "d",
|
---|
| 1052 | CLI.pyuipc2fuelCapacity,
|
---|
| 1053 | CLI.fuelCapacity2pyuipc)
|
---|
| 1054 | self._valueHandlers["centre2Level"] = (0x1244, "d", CLI.pyuipc2fuelLevel,
|
---|
| 1055 | CLI.fuelLevel2pyuipc)
|
---|
| 1056 | self._valueHandlers["centre2Capacity"] = (0x1248, "d",
|
---|
| 1057 | CLI.pyuipc2fuelCapacity,
|
---|
| 1058 | CLI.fuelCapacity2pyuipc)
|
---|
| 1059 | self._valueHandlers["external1Level"] = (0x1254, "d", CLI.pyuipc2fuelLevel,
|
---|
| 1060 | CLI.fuelLevel2pyuipc)
|
---|
| 1061 | self._valueHandlers["external1Capacity"] = (0x1258, "d",
|
---|
| 1062 | CLI.pyuipc2fuelCapacity,
|
---|
| 1063 | CLI.fuelCapacity2pyuipc)
|
---|
| 1064 | self._valueHandlers["external2Level"] = (0x125c, "d", CLI.pyuipc2fuelLevel,
|
---|
| 1065 | CLI.fuelLevel2pyuipc)
|
---|
| 1066 | self._valueHandlers["external2Capacity"] = (0x1260, "d",
|
---|
| 1067 | CLI.pyuipc2fuelCapacity,
|
---|
| 1068 | CLI.fuelCapacity2pyuipc)
|
---|
| 1069 |
|
---|
| 1070 | self._valueHandlers["n1_1"] = (0x2000, "f", lambda value: value,
|
---|
| 1071 | lambda word: float(word))
|
---|
| 1072 | self._valueHandlers["n1_2"] = (0x2100, "f", lambda value: value,
|
---|
| 1073 | lambda word: float(word))
|
---|
| 1074 | self._valueHandlers["n1_3"] = (0x2200, "f", lambda value: value,
|
---|
| 1075 | lambda word: float(word))
|
---|
| 1076 |
|
---|
| 1077 | self._valueHandlers["throttle_1"] = (0x088c, "H",
|
---|
| 1078 | CLI.pyuipc2throttle,
|
---|
| 1079 | CLI.throttle2pyuipc)
|
---|
| 1080 | self._valueHandlers["throttle_2"] = (0x0924, "H",
|
---|
| 1081 | CLI.pyuipc2throttle,
|
---|
| 1082 | CLI.throttle2pyuipc)
|
---|
| 1083 | self._valueHandlers["throttle_3"] = (0x09bc, "H",
|
---|
| 1084 | CLI.pyuipc2throttle,
|
---|
| 1085 | CLI.throttle2pyuipc)
|
---|
[55] | 1086 |
|
---|
[85] | 1087 | self._valueHandlers["visibility"] = (0x0e8a, "H",
|
---|
| 1088 | lambda value: value*1609.344/100.0,
|
---|
| 1089 | lambda word: int(float(word)*
|
---|
| 1090 | 100.0/1609.344))
|
---|
| 1091 |
|
---|
[55] | 1092 | def default(self, line):
|
---|
| 1093 | """Handle unhandle commands."""
|
---|
| 1094 | if line=="EOF":
|
---|
| 1095 | print
|
---|
[59] | 1096 | return self.do_quit("")
|
---|
[55] | 1097 | else:
|
---|
| 1098 | return super(CLI, self).default(line)
|
---|
| 1099 |
|
---|
| 1100 | def do_get(self, args):
|
---|
| 1101 | """Handle the get command."""
|
---|
| 1102 | names = args.split()
|
---|
| 1103 | data = []
|
---|
| 1104 | for name in names:
|
---|
| 1105 | if name not in self._valueHandlers:
|
---|
| 1106 | print >> sys.stderr, "Unknown variable: " + name
|
---|
| 1107 | return False
|
---|
| 1108 | valueHandler = self._valueHandlers[name]
|
---|
| 1109 | data.append((valueHandler[0], valueHandler[1]))
|
---|
| 1110 |
|
---|
[53] | 1111 | try:
|
---|
[55] | 1112 | result = self._client.read(data)
|
---|
| 1113 | for i in range(0, len(result)):
|
---|
| 1114 | name = names[i]
|
---|
| 1115 | valueHandler = self._valueHandlers[name]
|
---|
| 1116 | print name + "=" + str(valueHandler[2](result[i]))
|
---|
[53] | 1117 | except Exception, e:
|
---|
[55] | 1118 | print >> sys.stderr, "Failed to read data: " + str(e)
|
---|
| 1119 |
|
---|
| 1120 | return False
|
---|
| 1121 |
|
---|
| 1122 | def help_get(self):
|
---|
| 1123 | """Print help for the get command."""
|
---|
| 1124 | print "get <variable> [<variable>...]"
|
---|
| 1125 |
|
---|
| 1126 | def complete_get(self, text, line, begidx, endidx):
|
---|
| 1127 | """Try to complete the get command."""
|
---|
| 1128 | return [key for key in self._valueHandlers if key.startswith(text)]
|
---|
[53] | 1129 |
|
---|
| 1130 | def do_set(self, args):
|
---|
| 1131 | """Handle the set command."""
|
---|
[55] | 1132 | arguments = args.split()
|
---|
| 1133 | names = []
|
---|
| 1134 | data = []
|
---|
| 1135 | for argument in arguments:
|
---|
| 1136 | words = argument.split("=")
|
---|
| 1137 | if len(words)!=2:
|
---|
| 1138 | print >> sys.stderr, "Invalid argument: " + argument
|
---|
| 1139 | return False
|
---|
| 1140 |
|
---|
| 1141 | (name, value) = words
|
---|
| 1142 | if name not in self._valueHandlers:
|
---|
| 1143 | print >> sys.stderr, "Unknown variable: " + name
|
---|
| 1144 | return False
|
---|
| 1145 |
|
---|
| 1146 | valueHandler = self._valueHandlers[name]
|
---|
| 1147 | try:
|
---|
| 1148 | value = valueHandler[3](value)
|
---|
| 1149 | data.append((valueHandler[0], valueHandler[1], value))
|
---|
| 1150 | except Exception, e:
|
---|
| 1151 | print >> sys.stderr, "Invalid value '%s' for variable %s: %s" % \
|
---|
| 1152 | (value, name, str(e))
|
---|
| 1153 | return False
|
---|
| 1154 |
|
---|
| 1155 | try:
|
---|
| 1156 | self._client.write(data)
|
---|
| 1157 | print "Data written"
|
---|
| 1158 | except Exception, e:
|
---|
| 1159 | print >> sys.stderr, "Failed to write data: " + str(e)
|
---|
| 1160 |
|
---|
[53] | 1161 | return False
|
---|
| 1162 |
|
---|
| 1163 | def help_set(self):
|
---|
| 1164 | """Print help for the set command."""
|
---|
[55] | 1165 | print "set <variable>=<value> [<variable>=<value>...]"
|
---|
| 1166 |
|
---|
| 1167 | def complete_set(self, text, line, begidx, endidx):
|
---|
| 1168 | """Try to complete the set command."""
|
---|
| 1169 | if not text and begidx>0 and line[begidx-1]=="=":
|
---|
| 1170 | return []
|
---|
| 1171 | else:
|
---|
| 1172 | return [key + "=" for key in self._valueHandlers if key.startswith(text)]
|
---|
[53] | 1173 |
|
---|
[59] | 1174 | def do_close(self, args):
|
---|
| 1175 | """Close an existing connection so that FS will fail."""
|
---|
| 1176 | try:
|
---|
| 1177 | self._client.close()
|
---|
| 1178 | print "Connection closed"
|
---|
| 1179 | except Exception, e:
|
---|
| 1180 | print >> sys.stderr, "Failed to close the connection: " + str(e)
|
---|
| 1181 |
|
---|
| 1182 | def do_failopen(self, args):
|
---|
| 1183 | """Enable/disable the failing of opens."""
|
---|
| 1184 | try:
|
---|
| 1185 | value = self.str2bool(args)
|
---|
| 1186 | self._client.failOpen(value)
|
---|
| 1187 | print "Opening will%s fail" % ("" if value else " not",)
|
---|
| 1188 | except Exception, e:
|
---|
| 1189 | print >> sys.stderr, "Failed to set open failure: " + str(e)
|
---|
| 1190 |
|
---|
| 1191 | def help_failopen(self, usage = False):
|
---|
| 1192 | """Help for the failopen close"""
|
---|
| 1193 | if usage: print "Usage:",
|
---|
| 1194 | print "failopen yes|no"
|
---|
| 1195 |
|
---|
| 1196 | def complete_failopen(self, text, line, begidx, endidx):
|
---|
| 1197 | if text:
|
---|
| 1198 | if "yes".startswith(text): return ["yes"]
|
---|
| 1199 | elif "no".startswith(text): return ["no"]
|
---|
| 1200 | else: return []
|
---|
| 1201 | else:
|
---|
| 1202 | return ["yes", "no"]
|
---|
| 1203 |
|
---|
[53] | 1204 | def do_quit(self, args):
|
---|
| 1205 | """Handle the quit command."""
|
---|
[59] | 1206 | self._client.quit()
|
---|
[53] | 1207 | return True
|
---|
| 1208 |
|
---|
| 1209 | #------------------------------------------------------------------------------
|
---|
| 1210 |
|
---|
| 1211 | if __name__ == "__main__":
|
---|
[55] | 1212 | CLI().cmdloop()
|
---|
[53] | 1213 | else:
|
---|
| 1214 | server = Server()
|
---|
| 1215 | server.start()
|
---|
| 1216 |
|
---|
| 1217 | #------------------------------------------------------------------------------
|
---|