243 lines
10 KiB
C
243 lines
10 KiB
C
//------------------------------------------------------------------------------
|
|
// ISC License (ISC)
|
|
//
|
|
// Copyright (c) 2005-2010, The Linux Foundation
|
|
// All rights reserved.
|
|
// Software was previously licensed under 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.
|
|
//
|
|
//
|
|
//------------------------------------------------------------------------------
|
|
//==============================================================================
|
|
// Author(s): ="Atheros"
|
|
//==============================================================================
|
|
|
|
#ifndef __REG_DBSCHEMA_H__
|
|
#define __REG_DBSCHEMA_H__
|
|
|
|
/*
|
|
* This file describes the regulatory DB schema, which is common between the
|
|
* 'generator' and 'parser'. The 'generator' runs on a host(typically a x86
|
|
* Linux) and spits outs two binary files, which follow the DB file
|
|
* format(described below). The resultant output "regulatoryData_AG.bin"
|
|
* is binary file which has information regarding A and G regulatory
|
|
* information, while the "regulatoryData_G.bin" consists of G-ONLY regulatory
|
|
* information. This binary file is parsed in the target for extracting
|
|
* regulatory information.
|
|
*
|
|
* The DB values used to populate the regulatory DB are defined in
|
|
* reg_dbvalues.h
|
|
*
|
|
*/
|
|
|
|
/* Binary data file - Representation of Regulatory DB*/
|
|
#define REG_DATA_FILE_AG "./regulatoryData_AG.bin"
|
|
#define REG_DATA_FILE_G "./regulatoryData_G.bin"
|
|
|
|
|
|
/* Table tags used to encode different tables in the database */
|
|
enum data_tags_t{
|
|
REG_DMN_PAIR_MAPPING_TAG = 0,
|
|
REG_COUNTRY_CODE_TO_ENUM_RD_TAG,
|
|
REG_DMN_FREQ_BAND_regDmn5GhzFreq_TAG,
|
|
REG_DMN_FREQ_BAND_regDmn2Ghz11_BG_Freq_TAG,
|
|
REG_DOMAIN_TAG,
|
|
MAX_DB_TABLE_TAGS
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
****************************************************************************
|
|
* Regulatory DB file format :
|
|
* 4-bytes : "RGDB" (Magic Key)
|
|
* 4-bytes : version (Default is 5379(my extn))
|
|
* 4-bytes : length of file
|
|
* dbType(4)
|
|
* TAG(4)
|
|
* Entries(1)entrySize(1)searchType(1)reserved[3]tableSize(2)"0xdeadbeef"(4)struct_data....
|
|
* TAG(4)
|
|
* Entries(1)entrySize(1)searchType(1)reserved[3]tableSize(2)"0xdeadbeef"(4)struct_data....
|
|
* TAG(4)
|
|
* Entries(1)entrySize(1)searchType(1)reserved[3]tableSize(2)"0xdeadbeef"(4)struct_data....
|
|
* ...
|
|
* ...
|
|
****************************************************************************
|
|
*
|
|
*/
|
|
|
|
/*
|
|
* Length of the file would be filled in when the file is created and
|
|
* it would include the header size.
|
|
*/
|
|
|
|
#define REG_DB_KEY "RGDB" /* Should be EXACTLY 4-bytes */
|
|
#define REG_DB_VER 7803 /* Between 0-9999 */
|
|
/* REG_DB_VER history in reverse chronological order:
|
|
* 7803: 78 (ASCII code of N) + 03 (minor version number) - updated 08/03/10, p4#21
|
|
* 7802: 78 (ASCII code of N) + 02 (minor version number) - updated 10/21/09, p4#17
|
|
* 7801: 78 (ASCII code of N) + 01 (minor version number, increment on further changes)
|
|
* 1178: '11N' = 11 + ASCII code of N(78)
|
|
* 5379: initial version, no 11N support
|
|
*/
|
|
#define MAGIC_KEY_OFFSET 0
|
|
#define VERSION_OFFSET 4
|
|
#define FILE_SZ_OFFSET 8
|
|
#define DB_TYPE_OFFSET 12
|
|
|
|
#define MAGIC_KEY_SZ 4
|
|
#define VERSION_SZ 4
|
|
#define FILE_SZ_SZ 4
|
|
#define DB_TYPE_SZ 4
|
|
#define DB_TAG_SZ 4
|
|
|
|
#define REGDB_GET_MAGICKEY(x) ((char *)x + MAGIC_KEY_OFFSET)
|
|
#define REGDB_GET_VERSION(x) ((char *)x + VERSION_OFFSET)
|
|
#define REGDB_GET_FILESIZE(x) *((unsigned int *)((char *)x + FILE_SZ_OFFSET))
|
|
#define REGDB_GET_DBTYPE(x) *((char *)x + DB_TYPE_OFFSET)
|
|
|
|
#define REGDB_SET_FILESIZE(x, sz_) *((unsigned int *)((char *)x + FILE_SZ_OFFSET)) = (sz_)
|
|
#define REGDB_IS_EOF(cur, begin) ( REGDB_GET_FILESIZE(begin) > ((cur) - (begin)) )
|
|
|
|
|
|
/* A Table can be search based on key as a parameter or accessed directly
|
|
* by giving its index in to the table.
|
|
*/
|
|
enum searchType {
|
|
KEY_BASED_TABLE_SEARCH = 1,
|
|
INDEX_BASED_TABLE_ACCESS
|
|
};
|
|
|
|
|
|
/* Data is organised as different tables. There is a Master table, which
|
|
* holds information regarding all the tables. It does not have any
|
|
* knowledge about the attributes of the table it is holding
|
|
* but has external view of the same(for ex, how many entries, record size,
|
|
* how to search the table, total table size and reference to the data
|
|
* instance of table).
|
|
*/
|
|
typedef PREPACK struct dbMasterTable_t { /* Hold ptrs to Table data structures */
|
|
A_UCHAR numOfEntries;
|
|
A_CHAR entrySize; /* Entry size per table row */
|
|
A_CHAR searchType; /* Index based access or key based */
|
|
A_CHAR reserved[3]; /* for alignment */
|
|
A_UINT16 tableSize; /* Size of this table */
|
|
A_CHAR *dataPtr; /* Ptr to the actual Table */
|
|
} POSTPACK dbMasterTable; /* Master table - table of tables */
|
|
|
|
|
|
/* used to get the number of rows in a table */
|
|
#define REGDB_NUM_OF_ROWS(a) (sizeof (a) / sizeof (a[0]))
|
|
|
|
/*
|
|
* Used to set the RegDomain bitmask which chooses which frequency
|
|
* band specs are used.
|
|
*/
|
|
|
|
#define BMLEN 2 /* Use 2 32-bit uint for channel bitmask */
|
|
#define BMZERO {0,0} /* BMLEN zeros */
|
|
|
|
#define BM(_fa, _fb, _fc, _fd, _fe, _ff, _fg, _fh) \
|
|
{((((_fa >= 0) && (_fa < 32)) ? (((A_UINT32) 1) << _fa) : 0) | \
|
|
(((_fb >= 0) && (_fb < 32)) ? (((A_UINT32) 1) << _fb) : 0) | \
|
|
(((_fc >= 0) && (_fc < 32)) ? (((A_UINT32) 1) << _fc) : 0) | \
|
|
(((_fd >= 0) && (_fd < 32)) ? (((A_UINT32) 1) << _fd) : 0) | \
|
|
(((_fe >= 0) && (_fe < 32)) ? (((A_UINT32) 1) << _fe) : 0) | \
|
|
(((_ff >= 0) && (_ff < 32)) ? (((A_UINT32) 1) << _ff) : 0) | \
|
|
(((_fg >= 0) && (_fg < 32)) ? (((A_UINT32) 1) << _fg) : 0) | \
|
|
(((_fh >= 0) && (_fh < 32)) ? (((A_UINT32) 1) << _fh) : 0)), \
|
|
((((_fa > 31) && (_fa < 64)) ? (((A_UINT32) 1) << (_fa - 32)) : 0) | \
|
|
(((_fb > 31) && (_fb < 64)) ? (((A_UINT32) 1) << (_fb - 32)) : 0) | \
|
|
(((_fc > 31) && (_fc < 64)) ? (((A_UINT32) 1) << (_fc - 32)) : 0) | \
|
|
(((_fd > 31) && (_fd < 64)) ? (((A_UINT32) 1) << (_fd - 32)) : 0) | \
|
|
(((_fe > 31) && (_fe < 64)) ? (((A_UINT32) 1) << (_fe - 32)) : 0) | \
|
|
(((_ff > 31) && (_ff < 64)) ? (((A_UINT32) 1) << (_ff - 32)) : 0) | \
|
|
(((_fg > 31) && (_fg < 64)) ? (((A_UINT32) 1) << (_fg - 32)) : 0) | \
|
|
(((_fh > 31) && (_fh < 64)) ? (((A_UINT32) 1) << (_fh - 32)) : 0))}
|
|
|
|
|
|
/*
|
|
* THE following table is the mapping of regdomain pairs specified by
|
|
* a regdomain value to the individual unitary reg domains
|
|
*/
|
|
|
|
typedef PREPACK struct reg_dmn_pair_mapping {
|
|
A_UINT16 regDmnEnum; /* 16 bit reg domain pair */
|
|
A_UINT16 regDmn5GHz; /* 5GHz reg domain */
|
|
A_UINT16 regDmn2GHz; /* 2GHz reg domain */
|
|
A_UINT8 flags5GHz; /* Requirements flags (AdHoc disallow etc) */
|
|
A_UINT8 flags2GHz; /* Requirements flags (AdHoc disallow etc) */
|
|
A_UINT32 pscanMask; /* Passive Scan flags which can override unitary domain passive scan
|
|
flags. This value is used as a mask on the unitary flags*/
|
|
} POSTPACK REG_DMN_PAIR_MAPPING;
|
|
|
|
#define OFDM_YES (1 << 0)
|
|
#define OFDM_NO (0 << 0)
|
|
#define MCS_HT20_YES (1 << 1)
|
|
#define MCS_HT20_NO (0 << 1)
|
|
#define MCS_HT40_A_YES (1 << 2)
|
|
#define MCS_HT40_A_NO (0 << 2)
|
|
#define MCS_HT40_G_YES (1 << 3)
|
|
#define MCS_HT40_G_NO (0 << 3)
|
|
|
|
typedef PREPACK struct {
|
|
A_UINT16 countryCode;
|
|
A_UINT16 regDmnEnum;
|
|
A_CHAR isoName[3];
|
|
A_CHAR allowMode; /* what mode is allowed - bit 0: OFDM; bit 1: MCS_HT20; bit 2: MCS_HT40_A; bit 3: MCS_HT40_G */
|
|
} POSTPACK COUNTRY_CODE_TO_ENUM_RD;
|
|
|
|
/* lower 16 bits of ht40ChanMask */
|
|
#define NO_FREQ_HT40 0x0 /* no freq is HT40 capable */
|
|
#define F1_TO_F4_HT40 0xF /* freq 1 to 4 in the block is ht40 capable */
|
|
#define F2_TO_F3_HT40 0x6 /* freq 2 to 3 in the block is ht40 capable */
|
|
#define F1_TO_F10_HT40 0x3FF /* freq 1 to 10 in the block is ht40 capable */
|
|
#define F3_TO_F11_HT40 0x7FC /* freq 3 to 11 in the block is ht40 capable */
|
|
#define F3_TO_F9_HT40 0x1FC /* freq 3 to 9 in the block is ht40 capable */
|
|
#define F1_TO_F8_HT40 0xFF /* freq 1 to 8 in the block is ht40 capable */
|
|
#define F1_TO_F4_F9_TO_F10_HT40 0x30F /* freq 1 to 4, 9 to 10 in the block is ht40 capable */
|
|
|
|
/* upper 16 bits of ht40ChanMask */
|
|
#define FREQ_HALF_RATE 0x10000
|
|
#define FREQ_QUARTER_RATE 0x20000
|
|
|
|
typedef PREPACK struct RegDmnFreqBand {
|
|
A_UINT16 lowChannel; /* Low channel center in MHz */
|
|
A_UINT16 highChannel; /* High Channel center in MHz */
|
|
A_UINT8 power; /* Max power (dBm) for channel range */
|
|
A_UINT8 channelSep; /* Channel separation within the band */
|
|
A_UINT8 useDfs; /* Use DFS in the RegDomain if corresponding bit is set */
|
|
A_UINT8 mode; /* Mode of operation */
|
|
A_UINT32 usePassScan; /* Use Passive Scan in the RegDomain if corresponding bit is set */
|
|
A_UINT32 ht40ChanMask; /* lower 16 bits: indicate which frequencies in the block is HT40 capable
|
|
upper 16 bits: what rate (half/quarter) the channel is */
|
|
} POSTPACK REG_DMN_FREQ_BAND;
|
|
|
|
|
|
|
|
typedef PREPACK struct regDomain {
|
|
A_UINT16 regDmnEnum; /* value from EnumRd table */
|
|
A_UINT8 rdCTL;
|
|
A_UINT8 maxAntGain;
|
|
A_UINT8 dfsMask; /* DFS bitmask for 5Ghz tables */
|
|
A_UINT8 flags; /* Requirement flags (AdHoc disallow etc) */
|
|
A_UINT16 reserved; /* for alignment */
|
|
A_UINT32 pscan; /* Bitmask for passive scan */
|
|
A_UINT32 chan11a[BMLEN]; /* 64 bit bitmask for channel/band selection */
|
|
A_UINT32 chan11bg[BMLEN];/* 64 bit bitmask for channel/band selection */
|
|
} POSTPACK REG_DOMAIN;
|
|
|
|
#endif /* __REG_DBSCHEMA_H__ */
|