open_io_channelT_open_io_channelOpenIoChannelopen_io_channelOpenIoChannelOpenIoChannel (Operator)

Name

open_io_channelT_open_io_channelOpenIoChannelopen_io_channelOpenIoChannelOpenIoChannel — Öffnen und Konfigurieren von I/O-Übertragungskanälen.

Signatur

open_io_channel( : : IODeviceHandle, IOChannelName, GenParamName, GenParamValue : IOChannelHandle)

Beschreibung

Der Operator open_io_channelopen_io_channelOpenIoChannelopen_io_channelOpenIoChannelOpenIoChannel öffnet und konfiguriert Übertragungskanäle einer geöffneten I/O-Geräteinstanz. Die Geräteinstanz muss zuvor von open_io_deviceopen_io_deviceOpenIoDeviceopen_io_deviceOpenIoDeviceOpenIoDevice erzeugt worden sein und wird dem Parameter IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle übergeben. Die Übertragungskanäle selbst werden durch ihre Namen in IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelName adressiert. Die vom Gerät unterstützten Namen können mit Hilfe des Operators query_io_devicequery_io_deviceQueryIoDevicequery_io_deviceQueryIoDeviceQueryIoDevice über den Parameter 'io_channel_name'"io_channel_name""io_channel_name""io_channel_name""io_channel_name""io_channel_name" abgefragt werden. Die Kanäle können über die Parameter GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue konfiguriert werden. Es wird eine Instanz jedes Übertragungskanals erzeugt, deren Referenzen in IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandle zurückgegeben werden. Falls die Instanz eines Kanals nicht mehr benötigt wird, sollte sie über den Operator close_io_channelclose_io_channelCloseIoChannelclose_io_channelCloseIoChannelCloseIoChannel freigegeben und geschlossen werden. Sie wird automatisch geschlossen, wenn die mit dem Kanal zusammenhängende Geräteinstanz über close_io_deviceclose_io_deviceCloseIoDeviceclose_io_deviceCloseIoDeviceCloseIoDevice geschlossen wird.

Mit einem geöffneten Übertragungskanal können schließlich die Werte vom Gerät mit Hilfe der Operatoren read_io_channelread_io_channelReadIoChannelread_io_channelReadIoChannelReadIoChannel und write_io_channelwrite_io_channelWriteIoChannelwrite_io_channelWriteIoChannelWriteIoChannel gelesen und geschrieben werden.

Ein bereits geöffneter Kanal kann über die Operatoren set_io_channel_paramset_io_channel_paramSetIoChannelParamset_io_channel_paramSetIoChannelParamSetIoChannelParam und get_io_channel_paramget_io_channel_paramGetIoChannelParamget_io_channel_paramGetIoChannelParamGetIoChannelParam rekonfiguriert werden.

Eine ausführliche Beschreibung aller gerätespezifischen Parameter findet sich in der Dokumentation für die verwendete I/O-Schnittstelle im Verzeichnis 'doc/html/reference/io'"doc/html/reference/io""doc/html/reference/io""doc/html/reference/io""doc/html/reference/io""doc/html/reference/io".

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

IODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandleIODeviceHandle (input_control) io_device → (integer)

Referenz auf das geöffnete I/O-Gerät.

IOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelNameIOChannelName (input_control) string(-array) → (string)

I/O-Kanalnamen.

GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control) string-array → (string)

Generische Parameternamen.

Defaultwert: []

GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control) string-array → (string / integer / real)

Generische Parameterwerte.

Defaultwert: []

IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandle (output_control) io_channel(-array) → (integer)

Referenzen auf die geöffneten I/O-Übertragungskanäle.

Beispiel (HDevelop)

query_io_device (IODeviceHandle, [], 'io_channel_names.digital_output', ChannelOutputNames)
open_io_channel (IODeviceHandle, ChannelOutputNames[0], [], [], IOChannelHandle)
write_io_channel (IOChannelHandle, 1, Status)

Ergebnis

Der Operator open_io_channelopen_io_channelOpenIoChannelopen_io_channelOpenIoChannelOpenIoChannel liefert den Wert 2 (H_MSG_TRUE), wenn die Parameterwerte gültig waren und die Kanäle für das Gerät geöffnet werden konnten. Ansonsten wird eine Fehlerbehandlung durchgeführt. In diesem Fall kann vom Interface eine zusätzliche Fehlerinformation gesetzt werden, die mit get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfo abgefragt werden kann.

Vorgänger

open_io_deviceopen_io_deviceOpenIoDeviceopen_io_deviceOpenIoDeviceOpenIoDevice, query_io_devicequery_io_deviceQueryIoDevicequery_io_deviceQueryIoDeviceQueryIoDevice

Nachfolger

set_io_channel_paramset_io_channel_paramSetIoChannelParamset_io_channel_paramSetIoChannelParamSetIoChannelParam, read_io_channelread_io_channelReadIoChannelread_io_channelReadIoChannelReadIoChannel, write_io_channelwrite_io_channelWriteIoChannelwrite_io_channelWriteIoChannelWriteIoChannel

Modul

Foundation

Operatoren