dali/bacnet_stack
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Updated documentation for mstpcap utility.

Browse Source
This commit is contained in:
skarg
2011-08-15 17:15:20 +00:00
parent b3a8eff164
commit 7e503510c7
1 changed files with 68 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files
bacnet-stack/demo/mstpcap/mstpcap.txt
+68 -27
View File
@@ -12,26 +12,46 @@ D:\code\bacnet-stack>bin\mstpcap.exe com54 38400
Adjusted interface name to \\.\COM54 Adjusted interface name to \\.\COM54
mstpcap: Using \\.\COM54 for capture at 38400 bps. mstpcap: Using \\.\COM54 for capture at 38400 bps.
mstpcap: saving capture to mstp_20110413134119.cap mstpcap: saving capture to mstp_20110413134119.cap
3200 packets, 0 invalid frames 1156 packets
MAC MaxMstr Tokens Retries PFM Treply Tusage Trpfm Tder Tpostpd ==== MS/TP Frame Counts ====
0 1 557 0 32 11 47 0 0 0 MAC Tokens PFM RPFM DER Postpd DNER TestReq TestRsp
2 0 557 0 47 0 0 0 0 0 0 188 4 0 0 0 0 0 0
3 4 557 0 32 11 110 0 0 0 2 189 0 0 0 0 0 0 0
5 6 558 0 31 11 78 0 0 0 3 189 9 0 0 0 0 0 0
7 127 557 1 31 404 63 0 0 0 7 189 60 0 0 0 0 0 0
35 188 140 0 0 0 0 0 0
Node Count: 5
==== MS/TP Usage and Timing Maximums ====
MAC MaxMstr Retries Npoll Self Treply Tusage Trpfm Tder Tpostpd
0 1 0 52 0 11 24 0 0 0
2 0 0 0 0 23 0 0 0 0
3 6 0 50 0 5 100 0 0 0
7 34 0 52 0 5 34 0 0 0
35 127 0 50 0 6 63 0 0 0
Node Count: 5 Node Count: 5
Invalid Frame Count: 0 Invalid Frame Count: 0
The files that are captured can also be scanned to give some statistics: The files that are captured can also be scanned to give some statistics:
D:\code\bacnet-stack>bin\mstpcap.exe --scan mstp_20110413134119.cap D:\code\bacnet-stack>bin\mstpcap.exe --scan mstp_20110413134119.cap
Scanning mstp_20110413134119.cap Scanning mstp_20110413134119.cap
3223 packets 1156 packets
MAC MaxMstr Tokens Retries PFM Treply Tusage Trpfm Tder Tpostpd ==== MS/TP Frame Counts ====
0 1 557 0 32 11 47 0 0 0 MAC Tokens PFM RPFM DER Postpd DNER TestReq TestRsp
2 0 557 0 47 0 0 0 0 0 0 188 4 0 0 0 0 0 0
3 4 557 0 32 11 110 0 0 0 2 189 0 0 0 0 0 0 0
5 6 558 0 31 11 78 0 0 0 3 189 9 0 0 0 0 0 0
7 127 557 1 31 404 63 0 0 0 7 189 60 0 0 0 0 0 0
35 188 140 0 0 0 0 0 0
Node Count: 5
==== MS/TP Usage and Timing Maximums ====
MAC MaxMstr Retries Npoll Self Treply Tusage Trpfm Tder Tpostpd
0 1 0 52 0 11 24 0 0 0
2 0 0 0 0 23 0 0 0 0
3 6 0 50 0 5 100 0 0 0
7 34 0 52 0 5 34 0 0 0
35 127 0 50 0 6 63 0 0 0
Node Count: 5 Node Count: 5
Invalid Frame Count: 0 Invalid Frame Count: 0
@@ -43,13 +63,33 @@ The statistics are emitted when Control-C is pressed, or when
The statistics are cleared when the new file is created. The statistics are cleared when the new file is created.
The statistics can be emitted from a file using the "--scan" option. The statistics can be emitted from a file using the "--scan" option.
MaxMstr = highest destination MAC address during PFM The MS/TP Frame counts use the following abbreviations:
Tokens = number of Token frames sent from this MAC address. Tokens = number of Token frames sent from this MAC address.
PFM = number of Poll-For-Master frames sent from this MAC address.
RPFM = number of Reply-To-Poll-For-Master frames sent from this MAC address.
DER = number of Data-Expecting-Reply frames sent from this MAC address.
Postpd = number of Reply-Postponed frames sent from this MAC address.
DNER = number of Data-Not-Expecting-Reply frames sent from this MAC address.
TestReq = number of Test-Request frames sent from this MAC address.
TestRsp = number of Test-Response frames sent from this MAC address.
The MS/TP Usage and Timing Maximums use the following abbreviations:
MaxMstr = highest destination MAC address during PFM
Retries = number of second tokens sent to this MAC address. Retries = number of second tokens sent to this MAC address.
PFM = number of Poll-For-Master frames sent from this MAC address. Npoll = number of Tokens between Poll-For-Master
Self = number of Tokens sent to self (Addendum 135-2008v)
Treply = maximum number of milliseconds it took to reply with Treply = maximum number of milliseconds it took to reply with
a token after receiving a token. Treply is required to be less a token after receiving a token. Treply is required to be less
@@ -71,9 +111,6 @@ Tpostpd = maximum number of milliseconds to respond to
DataExpectingReply request with ReplyPostponed. Tpostpd is DataExpectingReply request with ReplyPostponed. Tpostpd is
required to be less than 250ms. required to be less than 250ms.
Note that the mstpcap tool may not have that good of
resolution on Windows, so timing under 50ms may not be accurate.
==== FTDI chip RS-485 converter 76800 baud tricks ==== ==== FTDI chip RS-485 converter 76800 baud tricks ====
If you are using FTDI chip in your RS485 converter, you can If you are using FTDI chip in your RS485 converter, you can
@@ -112,16 +149,21 @@ So to capture at 76800 baud type: mstpcap.exe COM2 300
Linux (used with Debian Lenny and Fedora 15) Linux (used with Debian Lenny and Fedora 15)
http://www.connecttech.com/KnowledgeDatabase/kdb309.htm http://www.connecttech.com/KnowledgeDatabase/kdb309.htm
As root: As root:
chmod 777 /dev/ttyUSB0 - so I can use it later as normal user Change USB so I can use it later as normal user:
setserial /dev/ttyUSB0 –a - this prints current info about the device # chmod 777 /dev/ttyUSB0 -
Print current info about the device:
# setserial /dev/ttyUSB0 –a
/dev/ttyUSB0, Line 0, UART: unknown, Port: 0x0000, IRQ: 0 /dev/ttyUSB0, Line 0, UART: unknown, Port: 0x0000, IRQ: 0
Baud_base: 24000000, close_delay: 0, divisor: 0 Baud_base: 24000000, close_delay: 0, divisor: 0
closing_wait: infinte closing_wait: infinte
Flags: spd_normal low_latency Flags: spd_normal low_latency
setserial /dev/ttyUSB0 spd_cust - to make custom speed Make custom speed:
setserial /dev/ttyUSB0 divisor 312 - 24000000/312 gives 76923 baudrate # setserial /dev/ttyUSB0 spd_cust
setserial /dev/ttyUSB0 –a - just to make sure changes got applied 24000000/312 gives 76923 baudrate:
# setserial /dev/ttyUSB0 divisor 312
Print to make sure changes got applied:
# setserial /dev/ttyUSB0 –a
/dev/ttyUSB0, Line 0, UART: unknown, Port: 0x0000, IRQ: 0 /dev/ttyUSB0, Line 0, UART: unknown, Port: 0x0000, IRQ: 0
Baud_base: 24000000, close_delay: 0, divisor: 312 Baud_base: 24000000, close_delay: 0, divisor: 312
closing_wait: infinte closing_wait: infinte
@@ -130,7 +172,6 @@ setserial /dev/ttyUSB0
Now as normal user running the mstpcap which uses the default 38400 baud it Now as normal user running the mstpcap which uses the default 38400 baud it
will actually capture at 76800 baud. (76923) will actually capture at 76800 baud. (76923)
Just navigate to bin folder in the project and type: Just navigate (cd bin) to bin folder in the project and type:
./mstpcap
$ ./mstpcap