drivers/infineon/bcmwifi_channels.h

10  *      Unless you and Broadcom execute a separate written software license
16  *      As a special exception, the copyright holders of this software give you
20  * the license of that module.  An independent module is a module which is not
25  * software in any way with any other Broadcom software provided under a license
31  * $Id: bcmwifi_channels.h 695288 2017-04-19 17:20:39Z $
37 /* A chanspec holds the channel number, band, bandwidth and primary 20MHz sideband */
57 					 * this is that + 1 rounded up to a multiple of NBBY (8).
62 #define INVCHANNEL              255     /* error value for a bad channel */
134 /* pass a 80MHz channel number (uint8) to get respective LL, UU, LU, UL */
216 /* pass a center channel and get channel offset from it by 10MHz */
224 /* pass a 160MHz center channel to get 20MHz subband channel numbers */
244 /* pass an 80P80 chanspec (not channel) to get 20MHz subnand channel numbers */
254 /* get lowest 20MHz sideband of a given chspec
255  * (works with 20, 40, 80, 160, 80p80)
264 /* get upper most 20MHz sideband of a given chspec
265  * (works with 20, 40, 80, 160, 80p80)
274 /* call this with chspec and a valid 20MHz sideband of this channel to get the next 20MHz sideband
283 /* call this with chspec and a valid 20MHz sideband of this channel to get the next 20MHz sideband
284  * (works with 20, 40, 80, 160, 80p80)
316 /* get lowest 20MHz sideband of a given chspec
317  * (works with 20, 40, 80)
323 /* get upper most 20MHz sideband of a given chspec
324  * (works with 20, 40, 80, 160, 80p80)
331 /* call this with chspec and a valid 20MHz sideband of this channel to get the next 20MHz sideband
332  * (works with 20, 40, 80, 160, 80p80)
341 /* Iterator for 20MHz side bands of a chanspec: (chanspec_t chspec, uint8 channel)
342  * 'chspec' chanspec_t of interest (used in loop, better to pass a resolved value than a macro)
343  * 'channel' must be a variable (not an expression).
360 /* given a chanspec of any bw, tests if primary20 SB is in lower 20, 40, 80 respectively */
361 #define IS_CTL_IN_L20(chspec) !((chspec) & WL_CHANSPEC_CTL_SB_U) /* CTL SB is in low 20 of any 40 */
391 #define CHANSPEC_STR_LEN    20
480  * given a channel number.
551  * @param	a     pointer to input string
555 extern chanspec_t wf_chspec_aton(const char *a);
560  * @param       a                       pointer to chanspec input string
565 extern chanspec_t wf_chspec_aton_ex(const char *a, const uint default_bw);
570  * Verify the chanspec is using a legal set field values, i.e. that the chanspec
571  * specified a band, bw, primary_sb, and channel and that the combination could be
581  * Verify the chanspec specifies a valid channel according to 802.11.
585  * @return TRUE if the chanspec is a valid 802.11 channel
590  * Return the primary 20MHz channel.
592  * This function returns the channel number of the primary 20MHz channel. For
593  * 20MHz channels this is just the channel number. For 40MHz or wider channels
594  * it is the primary 20MHz channel specified by the chanspec.
598  * @return Returns the channel number of the primary 20MHz channel
613  *         "5", "10", "20", "40", "80", "160", "80+80"
618  * Create a 20MHz chanspec for the given band.
623  * Return the primary 20MHz chanspec.
625  * This function returns the chanspec of the primary 20MHz channel. For 20MHz
627  * chanspec of the primary 20MHZ channel specified by the chanspec.
631  * @return Returns the chanspec of the primary 20MHz channel
642  * The primary 20MHz channel of the returned 40MHz chanspec is the same as the primary 20MHz
648  * Return the channel number for a given frequency and base frequency.
650  * If the given base frequency is zero, a base frequency of 5 GHz is assumed for
661  * frequency is not a 2.4 GHz channel, or if the frequency is not and even
669  * @return Returns a channel number
686  * The channel range of [1, 14] is only checked for a start_factor of
697  * @return Returns a frequency in MHz
708  *	primary_channel - primary 20Mhz channel
734  *    primary_20mhz - Primary 20 MHz channel
784  * does not contain the primary 20MHz channel.
796  * For 20/40/80MHz chanspec, set ch[0] to be the center freq, and chan[1]=-1
810 /* Populates array with all 20MHz side bands of a given chanspec_t in the following order:
815  * Works with 20, 40, 80, 80p80 and 160MHz chspec
822  * (Overlap: At least one 20MHz subband is common between the two chanspecs provided)