CoCalc -- brcmu

GitHub Repository: freebsd/freebsd-src
Path: blob/main/sys/contrib/dev/broadcom/brcm80211/include/brcmu_d11.h
¹⁷⁸⁶⁶⁵ views
1
// SPDX-License-Identifier: ISC
2
/*
3
 * Copyright (c) 2010 Broadcom Corporation
4
 */
5

6
#ifndef	_BRCMU_D11_H_
7
#define	_BRCMU_D11_H_
8

9
/* d11 io type */
10
#define BRCMU_D11N_IOTYPE		1
11
#define BRCMU_D11AC_IOTYPE		2
12

13
/* A chanspec (channel specification) holds the channel number, band,
14
 * bandwidth and control sideband
15
 */
16

17
/* chanspec binary format */
18

19
#define BRCMU_CHSPEC_INVALID		255
20
/* bit 0~7 channel number
21
 * for 80+80 channels: bit 0~3 low channel id, bit 4~7 high channel id
22
 */
23
#define BRCMU_CHSPEC_CH_MASK		0x00ff
24
#define BRCMU_CHSPEC_CH_SHIFT		0
25
#define BRCMU_CHSPEC_CHL_MASK		0x000f
26
#define BRCMU_CHSPEC_CHL_SHIFT		0
27
#define BRCMU_CHSPEC_CHH_MASK		0x00f0
28
#define BRCMU_CHSPEC_CHH_SHIFT		4
29

30
/* bit 8~16 for dot 11n IO types
31
 * bit 8~9 sideband
32
 * bit 10~11 bandwidth
33
 * bit 12~13 spectral band
34
 * bit 14~15 not used
35
 */
36
#define BRCMU_CHSPEC_D11N_SB_MASK	0x0300
37
#define BRCMU_CHSPEC_D11N_SB_SHIFT	8
38
#define  BRCMU_CHSPEC_D11N_SB_L		0x0100	/* control lower */
39
#define  BRCMU_CHSPEC_D11N_SB_U		0x0200	/* control upper */
40
#define  BRCMU_CHSPEC_D11N_SB_N		0x0300	/* none */
41
#define BRCMU_CHSPEC_D11N_BW_MASK	0x0c00
42
#define BRCMU_CHSPEC_D11N_BW_SHIFT	10
43
#define  BRCMU_CHSPEC_D11N_BW_10	0x0400
44
#define  BRCMU_CHSPEC_D11N_BW_20	0x0800
45
#define  BRCMU_CHSPEC_D11N_BW_40	0x0c00
46
#define BRCMU_CHSPEC_D11N_BND_MASK	0x3000
47
#define BRCMU_CHSPEC_D11N_BND_SHIFT	12
48
#define  BRCMU_CHSPEC_D11N_BND_5G	0x1000
49
#define  BRCMU_CHSPEC_D11N_BND_2G	0x2000
50

51
/* bit 8~16 for dot 11ac IO types
52
 * bit 8~10 sideband
53
 * bit 11~13 bandwidth
54
 * bit 14~15 spectral band
55
 */
56
#define BRCMU_CHSPEC_D11AC_SB_MASK	0x0700
57
#define BRCMU_CHSPEC_D11AC_SB_SHIFT	8
58
#define  BRCMU_CHSPEC_D11AC_SB_LLL	0x0000
59
#define  BRCMU_CHSPEC_D11AC_SB_LLU	0x0100
60
#define  BRCMU_CHSPEC_D11AC_SB_LUL	0x0200
61
#define  BRCMU_CHSPEC_D11AC_SB_LUU	0x0300
62
#define  BRCMU_CHSPEC_D11AC_SB_ULL	0x0400
63
#define  BRCMU_CHSPEC_D11AC_SB_ULU	0x0500
64
#define  BRCMU_CHSPEC_D11AC_SB_UUL	0x0600
65
#define  BRCMU_CHSPEC_D11AC_SB_UUU	0x0700
66
#define  BRCMU_CHSPEC_D11AC_SB_LL	BRCMU_CHSPEC_D11AC_SB_LLL
67
#define  BRCMU_CHSPEC_D11AC_SB_LU	BRCMU_CHSPEC_D11AC_SB_LLU
68
#define  BRCMU_CHSPEC_D11AC_SB_UL	BRCMU_CHSPEC_D11AC_SB_LUL
69
#define  BRCMU_CHSPEC_D11AC_SB_UU	BRCMU_CHSPEC_D11AC_SB_LUU
70
#define  BRCMU_CHSPEC_D11AC_SB_L	BRCMU_CHSPEC_D11AC_SB_LLL
71
#define  BRCMU_CHSPEC_D11AC_SB_U	BRCMU_CHSPEC_D11AC_SB_LLU
72
#define BRCMU_CHSPEC_D11AC_BW_MASK	0x3800
73
#define BRCMU_CHSPEC_D11AC_BW_SHIFT	11
74
#define  BRCMU_CHSPEC_D11AC_BW_5	0x0000
75
#define  BRCMU_CHSPEC_D11AC_BW_10	0x0800
76
#define  BRCMU_CHSPEC_D11AC_BW_20	0x1000
77
#define  BRCMU_CHSPEC_D11AC_BW_40	0x1800
78
#define  BRCMU_CHSPEC_D11AC_BW_80	0x2000
79
#define  BRCMU_CHSPEC_D11AC_BW_160	0x2800
80
#define  BRCMU_CHSPEC_D11AC_BW_8080	0x3000
81
#define BRCMU_CHSPEC_D11AC_BND_MASK	0xc000
82
#define BRCMU_CHSPEC_D11AC_BND_SHIFT	14
83
#define  BRCMU_CHSPEC_D11AC_BND_2G	0x0000
84
#define  BRCMU_CHSPEC_D11AC_BND_3G	0x4000
85
#define  BRCMU_CHSPEC_D11AC_BND_4G	0x8000
86
#define  BRCMU_CHSPEC_D11AC_BND_5G	0xc000
87

88
#define BRCMU_CHAN_BAND_2G		0
89
#define BRCMU_CHAN_BAND_5G		1
90

91
enum brcmu_chan_bw {
92
	BRCMU_CHAN_BW_20,
93
	BRCMU_CHAN_BW_40,
94
	BRCMU_CHAN_BW_80,
95
	BRCMU_CHAN_BW_80P80,
96
	BRCMU_CHAN_BW_160,
97
};
98

99
enum brcmu_chan_sb {
100
	BRCMU_CHAN_SB_NONE = -1,
101
	BRCMU_CHAN_SB_LLL,
102
	BRCMU_CHAN_SB_LLU,
103
	BRCMU_CHAN_SB_LUL,
104
	BRCMU_CHAN_SB_LUU,
105
	BRCMU_CHAN_SB_ULL,
106
	BRCMU_CHAN_SB_ULU,
107
	BRCMU_CHAN_SB_UUL,
108
	BRCMU_CHAN_SB_UUU,
109
	BRCMU_CHAN_SB_L = BRCMU_CHAN_SB_LLL,
110
	BRCMU_CHAN_SB_U = BRCMU_CHAN_SB_LLU,
111
	BRCMU_CHAN_SB_LL = BRCMU_CHAN_SB_LLL,
112
	BRCMU_CHAN_SB_LU = BRCMU_CHAN_SB_LLU,
113
	BRCMU_CHAN_SB_UL = BRCMU_CHAN_SB_LUL,
114
	BRCMU_CHAN_SB_UU = BRCMU_CHAN_SB_LUU,
115
};
116

117
/**
118
 * struct brcmu_chan - stores channel formats
119
 *
120
 * This structure can be used with functions translating chanspec into generic
121
 * channel info and the other way.
122
 *
123
 * @chspec: firmware specific format
124
 * @chnum: center channel number
125
 * @control_ch_num: control channel number
126
 * @band: frequency band
127
 * @bw: channel width
128
 * @sb: control sideband (location of control channel against the center one)
129
 */
130
struct brcmu_chan {
131
	u16 chspec;
132
	u8 chnum;
133
	u8 control_ch_num;
134
	u8 band;
135
	enum brcmu_chan_bw bw;
136
	enum brcmu_chan_sb sb;
137
};
138

139
/**
140
 * struct brcmu_d11inf - provides functions translating channel format
141
 *
142
 * @io_type: determines version of channel format used by firmware
143
 * @encchspec: encodes channel info into a chanspec, requires center channel
144
 *	number, ignores control one
145
 * @decchspec: decodes chanspec into generic info
146
 */
147
struct brcmu_d11inf {
148
	u8 io_type;
149

150
	void (*encchspec)(struct brcmu_chan *ch);
151
	void (*decchspec)(struct brcmu_chan *ch);
152
};
153

154
void brcmu_d11_attach(struct brcmu_d11inf *d11inf);
155

156
#endif	/* _BRCMU_CHANNELS_H_ */
157

158
Product

Resources

Company
