SiTCP ユーティリティユーザガイド

2023 年 7 月 6 日 0.9 版㈱Bee Beans Technologies

1

改版履歴
版数

日付

内容

備考

0.1

2013 年 04 月 04 日・ドラフト作成

0.11

2013 年 04 月 10 日・UI 等の微調整に対応

0.2

2013 年 04 月 24 日

・サーバー機能追加

0.3

2013 年 06 月 18 日

・各 OS へのインストール方法記述
・TCP 送信機能の作成

0.31

2013 年 06 月 19 日

・微修正

0.5

2013 年 08 月 26 日

・TCP 機能の修正
・UI の調整0.6

2013 年 10 月 23 日

・レビュー反映

0.62

2013 年 11 月 13 日

・エラー表示の修正
・国際化

0.7

2014 年 02 月 12 日

・SOY-RS232C 対応
・SOY-GPIB 対応

0.73

2014 年 06 月 18 日

・SOY タブを分離・通信性能について追記

0.92023 年 7 月 6 日

・「1.1.実行環境」を更新
・「1.2.インストール」を更新
・「2.3.データ(TCP)タブ」を更新
・その他、軽微な表現の修正

内容
1.

実行環境、インストールとアンインストール、起動/停止 ............................................................ 5
1.1.

実行環境 ................................................................................................................... 5

1.2.

インストール ................................................................................................................. 6

1.2.1.

Windows .......................................................................................................... 6

1.2.2.

macOS.............................................................................................................. 6

1.2.3.

CentOS ............................................................................................................. 6

1.3.

アンインストール ........................................................................................................... 6

1.4.

SiTCP ユーティリティの起動 .......................................................................................... 7

1.5.

SiTCP ユーティリティの停止 .......................................................................................... 72

2.

画面説明 .......................................................................................................................... 8
2.1.

一般タブ ..................................................................................................................... 8

2.1.1.

制御対象............................................................................................................ 82.1.2.

書き込み内容...................................................................................................... 92.1.3.

[EEPROM にアクセスする]チェックボックス ............................................................... 92.1.4.

[読み込み]ボタン ................................................................................................. 92.1.5.

[書き込み]ボタン ................................................................................................. 92.1.6.

読み込み結果 ..................................................................................................... 92.2.

制御(UDP)タブ ........................................................................................................ 102.2.1.

レジスタアドレス(16 進数) .................................................................................. 102.2.2.

データ長(Byte) ................................................................................................. 102.2.3.

データ.................................................................................................................112.2.4.

アドレス表示 .......................................................................................................112.2.5.

[読み出し] / [書き込み]ボタン ............................................................................112.3.

データ(TCP)タブ........................................................................................................ 122.3.1.

[受信設定]グループボックス ................................................................................ 122.3.2.

[送信設定]グループボックス ................................................................................ 132.3.3.

[受信ダイアログ]ボタン ........................................................................................ 132.3.4.

[送信ダイアログ]ボタン ........................................................................................ 132.3.5.

[受信情報]ダイアログ ......................................................................................... 142.3.6.

[送信情報]ダイアログ ......................................................................................... 152.4.

SOY-RS232C タブ .................................................................................................. 17

2.4.1.

[共通設定]グループボックス ................................................................................ 172.4.2.

[DCE/DTE]グループボックス ............................................................................... 172.4.3.

[読み込み]ボタン ............................................................................................... 172.4.4.

[書き込み]ボタン ............................................................................................... 18

2.4.5.

[EEPROM にアクセスする]チェックボックス ............................................................. 18

2.4.6.

[接続]ボタン ..................................................................................................... 18

2.4.7.

[デリミタ] ........................................................................................................... 182.4.8.

[送信データ(ASCII)] ........................................................................................ 182.4.9.

[送信]ボタン ..................................................................................................... 182.4.10.

[受信データ] ................................................................................................. 182.4.11.

[16 進数表示]チェックボックス ......................................................................... 182.4.12.

[最大受信長] ............................................................................................... 182.4.13.

[受信]ボタン .................................................................................................. 19

2.4.14.

[クリア]ボタン.................................................................................................. 193

2.5.

SOY-GPIB タブ........................................................................................................ 202.5.1.

[Controller GPIB Address] .......................................................................... 202.5.2.

[タイムアウト] ..................................................................................................... 202.5.3.

[読み込み]ボタン ............................................................................................... 202.5.4.

[書き込み]ボタン ............................................................................................... 21

2.5.5.

[接続]ボタン ..................................................................................................... 21

2.5.6.

[Interface Clear]ボタン .................................................................................. 21

2.5.7.

[Target GPIB Address] ................................................................................ 21

2.5.8.

[デリミタ] ........................................................................................................... 21

2.5.9.

[送信データ(ASCII)] ........................................................................................ 21

2.5.10.

[送信]ボタン .................................................................................................. 21

2.5.11.

[受信データ] ................................................................................................. 21

2.5.12.

[16 進数表示]チェックボックス ......................................................................... 21

2.5.13.

[最大受信長] ............................................................................................... 22

2.5.14.

[受信]ボタン .................................................................................................. 22

2.5.15.

[クリア]ボタン.................................................................................................. 222.6.

詳細タブ ................................................................................................................... 23

2.6.1.

制御対象.......................................................................................................... 232.6.2.

[EEPROM にアクセスする]チェックボックス ............................................................. 23

2.6.3.

[読み出し] ボタン .............................................................................................. 24

2.6.4.

[書き込み]ボタン ............................................................................................... 24

2.7.

サーバータブ .............................................................................................................. 25

2.7.1.
3.

サーバーログ....................................................................................................... 25

性能 ............................................................................................................................... 27

4

1. 実行環境、インストールとアンインストール、起動/停止
1.1. 実行環境
本ソフトウェアのテスト環境は以下の通りです。

表 1-1.テスト環境
OSバージョン

Windows®
macOS

Windows 11 Pro (x86_64)®

macOS 12 (x86_64/arm64)

CentOSCentOS7 (x86_64)
Windows は Microsoft 社の、macOS は Apple 社の登録商標です

以下マニュアルの画面は Windows 版のものを用いますが、その他の OS でも同様の操作でご利用いただけます。

5

1.2. インストール
1.2.1. Windows
SiTCPUtility.zip を解凍ソフトウェアによって解凍してください。

1.2.2. macOSSiTCPUtility.dmg をマウントしてください。

1.2.3. CentOS
SiTCPUtility.tar.gz を解凍してください。
次に解凍してできたフォルダ内の SiTCPUtility ファイルに実行権限を付与してください。

1.3. アンインストール
解凍してできたフォルダを削除してください。

6

1.4. SiTCP ユーティリティの起動
解凍してできたフォルダ内の、「SiTCPUtility.exe」または「SiTCPUtility」をダブルクリックして起動してください。

図 1-1 SiTCP ユーティリティ起動画面
起動時にコマンドラインオプションを指定することによって詳細タブ、およびサーバータブを有効にすることができます。詳細は p.14[2.4.詳細タブ]、p.16[2.5.サーバータブ]をご参照ください。
UI 下部ログには処理の成功/エラーメッセージが表示されます。

1.5. SiTCP ユーティリティの停止
SiTCP ユーティリティを停止するには、画面上部の「x」ボタンをクリックしてください。

7

2. 画面説明
2.1. 一般タブ

図 2-1[一般]タブ

2.1.1. 制御対象
制御対象となる SiTCP 機器のアクセス情報を設定します。ここで設定された情報が、2.1.2.書き込み内
容、2.2.制御(UDP)タブ、2.3.データ(TCP)タブでの制御対象となります。
・IP Address: IP アドレスを指定します・

TCP Port: データ受信用の TCP ポート番号を指定します。

・

UDP Port: 制御プロトコル(BCP / Slow Control)用の UDP ポート番号を指定します。

8

2.1.2. 書き込み内容
SiTCP 機器の設定を書き換える場合に使用します。設定内容は 2.1.1.制御対象と同様です。
・IP Address

・

TCP Port

・

UDP Port

2.1.3.[EEPROM にアクセスする]チェックボックスの指定によって、書き換え対象が使用中のメモリ情報、
EEPROM 情報のいずれかとなります。
書き換え時には EEPROM を書き換えたのち、SiTCP 機器を再起動することをお勧めします。
使用中のメモリ情報を書き換えた場合、IP アドレスの変更により SiTCP ユーティリティが無応答となります。ご注意ください。

2.1.3. [EEPROM にアクセスする]チェックボックス[書き込み]ボタンクリック時のアクセス対象を変更します。
チェックボックス OFF の時: 使用中のメモリにアクセスします

チェックボックス ON の時: EEPROM にアクセスします

2.1.4. [読み込み]ボタン
SiTCP 機器の設定を読み込み、[読み込み結果]に出力します。

2.1.5. [書き込み]ボタン
SiTCP 機器の設定を[書き込み内容]の内容に書き換えます。

2.1.6. 読み込み結果
SiTCP 機器の設定を表示します。

92.2. 制御(UDP)タブ

図 2-2[制御(UDP)]タブ

2.2.1. レジスタアドレス(16 進数)「読み出し」または「書き込み」を行う SiTCP 機器のレジスタアドレスを指定します。
値は 16 進数で指定します。0x などのプレフィクスは不要です。
入力後エンターキーを押下するとレジスタアドレスをコンボボックスに追加できます。

2.2.2. データ長(Byte)「読み出し」または「書き込み」を行うデータ長を指定します。

10

2.2.3. データ「読み出し」時には、読み出されたデータが、「書き込み」時には書き込むデータを 16 進数で指定します。

2.2.4. アドレス表示「読み出し」時に読み出されたデータにアドレス表示を付与します。

2.2.5. [読み出し] / [書き込み]ボタン
2.2.1 から 2.2.3 で指定した情報で、レジスタに「読み出し」/「書き込み」を行います。

アドレス表示をした状態で書き込みを行っても、データ内のアドレス情報は無視されます。
書き込み時にはアドレス表示のない状態で行うことをお勧めします。

11

2.3. データ(TCP)タブ

図 2-3[データ(TCP)]タブ

2.3.1. [受信設定]グループボックス
2.3.1.1.

[フォーマットを利用して保存]

TCP 通信によって受信したデータを、フォーマットを利用して保存する場合にチェックを入れてください。ファ
イルは utf8 形式で保存します。フォーマットの詳細については、[2.3.1.5.フォーマット]をご参照ください。
2.3.1.2.

[保存ファイル]

受信したデータを保存するファイルを指定します。左の[…]ボタンでファイル参照のダイアログが表示されます。
2.3.1.3.

[開く]ボタン[保存ファイル]で指定したファイルを既定のプログラムを利用して開きます。

12

2.3.1.4.

[フォーマット]

テキスト形式ファイルの保存時、およびデータ表示時に使用されるバイナリデータの表示フォーマットを指定します。フォーマットは１行分の出力形式を 10 進数値とそれ以外の文字列で記述します。10 進数値はバイト数、その他の文字列はすべて区切り文字列として解釈されます。ただし、\t(tab)、\n(改行)などは指定できません。デフォルトでは１バイトずつ 8 バイトまでスペースで区切って出力されます。
例）デフォルトのフォーマットは以下のように 1 とスペースを 16 個記載したものです。
1111111111111111
例) 「4,4,4」を指定した場合4 バイトずつ 3 つのデータをカンマで区切って１行とします。1 行は 12 バイト分となります。

2.3.2. [送信設定]グループボックス
2.3.2.1.

[フォーマットされたファイルを送る]

送信時に利用するファイルを utf8 のフォーマット済み形式として解釈する場合にチェックします。その際ファ
イルは 16 進数が 0～9、A～F で記載されているものとして解釈し、その他の文字は読み飛ばされます。
このチェックボックスが入った状態で utf8 以外の文字コードで保存されたファイルを送信すると、フォーマットエラーが発生しますのでご注意ください。
2.3.2.2.

[送信ファイル]

送信するファイルを指定します。左の[…]ボタンでファイルの参照ダイアログが表示されます。
2.3.2.3.

2.3.1.3. [開く]ボタン[送信ファイル]で指定したファイルを既定のプログラムを利用して開きます。
2.3.2.4.

[フォーマット]

データ表示時に使用されるバイナリデータの表示フォーマットを指定します。詳細は[2.3.1.4.フォーマット]と同様です。

2.3.3. [受信ダイアログ]ボタン
図 2-4.で示される受信ダイアログを表示します。

2.3.4. [送信ダイアログ]ボタン
図 2-5.で示される送信ダイアログを表示します。

13

2.3.5. [受信情報]ダイアログ

図 2-4[受信情報]ダイアログ
2.3.5.1.

[受信サイズ][受信開始]ボタンをクリックしてから受信したデータのサイズです。
2.3.5.2.

[受信時間][受信開始]ボタンをクリックしてからの経過時間です。
2.3.5.3.

[受信レート][受信開始]ボタンをクリックしてからの平均受信レートです。
2.3.5.4.

[データ表示]チェックボックス

受信したデータを下部のテキストエリアに表示する場合チェックします。
2.3.5.5.

[フォーマットを利用して表示]チェックボックス

受信したデータを、形式を指定してテキストエリアに表示する場合チェックします。チェックしない場合、受信したデータを utf8 形式のデータとしてテキストエリアに表示します。
2.3.5.6.

[フォーマットを利用して表示]テキストエリア

受信したデータを、テキストエリアに表示する形式を指定します。入力内容は、[2.3.1.4.フォーマット]と同期します。

14

2.3.5.7.

[データ表示]テキストエリア

受信したデータを表示します。
2.3.5.8.

[受信開始]ボタン

SiTCP 機器に接続し受信を開始します。
2.3.5.9.

[受信停止]ボタン

受信を停止します。
2.3.5.10.

[クリア]ボタン

テキストエリアの内容を消去します。

2.3.6. [送信情報]ダイアログ

図 2-5[送信情報]ダイアログ
2.3.6.1.

[送信サイズ][送信開始]ボタンをクリックしてから機器に書き込んだデータのサイズです。
2.3.6.2.

[送信時間][送信開始]ボタンをクリックしてからの経過時間です。
2.3.6.3.

[送信レート][送信開始]ボタンをクリックしてからの平均送信レートです。

15

2.3.6.4.

プログレスバー

送信完了しているデータの割合を示します。
2.3.6.5.

[データ表示]チェックボックス

送信したデータを下部のテキストエリアに表示する場合チェックします。
2.3.6.6.

[データ表示]テキストエリア

送信したデータを[2.3.2.4.フォーマット]で指定した形式を適用して表示します。
2.3.6.7.

[送信開始]ボタン

SiTCP 機器に接続し送信を開始します。
2.3.6.8.

[送信停止]ボタン

送信を停止します。
2.3.6.9.

[クリア]ボタン

テキストエリアの内容を消去します。
表示される受信/送信サイズは実データのバイナリサイズです。テキスト変換されたファイルサイズとは一致しません。
データ表示やファイル保存時には本ソフトウェアの処理のため送受信レートが低下します。ご了承ください。ターゲット SiTCP デバイスの送信性能を見る場合はファイル名を指定せず（空白とします）データ表示のチェックを外します。ただし、本ソフトウェアの送受信可能レートはご利用になるパーソナルコンピュータ、ネットワークカード、接続されたネットワークなどの性能に依存します。

16

2.4. SOY-RS232C タブ

図 2-6[SOY-RS232C]タブ

2.4.1. [共通設定]グループボックス
SOY-RS232C の DCE/DTE 共通の設定内容を指定します。

2.4.2. [DCE/DTE]グループボックス
DCE/DTE 別々にある設定内容を指定します。
ラジオボタンでは太字の項目のみ信号の On/Off を切り替えることが可能です。

2.4.3. [読み込み]ボタン
SOY-RS232C の設定情報を読み込みます。

17

2.4.4. [書き込み]ボタン
SOY-RS232C の設定情報を書き込みます。

2.4.5. [EEPROM にアクセスする]チェックボックス
EEPROM 内の設定内容にアクセスする場合にチェックしてください。

2.4.6. [接続]ボタン
SOY-RS232C に接続します。

2.4.7. [デリミタ]
RS232C で送受信される命令のデリミタを指定します。

2.4.8. [送信データ(ASCII)]
送信したい命令を ASCII で指定します。

2.4.9. [送信]ボタン
指定した命令を SOY-RS232C を介して送信します。

2.4.10.

[受信データ]

受信したデータを表示します。

2.4.11.

[16 進数表示]チェックボックス

受信したデータを 16 進数で表示する場合チェックしてください。チェックされていない場合 ASCII 文字コー
ドとしてコーディングされます。

2.4.12.

[最大受信長]RS232C で１度に受け取る最大のデータ長を指定します。

18

2.4.13.

[受信]ボタンSOY-RS232C を介して機器からデータを受け取ります。

2.4.14.

[クリア]ボタン[受信データ]の内容を消します。
RS232C 関連の設定は通信対象の機器により大きく異なります。適切な設定でない場合は正常な通信ができませんので、ご注意ください。

19

2.5. SOY-GPIB タブ

図 2-7[SOY-GPIB]タブ

2.5.1. [Controller GPIB Address]
SOY-GPIB の GPIB アドレスを指定します。

2.5.2. [タイムアウト]
GPIB で通信する際に SOY-GPIB がタイムアウトと判断するまでの時間です。

2.5.3. [読み込み]ボタン
SOY-GPIB の設定情報を読み込みます。

20

2.5.4. [書き込み]ボタン
SOY-GPIB の設定情報を書き込みます。

2.5.5. [接続]ボタン
SOY-GPIB に対して接続/切断をします。

2.5.6. [Interface Clear]ボタン
SOY-GPIB を介して Interface Clear 命令を発行します。

2.5.7. [Target GPIB Address]
SOY-GPIB を介して通信を行う機器のアドレスを指定します。

2.5.8. [デリミタ]
GPIB で送受信される命令のデリミタを指定します。

2.5.9. [送信データ(ASCII)]
送信したい命令を ASCII で指定します。

2.5.10.

[送信]ボタン

指定した命令を SOY-GPIB を介して送信します。

2.5.11.

[受信データ]

受信したデータを表示します。

2.5.12.

[16 進数表示]チェックボックス

受信したデータを 16 進数で表示する場合チェックしてください。チェックされていない場合 ASCII 文字コー
ドとしてコーディングされます。

21

2.5.13.

[最大受信長]GPIB で１度に受け取る最大のデータ長を指定します。

2.5.14.

[受信]ボタンSOY-GPIB を介して機器からデータを受け取ります。

2.5.15.

[クリア]ボタン[受信データ]の内容を消します。

22

2.6. 詳細タブ

図 2-8[詳細]タブ
通常起動では利用できません。起動時に「-expert」オプションを指定してください。
書き込み内容によっては、SiTCP 機器が正常に動作しなくなる可能性があります。起動しなくなった場合には、リセットジャンパを用いて設定を初期状態に戻してください。

2.6.1. 制御対象
制御対象となる SiTCP 機器のアクセス情報を設定します。この情報は 2.1.1.制御対象と連動します。

2.6.2. [EEPROM にアクセスする]チェックボックス[読み出し] / [書き込み]ボタンクリック時のアクセス対象を変更します。

23

2.6.3. [読み出し] ボタン
制御対象となる SiTCP 機器の 2.6.2. [EEPROM にアクセスする]チェックボックスで指定したメモリにアクセスし、設定内容をタブ下部領域に書き込みます。

2.6.4. [書き込み]ボタン
制御対象となる SiTCP 機器にアクセスし、タブ下部領域の内容を 2.6.2. [EEPROM にアクセスする]チェックボックスで指定したメモリに書き込みます。

MAC アドレスを書き換えると異常動作が発生するため、書き換え不可になっております。

24

2.7. サーバータブ

図 2-7[サーバー]タブ

2.7.1. サーバーログ
サーバーモードのとき接続してきたクライアントの動作を表示します。
クライアントは Telnet 等で接続し、命令を送信して遠隔から SiTCP 機器を操作することができます。
命令に対してサーバーは、「OK:」または「NG:」から始まり「SiTCPUtility>」で終わる返答を返します。
現在サーバーがサポートしている命令は以下の 3 つです。
・read <アドレス(16 進数)> <バイト長> [ファイル名]
SiTCP 機器のレジスタを読み込みます。ファイル名を指定するとサーバー上のファイルに保存します。
戻り値は「<アドレス> : データ」の形式で 16 バイトごとに区切って出力されます。

25例)
SiTCPUtil>read ffffff00 32
OK:
FFFFFF00 : 12 02 27 01 02 09 00 12 53 69 54 43 50 00 00 00
FFFFFF10 : 01 00 02 00 C0 A8 00 10 C0 A8 0A 10 00 18 00 17・write <アドレス(16 進数)> <データ(16 進数) | ファイル名>
SiTCP 機器のレジスタにデータを書き込みます。第２引数が 16 進数として解釈可能な場合、データとして解釈します。そうでない場合はファイル名として扱います。
戻り値は「<アドレス> : データ」の形式で 16 バイトごとに区切って出力されます。
例)
SiTCPUtil>write 00ffff00 1202
OK:00FFFF00 : 12 02
・help
サポートしている命令の一覧を出力します。
例)
SiTCPUtil>help
OK:
read <address> <length> [filename]write <address> <data(hex) | filename>
また、接続を終了するときは「quit」命令を送信します。
例)
SiTCPUtil>quit
Bye-Bye!
通常起動では利用できません。起動時に「-uiport:<ポート番号>」オプションを指定してください。

26

3. 性能本ソフトウェアの通信性能を以下に示します。なおこれらの値はテスト時のものであり、環境により変動があります。
項目

性能

RBCP 最小ターンアラウンドタイム

50μs

TCP 最大通信速度

650Mbps

SOY-RS232c 最大通信速度

460.8Kbps

SOY-GPIB 最小ターンアラウンドタイム

45μs27