GET SERIAL PORT MAPPING

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 2004


GET SERIAL PORT MAPPING (numArray; nameArray)

ParameterTypeDescription
numArrayNumber arrayArray of port numbers
nameArrayString arrayArray of port names

Description

The GET SERIAL PORT MAPPING command returns two arrays, numArray and nameArray, containing the serial port numbers and the serial port names of the current machine.

This command is useful under Mac OS X, where the operating system dynamically allocates the port number when using a USB serial adapter. You can address any extended serial port using its name (static), regardless of its actual number.

Note: This command does not return meaningful values with standard ports. If you want to address a standard port, you must pass its value (0 or 1) directly using the SET CHANNEL command (former operation of 4D).

Example

This project method can be used to address the same serial port (without protocol), regardless of the number that has been assigned to it:

   ARRAY TEXT($arrPortNames;0)
   ARRAY LONGINT($arrPortNums;0)
   C_LONGINT($vPortNum)

      `Find out the current numbers of the serial ports
   GET SERIAL PORT MAPPING($arrPortNums;$arrPortNames)
   $vPortNum:=Find in array($arrPortNames;vPortName)
      ` vPortName contains the name of the port to be used; it may come from a dialog box, 
      ` a value stored in a field, etc.
   If ($vPortNum>0)
      SET CHANNEL($vPortNum+100; params)  `params contains the communication parameters
         `Don't forget to add 100 to the number since it is an extended port
   End if
   ...   `Carry out the desired operations
   SET CHANNEL(11)     `Closing of port

See Also

SET CHANNEL.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next