1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3 
4   Broadcom B43 wireless driver
5 
6   Copyright (c) 2005 Martin Langer <martin-langer@gmx.de>,
7                      Stefano Brivio <stefano.brivio@polimi.it>
8                      Michael Buesch <m@bues.ch>
9                      Danny van Dyk <kugelfang@gentoo.org>
10                      Andreas Jaggi <andreas.jaggi@waterwave.ch>
11 
12   Some parts of the code in this file are derived from the ipw2200
13   driver  Copyright(c) 2003 - 2004 Intel Corporation.
14 
15 
16 */
17 
18 #ifndef B43_MAIN_H_
19 #define B43_MAIN_H_
20 
21 #include "b43.h"
22 
23 #define P4D_BYT3S(magic, nr_bytes)	u8 __p4dding##magic[nr_bytes]
24 #define P4D_BYTES(line, nr_bytes)	P4D_BYT3S(line, nr_bytes)
25 /* Magic helper macro to pad structures. Ignore those above. It's magic. */
26 #define PAD_BYTES(nr_bytes)		P4D_BYTES( __LINE__ , (nr_bytes))
27 
28 
29 extern int b43_modparam_verbose;
30 
31 /* Logmessage verbosity levels. Update the b43_modparam_verbose helptext, if
32  * you add or remove levels. */
33 enum b43_verbosity {
34 	B43_VERBOSITY_ERROR,
35 	B43_VERBOSITY_WARN,
36 	B43_VERBOSITY_INFO,
37 	B43_VERBOSITY_DEBUG,
38 	__B43_VERBOSITY_AFTERLAST, /* keep last */
39 
40 	B43_VERBOSITY_MAX = __B43_VERBOSITY_AFTERLAST - 1,
41 #if B43_DEBUG
42 	B43_VERBOSITY_DEFAULT = B43_VERBOSITY_DEBUG,
43 #else
44 	B43_VERBOSITY_DEFAULT = B43_VERBOSITY_INFO,
45 #endif
46 };
47 
48 static inline int b43_is_cck_rate(int rate)
49 {
50 	return (rate == B43_CCK_RATE_1MB ||
51 		rate == B43_CCK_RATE_2MB ||
52 		rate == B43_CCK_RATE_5MB || rate == B43_CCK_RATE_11MB);
53 }
54 
55 static inline int b43_is_ofdm_rate(int rate)
56 {
57 	return !b43_is_cck_rate(rate);
58 }
59 
60 u8 b43_ieee80211_antenna_sanitize(struct b43_wldev *dev,
61 				  u8 antenna_nr);
62 
63 void b43_tsf_read(struct b43_wldev *dev, u64 * tsf);
64 void b43_tsf_write(struct b43_wldev *dev, u64 tsf);
65 
66 u32 b43_shm_read32(struct b43_wldev *dev, u16 routing, u16 offset);
67 u16 b43_shm_read16(struct b43_wldev *dev, u16 routing, u16 offset);
68 void b43_shm_write32(struct b43_wldev *dev, u16 routing, u16 offset, u32 value);
69 void b43_shm_write16(struct b43_wldev *dev, u16 routing, u16 offset, u16 value);
70 
71 u64 b43_hf_read(struct b43_wldev *dev);
72 void b43_hf_write(struct b43_wldev *dev, u64 value);
73 
74 void b43_dummy_transmission(struct b43_wldev *dev, bool ofdm, bool pa_on);
75 
76 void b43_wireless_core_reset(struct b43_wldev *dev, bool gmode);
77 
78 void b43_controller_restart(struct b43_wldev *dev, const char *reason);
79 
80 #define B43_PS_ENABLED	(1 << 0)	/* Force enable hardware power saving */
81 #define B43_PS_DISABLED	(1 << 1)	/* Force disable hardware power saving */
82 #define B43_PS_AWAKE	(1 << 2)	/* Force device awake */
83 #define B43_PS_ASLEEP	(1 << 3)	/* Force device asleep */
84 void b43_power_saving_ctl_bits(struct b43_wldev *dev, unsigned int ps_flags);
85 
86 void b43_wireless_core_phy_pll_reset(struct b43_wldev *dev);
87 
88 void b43_mac_suspend(struct b43_wldev *dev);
89 void b43_mac_enable(struct b43_wldev *dev);
90 void b43_mac_phy_clock_set(struct b43_wldev *dev, bool on);
91 void b43_mac_switch_freq(struct b43_wldev *dev, u8 spurmode);
92 
93 
94 struct b43_request_fw_context;
95 int b43_do_request_fw(struct b43_request_fw_context *ctx, const char *name,
96 		      struct b43_firmware_file *fw, bool async);
97 void b43_do_release_fw(struct b43_firmware_file *fw);
98 
99 #endif /* B43_MAIN_H_ */
100