2 * UWB reservation 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>
20 #include <linux/slab.h>
21 #include <linux/random.h>
22 #include <linux/export.h>
24 #include "uwb-internal.h"
26 static void uwb_rsv_timer(unsigned long arg
);
28 static const char *rsv_states
[] = {
29 [UWB_RSV_STATE_NONE
] = "none ",
30 [UWB_RSV_STATE_O_INITIATED
] = "o initiated ",
31 [UWB_RSV_STATE_O_PENDING
] = "o pending ",
32 [UWB_RSV_STATE_O_MODIFIED
] = "o modified ",
33 [UWB_RSV_STATE_O_ESTABLISHED
] = "o established ",
34 [UWB_RSV_STATE_O_TO_BE_MOVED
] = "o to be moved ",
35 [UWB_RSV_STATE_O_MOVE_EXPANDING
] = "o move expanding",
36 [UWB_RSV_STATE_O_MOVE_COMBINING
] = "o move combining",
37 [UWB_RSV_STATE_O_MOVE_REDUCING
] = "o move reducing ",
38 [UWB_RSV_STATE_T_ACCEPTED
] = "t accepted ",
39 [UWB_RSV_STATE_T_CONFLICT
] = "t conflict ",
40 [UWB_RSV_STATE_T_PENDING
] = "t pending ",
41 [UWB_RSV_STATE_T_DENIED
] = "t denied ",
42 [UWB_RSV_STATE_T_RESIZED
] = "t resized ",
43 [UWB_RSV_STATE_T_EXPANDING_ACCEPTED
] = "t expanding acc ",
44 [UWB_RSV_STATE_T_EXPANDING_CONFLICT
] = "t expanding conf",
45 [UWB_RSV_STATE_T_EXPANDING_PENDING
] = "t expanding pend",
46 [UWB_RSV_STATE_T_EXPANDING_DENIED
] = "t expanding den ",
49 static const char *rsv_types
[] = {
50 [UWB_DRP_TYPE_ALIEN_BP
] = "alien-bp",
51 [UWB_DRP_TYPE_HARD
] = "hard",
52 [UWB_DRP_TYPE_SOFT
] = "soft",
53 [UWB_DRP_TYPE_PRIVATE
] = "private",
54 [UWB_DRP_TYPE_PCA
] = "pca",
57 bool uwb_rsv_has_two_drp_ies(struct uwb_rsv
*rsv
)
59 static const bool has_two_drp_ies
[] = {
60 [UWB_RSV_STATE_O_INITIATED
] = false,
61 [UWB_RSV_STATE_O_PENDING
] = false,
62 [UWB_RSV_STATE_O_MODIFIED
] = false,
63 [UWB_RSV_STATE_O_ESTABLISHED
] = false,
64 [UWB_RSV_STATE_O_TO_BE_MOVED
] = false,
65 [UWB_RSV_STATE_O_MOVE_COMBINING
] = false,
66 [UWB_RSV_STATE_O_MOVE_REDUCING
] = false,
67 [UWB_RSV_STATE_O_MOVE_EXPANDING
] = true,
68 [UWB_RSV_STATE_T_ACCEPTED
] = false,
69 [UWB_RSV_STATE_T_CONFLICT
] = false,
70 [UWB_RSV_STATE_T_PENDING
] = false,
71 [UWB_RSV_STATE_T_DENIED
] = false,
72 [UWB_RSV_STATE_T_RESIZED
] = false,
73 [UWB_RSV_STATE_T_EXPANDING_ACCEPTED
] = true,
74 [UWB_RSV_STATE_T_EXPANDING_CONFLICT
] = true,
75 [UWB_RSV_STATE_T_EXPANDING_PENDING
] = true,
76 [UWB_RSV_STATE_T_EXPANDING_DENIED
] = true,
79 return has_two_drp_ies
[rsv
->state
];
83 * uwb_rsv_state_str - return a string for a reservation state
84 * @state: the reservation state.
86 const char *uwb_rsv_state_str(enum uwb_rsv_state state
)
88 if (state
< UWB_RSV_STATE_NONE
|| state
>= UWB_RSV_STATE_LAST
)
90 return rsv_states
[state
];
92 EXPORT_SYMBOL_GPL(uwb_rsv_state_str
);
95 * uwb_rsv_type_str - return a string for a reservation type
96 * @type: the reservation type
98 const char *uwb_rsv_type_str(enum uwb_drp_type type
)
100 if (type
< UWB_DRP_TYPE_ALIEN_BP
|| type
> UWB_DRP_TYPE_PCA
)
102 return rsv_types
[type
];
104 EXPORT_SYMBOL_GPL(uwb_rsv_type_str
);
106 void uwb_rsv_dump(char *text
, struct uwb_rsv
*rsv
)
108 struct device
*dev
= &rsv
->rc
->uwb_dev
.dev
;
109 struct uwb_dev_addr devaddr
;
110 char owner
[UWB_ADDR_STRSIZE
], target
[UWB_ADDR_STRSIZE
];
112 uwb_dev_addr_print(owner
, sizeof(owner
), &rsv
->owner
->dev_addr
);
113 if (rsv
->target
.type
== UWB_RSV_TARGET_DEV
)
114 devaddr
= rsv
->target
.dev
->dev_addr
;
116 devaddr
= rsv
->target
.devaddr
;
117 uwb_dev_addr_print(target
, sizeof(target
), &devaddr
);
119 dev_dbg(dev
, "rsv %s %s -> %s: %s\n",
120 text
, owner
, target
, uwb_rsv_state_str(rsv
->state
));
123 static void uwb_rsv_release(struct kref
*kref
)
125 struct uwb_rsv
*rsv
= container_of(kref
, struct uwb_rsv
, kref
);
130 void uwb_rsv_get(struct uwb_rsv
*rsv
)
132 kref_get(&rsv
->kref
);
135 void uwb_rsv_put(struct uwb_rsv
*rsv
)
137 kref_put(&rsv
->kref
, uwb_rsv_release
);
141 * Get a free stream index for a reservation.
143 * If the target is a DevAddr (e.g., a WUSB cluster reservation) then
144 * the stream is allocated from a pool of per-RC stream indexes,
145 * otherwise a unique stream index for the target is selected.
147 static int uwb_rsv_get_stream(struct uwb_rsv
*rsv
)
149 struct uwb_rc
*rc
= rsv
->rc
;
150 struct device
*dev
= &rc
->uwb_dev
.dev
;
151 unsigned long *streams_bm
;
154 switch (rsv
->target
.type
) {
155 case UWB_RSV_TARGET_DEV
:
156 streams_bm
= rsv
->target
.dev
->streams
;
158 case UWB_RSV_TARGET_DEVADDR
:
159 streams_bm
= rc
->uwb_dev
.streams
;
165 stream
= find_first_zero_bit(streams_bm
, UWB_NUM_STREAMS
);
166 if (stream
>= UWB_NUM_STREAMS
) {
167 dev_err(dev
, "%s: no available stream found\n", __func__
);
171 rsv
->stream
= stream
;
172 set_bit(stream
, streams_bm
);
174 dev_dbg(dev
, "get stream %d\n", rsv
->stream
);
179 static void uwb_rsv_put_stream(struct uwb_rsv
*rsv
)
181 struct uwb_rc
*rc
= rsv
->rc
;
182 struct device
*dev
= &rc
->uwb_dev
.dev
;
183 unsigned long *streams_bm
;
185 switch (rsv
->target
.type
) {
186 case UWB_RSV_TARGET_DEV
:
187 streams_bm
= rsv
->target
.dev
->streams
;
189 case UWB_RSV_TARGET_DEVADDR
:
190 streams_bm
= rc
->uwb_dev
.streams
;
196 clear_bit(rsv
->stream
, streams_bm
);
198 dev_dbg(dev
, "put stream %d\n", rsv
->stream
);
201 void uwb_rsv_backoff_win_timer(unsigned long arg
)
203 struct uwb_drp_backoff_win
*bow
= (struct uwb_drp_backoff_win
*)arg
;
204 struct uwb_rc
*rc
= container_of(bow
, struct uwb_rc
, bow
);
205 struct device
*dev
= &rc
->uwb_dev
.dev
;
207 bow
->can_reserve_extra_mases
= true;
208 if (bow
->total_expired
<= 4) {
209 bow
->total_expired
++;
211 /* after 4 backoff window has expired we can exit from
212 * the backoff procedure */
213 bow
->total_expired
= 0;
214 bow
->window
= UWB_DRP_BACKOFF_WIN_MIN
>> 1;
216 dev_dbg(dev
, "backoff_win_timer total_expired=%d, n=%d\n", bow
->total_expired
, bow
->n
);
218 /* try to relocate all the "to be moved" relocations */
219 uwb_rsv_handle_drp_avail_change(rc
);
222 void uwb_rsv_backoff_win_increment(struct uwb_rc
*rc
)
224 struct uwb_drp_backoff_win
*bow
= &rc
->bow
;
225 struct device
*dev
= &rc
->uwb_dev
.dev
;
228 dev_dbg(dev
, "backoff_win_increment: window=%d\n", bow
->window
);
230 bow
->can_reserve_extra_mases
= false;
232 if((bow
->window
<< 1) == UWB_DRP_BACKOFF_WIN_MAX
)
236 bow
->n
= prandom_u32() & (bow
->window
- 1);
237 dev_dbg(dev
, "new_window=%d, n=%d\n", bow
->window
, bow
->n
);
239 /* reset the timer associated variables */
240 timeout_us
= bow
->n
* UWB_SUPERFRAME_LENGTH_US
;
241 bow
->total_expired
= 0;
242 mod_timer(&bow
->timer
, jiffies
+ usecs_to_jiffies(timeout_us
));
245 static void uwb_rsv_stroke_timer(struct uwb_rsv
*rsv
)
247 int sframes
= UWB_MAX_LOST_BEACONS
;
250 * Multicast reservations can become established within 1
251 * super frame and should not be terminated if no response is
254 if (rsv
->state
== UWB_RSV_STATE_NONE
) {
256 } else if (rsv
->is_multicast
) {
257 if (rsv
->state
== UWB_RSV_STATE_O_INITIATED
258 || rsv
->state
== UWB_RSV_STATE_O_MOVE_EXPANDING
259 || rsv
->state
== UWB_RSV_STATE_O_MOVE_COMBINING
260 || rsv
->state
== UWB_RSV_STATE_O_MOVE_REDUCING
)
262 if (rsv
->state
== UWB_RSV_STATE_O_ESTABLISHED
)
269 * Add an additional 2 superframes to account for the
270 * time to send the SET DRP IE command.
272 unsigned timeout_us
= (sframes
+ 2) * UWB_SUPERFRAME_LENGTH_US
;
273 mod_timer(&rsv
->timer
, jiffies
+ usecs_to_jiffies(timeout_us
));
275 del_timer(&rsv
->timer
);
279 * Update a reservations state, and schedule an update of the
280 * transmitted DRP IEs.
282 static void uwb_rsv_state_update(struct uwb_rsv
*rsv
,
283 enum uwb_rsv_state new_state
)
285 rsv
->state
= new_state
;
286 rsv
->ie_valid
= false;
288 uwb_rsv_dump("SU", rsv
);
290 uwb_rsv_stroke_timer(rsv
);
291 uwb_rsv_sched_update(rsv
->rc
);
294 static void uwb_rsv_callback(struct uwb_rsv
*rsv
)
300 void uwb_rsv_set_state(struct uwb_rsv
*rsv
, enum uwb_rsv_state new_state
)
302 struct uwb_rsv_move
*mv
= &rsv
->mv
;
304 if (rsv
->state
== new_state
) {
305 switch (rsv
->state
) {
306 case UWB_RSV_STATE_O_ESTABLISHED
:
307 case UWB_RSV_STATE_O_MOVE_EXPANDING
:
308 case UWB_RSV_STATE_O_MOVE_COMBINING
:
309 case UWB_RSV_STATE_O_MOVE_REDUCING
:
310 case UWB_RSV_STATE_T_ACCEPTED
:
311 case UWB_RSV_STATE_T_EXPANDING_ACCEPTED
:
312 case UWB_RSV_STATE_T_RESIZED
:
313 case UWB_RSV_STATE_NONE
:
314 uwb_rsv_stroke_timer(rsv
);
317 /* Expecting a state transition so leave timer
324 uwb_rsv_dump("SC", rsv
);
327 case UWB_RSV_STATE_NONE
:
328 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_NONE
);
330 uwb_rsv_callback(rsv
);
332 case UWB_RSV_STATE_O_INITIATED
:
333 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_O_INITIATED
);
335 case UWB_RSV_STATE_O_PENDING
:
336 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_O_PENDING
);
338 case UWB_RSV_STATE_O_MODIFIED
:
339 /* in the companion there are the MASes to drop */
340 bitmap_andnot(rsv
->mas
.bm
, rsv
->mas
.bm
, mv
->companion_mas
.bm
, UWB_NUM_MAS
);
341 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_O_MODIFIED
);
343 case UWB_RSV_STATE_O_ESTABLISHED
:
344 if (rsv
->state
== UWB_RSV_STATE_O_MODIFIED
345 || rsv
->state
== UWB_RSV_STATE_O_MOVE_REDUCING
) {
346 uwb_drp_avail_release(rsv
->rc
, &mv
->companion_mas
);
347 rsv
->needs_release_companion_mas
= false;
349 uwb_drp_avail_reserve(rsv
->rc
, &rsv
->mas
);
350 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_O_ESTABLISHED
);
351 uwb_rsv_callback(rsv
);
353 case UWB_RSV_STATE_O_MOVE_EXPANDING
:
354 rsv
->needs_release_companion_mas
= true;
355 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_O_MOVE_EXPANDING
);
357 case UWB_RSV_STATE_O_MOVE_COMBINING
:
358 rsv
->needs_release_companion_mas
= false;
359 uwb_drp_avail_reserve(rsv
->rc
, &mv
->companion_mas
);
360 bitmap_or(rsv
->mas
.bm
, rsv
->mas
.bm
, mv
->companion_mas
.bm
, UWB_NUM_MAS
);
361 rsv
->mas
.safe
+= mv
->companion_mas
.safe
;
362 rsv
->mas
.unsafe
+= mv
->companion_mas
.unsafe
;
363 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_O_MOVE_COMBINING
);
365 case UWB_RSV_STATE_O_MOVE_REDUCING
:
366 bitmap_andnot(mv
->companion_mas
.bm
, rsv
->mas
.bm
, mv
->final_mas
.bm
, UWB_NUM_MAS
);
367 rsv
->needs_release_companion_mas
= true;
368 rsv
->mas
.safe
= mv
->final_mas
.safe
;
369 rsv
->mas
.unsafe
= mv
->final_mas
.unsafe
;
370 bitmap_copy(rsv
->mas
.bm
, mv
->final_mas
.bm
, UWB_NUM_MAS
);
371 bitmap_copy(rsv
->mas
.unsafe_bm
, mv
->final_mas
.unsafe_bm
, UWB_NUM_MAS
);
372 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_O_MOVE_REDUCING
);
374 case UWB_RSV_STATE_T_ACCEPTED
:
375 case UWB_RSV_STATE_T_RESIZED
:
376 rsv
->needs_release_companion_mas
= false;
377 uwb_drp_avail_reserve(rsv
->rc
, &rsv
->mas
);
378 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_T_ACCEPTED
);
379 uwb_rsv_callback(rsv
);
381 case UWB_RSV_STATE_T_DENIED
:
382 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_T_DENIED
);
384 case UWB_RSV_STATE_T_CONFLICT
:
385 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_T_CONFLICT
);
387 case UWB_RSV_STATE_T_PENDING
:
388 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_T_PENDING
);
390 case UWB_RSV_STATE_T_EXPANDING_ACCEPTED
:
391 rsv
->needs_release_companion_mas
= true;
392 uwb_drp_avail_reserve(rsv
->rc
, &mv
->companion_mas
);
393 uwb_rsv_state_update(rsv
, UWB_RSV_STATE_T_EXPANDING_ACCEPTED
);
396 dev_err(&rsv
->rc
->uwb_dev
.dev
, "unhandled state: %s (%d)\n",
397 uwb_rsv_state_str(new_state
), new_state
);
401 static void uwb_rsv_handle_timeout_work(struct work_struct
*work
)
403 struct uwb_rsv
*rsv
= container_of(work
, struct uwb_rsv
,
404 handle_timeout_work
);
405 struct uwb_rc
*rc
= rsv
->rc
;
407 mutex_lock(&rc
->rsvs_mutex
);
409 uwb_rsv_dump("TO", rsv
);
411 switch (rsv
->state
) {
412 case UWB_RSV_STATE_O_INITIATED
:
413 if (rsv
->is_multicast
) {
414 uwb_rsv_set_state(rsv
, UWB_RSV_STATE_O_ESTABLISHED
);
418 case UWB_RSV_STATE_O_MOVE_EXPANDING
:
419 if (rsv
->is_multicast
) {
420 uwb_rsv_set_state(rsv
, UWB_RSV_STATE_O_MOVE_COMBINING
);
424 case UWB_RSV_STATE_O_MOVE_COMBINING
:
425 if (rsv
->is_multicast
) {
426 uwb_rsv_set_state(rsv
, UWB_RSV_STATE_O_MOVE_REDUCING
);
430 case UWB_RSV_STATE_O_MOVE_REDUCING
:
431 if (rsv
->is_multicast
) {
432 uwb_rsv_set_state(rsv
, UWB_RSV_STATE_O_ESTABLISHED
);
436 case UWB_RSV_STATE_O_ESTABLISHED
:
437 if (rsv
->is_multicast
)
440 case UWB_RSV_STATE_T_EXPANDING_ACCEPTED
:
442 * The time out could be for the main or of the
443 * companion DRP, assume it's for the companion and
444 * drop that first. A further time out is required to
447 uwb_rsv_set_state(rsv
, UWB_RSV_STATE_T_ACCEPTED
);
448 uwb_drp_avail_release(rsv
->rc
, &rsv
->mv
.companion_mas
);
450 case UWB_RSV_STATE_NONE
:
459 mutex_unlock(&rc
->rsvs_mutex
);
462 static struct uwb_rsv
*uwb_rsv_alloc(struct uwb_rc
*rc
)
466 rsv
= kzalloc(sizeof(struct uwb_rsv
), GFP_KERNEL
);
470 INIT_LIST_HEAD(&rsv
->rc_node
);
471 INIT_LIST_HEAD(&rsv
->pal_node
);
472 kref_init(&rsv
->kref
);
473 setup_timer(&rsv
->timer
, uwb_rsv_timer
, (unsigned long)rsv
);
476 INIT_WORK(&rsv
->handle_timeout_work
, uwb_rsv_handle_timeout_work
);
482 * uwb_rsv_create - allocate and initialize a UWB reservation structure
483 * @rc: the radio controller
484 * @cb: callback to use when the reservation completes or terminates
485 * @pal_priv: data private to the PAL to be passed in the callback
487 * The callback is called when the state of the reservation changes from:
489 * - pending to accepted
490 * - pending to denined
491 * - accepted to terminated
492 * - pending to terminated
494 struct uwb_rsv
*uwb_rsv_create(struct uwb_rc
*rc
, uwb_rsv_cb_f cb
, void *pal_priv
)
498 rsv
= uwb_rsv_alloc(rc
);
503 rsv
->pal_priv
= pal_priv
;
507 EXPORT_SYMBOL_GPL(uwb_rsv_create
);
509 void uwb_rsv_remove(struct uwb_rsv
*rsv
)
511 uwb_rsv_dump("RM", rsv
);
513 if (rsv
->state
!= UWB_RSV_STATE_NONE
)
514 uwb_rsv_set_state(rsv
, UWB_RSV_STATE_NONE
);
516 if (rsv
->needs_release_companion_mas
)
517 uwb_drp_avail_release(rsv
->rc
, &rsv
->mv
.companion_mas
);
518 uwb_drp_avail_release(rsv
->rc
, &rsv
->mas
);
520 if (uwb_rsv_is_owner(rsv
))
521 uwb_rsv_put_stream(rsv
);
523 uwb_dev_put(rsv
->owner
);
524 if (rsv
->target
.type
== UWB_RSV_TARGET_DEV
)
525 uwb_dev_put(rsv
->target
.dev
);
527 list_del_init(&rsv
->rc_node
);
532 * uwb_rsv_destroy - free a UWB reservation structure
533 * @rsv: the reservation to free
535 * The reservation must already be terminated.
537 void uwb_rsv_destroy(struct uwb_rsv
*rsv
)
541 EXPORT_SYMBOL_GPL(uwb_rsv_destroy
);
544 * usb_rsv_establish - start a reservation establishment
545 * @rsv: the reservation
547 * The PAL should fill in @rsv's owner, target, type, max_mas,
548 * min_mas, max_interval and is_multicast fields. If the target is a
549 * uwb_dev it must be referenced.
551 * The reservation's callback will be called when the reservation is
552 * accepted, denied or times out.
554 int uwb_rsv_establish(struct uwb_rsv
*rsv
)
556 struct uwb_rc
*rc
= rsv
->rc
;
557 struct uwb_mas_bm available
;
558 struct device
*dev
= &rc
->uwb_dev
.dev
;
561 mutex_lock(&rc
->rsvs_mutex
);
562 ret
= uwb_rsv_get_stream(rsv
);
564 dev_err(dev
, "%s: uwb_rsv_get_stream failed: %d\n",
569 rsv
->tiebreaker
= prandom_u32() & 1;
570 /* get available mas bitmap */
571 uwb_drp_available(rc
, &available
);
573 ret
= uwb_rsv_find_best_allocation(rsv
, &available
, &rsv
->mas
);
574 if (ret
== UWB_RSV_ALLOC_NOT_FOUND
) {
576 uwb_rsv_put_stream(rsv
);
577 dev_err(dev
, "%s: uwb_rsv_find_best_allocation failed: %d\n",
582 ret
= uwb_drp_avail_reserve_pending(rc
, &rsv
->mas
);
584 uwb_rsv_put_stream(rsv
);
585 dev_err(dev
, "%s: uwb_drp_avail_reserve_pending failed: %d\n",
591 list_add_tail(&rsv
->rc_node
, &rc
->reservations
);
592 rsv
->owner
= &rc
->uwb_dev
;
593 uwb_dev_get(rsv
->owner
);
594 uwb_rsv_set_state(rsv
, UWB_RSV_STATE_O_INITIATED
);
596 mutex_unlock(&rc
->rsvs_mutex
);
599 EXPORT_SYMBOL_GPL(uwb_rsv_establish
);
602 * uwb_rsv_modify - modify an already established reservation
603 * @rsv: the reservation to modify
604 * @max_mas: new maximum MAS to reserve
605 * @min_mas: new minimum MAS to reserve
606 * @max_interval: new max_interval to use
608 * FIXME: implement this once there are PALs that use it.
610 int uwb_rsv_modify(struct uwb_rsv
*rsv
, int max_mas
, int min_mas
, int max_interval
)
614 EXPORT_SYMBOL_GPL(uwb_rsv_modify
);
617 * move an already established reservation (rc->rsvs_mutex must to be
618 * taken when tis function is called)
620 int uwb_rsv_try_move(struct uwb_rsv
*rsv
, struct uwb_mas_bm
*available
)
622 struct uwb_rc
*rc
= rsv
->rc
;
623 struct uwb_drp_backoff_win
*bow
= &rc
->bow
;
624 struct device
*dev
= &rc
->uwb_dev
.dev
;
625 struct uwb_rsv_move
*mv
;
628 if (bow
->can_reserve_extra_mases
== false)
633 if (uwb_rsv_find_best_allocation(rsv
, available
, &mv
->final_mas
) == UWB_RSV_ALLOC_FOUND
) {
635 if (!bitmap_equal(rsv
->mas
.bm
, mv
->final_mas
.bm
, UWB_NUM_MAS
)) {
636 /* We want to move the reservation */
637 bitmap_andnot(mv
->companion_mas
.bm
, mv
->final_mas
.bm
, rsv
->mas
.bm
, UWB_NUM_MAS
);
638 uwb_drp_avail_reserve_pending(rc
, &mv
->companion_mas
);
639 uwb_rsv_set_state(rsv
, UWB_RSV_STATE_O_MOVE_EXPANDING
);
642 dev_dbg(dev
, "new allocation not found\n");
648 /* It will try to move every reservation in state O_ESTABLISHED giving
649 * to the MAS allocator algorithm an availability that is the real one
650 * plus the allocation already established from the reservation. */
651 void uwb_rsv_handle_drp_avail_change(struct uwb_rc
*rc
)
653 struct uwb_drp_backoff_win
*bow
= &rc
->bow
;
655 struct uwb_mas_bm mas
;
657 if (bow
->can_reserve_extra_mases
== false)
660 list_for_each_entry(rsv
, &rc
->reservations
, rc_node
) {
661 if (rsv
->state
== UWB_RSV_STATE_O_ESTABLISHED
||
662 rsv
->state
== UWB_RSV_STATE_O_TO_BE_MOVED
) {
663 uwb_drp_available(rc
, &mas
);
664 bitmap_or(mas
.bm
, mas
.bm
, rsv
->mas
.bm
, UWB_NUM_MAS
);
665 uwb_rsv_try_move(rsv
, &mas
);
672 * uwb_rsv_terminate - terminate an established reservation
673 * @rsv: the reservation to terminate
675 * A reservation is terminated by removing the DRP IE from the beacon,
676 * the other end will consider the reservation to be terminated when
677 * it does not see the DRP IE for at least mMaxLostBeacons.
679 * If applicable, the reference to the target uwb_dev will be released.
681 void uwb_rsv_terminate(struct uwb_rsv
*rsv
)
683 struct uwb_rc
*rc
= rsv
->rc
;
685 mutex_lock(&rc
->rsvs_mutex
);
687 if (rsv
->state
!= UWB_RSV_STATE_NONE
)
688 uwb_rsv_set_state(rsv
, UWB_RSV_STATE_NONE
);
690 mutex_unlock(&rc
->rsvs_mutex
);
692 EXPORT_SYMBOL_GPL(uwb_rsv_terminate
);
695 * uwb_rsv_accept - accept a new reservation from a peer
696 * @rsv: the reservation
697 * @cb: call back for reservation changes
698 * @pal_priv: data to be passed in the above call back
700 * Reservation requests from peers are denied unless a PAL accepts it
701 * by calling this function.
703 * The PAL call uwb_rsv_destroy() for all accepted reservations before
704 * calling uwb_pal_unregister().
706 void uwb_rsv_accept(struct uwb_rsv
*rsv
, uwb_rsv_cb_f cb
, void *pal_priv
)
711 rsv
->pal_priv
= pal_priv
;
712 rsv
->state
= UWB_RSV_STATE_T_ACCEPTED
;
714 EXPORT_SYMBOL_GPL(uwb_rsv_accept
);
717 * Is a received DRP IE for this reservation?
719 static bool uwb_rsv_match(struct uwb_rsv
*rsv
, struct uwb_dev
*src
,
720 struct uwb_ie_drp
*drp_ie
)
722 struct uwb_dev_addr
*rsv_src
;
725 stream
= uwb_ie_drp_stream_index(drp_ie
);
727 if (rsv
->stream
!= stream
)
730 switch (rsv
->target
.type
) {
731 case UWB_RSV_TARGET_DEVADDR
:
732 return rsv
->stream
== stream
;
733 case UWB_RSV_TARGET_DEV
:
734 if (uwb_ie_drp_owner(drp_ie
))
735 rsv_src
= &rsv
->owner
->dev_addr
;
737 rsv_src
= &rsv
->target
.dev
->dev_addr
;
738 return uwb_dev_addr_cmp(&src
->dev_addr
, rsv_src
) == 0;
743 static struct uwb_rsv
*uwb_rsv_new_target(struct uwb_rc
*rc
,
745 struct uwb_ie_drp
*drp_ie
)
749 enum uwb_rsv_state state
;
751 rsv
= uwb_rsv_alloc(rc
);
757 uwb_dev_get(rsv
->owner
);
758 rsv
->target
.type
= UWB_RSV_TARGET_DEV
;
759 rsv
->target
.dev
= &rc
->uwb_dev
;
760 uwb_dev_get(&rc
->uwb_dev
);
761 rsv
->type
= uwb_ie_drp_type(drp_ie
);
762 rsv
->stream
= uwb_ie_drp_stream_index(drp_ie
);
763 uwb_drp_ie_to_bm(&rsv
->mas
, drp_ie
);
766 * See if any PALs are interested in this reservation. If not,
769 rsv
->state
= UWB_RSV_STATE_T_DENIED
;
770 mutex_lock(&rc
->uwb_dev
.mutex
);
771 list_for_each_entry(pal
, &rc
->pals
, node
) {
773 pal
->new_rsv(pal
, rsv
);
774 if (rsv
->state
== UWB_RSV_STATE_T_ACCEPTED
)
777 mutex_unlock(&rc
->uwb_dev
.mutex
);
779 list_add_tail(&rsv
->rc_node
, &rc
->reservations
);
781 rsv
->state
= UWB_RSV_STATE_NONE
;
783 /* FIXME: do something sensible here */
784 if (state
== UWB_RSV_STATE_T_ACCEPTED
785 && uwb_drp_avail_reserve_pending(rc
, &rsv
->mas
) == -EBUSY
) {
786 /* FIXME: do something sensible here */
788 uwb_rsv_set_state(rsv
, state
);
795 * uwb_rsv_get_usable_mas - get the bitmap of the usable MAS of a reservations
796 * @rsv: the reservation.
797 * @mas: returns the available MAS.
799 * The usable MAS of a reservation may be less than the negotiated MAS
800 * if alien BPs are present.
802 void uwb_rsv_get_usable_mas(struct uwb_rsv
*rsv
, struct uwb_mas_bm
*mas
)
804 bitmap_zero(mas
->bm
, UWB_NUM_MAS
);
805 bitmap_andnot(mas
->bm
, rsv
->mas
.bm
, rsv
->rc
->cnflt_alien_bitmap
.bm
, UWB_NUM_MAS
);
807 EXPORT_SYMBOL_GPL(uwb_rsv_get_usable_mas
);
810 * uwb_rsv_find - find a reservation for a received DRP IE.
811 * @rc: the radio controller
812 * @src: source of the DRP IE
813 * @drp_ie: the DRP IE
815 * If the reservation cannot be found and the DRP IE is from a peer
816 * attempting to establish a new reservation, create a new reservation
817 * and add it to the list.
819 struct uwb_rsv
*uwb_rsv_find(struct uwb_rc
*rc
, struct uwb_dev
*src
,
820 struct uwb_ie_drp
*drp_ie
)
824 list_for_each_entry(rsv
, &rc
->reservations
, rc_node
) {
825 if (uwb_rsv_match(rsv
, src
, drp_ie
))
829 if (uwb_ie_drp_owner(drp_ie
))
830 return uwb_rsv_new_target(rc
, src
, drp_ie
);
836 * Go through all the reservations and check for timeouts and (if
837 * necessary) update their DRP IEs.
839 * FIXME: look at building the SET_DRP_IE command here rather than
840 * having to rescan the list in uwb_rc_send_all_drp_ie().
842 static bool uwb_rsv_update_all(struct uwb_rc
*rc
)
844 struct uwb_rsv
*rsv
, *t
;
845 bool ie_updated
= false;
847 list_for_each_entry_safe(rsv
, t
, &rc
->reservations
, rc_node
) {
848 if (!rsv
->ie_valid
) {
849 uwb_drp_ie_update(rsv
);
857 void uwb_rsv_queue_update(struct uwb_rc
*rc
)
859 unsigned long delay_us
= UWB_MAS_LENGTH_US
* UWB_MAS_PER_ZONE
;
861 queue_delayed_work(rc
->rsv_workq
, &rc
->rsv_update_work
, usecs_to_jiffies(delay_us
));
865 * uwb_rsv_sched_update - schedule an update of the DRP IEs
866 * @rc: the radio controller.
868 * To improve performance and ensure correctness with [ECMA-368] the
869 * number of SET-DRP-IE commands that are done are limited.
871 * DRP IEs update come from two sources: DRP events from the hardware
872 * which all occur at the beginning of the superframe ('syncronous'
873 * events) and reservation establishment/termination requests from
874 * PALs or timers ('asynchronous' events).
876 * A delayed work ensures that all the synchronous events result in
877 * one SET-DRP-IE command.
879 * Additional logic (the set_drp_ie_pending and rsv_updated_postponed
880 * flags) will prevent an asynchrous event starting a SET-DRP-IE
881 * command if one is currently awaiting a response.
883 * FIXME: this does leave a window where an asynchrous event can delay
884 * the SET-DRP-IE for a synchronous event by one superframe.
886 void uwb_rsv_sched_update(struct uwb_rc
*rc
)
888 spin_lock_irq(&rc
->rsvs_lock
);
889 if (!delayed_work_pending(&rc
->rsv_update_work
)) {
890 if (rc
->set_drp_ie_pending
> 0) {
891 rc
->set_drp_ie_pending
++;
894 uwb_rsv_queue_update(rc
);
897 spin_unlock_irq(&rc
->rsvs_lock
);
901 * Update DRP IEs and, if necessary, the DRP Availability IE and send
902 * the updated IEs to the radio controller.
904 static void uwb_rsv_update_work(struct work_struct
*work
)
906 struct uwb_rc
*rc
= container_of(work
, struct uwb_rc
,
907 rsv_update_work
.work
);
910 mutex_lock(&rc
->rsvs_mutex
);
912 ie_updated
= uwb_rsv_update_all(rc
);
914 if (!rc
->drp_avail
.ie_valid
) {
915 uwb_drp_avail_ie_update(rc
);
919 if (ie_updated
&& (rc
->set_drp_ie_pending
== 0))
920 uwb_rc_send_all_drp_ie(rc
);
922 mutex_unlock(&rc
->rsvs_mutex
);
925 static void uwb_rsv_alien_bp_work(struct work_struct
*work
)
927 struct uwb_rc
*rc
= container_of(work
, struct uwb_rc
,
928 rsv_alien_bp_work
.work
);
931 mutex_lock(&rc
->rsvs_mutex
);
933 list_for_each_entry(rsv
, &rc
->reservations
, rc_node
) {
934 if (rsv
->type
!= UWB_DRP_TYPE_ALIEN_BP
) {
935 uwb_rsv_callback(rsv
);
939 mutex_unlock(&rc
->rsvs_mutex
);
942 static void uwb_rsv_timer(unsigned long arg
)
944 struct uwb_rsv
*rsv
= (struct uwb_rsv
*)arg
;
946 queue_work(rsv
->rc
->rsv_workq
, &rsv
->handle_timeout_work
);
950 * uwb_rsv_remove_all - remove all reservations
951 * @rc: the radio controller
953 * A DRP IE update is not done.
955 void uwb_rsv_remove_all(struct uwb_rc
*rc
)
957 struct uwb_rsv
*rsv
, *t
;
959 mutex_lock(&rc
->rsvs_mutex
);
960 list_for_each_entry_safe(rsv
, t
, &rc
->reservations
, rc_node
) {
961 if (rsv
->state
!= UWB_RSV_STATE_NONE
)
962 uwb_rsv_set_state(rsv
, UWB_RSV_STATE_NONE
);
963 del_timer_sync(&rsv
->timer
);
965 /* Cancel any postponed update. */
966 rc
->set_drp_ie_pending
= 0;
967 mutex_unlock(&rc
->rsvs_mutex
);
969 cancel_delayed_work_sync(&rc
->rsv_update_work
);
970 flush_workqueue(rc
->rsv_workq
);
972 mutex_lock(&rc
->rsvs_mutex
);
973 list_for_each_entry_safe(rsv
, t
, &rc
->reservations
, rc_node
) {
976 mutex_unlock(&rc
->rsvs_mutex
);
979 void uwb_rsv_init(struct uwb_rc
*rc
)
981 INIT_LIST_HEAD(&rc
->reservations
);
982 INIT_LIST_HEAD(&rc
->cnflt_alien_list
);
983 mutex_init(&rc
->rsvs_mutex
);
984 spin_lock_init(&rc
->rsvs_lock
);
985 INIT_DELAYED_WORK(&rc
->rsv_update_work
, uwb_rsv_update_work
);
986 INIT_DELAYED_WORK(&rc
->rsv_alien_bp_work
, uwb_rsv_alien_bp_work
);
987 rc
->bow
.can_reserve_extra_mases
= true;
988 rc
->bow
.total_expired
= 0;
989 rc
->bow
.window
= UWB_DRP_BACKOFF_WIN_MIN
>> 1;
990 setup_timer(&rc
->bow
.timer
, uwb_rsv_backoff_win_timer
,
991 (unsigned long)&rc
->bow
);
993 bitmap_complement(rc
->uwb_dev
.streams
, rc
->uwb_dev
.streams
, UWB_NUM_STREAMS
);
996 int uwb_rsv_setup(struct uwb_rc
*rc
)
1000 snprintf(name
, sizeof(name
), "%s_rsvd", dev_name(&rc
->uwb_dev
.dev
));
1001 rc
->rsv_workq
= create_singlethread_workqueue(name
);
1002 if (rc
->rsv_workq
== NULL
)
1008 void uwb_rsv_cleanup(struct uwb_rc
*rc
)
1010 uwb_rsv_remove_all(rc
);
1011 destroy_workqueue(rc
->rsv_workq
);