4D v14.3

SET CHANNEL

Home

 
4D v14.3
SET CHANNEL

SET CHANNEL 


 

SET CHANNEL ( Schnittstelle ; Parameter ) 
Parameter Typ   Beschreibung
Schnittstelle  Lange Ganzzahl in Wahl der Schnittstelle
Parameter  Lange Ganzzahl in Parameter der Schnittstelle
SET CHANNEL ( Operation ; Dokumentname ) 
Parameter Typ   Beschreibung
Operation  Lange Ganzzahl in Operation für das Dokument
Dokumentname  String in Dokumentname

Der Befehl SET CHANNEL öffnet eine serielle Schnittstelle oder ein Dokument. Sie können immer nur eine serielle Schnittstelle oder ein Dokument gleichzeitig öffnen. Um eine geöffnete serielle Schnittstelle zu schließen, übergeben Sie SET CHANNEL (11).

Historischer Hinweis: SET CHANNEL war ursprünglich der erste Befehl zum Arbeiten mit seriellen Schnittstellen und Dokumenten auf Festplatten. Seither sind neue Befehle hinzugekommen. Heute verwenden Sie für Dokumente auf der Festplatte vorrangig die Befehle Open document, Create document und Append document. Damit können Sie mit Hilfe von Create document oder RECEIVE PACKET Zeichen in bzw. aus Dokumenten ein- bzw. auslesen (Diese Befehle arbeiten auch mit SET CHANNEL). Für die Befehle SEND VARIABLE, RECEIVE VARIABLE, RECEIVE VARIABLE und RECEIVE RECORD können Sie dagegen nur über SET CHANNEL auf Dokumente auf der Festplatte zugreifen.

Die Beschreibung von SET CHANNEL gliedert sich in zwei Abschnitte:

  • Arbeiten mit seriellen Schnittstellen
  • Arbeiten mit Dokumenten

Die erste Syntax des Befehls SET CHANNEL öffnet eine serielle Schnittstelle und definiert das Protokoll sowie weitere Informationen der Schnittstelle. Sie können Daten senden mit SEND PACKET, SEND RECORD oder SEND VARIABLE, bzw. Daten empfangen mit RECEIVE BUFFER, RECEIVE PACKET, RECEIVE VARIABLE oder RECEIVE RECORD.

Schnittstelle wählt die serielle Schnittstelle und das zu benutzende Protokoll. Sie können bis zu 99 serielle Schnittstellen ansprechen (eine zur gleichen Zeit pro Prozess). Folgende Liste zeigt die möglichen Werte für Schnittstelle:

BereichBeschreibung
0COM2 (Windows) ohne Protokoll oder Druckerschnittstelle (Mac)
1COM1 (Windows) ohne Protokoll oder Modemschnittstelle (Mac)
20COM2 (Windows) mit Software Protokoll wie XON/XOFF oder
Druckerschnittstelle (Mac)
21COM1 (Windows) mit Software Protokoll wie XON/XOFF oder
Modemschnittstelle (Mac)
30COM2 (Windows) mit Hardware Protokoll wie RTS/CTS oder
Druckerschnittstelle (Mac)
31COM1 (Windows) mit Hardware Protokoll wie RTS/CTS oder
Modemschnittstelle (Mac)
101 bis 199Serielle Kommunikation ohne Protokoll
201 bis 299Serielle Kommunikation mit Software Protokoll wie XON/XOFF
301 bis 399Serielle Kommunikation mit Hardware Protokoll wie RTS/CTS

Wichtig: Der in Schnittstelle übergebene Wert muss sich auf eine vorhandene COM Schnittstelle beziehen, die Ihr Betriebssystem erkennt. Wollen Sie zum Beispiel die Werte 101, 103 und 125 verwenden, müssen die Schnittstellen COM1, COM3 und COM25 richtig konfiguriert sein.

Die Betriebssysteme erkennen standardmäßig zwei serielle Schnittstellen der Software: unter Windows die Schnittstellen COM1 und COM2, auf Macintosh die Modem- und die Druckerschnittstelle. Sie können natürlich mit Hilfe von zusätzlicher Hardware weitere serielle Schnittstellen hinzufügen. 4D hat ursprünglich nur die o.a. Standard-Schnittstellen unterstützt, nach und nach sind weitere serielle Schnittstellen hinzugekommen. Aus Kompatibilitätsgründen bleiben beide Systeme erhalten.

  • Wollen Sie nur eine Standardschnittstelle zuweisen (COM2 /Drucker oder COM1/Modem), können Sie im Parameter den Wert 0, 1, 20, 21, 30 oder 31 übergeben (das entspricht der alten Funktionsweise von 4D) bzw. einen Wert > 100 (siehe oben).
  • Wollen Sie erweiterte serielle Schnittstellen zuweisen, müssen Sie in Schnittstelle (Zuweisen der n-ten seriellen Schnittstelle) den Wert N+100 übergeben, und diesen noch um 100 oder 200 erhöhen, je nachdem, ob Sie ein Software- oder ein Hardware-Protokoll verwenden.

Für COM2 bzw. die Druckerschnittstelle ohne Protokoll verwenden Sie die Syntax:

 SET CHANNEL(0;param)

oder

 SET CHANNEL(102;param)

Für COM1 bzw. die Modemschnittstelle mit dem Protokoll XON/XOFF verwenden Sie die Syntax:

 SET CHANNEL(21;param)

oder

 SET CHANNEL(201;param)

Für COM25 mit dem Protokoll RTS/CTS verwenden Sie ausschließlich die Syntax:

 SET CHANNEL(325;param)

Mit Parameter wählen Sie die Parameter der Kommunikation: Geschwindigkeit, Anzahl der Bits sowie der Stop-Bits und Parität. Sie legen den Wert für Parameter durch Hinzufügen der unten aufgeführten Werte fest. Wollen Sie z.B. setzen 1200 Baud, 8 Datenbits, 1 Stop-Bit und keine Parität, fügen Sie hinzu: 94 + 3072 + 16384 + 0 = 19550. In Parameter setzen Sie dann 19550 ein.

Hinzuzufügende WerteBeschreibung
für Parameter

Geschwindigkeit
380 300
(in Baud) 189 600
941200
62 1800
46 2400
30 3600
22 4800
14 7200
10 9600
4 19200
228800
138400
0 57600
1022115200
1021230400
Anzahl Datenbits0 5
2048 6
1024 7
3072 8
Anzahl Stop-Bits 16384 1
–32768 1.5
–16384 2
Parität0 Keine
4096 Ungerade
12288Gerade


Tipp: Die verschiedenen Werte zum Akkumulieren und zur Übergabe in den Parametern Schnittstelle und Parameter (mit Ausnahme der Werte für COM1...COM99) sind in der Designumgebung im Explorer Fenster als vordefinierte  Konstanten unter dem Thema Kommunikation verfügbar. Für COM1...COM99 verwenden Sie numerische Entsprechungen.

Die zweite Syntax von SET CHANNEL erstellt, öffnet und schließt ein Dokument. Sie können jedoch im Gegensatz zu den Befehlen im Kapitel Systemdokumente nur ein Dokument zur gleichen Zeit öffnen. Das Dokument kann aus- oder eingelesen werden.

Mit Operation legen Sie fest, was mit dem in Dokument festgelegten Dokument ausgeführt wird. Nachfolgende Tabelle zeigt die für Operation und Dokument zugelassenen Werte und die daraus resultierende Operation.

Operation Dokument Ergebnis

10
AlphanumerischÖffnet das alphanumerische Dokument.
Gibt es das Dokument nicht, wird es erstellt
und geöffnet.
10 "" (alphanum. leer) Zeigt das Dialogfenster Datei öffnen zum
Öffnen einer Datei an.
Alle Datentypen werden angezeigt.
11 nichts Schließt eine geöffnete Datei.
12 "" (alphanum. leer) Zeigt das Dialogfenster Datei sichern zum
Erstellen einer neuen Datei an.
13 "" (alphanum. leer) Zeigt das Dialogfenster Datei öffnen zum
Öffnen einer Datei an.
Nur Textdateien werden angezeigt.

Wollen Sie z.B. ein Dialogfenster Datei öffnen anzeigen, um eine Textdatei zu öffnen, schreiben Sie folgende Programmierzeile:

 SET CHANNEL(13;"")

Alle hier aufgelisteten Operationen setzen bei Bedarf die Systemvariable Document. War die Operation erfolgreich, hat die Systemvariable OK den Wert 1, ansonsten den Wert 0.

Siehe Beispiele für die Befehle RECEIVE BUFFER, SET TIMEOUT und RECEIVE RECORD.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Kommunikation
Nummer: 77

Dieser Befehl ändert die Systemvariable OKDieser Befehl ändert die Systemvariable Document

 
GESCHICHTE 

Erstellt: < 4D v6

 
SIEHE AUCH 

Append document
Create document
GET SERIAL PORT MAPPING
Kommunikation
Open document
RECEIVE BUFFER
RECEIVE PACKET
RECEIVE RECORD
RECEIVE VARIABLE
SEND PACKET
SEND RECORD
SEND VARIABLE
SET TIMEOUT

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)