[deliverable/linux.git] / drivers / net / wireless / b43 / phy_common.h

#ifndef LINUX_B43_PHY_COMMON_H_
#define LINUX_B43_PHY_COMMON_H_

#include <linux/types.h>
#include <linux/nl80211.h>

struct b43_wldev;

/* Complex number using 2 32-bit signed integers */
struct b43_c32 { s32 i, q; };

#define CORDIC_CONVERT(value)	(((value) >= 0) ? \
				 ((((value) >> 15) + 1) >> 1) : \
				 -((((-(value)) >> 15) + 1) >> 1))

/* PHY register routing bits */
#define B43_PHYROUTE			0x0C00 /* PHY register routing bits mask */
#define  B43_PHYROUTE_BASE		0x0000 /* Base registers */
#define  B43_PHYROUTE_OFDM_GPHY		0x0400 /* OFDM register routing for G-PHYs */
#define  B43_PHYROUTE_EXT_GPHY		0x0800 /* Extended G-PHY registers */
#define  B43_PHYROUTE_N_BMODE		0x0C00 /* N-PHY BMODE registers */

/* CCK (B-PHY) registers. */
#define B43_PHY_CCK(reg)		((reg) | B43_PHYROUTE_BASE)
/* N-PHY registers. */
#define B43_PHY_N(reg)			((reg) | B43_PHYROUTE_BASE)
/* N-PHY BMODE registers. */
#define B43_PHY_N_BMODE(reg)		((reg) | B43_PHYROUTE_N_BMODE)
/* OFDM (A-PHY) registers. */
#define B43_PHY_OFDM(reg)		((reg) | B43_PHYROUTE_OFDM_GPHY)
/* Extended G-PHY registers. */
#define B43_PHY_EXTG(reg)		((reg) | B43_PHYROUTE_EXT_GPHY)


/* Masks for the PHY versioning registers. */
#define B43_PHYVER_ANALOG		0xF000
#define B43_PHYVER_ANALOG_SHIFT		12
#define B43_PHYVER_TYPE			0x0F00
#define B43_PHYVER_TYPE_SHIFT		8
#define B43_PHYVER_VERSION		0x00FF

/* PHY writes need to be flushed if we reach limit */
#define B43_MAX_WRITES_IN_ROW		24

/**
 * enum b43_interference_mitigation - Interference Mitigation mode
 *
 * @B43_INTERFMODE_NONE:	Disabled
 * @B43_INTERFMODE_NONWLAN:	Non-WLAN Interference Mitigation
 * @B43_INTERFMODE_MANUALWLAN:	WLAN Interference Mitigation
 * @B43_INTERFMODE_AUTOWLAN:	Automatic WLAN Interference Mitigation
 */
enum b43_interference_mitigation {
	B43_INTERFMODE_NONE,
	B43_INTERFMODE_NONWLAN,
	B43_INTERFMODE_MANUALWLAN,
	B43_INTERFMODE_AUTOWLAN,
};

/* Antenna identifiers */
enum {
	B43_ANTENNA0 = 0,	/* Antenna 0 */
	B43_ANTENNA1 = 1,	/* Antenna 1 */
	B43_ANTENNA_AUTO0 = 2,	/* Automatic, starting with antenna 0 */
	B43_ANTENNA_AUTO1 = 3,	/* Automatic, starting with antenna 1 */
	B43_ANTENNA2 = 4,
	B43_ANTENNA3 = 8,

	B43_ANTENNA_AUTO = B43_ANTENNA_AUTO0,
	B43_ANTENNA_DEFAULT = B43_ANTENNA_AUTO,
};

/**
 * enum b43_txpwr_result - Return value for the recalc_txpower PHY op.
 *
 * @B43_TXPWR_RES_NEED_ADJUST:	Values changed. Hardware adjustment is needed.
 * @B43_TXPWR_RES_DONE:		No more work to do. Everything is done.
 */
enum b43_txpwr_result {
	B43_TXPWR_RES_NEED_ADJUST,
	B43_TXPWR_RES_DONE,
};

/**
 * struct b43_phy_operations - Function pointers for PHY ops.
 *
 * @allocate:		Allocate and initialise the PHY data structures.
 * 			Must not be NULL.
 * @free:		Destroy and free the PHY data structures.
 * 			Must not be NULL.
 *
 * @prepare_structs:	Prepare the PHY data structures.
 * 			The data structures allocated in @allocate are
 * 			initialized here.
 * 			Must not be NULL.
 * @prepare_hardware:	Prepare the PHY. This is called before b43_chip_init to
 * 			do some early early PHY hardware init.
 * 			Can be NULL, if not required.
 * @init:		Initialize the PHY.
 * 			Must not be NULL.
 * @exit:		Shutdown the PHY.
 * 			Can be NULL, if not required.
 *
 * @phy_read:		Read from a PHY register.
 * 			Must not be NULL.
 * @phy_write:		Write to a PHY register.
 * 			Must not be NULL.
 * @phy_maskset:	Maskset a PHY register, taking shortcuts.
 *			If it is NULL, a generic algorithm is used.
 * @radio_read:		Read from a Radio register.
 * 			Must not be NULL.
 * @radio_write:	Write to a Radio register.
 * 			Must not be NULL.
 *
 * @supports_hwpctl:	Returns a boolean whether Hardware Power Control
 * 			is supported or not.
 * 			If NULL, hwpctl is assumed to be never supported.
 * @software_rfkill:	Turn the radio ON or OFF.
 * 			Possible state values are
 * 			RFKILL_STATE_SOFT_BLOCKED or
 * 			RFKILL_STATE_UNBLOCKED
 * 			Must not be NULL.
 * @switch_analog:	Turn the Analog on/off.
 * 			Must not be NULL.
 * @switch_channel:	Switch the radio to another channel.
 * 			Must not be NULL.
 * @get_default_chan:	Just returns the default channel number.
 * 			Must not be NULL.
 * @set_rx_antenna:	Set the antenna used for RX.
 * 			Can be NULL, if not supported.
 * @interf_mitigation:	Switch the Interference Mitigation mode.
 * 			Can be NULL, if not supported.
 *
 * @recalc_txpower:	Recalculate the transmission power parameters.
 * 			This callback has to recalculate the TX power settings,
 * 			but does not need to write them to the hardware, yet.
 * 			Returns enum b43_txpwr_result to indicate whether the hardware
 * 			needs to be adjusted.
 * 			If B43_TXPWR_NEED_ADJUST is returned, @adjust_txpower
 * 			will be called later.
 * 			If the parameter "ignore_tssi" is true, the TSSI values should
 * 			be ignored and a recalculation of the power settings should be
 * 			done even if the TSSI values did not change.
 * 			This function may sleep, but should not.
 * 			Must not be NULL.
 * @adjust_txpower:	Write the previously calculated TX power settings
 * 			(from @recalc_txpower) to the hardware.
 * 			This function may sleep.
 * 			Can be NULL, if (and ONLY if) @recalc_txpower _always_
 * 			returns B43_TXPWR_RES_DONE.
 *
 * @pwork_15sec:	Periodic work. Called every 15 seconds.
 * 			Can be NULL, if not required.
 * @pwork_60sec:	Periodic work. Called every 60 seconds.
 * 			Can be NULL, if not required.
 */
struct b43_phy_operations {
	/* Initialisation */
	int (*allocate)(struct b43_wldev *dev);
	void (*free)(struct b43_wldev *dev);
	void (*prepare_structs)(struct b43_wldev *dev);
	int (*prepare_hardware)(struct b43_wldev *dev);
	int (*init)(struct b43_wldev *dev);
	void (*exit)(struct b43_wldev *dev);

	/* Register access */
	u16 (*phy_read)(struct b43_wldev *dev, u16 reg);
	void (*phy_write)(struct b43_wldev *dev, u16 reg, u16 value);
	void (*phy_maskset)(struct b43_wldev *dev, u16 reg, u16 mask, u16 set);
	u16 (*radio_read)(struct b43_wldev *dev, u16 reg);
	void (*radio_write)(struct b43_wldev *dev, u16 reg, u16 value);

	/* Radio */
	bool (*supports_hwpctl)(struct b43_wldev *dev);
	void (*software_rfkill)(struct b43_wldev *dev, bool blocked);
	void (*switch_analog)(struct b43_wldev *dev, bool on);
	int (*switch_channel)(struct b43_wldev *dev, unsigned int new_channel);
	unsigned int (*get_default_chan)(struct b43_wldev *dev);
	void (*set_rx_antenna)(struct b43_wldev *dev, int antenna);
	int (*interf_mitigation)(struct b43_wldev *dev,
				 enum b43_interference_mitigation new_mode);

	/* Transmission power adjustment */
	enum b43_txpwr_result (*recalc_txpower)(struct b43_wldev *dev,
						bool ignore_tssi);
	void (*adjust_txpower)(struct b43_wldev *dev);

	/* Misc */
	void (*pwork_15sec)(struct b43_wldev *dev);
	void (*pwork_60sec)(struct b43_wldev *dev);
};

struct b43_phy_a;
struct b43_phy_g;
struct b43_phy_n;
struct b43_phy_lp;
struct b43_phy_ht;
struct b43_phy_lcn;

struct b43_phy {
	/* Hardware operation callbacks. */
	const struct b43_phy_operations *ops;

	/* Most hardware context information is stored in the standard-
	 * specific data structures pointed to by the pointers below.
	 * Only one of them is valid (the currently enabled PHY). */
#ifdef CONFIG_B43_DEBUG
	/* No union for debug build to force NULL derefs in buggy code. */
	struct {
#else
	union {
#endif
		/* A-PHY specific information */
		struct b43_phy_a *a;
		/* G-PHY specific information */
		struct b43_phy_g *g;
		/* N-PHY specific information */
		struct b43_phy_n *n;
		/* LP-PHY specific information */
		struct b43_phy_lp *lp;
		/* HT-PHY specific information */
		struct b43_phy_ht *ht;
		/* LCN-PHY specific information */
		struct b43_phy_lcn *lcn;
		/* AC-PHY specific information */
		struct b43_phy_ac *ac;
	};

	/* Band support flags. */
	bool supports_2ghz;
	bool supports_5ghz;

	/* Is GMODE (2 GHz mode) bit enabled? */
	bool gmode;

	/* After power reset full init has to be performed */
	bool do_full_init;

	/* Analog Type */
	u8 analog;
	/* B43_PHYTYPE_ */
	u8 type;
	/* PHY revision number. */
	u8 rev;

	/* Count writes since last read */
	u8 writes_counter;

	/* Radio versioning */
	u16 radio_manuf;	/* Radio manufacturer */
	u16 radio_ver;		/* Radio version */
	u8 radio_rev;		/* Radio revision */

	/* Software state of the radio */
	bool radio_on;

	/* Desired TX power level (in dBm).
	 * This is set by the user and adjusted in b43_phy_xmitpower(). */
	int desired_txpower;

	/* Hardware Power Control enabled? */
	bool hardware_power_control;

	/* The time (in absolute jiffies) when the next TX power output
	 * check is needed. */
	unsigned long next_txpwr_check_time;

	/* Current channel */
	struct cfg80211_chan_def *chandef;
	unsigned int channel;

	/* PHY TX errors counter. */
	atomic_t txerr_cnt;

#ifdef CONFIG_B43_DEBUG
	/* PHY registers locked (w.r.t. firmware) */
	bool phy_locked;
	/* Radio registers locked (w.r.t. firmware) */
	bool radio_locked;
#endif /* B43_DEBUG */
};


/**
 * b43_phy_allocate - Allocate PHY structs
 * Allocate the PHY data structures, based on the current dev->phy.type
 */
int b43_phy_allocate(struct b43_wldev *dev);

/**
 * b43_phy_free - Free PHY structs
 */
void b43_phy_free(struct b43_wldev *dev);

/**
 * b43_phy_init - Initialise the PHY
 */
int b43_phy_init(struct b43_wldev *dev);

/**
 * b43_phy_exit - Cleanup PHY
 */
void b43_phy_exit(struct b43_wldev *dev);

/**
 * b43_has_hardware_pctl - Hardware Power Control supported?
 * Returns a boolean, whether hardware power control is supported.
 */
bool b43_has_hardware_pctl(struct b43_wldev *dev);

/**
 * b43_phy_read - 16bit PHY register read access
 */
u16 b43_phy_read(struct b43_wldev *dev, u16 reg);

/**
 * b43_phy_write - 16bit PHY register write access
 */
void b43_phy_write(struct b43_wldev *dev, u16 reg, u16 value);

/**
 * b43_phy_copy - copy contents of 16bit PHY register to another
 */
void b43_phy_copy(struct b43_wldev *dev, u16 destreg, u16 srcreg);

/**
 * b43_phy_mask - Mask a PHY register with a mask
 */
void b43_phy_mask(struct b43_wldev *dev, u16 offset, u16 mask);

/**
 * b43_phy_set - OR a PHY register with a bitmap
 */
void b43_phy_set(struct b43_wldev *dev, u16 offset, u16 set);

/**
 * b43_phy_maskset - Mask and OR a PHY register with a mask and bitmap
 */
void b43_phy_maskset(struct b43_wldev *dev, u16 offset, u16 mask, u16 set);

/**
 * b43_radio_read - 16bit Radio register read access
 */
u16 b43_radio_read(struct b43_wldev *dev, u16 reg);
#define b43_radio_read16	b43_radio_read /* DEPRECATED */

/**
 * b43_radio_write - 16bit Radio register write access
 */
void b43_radio_write(struct b43_wldev *dev, u16 reg, u16 value);
#define b43_radio_write16	b43_radio_write /* DEPRECATED */

/**
 * b43_radio_mask - Mask a 16bit radio register with a mask
 */
void b43_radio_mask(struct b43_wldev *dev, u16 offset, u16 mask);

/**
 * b43_radio_set - OR a 16bit radio register with a bitmap
 */
void b43_radio_set(struct b43_wldev *dev, u16 offset, u16 set);

/**
 * b43_radio_maskset - Mask and OR a radio register with a mask and bitmap
 */
void b43_radio_maskset(struct b43_wldev *dev, u16 offset, u16 mask, u16 set);

/**
 * b43_radio_wait_value - Waits for a given value in masked register read
 */
bool b43_radio_wait_value(struct b43_wldev *dev, u16 offset, u16 mask,
			  u16 value, int delay, int timeout);

/**
 * b43_radio_lock - Lock firmware radio register access
 */
void b43_radio_lock(struct b43_wldev *dev);

/**
 * b43_radio_unlock - Unlock firmware radio register access
 */
void b43_radio_unlock(struct b43_wldev *dev);

/**
 * b43_phy_lock - Lock firmware PHY register access
 */
void b43_phy_lock(struct b43_wldev *dev);

/**
 * b43_phy_unlock - Unlock firmware PHY register access
 */
void b43_phy_unlock(struct b43_wldev *dev);

void b43_phy_put_into_reset(struct b43_wldev *dev);
void b43_phy_take_out_of_reset(struct b43_wldev *dev);

/**
 * b43_switch_channel - Switch to another channel
 */
int b43_switch_channel(struct b43_wldev *dev, unsigned int new_channel);

/**
 * b43_software_rfkill - Turn the radio ON or OFF in software.
 */
void b43_software_rfkill(struct b43_wldev *dev, bool blocked);

/**
 * b43_phy_txpower_check - Check TX power output.
 *
 * Compare the current TX power output to the desired power emission
 * and schedule an adjustment in case it mismatches.
 *
 * @flags:	OR'ed enum b43_phy_txpower_check_flags flags.
 * 		See the docs below.
 */
void b43_phy_txpower_check(struct b43_wldev *dev, unsigned int flags);
/**
 * enum b43_phy_txpower_check_flags - Flags for b43_phy_txpower_check()
 *
 * @B43_TXPWR_IGNORE_TIME: Ignore the schedule time and force-redo
 *                         the check now.
 * @B43_TXPWR_IGNORE_TSSI: Redo the recalculation, even if the average
 *                         TSSI did not change.
 */
enum b43_phy_txpower_check_flags {
	B43_TXPWR_IGNORE_TIME		= (1 << 0),
	B43_TXPWR_IGNORE_TSSI		= (1 << 1),
};

struct work_struct;
void b43_phy_txpower_adjust_work(struct work_struct *work);

/**
 * b43_phy_shm_tssi_read - Read the average of the last 4 TSSI from SHM.
 *
 * @shm_offset:		The SHM address to read the values from.
 *
 * Returns the average of the 4 TSSI values, or a negative error code.
 */
int b43_phy_shm_tssi_read(struct b43_wldev *dev, u16 shm_offset);

/**
 * b43_phy_switch_analog_generic - Generic PHY operation for switching the Analog.
 *
 * It does the switching based on the PHY0 core register.
 * Do _not_ call this directly. Only use it as a switch_analog callback
 * for struct b43_phy_operations.
 */
void b43_phyop_switch_analog_generic(struct b43_wldev *dev, bool on);

bool b43_is_40mhz(struct b43_wldev *dev);

void b43_phy_force_clock(struct b43_wldev *dev, bool force);

struct b43_c32 b43_cordic(int theta);

#endif /* LINUX_B43_PHY_COMMON_H_ */
Commit	Line	Data
ef1a628d MB	1	#ifndef LINUX_B43_PHY_COMMON_H_
	2	#define LINUX_B43_PHY_COMMON_H_
	3
f41f3f37	4	#include <linux/types.h>
e5c407f9	5	#include <linux/nl80211.h>
ef1a628d MB	6
	7	struct b43_wldev;
	8
98650454 RM	9	/* Complex number using 2 32-bit signed integers */
98650454 RM	10	struct b43_c32 { s32 i, q; };
ef1a628d	11
6f98e62a RM	12	#define CORDIC_CONVERT(value) (((value) >= 0) ? \
	13	((((value) >> 15) + 1) >> 1) : \
	14	-((((-(value)) >> 15) + 1) >> 1))
	15
ef1a628d MB	16	/* PHY register routing bits */
	17	#define B43_PHYROUTE 0x0C00 /* PHY register routing bits mask */
	18	#define B43_PHYROUTE_BASE 0x0000 /* Base registers */
	19	#define B43_PHYROUTE_OFDM_GPHY 0x0400 /* OFDM register routing for G-PHYs */
	20	#define B43_PHYROUTE_EXT_GPHY 0x0800 /* Extended G-PHY registers */
	21	#define B43_PHYROUTE_N_BMODE 0x0C00 /* N-PHY BMODE registers */
	22
	23	/* CCK (B-PHY) registers. */
	24	#define B43_PHY_CCK(reg) ((reg) \| B43_PHYROUTE_BASE)
	25	/* N-PHY registers. */
	26	#define B43_PHY_N(reg) ((reg) \| B43_PHYROUTE_BASE)
	27	/* N-PHY BMODE registers. */
	28	#define B43_PHY_N_BMODE(reg) ((reg) \| B43_PHYROUTE_N_BMODE)
	29	/* OFDM (A-PHY) registers. */
	30	#define B43_PHY_OFDM(reg) ((reg) \| B43_PHYROUTE_OFDM_GPHY)
	31	/* Extended G-PHY registers. */
	32	#define B43_PHY_EXTG(reg) ((reg) \| B43_PHYROUTE_EXT_GPHY)
	33
	34
	35	/* Masks for the PHY versioning registers. */
	36	#define B43_PHYVER_ANALOG 0xF000
	37	#define B43_PHYVER_ANALOG_SHIFT 12
	38	#define B43_PHYVER_TYPE 0x0F00
	39	#define B43_PHYVER_TYPE_SHIFT 8
	40	#define B43_PHYVER_VERSION 0x00FF
	41
15518080 RM	42	/* PHY writes need to be flushed if we reach limit */
	43	#define B43_MAX_WRITES_IN_ROW 24
	44
ef1a628d MB	45	/**
	46	* enum b43_interference_mitigation - Interference Mitigation mode
	47	*
	48	* @B43_INTERFMODE_NONE: Disabled
	49	* @B43_INTERFMODE_NONWLAN: Non-WLAN Interference Mitigation
	50	* @B43_INTERFMODE_MANUALWLAN: WLAN Interference Mitigation
	51	* @B43_INTERFMODE_AUTOWLAN: Automatic WLAN Interference Mitigation
	52	*/
	53	enum b43_interference_mitigation {
	54	B43_INTERFMODE_NONE,
	55	B43_INTERFMODE_NONWLAN,
	56	B43_INTERFMODE_MANUALWLAN,
	57	B43_INTERFMODE_AUTOWLAN,
	58	};
	59
	60	/* Antenna identifiers */
	61	enum {
64e368bf GS	62	B43_ANTENNA0 = 0, /* Antenna 0 */
	63	B43_ANTENNA1 = 1, /* Antenna 1 */
	64	B43_ANTENNA_AUTO0 = 2, /* Automatic, starting with antenna 0 */
	65	B43_ANTENNA_AUTO1 = 3, /* Automatic, starting with antenna 1 */
	66	B43_ANTENNA2 = 4,
ef1a628d MB	67	B43_ANTENNA3 = 8,
	68
	69	B43_ANTENNA_AUTO = B43_ANTENNA_AUTO0,
	70	B43_ANTENNA_DEFAULT = B43_ANTENNA_AUTO,
	71	};
	72
18c8adeb MB	73	/**
	74	* enum b43_txpwr_result - Return value for the recalc_txpower PHY op.
	75	*
	76	* @B43_TXPWR_RES_NEED_ADJUST: Values changed. Hardware adjustment is needed.
	77	* @B43_TXPWR_RES_DONE: No more work to do. Everything is done.
	78	*/
	79	enum b43_txpwr_result {
	80	B43_TXPWR_RES_NEED_ADJUST,
	81	B43_TXPWR_RES_DONE,
	82	};
	83
ef1a628d MB	84	/**
	85	* struct b43_phy_operations - Function pointers for PHY ops.
	86	*
fb11137a MB	87	* @allocate: Allocate and initialise the PHY data structures.
	88	* Must not be NULL.
	89	* @free: Destroy and free the PHY data structures.
	90	* Must not be NULL.
	91	*
	92	* @prepare_structs: Prepare the PHY data structures.
	93	* The data structures allocated in @allocate are
	94	* initialized here.
	95	* Must not be NULL.
	96	* @prepare_hardware: Prepare the PHY. This is called before b43_chip_init to
	97	* do some early early PHY hardware init.
ef1a628d MB	98	* Can be NULL, if not required.
	99	* @init: Initialize the PHY.
	100	* Must not be NULL.
fb11137a	101	* @exit: Shutdown the PHY.
ef1a628d MB	102	* Can be NULL, if not required.
	103	*
	104	* @phy_read: Read from a PHY register.
	105	* Must not be NULL.
	106	* @phy_write: Write to a PHY register.
	107	* Must not be NULL.
68ec5329 GS	108	* @phy_maskset: Maskset a PHY register, taking shortcuts.
68ec5329 GS	109	* If it is NULL, a generic algorithm is used.
ef1a628d MB	110	* @radio_read: Read from a Radio register.
	111	* Must not be NULL.
	112	* @radio_write: Write to a Radio register.
	113	* Must not be NULL.
	114	*
	115	* @supports_hwpctl: Returns a boolean whether Hardware Power Control
	116	* is supported or not.
	117	* If NULL, hwpctl is assumed to be never supported.
	118	* @software_rfkill: Turn the radio ON or OFF.
	119	* Possible state values are
	120	* RFKILL_STATE_SOFT_BLOCKED or
	121	* RFKILL_STATE_UNBLOCKED
	122	* Must not be NULL.
cb24f57f MB	123	* @switch_analog: Turn the Analog on/off.
cb24f57f MB	124	* Must not be NULL.
ef1a628d MB	125	* @switch_channel: Switch the radio to another channel.
	126	* Must not be NULL.
	127	* @get_default_chan: Just returns the default channel number.
	128	* Must not be NULL.
	129	* @set_rx_antenna: Set the antenna used for RX.
	130	* Can be NULL, if not supported.
	131	* @interf_mitigation: Switch the Interference Mitigation mode.
	132	* Can be NULL, if not supported.
	133	*
18c8adeb MB	134	* @recalc_txpower: Recalculate the transmission power parameters.
	135	* This callback has to recalculate the TX power settings,
	136	* but does not need to write them to the hardware, yet.
	137	* Returns enum b43_txpwr_result to indicate whether the hardware
	138	* needs to be adjusted.
	139	* If B43_TXPWR_NEED_ADJUST is returned, @adjust_txpower
	140	* will be called later.
	141	* If the parameter "ignore_tssi" is true, the TSSI values should
	142	* be ignored and a recalculation of the power settings should be
	143	* done even if the TSSI values did not change.
36dbd954	144	* This function may sleep, but should not.
ef1a628d	145	* Must not be NULL.
18c8adeb MB	146	* @adjust_txpower: Write the previously calculated TX power settings
	147	* (from @recalc_txpower) to the hardware.
	148	* This function may sleep.
	149	* Can be NULL, if (and ONLY if) @recalc_txpower _always_
	150	* returns B43_TXPWR_RES_DONE.
ef1a628d MB	151	*
	152	* @pwork_15sec: Periodic work. Called every 15 seconds.
	153	* Can be NULL, if not required.
	154	* @pwork_60sec: Periodic work. Called every 60 seconds.
	155	* Can be NULL, if not required.
	156	*/
	157	struct b43_phy_operations {
	158	/* Initialisation */
	159	int (allocate)(struct b43_wldev dev);
fb11137a MB	160	void (free)(struct b43_wldev dev);
	161	void (prepare_structs)(struct b43_wldev dev);
	162	int (prepare_hardware)(struct b43_wldev dev);
ef1a628d MB	163	int (init)(struct b43_wldev dev);
	164	void (exit)(struct b43_wldev dev);
	165
	166	/* Register access */
	167	u16 (phy_read)(struct b43_wldev dev, u16 reg);
	168	void (phy_write)(struct b43_wldev dev, u16 reg, u16 value);
68ec5329	169	void (phy_maskset)(struct b43_wldev dev, u16 reg, u16 mask, u16 set);
ef1a628d MB	170	u16 (radio_read)(struct b43_wldev dev, u16 reg);
	171	void (radio_write)(struct b43_wldev dev, u16 reg, u16 value);
	172
	173	/* Radio */
	174	bool (supports_hwpctl)(struct b43_wldev dev);
19d337df	175	void (software_rfkill)(struct b43_wldev dev, bool blocked);
cb24f57f	176	void (switch_analog)(struct b43_wldev dev, bool on);
ef1a628d MB	177	int (switch_channel)(struct b43_wldev dev, unsigned int new_channel);
	178	unsigned int (get_default_chan)(struct b43_wldev dev);
	179	void (set_rx_antenna)(struct b43_wldev dev, int antenna);
	180	int (interf_mitigation)(struct b43_wldev dev,
	181	enum b43_interference_mitigation new_mode);
	182
	183	/* Transmission power adjustment */
18c8adeb MB	184	enum b43_txpwr_result (recalc_txpower)(struct b43_wldev dev,
	185	bool ignore_tssi);
	186	void (adjust_txpower)(struct b43_wldev dev);
ef1a628d MB	187
	188	/* Misc */
	189	void (pwork_15sec)(struct b43_wldev dev);
	190	void (pwork_60sec)(struct b43_wldev dev);
	191	};
	192
	193	struct b43_phy_a;
	194	struct b43_phy_g;
	195	struct b43_phy_n;
e63e4363	196	struct b43_phy_lp;
d7520b1d	197	struct b43_phy_ht;
58eb7ff3	198	struct b43_phy_lcn;
ef1a628d MB	199
	200	struct b43_phy {
	201	/* Hardware operation callbacks. */
	202	const struct b43_phy_operations *ops;
	203
	204	/* Most hardware context information is stored in the standard-
	205	* specific data structures pointed to by the pointers below.
	206	* Only one of them is valid (the currently enabled PHY). */
	207	#ifdef CONFIG_B43_DEBUG
	208	/* No union for debug build to force NULL derefs in buggy code. */
	209	struct {
	210	#else
	211	union {
	212	#endif
	213	/* A-PHY specific information */
	214	struct b43_phy_a *a;
	215	/* G-PHY specific information */
	216	struct b43_phy_g *g;
	217	/* N-PHY specific information */
	218	struct b43_phy_n *n;
e63e4363 MB	219	/* LP-PHY specific information */
e63e4363 MB	220	struct b43_phy_lp *lp;
d7520b1d RM	221	/* HT-PHY specific information */
d7520b1d RM	222	struct b43_phy_ht *ht;
58eb7ff3 RM	223	/* LCN-PHY specific information */
58eb7ff3 RM	224	struct b43_phy_lcn *lcn;
3f7bb3f3 RM	225	/* AC-PHY specific information */
3f7bb3f3 RM	226	struct b43_phy_ac *ac;
ef1a628d MB	227	};
	228
	229	/* Band support flags. */
	230	bool supports_2ghz;
	231	bool supports_5ghz;
	232
24acfc63	233	/* Is GMODE (2 GHz mode) bit enabled? */
ef1a628d MB	234	bool gmode;
ef1a628d MB	235
09951ad4 RM	236	/* After power reset full init has to be performed */
	237	bool do_full_init;
	238
ef1a628d MB	239	/* Analog Type */
	240	u8 analog;
	241	/* B43_PHYTYPE_ */
	242	u8 type;
	243	/* PHY revision number. */
	244	u8 rev;
	245
15518080 RM	246	/* Count writes since last read */
	247	u8 writes_counter;
	248
ef1a628d MB	249	/* Radio versioning */
	250	u16 radio_manuf; /* Radio manufacturer */
	251	u16 radio_ver; /* Radio version */
	252	u8 radio_rev; /* Radio revision */
	253
	254	/* Software state of the radio */
	255	bool radio_on;
	256
	257	/* Desired TX power level (in dBm).
	258	* This is set by the user and adjusted in b43_phy_xmitpower(). */
18c8adeb	259	int desired_txpower;
ef1a628d MB	260
	261	/* Hardware Power Control enabled? */
	262	bool hardware_power_control;
	263
18c8adeb MB	264	/* The time (in absolute jiffies) when the next TX power output
	265	* check is needed. */
	266	unsigned long next_txpwr_check_time;
	267
e5c407f9	268	/* Current channel */
ea42e71c	269	struct cfg80211_chan_def *chandef;
ef1a628d MB	270	unsigned int channel;
	271
	272	/* PHY TX errors counter. */
	273	atomic_t txerr_cnt;
	274
	275	#ifdef CONFIG_B43_DEBUG
591f3dc2	276	/* PHY registers locked (w.r.t. firmware) */
ef1a628d	277	bool phy_locked;
591f3dc2 MB	278	/* Radio registers locked (w.r.t. firmware) */
591f3dc2 MB	279	bool radio_locked;
ef1a628d MB	280	#endif /* B43_DEBUG */
	281	};
	282
	283
	284	/**
fb11137a MB	285	* b43_phy_allocate - Allocate PHY structs
	286	* Allocate the PHY data structures, based on the current dev->phy.type
	287	*/
	288	int b43_phy_allocate(struct b43_wldev *dev);
	289
	290	/**
	291	* b43_phy_free - Free PHY structs
ef1a628d	292	*/
fb11137a	293	void b43_phy_free(struct b43_wldev *dev);
ef1a628d MB	294
	295	/**
	296	* b43_phy_init - Initialise the PHY
	297	*/
	298	int b43_phy_init(struct b43_wldev *dev);
	299
	300	/**
	301	* b43_phy_exit - Cleanup PHY
	302	*/
	303	void b43_phy_exit(struct b43_wldev *dev);
	304
	305	/**
	306	* b43_has_hardware_pctl - Hardware Power Control supported?
	307	* Returns a boolean, whether hardware power control is supported.
	308	*/
	309	bool b43_has_hardware_pctl(struct b43_wldev *dev);
	310
	311	/**
	312	* b43_phy_read - 16bit PHY register read access
	313	*/
	314	u16 b43_phy_read(struct b43_wldev *dev, u16 reg);
	315
	316	/**
	317	* b43_phy_write - 16bit PHY register write access
	318	*/
	319	void b43_phy_write(struct b43_wldev *dev, u16 reg, u16 value);
	320
738f0f43 GS	321	/**
	322	* b43_phy_copy - copy contents of 16bit PHY register to another
	323	*/
	324	void b43_phy_copy(struct b43_wldev *dev, u16 destreg, u16 srcreg);
	325
ef1a628d MB	326	/**
	327	* b43_phy_mask - Mask a PHY register with a mask
	328	*/
	329	void b43_phy_mask(struct b43_wldev *dev, u16 offset, u16 mask);
	330
	331	/**
	332	* b43_phy_set - OR a PHY register with a bitmap
	333	*/
	334	void b43_phy_set(struct b43_wldev *dev, u16 offset, u16 set);
	335
	336	/**
	337	* b43_phy_maskset - Mask and OR a PHY register with a mask and bitmap
	338	*/
	339	void b43_phy_maskset(struct b43_wldev *dev, u16 offset, u16 mask, u16 set);
	340
	341	/**
	342	* b43_radio_read - 16bit Radio register read access
	343	*/
	344	u16 b43_radio_read(struct b43_wldev *dev, u16 reg);
	345	#define b43_radio_read16 b43_radio_read /* DEPRECATED */
	346
	347	/**
	348	* b43_radio_write - 16bit Radio register write access
	349	*/
	350	void b43_radio_write(struct b43_wldev *dev, u16 reg, u16 value);
	351	#define b43_radio_write16 b43_radio_write /* DEPRECATED */
	352
	353	/**
	354	* b43_radio_mask - Mask a 16bit radio register with a mask
	355	*/
	356	void b43_radio_mask(struct b43_wldev *dev, u16 offset, u16 mask);
	357
	358	/**
	359	* b43_radio_set - OR a 16bit radio register with a bitmap
	360	*/
	361	void b43_radio_set(struct b43_wldev *dev, u16 offset, u16 set);
	362
	363	/**
	364	* b43_radio_maskset - Mask and OR a radio register with a mask and bitmap
	365	*/
	366	void b43_radio_maskset(struct b43_wldev *dev, u16 offset, u16 mask, u16 set);
	367
0f941777 RM	368	/**
	369	* b43_radio_wait_value - Waits for a given value in masked register read
	370	*/
	371	bool b43_radio_wait_value(struct b43_wldev *dev, u16 offset, u16 mask,
	372	u16 value, int delay, int timeout);
	373
ef1a628d MB	374	/**
	375	* b43_radio_lock - Lock firmware radio register access
	376	*/
	377	void b43_radio_lock(struct b43_wldev *dev);
	378
	379	/**
	380	* b43_radio_unlock - Unlock firmware radio register access
	381	*/
	382	void b43_radio_unlock(struct b43_wldev *dev);
	383
	384	/**
	385	* b43_phy_lock - Lock firmware PHY register access
	386	*/
	387	void b43_phy_lock(struct b43_wldev *dev);
	388
	389	/**
	390	* b43_phy_unlock - Unlock firmware PHY register access
	391	*/
	392	void b43_phy_unlock(struct b43_wldev *dev);
b60c3c2f RM	393
b60c3c2f RM	394	void b43_phy_put_into_reset(struct b43_wldev *dev);
50c1b59e	395	void b43_phy_take_out_of_reset(struct b43_wldev *dev);
ef1a628d MB	396
	397	/**
	398	* b43_switch_channel - Switch to another channel
	399	*/
	400	int b43_switch_channel(struct b43_wldev *dev, unsigned int new_channel);
ef1a628d MB	401
	402	/**
	403	* b43_software_rfkill - Turn the radio ON or OFF in software.
	404	*/
19d337df	405	void b43_software_rfkill(struct b43_wldev *dev, bool blocked);
ef1a628d	406
18c8adeb MB	407	/**
	408	* b43_phy_txpower_check - Check TX power output.
	409	*
	410	* Compare the current TX power output to the desired power emission
	411	* and schedule an adjustment in case it mismatches.
18c8adeb MB	412	*
	413	* @flags: OR'ed enum b43_phy_txpower_check_flags flags.
	414	* See the docs below.
	415	*/
	416	void b43_phy_txpower_check(struct b43_wldev *dev, unsigned int flags);
	417	/**
	418	* enum b43_phy_txpower_check_flags - Flags for b43_phy_txpower_check()
	419	*
	420	* @B43_TXPWR_IGNORE_TIME: Ignore the schedule time and force-redo
	421	* the check now.
	422	* @B43_TXPWR_IGNORE_TSSI: Redo the recalculation, even if the average
	423	* TSSI did not change.
	424	*/
	425	enum b43_phy_txpower_check_flags {
	426	B43_TXPWR_IGNORE_TIME = (1 << 0),
	427	B43_TXPWR_IGNORE_TSSI = (1 << 1),
	428	};
	429
	430	struct work_struct;
	431	void b43_phy_txpower_adjust_work(struct work_struct *work);
	432
	433	/**
	434	* b43_phy_shm_tssi_read - Read the average of the last 4 TSSI from SHM.
	435	*
	436	* @shm_offset: The SHM address to read the values from.
	437	*
	438	* Returns the average of the 4 TSSI values, or a negative error code.
	439	*/
	440	int b43_phy_shm_tssi_read(struct b43_wldev *dev, u16 shm_offset);
	441
cb24f57f MB	442	/**
	443	* b43_phy_switch_analog_generic - Generic PHY operation for switching the Analog.
	444	*
	445	* It does the switching based on the PHY0 core register.
	446	* Do _not_ call this directly. Only use it as a switch_analog callback
	447	* for struct b43_phy_operations.
	448	*/
	449	void b43_phyop_switch_analog_generic(struct b43_wldev *dev, bool on);
	450
bee6d4b2 RM	451	bool b43_is_40mhz(struct b43_wldev *dev);
bee6d4b2 RM	452
f6a3e99d RM	453	void b43_phy_force_clock(struct b43_wldev *dev, bool force);
f6a3e99d RM	454
98650454	455	struct b43_c32 b43_cordic(int theta);
18c8adeb	456
ef1a628d	457	#endif /* LINUX_B43_PHY_COMMON_H_ */