Configure Application mode for a serial port

Application mode provides access to the serial device from Python applications.

To change the configuration to match the serial configuration of the device to which you want to connect:

  1. Choose the management interface you want to use to access your device. Click a dropdown for instructions.

    1. Log in to Digi Remote Manager.

    1. Navigate to the device's dashboard.

    Log in to your device's Web UI.

    Log in to your device's Admin CLI via an SSH client, Telnet client, or terminal emulator.

  2. Configure the settings.

    1. Click to open the device's configuration menu.

      • In Digi Remote Manager, on the device dashboard, click Settings > Serial.

      • In the Web UI, there are two ways to access your serial ports from the navigation menu:

        Serial Configuration

        On the dashboard page, in the navigation menu, click Serial Configuration.

        The Serial Configuration page displays.

        Device Configuration > Serial

        On the dashboard page, click Device Configuration > Serial.

        The Serial page displays.

        Note Both pages access the same configuration and are just alternate views of the same information. Any changes made on one page are automatically reflected in the other page.

    2. Click to expand the menu of the serial port you want to work with.

      3. The serial port is enabled by default. To disable, toggle off Enable.

    3. For Serial mode, select Application. The default is Remote Access.

    4. Enable Altpin to use the Altpin feature. Altpin is disabled by default. If you enable Altpin in EIA-232 mode, the DCD and DSR signals are swapped. This allows use of DCD with 8-wire cables. Altpin has no impact on 422 or 485 mode. For more information, see Serial connector pinout.

    5. (Optional) For Label, enter a label that will be used when referring to this port.

    6. For Signaling, select the electrical signaling interface type used on this serial port:

      • RS-232. This is the default.
        • Enable RTS Toggle if you want to enable RTS toggling during transmission on this serial port. If enabled, this setting overrides RTS\CTS flow control.
        • For RTS Pre-delay, enter the amount of time RTS is asserted before starting data transmission. The time is measured in milliseconds. The default is 0ms.
        • For RTS Post-delay, enter the amount of time RTS is deasserted before completing data transmission. The time is measured in milliseconds. The default is 0ms.
      • RS-422
        • Enable Termination if you want to enable electrical termination on this serial port.
      • RS-485
        • Enable Termination if you want to enable electrical termination on this serial port.
        • Enable Full Duplex if you want to enable full duplex communication on this serial port.

        • Enable Four Wire (or Four-Wire Communication) if you want to enable four-wire communication on this serial port. This option is disabled by default.

    7. Click Apply to save the configuration and apply the change.

    1. At the CLI prompt, type config and then press Enter.

    2. The serial port is enabled by default. To disable:
      (config)> serial port1 enable false
(config)>
    3. Set the mode:
      (config)> serial port1 mode application
(config)>

    4. Enable Altpin to use the Altpin feature. Altpin is disabled by default. If you enable Altpin in EIA-232 mode, the DCD and DSR signals are swapped. This allows use of DCD with 8-wire cables. Altpin has no impact on 422 or 485 mode. For more information, see Serial connector pinout.

      (config)> serial port1 altpin true
(config)>

    5. Set the signaling interface type used on this serial port:

      • rs -232. This is the default.
        • Enable rts_toggle if you want to enable RTS toggling during transmission on this serial port. If enabled, this setting overrides RTS\CTS flow control:
          (config)> serial port1 rts_toggle true
(config)>
        • For rts_pre_delay, enter the amount of time RTS is asserted before starting data transmission. The time is measured in milliseconds. The default is 0ms:
          (config)> serial port1 "rts_pre_delay value
(config)>
        • For rts_post_delay, enter the amount of time RTS is deasserted before completing data transmission. The time is measured in milliseconds. The default is 0ms:
          (config)> serial port1 rts_post_delay value
(config)>
      • rs -422
        • Enable Termination if you want to enable electrical termination on this serial port.
      • rs -485
        • Enable termination if you want to enable electrical termination on this serial port:
          (config)> serial port1 termination true
(config)>
        • Enable full_duplex if you want to enable full duplex communication on this serial port:
          (config)> serial port1 full_duplex true
(config)>

        • Enable four_wire if you want to enable four-wire communication on this serial port. This option is disabled by default.

          (config)> serial port1 four_wire true
(config)>
    6. (Optional) Set a label that will be used when referring to this port.
      (config)>path-paramlabel label
(config)>
    7. Save the configuration and apply the change.
      (config)> save
Configuration saved.
>
    8. Type exit to exit the Admin CLI.

      Depending on your device configuration, you may be presented with an Access selection menu. Type quit to disconnect from the device.