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

    /*====================================================================*
     *
     *   signed ModuleWrite (struct plc * plc, struct _file_ * file, unsigned index, struct vs_module_spec * vs_module_spec);
     *
     *   plc.h
     *
     *   write an entire file to flash memory as a single module; write
     *   the file in 1400 byte records; allow up to 80 seconds for each
     *   write to complete; extra time is needed because memory must be
     *   erased;
     *
     *
     *   Contributor(s):
     *      Charles Maier <cmaier@qca.qualcomm.com>
     *
     *--------------------------------------------------------------------*/

    #ifndef MODULEWRITE_SOURCE
    #define MODULEWRITE_SOURCE

    #include <stdint.h>
    #include <limits.h>
    #include <unistd.h>
    #include <string.h>
    #include <memory.h>

    #include "../tools/error.h"
    #include "../tools/files.h"
    #include "../plc/plc.h"

    signed ModuleWrite (struct plc * plc, struct _file_ * file, unsigned index, struct vs_module_spec * vs_module_spec)

    {
    	struct channel * channel = (struct channel *)(plc->channel);
    	struct message * message = (struct message *)(plc->message);

    #ifndef __GNUC__
    #pragma pack (push,1)
    #endif

    	struct __packed vs_module_operation_write_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;
    			uint32_t MOD_OP_SESSION_ID;
    			uint8_t MODULE_IDX;
    			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];
    	}
    	* request = (struct vs_module_operation_write_request *)(message);
    	struct __packed vs_module_operation_write_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;
    			uint32_t MOD_OP_SESSION_ID;
    			uint8_t MODULE_IDX;
    			uint16_t MODULE_ID;
    			uint16_t MODULE_SUB_ID;
    			uint16_t MODULE_LENGTH;
    			uint32_t MODULE_OFFSET;
    		}
    		MODULE_SPEC;
    	}
    	* confirm = (struct vs_module_operation_write_confirm *)(message);

    #ifndef __GNUC__
    #pragma pack (pop)
    #endif

    	unsigned timer = channel->timeout;
    	uint16_t length = PLC_MODULE_SIZE;
    	uint32_t extent = vs_module_spec->MODULE_LENGTH;
    	uint32_t offset = 0;
    	Request (plc, "Flash %s", file->name);
    	while (extent)
    	{
    		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 = sizeof (struct vs_module_operation_write_request);
    		if (length > extent)
    		{
    			length = extent;
    		}
    		if (read (file->file, request->MODULE_DATA, length) != length)
    		{
    			error (1, errno, FILE_CANTREAD, file->name);
    		}
    		request->NUM_OP_DATA = 1;
    		request->MODULE_SPEC.MOD_OP = HTOLE16 (PLC_MOD_OP_WRITE_MODULE);
    		request->MODULE_SPEC.MOD_OP_DATA_LEN = HTOLE16 (sizeof (request->MODULE_SPEC) + sizeof (request->MODULE_DATA));
    		request->MODULE_SPEC.MOD_OP_SESSION_ID = HTOLE32 (plc->cookie);
    		request->MODULE_SPEC.MODULE_IDX = index;
    		request->MODULE_SPEC.MODULE_ID = HTOLE16 (vs_module_spec->MODULE_ID);
    		request->MODULE_SPEC.MODULE_SUB_ID = HTOLE16 (vs_module_spec->MODULE_SUB_ID);
    		request->MODULE_SPEC.MODULE_LENGTH = HTOLE16 (length);
    		request->MODULE_SPEC.MODULE_OFFSET = HTOLE32 (offset);

    #if 1

    		fprintf (stderr, "RESERVED 0x%08X\n", LE32TOH (request->RESERVED));
    		fprintf (stderr, "NUM_OP_DATA %d\n", request->NUM_OP_DATA);
    		fprintf (stderr, "MOD_OP 0x%02X\n", LE16TOH (request->MODULE_SPEC.MOD_OP));
    		fprintf (stderr, "MOD_OP_DATA_LEN %d\n", LE16TOH (request->MODULE_SPEC.MOD_OP_DATA_LEN));
    		fprintf (stderr, "RESERVED 0x%08X\n", LE32TOH (request->MODULE_SPEC.MOD_OP_RSVD));
    		fprintf (stderr, "MODULE_ID 0x%04X\n", LE16TOH (request->MODULE_SPEC.MODULE_ID));
    		fprintf (stderr, "MODULE_SUB_ID 0x%04X\n", LE16TOH (request->MODULE_SPEC.MODULE_SUB_ID));
    		fprintf (stderr, "MODULE_LENGTH %d\n", LE16TOH (request->MODULE_SPEC.MODULE_LENGTH));
    		fprintf (stderr, "MODULE_OFFSET 0x%08X\n", LE32TOH (request->MODULE_SPEC.MODULE_OFFSET));

    #endif

    		if (SendMME (plc) <= 0)
    		{
    			error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND);
    			return (-1);
    		}
    		channel->timeout = PLC_MODULE_WRITE_TIMEOUT;
    		if (ReadMME (plc, 0, (VS_MODULE_OPERATION | MMTYPE_CNF)) <= 0)
    		{
    			error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD);
    			channel->timeout = timer;
    			return (-1);
    		}
    		channel->timeout = timer;

    #if 1

    		fprintf (stderr, "MSTATUS 0x%04X\n", LE16TOH (confirm->MSTATUS));
    		fprintf (stderr, "ERROR_REC_CODE %d\n", LE16TOH (confirm->ERR_REC_CODE));
    		fprintf (stderr, "RESERVED 0x%08X\n", LE32TOH (confirm->RESERVED));
    		fprintf (stderr, "NUM_OP_DATA %d\n", confirm->NUM_OP_DATA);
    		fprintf (stderr, "MOD_OP 0x%02X\n", LE16TOH (request->MODULE_SPEC.MOD_OP));
    		fprintf (stderr, "MOD_OP_DATA_LEN %d\n", LE16TOH (confirm->MODULE_SPEC.MOD_OP_DATA_LEN));
    		fprintf (stderr, "RESERVED 0x%08X\n", LE32TOH (confirm->MODULE_SPEC.MOD_OP_RSVD));
    		fprintf (stderr, "MODULE_ID 0x%04X\n", LE16TOH (confirm->MODULE_SPEC.MODULE_ID));
    		fprintf (stderr, "MODULE_SUB_ID 0x%04X\n", LE16TOH (confirm->MODULE_SPEC.MODULE_SUB_ID));
    		fprintf (stderr, "MODULE_LENGTH %d\n", LE16TOH (confirm->MODULE_SPEC.MODULE_LENGTH));
    		fprintf (stderr, "MODULE_OFFSET 0x%08X\n", LE32TOH (request->MODULE_SPEC.MODULE_OFFSET));

    #endif

    		if (confirm->MSTATUS)
    		{
    			Failure (plc, PLC_WONTDOIT);
    			return (-1);
    		}
    		if (LE16TOH (confirm->MODULE_SPEC.MODULE_LENGTH) != length)
    		{
    			error (PLC_EXIT (plc), 0, PLC_ERR_LENGTH);
    			return (-1);
    		}
    		if (LE32TOH (confirm->MODULE_SPEC.MODULE_OFFSET) != offset)
    		{
    			error (PLC_EXIT (plc), 0, PLC_ERR_OFFSET);
    			return (-1);
    		}
    		extent -= length;
    		offset += length;
    	}
    	return (0);
    }

    #endif

[PREV] [HOME] [NEXT]