Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

This Article describes the Settings to configure the Connection between custo diagnostic and Cosmed Omnia.

Requirements

Minimum Version are:

custo diagnostic: 4.5.x
cosmed Omnia: 1.4

Functionality

The current Interface has the following Functionality:

  1. The Selection of the Patient or the Order has to be done in custo diagnostic.
  2. The System can be run in two different Operation Modes:
    1. COSMED Omnia (master), custo diagnostic does not control the Training Device
    2. COSMED Omnia (slave), custo diagnostic control the Training Device
  3. The CPET Examination can be terminated in custo diagnostic OR in Cosmed Omnia.
  4. The Recall of an Evaluation can be done only throught custo diagnostic.

Settings in custo diagnostic

For the perfect operation you have to set up the following options:

  1. Select Cosmed Omnia as CPET Software in the Interface Selection
    Please compare also with the Types of the Interface
    Image Added

  2. Enable necessary Dialogues to ask the Customer for required Data
    For the Operation of Cosmed Omnia the Weight and Height of the Patient is mandatory!
    You have to enable these Options:
    Image Added

  3. Enable PDF-Grabbing
    The PDF Grabbing import the PDF into the Evaluation which is printed from Cosmed Omnia as Report while the Test.
    Image Added

  4. If custo diagnostic should make a Printout after the Examination you have to enable 'PDF attachments'. This Option add the via PDF Grabbing imported PDFs (Printouts) from Cosmed Omnia to the normal Printout of custo diagnostic. If you want to export these PDFs to the HIS you have to switch the 'Printout Type' to the Option 'PDF Export' and than enable in this Printout Type the Option 'PDF attachments'.
    Image Added
     

  5. Configure the LoginUserName and LoginPassword from Cosmed Omnia
    The Login Credentials are mandatory because its a part of the TCP/IP Communication.
    Image Added

  6. Configure the Program Name of Cosmed Omnia
    This Program will be started if you launch a CPET Test in custo diagnostic.
    Image Added

Settings in Cosmed Omnia

  1. Install Cosmed Omnia (min. Version 1.4) on the PC

  2. Start Cosmed Omnia the first Time and make it running

  3. Activate the TCP/IP Interface in the File "\%PUBLIC%\Documents\Cosmed\CosmedLab\ACS.XML". The File exists only you had start Cosmed Omnia one times. After that you have to edit the File manually.

    Code Block
    languagexml
    <ExtendedConfiguration Version="1">
      <General>
        <TimeOutMinCheckValue Type="System.Int32" Value="15" />
        <MenuMatrix Type="Tuple" TypeID="System.Int32" ID="2" TypeValue="System.Int32" Value="3" />
      </General>
      <EntityFramework>
        <SessionTimeout Type="System.Int32" Value="60" />
        <MaxRetryCount Type="System.Int32" Value="5" />
        <MaxDelay Type="System.Int32" Value="26" />
      </EntityFramework>
      <Bridge>
        <Debugger Type="System.Boolean" Value="True" />
        <Control Type="Tuple" TypeID="System.String" ID="tcp" TypeValue="System.String" Value="xml" TypeItem2="System.String" Item2="utf-8" TypeItem3="System.String" Item3="5530" TypeItem4="System.String" Item4="OmniaXB" />
        <Legacy Type="Tuple" TypeID="System.String" ID="legacy" TypeValue="System.String" Value="raw" TypeItem2="System.String" Item2="ascii" TypeItem3="System.String" Item3="" TypeItem4="System.String" Item4="" />
      </Bridge>
      <Ergo>
        <ShowDataOnProtocolChart Type="System.Boolean" Value="True" />
      </Ergo>
    </ExtendedConfiguration>

     To activate the Communication via TCP/IP you have to insert this Line inside the Section <Bridge>:

    Code Block
    languagexml
        <Control Type="Tuple" TypeID="System.String" ID="tcp" TypeValue="System.String" Value="xml" TypeItem2="System.String" Item2="utf-8" TypeItem3="System.String" Item3="5530" TypeItem4="System.String" Item4="OmniaXB" />
    

    Please be careful that only one Line of the Type <Control> in the Section <Bridge> exists.

     

  4. Start Cosmed Omnia
    Login as an Administrator. You can use these Credential also in the Configuration in custo diagnostic.
    With the Patient "DEMO SUBJECT" every time a Test can be performed.

  5. Configure the Device K5
    Image Added

  6. Start a test once time and select 'PC Software ECG' as HR Source and 'Ergoline900' as the bike. This is only possible after you had selected the Device K5!

    Image Added

 

Anchor
Types of the Interface
Types of the Interface
Types of the Interface

In custo diagnostic → Settiungs → System → Workstation
Image Added
the Type of Interface to Cosmed Omnia can be selected. This is comparable to an Operation Mode. The Selection is described as View from custo diagnostic.

SelectionOperation Mode

COSMED Omnia (slave)

Cosmed Omnia: do not control the Training Device
custo diagnostic: control the Training Device

...

Die Anbindung an das Spirometrieprodukt Omnia von der Firma Cosmed ist ab der custo diagnostic Versoin 4.5 möglich.
com.atlassian.confluence.macro.MacroExecutionException: Problem authenticating. Please check your username and password and try again.

 
die aktuell Omnia-Version 1.6.1 Stadalone ist hier \\ms-server\Projekte\Winprog\Projekte\Spiroergomterie\Omnia zu finden.
Protokolle:

ToDo's/Probleme

  • Der Austausch der Kennungen einer Auswertung (Test) funktioniert nicht immer zuverlässig. 
  • Wir können nicht zwischen Ergometer und Laufband unterscheiden.1. Omnia sendet keinerlei Kennung was gerade abläuft2. selbst wenn, das ist uns zu spät, denn die Ergometrie muß es ziemlich frühzeitig wissen was für ein Gerät gesteuert wird. Lösung: im SartingTest-Kommando erhalten wird die Info, PJ muß dann einen neuen Aufruf erhalten, das er dann seinen Darstellung dynamisch umschaltet  

 

Funktionsweise

Die aktuelle Implementierung der Schnittstelle sieht vor:

  1. Patienten resp. Auftragsauswahl erfolgt in custo diagniostic
  2. custo diagostic steuert kein Gerät 
  3. nach erscheinen des EKG's in custo diagnostic wird alles weitere in Omnia gemacht. Dazu erscheint nach 6 Sek., ( einstellbar) dort der Dialog zur Konfiguration der Messung ( Make, Profil, usw. )
  4. Die laufenden Messung kann sowohl in custo diagnostic als auch in Omnia beendet werden.5 Sekunden ( einstellbar) nach dem in Omnia die Messung beendet worden ist, wird trickreich versucht die Kennung der neuen Messung/Auswertung zu ermitteln 
  5. Die Darstellung einenr gemeinsamen Messung kann nur in custo diagnostic gemacht werden.Außer da bei Omnia die gleiche Auswertung aufgerufen wird, wird sonst nichts bzgl. der Kommunikation zwischen den beiden Produkten gemacht.  

 

Einstellungen bei custo diagnostic

Für den einwandfreien Betrieb müssen folgen Einstellungen getroffen werden:

  1. Auswahl vom Comsmed Omnia als Spirometriesoftware Image Removed  
  2. notwendige Datenabfrage-Dialoge aktivieren Image Removed  Für den Betrieb an Omnia ist es zwingend notwendig das der Patienten ein Gewicht und einen Größe hat.
  3. PDF-Grabbing Image Removed  Ist notwendig, damit der PDF-Ausdruck von Omnia in unsere CST-Datei vermerkt wird
  4. PDF-Ausdruck/Export Image Removed  
  5. Anmeldedaten/Logindaten für Omnia !worddav094d354205fe0d9c43478ae42e56d52c.png|height=196,width=624!Sind notwendig, da die Kommunikation das Anmelden mit einschließt
  6. Programmname vom Omnia !worddav4df288c02891d479e106d68d26a853e1.png|height=402,width=624!Das hier eingestellte Programm wird von custo aufgerufen, die Voreinstellung ist meistens passen 

 

Einstellungen Omnia 

  1. Die Verison 1.4 von Omnia muß auf dem PC installiert werden (hier zu finden \\ms-server\Projekte\Winprog\Projekte\Spiroergomterie\Omnia ). 
  2. In der ACS.XML Datei unter %PUBLIC%\Documents\Cosmed\CosmedLab muß die TCP/IP Schnittstelle aktiviert werden. Dazu muß das Programm Omnia mindestens einmal aufgerufen und beendet werden. Danach  kann die Datei manuell editiert werden.
  3. <?xml version="1.0" encoding="UTF-8"?>
  4. <ExtendedConfiguration Version="1">
  5. <General>
  6. <TimeOutMinCheckValue Type="System.Int32" Value="15" />
  7. <MenuMatrix Type="Tuple" TypeID="System.Int32" ID="2" TypeValue="System.Int32" Value="3" />
  8. </General>
  9. <EntityFramework>
  10. <SessionTimeout Type="System.Int32" Value="60" />
  11. <MaxRetryCount Type="System.Int32" Value="5" />
  12. <MaxDelay Type="System.Int32" Value="26" />
  13. </EntityFramework>
  14. <Bridge>
  15. <Debugger Type="System.Boolean" Value="True" />
  16. <Control Type="Tuple" TypeID="System.String" ID="tcp" TypeValue="System.String" Value="xml" TypeItem2="System.String" Item2="utf-8" TypeItem3="System.String" Item3="5530" TypeItem4="System.String" Item4="OmniaXB" />
  17. <Legacy Type="Tuple" TypeID="System.String" ID="legacy" TypeValue="System.String" Value="raw" TypeItem2="System.String" Item2="ascii" TypeItem3="System.String" Item3="" TypeItem4="System.String" Item4="" />
  18. </Bridge>
  19. <Ergo>
  20. <ShowDataOnProtocolChart Type="System.Boolean" Value="True" />
  21. </Ergo>

</ExtendedConfiguration>
<Bridge>
<Debugger Type="System.Boolean" Value="True" />
<Control Type="Tuple" TypeID="System.String" ID="tcp" TypeValue="System.String" Value="xml" TypeItem2="System.String" Item2="utf-8" TypeItem3="System.String" Item3="5530" TypeItem4="System.String" Item4="OmniaXB" />
</Bridge>
Um die Kommunikation über TCP/IP zu aktivieren, muss zwingend die Zeile 
eingefügt werden. Bitte darauf achten, das in der Sektion Bridge nur ein Eintrag von Typ <Control>  existiert.
 

  1.  COSMED Omnia startenAnmelden als Admin evtl. muß das Passwort jetzt eingegeben werden, bitte merken, denn es muß auch in die Einstellungen von custo diagnostic übernommen werden.Über die Datenbank kann immer der Patienten DEMO SUBJECT  gewählt werden wenn einen Messung zu machen ist 
  2. Das Gerät K5 konfigurieren   Image Removed
  3. Einmalig eine Messung starten und als HF-Quelle 'PC Software ECG' und Ergometer 'Ergoline900' wählen.Das geht nur, wenn zuvor das Gerät K5 ausgewählt wurde!       Image Removed
  4.  

 

Liste der Einstellungen für die Anbindung

Unter Einstellungen -> System ->Arbeitsplatz
          Image Removed
kann die jeweilige Anbindung an Cosmed ausgewählt werden.Hierbei sind zwei unterschiedliche "Betriebsmodi" auswählbar, die Auswahl ist immer aus Sicht von custo diagnostic system zu sehen.  

Auswahl

Funktionsweise

COSMED Omnia (slave)

Omnia: Zeigt nur an, steuert NICHT
diagnostic system: Ergometersteuerung

COSMED Omnia (master)
ehemals  
COSMED Omnia

Cosmed Omnia:

Ergometersteuerung

control the Training Device
custo diagnostic

system: Zeigt nur an, steuert NICHT

 
 

spezielle Einstellungen in custo diagnostic

: do not control the Training Device


Special Settings in custo diagnostic

These internal Setting you can find in CSC->DatenDie (speziellen) Einstellungen für die Anbindung an Omnia ist unter im Einstellungseditor unter Daten-Export\CosmedOmnia zu finden. Folgende Einstellungen existieren. These Settings are available:

Einstellung
Setting
Voreinstellung

Default Value

Beschreibung

Description

AutostartOmniaDebugMonitor

falsch

startet den Monitor DialogDarin ist jede einzel Zuckung von custo diagnostic in Echtzeit nachzuvollziehen 

false

Starts a Debug Monitor Dialogue when the Communication is established. In this every Action / Reaction will be recorded during a Communication (Test) in Real Time.

AutostartOmniaProgram

false

Starts the Cosmed Omnia Main Program if custo diagnostic ist started. Otherwise the Cosmed Omnia Program ist started not until the customed has select CPET in custo diagnostic.

AutostartOmniaProgram

falsch

 

HostAddress

127.0.0.1

ist die

The TCP/IP

Adresse. Voreinstellung ist der eigenen PC, denn meistens laufen die beiden Programm am gleichen PC

Address to Cosmed Omnia (PC). Default Setting is the local Address of the PC. Often the two Programms are running on the same PC.

Port

5530

TPC Port

unter der das Omnia Programm zu erreichen ist

(Cosmed Omnia) for the TCP/IP Connection

LogonPassword

 

Ist das Passwort des bei Omnia anzumeldenden Benutzers

<empty>

Password of the Cosmed Omnia User

LogonUserName

 

<empty>

Name of the Cosmed Omnia User

Ist das name des bei Omnia anzumeldenden Benutzers

ProgramFullName

C:\Program Files (x86)\COSMED\Omnia\CosmedLab.exe

ist der vollständige Programmname des zu startenden Programmes

Path an Name of the Cosmed Omnia Programfile

PostTestCommandDelaySeconds

5

Ist die Wartezeit bei custo die nach der Ende der Messung abgewartet wird, bevor die Liste des Auswertungen (Tests) des aktuellen Patienten angefordert wird. Dies ist notwendig, denn Omni kann nicht unmittelbar nach Ende der Messung die Liste des Auswertungen (Tests) des aktuellen Patienten liefern, der befehl wird mit NACK beantwortet und steht dann auch als Fehlermeldung in der Error.log
omniacommunicator.cpp, 205   COmniaCommunicator NACK from Omnia for command 21 <SetRealTimeInfo>
Ist dies der Fall, dann muß evtl. die Wartezeit erhöht werden. Allerdings ist das nicht immer zielführend! Wenn bei Omnia nach Ende der Messung noch eine Benutzeraktion stattfindet, z.B. das Einholen der Bestätigung um Änderungen in den Einstellung zu speichern, dann wird so lange der Anwender nicht irgendeinen Taste drückt, der Befehl von uns immer mit NACK beantwortet. Dagegen ist leider noch kein Kraut gewachsen

StartTestCommandDelaySeconds

6

Ist die Wartezeit bei custo die mindestens vergeht bevor bei Omnia der Start-Dialog aufgerufen wird. Dies ist notwendig, da bei Omni der Start-Befehl erst dann verarbeitet wird, wenn die richtige Bildschirmmaske auf den Bildschirm ist und das braucht meisten 2-4- Sek. Zeit

TcpConnectionMaxRetryCount

6

gibt an wie oft maximal versucht werden soll die TCP/IP Verbindung aufzubauen.Erfahrungsgemäß gelingt nach einem Programmstart vom Omnia nicht immer auf Anhieb die Verbindung aufzubauen, daher können hier mehrer Versuche durchaus Hilfreich sein