                         CMRKCTRL.DLL
                         ============

Pour une description en Franais, voir la deuxime partie de ce document.
------------------------------------------------------------------------

Here is a "BETA" version of the interface controller DLL for CATrain, designed
for the Mrklin Digital(c) system.
Since this  DLL has not yet been tested in all modes with a 
genuine Mrklin 6051 control unit, this "shareware" is provided "as is", 
without any warranty of functioning.
The only retribution requested to the "Beta testers" is a test report with
the encountered problems and some suggestions.

Some advises:

- To install CMRKCTRL.DLL, you just have to copy this file in the directory
where CATRAIN.EXE is located. Than, the file "CATRAIN.INI" must be edited
to substitute the command line CTRLCOM=CDUMCTRL.DLL with the line
CTRLCOM=CMRKCTRL.DLL in the[DLL] paragraph.

- The Baud-Rate of the serial line (by default COM2) must be set to 2400 BD
for the communication with the 6051 Mrklin Controller.

- In case of problems encountered for controlling the "mechanical" devices
or during the train circulation, it is possible to modified some parameter
default values by adding the following lines inside the [PARAMETERS] 
paragraph of CATRAIN.INI:


  The following line defines the pulse duration for the command of an
  electromechanical device: (default 216 ms)

CTRLPERIOD=216

  The following line defines the period for the polling of the feed-back
  information:  (default 648 ms)

POLLPERIOD=648

  The following line defines the maximum tolerated time for a loss of
  synchronisation between the model and the feed-back information provided
  about train location: (default 10 seconds)

SYNCTIMEOUT=10

  The following line defines the rail distance that a train must cross before
  that the previously occupied block (rail section) is liberated and the 
  corresponding signal is set to Red. (default 3 rails).

SECTFREEDIST=3

  The following lines define the rail distance before the lowering and after
  the raising of the level crossing barriers.

LCROSSDETECT=7
LCROSSLEAVE=2

  The following line defines the slope incidence on the electrical power
  applied to the loco engine: (default 2)

SLOPEINCIDENCE=2

The "Tracing" functionality of CATrain permits to visualize in a file the
traffic exchanged between the computer and the 6051 control unit.
This file is named "Ctrl.trc".

The command sent to the general power switch is 96 for "GO" and 97 for "STOP".

The license agreement for using and distributing CMRKCTRL.DLL are identical
to the license agreement applicable to CATRAIN.
Under no circumstances will Joel Bouchat be liable for damages arising
from the use of this software.

==============================================================================


Voici une version "BETA" du contrleur d'interface pour CATrain, conu 
pour le systme Mrklin Digital(c).
Comme le DLL n'a pu encore pu tre test dans toutes les conditions
d'utilisation en liaison avec une vritable unit de contrle Mrklin 6051
et ses accessoires, ce "shareware" est livr en l'tat, sans garantie,
 l'intention des "Beta testeurs" volontaires ...
L'unique rtribution demande est l'envoi d'un rapport de test sur les
dysfonctionnements plus ou moins graves constats et les solutions et
amliorations proposes.

Quelques conseils:

- Pour installer CMRKCTRL.DLL il suffit que ce programme soit prsent
dans le rpertoire o CATRAIN.EXE est install, et que ce DLL soit
rfrenc dans CATRAIN.INI en lieu et place de CDUMCTRL.DLL par la
ligne de commande:

[DLL]
CTRLCOM=CMRKCTRL.DLL

- Le Baud-Rate de la ligne srie (par dfaut COM2) doit tre fix
 2400 BD pour l'interface  Mrklin  6051.

- En cas de problmes de contrle des lments "mcaniques" ou de 
synchronisation des trains. Il est possible de modifier certains paramtres
par dfaut en insrant quelques ligne de commandes dans le paragraphe
[PARAMETERS] de CATRAIN.INI:

  La ligne suivante dfinit la longueur de l'impulsion de contrle d'un
  lment lectromagntique (par dfaut 216 ms):

CTRLPERIOD=216

  La ligne suivante dfinit la priode de "polling" des informations
  de rtrosignalisation (par dfaut 648 ms):

POLLPERIOD=648

  La ligne suivante dfinit le temps maximum de dsynchronisation tolr
  entre le modle informatique et les informations fournies par les units
  de rtrosignalisation sur la position relle des trains:
  (par dfaut 10 secondes)

SYNCTIMEOUT=10

  La ligne suivante dfinit la distance (en voies) parcourue par le
  modle d'un train avant la libration du tronon prcdemment occup et la
  mise au rouge du signal correspondant:
  (par dfaut 3 voies)

SECTFREEDIST=3

  Les lignes suivantes dfinissent les distances (en voies) pour l'abaissement
  et le relevage des barrires d'un passage  niveau:

LCROSSDETECT=7
LCROSSLEAVE=2

  La ligne suivante dfinit l'incidence du degr des pentes et des ctes sur
  la commande lectrique des moteurs des locos: (par dfaut 2)

SLOPEINCIDENCE=2

La fonction de "Trace" de CATrain permet de visualiser dans un fichier 
appel ""Ctrl.trc", le trafic chang entre l'ordinateur et l'unit 6051.

La commande du relais gnral d'alimentation est 96 pour "GO" et 97 pour
"STOP".

Les conditions d'utilisation et de distribution de ce logiciel CMRKCTRL.DLL
sont identiques  celles du logiciel principal CATrain.

En aucune circonstance Jol Bouchat ne pourra tre tenu  pour responsable 
des dommages qui pourraient dcouler de l'utilisation de ce logiciel.



