|
|
|
|
|
sOpen (Function) In french: sOuvre Opens and initializes: - a serial port.
- a parallel port.
- an infrared port. In this case, only the second syntax is available.
The default values are as follows: - Transfer rate: 9600 Bauds
- Parity: None
- 8 data bits
- 1 stop bit
// Open IR1 (using the port name) IR1 = sOpen("IR1", 2000, 2000) IF IR1 <> 0 THEN // Configure IR1 sParameter(IR1, 9600, 1, 8, 1) // Rest of process... // Close IR1 sClose(IR1) ELSE Error("Error while opening IR1") END Syntax
Opening and initializing a port by specifying its name Hide the details
<Result> = sOpen(<Port name> , <Size of input buffer> , <Size of output buffer> [, <Timeout>])
<Result>: Integer - Identifier of open port. This identifier can be used in the functions for managing ports.
This identifier corresponds to:- the number of the relevant serial port: 1, 2, 3, ... 256 for COM1, COM2, COM3, ... COM256.
- the number of the relevant parallel port: -1, -2, -3 or -4 for LPT1, LPT2, LPT3 or LPT4.
- the number of the relevant infrared port: 1, 2, 3, ... 256 for IR1, IR2, IR3, ... IR256.
- 0 if an error occurs.
<Port name>: Character string Name of relevant port: - Name of serial port::
- COM1, COM2, COM3, ... COM256.
Serial port number in Linux (for example /dev/ttyS1).
- Name of parallel port: LPT1, LPT2, LPT3 or LPT4.
- Name of infrared port: IR1, IR2, ... IR256.
<Size of input buffer>: Integer Size of input buffer in bytes (up to 32768). <Size of output buffer>: Integer Size of output buffer in bytes (up to 32768). <Timeout>: Optional integer Duration (expressed in milliseconds) for reading or writing a character. If <Timeout> is set to 1s when writing 1024 bytes, the waiting time will be 1024s. This parameter is used to avoid a lock when a read or write problem occurs on the print port. - if <Timeout> is negative, the waiting time will be constant. For example, if <Timeout> time is set to "-1s" when reading 1024 bytes, the waiting time will be 1s.
- When <Timeout> has expired, the read or write function returns 0.
- The default value of this parameter is defined at system level.
The sDefaultTimeout constant allows you to use the default timeout. This parameter can be: - an integer corresponding to the number of milliseconds,
- a Duration variable,
- the duration in a readable format (e.g., 1 s or 10 ms).
Remarks Operating mode - A port cannot be opened if this port was not closed properly.
- Important: A port must be opened by sOpen before it can be configured by sParameter.
- WLanguage does not allow you to manage the control signals.
- Two computers send each other characters via a port: if the second computer calls sOpen once the characters have been sent by the first computer, these characters are ignored.
Remarks: The following entries of the registry return the list of serial ports and parallel ports:- "HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM" for the serial ports.
- "HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\PARALLEL PORTS" for the parallel ports.
Business / UI classification: Business Logic
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|