PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Miscellaneous
  • Opening and initializing an infrared port by specifying its name (syntax 2)
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Opens and initializes:
  • a serial port.
  • a parallel port.
  • an infrared port. In this last case, the second syntax must be used.
The default values are as follows:
  • Transfer rate: 9600 Bauds
  • Parity: None
  • 8 data bits
  • 1 stop bit
Remarks:
    Windows Mobile Caution: In order for sOpen to operate, "Receive all incoming beams" must be unchecked on the Pocket PC used. To display this option:
    • Select "Start .. Parameter".
    • Display the "Connection" tab.
    • Click the "Send" icon.
    Windows Mobile
    // Open COM1 (using the port number)
    LineCom1 = sOpen(1, 2000, 2000)
    IF LineCom1 = True THEN
    // Configure COM1: Rate 9600, even parity,
    // 8 data bits, 1 stop bit
    sParameter(1, 9600, 1, 8, 0)
    // Rest of process...
    // Close COM1
    sClose(1)
    ELSE
    Error("Error while opening COM1")
    END
    // 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 number Hide the details

    <Result> = sOpen(<Port number> , <Size of input buffer> , <Size of output buffer> [, <Timeout> [, <Managing events>]])
    <Result>: Boolean
    • True if the port was opened and initialized,
    • False otherwise.
    <Port number>: Integer
    Number of relevant port:
    • Number of serial port: 1, 2, 3, ... 256 for COM1, COM2, COM3, ... COM256.
    • Number of parallel port: -1, -2, -3 or -4 for LPT1, LPT2, LPT3 or LPT4.
    <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 or optional Duration
    Duration (expressed in milliseconds) allocated for reading or writing a character.
    This parameter is used to avoid a lock when a read or write problem occurs on the print port.
    • 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 correspond to:
    • an integer corresponding to the number of milliseconds,
    • a Duration variable,
    • Versions 23 and later
      the direct indication of duration (1 s or 10 ms for example).
      New in version 23
      the direct indication of duration (1 s or 10 ms for example).
      the direct indication of duration (1 s or 10 ms for example).
    <Managing events>: Optional boolean
    • True to detect the events on the serial port,
    • False (default value) to avoid managing the events. These events can be managed by sEvent.

    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
    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 occurred.
    <Port name>: Character string with quotes
    Name of relevant port:
    • Name of serial port: COM1, COM2, COM3, ... COM256.

    • 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) allocated for reading or writing a character. This parameter is used to avoid a lock when a read or write problem occurs on the print port.
    • 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 correspond to:
    • an integer corresponding to the number of milliseconds,
    • a Duration variable,
    • Versions 23 and later
      the direct indication of duration (1 s or 10 ms for example).
      New in version 23
      the direct indication of duration (1 s or 10 ms for example).
      the direct indication of duration (1 s or 10 ms for example).
    Remarks

    Miscellaneous

    • 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.
    Windows Mobile

    Opening and initializing an infrared port by specifying its name (syntax 2)

    The use of an infrared port opened by sOpen corresponds to the simulated use of a serial port. This simulation does not operate properly on some Pocket PCs.
    To open an infrared port, we recommend that you use SocketConnectInfrared and SocketCreateInfrared. Therefore, the infrared port is using the IRDA protocol. This protocol is more reliable and faster for managing the IRDA-compatible devices (Pocket PCs, printers, cell phones, ...).
    Remark: However, sOpen must be used to communicate with devices that are not IRDA-compatible (TV for example).
    Business / UI classification : Business Logic
    Component : wd250com.dll
    Minimum version required
    • Version 9
    This page is also available for…
    Comments
    Click [Add] to post a comment