motion simulator DIY community

From X-SIM DIY motion simulator community - international wiki

MainPage | X-SIM 2.0 Manual | Projects | Tutorials | Forum 

Contents

X-Sim 2.0 documentation

X-Sim is the short synonym for Cross Simulator software. It is a software suitable for most selfmade or comercial simulators. The most interresting part would be the big support for every game usable with it. Because every game developer will implement another method of exporting the ingame realtime values like g-forces, speeds or the selected gear, it is very importand to know about the different export types. On this page they are all explained and the Sender2 software owns plugins and tools for users which want to get a new game working with this software package. If you are a programmer you can use that defined interface for your own software and profit from the game support.
 

Force-Sender2


Image:Sender2-main-3d.gif


If no control software is given the second part of X-Sim2 will be interresting for you. The Profiler2 will control your hardware with unlimited axis/actuator support. The synaptrix can handle non intelligent interfaces like the printerport to control pneumatic, hydraulic and electric actuator systems. The software itself becomes therefore like a realtime system which is able to solve measurement and motion control. The profiler will help you to control more than a 6DOF platform and make it possible to add other actuators to a realistic simulator like a air speed hardware addon with simple fans to simulate the car speed in a open car. You can break the limits of any other solutions on the market. Also the Profiler2 is able to do some input value scaling and serial export with a Universal Serial Output prsaer system. This will output the current target value as a simple byte to the serial port where a intelligent actuator system is placed.

Force-Profiler2


Image:Profiler2-main-3d.gif

Setup solutions


Image:Pneuicon.gifImage:Hydricon.gif Image:Elecicon.gif Image:Usoicon.gif


As a big differnce to the first x-sim version X-Sim2 will support gauge dashboards and inrace result viewer in many solutions. Therefore the ingame car and race values are resized and transfered to a user selected gauge system. New is also the graphical desktop dashboard solution to use a normal computer monitor to show up all car or flight instruments. Also this values can be transfered to a hardware gauge system or to a interface which controls such a hardware.

As a big differnce to the first x-sim version X-Sim2 will support gauge dashboards and inrace result viewer in many solutions. Therefore the ingame car and race values are resized and transfered to a user selected gauge system. New is also the graphical desktop dashboard solution to use a normal computer monitor to show up all car or flight instruments. Also this values can be transfered to a hardware gauge system or to a interface which controls such a hardware.

X-Sim2 Gauge dashboard system


Image:Pointer3small.gif

How a simulator control will work and which software part of X-Sim2 will do it?


Image:Profiler2-main-structo-original.gif

First a software is needed which will get the simulation game force values. Sometimes the game will only support native exports like speed or Microsoft DirectX Force Feedback signals. This values has to be captured and send to a control software. This part the Force-Sender2 will do with it’s plugin system and tool software like Yoda2 and Force-Injector. This software is the first one which is able to collect all the information parallel and is able to mix them to a simulator output. Normaly only the lateral, longitudinal and vertical forces are used in a simulator, but now you can also mix special event’s like curp detection in your output result.

After the values are collected, they are send as “raw” values with unknown size to the Force-Profiler2 which will resize and convert them to a minimum and maximum movement on a connected actuator system. This can be one axis of a 6DOF system or a simple fan which simulates the air speed of a car. The second part of the Profiler2 is to transfere the results to a actuator system with serial RS232/RS485 port support or direct control a actuator hardware in realtime if the used interface is not a intelligent hardware which should has a input/output PID control. The last part of the Profiler2 will control gauge dashboards with the values given by the game plugins which can be mounted to a simulator system. The game detection finally will stop your simulator if you have finished your race or flight.





Why X-Sim2 should use two computers for a simulator setup?


This table shows you the standard configuration of a X-Sim2 simulator control setup:
Image:Generalsetting.png


To reduce the proccessor usage of the game pc and to insure a correct realtime control the control PC is excluded over a network. If you do not have a paralell working intelligent interface it is highly recommended to use a second PC for a fast aquisition time. If a game would slow down the regulating process of your interface the actuator will not stop at the wished position. If you are using a multicore system you are able to isolate the profiler work on a single core in the program setup. This will also insure a fast control task with your interface.


Programmer Section

The X-Sim project offers some unified interface plugins for all the games or hardware it will use, To simplify the handling with the different game developer ingame value readout solutions, someone can use parts of X-Sim in it’s own simulator software. Here you will find some good stuff to make addons for the x-sim software or to write own software which is able to read ingame values. The goal of x-sim is to help others making good software for simulation games.

Writing desktop gauges or software which needs input out of x-sim
This part would be the easiest, because X-Sim is using simple MMF files to publish the gauge section to other programs

Writing a math plugin for the math setup of the Profiler 2.x application
Here you will find a detailed information how a math addon can be programmed. With a math plugin you are able to get the last mathline and transform the result to your wishes. With a dialog you are able to implement a user interaction.

Writing a new interface plugin for the Profiler 2.x
If you own knowlege about a interface that you would like to use in the synaptrix or direct output setup, you are able to add a self written plugin here. The plugins are self detecting drivers of a hardware. Mostly this should be a USB device or a serial RS232 compatible hardware with type and serialnumber detection.

Writing a game plugin for the force-sender application.
New games need sometimes a new type of game plugin. If the force-injector cannot be used, because many updates wil destroy your work, you are able to implement a game plugin which will use a game developer solution for that work. This could be a network readout or a memory mapped file readout.The plugin must support a ingame start detection and the export of some simulator relevant values. It is also highly wished to increase the value readout of existing plugins!

You will find the sample sourcecode in the x-sim directory /other stuff/sourcecode


Command line parameter

To program a automation menu or some sequence with the x-sim software, each application uses parameter after its exe call.

Force Sender2:

  • ”send”
  • ”playermode”
  • ”myconfigfile.fsd”

All parameter are inserted behind a exe file without the “-” or “ . The send command will press the “try to send” button of the sender main dialog after a application startup. The playermode is special for the video plugin and is used on a double click on a video plugin config file.

Samples:

c:>Force-Sender.exe send only press the “try send” button c:>Force-Sender.exe flatout.fsd loads the flatout.fsd file and start the “play” button


Force Profiler2:

It is only possible to attach the .rn2 file after the exe filename.

Sample: c:>Profiler.exe flatout.rn2 loads the flatout.rn2 setup file


Yoda force feedback scanner:

  • “miminize”
  • “start”
  • “filter”
  • “myexportfile.yef”

The filter function will be good for the final scan export usage. Normaly all that options are controlled by the sender. Only if you are using that software in your own profiler, you have to know about the command line parameters.


Video Plugin 2.x

Here you can only attach the fsm file which will be loaded by the plugin. Insure the video file is in the same directory.


MainPage | X-SIM 2.0 Manual | Projects | Tutorials | Forum 

Site Toolbox:

Personal tools
This page was last modified on 24 April 2009, at 15:32. - This page has been accessed 10,810 times. - Disclaimers - About X-SIM DIY motion simulator community - international wiki