Skip to content

シリアル送信時のデータドロップの軽減検討 #1000

Closed

Description

@zmatsuo

シリアル通信時、大量送信時のデータのドロップを軽減すること検討するPRです。

送信サイズを制限して送信パフォーマンスを落とします。
すぐにmainにマージする変更ではなく、
BSoDが出る環境や
Tera Term 5からファイルを送信すると受信に失敗する場合に
対応できるのではないか、検討するのが目的です。

テストできる方のご意見をいただければありがたいです。

シリアルの送信

Tera Termのシリアル送信はOverLappeded I/Oを使っていますが、
WriteFile()後すぐWaitForSingleObject()するので
事実上送信が完了するまでブロックしています。

シリアルの初期化と送信は次のようになっています。

初期化 CommResetSerial() commlib.c

  • SetupComm()で送受信バッファサイズを設定 164行目
    • 受信バッファサイズ=16384 byte (旧8192)
    • 送信バッファサイズ=4096 byte (旧2048)
    • 設定直後設定サイズを確認してみた
      • GetCommProperties() で取得
      • 受信バッファサイズ=16384 byte
      • 送信バッファサイズ=0 byte

送信 CommSend() commlib.c

  • 送信サイズを決定
    • OS内の送信バッファ内の残りサイズを取得 1071行目
      • ClearCommError(,&stat) の stat.cboutque
      • 実際は常に 0
    • 送信サイズ最大を決める 1085行目
      • 設定したつもりの送信バッファ(4096) - 残りサイズ(Stat.cbOutQue)
      • 実際は常に 4096
    • 送信サイズ = max(Tera TermT内の送信バッファ残りサイズ,送信サイズ最大)
  • WriteFile()で、データを送信
    • TeraTerm内の送信バッファ内のデータを上記の送信サイズ 1034行目
    • WaitForSingleObject(,1000) で 1000msブロック(送信完了までブロック) 1036行目
    • タイムアウト時、データは次回送信

送信時の概要
Image

PRの内容

1回の送信リクエスト(WriteFile())の送信サイズを制限して
送信パフォーマンスを下げて、受信側の不可を下げます。

commlib.c の CommWriteLimit の値を変更してビルドすると制限を変更できます。
デフォルトでは制限なしで従来通りです。

効果

手もとの環境はシリアル対向2ポートとも同じドライバです。

Device Friendly Name: USB Serial Port (COM5)
Device Instance ID: FTDIBUS\VID_0403+PID_6001+AI05V0K5A\0000
Device Manufacturer: FTDI
Provider Name: FTDI
Driver Data: 10-28-2024
Driver Version: 2.12.36.20
Class: Ports

(com0com等仮想comポートではうまくテストできないかもしれません。)

921600 BPSでzmodemの送信を行いました(受信側はTera Term 5.5.0です)。

制限なし
15KB/s

制限1byte
3KB/s

drop_send.drawio

Activity

  1. nmaya commented on Dec 12, 2025

    @nmaya
    Member

    接続デバイスがなくテストに協力できません。すみません。

  2. hkanou commented on Dec 14, 2025

    @hkanou
    Member

    ありがとうございます。
    CommWriteLimit の値を小さくすることで送信パフォーマンスを下げることが出来ることを確認致しました。

    ファイル送信のスループット
    
    CommWriteLimit    819200 bps     460800 bps     38400 bps
    ==========================================================
      0               77.14 KB/s     44.78 KB/s     3.76 KB/s
    ----------------------------------------------------------
      1                1.88 KB/s                    1.91 KB/s
      2                3.74 KB/s                    3.51 KB/s
      3                5.64 KB/s                    3.76 KB/s
      4                7.50 KB/s                    3.76 KB/s
      8               14.30 KB/s
     16               26.38 KB/s     25.52 KB/s
     32               47.33 KB/s     43.49 KB/s
     48               67.04 KB/s     44.76 KB/s
     64               74.96 KB/s
    128               76.86 KB/s
    256               77.05 KB/s
    512               77.14 KB/s
    ----------------------------------------------------------
    
          USB serial-cable  Controller         driver
    送信  Elecom UC-SGT     PL-2303 XA / HXA   Prolific 3.3.11.152
    受信  Elecom UC-SGT     PL-2303 TA         Elecom   3.4.62.294
    
  3. zmatsuo commented on Dec 15, 2025

    @zmatsuo
    MemberAuthor

    接続デバイスがなくテストに協力できません。すみません。

    いえいえ

    CommWriteLimit の値を小さくすることで送信パフォーマンスを下げることが出来ることを確認致しました。

    ありがとうございます。

    「Tera Termで送信すると、受信側でdropする」という場合に
    この設定があれば使えそうです。

    値を設定すれば送信が遅くなるのですが、
    どんな値でどれぐらいの遅くなるのか、説明が難しいですね。
    環境に大きく左右されそうですし。

    この機能を作り込むなら、
    TERATERM.INI に CommWriteLimit(仮) を追加、
    デフォルト値は0(=無効)、とすればよさそうです。

  4. zmatsuo commented on Aug 22, 2026

    @zmatsuo
    MemberAuthor

    修正をコミットしました。 bc9b7d5

    TERATERM.INI に CommWriteLimit(仮) を追加、
    デフォルト値は0(=無効)、とすればよさそうです。

    キーは SerialSendLimit としました。
    値を変更した時のパフォーマンスの変化は
    hkanouさんの計測値をマニュアルに入れました。

  5. nmaya commented on Aug 24, 2026

    @nmaya
    Member

    ありがとうございます。
    SerialSendLimit は「UIのない設定値(special options)」になります。
    usage/tips/data_drop.html‎ に書いていただいた設定値「SerialSendLimit」の解説は、「通信 (Tera Term 設定ファイル)」ならびに入り口の「Tera Term 設定ファイル」を書いていただくのが、ドキュメント全体として統一性が出ます。
    移動していただくことはできるでしょうか?

  6. zmatsuo commented on Aug 25, 2026

    @zmatsuo
    MemberAuthor

    ありがとうございます。
    文書を移動しました。以前より統一感が出たと思います。

    Tera Term 設定ファイル
    はTera Term 設定ファイルを直接編集しなければならない、
    UIのない設定値を主に扱う内容なので、
    UIのある(後でUIが追加された)設定値は、
    UIのページか解説用ページ(下の例だとDEC Special Graphicsのページ)にまとめて、
    設定ファイルのページからなくすのがよさそうですね。

    眺めていてそう思ったのが次の項目です。

    ユーザインタフェースの言語ファイルの説明がTera Term 設定ファイルのページにあるのは、
    最初言語は変更できなくて、次に設定ファイルに追加、
    次にUIから変更可能となったのかなと感じました。

    「メッセージカタログ」となっているところもあるので
    以前から表記に揺れががあるかも。言語ファイルに合わせたほうがよさそうです。

  7. nmaya commented on Aug 28, 2026

    @nmaya
    Member

    修正ありがとうございます。

    後でUIが追加された設定値は、UIのページか解説用ページにまとめて

    そう思います。
    「なぜその設定が必要か、どういうときに使うか」が短く説明されれているものなら、UI画面の設定項目のところに書き、長くなるようならUIのところは手短にまとめて別のページにリンクすると、UI画面のヘルプとして読みやすくなると思います。

  8. added a commit that references this issue on Aug 29, 2026
  9. zmatsuo commented on Aug 29, 2026

    @zmatsuo
    MemberAuthor

    mainにマージしました。
    試しに作成したブランチも削除しました。
    クローズします。

    ドキュメントの調整は少しづつ、おいおい進めましょう。

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions