2 * UWB radio (channel) management.
4 * Copyright (C) 2008 Cambridge Silicon Radio Ltd.
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License version
8 * 2 as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
18 #include <linux/kernel.h>
19 #include <linux/uwb.h>
21 #include "uwb-internal.h"
24 static int uwb_radio_select_channel(struct uwb_rc
*rc
)
27 * Default to channel 9 (BG1, TFC1) unless the user has
28 * selected a specific channel or there are no active PALs.
30 if (rc
->active_pals
== 0)
32 if (rc
->beaconing_forced
)
33 return rc
->beaconing_forced
;
39 * Notify all active PALs that the channel has changed.
41 static void uwb_radio_channel_changed(struct uwb_rc
*rc
, int channel
)
45 list_for_each_entry(pal
, &rc
->pals
, node
) {
46 if (pal
->channel
&& channel
!= pal
->channel
) {
47 pal
->channel
= channel
;
48 if (pal
->channel_changed
)
49 pal
->channel_changed(pal
, pal
->channel
);
55 * Change to a new channel and notify any active PALs of the new
58 * When stopping the radio, PALs need to be notified first so they can
59 * terminate any active reservations.
61 static int uwb_radio_change_channel(struct uwb_rc
*rc
, int channel
)
66 uwb_radio_channel_changed(rc
, channel
);
68 if (channel
!= rc
->beaconing
) {
69 if (rc
->beaconing
!= -1 && channel
!= -1) {
70 ret
= uwb_radio_change_channel(rc
, -1);
74 ret
= uwb_rc_beacon(rc
, channel
, 0);
78 uwb_radio_channel_changed(rc
, rc
->beaconing
);
84 * uwb_radio_start - request that the radio be started
85 * @pal: the PAL making the request.
87 * If the radio is not already active, aa suitable channel is selected
88 * and beacons are started.
90 int uwb_radio_start(struct uwb_pal
*pal
)
92 struct uwb_rc
*rc
= pal
->rc
;
95 mutex_lock(&rc
->uwb_dev
.mutex
);
100 ret
= uwb_radio_change_channel(rc
, uwb_radio_select_channel(rc
));
103 mutex_unlock(&rc
->uwb_dev
.mutex
);
106 EXPORT_SYMBOL_GPL(uwb_radio_start
);
109 * uwb_radio_stop - request tha the radio be stopped.
110 * @pal: the PAL making the request.
112 * Stops the radio if no other PAL is making use of it.
114 void uwb_radio_stop(struct uwb_pal
*pal
)
116 struct uwb_rc
*rc
= pal
->rc
;
118 mutex_lock(&rc
->uwb_dev
.mutex
);
122 uwb_radio_change_channel(rc
, uwb_radio_select_channel(rc
));
126 mutex_unlock(&rc
->uwb_dev
.mutex
);
128 EXPORT_SYMBOL_GPL(uwb_radio_stop
);
131 * uwb_radio_force_channel - force a specific channel to be used
132 * @rc: the radio controller.
133 * @channel: the channel to use; -1 to force the radio to stop; 0 to
134 * use the default channel selection algorithm.
136 int uwb_radio_force_channel(struct uwb_rc
*rc
, int channel
)
140 mutex_lock(&rc
->uwb_dev
.mutex
);
142 rc
->beaconing_forced
= channel
;
143 ret
= uwb_radio_change_channel(rc
, uwb_radio_select_channel(rc
));
145 mutex_unlock(&rc
->uwb_dev
.mutex
);
150 * uwb_radio_setup - setup the radio manager
151 * @rc: the radio controller.
153 * The radio controller is reset to ensure it's in a known state
156 int uwb_radio_setup(struct uwb_rc
*rc
)
158 return uwb_rc_reset(rc
);
162 * uwb_radio_reset_state - reset any radio manager state
163 * @rc: the radio controller.
165 * All internal radio manager state is reset to values corresponding
166 * to a reset radio controller.
168 void uwb_radio_reset_state(struct uwb_rc
*rc
)
172 mutex_lock(&rc
->uwb_dev
.mutex
);
174 list_for_each_entry(pal
, &rc
->pals
, node
) {
177 if (pal
->channel_changed
)
178 pal
->channel_changed(pal
, -1);
185 mutex_unlock(&rc
->uwb_dev
.mutex
);
189 * uwb_radio_shutdown - shutdown the radio manager
190 * @rc: the radio controller.
192 * The radio controller is reset.
194 void uwb_radio_shutdown(struct uwb_rc
*rc
)
196 uwb_radio_reset_state(rc
);