/*
 * Copyright (c) 2012-2013 The Linux Foundation. All rights reserved.
 *
 * Previously licensed under the ISC license by Qualcomm Atheros, Inc.
 *
 *
 * Permission to use, copy, modify, and/or distribute this software for
 * any purpose with or without fee is hereby granted, provided that the
 * above copyright notice and this permission notice appear in all
 * copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
 * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
 * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
 * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
 * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 * PERFORMANCE OF THIS SOFTWARE.
 */

/*
 * This file was originally distributed by Qualcomm Atheros, Inc.
 * under proprietary terms before Copyright ownership was assigned
 * to the Linux Foundation.
 */

//==================================================================
//
//  File:         polFile.h
//
//  Description:  Structures that define the firmware file format.                
//
//  Author:       Larry Cawley
// 
//
//
//  Change History:
//  04/09/2002 - LAC - Initial version.
//
//===================================================================
#if !defined( __polFile_h__ )
#define __polFile_h__



   
// File format
//
//  byte 0        1        2       3
//
// +---------+---------+--------+-------+                        <----+
// | Major   | Minor   |        |       |                             |
// | Version | Version | Suffix | Build |   FileVersion               |
// +---------+---------+--------+-------+                             |
// | Major   | Minor   |        |       |                             |
// | Version | Version | Suffix | Build |   HwCapabilities            | tPolFileHeader
// +---------+---------+--------+-------+                             |
// |                                    |                             |
// | FileLength                         |   FileLength                |
// +------------------------------------+                             |
// |                                    |                             |
// | Number of Directory Entries        |   NumDirectoryEntries       |
// +------------------------------------+                        <----+
// |                                    |                             |
// | Directory Entry 1 Type             |   DirEntryType              |
// +------------------------------------+                             |
// |                                    |                             | tPolFileDirEntry 1
// | Directory Entry 1 File Offset      |   DirEntryFileOffset        |
// +------------------------------------+                             |
// |                                    |                             |
// | Directory Entry 1 Length           |   DirEntryLength            |
// +------------------------------------+                        <----+
// |            . . .                   |                        . . . 
// +------------------------------------+                        <----+
// |                                    |                             |
// | Directory Entry n Type             |                             |
// +------------------------------------+                             |
// |                                    |                             | tpolFileDirEntry n
// | Directory Entry n File Offset      |                             |
// +------------------------------------+                             |
// |                                    |                             |
// | Directory Entry n Length           |                             |
// +------------------------------------+                        <----+
// |                                    |
// |                                    |
// | File data described by             |
// | directory entry 1                  |
// |                                    |
// |                                    |
// +------------------------------------+
// |            . . .                   |
// +------------------------------------+
// |                                    |
// |                                    |
// | File data described by             |
// | directory entry n                  |
// |                                    |
// |                                    |
// +---------+---------+----------------+
// |                   |
// | File Checksum     |
// +---------+---------+
//
//
//         
//


#pragma pack( push )
#pragma pack( 1 )

typedef struct sPolFileVersion {

  unsigned char  MajorVersion;
  unsigned char  MinorVersion;
  unsigned char  Suffix;
  unsigned char  Build;

} tPolFileVersion;


typedef struct sPolFileHeader {

  tPolFileVersion FileVersion;
  tPolFileVersion HWCapabilities;
  unsigned int   FileLength;
  unsigned int   NumDirectoryEntries;

} tPolFileHeader;


typedef enum ePolFileDirTypes {

  ePOL_DIR_TYPE_BOOTLOADER = 0,
  ePOL_DIR_TYPE_STA_FIRMWARE,
  ePOL_DIR_TYPE_AP_FIRMWARE,
  ePOL_DIR_TYPE_DIAG_FIRMWARE,
  ePOL_DIR_TYPE_STA_CONFIG,
  ePOL_DIR_TYPE_AP_CONFIG

} tPolFileDirTypes;


typedef struct sPolFileDirEntry {

  unsigned int DirEntryType;
  unsigned int DirEntryFileOffset;
  unsigned int DirEntryLength;

} tPolFileDirEntry;


#pragma pack( pop )


__inline unsigned short polFileChkSum( unsigned short *FileData, unsigned long NumWords )
{
  unsigned long Sum;

  for ( Sum = 0; NumWords > 0; NumWords-- ) {

    Sum += *FileData++;
  }

  Sum  = (Sum >> 16) + (Sum & 0xffff); // add carry
  Sum += (Sum >> 16);                  // maybe last unsigned short

  return( (unsigned short)( ~Sum ) );
}



#endif