FAQ TWedge

Wie werden Daten zum Eingabegerät gesendet?

TWedge V2

Lösung: Für diesen Zweck bietet TWedge die JavaScript Funktion WriteToDevice () an. Diese Funktion akzeptiert zwei Parameter:

• Der erste Parameter gibt an, welche Daten zum Gerät gesendet werden.
• Der zweite Parameter gibt das Timeout (in Millisekunden) für diese Operation an.

Das folgende Beispiel sendet zwei Zeilen Text (die erste Zeile fordert das Gerät auf den Usernamen zu akzeptieren, die zweite Zeile sendet den Usernamen an das Gerät). Jede Zeile schließt mit einem Zeilenumbruch ab \n).

WriteToDevice ("user\n", 1000);
WriteToDevice ("sysadmin\n", 1000);

TWedge V3

Lösung: Für diesen Zweck bietet TWedge die JavaScript Member-Funktion WriteData () an. Diese Funktion gibt es in zwei Varianten mit unterschiedlichen Parametern:

• Integer WriteData (Array arrData, Integer nTimeout)
• Integer WriteData (String sData, Integer nTimeout, String sEncoding = "Latin1")

Das folgende Beispiel sendet einmal die Daten als Binär-Array und einmal als String (Zeichenkette). In der Stringvariante können Sie mit der Escape-Folge \n einen Zeilenumbruch kodieren.

var arrSend = [0x48, 0x65, 0x6c, 0x6c, 0x6f]; 
hConn.WriteData (arrSend, 200);

hConn.WriteData ("Hello\n", 1000);

Das Eingabegerät ignoriert alle Kommandos

Warum werden alle Kommandos von dem Eingabegerät ignoriert?

Lösung: Wenn die Funktion WriteToDevice () (bzw. WriteData ()) zum Senden von Konfigurations- oder Startkommandos verwendet wird, überprüfen Sie bitte, ob Zeilenumbrüche notwendig sind. Das ist besonders dann wichtig, wenn das Gerät ein Protokoll wie TELNET verwendet. Ein Zeilenumbruch wird mit der Escapesequenz \n angegeben.

Das folgende Beispiel sendet den Text "user" - gefolgt von einem Zeilenumbruch - an das Gerät:

// TWedge 2:
WriteToDevice ("user\n", 1000);

// TWedge 3:
hConn.WriteData ("user\n", 1000);

Hier ist eine Liste mit den gebräuchlichsten Escapesequenzen:

• \' Einfaches Anführungszeichen.
• \" Doppeltes Anführungszeichen. Verwenden Sie diese Escape-Sequenz, wenn Sie es als Teil eines Zeichens angeben.
• \\ Ein einfaches Backslash Zeichen.
• \b Backspace.
• \n Zeilenvorschub (Line Feed).
• \r Wagenrücklauf (Carriage Return). In DOS Systemen wird ein Zeilenumbruch üblicherweise durch die Zeichenkombination \r (Wagenrücklauf) und \n (Zeilenvorschub) kodiert. Meistens reicht aber auch ein \n (statt \r\n).
• \t Horizontaler Tabulator.
• \f Seitenvorschub (für Drucker).

Das USB-Gerät verliert die Verbindung, wenn es längere Zeit nicht benutzt wird

Problem: Mein USB-Gerät (mit virtuellem COM-Anschluss) verliert die Verbindung, wenn es eine längere Zeit nicht benutzt wird.

Die Energieverwaltung ist eine häufige Ursache für Probleme mit USB-gesteuerten Geräten. Um Strom zu sparen, schaltet Windows die Stromversorgung der USB-Ports automatisch ab. Dies kann zu Problemen mit Zusatzgeräten und dadurch zu einem Verlust der Verbindung führen, wenn Sie Ihr Gerät längere Zeit nicht benutzen.

Workaround: Hier sind einige Maßnahmen, welche Sie Schritt für Schritt ausprobieren können, bis dieses Problem nicht mehr auftritt:

a) Verhindern, dass Windows USB-Geräte ausschaltet.

1. Öffnen Sie den Gerätemanager, indem Sie auf Start klicken und im Suchfeld Gerätemanager eingeben.
2. Im Gerätemanager erweitern Sie den Bereich Universal Serial Bus Controllers, Doppelklick auf das Gerät USB Root Hub und wählen Sie Energieverwaltung aus.
3. "Dem Computer erlauben, Geräte auszuschalten, um Strom zu sparen" deaktivieren, indem Sie das Häkchen bei der Checkbox entfernen.
4. Mit dem OK-Button bestätigen.

b) Motherboard: Falls Ihr BIOS die Einstellung 'Deep Sleep Control' hat, dann deaktivieren Sie es.

c) "hybrid sleep option" deaktivieren (falls möglich):

• Gehen Sie in den Systemeinstellungen unter Energieverwaltung 🡒 Standardeinstellungen ändern 🡒 Erweiterte Energieeinstellungen ändern 🡒 Ruhezustand 🡒 "Allow hybrid sleep" und setzen Sie es auf AUS.

d) "USB selective suspend" deaktivieren (falls möglich):

• Gehen Sie in den Systemeinstellungen unter Power options -> Change plan settings 🡒 Change advanced power settings 🡒 USB-Einstellungen 🡒 "Selective suspend" und deaktivieren Sie es.

Keyboard Wedge funktioniert nicht, wenn TWedge als Dienst läuft

Problem: Sogenannte Dienste werden als separater Prozess ausgeführt, ohne dass eine Benutzersitzung angeschlossen ist, somit kann Windows nicht erkennen, wohin die Tastenanschläge gesendet werden sollen.

Lösung: Sie können versuchen, ob die Einstellung “Erlauben Sie dem Dienst die Interaktion mit dem Desktop” einen Unterschied ausmacht, üblicherweise kann die Tastenanschlagsimulation aber nicht verwendet werden, wenn TWedge als Dienst läuft.

Workaround: Schreiben Sie in eine CSV-Datei (siehe Aktionsvorlagen). Der Dateiname könnte auf dem aktuellen Datum basieren, damit Sie jeden Tag eine neue Datei erhalten (erfordert eine kleine Änderung im Skript). CSV-Dateien können auch in Excel geöffnet werden.

Wo finde ich eine detaillierte Bedienungsanleitung zu TWedge?

• Sie können das zusammen mit TWedge installierte Handbuch mit dem Hilfe-Menü in TWedge (F1) öffnen.
• Sie können das Handbuch auch im Dokumentations-Bereich der TWedge-Downloadseite herunterladen.
• Die Skript-Referenz kann mithilfe des Buttons [Script Reference] am unteren Rand des Skript-Editors (CTRL-E) geöffnet werden.

SHIFT-Taste wird nicht als Tastenanschlag gesendet

Problem: Während dem Lesen von einem HID Gerät erscheint eine über SendKeyStroke(..) gesendete SHIFT-Taste (oder ein anderer Modifier) nicht als Tastenanschlag.

Lösung: Senden Sie die SHIFT-Tastenkombination etwas verzögert - siehe Beispiel-Code unten:

SetDelayCharacter ("#");
SetDelayTime (200);
if ( !SendKeyStrokes ("#{SHIFT+F7}"))
  NotifyWarning("Ignoring keystrokes sent to TWedge. Please set focus to the target application.");

Wie kann ich eine Dezimalzahl (Zahl mit Kommastellen) zu einer ganzen Zahl konvertieren?

Mein Gerät gibt 123,4 aus, ich brauche aber nur 123

Modifizieren Sie das Script im OnData Event Code (Ctrl - E). Ersetzen Sie die Codezeilen durch folgendes:

TWedge V2

var myData = Math.round(DATA).toFixed();
SendKeyStrokes(myData);

TWedge V3

var myData = DataToString(data);
myData = Math.round(myData).toFixed();
SendKeyStrokes(myData);

Dieser Code übernimmt die Rundung. Wenn Sie keine Rundung benötigen, ersetzen Sie Math.round durch Math.floor.

Meine Waage sendet Gramm, ich benötige aber Kilogramm

Modifizieren Sie den OnData Event Code durch folgendes:

TWedge V2

var myData = (parseInt(DATA)/1000).toFixed(3);
SendKeyStrokes(myData);

TWedge V3

var myData = DataToString(data);
myData = (parseInt(myData)/1000).toFixed(3);
SendKeyStrokes(myData);

Wie kann man Daten in einer Schleife lesen, ohne StartListen zu verwenden?

Nehmen wir an, Sie möchten von zwei Skripten aus auf einen bestimmten COM-Anschluss (nacheinander) zugreifen, können ihn aber nur von jeweils einem Skript aus öffnen. Sie können StartListen() nicht verwenden, da dies den Port die ganze Zeit über belegt, solange die Datenerfassung aktiv ist.

Im Folgenden zeigen wir Ihnen, wie Sie den Port öffnen, Daten synchron lesen und dann den Port wieder schließen, damit das andere Skript auf den Port zugreifen kann.

hConn2.Open(funcOnConnectionLost2);

var arr2Data = null;
retries2 = 60; // wait maximum 1 minute for data (60 * 1000 ms)
while (retries2-- > 0)
{
  try
  {
    Print ("Waiting for data from " + hConn2.Port);
    
    var currData = hConn2.ReadData(100, 1000); // try to read max 100 Bytes in 1 sec
   
    if (arr2Data == null)
      arr2Data = currData; // first data packet
    else
      arr2Data.concat(currData); // subsequent data packet -> append
  }
  catch (err)
  {
    // stop when we have data already (no data packet after successful read) 
    if (arr2Data != null)
      break;
  }
}

processData2 (arr2Data);
  
if (hConn2.IsOpen)
  closeConnection2();    

Wie verwendet man eine zweite Tastenkombination in Twedge?

Sie können eine weitere Tastenkombination wie folgt erstellen:

1. Öffnen Sie das Javascript Edtior (CTRL-E)
2. Kopieren Sie die bestehende Hotkey-Funktion (am Ende des Skripts) und benennen Sie es in onHotKey2 um

function onHotkey2 ()
{
  Print("onHotkey2! ");
}

3. Registrieren Sie die Funktion onHotkey2 für eine bestimmte Tastenkombination (z. B. F8) am Anfang des Skripts (nach dem generierten Skriptblock):

hInstance.RegisterHotkey("F8", onHotkey2); 

4. Wenn Sie F8 drücken, sollte die zweite, neu hinzugefügte Funktion aufgerufen werden.

COM Ports auf Citrix/Terminal Server

Problem: TWedge verbindet sich zum Server, nicht zum Client

Lösung: Sie müssen den COM Port des Clients einem virtuellen COM Port am Server zuweisen. Das wird als COM Port Weiterleitung bezeichnet.

Fehlermeldung "Zugriff verweigert" beim Starten von Twedge

Problem: Beim Starten von TWedge erhalten Sie die Fehlermeldung "Datei 'C:\ProgramData\TEC-IT\TWedge\3.5\twedge.bcopt' kann nicht gespeichert werden. Zugriff verweigert."

Lösung: Überprüfen Sie die Berechtigungen für das TWedge-Verzeichnis und die bcopt-Datei für das Benutzerkonto, bei welchem das Problem auftaucht.

C:\ProgramData\TEC-IT\TWedge\3.5

Die BCOPT-Datei speichert die Fenster-Einstellungen von TWedge. Das Startbenutzerkonto von TWedge muss Lese-/Schreibrechte für diese Datei haben.