From 7e503510c7cea48624a55e0c0716033c94467fe8 Mon Sep 17 00:00:00 2001 From: skarg Date: Mon, 15 Aug 2011 17:15:20 +0000 Subject: [PATCH] Updated documentation for mstpcap utility. --- bacnet-stack/demo/mstpcap/mstpcap.txt | 95 +++++++++++++++++++-------- 1 file changed, 68 insertions(+), 27 deletions(-) diff --git a/bacnet-stack/demo/mstpcap/mstpcap.txt b/bacnet-stack/demo/mstpcap/mstpcap.txt index 5d3b306f..326c8d1f 100644 --- a/bacnet-stack/demo/mstpcap/mstpcap.txt +++ b/bacnet-stack/demo/mstpcap/mstpcap.txt @@ -12,26 +12,46 @@ D:\code\bacnet-stack>bin\mstpcap.exe com54 38400 Adjusted interface name to \\.\COM54 mstpcap: Using \\.\COM54 for capture at 38400 bps. mstpcap: saving capture to mstp_20110413134119.cap -3200 packets, 0 invalid frames -MAC MaxMstr Tokens Retries PFM Treply Tusage Trpfm Tder Tpostpd -0 1 557 0 32 11 47 0 0 0 -2 0 557 0 47 0 0 0 0 0 -3 4 557 0 32 11 110 0 0 0 -5 6 558 0 31 11 78 0 0 0 -7 127 557 1 31 404 63 0 0 0 +1156 packets +==== MS/TP Frame Counts ==== +MAC Tokens PFM RPFM DER Postpd DNER TestReq TestRsp +0 188 4 0 0 0 0 0 0 +2 189 0 0 0 0 0 0 0 +3 189 9 0 0 0 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 Invalid Frame Count: 0 The files that are captured can also be scanned to give some statistics: D:\code\bacnet-stack>bin\mstpcap.exe --scan mstp_20110413134119.cap Scanning mstp_20110413134119.cap -3223 packets -MAC MaxMstr Tokens Retries PFM Treply Tusage Trpfm Tder Tpostpd -0 1 557 0 32 11 47 0 0 0 -2 0 557 0 47 0 0 0 0 0 -3 4 557 0 32 11 110 0 0 0 -5 6 558 0 31 11 78 0 0 0 -7 127 557 1 31 404 63 0 0 0 +1156 packets +==== MS/TP Frame Counts ==== +MAC Tokens PFM RPFM DER Postpd DNER TestReq TestRsp +0 188 4 0 0 0 0 0 0 +2 189 0 0 0 0 0 0 0 +3 189 9 0 0 0 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 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 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. +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. -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 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 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 ==== 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) http://www.connecttech.com/KnowledgeDatabase/kdb309.htm As root: -chmod 777 /dev/ttyUSB0 - so I can use it later as normal user -setserial /dev/ttyUSB0 –a - this prints current info about the device +Change USB so I can use it later as normal user: +# chmod 777 /dev/ttyUSB0 - +Print current info about the device: +# setserial /dev/ttyUSB0 –a /dev/ttyUSB0, Line 0, UART: unknown, Port: 0x0000, IRQ: 0 Baud_base: 24000000, close_delay: 0, divisor: 0 closing_wait: infinte Flags: spd_normal low_latency -setserial /dev/ttyUSB0 spd_cust - to make custom speed -setserial /dev/ttyUSB0 divisor 312 - 24000000/312 gives 76923 baudrate -setserial /dev/ttyUSB0 –a - just to make sure changes got applied +Make custom speed: +# setserial /dev/ttyUSB0 spd_cust +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 Baud_base: 24000000, close_delay: 0, divisor: 312 closing_wait: infinte @@ -130,7 +172,6 @@ setserial /dev/ttyUSB0 Now as normal user running the mstpcap which uses the default 38400 baud it will actually capture at 76800 baud. (76923) -Just navigate to bin folder in the project and type: - -./mstpcap +Just navigate (cd bin) to bin folder in the project and type: +$ ./mstpcap