plctest.c
Author: cmaier@cmassoc.net

    /*====================================================================*
     *
     *   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.
     *
     *--------------------------------------------------------------------*/

    /*====================================================================*"
     *
     *   plctest.c - Atheros Test Applet Loader;
     *
     *
     *   Contributor(s):
     *      Charles Maier <cmaier@qca.qualcomm.com>
     *
     *--------------------------------------------------------------------*/

    /*====================================================================*"
     *   system header files;
     *--------------------------------------------------------------------*/

    #include <unistd.h>
    #include <stdlib.h>
    #include <stdint.h>
    #include <limits.h>
    #include <errno.h>

    /*====================================================================*
     *   custom header files;
     *--------------------------------------------------------------------*/

    #include "../tools/getoptv.h"
    #include "../tools/putoptv.h"
    #include "../tools/memory.h"
    #include "../tools/number.h"
    #include "../tools/types.h"
    #include "../tools/flags.h"
    #include "../tools/files.h"
    #include "../tools/error.h"
    #include "../ether/channel.h"
    #include "../ram/nvram.h"
    #include "../ram/sdram.h"
    #include "../nvm/nvm.h"
    #include "../pib/pib.h"
    #include "../plc/plc.h"

    /*====================================================================*
     *   custom source files;
     *--------------------------------------------------------------------*/

    #ifndef MAKEFILE
    #include "../plc/chipset.c"
    #include "../plc/Confirm.c"
    #include "../plc/Devices.c"
    #include "../plc/Display.c"
    #include "../plc/ExecuteApplets.c"
    #include "../plc/ExecuteApplets1.c"
    #include "../plc/ExecuteApplets2.c"
    #include "../plc/Failure.c"
    #include "../plc/NVMSelect.c"
    #include "../plc/Request.c"
    #include "../plc/SendMME.c"
    #include "../plc/StartFirmware1.c"
    #include "../plc/WaitForStart.c"
    #include "../plc/WriteExecuteApplet2.c"
    #include "../plc/WriteExecuteFirmware1.c"
    #include "../plc/WriteExecuteFirmware2.c"
    #include "../plc/WriteFirmware1.c"
    #include "../plc/WriteFirmware2.c"
    #endif

    #ifndef MAKEFILE
    #include "../tools/getoptv.c"
    #include "../tools/putoptv.c"
    #include "../tools/version.c"
    #include "../tools/uintspec.c"
    #include "../tools/checkfilename.c"
    #include "../tools/hexdecode.c"
    #include "../tools/todigit.c"
    #include "../tools/hexdump.c"
    #include "../tools/checksum32.c"
    #include "../tools/fdchecksum32.c"
    #include "../tools/error.c"
    #include "../tools/strfbits.c"
    #include "../tools/typename.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 "../nvm/nvmfile.c"
    #include "../nvm/nvmfile1.c"
    #include "../nvm/nvmfile2.c"
    #endif

    #ifndef MAKEFILE
    #include "../mme/EthernetHeader.c"
    #include "../mme/QualcommHeader.c"
    #include "../mme/UnwantedMessage.c"
    #include "../mme/FirmwareMessage.c"
    #include "../mme/ARPCPrint.c"
    #include "../mme/MMECode.c"
    #endif

    /*====================================================================*
     *
     *   signed ReadMME (struct plc * plc, uint8_t MMV, uint16_t MMTYPE);
     *
     *   plc.h
     *
     *   this version of ReadMME() calls FirmwareMessage() to intercept
     *   VS_ARPC messages and print them on stdout in readable format;
     *
     *
     *   Contributor(s):
     *      Charles Maier <cmaier@qca.qualcomm.com>
     *      Matthieu Poullet <m.poullet@avm.de>
     *
     *--------------------------------------------------------------------*/

    signed ReadMME (struct plc * plc, uint8_t MMV, uint16_t MMTYPE)

    {
    	struct channel * channel = (struct channel *)(plc->channel);
    	struct message * message = (struct message *)(plc->message);
    	while ((plc->packetsize = readpacket (channel, message, sizeof (* message))) > 0)
    	{
    		if (FirmwareMessage (message))
    		{
    			continue;
    		}
    		if (UnwantedMessage (message, plc->packetsize, MMV, MMTYPE))
    		{
    			continue;
    		}
    		break;
    	}
    	return (plc->packetsize);
    }

    /*====================================================================*
     *
     *   void sequence (struct plc * plc, int argc, char const * argv);
     *
     *   open each file on the command line and execute all applets in
     *   each file; move on if errors occur;
     *
     *
     *   Contributor(s):
     *      Charles Maier <cmaier@qca.qualcomm.com>
     *
     *--------------------------------------------------------------------*/

    static void sequence (struct plc * plc, int argc, char const * argv [])

    {
    	while ((argc) && (* argv))
    	{
    		if ((plc->NVM.file = open (plc->NVM.name = * argv, O_BINARY|O_RDONLY)) == -1)
    		{
    			error (0, errno, FILE_CANTOPEN, plc->NVM.name);
    		}
    		else if (nvmfile (&plc->NVM))
    		{
    			error (0, errno, FILE_CANTLOAD, plc->NVM.name);
    		}
    		else
    		{
    			ExecuteApplets (plc);
    		}
    		close (plc->NVM.file);
    		argc--;
    		argv++;
    	}
    	return;
    }

    /*====================================================================*
     *
     *   int main (int argc, char const * argv[]);
     *
     *   parse command line, populate plc structure and perform selected
     *   operations; show help summary when asked; see getoptv and putoptv
     *   to understand command line parsing and help summary display; see
     *   plc.h for the definition of struct plc;
     *
     *   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;
     *
     *
     *   Contributor(s):
     *      Charles Maier <cmaier@qca.qualcomm.com>
     *
     *--------------------------------------------------------------------*/

    int main (int argc, char const * argv [])

    {
    	extern struct channel channel;
    	char firmware [PLC_VERSION_STRING];
    	static char const * optv [] =
    	{
    		"ei:lqt:vw:xX",
    		"file [file] [...]",
    		"Qualcomm Atheros PLC Test Applet Loader",
    		"e\tredirect stderr to stdout",

    #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

    		"l\tloop until program is terminated",
    		"q\tquiet mode",
    		"t n\tread timeout is (n) milliseconds [" LITERAL (CHANNEL_TIMEOUT) "]",
    		"v\tverbose mode",
    		"w n\twait time is (n) seconds [" LITERAL (PLC_TIMER) "]",
    		"x\texit on error",
    		"X\texit on start",
    		(char const *) (0)
    	};

    #include "../plc/plc.c"

    	signed loop = 0;
    	signed c;
    	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 'e':
    			dup2 (STDOUT_FILENO, STDERR_FILENO);
    			break;
    		case 'i':

    #if defined (WINPCAP) || defined (LIBPCAP)

    			channel.ifindex = atoi (optarg);

    #else

    			channel.ifname = optarg;

    #endif

    			break;
    		case 'l':
    			loop = 1;
    			break;
    		case 'q':
    			_setbits (channel.flags, CHANNEL_SILENCE);
    			_setbits (plc.flags, PLC_SILENCE);
    			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, 3600));
    			break;
    		case 'x':
    			_setbits (plc.flags, PLC_BAILOUT);
    			break;
    		case 'X':
    			_setbits (plc.flags, PLC_QUICK_FLASH);
    			break;
    		}
    	}
    	argc -= optind;
    	argv += optind;
    	openchannel (&channel);
    	if (!(plc.message = malloc (sizeof (* plc.message))))
    	{
    		error (1, errno, PLC_NOMEMORY);
    	}
    	if (WaitForStart (&plc, firmware, sizeof (firmware)))
    	{
    		error (1, ECANCELED, PLC_NODETECT);
    	}
    	if (strcmp (firmware, "BootLoader"))
    	{
    		error (1, ECANCELED, "BootLoader must be running");
    	}
    	do
    	{
    		sequence (&plc, argc, argv);
    	}
    	while (loop);
    	free (plc.message);
    	closechannel (&channel);
    	return (plc.state);
    }

[PREV] [HOME] [NEXT]