Skip to content

Feature request: Manual RTS/DTR control in GUI #934

Closed

Description

@quasarsuport-del

Summary
Currently, Tera Term allows controlling RTS and DTR lines only via TTL macros (setrts and setdtr) or through hardware flow control options. There is no way to toggle these lines manually from the graphical user interface (GUI).

Problem
When working with serial devices (e.g., embedded boards, modems, or programmers), users often need to manually assert or deassert RTS and DTR lines to reset, boot, or signal external hardware. Using macros for this purpose is inconvenient for quick manual testing.

Suggested solution
Add a simple GUI control (e.g., in the Setup → Serial port… dialog or in the Control menu) to manually toggle RTS and DTR lines:

  • Checkboxes or toggle buttons labeled “RTS” and “DTR”.
  • Visual indication of current state (on/off).
  • Option to keep them fixed or revert to automatic control when hardware flow control is enabled.

Benefits

  • Easier manual testing and debugging of hardware interfaces.
  • Removes the need to write or run macros for basic control.
  • Improves usability and parity with similar serial terminal tools.

Thank you for considering this feature!

Activity

  1. added theissue type on Oct 28, 2025
  2. added this to the 5.6.0 milestone on Dec 19, 2025
  3. hkanou commented on Dec 19, 2025

    @hkanou
    Member

    Thank you for your suggestion.
    I submitted a PR to add the following to the Serial Port tab:

    • Ability to configure RTS and DTR flow control
    • Ability to toggle RTS and DTR assert/deassert

    The binaries for verification are stored at the following location:
    https://github.com/TeraTermProject/teraterm/actions/runs/20379426009

  4. nmaya commented on Dec 26, 2025

    @nmaya
    Member

    見てみました。ありがとうございます。

    確認です。
    CTS, DSR, RING, RLSD の表示はリアルタイムではなく、ダイアログ表示時点の値ですよね。(違ったらリアルタイムに変更してください、といっているわけではありません)

    また、シリアルポートについての知識が乏しいのですが、教えてください。
    「RTS / DTR のダイアログ表示時点の設定を表示する」と「フロー制御の設定を変更する」をこのダイアログでできるようになると思います。
    「RTS / DTR の設定」というのは、今までの setrts, setdtr マクロコマンドで変更することができたものだと思います。
    フロー制御方法「Disable / Enable / Handshake / Toggle」とはどんなものでしょうか?

  5. hkanou commented on Dec 29, 2025

    @hkanou
    Member

    確認頂きありがとうございます。

    CTS, DSR, RING, RLSD の表示はリアルタイムではなく、ダイアログ表示時点の値ですよね。

    0.1秒間隔で情報取得/更新を行っていますが、CTS、DTRの値はかなり頻繁にhigh/lowが切り替わるためリアルタイムとはいえず、目安として見られるくらいのものです。

    フロー制御方法「Disable / Enable / Handshake / Toggle」とはどんなものでしょうか?

    下記のような感じで、https://learn.microsoft.com/ja-jp/windows/win32/api/winbase/ns-winbase-dcb の fRtsControl のパラメタになります。

    Disable   常にlow
    Enable    常にhigh
    Handshake 受信可能な場合にhigh
    Toggle    送信時にhigh
    

    マニュアルの説明を追加するよう見直しいたします。
    また、Toggle指定時の表示のhigh/lowが逆になっていましたので、こちらも修正いたします。

  6. hkanou commented on Dec 29, 2025

    @hkanou
    Member

    47c5acf で下記の修正を行いました。

    • RTSのフロー制御でToggle指定時の表示がhighになっていた誤りを修正
    • ラジオボタンをチェックボックスに変更
    • マニュアルの説明を追加

    動作確認用のバイナリの格納先は以下のとおりです。
    https://github.com/TeraTermProject/teraterm/actions/runs/20573749123

  7. nmaya commented on Dec 29, 2025

    @nmaya
    Member

    解説ありがとうございます。

    目安として見られる

    なるほど、わかりやすいですね。ありがとうございます。

    fRtsControl のパラメタ

    いままでマクロでは変更することができなかった設定値がある(マクロでは今も)ということですね。

    レイアウトについて、今のものでもわかるので参考意見です。
    今のレイアウトはコンパクトに収まっていてよいと思いますが、初見時に上からなめていって設定できないCTSが出てきたので「あれ?」という感じになりました。
    「上の "Port" から『設定項目のラベル』が並んでいる」のと、「6種の簡易モニタがあり、そのうち「RTS」「DTR」はユーザ設定でき」ます。「新設された設定項目 fRtsControl / fDtrControl のラベル」と、「GetCommState() / SetCommState() の項目 RTS / DTR の表示 / 設定」が兼用されているためと分析します。

  8. quasarsuport-del commented on Dec 30, 2025

    @quasarsuport-del
    Author

    Thank you very much for incorporating my changes into the project. Great work, and thanks for the quick response!

  9. hkanou commented on Dec 31, 2025

    @hkanou
    Member

    いままでマクロでは変更することができなかった設定値がある(マクロでは今も)ということですね。

    ご認識のとおりです。
    fRtsControl、fDtrControlを個別に設定するのは、今回の要望や半2重で接続したい時くらいでレアケースなように思われます。(マクロはリクエストがあったらの対応でも良いかなと思っています)

    今のレイアウトはコンパクトに収まっていてよいと思いますが、初見時に上からなめていって設定できないCTSが出てきたので「あれ?」という感じになりました。

    ご指摘ありがとうございます。
    RTS と DTR で設定名と表示名を兼用していること、チェックボックスをインジケータとして使用していることのためわかりづらくなってしまっています。
    良い表示方法を思いついたら見直しさせて頂きます。

  10. hkanou commented on Dec 31, 2025

    @hkanou
    Member

    Thank you very much for incorporating my changes into the project.

    Thank you for confirming that it works.
    Please let us know if you notice anything.

  11. hkanou commented on Jan 4, 2026

    @hkanou
    Member

    PR #1014 をメインにマージさせて頂きました。
    本 issue をクローズさせて頂きます。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions