/*====================================================================* * * 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. * *--------------------------------------------------------------------*/ /*====================================================================*" * * ampwait.c - * * * Contributor(s): * Charles Maier * Nathaniel Houghton * Werner Henze * *--------------------------------------------------------------------*/ /*====================================================================*" * system header files; *--------------------------------------------------------------------*/ #include #include #include #include #include /*====================================================================* * 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/timer.h" #include "../tools/error.h" #include "../tools/permissions.h" #include "../plc/plc.h" /*====================================================================* * custom source files; *--------------------------------------------------------------------*/ #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/checkfilename.c" #include "../tools/synonym.c" #include "../tools/error.c" #include "../tools/desuid.c" #endif #ifndef MAKEFILE #include "../plc/Confirm.c" #include "../plc/Display.c" #include "../plc/Failure.c" #include "../plc/ReadMME.c" #include "../plc/Request.c" #include "../plc/SendMME.c" #include "../plc/Devices.c" #endif #ifndef MAKEFILE #include "../ether/initchannel.c" #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" #include "../mme/QualcommHeader1.c" #include "../mme/UnwantedMessage.c" #endif /*====================================================================* * * signed ResetAndWait (struct plc * plc); * * plc.h * * send VS_RS_DEV.REQ messages every channel->timeout milliseconds * until the device responds to indicate that it is ready to reset; * return 0 if the device eventually responds within plc->timer * seconds or -1 if not; * * Contributor(s): * Charles Maier * Nathaniel Houghton * *--------------------------------------------------------------------*/ signed ResetAndWait (struct plc * plc) { struct channel * channel = (struct channel *)(plc->channel); struct message * message = (struct message *)(plc->message); struct timeval ts; struct timeval tc; unsigned timer = 0; #ifndef __GNUC__ #pragma pack (push,1) #endif struct __packed vs_rs_dev_request { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; } * request = (struct vs_rs_dev_request *) (message); struct __packed vs_rs_dev_confirm { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint8_t MSTATUS; } * confirm = (struct vs_rs_dev_confirm *) (message); #ifndef __GNUC__ #pragma pack (pop) #endif Request (plc, "Reset when Ready"); if (gettimeofday (&ts, NULL) == -1) { error (1, errno, CANT_START_TIMER); } for (timer = 0; timer < plc->timer; timer = SECONDS (ts, tc)) { memset (message, 0, sizeof (* message)); EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type); QualcommHeader (&request->qualcomm, 0, (VS_RS_DEV | MMTYPE_REQ)); plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN); if (SendMME (plc) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND); return (-1); } if (ReadMME (plc, 0, (VS_RS_DEV | MMTYPE_CNF)) < 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD); return (-1); } if (gettimeofday (&tc, NULL) == -1) { error (1, errno, CANT_RESET_TIMER); } if (plc->packetsize) { if (!confirm->MSTATUS) { Confirm (plc, "Resetting ..."); return (0); } } } return (-1); } /*====================================================================* * * signed WaitForReset (struct plc * plc, char string [], size_t length); * * plc.h * * send VS_SW_VER.REQ messages every channel->timeout milliseconds * until the device stops responding to indicate that it is inactive; * return 0 if the device eventually stops responding within * plc->timer seconds or -1 if not; * * this function cannot distinguish between a software reset and * hardware reset; * * Contributor(s): * Charles Maier * Nathaniel Houghton * Werner Henze * *--------------------------------------------------------------------*/ signed WaitForReset (struct plc * plc) { struct channel * channel = (struct channel *)(plc->channel); struct message * message = (struct message *)(plc->message); struct timeval ts; struct timeval tc; unsigned timer = 0; #ifndef __GNUC__ #pragma pack (push,1) #endif struct __packed vs_sw_ver_request { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint8_t MSTATUS; uint8_t MDEVICEID; uint8_t MVERLENGTH; char MVERSION [PLC_VERSION_STRING]; } * request = (struct vs_sw_ver_request *) (message); #ifndef __GNUC__ #pragma pack (pop) #endif Request (plc, "Allow %d seconds for Reset", plc->timer); if (gettimeofday (&ts, NULL) == -1) { error (1, errno, CANT_START_TIMER); } for (timer = 0; timer < plc->timer; timer = SECONDS (ts, tc)) { memset (message, 0, sizeof (* message)); EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type); QualcommHeader (&request->qualcomm, 0, (VS_SW_VER | MMTYPE_REQ)); plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN); if (SendMME (plc) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND); return (-1); } if (ReadMME (plc, 0, (VS_SW_VER | MMTYPE_CNF)) < 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD); return (-1); } if (gettimeofday (&tc, NULL) == -1) { error (1, errno, CANT_RESET_TIMER); } if (!plc->packetsize) { if (_allset (plc->flags, (PLC_WAITFORRESET | PLC_ANALYSE))) { Confirm (plc, "Waited %d seconds for Reset", timer); } return (0); } } if (_allset (plc->flags, (PLC_WAITFORRESET | PLC_ANALYSE))) { Confirm (plc, "Waited %d seconds for Reset", timer); } return (-1); } /*====================================================================* * * signed WaitForStart (struct plc * plc, char string [], size_t length); * * plc.h * * send VS_SW_VER.REQ messages every channel->timeout milliseconds * until the device responds to indicate that it is active; return * 0 if the device eventually responds within plc->timer seconds * or -1 if not; * * Contributor(s): * Charles Maier * Nathaniel Houghton * *--------------------------------------------------------------------*/ signed WaitForStart (struct plc * plc, char string [], size_t length) { struct channel * channel = (struct channel *)(plc->channel); struct message * message = (struct message *)(plc->message); struct timeval ts; struct timeval tc; unsigned timer = 0; #ifndef __GNUC__ #pragma pack (push,1) #endif struct __packed vs_sw_ver_request { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint8_t MSTATUS; uint8_t MDEVICEID; uint8_t MVERLENGTH; char MVERSION [PLC_VERSION_STRING]; } * request = (struct vs_sw_ver_request *) (message); struct __packed vs_sw_ver_confirm { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint8_t MSTATUS; uint8_t MDEVICEID; uint8_t MVERLENGTH; char MVERSION [PLC_VERSION_STRING]; } * confirm = (struct vs_sw_ver_confirm *) (message); #ifndef __GNUC__ #pragma pack (pop) #endif Request (plc, "Allow %d seconds for Start", plc->timer); if (gettimeofday (&ts, NULL) == -1) { error (1, errno, CANT_START_TIMER); } for (timer = 0; timer < plc->timer; timer = SECONDS (ts, tc)) { memset (message, 0, sizeof (* message)); EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type); QualcommHeader (&request->qualcomm, 0, (VS_SW_VER | MMTYPE_REQ)); plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN); if (SendMME (plc) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND); return (-1); } if (ReadMME (plc, 0, (VS_SW_VER | MMTYPE_CNF)) < 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD); return (-1); } if (gettimeofday (&tc, NULL) == -1) { error (1, errno, CANT_RESET_TIMER); } if (plc->packetsize) { if (confirm->MSTATUS) { Failure (plc, PLC_WONTDOIT); return (-1); } if (_allset (plc->flags, (PLC_WAITFORSTART | PLC_ANALYSE))) { Confirm (plc, "Waited %d seconds for Start", timer); } strncpy (string, confirm->MVERSION, length); return (0); } } if (_allset (plc->flags, (PLC_WAITFORSTART | PLC_ANALYSE))) { Confirm (plc, "Waited %d seconds for Start", timer); } return (-1); } /*====================================================================* * * signed WaitForAssoc (struct plc * plc); * * plc.h * * send VS_NW_INFO.REQ messages every channel->timeout milliseconds * until the device reports that a network has formed; return 0 if a * network forms within plc->timer seconds or -1 if not; * * Contributor(s): * Charles Maier * Nathaniel Houghton * *--------------------------------------------------------------------*/ signed WaitForAssoc (struct plc * plc) { extern const uint8_t broadcast [ETHER_ADDR_LEN]; struct channel * channel = (struct channel *)(plc->channel); struct message * message = (struct message *)(plc->message); struct timeval ts; struct timeval tc; unsigned timer = 0; #ifndef __GNUC__ #pragma pack (push,1) #endif struct __packed vs_nw_info_request { struct ethernet_hdr ethernet; struct qualcomm_fmi qualcomm; } * request = (struct vs_nw_info_request *)(message); struct __packed vs_nw_info_confirm { struct ethernet_hdr ethernet; struct qualcomm_fmi qualcomm; uint8_t SUB_VERSION; uint8_t Reserved; uint16_t DATA_LEN; uint8_t DATA [1]; } * confirm = (struct vs_nw_info_confirm *)(message); struct __packed station { uint8_t MAC [ETHER_ADDR_LEN]; uint8_t TEI; uint8_t Reserved [3]; uint8_t BDA [ETHER_ADDR_LEN]; uint16_t AVGTX; uint8_t COUPLING; uint8_t Reserved3; uint16_t AVGRX; uint16_t Reserved4; } * station; struct __packed network { uint8_t NID [7]; uint8_t Reserved1 [2]; uint8_t SNID; uint8_t TEI; uint8_t Reserved2 [4]; uint8_t ROLE; uint8_t CCO_MAC [ETHER_ADDR_LEN]; uint8_t CCO_TEI; uint8_t Reserved3 [3]; uint8_t NUMSTAS; uint8_t Reserved4 [5]; struct station stations [1]; } * network; struct __packed networks { uint8_t Reserved; uint8_t NUMAVLNS; struct network networks [1]; } * networks = (struct networks *) (confirm->DATA); #ifndef __GNUC__ #pragma pack (pop) #endif Request (plc, "Allow %d seconds for Assoc", plc->timer); if (gettimeofday (&ts, NULL) == -1) { error (1, errno, CANT_START_TIMER); } for (timer = 0; timer < plc->timer; timer = SECONDS (ts, tc)) { memset (message, 0, sizeof (* message)); EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type); QualcommHeader1 (&request->qualcomm, 1, (VS_NW_INFO | MMTYPE_REQ)); plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN); if (SendMME (plc) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND); return (-1); } if (ReadMME (plc, 1, (VS_NW_INFO | MMTYPE_CNF)) < 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD); return (-1); } if (gettimeofday (&tc, NULL) == -1) { error (1, errno, CANT_RESET_TIMER); } if (plc->packetsize) { network = (struct network *)(&networks->networks); while (networks->NUMAVLNS--) { station = (struct station *)(&network->stations); while (network->NUMSTAS--) { if (memcmp (station->MAC, broadcast, sizeof (broadcast))) { if (_allset (plc->flags, (PLC_WAITFORASSOC | PLC_ANALYSE))) { Confirm (plc, "Waited %d seconds for Assoc", timer); } return (0); } station++; } network = (struct network *)(station); } } } if (_allset (plc->flags, (PLC_WAITFORASSOC | PLC_ANALYSE))) { Confirm (plc, "Waited %d seconds for Assoc", timer); } return (-1); } /*====================================================================* * * void function (struct plc * plc, char const * firmware); * * perform operations in a logical order; * * *--------------------------------------------------------------------*/ static void function (struct plc * plc, char const * firmware) { char string [PLC_VERSION_STRING]; if (_anyset (plc->flags, PLC_RESET_DEVICE)) { if (ResetAndWait (plc)) { Failure (plc, "Device did not Reset."); } } if (_anyset (plc->flags, PLC_WAITFORRESET)) { if (WaitForReset (plc)) { Failure (plc, "Device did not Reset."); } } if (_anyset (plc->flags, PLC_WAITFORSTART)) { if (WaitForStart (plc, string, sizeof (string))) { Failure (plc, "Device did not Start."); } if ((firmware) && (*firmware) && strcmp (firmware, string)) { Failure (plc, "Started wrong firmware"); } } if (_anyset (plc->flags, PLC_WAITFORASSOC)) { if (WaitForAssoc (plc)) { Failure (plc, "Device did not Assoc."); } } if (plc->sleep) { Request (plc, "Pause %d seconds", plc->sleep); sleep (plc->sleep); } return; } /*====================================================================* * * int main (int argc, char const * argv[]); * * parse command line, populate plc structure and perform selected * operations; show help summary if asked; see getoptv and putoptv * to understand command line parsing and help summary display; see * plc.h for the definition of struct plc; * * the command line accepts multiple MAC addresses and the program * performs the specified operations on each address, in turn; the * address order is significant but the option order is not; the * default address is a local broadcast that causes all devices on * the local H1 interface to respond but not those at the remote * end of the powerline; * * the default address is 00:B0:52:00:00:01; omitting the address * will automatically address the local device; some options will * cancel themselves if this makes no sense; * * the default interface is eth1 because most people use eth0 as * their principle network connection; you can specify another * interface with -i or define environment string PLC to make * that the default interface and save typing; * * *--------------------------------------------------------------------*/ int main (int argc, char const * argv []) { extern struct channel channel; static char const * optv [] = { "aef:i:p:qrRstvw:xy", "device [device] [...] [> stdout]", "Qualcomm Atheros Powerline Procrastinator", "a\twait for device assoc", "e\tredirect stderr to stdout", "f s\tconfirm firmware is revision s", #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 "p n\tpause (n) seconds", "q\tquiet mode", "r\twait for device reset", "R\treset device and wait", "s\twait for device start", "t n\tchannel timeout is (n) milliseconds [" LITERAL (CHANNEL_TIMEOUT) "]", "v\tverbose mode", "w n\twait up to (n) seconds for action [" LITERAL (PLC_TIMER) "]", "x\texit on error", "y\treport failure times", (char const *) (0) }; #include "../plc/plc.c" char const * firmware = ""; signed c; initchannel (&channel); desuid (); if (getenv (PLCDEVICE)) { #if defined (WINPCAP) || defined (LIBPCAP) channel.ifindex = atoi (getenv (PLCDEVICE)); #else channel.ifname = strdup (getenv (PLCDEVICE)); #endif } optind = 1; while ((c = getoptv (argc, argv, optv)) != -1) { switch (c) { case 'a': _setbits (plc.flags, PLC_WAITFORASSOC); break; case 'e': dup2 (STDOUT_FILENO, STDERR_FILENO); break; case 'f': firmware = optarg; break; case 'i': #if defined (WINPCAP) || defined (LIBPCAP) channel.ifindex = atoi (optarg); #else channel.ifname = optarg; #endif break; case 'p': plc.sleep = (unsigned)(uintspec (optarg, 0, 3600)); break; case 'q': _setbits (channel.flags, CHANNEL_SILENCE); _setbits (plc.flags, PLC_SILENCE); break; case 'r': _setbits (plc.flags, PLC_WAITFORRESET); break; case 'R': _setbits (plc.flags, PLC_RESET_DEVICE); break; case 's': _setbits (plc.flags, PLC_WAITFORSTART); 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 'w': plc.timer = (unsigned)(uintspec (optarg, 0, 86400)); break; case 'x': _setbits (plc.flags, PLC_BAILOUT); break; case 'y': _setbits (plc.flags, PLC_ANALYSE); break; default: break; } } argc -= optind; argv += optind; openchannel (&channel); if (!(plc.message = malloc (sizeof (* plc.message)))) { error (1, errno, PLC_NOMEMORY); } if (!argc) { function (&plc, firmware); } while ((argc) && (* argv)) { if (!hexencode (channel.peer, sizeof (channel.peer), synonym (* argv, devices, SIZEOF (devices)))) { error (1, errno, PLC_BAD_MAC, * argv); } function (&plc, firmware); argv++; argc--; } free (plc.message); closechannel (&channel); exit (0); }