| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502 |
- <?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>
- plcotst.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='PLCNetworkInfo.c.html' title=' PLCNetworkInfo.c '>PREV</a>]
- [<a href='toolkit.html' title=' Index '>HOME</a>]
- [<a href='PLCPhyRates.c.html' title=' PLCPhyRates.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.
- *
- *--------------------------------------------------------------------*/
- /*====================================================================*
- *
- * plcotst.c - Atheros PLC One-Time Self-Test Manager;
- *
- * Use VS_SELFTEST_ONETIME_CONFIG and VS_SELFTEST_RESULTS message
- * type to configure the Atheros PLC One-Time Self-Test then read
- * and display stored selftest results;
- *
- * Contributor(s):
- * Charles Maier <cmaier@qca.qualcomm.com>
- *
- *--------------------------------------------------------------------*/
- /*====================================================================*"
- * system header files;
- *--------------------------------------------------------------------*/
- #include <unistd.h>
- #include <stdlib.h>
- #include <stdint.h>
- #include <limits.h>
- /*====================================================================*
- * custom header files;
- *--------------------------------------------------------------------*/
- #include "../tools/getoptv.h"
- #include "../tools/putoptv.h"
- #include "../tools/memory.h"
- #include "../tools/number.h"
- #include "../tools/symbol.h"
- #include "../tools/types.h"
- #include "../tools/flags.h"
- #include "../tools/files.h"
- #include "../tools/error.h"
- #include "../plc/plc.h"
- /*====================================================================*
- * custom source files;
- *--------------------------------------------------------------------*/
- #ifndef MAKEFILE
- #include "../plc/Confirm.c"
- #include "../plc/Display.c"
- #include "../plc/Failure.c"
- #include "../plc/Request.c"
- #include "../plc/ReadMME.c"
- #include "../plc/SendMME.c"
- #include "../mme/UnwantedMessage.c"
- #include "../plc/Devices.c"
- #endif
- #ifndef MAKEFILE
- #include "../tools/getoptv.c"
- #include "../tools/putoptv.c"
- #include "../tools/version.c"
- #include "../tools/uintspec.c"
- #include "../tools/hexdump.c"
- #include "../tools/hexencode.c"
- #include "../tools/hexdecode.c"
- #include "../tools/todigit.c"
- #include "../tools/synonym.c"
- #include "../tools/error.c"
- #endif
- #ifndef MAKEFILE
- #include "../ether/openchannel.c"
- #include "../ether/closechannel.c"
- #include "../ether/readpacket.c"
- #include "../ether/sendpacket.c"
- #include "../ether/channel.c"
- #endif
- #ifndef MAKEFILE
- #include "../mme/MMECode.c"
- #include "../mme/EthernetHeader.c"
- #include "../mme/QualcommHeader.c"
- #endif
- /*====================================================================*
- * program constants;
- *--------------------------------------------------------------------*/
- #define PLCOTST_MVERSION 0
- #define PLCOTST_RUNAFTERRESET 1
- #define PLCOTST_DELAYTORUN 0
- #define PLCOTST_MEMRUNS 0
- #define PLCOTST_FLASHRUNS 0
- #define PLCOTST_RESETONDONE 0
- /*====================================================================*
- * program variables;
- *--------------------------------------------------------------------*/
- #ifndef __GNUC__
- #pragma pack (push,1)
- #endif
- typedef struct __packed selftest
- {
- uint8_t MVERSION;
- uint8_t RUNAFTERRESET;
- uint32_t DELAYTORUN;
- uint32_t MEMRUNS;
- uint32_t FLASHRUNS;
- uint8_t RESETONDONE;
- }
- selftest;
- #ifndef __GNUC__
- #pragma pack (pop)
- #endif
- /*====================================================================*
- *
- * signed configure (struct plc * plc, struct selftest * selftest);
- *
- *
- *--------------------------------------------------------------------*/
- static signed configure (struct plc * plc, struct selftest * selftest)
- {
- struct channel * channel = (struct channel *)(plc->channel);
- struct message * message = (struct message *)(plc->message);
- #ifndef __GNUC__
- #pragma pack (push,1)
- #endif
- struct __packed vs_selftest_onetime_config_request
- {
- struct ethernet_hdr ethernet;
- struct qualcomm_hdr qualcomm;
- uint8_t MVERSION;
- uint8_t RUNAFTERRESET;
- uint32_t DELAYTORUN;
- uint32_t MEMRUNS;
- uint32_t FLASHRUNS;
- uint8_t RESETONDONE;
- }
- * request = (struct vs_selftest_onetime_config_request *) (message);
- struct __packed vs_selftest_onetime_config_confirm
- {
- struct ethernet_hdr ethernet;
- struct qualcomm_hdr qualcomm;
- uint8_t MSTATUS;
- }
- * confirm = (struct vs_selftest_onetime_config_confirm *) (message);
- #ifndef __GNUC__
- #pragma pack (pop)
- #endif
- Request (plc, "Configure One-Time Self-Test");
- memset (message, 0, sizeof (* message));
- EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type);
- QualcommHeader (&request->qualcomm, 0, (VS_SELFTEST_ONETIME_CONFIG | MMTYPE_REQ));
- request->MVERSION = selftest->MVERSION;
- request->RUNAFTERRESET = selftest->RUNAFTERRESET;
- request->DELAYTORUN = HTOLE32 (selftest->DELAYTORUN);
- request->MEMRUNS = HTOLE32 (selftest->MEMRUNS);
- request->FLASHRUNS = HTOLE32 (selftest->FLASHRUNS);
- request->RESETONDONE = selftest->RESETONDONE;
- plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN);
- if (SendMME (plc) <= 0)
- {
- error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND);
- return (-1);
- }
- while (ReadMME (plc, 0, (VS_SELFTEST_ONETIME_CONFIG | MMTYPE_CNF)) > 0)
- {
- if (confirm->MSTATUS)
- {
- Failure (plc, PLC_WONTDOIT);
- continue;
- }
- Display (plc, "%s", "Configured");
- }
- return (0);
- }
- /*====================================================================*
- *
- * signed retrieve (struct plc * plc, struct selftest * selftest);
- *
- *
- *--------------------------------------------------------------------*/
- static signed retrieve (struct plc * plc, struct selftest * selftest)
- {
- struct channel * channel = (struct channel *)(plc->channel);
- struct message * message = (struct message *)(plc->message);
- #ifndef __GNUC__
- #pragma pack (push,1)
- #endif
- struct __packed vs_selftest_results_request
- {
- struct ethernet_hdr ethernet;
- struct qualcomm_hdr qualcomm;
- uint8_t MVERSION;
- uint8_t MACTION;
- }
- * request = (struct vs_selftest_results_request *) (message);
- struct __packed vs_selftest_results_confirm
- {
- struct ethernet_hdr ethernet;
- struct qualcomm_hdr qualcomm;
- uint8_t MVERSION;
- uint8_t MSTATUS;
- uint32_t NUMBER [6];
- }
- * confirm = (struct vs_selftest_results_confirm *) (message);
- #ifndef __GNUC__
- #pragma pack (pop)
- #endif
- Request (plc, "Retrieve Self-Test Results");
- memset (message, 0, sizeof (* message));
- EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type);
- QualcommHeader (&request->qualcomm, 0, (VS_SELFTEST_RESULTS | MMTYPE_REQ));
- request->MVERSION = selftest->MVERSION;
- request->MACTION = plc->action;
- plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN);
- if (SendMME (plc) <= 0)
- {
- error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND);
- return (-1);
- }
- while (ReadMME (plc, 0, (VS_SELFTEST_RESULTS | MMTYPE_CNF)) > 0)
- {
- if ((confirm->MSTATUS == 2) || (confirm->MSTATUS == 4) || (confirm->MSTATUS == 6))
- {
- Display (plc, "Memory test %d Passed %d Failed %d Flash test %d Passed %d Failed %d", LE32TOH (confirm->NUMBER [0]), LE32TOH (confirm->NUMBER [1]), LE32TOH (confirm->NUMBER [2]), LE32TOH (confirm->NUMBER [3]), LE32TOH (confirm->NUMBER [4]), LE32TOH (confirm->NUMBER [5]));
- continue;
- }
- if (confirm->MSTATUS == 3)
- {
- Failure (plc, "%d seconds remaining", LE32TOH (confirm->NUMBER [0]));
- continue;
- }
- if (confirm->MSTATUS)
- {
- Failure (plc, PLC_WONTDOIT);
- continue;
- }
- Confirm (plc, "Cleared Results");
- }
- return (0);
- }
- /*====================================================================*
- *
- * signed manager (struct plc * plc, struct selftest * selftest);
- *
- *
- *--------------------------------------------------------------------*/
- static signed manager (struct plc * plc, struct selftest * selftest)
- {
- if (_anyset (plc->flags, PLC_CONFIGURE))
- {
- configure (plc, selftest);
- }
- if (_anyset (plc->flags, PLC_RESULTS))
- {
- retrieve (plc, selftest);
- }
- return (0);
- }
- /*====================================================================*
- *
- * int main (int argc, char const * argv[]);
- *
- *
- *--------------------------------------------------------------------*/
- int main (int argc, char const * argv [])
- {
- extern struct channel channel;
- static char const * optv [] =
- {
- "c:Cd:ef:i:m:qr:R:t:vx",
- "device [device] [...] [> stdout]",
- "Qualcomm Atheros Powerline One-Time Self-Test Manager",
- "c n\tconfiguration version",
- "C\tclear selftest results",
- "d n\tdelay selftest start by (n) seconds [" LITERAL (PLCOTST_DELAYTORUN) "]",
- "e\tredirect stderr to stdout",
- "f n\trun flash selftest (n) times [" LITERAL (PLCOTST_FLASHRUNS) "]",
- #if defined (WINPCAP) || defined (LIBPCAP)
- "i n\thost interface is (n) [" LITERAL (CHANNEL_ETHNUMBER) "]",
- #else
- "i s\thost interface is (s) [" LITERAL (CHANNEL_ETHDEVICE) "]",
- #endif
- "m n\trun memory selftest (n) times [" LITERAL (PLCOTST_MEMRUNS) "]",
- "q\tquiet mode",
- "r n\trun selftest after reset [" LITERAL (PLCOTST_RUNAFTERRESET) "]",
- "R n\treset after selftest completes [" LITERAL (PLCOTST_RESETONDONE) "]",
- "t n\tread timeout is (n) milliseconds [" LITERAL (CHANNEL_TIMEOUT) "]",
- "v\tverbose mode",
- "x\texit on error",
- (char const *) (0)
- };
- #include "../plc/plc.c"
- struct selftest selftest =
- {
- PLCOTST_MVERSION,
- PLCOTST_RUNAFTERRESET,
- PLCOTST_DELAYTORUN,
- PLCOTST_MEMRUNS,
- PLCOTST_FLASHRUNS,
- PLCOTST_RESETONDONE
- };
- signed c;
- if (getenv (PLCDEVICE))
- {
- channel.ifname = strdup (getenv (PLCDEVICE));
- }
- optind = 1;
- while ((c = getoptv (argc, argv, optv)) != -1)
- {
- switch (c)
- {
- case 'c':
- selftest.MVERSION = (uint8_t)(uintspec (optarg, 0, UCHAR_MAX));
- break;
- case 'C':
- _setbits (plc.flags, PLC_RESULTS);
- plc.action = 1;
- break;
- case 'd':
- _setbits (plc.flags, PLC_CONFIGURE);
- selftest.DELAYTORUN = (uint32_t)(uintspec (optarg, 0, UINT_MAX));
- break;
- case 'e':
- dup2 (STDOUT_FILENO, STDERR_FILENO);
- break;
- case 'f':
- _setbits (plc.flags, PLC_CONFIGURE);
- selftest.FLASHRUNS = (uint32_t)(uintspec (optarg, 0, UINT_MAX));
- break;
- case 'i':
- #if defined (WINPCAP) || defined (LIBPCAP)
- channel.ifindex = atoi (optarg);
- #else
- channel.ifname = optarg;
- #endif
- break;
- case 'm':
- _setbits (plc.flags, PLC_CONFIGURE);
- selftest.MEMRUNS = (uint32_t)(uintspec (optarg, 0, UINT_MAX));
- break;
- case 'q':
- _setbits (channel.flags, CHANNEL_SILENCE);
- _setbits (plc.flags, PLC_SILENCE);
- break;
- case 'r':
- _setbits (plc.flags, PLC_CONFIGURE);
- selftest.RUNAFTERRESET = (uint8_t)(uintspec (optarg, false, true));
- break;
- case 'R':
- _setbits (plc.flags, PLC_CONFIGURE);
- selftest.RESETONDONE = (uint8_t)(uintspec (optarg, false, true));
- break;
- case 't':
- channel.timeout = (signed)(uintspec (optarg, 0, UINT_MAX));
- break;
- case 'v':
- _setbits (channel.flags, CHANNEL_VERBOSE);
- _setbits (plc.flags, PLC_VERBOSE);
- break;
- case 'x':
- _setbits (plc.flags, PLC_BAILOUT);
- break;
- default:
- break;
- }
- }
- argc -= optind;
- argv += optind;
- if (_allclr (plc.flags, (PLC_CONFIGURE | PLC_RESULTS)))
- {
- _setbits (plc.flags, PLC_RESULTS);
- }
- openchannel (&channel);
- if (!(plc.message = malloc (sizeof (* plc.message))))
- {
- error (1, errno, PLC_NOMEMORY);
- }
- if (!argc)
- {
- manager (&plc, &selftest);
- }
- while ((argc) && (* argv))
- {
- if (!hexencode (channel.peer, sizeof (channel.peer), synonym (* argv, devices, SIZEOF (devices))))
- {
- error (1, errno, PLC_BAD_MAC, * argv);
- }
- manager (&plc, &selftest);
- argv++;
- argc--;
- }
- free (plc.message);
- closechannel (&channel);
- return (0);
- }
- </pre>
- <div class='footerlink'>
- [<a href='PLCNetworkInfo.c.html' title=' PLCNetworkInfo.c '>PREV</a>]
- [<a href='toolkit.html' title=' Index '>HOME</a>]
- [<a href='PLCPhyRates.c.html' title=' PLCPhyRates.c '>NEXT</a>]
- </div>
- </body>
- </html>
|
