1 /**************************************************************************/
2 /* ---------------------------------------------------------------------- */
3 /* Copyright (C) 2006 - 2008 FRESCOR consortium partners: */
5 /* Universidad de Cantabria, SPAIN */
6 /* University of York, UK */
7 /* Scuola Superiore Sant'Anna, ITALY */
8 /* Kaiserslautern University, GERMANY */
9 /* Univ. Politécnica Valencia, SPAIN */
10 /* Czech Technical University in Prague, CZECH REPUBLIC */
12 /* Thales Communication S.A. FRANCE */
13 /* Visual Tools S.A. SPAIN */
14 /* Rapita Systems Ltd UK */
17 /* See http://www.frescor.org for a link to partners' websites */
19 /* FRESCOR project (FP6/2005/IST/5-034026) is funded */
20 /* in part by the European Union Sixth Framework Programme */
21 /* The European Union is not liable of any use that may be */
22 /* made of this code. */
25 /* This file is part of FWP (Frescor WLAN Protocol) */
27 /* FWP is free software; you can redistribute it and/or modify it */
28 /* under terms of the GNU General Public License as published by the */
29 /* Free Software Foundation; either version 2, or (at your option) any */
30 /* later version. FWP is distributed in the hope that it will be */
31 /* useful, but WITHOUT ANY WARRANTY; without even the implied warranty */
32 /* of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU */
33 /* General Public License for more details. You should have received a */
34 /* copy of the GNU General Public License along with FWP; see file */
35 /* COPYING. If not, write to the Free Software Foundation, 675 Mass Ave, */
36 /* Cambridge, MA 02139, USA. */
38 /* As a special exception, including FWP header files in a file, */
39 /* instantiating FWP generics or templates, or linking other files */
40 /* with FWP objects to produce an executable application, does not */
41 /* by itself cause the resulting executable application to be covered */
42 /* by the GNU General Public License. This exception does not */
43 /* however invalidate any other reasons why the executable file might be */
44 /* covered by the GNU Public License. */
45 /**************************************************************************/
46 #include <fres_sa_scenario.h>
49 #include "fwp_admctrl.h"
51 #include <ul_logreg.h>
52 #include "fwp_utils.h"
54 UL_LOG_CUST(ulogd_fwp_admctrl);
55 ul_log_domain_t ulogd_fwp_admctrl = {UL_LOGL_MSG, "fwp_admctrl"};
56 UL_LOGREG_SINGLE_DOMAIN_INIT_FUNCTION(fwp_admctrl_logreg_domains, ulogd_fwp_admctrl);
58 /* TODO: Find out the real value and determine what influences it (MTU
59 * of the interface minus header sizes?). */
61 #define UDP_HEADER_SIZE 8
62 #define IP_HEADER_SIZE 20
63 #define LLC_HEADER_SIZE 2 /* ??? */
64 #define MAC_HEADER_SIZE 26 /* With QoS field added */
65 #define MAC_FCS_SIZE 4
67 #define RTS_FRAME_SIZE 20
68 #define CTS_FRAME_SIZE 14
69 #define ACK_FRAME_SIZE 14
71 #define ASLOTTIME_USEC 20 /* 802.11g-2003 p. 46 */
72 #define ASIFSTIME_USEC 10
73 #define ADIFSTIME_USEC (ASIFSTIME_USEC + 2*ASLOTTIME_USEC)
74 #define AAIFSTIME_USEC(n) (ASIFSTIME_USEC + (n)*ASLOTTIME_USEC)
76 /* Default values from 802.11e */
77 const int aifsn[FWP_AC_NUM] = { 2, 2, 3, 7 };
78 const int cwmin[FWP_AC_NUM] = { 3, 7, 15, 15 };
80 /* Experimental konstants - weight of backoff */
81 const int pisvejc[FWP_AC_NUM] = { 6, 5, 2, 2 };
83 int fwp_reserved_utilization;
86 * Calucaltes frame duration in microseconds. If the real duration is
87 * represented by a fractional number, the value is rounded up.
89 * @param length Number of bytes in PSDU.
90 * @param rate_bps Transmit rate of PSDU. The rate should correspond
91 * to other parameters accoring to 19.3.2 (802.11g)
92 * @param erp_ofdm Whether Extended Rate PHY (part of 802.11g) and ERP-OFDM
94 * @param short_preamble Whether short preamble (HR/DSSS/short) is
97 * @return The number of microseconds or a negative number in case of error.
99 static int frame_duration(uint16_t length, int rate_bps, bool erp_ofdm, bool short_preamble)
101 uint32_t duration_usec = 0;
104 duration_usec = ((int64_t)(length) * 8 * SEC_TO_USEC / rate_bps);
105 if (short_preamble) {
106 /* For HR/DSSS/short (2, 5.5 and 11 Mbit,
107 * 802.11b-1999), also for DSSS-OFDM rates and
109 * Preamble sent at 1 MBit, header at 2 Mbit */
110 duration_usec += 72/*bits*/+48/*bits*//2;
112 /* For DSSS PHY (1 and 2 Mbit rates,
113 * 802.11-1999) and for DSS-OFDM and ERP-PBCC
114 * rates. Always sent at 1 MBit */
115 duration_usec += 144/*bits*/+48/*bits*/;
118 #define MBIT_TO_INDEX(rate_Mbps) ((rate_Mbps)/3 - 2)
119 const int N_dbps[] = {
120 [MBIT_TO_INDEX(6)] = 24,
121 [MBIT_TO_INDEX(9)] = 36,
122 [MBIT_TO_INDEX(12)] = 48,
123 [MBIT_TO_INDEX(18)] = 72,
124 [MBIT_TO_INDEX(24)] = 96,
125 [MBIT_TO_INDEX(36)] = 144,
126 [MBIT_TO_INDEX(48)] = 192,
127 [MBIT_TO_INDEX(54)] = 216
129 int rate_idx = MBIT_TO_INDEX(rate_bps/1000/1000);
132 rate_idx >= sizeof(N_dbps)/sizeof(*N_dbps) ||
133 N_dbps[rate_idx] == 0)
136 duration_usec += 16 + 4; /* Preamble, SIGNAL */
141 int Nsym = (bits + N_dbps[rate_idx] - 1)/N_dbps[rate_idx];
143 duration_usec += Nsym * 4;
145 duration_usec += 6; /* signal extension */
147 return duration_usec;
150 int fwp_admctrl_utilization(struct fres_sa_scenario *scenario, void *priv,
155 const int rate = 54*1000*1000;
156 const bool erp_ofdm = true;
157 const bool short_preamble = true;
158 struct fres_sa_contract *c;
159 long int period_usec;
160 fres_block_fwp_sched *fwp_sched;
163 long int duration_usec, tmp_usec;
167 fres_sa_scenario_for_each_no_cancel_contract(scenario, c) {
168 fres_block_basic *basic;
170 fres_contract_id_to_string(id, &c->contract->id, sizeof(id));
171 basic = fres_contract_get_basic(c->contract);
173 frsh_network_budget_to_bytes(FRSH_NETPF_FWP,&basic->budget,&bytes);
174 ul_logmsg("processing: id=%s, period=%ld ms, budget=%lu bytes\n",
176 fosa_rel_time_to_msec(basic->period),
177 (long unsigned int)bytes);
179 period_usec = basic ? fosa_rel_time_to_msec(basic->period)*1000 : 0;
181 /* Calculate protocol overhead */
182 fragments = (bytes + MTU - 1) / MTU;
184 if (fragments == 0 && period_usec != 0)
187 const int data_overhead = UDP_HEADER_SIZE + IP_HEADER_SIZE +
188 LLC_HEADER_SIZE + MAC_FCS_SIZE;
190 duration_usec = frame_duration(data_overhead + bytes%MTU, rate,
191 erp_ofdm, short_preamble);
192 tmp_usec = frame_duration(data_overhead + MTU, rate, erp_ofdm,
194 duration_usec += tmp_usec*(fragments-1);
195 /* Add average backoff - assume there is no collision */
196 tmp_usec = ASLOTTIME_USEC*fragments*pisvejc[ac];
197 duration_usec += (aifsn[ac] + cwmin[ac]/2)*tmp_usec;
198 /* We use ACK and ignore burst */
199 tmp_usec = frame_duration(ACK_FRAME_SIZE, rate, erp_ofdm,
200 short_preamble) + ASIFSTIME_USEC;
201 duration_usec += fragments * tmp_usec;
202 //printf("duration: %ld ms\n", duration_usec/1000);
204 /* TODO: If STA-to-STA, multiply it by two. Note that
205 * AP may use different values for backoff. */
206 //duration_usec *= 2; /* For demo, we have always STA-to-STA */
208 if (c->contract == c->new) {
209 if (period_usec == 0) {
210 ul_logmsg("Period is zero!\n");
211 goto not_schedulable;
214 frsh_rel_time_t deadline;
216 if (fres_contract_get_deadline(&c->contract, &deadline)) {
217 d = fosa_rel_time_to_msec(deadline)*1000;
219 d = 100/*sec*/*1000*1000;
221 if (d < 30/*msec*/*1000) {
222 ul_logmsg("Deadline shorter than 30 ms!\n");
223 goto not_schedulable;
226 fwp_sched = malloc(sizeof(*fwp_sched));
228 d < 100*1000 ? FWP_AC_VO :
229 d < 500*1000 ? FWP_AC_VI :
230 d < 1000*1000 ? FWP_AC_BE :
232 fres_contract_add_block(c->contract, FRES_BLOCK_FWP_SCHED, fwp_sched);
235 utilization += (long long)(duration_usec * 10000) / period_usec;
238 if (utilization >= 10000 * 96/100) {
239 goto not_schedulable;
241 scenario->utilization = utilization/100; /* For GUI */
243 ul_logmsg("accepted\n");
248 ul_logmsg("rejected\n");
249 *schedulable = false;