123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411 |
- <?xml version='1.0' encoding='iso-8859-1'?>
- <!doctype html public '-//W3C//DTD XHTML 1.0 Strict//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
- <html xmlns='http://www.w3c.org/1999/xhtml' lang='en-us'>
- <head>
- <title>
- LinkStatistics.c
- </title>
- <meta http-equiv='content-type' content='text/html;iso-8859-1'/>
- <meta name='generator' content='motley-tools 1.9.4 13:40:33 Feb 18 2015'/>
- <meta name='author' content='cmaier@cmassoc.net'/>
- <meta name='robots' content='noindex,nofollow'/>
- <link href='toolkit.css' rel='stylesheet' type='text/css'/>
- </head>
- <body>
- <div class='headerlink'>
- [<a href='keys.c.html' title=' keys.c '>PREV</a>]
- [<a href='toolkit.html' title=' Index '>HOME</a>]
- [<a href='LinkStatus.c.html' title=' LinkStatus.c '>NEXT</a>]
- </div>
- <pre>
- /*====================================================================*
- *
- * Copyright (c) 2013 Qualcomm Atheros, Inc.
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or
- * without modification, are permitted (subject to the limitations
- * in the disclaimer below) provided that the following conditions
- * are met:
- *
- * * Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * * Redistributions in binary form must reproduce the above
- * copyright notice, this list of conditions and the following
- * disclaimer in the documentation and/or other materials
- * provided with the distribution.
- *
- * * Neither the name of Qualcomm Atheros nor the names of
- * its contributors may be used to endorse or promote products
- * derived from this software without specific prior written
- * permission.
- *
- * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE
- * GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE
- * COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
- * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
- * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
- * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
- * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
- * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- *--------------------------------------------------------------------*/
- /*====================================================================*
- *
- * signed LinkStatistics (struct plc * plc);
- *
- * plc.h
- *
- * this plugin for plcstat reads device link statistics using a
- * VS_LNK_STATS message and displays information on stdout; since
- * the output may not suite all requirements, users are encouraged
- * to modify as needed; there is way too much data displayed here;
- *
- * some code is duplicated for the sake of modularity;
- *
- *
- * Contributor(s):
- * Charles Maier <cmaier@qca.qualcomm.com>
- *
- *--------------------------------------------------------------------*/
- #ifndef LINKSTATISTICS_SOURCE
- #define LINKSTATISTICS_SOURCE
- #include <stdint.h>
- #include <memory.h>
- #include <inttypes.h>
- #include "../plc/plc.h"
- #include "../tools/memory.h"
- #include "../tools/number.h"
- #include "../tools/error.h"
- /*====================================================================*
- * constants;
- *--------------------------------------------------------------------*/
- #define PAD ' '
- #define DIGITS 16
- /*====================================================================*
- * variables;
- *--------------------------------------------------------------------*/
- #ifndef __GNUC__
- #pragma pack (push,1)
- #endif
- typedef struct __packed transmit
- {
- uint64_t NUMTXMPDU_ACKD;
- uint64_t NUMTXMPDU_COLL;
- uint64_t NUMTXMPDU_FAIL;
- uint64_t NUMTXPBS_PASS;
- uint64_t NUMTXPBS_FAIL;
- }
- transmit;
- typedef struct __packed receive
- {
- uint64_t NUMRXMPDU_ACKD;
- uint64_t NUMRXMPDU_FAIL;
- uint64_t NUMRXPBS_PASS;
- uint64_t NUMRXPBS_FAIL;
- uint64_t SUMTURBOBER_PASS;
- uint64_t SUMTURBOBER_FAIL;
- uint8_t NUMRXINTERVALS;
- uint8_t RXINTERVALSTATS [1];
- }
- receive;
- typedef struct __packed interval
- {
- uint8_t RXPHYRATE_MBPS_0;
- uint64_t NUMRXPBS_PASS;
- uint64_t NUMRXPBS_FAIL;
- uint64_t SUMTURBOBER_PASS;
- uint64_t SUMTURBOBER_FAIL;
- }
- interval;
- #ifndef __GNUC__
- #pragma pack (pop)
- #endif
- /*====================================================================*
- *
- * unsigned error_rate (uint64_t passed, uint64_t failed);
- *
- * compute error rate for a given quantity; the error rate is the
- * ratio of failures to attempts;
- *
- *--------------------------------------------------------------------*/
- static float error_rate (uint64_t passed, uint64_t failed)
- {
- if ((passed) || (failed))
- {
- return ((float)(failed * 100) / (float)(passed + failed));
- }
- return (0);
- }
- /*====================================================================*
- *
- * float fec_bit_error_rate (struct receive * receive);
- *
- * compute the FEC-BER from the VS_LNK_STATS when DIRECTION=1 and
- * LID=0xF8;
- *
- *--------------------------------------------------------------------*/
- static float fec_bit_error_rate (struct receive * receive)
- {
- float FECBitErrorRate = 0;
- if (receive->SUMTURBOBER_PASS || receive->SUMTURBOBER_FAIL)
- {
- float TotalSumOfBitError = 100 * (float)(receive->SUMTURBOBER_PASS + receive->SUMTURBOBER_FAIL);
- float TotalSumOfBits = 8 * 520 * (float)(receive->NUMRXPBS_PASS + receive->NUMRXPBS_FAIL);
- FECBitErrorRate = TotalSumOfBitError / TotalSumOfBits;
- }
- return (FECBitErrorRate);
- }
- /*====================================================================*
- *
- * void transmit (struct transmit * transmit);
- *
- * display transmit statistics in fixed field format;
- *
- *--------------------------------------------------------------------*/
- static void TransmitStatistics (struct transmit * transmit)
- {
- printf (" TX");
- printf (" %20" PRId64, transmit->NUMTXPBS_PASS);
- printf (" %20" PRId64, transmit->NUMTXPBS_FAIL);
- printf (" %6.2f%%", error_rate (transmit->NUMTXPBS_PASS, transmit->NUMTXPBS_FAIL));
- printf (" %20" PRId64, transmit->NUMTXMPDU_ACKD);
- printf (" %20" PRId64, transmit->NUMTXMPDU_FAIL);
- printf (" %20" PRId64, transmit->NUMTXMPDU_COLL);
- printf (" %6.2f%%", error_rate (transmit->NUMTXMPDU_ACKD, transmit->NUMTXMPDU_FAIL));
- printf ("\n");
- return;
- }
- /*====================================================================*
- *
- * void Receive (struct receive * receive);
- *
- * display receive statistics in fixed field format;
- *
- *--------------------------------------------------------------------*/
- static void ReceiveStatistics (struct receive * receive)
- {
- printf (" RX");
- printf (" %20" PRId64, receive->NUMRXPBS_PASS);
- printf (" %20" PRId64, receive->NUMRXPBS_FAIL);
- printf (" %6.2f%%", error_rate (receive->NUMRXPBS_PASS, receive->NUMRXPBS_FAIL));
- printf (" %20" PRId64, receive->NUMRXMPDU_ACKD);
- printf (" %20" PRId64, receive->NUMRXMPDU_FAIL);
- printf (" %6.2f%%", error_rate (receive->NUMRXMPDU_ACKD, receive->NUMRXMPDU_FAIL));
- printf ("\n");
- return;
- }
- /*====================================================================*
- *
- * void Receive (struct receive * receive);
- *
- * display receive statistics in fixed field format for each slot;
- * the last line sumarizes results for all slots;
- *
- *--------------------------------------------------------------------*/
- static void Receive2 (struct receive * receive)
- {
- struct interval * interval = (struct interval *)(receive->RXINTERVALSTATS);
- uint8_t slot = 0;
- while (slot < receive->NUMRXINTERVALS)
- {
- printf (" %1d", slot);
- printf (" %3d", interval->RXPHYRATE_MBPS_0);
- printf (" %20" PRId64, interval->NUMRXPBS_PASS);
- printf (" %20" PRId64, interval->NUMRXPBS_FAIL);
- printf (" %6.2f%%", error_rate (interval->NUMRXPBS_PASS, interval->NUMRXPBS_FAIL));
- printf (" %20" PRId64, interval->SUMTURBOBER_PASS);
- printf (" %20" PRId64, interval->SUMTURBOBER_FAIL);
- printf (" %6.2f%%", error_rate (interval->SUMTURBOBER_PASS, interval->SUMTURBOBER_FAIL));
- printf ("\n");
- interval++;
- slot++;
- }
- printf (" ALL");
- printf (" %20" PRId64, receive->NUMRXPBS_PASS);
- printf (" %20" PRId64, receive->NUMRXPBS_FAIL);
- printf (" %6.2f%%", error_rate (receive->NUMRXPBS_PASS, receive->NUMRXPBS_FAIL));
- printf (" %20" PRId64, receive->SUMTURBOBER_PASS);
- printf (" %20" PRId64, receive->SUMTURBOBER_FAIL);
- printf (" %6.2f%%", error_rate (receive->SUMTURBOBER_PASS, receive->SUMTURBOBER_FAIL));
- printf (" %6.2f%%", fec_bit_error_rate (receive));
- printf ("\n");
- return;
- }
- /*====================================================================*
- *
- * signed LinkStatistics (struct plc * plc);
- *
- *
- *--------------------------------------------------------------------*/
- signed LinkStatistics (struct plc * plc)
- {
- struct channel * channel = (struct channel *)(plc->channel);
- struct message * message = (struct message *)(plc->message);
- #ifndef __GNUC__
- #pragma pack (push,1)
- #endif
- struct __packed vs_lnk_stats_request
- {
- struct ethernet_hdr ethernet;
- struct qualcomm_hdr qualcomm;
- uint8_t MCONTROL;
- uint8_t DIRECTION;
- uint8_t LID;
- uint8_t MACADDRESS [ETHER_ADDR_LEN];
- }
- * request = (struct vs_lnk_stats_request *) (message);
- struct __packed vs_lnk_stats_confirm
- {
- struct ethernet_hdr ethernet;
- struct qualcomm_hdr qualcomm;
- uint8_t MSTATUS;
- uint8_t DIRECTION;
- uint8_t LID;
- uint8_t TEI;
- uint8_t LSTATS [1];
- }
- * confirm = (struct vs_lnk_stats_confirm *) (message);
- #ifndef __GNUC__
- #pragma pack (pop)
- #endif
- memset (message, 0, sizeof (* message));
- EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type);
- QualcommHeader (&request->qualcomm, 0, (VS_LNK_STATS | MMTYPE_REQ));
- plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN);
- request->MCONTROL = plc->pushbutton;
- request->DIRECTION = plc->module;
- request->LID = plc->action;
- memcpy (request->MACADDRESS, plc->RDA, sizeof (request->MACADDRESS));
- if (SendMME (plc) <= 0)
- {
- error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND);
- return (-1);
- }
- if (ReadMME (plc, 0, (VS_LNK_STATS | MMTYPE_CNF)) <= 0)
- {
- error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD);
- return (-1);
- }
- if (confirm->MSTATUS)
- {
- Failure (plc, PLC_WONTDOIT);
- return (-1);
- }
- if (confirm->DIRECTION == 0)
- {
- printf (" DIR");
- printf (" ----------- PBs PASS");
- printf (" ----------- PBs FAIL");
- printf (" PBs ERR");
- printf (" ---------- MPDU ACKD");
- printf (" ---------- MPDU FAIL");
- printf ("\n");
- TransmitStatistics ((struct transmit *)(confirm->LSTATS));
- printf ("\n");
- }
- if (confirm->DIRECTION == 1)
- {
- printf (" DIR");
- printf (" ----------- PBs PASS");
- printf (" ----------- PBs FAIL");
- printf (" PBs ERR");
- printf (" ---------- MPDU ACKD");
- printf (" ---------- MPDU FAIL");
- printf ("\n");
- ReceiveStatistics ((struct receive *)(confirm->LSTATS));
- printf ("\n");
- printf (" PHY");
- printf (" ----------- PBs PASS");
- printf (" ----------- PBs FAIL");
- printf (" PBs ERR");
- printf (" ----------- BER PASS");
- printf (" ----------- BER FAIL");
- printf (" BER ERR");
- printf ("\n");
- Receive2 ((struct receive *)(confirm->LSTATS));
- printf ("\n");
- }
- if (confirm->DIRECTION == 2)
- {
- printf (" DIR");
- printf (" ----------- PBs PASS");
- printf (" ----------- PBs FAIL");
- printf (" PBs ERR");
- printf (" ---------- MPDU ACKD");
- printf (" ---------- MPDU FAIL");
- printf ("\n");
- TransmitStatistics ((struct transmit *)(confirm->LSTATS));
- ReceiveStatistics ((struct receive *)(confirm->LSTATS + sizeof (struct transmit)));
- printf ("\n");
- printf (" PHY");
- printf (" ----------- PBs PASS");
- printf (" ----------- PBs FAIL");
- printf (" PBs ERR");
- printf (" ----------- BER PASS");
- printf (" ----------- BER FAIL");
- printf (" BER ERR");
- printf ("\n");
- Receive2 ((struct receive *)(confirm->LSTATS + sizeof (struct transmit)));
- printf ("\n");
- }
- return (0);
- }
- #endif
- </pre>
- <div class='footerlink'>
- [<a href='keys.c.html' title=' keys.c '>PREV</a>]
- [<a href='toolkit.html' title=' Index '>HOME</a>]
- [<a href='LinkStatus.c.html' title=' LinkStatus.c '>NEXT</a>]
- </div>
- </body>
- </html>
|