Serial Port Configuration
Serial Port Configuration Options

The platform offers three serial port configuration capabilities:

  • Force RTS/CTS and DTR to be used or ignored regardless of whether the driver author has provided this capability in their driver. This is useful for some USB serial ports that require particular values of these settings in order to function correctly.
  • Force a COM port to appear in the list of available COM ports even if the Platform auto detect code is unable to see the port.
  • Force a COM port to be omitted from the list of available ports. This can be useful if you just want alimited range of the ports on the PC to show up for selection.

These capabilities are described in the following sections.

Force use of the RTS/CTS or DTR lines for a particular COM port.

The Platform defaults are for RTS/CTS to be disabled and DTR to be enabled. If you have issues with a particular COM port not working and you suspect that this may be due to these defaults they can be changed by adding appropriate entries using Profile Explorer.

  1. Start Profile Explorer
  2. Click the + next to COMPortSettings
  3. Right click on COMPortSettings and click new Key (See Figure 1)
  4. Change the highlighted text to the name of the COM port that you want to control and press ENTER
  5. Click on the key name that you just created to select it in the right hand values / data pane
  6. Click on the white square below the cell that is labeled (Default) and it will turn blue
  7. Type RTSEnable or DTREnable as required and press the TAB key
  8. Now type True or False in the Data cell on the same line as the name you just entered and press ENTER
  9. Repeat for the other setting if required (See Figure 2)

Figure 1: This image shows the new key being created in step 3

COMPort Create Key

Figure 2: This image shows the populated values for the example port COM5 after step 9. For illustration, the DTREnable and RTSEnable values have been swapped to the opposite of their default values. You should pick values that work for you, setting RTSEnable to True is the most likely use of this facility.

COMPort Settings

Force a COM port to appear in the list of available COM ports.

Occasionally, an installed COM port may not be detected by the Platform's GetAvailableCOMPorts command. You can confirm this through the Diagnostics Tool Tools / Available COM Ports test. To force a known COM port to appear in the list, its name should can be placed in the the ASCOM Profile ForceCOMPorts key using Profile Explorer.

  1. Start Profile Explorer
  2. Click the + next to COMPortSettings
  3. Click on the ForceCOMPorts key
  4. Click in the Value column cell next to the grey * at the bottom of the value/data pane.
  5. Type the name of the COM port and press ENTER
  6. Repeat for any other COM ports required(See Figure 3)

Figure 3: This image shows an entry to make the hypothetical port COM99 appear in the list of available ports.

ForceCOMPort

Force a COM port to be omitted from the list of available COM ports.

To force a known COM port to be omitted from the list of available ports, its name should be placed in the the ASCOM Profile IgnoreCOMPorts key using Profile Explorer. After updating the Profile using the steps below you can confirm that the port is no longer listed through the Diagnostics Tool Tools / Available COM Ports test.

  1. Start Profile Explorer
  2. Click the + next to COMPortSettings
  3. Click on the IgnoreCOMPorts key
  4. Click in the Value column cell next to the grey * at the bottom of the value/data pane.
  5. Type the name of the COM port and press ENTER
  6. Repeat for any other COM ports required(See Figure 4)

Figure 4: This image shows an entry to make port COM15 disappear from the list of available ports.

IgnoreCOMPort