set_serial_param [HALCON Operator-Referenz / Version 13.0.4]

set_serial_paramset_serial_paramSetSerialParamset_serial_paramSetSerialParamSetSerialParam — Setzen der Parameter eines seriellen Gerätes.

Signatur

Herror set_serial_param(const Hlong SerialHandle, const Hlong BaudRate, const Hlong DataBits, const char* FlowControl, const char* Parity, const Hlong StopBits, const Hlong TotalTimeOut, const Hlong InterCharTimeOut)

Herror T_set_serial_param(const Htuple SerialHandle, const Htuple BaudRate, const Htuple DataBits, const Htuple FlowControl, const Htuple Parity, const Htuple StopBits, const Htuple TotalTimeOut, const Htuple InterCharTimeOut)

Herror set_serial_param(const HTuple& SerialHandle, const HTuple& BaudRate, const HTuple& DataBits, const HTuple& FlowControl, const HTuple& Parity, const HTuple& StopBits, const HTuple& TotalTimeOut, const HTuple& InterCharTimeOut)

void HSerial::SetSerialParam(const HTuple& BaudRate, const HTuple& DataBits, const HTuple& FlowControl, const HTuple& Parity, const HTuple& StopBits, const HTuple& TotalTimeOut, const HTuple& InterCharTimeOut) const

void SetSerialParam(const HTuple& SerialHandle, const HTuple& BaudRate, const HTuple& DataBits, const HTuple& FlowControl, const HTuple& Parity, const HTuple& StopBits, const HTuple& TotalTimeOut, const HTuple& InterCharTimeOut)

void HSerial::SetSerialParam(const HTuple& BaudRate, const HTuple& DataBits, const HString& FlowControl, const HString& Parity, const HTuple& StopBits, const HTuple& TotalTimeOut, const HTuple& InterCharTimeOut) const

void HSerial::SetSerialParam(Hlong BaudRate, Hlong DataBits, const HString& FlowControl, const HString& Parity, Hlong StopBits, Hlong TotalTimeOut, Hlong InterCharTimeOut) const

void HSerial::SetSerialParam(Hlong BaudRate, Hlong DataBits, const char* FlowControl, const char* Parity, Hlong StopBits, Hlong TotalTimeOut, Hlong InterCharTimeOut) const

void HOperatorSetX.SetSerialParam( [in] VARIANT SerialHandle, [in] VARIANT BaudRate, [in] VARIANT DataBits, [in] VARIANT FlowControl, [in] VARIANT Parity, [in] VARIANT StopBits, [in] VARIANT TotalTimeOut, [in] VARIANT InterCharTimeOut)

void HSerialX.SetSerialParam( [in] VARIANT BaudRate, [in] VARIANT DataBits, [in] BSTR FlowControl, [in] BSTR Parity, [in] VARIANT StopBits, [in] VARIANT TotalTimeOut, [in] VARIANT InterCharTimeOut)

Beschreibung

Mit set_serial_paramset_serial_paramSetSerialParamset_serial_paramSetSerialParamSetSerialParam können die Parameter eines seriellen Gerätes gesetzt werden. Der Parameter BaudRateBaudRateBaudRateBaudRateBaudRatebaudRate gibt die Ein- und Ausgabegeschwindigkeit des Gerätes an. Es ist zu beachten, dass nicht jedes Gerät alle Geschwindigkeiten unterstützt. Die Anzahl der übertragenen Datenbits wird mit DataBitsDataBitsDataBitsDataBitsDataBitsdataBits festgelegt. Der Parameter FlowControlFlowControlFlowControlFlowControlFlowControlflowControl legt fest, ob und welche Art von Datenflusskontrolle verwendet werden. Software-Kontrolle ('xon_xoff'"xon_xoff""xon_xoff""xon_xoff""xon_xoff""xon_xoff") und Hardware-Kontrolle ('cts_rts'"cts_rts""cts_rts""cts_rts""cts_rts""cts_rts", 'dtr_dsr'"dtr_dsr""dtr_dsr""dtr_dsr""dtr_dsr""dtr_dsr" können gewählt werden. Mehrere Werte können hierfür innerhalb einer Zeichenkette gesetzt werden, durch Leerzeichen getrennt (z.B. 'cts_rts dtr_dsr'"cts_rts dtr_dsr""cts_rts dtr_dsr""cts_rts dtr_dsr""cts_rts dtr_dsr""cts_rts dtr_dsr"). Ob und welche Art von Paritätskontrolle der übertragenen Daten verwendet wird, lässt sich mit ParityParityParityParityParityparity festlegen. Die Anzahl der übertragenen Stop-Bits kann mit StopBitsStopBitsStopBitsStopBitsStopBitsstopBits gesetzt werden. Schließlich können noch zwei Timeouts für das Lesen von dem seriellen Gerät gesetzt werden. Der Parameter TotalTimeOutTotalTimeOutTotalTimeOutTotalTimeOutTotalTimeOuttotalTimeOut bezieht sich auf die Zeit, die bei read_serialread_serialReadSerialread_serialReadSerialReadSerial bis zum Eintreffen des ersten Zeichens, unabhängig von der Anzahl der insgesamt zu lesenden Zeichen, höchstens vergehen darf. Der Parameter InterCharTimeOutInterCharTimeOutInterCharTimeOutInterCharTimeOutInterCharTimeOutinterCharTimeOut gibt die Zeit an, die zwischen dem Lesen einzelner Zeichen verstreichen darf, falls mehrer Zeichen mit read_serialread_serialReadSerialread_serialReadSerialReadSerial gelesen werden sollen. Falls einer der beiden Timeouts auf -1 gesetzt wird, so wird beliebig lange auf das Eintreffen eines Zeichens gewartet. Werden beide Timeouts auf 0 gesetzt, wartet das System nicht, sondern liest die vorhandenen oder keine Zeichen. Auf Windows-Systemen ergibt sich so ein maximaler Timout von TotalTimeOutTotalTimeOutTotalTimeOutTotalTimeOutTotalTimeOuttotalTimeOut + n InterCharTimeOutInterCharTimeOutInterCharTimeOutInterCharTimeOutInterCharTimeOutinterCharTimeOut, wenn n Zeichen gelesen werden sollen. Auf unixartigen Systemen kann systembedingt nur einer der beiden Timeouts gesetzt werden. Wenn beide Timeouts größer als -1 übergeben werden, wird nur der Total-Timeout beachtet. Die Einheit der beiden Timeouts ist Millisekunden. Es ist jedoch zu beachten, dass der Timeout unter unixartigen Systemen nur in Zehntelsekundenschritten spezifizieren lässt, d.h. der minimale wirksame Timeout ist 100. Für jeden dieser Parameter kann die aktuelle Einstellung beibehalten werden, indem 'unchanged'"unchanged""unchanged""unchanged""unchanged""unchanged" übergeben wird.

Parallelisierung

Parameter

SerialHandleSerialHandleSerialHandleSerialHandleSerialHandleserialHandle (input_control, Zustand wird modifiziert) serial_id → (integer)

Handle der seriellen Schnittstelle.

BaudRateBaudRateBaudRateBaudRateBaudRatebaudRate (input_control) integer → (integer / string)

Übertragungsgeschwindigkeit der seriellen Schnittstelle.