drivers/bcmdhd/bcmwifi_channels.c

55  * [<band>'g']<channel>['/'<bandwidth>[<primary-sideband>]
63  *      or primary 20 MHz channel of 40MHz, 80MHz, 160MHz, 80+80MHz,
67  * <primary-sideband>:
70  *       For 2.4GHz band 40MHz channels, the same primary channel may be the
72  *       overlapping 40MHz channel. The {u: upper, l: lower} primary sideband
77  *       non-overlapping and the primary 20MHz channel position is derived from its
89  * 40MHz channels is also allowed: <channel><primary-sideband>
92  *	primary channel of 40MHz, channel <= 14 is 2GHz, otherwise 5GHz
93  * <primary-sideband>:
97  *      Chanspec        BW        Center Ch  Channel Range  Primary Ch
111  *      Chanspec        BW        Center Ch  Channel Range  Primary Ch
262 		/* bad primary channel lower than the low edge of the channel,  in channel_to_sb()
723 		/* if the bw is 20, only need the primary channel and band */  in wf_chspec_aton()
727 		 * non-overlapping in 5G or 6G bands. Each primary channel is contained  in wf_chspec_aton()
832 		 * 80+80 SB info is relative to the primary 80MHz sub-band.  in BCMPOSTTRAPFN()
1135 		/* step through low then high primary sideband, then next 40 center channel */  in wf_chanspec_iter_next_2g()
1137 			/* move from lower primary 20 to upper */  in wf_chanspec_iter_next_2g()
1141 			/* move to next 40M center and lower primary 20 */  in wf_chanspec_iter_next_2g()
1159  * The 5g iterator uses ranges of primary 20MHz channels, and the current BW, to create
1175 		 * channel with that new primary 20MHz.  in wf_chanspec_iter_next_5g()
1213  * Helper function to set up the next range of primary 20MHz channels to
1278  * The 6g iterator uses ranges of primary 20MHz channels, and the current BW, to create
1280  * Each BW in 6g has one contiguous range of primary 20MHz channels. When a range is
1294 		 * channel with that new primary 20MHz.  in wf_chanspec_iter_next_6g()
1335  * primary channels for the 6g band and for the BW being iterated.
1614  * Returns the chanspec for a 40MHz channel given the primary 20MHz channel number,
1617  * @param  primary_channel  primary 20Mhz channel
1632 	/* Calculate the sideband value for the center and primary channel.  in wf_create_40MHz_chspec()
1650  * Returns the chanspec for a 40MHz channel given the primary 20MHz channel number,
1651  * the sub-band for the primary 20MHz channel, and the band.
1653  * @param  primary_channel  primary 20Mhz channel
1654  * @param  primary_subband  sub-band of the 20MHz primary channel (chanspec_subband_t value)
1657  * The primary channel and sub-band should describe one of the 802.11 spec valid
1681  * Returns the chanspec for an 80MHz channel given the primary 20MHz channel number,
1684  * @param  primary_channel  primary 20Mhz channel
1699 	/* Calculate the sideband value for the center and primary channel.  in wf_create_80MHz_chspec()
1717  * Returns the chanspec for an 160MHz channel given the primary 20MHz channel number,
1720  * @param  primary_channel  primary 20Mhz channel
1734 	/* Calculate the sideband value for the center and primary channel.  in wf_create_160MHz_chspec()
1752  * Returns the chanspec for an 80+80MHz channel given the primary 20MHz channel number,
1755  * @param  primary_channel  primary 20 Mhz channel
1761  * The primary channel must be contained in one of the 80 MHz channels. This routine
1762  * will determine which frequency segment is the primary 80 MHz segment.
1797 	/* does the primary channel fit with the 1st 80MHz channel ? */  in wf_create_8080MHz_chspec()
1804 		/* no, so does the primary channel fit with the 2nd 80MHz channel ? */  in wf_create_8080MHz_chspec()
1825  * Returns the chanspec for an 160+160MHz channel given the primary 20MHz channel number,
1828  * @param  primary_channel  primary 20 Mhz channel
1834  * The primary channel must be contained in one of the 160 MHz channels. This routine
1835  * will determine which frequency segment is the primary 160 MHz segment.
1870 	/* does the primary channel fit with the 1st 160MHz channel ? */  in wf_create_160160MHz_chspec()
1877 		/* no, so does the primary channel fit with the 2nd 160MHz channel ? */  in wf_create_160160MHz_chspec()
1898  * Returns the chanspec for an 240MHz channel given the primary 20MHz channel number,
1901  * @param  primary_channel  primary 20 Mhz channel
1925 	/* Calculate the sideband value for the center and primary channel.  in wf_create_240MHz_chspec()
1946  * Returns the chanspec for an 320MHz channel given the primary 20MHz channel number,
1949  * @param  primary_channel  primary 20 Mhz channel
1954  * The primary channel must be contained in one of the 320 MHz channels.
1976 	/* Calculate the sideband value for the center and primary channel.  in wf_create_320MHz_chspec()
1997  * Returns the chanspec given the primary 20MHz channel number,
2003  * @param  primary_channel  primary 20Mhz channel
2021 	/* 20MHz channels have matching center and primary channels */  in wf_create_chspec()
2068  * Returns the chanspec given the primary 20MHz channel number,
2071  * @param  primary_channel  primary 20Mhz channel
2084  * have the same primary 20MHz channel. This function will return INVCHANSPEC
2088  * 20MHz primary channel uniquely specifies a wider channel in a given band.
2102 		 * and search for a center channel compatible with the given primary channel.  in wf_create_chspec_from_primary()
2133 		 * the primary channel.  in wf_create_chspec_from_primary()
2171  * Return the primary 20MHz channel.
2173  * This function returns the channel number of the primary 20MHz channel. For
2175  * it is the primary 20MHz channel specified by the chanspec.
2179  * @return Returns the channel number of the primary 20MHz channel
2201 			/* use bw 240MHz for the primary channel lookup */  in wf_chspec_primary20_chan()
2209 			/* use bw 320MHz for the primary channel lookup */  in wf_chspec_primary20_chan()
2244  * Return the primary 20MHz chanspec of a given chanspec
2246  * This function returns the chanspec of the primary 20MHz channel. For 20MHz
2248  * chanspec of the primary 20MHz channel specified by the chanspec.
2252  * @return Returns the chanspec of the primary 20MHz channel
2271 /* return chanspec given primary 20MHz channel and bandwidth
2327  * Return the primary 40MHz chanspec or a 40MHz or wider channel
2329  * This function returns the chanspec for the primary 40MHz of an 80MHz or wider channel.
2330  * The primary 40MHz channel is the 40MHz sub-band that contains the primary 20MHz channel.
2331  * The primary 20MHz channel of the returned 40MHz chanspec is the same as the primary 20MHz
2336  * @return Returns the chanspec of the primary 20MHz channel
2347 	/* if the chanspec is > 80MHz, use the helper routine to find the primary 80 MHz channel */  in wf_chspec_primary40_chspec()
2352 	/* determine primary 40 MHz sub-channel of an 80 MHz chanspec */  in wf_chspec_primary40_chspec()
2358 			/* Primary 40MHz is on lower side */  in wf_chspec_primary40_chspec()
2362 			/* Primary 40MHz is on upper side */  in wf_chspec_primary40_chspec()
2368 		/* Create primary 40MHz chanspec */  in wf_chspec_primary40_chspec()
2533  *	primary_channel - primary 20Mhz channel
2558 	* find a 80MHz chanspec with the given center_channel that had a primary channel  in wf_chspec_80()
2567  *    primary_20mhz - Primary 20 MHz channel
2572  * The primary channel must be contained in one of the 80MHz channels. This routine
2573  * will determine which frequency segment is the primary 80 MHz segment.
2596 	/* does the primary channel fit with the 1st 80MHz channel ? */  in wf_chspec_get8080_chspec()
2603 		/* no, so does the primary channel fit with the 2nd 80MHz channel ? */  in wf_chspec_get8080_chspec()
2624  * Returns the center channel of the primary 80 MHz sub-band of the provided chanspec
2664  * Returns the chanspec for the primary 80MHz sub-band of an 160MHz or 80+80 channel
2682 			/* Primary 80MHz is on lower side */  in wf_chspec_primary80_chspec()
2686 			/* Primary 80MHz is on upper side */  in wf_chspec_primary80_chspec()
2691 		/* Create primary 80MHz chanspec */  in wf_chspec_primary80_chspec()
2716 			/* Primary 80MHz is on lower side, so the secondary is on  in wf_chspec_secondary80_chspec()
2721 			/* Primary 80MHz is on upper side, so the secondary is on  in wf_chspec_secondary80_chspec()
2764  * Returns the center channel of the primary 160MHz sub-band of the provided chanspec
2784  * Returns the chanspec for the primary 160MHz sub-band of an 240/320MHz or 160+160 channel
2807 			/* Primary 160MHz is on lower side */  in wf_chspec_primary160_chspec()
2810 			/* Primary 160MHz is on upper side */  in wf_chspec_primary160_chspec()
2818 		/* Create primary 160MHz chanspec */  in wf_chspec_primary160_chspec()
2828 			/* Primary 160MHz is on lower side */  in wf_chspec_primary160_chspec()
2832 			/* Primary 160MHz is on upper side */  in wf_chspec_primary160_chspec()
2837 		/* Create primary 160MHz chanspec */  in wf_chspec_primary160_chspec()
2861 		wf_chspec_primary80_chspec(chspec) : (chspec); /* extract primary 80 */  in wf_get_all_ext()