/*====================================================================*
*
* 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.
*
*--------------------------------------------------------------------*/
/*====================================================================*
*
* plcID.c - Qualcomm Atheros Powerline Device Identity
*
*
* Contributor(s):
* Charles Maier <cmaier@qca.qualcomm.com>
*
*--------------------------------------------------------------------*/
/*====================================================================*"
* system header files;
*--------------------------------------------------------------------*/
#include <unistd.h>
#include <stdlib.h>
#include <limits.h>
#include <string.h>
#include <ctype.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"
#include "../ram/nvram.h"
#include "../ram/sdram.h"
#include "../nvm/nvm.h"
#include "../pib/pib.h"
#include "../mme/mme.h"
/*====================================================================*
* custom source files;
*--------------------------------------------------------------------*/
#ifndef MAKEFILE
#include "../tools/getoptv.c"
#include "../tools/putoptv.c"
#include "../tools/version.c"
#include "../tools/uintspec.c"
#include "../tools/hexencode.c"
#include "../tools/hexdecode.c"
#include "../tools/todigit.c"
#include "../tools/hexdump.c"
#include "../tools/hexout.c"
#include "../tools/error.c"
#include "../tools/synonym.c"
#include "../tools/checksum32.c"
#include "../tools/typename.c"
#endif
#ifndef MAKEFILE
#include "../plc/Display.c"
#include "../plc/Devices.c"
#include "../plc/Failure.c"
#include "../plc/ReadMME.c"
#include "../plc/SendMME.c"
#include "../plc/WaitForStart.c"
#include "../plc/chipset.c"
#endif
#ifndef MAKEFILE
#include "../mme/EthernetHeader.c"
#include "../mme/QualcommHeader.c"
#include "../mme/UnwantedMessage.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"
#endif
/*====================================================================*
* program constants;
*--------------------------------------------------------------------*/
#define PLCID_DAK 0
#define PLCID_NMK 1
#define PLCID_MAC 2
#define PLCID_MFG 3
#define PLCID_USR 4
#define PLCID_NET 5
/*====================================================================*
*
* signed PLCSelect (struct plc * plc, signed old (struct plc *), signed new (struct plc *));
*
* plc.h
*
* wait for device to start in order to determine chipset then call
* the approproate function based on chipset; unfortunately, chipset
* detection and selection may not be this simple in the future;
*
* Contributor(s):
* Charles Maier <cmaier@qca.qualcomm.com>
*
*--------------------------------------------------------------------*/
signed PLCSelect (struct plc * plc, signed old (struct plc *), signed new (struct plc *))
{
char firmware [PLC_VERSION_STRING];
if (WaitForStart (plc, firmware, sizeof (firmware)))
{
Failure (plc, PLC_NODETECT);
exit (1);
}
return ((plc->hardwareID < CHIPSET_QCA7420)? old (plc): new (plc));
}
/*====================================================================*
*
* signed ReadKey1 (struct plc * plc);
*
* read the first block of the PIB from a device then echo one of
* several parameters on stdout as a string; program output can be
* used in scripts to define variables or compare strings;
*
* this function is an abridged version of ReadParameters(); it reads only
* the first 1024 bytes of the PIB then stops; most parameters of
* general interest occur in that block;
*
*--------------------------------------------------------------------*/
static signed ReadKey1 (struct plc * plc)
{
static signed count = 0;
struct channel * channel = (struct channel *) (plc->channel);
struct message * message = (struct message *) (plc->message);
#ifndef __GNUC__
#pragma pack (push,1)
#endif
struct __packed vs_rd_mod_request
{
struct ethernet_hdr ethernet;
struct qualcomm_hdr qualcomm;
uint8_t MODULEID;
uint8_t RESERVED;
uint16_t MLENGTH;
uint32_t MOFFSET;
uint8_t DAK [16];
}
* request = (struct vs_rd_mod_request *) (message);
struct __packed vs_rd_mod_confirm
{
struct ethernet_hdr ethernet;
struct qualcomm_hdr qualcomm;
uint8_t MSTATUS;
uint8_t RESERVED1 [3];
uint8_t MODULEID;
uint8_t RESERVED2;
uint16_t MLENGTH;
uint32_t MOFFSET;
uint32_t MCHKSUM;
struct simple_pib pib;
}
* confirm = (struct vs_rd_mod_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_RD_MOD | MMTYPE_REQ));
request->MODULEID = VS_MODULE_PIB;
request->MLENGTH = HTOLE16 (PLC_RECORD_SIZE);
request->MOFFSET = HTOLE32 (0);
plc->packetsize = ETHER_MIN_LEN - ETHER_CRC_LEN;
if (SendMME (plc) <= 0)
{
error (1, errno, CHANNEL_CANTSEND);
}
while (ReadMME (plc, 0, (VS_RD_MOD | MMTYPE_CNF)) > 0)
{
if (confirm->MSTATUS)
{
Failure (plc, PLC_WONTDOIT);
return (-1);
}
if (count++ > 0)
{
putc (plc->coupling, stdout);
}
if (plc->action == PLCID_MAC)
{
hexout (confirm->pib.MAC, sizeof (confirm->pib.MAC), HEX_EXTENDER, 0, stdout);
}
else if (plc->action == PLCID_DAK)
{
hexout (confirm->pib.DAK, sizeof (confirm->pib.DAK), HEX_EXTENDER, 0, stdout);
}
else if (plc->action == PLCID_NMK)
{
hexout (confirm->pib.NMK, sizeof (confirm->pib.NMK), HEX_EXTENDER, 0, stdout);
}
else if (plc->action == PLCID_MFG)
{
confirm->pib.MFG [PIB_HFID_LEN -1] = (char) (0);
printf ("%s", confirm->pib.MFG);
}
else if (plc->action == PLCID_USR)
{
confirm->pib.USR [PIB_HFID_LEN -1] = (char) (0);
printf ("%s", confirm->pib.USR);
}
else if (plc->action == PLCID_NET)
{
confirm->pib.NET [PIB_HFID_LEN -1] = (char) (0);
printf ("%s", confirm->pib.NET);
}
}
if (plc->packetsize < 0)
{
error (1, errno, CHANNEL_CANTREAD);
}
return (0);
}
/*====================================================================*
*
* signed ReadKey2 (struct plc * plc);
*
* plc.h
*
* read start of parameter chain from the device using a single
* VS_MODULE_OPERATION message; search parameter chain for PIB and
* print requested plc->action on stdout;
*
* Contributor(s):
* Charles Maier <cmaier@qca.qualcomm.com>
*
*--------------------------------------------------------------------*/
static signed ReadKey2 (struct plc * plc)
{
static signed count = 0;
struct channel * channel = (struct channel *) (plc->channel);
struct message * message = (struct message *) (plc->message);
struct nvm_header2 * nvm_header;
uint32_t origin = ~ 0;
uint32_t offset = 0;
signed module = 0;
char * filename = "device";
#ifndef __GNUC__
#pragma pack (push,1)
#endif
struct __packed vs_module_operation_read_request
{
struct ethernet_hdr ethernet;
struct qualcomm_hdr qualcomm;
uint32_t RESERVED;
uint8_t NUM_OP_DATA;
struct __packed
{
uint16_t MOD_OP;
uint16_t MOD_OP_DATA_LEN;
uint32_t MOD_OP_RSVD;
uint16_t MODULE_ID;
uint16_t MODULE_SUB_ID;
uint16_t MODULE_LENGTH;
uint32_t MODULE_OFFSET;
}
MODULE_SPEC;
}
* request = (struct vs_module_operation_read_request *) (message);
struct __packed vs_module_operation_read_confirm
{
struct ethernet_hdr ethernet;
struct qualcomm_hdr qualcomm;
uint16_t MSTATUS;
uint16_t ERR_REC_CODE;
uint32_t RESERVED;
uint8_t NUM_OP_DATA;
struct __packed
{
uint16_t MOD_OP;
uint16_t MOD_OP_DATA_LEN;
uint32_t MOD_OP_RSVD;
uint16_t MODULE_ID;
uint16_t MODULE_SUB_ID;
uint16_t MODULE_LENGTH;
uint32_t MODULE_OFFSET;
}
MODULE_SPEC;
uint8_t MODULE_DATA [PLC_MODULE_SIZE];
}
* confirm = (struct vs_module_operation_read_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_MODULE_OPERATION | MMTYPE_REQ));
plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN);
request->NUM_OP_DATA = 1;
request->MODULE_SPEC.MOD_OP = HTOLE16 (0);
request->MODULE_SPEC.MOD_OP_DATA_LEN = HTOLE16 (sizeof (request->MODULE_SPEC));
request->MODULE_SPEC.MOD_OP_RSVD = HTOLE32 (0);
request->MODULE_SPEC.MODULE_ID = HTOLE16 (PLC_MODULEID_PARAMETERS);
request->MODULE_SPEC.MODULE_SUB_ID = HTOLE16 (0);
request->MODULE_SPEC.MODULE_LENGTH = HTOLE16 (PLC_MODULE_SIZE);
request->MODULE_SPEC.MODULE_OFFSET = HTOLE32 (0);
if (SendMME (plc) <= 0)
{
error (1, errno, CHANNEL_CANTSEND);
}
while (ReadMME (plc, 0, (VS_MODULE_OPERATION | MMTYPE_CNF)) > 0)
{
if (confirm->MSTATUS)
{
Failure (plc, PLC_WONTDOIT);
return (-1);
}
if (count++ > 0)
{
putc (plc->coupling, stdout);
}
do
{
nvm_header = (struct nvm_header2 *) (& confirm->MODULE_DATA [offset]);
if (LE16TOH (nvm_header->MajorVersion) != 1)
{
if (_allclr (plc->flags, PLC_SILENCE))
{
error (0, errno, NVM_HDR_VERSION, filename, module);
}
return (-1);
}
if (LE16TOH (nvm_header->MinorVersion) != 1)
{
if (_allclr (plc->flags, PLC_SILENCE))
{
error (0, errno, NVM_HDR_VERSION, filename, module);
}
return (-1);
}
if (LE32TOH (nvm_header->PrevHeader) != origin)
{
if (_allclr (plc->flags, PLC_SILENCE))
{
error (0, errno, NVM_HDR_LINK, filename, module);
}
return (-1);
}
if (checksum32 (nvm_header, sizeof (* nvm_header), 0))
{
error (0, 0, NVM_HDR_CHECKSUM, filename, module);
return (-1);
}
origin = offset;
offset += sizeof (* nvm_header);
if (LE32TOH (nvm_header->ImageType) == NVM_IMAGE_PIB)
{
struct simple_pib * pib = (struct simple_pib *) (& confirm->MODULE_DATA [offset]);
if (plc->action == PLCID_MAC)
{
hexout (pib->MAC, sizeof (pib->MAC), HEX_EXTENDER, 0, stdout);
}
else if (plc->action == PLCID_DAK)
{
hexout (pib->DAK, sizeof (pib->DAK), HEX_EXTENDER, 0, stdout);
}
else if (plc->action == PLCID_NMK)
{
hexout (pib->NMK, sizeof (pib->NMK), HEX_EXTENDER, 0, stdout);
}
else if (plc->action == PLCID_MFG)
{
pib->MFG [PIB_HFID_LEN -1] = (char) (0);
printf ("%s", pib->MFG);
}
else if (plc->action == PLCID_USR)
{
pib->USR [PIB_HFID_LEN -1] = (char) (0);
printf ("%s", pib->USR);
}
else if (plc->action == PLCID_NET)
{
pib->NET [PIB_HFID_LEN -1] = (char) (0);
printf ("%s", pib->NET);
}
break;
}
if (checksum32 (& confirm->MODULE_DATA [offset], LE32TOH (nvm_header->ImageLength), nvm_header->ImageChecksum))
{
if (_allclr (plc->flags, PLC_SILENCE))
{
error (0, errno, NVM_IMG_CHECKSUM, filename, module);
}
return (-1);
}
offset += LE32TOH (nvm_header->ImageLength);
module++;
}
while (~ nvm_header->NextHeader);
}
if (plc->packetsize < 0)
{
error (1, errno, CHANNEL_CANTREAD);
}
return (0);
}
/*====================================================================*
*
* int main (int argc, char const * argv []);
*
*--------------------------------------------------------------------*/
int main (int argc, char const * argv [])
{
extern struct channel channel;
static char const * optv [] =
{
"Ac:Dei:MnNqSUv",
"device",
"Qualcomm Atheros Powerline Device Identity",
"A\tEthernet address (MAC)",
"c c\tcharacter delimiter is (c)",
"D\tDevice Access Key (DAK)",
"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
"M\tNetwork Membership Key (NMK)",
"n\tappend newline on output",
"N\tnetwork HFID",
"q\tquiet mode",
"S\tmanufacturer HFID",
"U\tuser HFID",
"v\tverbose mode",
(char const *) (0)
};
#include "../plc/plc.c"
signed c;
plc.action = PLCID_DAK;
plc.coupling = '\n';
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)))
{
switch (c)
{
case 'A':
plc.action = PLCID_MAC;
break;
case 'c':
plc.coupling = * optarg;
break;
case 'D':
plc.action = PLCID_DAK;
break;
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 'M':
plc.action = PLCID_NMK;
break;
case 'n':
_setbits (plc.flags, PLC_NEWLINE);
break;
case 'N':
plc.action = PLCID_NET;
break;
case 'q':
_setbits (channel.flags, CHANNEL_SILENCE);
_setbits (plc.flags, PLC_SILENCE);
break;
case 'S':
plc.action = PLCID_MFG;
break;
case 'U':
plc.action = PLCID_USR;
break;
case 'v':
_setbits (channel.flags, CHANNEL_VERBOSE);
_setbits (plc.flags, PLC_VERBOSE);
break;
default:
break;
}
}
argc -= optind;
argv += optind;
openchannel (& channel);
if (! (plc.message = malloc (sizeof (* plc.message))))
{
error (1, errno, PLC_NOMEMORY);
}
if (! argc)
{
PLCSelect (& plc, ReadKey1, ReadKey2);
}
while ((argc) && (* argv))
{
if (! hexencode (channel.peer, sizeof (channel.peer), synonym (* argv, devices, SIZEOF (devices))))
{
error (1, errno, PLC_BAD_MAC, * argv);
}
PLCSelect (& plc, ReadKey1, ReadKey2);
argv++;
argc--;
}
if (_anyset (plc.flags, PLC_NEWLINE))
{
printf ("\n");
}
free (plc.message);
closechannel (& channel);
return (0);
}