sm_drv_pda.h

cx3110 drivers for linux 2.6 (基于SPI)

/*
 * src/sm_drv_pda.h
 *
 * Production Data Area API for Conexant CX3110x chipset.
 *  
 * Copyright (C) 2005, 2006 Nokia Corporation
 * Author: Samuel Ortiz <[e-mail]>
 *
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 *
 */
#ifndef _SM_DRV_PDA_H
#define _SM_DRV_PDA_H

#define UINT16_GET(p) (*(uint16_t *)(p))


/*
 * this files defines the PDR codes used to build PDAs as defined in document
 * number 553155. The current implementation mirrors version 1.1 of the 
 * document and lists only PDRs supported by the ARM platform.
 */

/* common and choice range (0x0000 - 0x0fff) */
#define PDR_END					0x0000
#define PDR_MANUFACTURING_PART_NUMBER		0x0001
#define PDR_PDA_VERSION				0x0002
#define PDR_NIC_SERIAL_NUMBER			0x0003

#define PDR_MAC_ADDRESS				0x0101
#define PDR_REGULATORY_DOMAIN_LIST		0x0103
#define PDR_TEMPERATURE_TYPE			0x0107

#define PDR_PRISM_PCI_IDENTIFIER		0x0402

/* ARM range (0x1000 - 0x1fff) */
#define PDR_COUNTRY_INFORMATION	 		0x1000
#define PDR_INTERFACE_LIST			0x1001
#define PDR_HARDWARE_PLATFORM_COMPONENT_ID	0x1002
#define PDR_OEM_NAME				0x1003
#define PDR_PRODUCT_NAME			0x1004
#define PDR_UTF8_OEM_NAME			0x1005
#define PDR_UTF8_PRODUCT_NAME			0x1006
#define PDR_COUNTRY_LIST			0x1007
#define PDR_DEFAULT_COUNTRY			0x1008

#define PDR_ANTENNA_GAIN			0x1100

#define PDR_PRISM_INDIGO_PA_CALIBRATION_DATA	0x1901
#define PDR_RSSI_LINEAR_APPROXIMATION		0x1902
#define PDR_PRISM_PA_CAL_OUTPUT_POWER_LIMITS	0x1903
#define PDR_PRISM_PA_CAL_CURVE_DATA		0x1904
#define PDR_RSSI_LINEAR_APPROXIMATION_DUAL_BAND	0x1905
#define PDR_PRISM_ZIF_TX_IQ_CALIBRATION     	0x1906
#define PDR_REGULATORY_POWER_LIMITS             0x1907
#define PDR_RSSI_LINEAR_APPROXIMATION_EXTENDED  0x1908
#define PDR_RADIATED_TRANSMISSION_CORRECTION    0x1909
#define PDR_PRISM_TX_IQ_CALIBRATION             0x190a

/* reserved range (0x2000 - 0x7fff) */

/* customer range (0x8000 - 0xffff) */
#define PDR_BASEBAND_REGISTERS			0x8000
#define PDR_PER_CHANNEL_BASEBAND_REGISTERS	0x8001

/*
 * regulatory domain codes as defined in IEEE 802.11
 */
#define REGDOMAIN_FCC		0x10
#define REGDOMAIN_IC		0x20
#define REGDOMAIN_ETSI		0x30
#define REGDOMAIN_SPAIN		0x31
#define REGDOMAIN_FRANCE	0x32
#define REGDOMAIN_MKK		0x40    /* channel 14 only */
#define REGDOMAIN_MKK13         0x41    /* channel 1 to 13 */

#define MAX_ARM_PDR             32
#define PDR_SIZE_LENGTH         2
#define PDR_CODE_LENGTH         2


/* ARM PDA types */
typedef struct pda_record_t_ {
	uint16_t size;
	uint16_t code;
	uint8_t * payload;
} pda_record_t;


/* 
 * PDR structures
 */
#define NUM_CHANNELS 13
#define POINTS_PER_CHANNEL 6

/* MAC address PDR 0x0101*/
struct wlan_pda_mac_addr_s {
	uint8_t	mac_addr[ETH_ALEN];
};


/* RSSI PDR 0x1908 */
struct wlan_pda_rssi_cal_channel_s {
	uint16_t frequency;
	uint16_t rssi_A;
	uint16_t rssi_B;
	uint16_t rssi_LNA;
} __attribute__ ((packed));

struct wlan_pda_rssi_cal_s {
	uint8_t  pdr_revision;
	uint8_t  xcvr_bmp;
	struct wlan_pda_rssi_cal_channel_s rssi_data[NUM_CHANNELS];
} __attribute__ ((packed));

/* Additional regulatory power limits PDR 0x1907 */
struct wlan_pda_add_regulatory_limits_channel_s {
	uint16_t frequency;
	uint8_t  regulatory_domain;
	uint8_t  country_code[3];
	uint8_t  modulation;
	uint8_t  power_limit;
} __attribute__ ((packed));

/* IQ calibration PDR 0x1906*/
struct wlan_pda_iq_autocal_s {
	uint16_t  frequency;
	uint16_t  iq_param_1;
	uint16_t  iq_param_2;
	uint16_t  iq_param_3;
	uint16_t  iq_param_4;
} __attribute__ ((packed));


/* Output limits PDR 0x1903 */
struct wlan_pda_output_limits_channel_s {
	uint16_t  frequency;
	uint8_t   rate_set_mask;
	uint8_t   rate_set_size;
	unsigned short   limit_barker;
	unsigned short   limit_bpsk;
	unsigned short   limit_qpsk;
	unsigned short   limit_16qam;
	unsigned short   limit_64qam;
} __attribute__ ((packed));

#define PHASER_PDR1903_REV   0x01
struct wlan_pda_output_limit_s {
	uint8_t  pdr_revision;
	uint8_t  xcvr_bmp;
	uint8_t  n_pa_levels;
	uint8_t  padding;
	struct wlan_pda_output_limits_channel_s  power[NUM_CHANNELS];
} __attribute__ ((packed));


/* PA Curve data PDR 0x1904 */
struct wlan_pda_pa_curve_data_sample_s {
	uint16_t  rf_power;
	uint16_t  pa_detector;
	uint16_t  pcv;
} __attribute__ ((packed));

struct wlan_pda_pa_curve_data_channel_s {
	uint16_t frequency;
	uint16_t ladder;
	uint8_t  rate_set_mask;
	uint8_t  rate_set_size;
	struct wlan_pda_pa_curve_data_sample_s curve_samples [POINTS_PER_CHANNEL];
} __attribute__ ((packed));

#define PHASER_PA_CAL_METHOD   0x03
struct wlan_pda_pa_curve_data_s {
	uint8_t  cal_method_revision;
	uint8_t  xcvr_bmp;
	uint8_t  points_per_channel;
	uint8_t  padding;
	struct wlan_pda_pa_curve_data_channel_s curve_data[NUM_CHANNELS];
} __attribute__ ((packed));

/* Default country PDR 0x1008 */
struct wlan_pda_default_country_s {
	uint8_t regulatory_domain;
	uint8_t country_code[3];
} __attribute__ ((packed));

extern struct wlan_pda_mac_addr_s wlan_pda_mac_address;
extern struct wlan_pda_rssi_cal_s * wlan_pda_rssi;
extern struct wlan_pda_iq_autocal_s * wlan_pda_iq;
extern struct wlan_pda_output_limit_s * wlan_pda_output_limits;
extern struct wlan_pda_pa_curve_data_s * wlan_pda_pa_curve_data;
extern struct wlan_pda_default_country_s * wlan_pda_default_country;

/* API */
short sm_drv_pda_init(pda_record_t * pdr_array, 
	       uint8_t * pda_buffer, uint16_t pda_len);
short sm_drv_pda_replace_pdr(pda_record_t * pdr_array, 
		      uint16_t code, uint8_t * payload, uint16_t size);
struct s_pda * sm_drv_pda_get_pda(pda_record_t * pdr_array);

#endif /* _PDA_H */