simcon 0.6.1

MSFS SimConnect wrapper for Python

py-simcon

This is a Python wrapper for SimConnect library which is used to talk to Microsoft Flight Simulator. This wrapper provides natural pythonic interface. It can be used in both synchronous and asynchronous (asyncio) applications. In both cases it is thread safe.

Features

• Listen to system events (aircraft loaded, game paused, etc)
• Receive data updates
• Async and sync interfaces, which can work together simultaneously

Examples

Conventional (synchronous)

import pprint

from simcon import Sim, DataField, PERIOD
from simcon.data import types


with Sim("MyApp") as sim:
    data = sim.sync_request_data_once([
        DataField("ATC ID", None, types.STRING32),
        DataField("Title", None, types.STRING256),
    ])
    pprint.pprint(data)
    data_request = sim.request_data_on_sim_object(
        [
            DataField("HSI station ident", None, types.STRING8),
            DataField("Plane latitude", "degrees"),
            DataField("Plane longitude", "degrees"),
            DataField("Plane altitude", "feet"),
            DataField("GPS ground true track", "degrees"),
            DataField("GPS ground speed", "knots"),
            DataField("Zulu time", "seconds"),
        ],
        PERIOD.SECOND,
    )
    count = 0
    for data in data_request:
        pprint.pprint(data)
        count += 1
        if count >= 3:
            break

Result:

{'GPS ground speed': 97.83114326014487,
 'GPS ground true track': 307.4598039853386,
 'Plane altitude': 8501.684970335986,
 'Plane latitude': 39.3924225392898,
 'Plane longitude': -125.57142850592173,
 'Zulu time': 3287.369384765625}
{'GPS ground speed': 97.83704928992589,
 'GPS ground true track': 307.45556123353225,
 'Plane altitude': 8501.840396854732,
 'Plane latitude': 39.39269706474836,
 'Plane longitude': -125.57189141562071,
 'Zulu time': 3288.369384765625}
...

Asynchronous (asyncio):

import asyncio
import pprint

from simcon import Sim, DataField, PERIOD
from simcon.data import types


async def show_data():
    async with Sim("MyApp") as sim:
        data = await sim.request_data_once([
            DataField("ATC ID", None, types.STRING32),
            DataField("Title", None, types.STRING256),
        ])
        pprint.pprint(data)
        data_request = sim.request_data_on_sim_object(
            [
                DataField("HSI station ident", None, types.STRING8),
                DataField("Plane latitude", "degrees"),
                DataField("Plane longitude", "degrees"),
                DataField("Plane altitude", "feet"),
                DataField("GPS ground true track", "degrees"),
                DataField("GPS ground speed", "knots"),
                DataField("Zulu time", "seconds"),
            ],
            PERIOD.SECOND,
        )
        count = 0
        async for data in data_request:
            pprint.pprint(data)
            count += 1
            if count >= 3:
                break

asyncio.run(show_data())

Results will be the same as in the example above

Release History

Yet to release

• Nothing so far

0.6.1

• Always release GIL before calling SimConnect (fixes freezes)

0.6.0

• Fixed event/data cleanup exceptions when stopping
• Fixed iterating over changing dicts when stopping
• Fixed non-asyncio-friendly threading.Lock causing deadlocks (API changed!)

0.5.0

• Added more parameters to data requests:
  • when - either always, or only when the data changes (default: always)
  • origin - periods to wait before first data transmission (default: 0)
  • interval - periods between data transmissions (default: 1, i.e. every period)
  • limit - limit the number of data transmissions (default: 0, i.e. never stop)
• Fixed 32-bit fields alignment

0.4.0

• Wrapped SimConnect failures into OSError instead of a generic RuntimeError
• Sim now stops when the simulator quits.
• Added wait_stop() to wait until Sim stops
• Stop Sim if it failed to start as a context manager

0.3.0

• Added support for strings, integer, and float32 data types
• Added a helper to request data once

0.2.0

• Added start() and stop() methods. All event and data listeners will throw Closed() exception if they are still being awaited when Sim stops, or if it is already stopped when wait() is called.

0.1.0

• Initial release