blob: 0833dd226222489c8726e2b2b88be41a38b8c769 [file] [log] [blame]
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +00001/*
2 * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020011#include "modules/bitrate_controller/send_side_bandwidth_estimation.h"
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +000012
jbauchf91e6d02016-01-24 23:05:21 -080013#include <algorithm>
Piotr Tworek5e4833c2017-12-12 12:09:31 +010014#include <cstdio>
Stefan Holmer9c79ed92017-03-31 15:53:27 +020015#include <limits>
16#include <string>
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +000017
Karl Wiberg918f50c2018-07-05 11:40:33 +020018#include "absl/memory/memory.h"
Yves Gerey988cc082018-10-23 12:03:01 +020019#include "logging/rtc_event_log/events/rtc_event.h"
Elad Alon4a87e1c2017-10-03 16:11:34 +020020#include "logging/rtc_event_log/events/rtc_event_bwe_update_loss_based.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020021#include "logging/rtc_event_log/rtc_event_log.h"
22#include "modules/remote_bitrate_estimator/include/bwe_defines.h"
23#include "rtc_base/checks.h"
24#include "rtc_base/logging.h"
25#include "system_wrappers/include/field_trial.h"
26#include "system_wrappers/include/metrics.h"
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +000027
28namespace webrtc {
andresp@webrtc.org07bc7342014-03-21 16:51:01 +000029namespace {
Sebastian Jansson7c1744d2018-10-08 11:00:50 +020030constexpr TimeDelta kBweIncreaseInterval = TimeDelta::Millis<1000>();
31constexpr TimeDelta kBweDecreaseInterval = TimeDelta::Millis<300>();
32constexpr TimeDelta kStartPhase = TimeDelta::Millis<2000>();
33constexpr TimeDelta kBweConverganceTime = TimeDelta::Millis<20000>();
34constexpr int kLimitNumPackets = 20;
35constexpr DataRate kDefaultMaxBitrate = DataRate::BitsPerSec<1000000000>();
36constexpr TimeDelta kLowBitrateLogPeriod = TimeDelta::Millis<10000>();
37constexpr TimeDelta kRtcEventLogPeriod = TimeDelta::Millis<5000>();
Stefan Holmer52200d02016-09-20 14:14:23 +020038// Expecting that RTCP feedback is sent uniformly within [0.5, 1.5]s intervals.
Sebastian Jansson7c1744d2018-10-08 11:00:50 +020039constexpr TimeDelta kMaxRtcpFeedbackInterval = TimeDelta::Millis<5000>();
40constexpr int kFeedbackTimeoutIntervals = 3;
41constexpr TimeDelta kTimeoutInterval = TimeDelta::Millis<1000>();
andresp@webrtc.org07bc7342014-03-21 16:51:01 +000042
Sebastian Jansson7c1744d2018-10-08 11:00:50 +020043constexpr float kDefaultLowLossThreshold = 0.02f;
44constexpr float kDefaultHighLossThreshold = 0.1f;
45constexpr DataRate kDefaultBitrateThreshold = DataRate::Zero();
Stefan Holmer9c79ed92017-03-31 15:53:27 +020046
stefan@webrtc.org474e36e2015-01-19 15:44:47 +000047struct UmaRampUpMetric {
48 const char* metric_name;
49 int bitrate_kbps;
50};
51
52const UmaRampUpMetric kUmaRampupMetrics[] = {
53 {"WebRTC.BWE.RampUpTimeTo500kbpsInMs", 500},
54 {"WebRTC.BWE.RampUpTimeTo1000kbpsInMs", 1000},
55 {"WebRTC.BWE.RampUpTimeTo2000kbpsInMs", 2000}};
56const size_t kNumUmaRampupMetrics =
57 sizeof(kUmaRampupMetrics) / sizeof(kUmaRampupMetrics[0]);
58
Stefan Holmer9c79ed92017-03-31 15:53:27 +020059const char kBweLosExperiment[] = "WebRTC-BweLossExperiment";
60
61bool BweLossExperimentIsEnabled() {
62 std::string experiment_string =
63 webrtc::field_trial::FindFullName(kBweLosExperiment);
64 // The experiment is enabled iff the field trial string begins with "Enabled".
65 return experiment_string.find("Enabled") == 0;
66}
67
68bool ReadBweLossExperimentParameters(float* low_loss_threshold,
69 float* high_loss_threshold,
70 uint32_t* bitrate_threshold_kbps) {
71 RTC_DCHECK(low_loss_threshold);
72 RTC_DCHECK(high_loss_threshold);
73 RTC_DCHECK(bitrate_threshold_kbps);
74 std::string experiment_string =
75 webrtc::field_trial::FindFullName(kBweLosExperiment);
76 int parsed_values =
77 sscanf(experiment_string.c_str(), "Enabled-%f,%f,%u", low_loss_threshold,
78 high_loss_threshold, bitrate_threshold_kbps);
79 if (parsed_values == 3) {
80 RTC_CHECK_GT(*low_loss_threshold, 0.0f)
81 << "Loss threshold must be greater than 0.";
82 RTC_CHECK_LE(*low_loss_threshold, 1.0f)
83 << "Loss threshold must be less than or equal to 1.";
84 RTC_CHECK_GT(*high_loss_threshold, 0.0f)
85 << "Loss threshold must be greater than 0.";
86 RTC_CHECK_LE(*high_loss_threshold, 1.0f)
87 << "Loss threshold must be less than or equal to 1.";
88 RTC_CHECK_LE(*low_loss_threshold, *high_loss_threshold)
89 << "The low loss threshold must be less than or equal to the high loss "
90 "threshold.";
91 RTC_CHECK_GE(*bitrate_threshold_kbps, 0)
92 << "Bitrate threshold can't be negative.";
93 RTC_CHECK_LT(*bitrate_threshold_kbps,
94 std::numeric_limits<int>::max() / 1000)
95 << "Bitrate must be smaller enough to avoid overflows.";
96 return true;
97 }
Mirko Bonadei675513b2017-11-09 11:09:25 +010098 RTC_LOG(LS_WARNING) << "Failed to parse parameters for BweLossExperiment "
99 "experiment from field trial string. Using default.";
Stefan Holmer9c79ed92017-03-31 15:53:27 +0200100 *low_loss_threshold = kDefaultLowLossThreshold;
101 *high_loss_threshold = kDefaultHighLossThreshold;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200102 *bitrate_threshold_kbps = kDefaultBitrateThreshold.kbps();
Stefan Holmer9c79ed92017-03-31 15:53:27 +0200103 return false;
104}
jbauchf91e6d02016-01-24 23:05:21 -0800105} // namespace
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000106
Sebastian Jansson24643482018-11-14 14:19:45 +0100107RttBasedBackoff::RttBasedBackoff()
108 : rtt_limit_("limit", TimeDelta::PlusInfinity()),
109 drop_fraction_("fraction", 0.5),
110 drop_interval_("interval", TimeDelta::ms(300)),
111 persist_on_route_change_("persist"),
112 // By initializing this to plus infinity, we make sure that we never
113 // trigger rtt backoff unless packet feedback is enabled.
114 last_propagation_rtt_update_(Timestamp::PlusInfinity()),
115 last_propagation_rtt_(TimeDelta::Zero()) {
116 ParseFieldTrial({&rtt_limit_, &drop_fraction_, &drop_interval_,
117 &persist_on_route_change_},
118 field_trial::FindFullName("WebRTC-Bwe-MaxRttLimit"));
Sebastian Jansson2e068e82018-10-08 12:49:53 +0200119}
Sebastian Jansson24643482018-11-14 14:19:45 +0100120
121void RttBasedBackoff::OnRouteChange() {
122 if (!persist_on_route_change_) {
123 last_propagation_rtt_update_ = Timestamp::PlusInfinity();
124 last_propagation_rtt_ = TimeDelta::Zero();
125 }
126}
127
128void RttBasedBackoff::UpdatePropagationRtt(Timestamp at_time,
129 TimeDelta propagation_rtt) {
130 last_propagation_rtt_update_ = at_time;
131 last_propagation_rtt_ = propagation_rtt;
132}
133
134TimeDelta RttBasedBackoff::RttLowerBound(Timestamp at_time) const {
135 // TODO(srte): Use time since last unacknowledged packet for this.
136 TimeDelta time_since_rtt = at_time - last_propagation_rtt_update_;
137 return time_since_rtt + last_propagation_rtt_;
138}
139
140RttBasedBackoff::~RttBasedBackoff() = default;
Sebastian Jansson2e068e82018-10-08 12:49:53 +0200141
ivoc14d5dbe2016-07-04 07:06:55 -0700142SendSideBandwidthEstimation::SendSideBandwidthEstimation(RtcEventLog* event_log)
Sebastian Jansson24643482018-11-14 14:19:45 +0100143 : lost_packets_since_last_loss_update_(0),
pbosb7edb882015-10-22 08:52:20 -0700144 expected_packets_since_last_loss_update_(0),
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200145 current_bitrate_(DataRate::Zero()),
146 min_bitrate_configured_(
147 DataRate::bps(congestion_controller::GetMinBitrateBps())),
148 max_bitrate_configured_(kDefaultMaxBitrate),
149 last_low_bitrate_log_(Timestamp::MinusInfinity()),
pbosb7edb882015-10-22 08:52:20 -0700150 has_decreased_since_last_fraction_loss_(false),
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200151 last_loss_feedback_(Timestamp::MinusInfinity()),
152 last_loss_packet_report_(Timestamp::MinusInfinity()),
153 last_timeout_(Timestamp::MinusInfinity()),
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000154 last_fraction_loss_(0),
stefan3821ff82016-09-04 05:07:26 -0700155 last_logged_fraction_loss_(0),
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200156 last_round_trip_time_(TimeDelta::Zero()),
157 bwe_incoming_(DataRate::Zero()),
158 delay_based_bitrate_(DataRate::Zero()),
159 time_last_decrease_(Timestamp::MinusInfinity()),
160 first_report_time_(Timestamp::MinusInfinity()),
stefan@webrtc.org548b2282014-11-03 14:42:43 +0000161 initially_lost_packets_(0),
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200162 bitrate_at_2_seconds_(DataRate::Zero()),
stefan@webrtc.org474e36e2015-01-19 15:44:47 +0000163 uma_update_state_(kNoUpdate),
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100164 uma_rtt_state_(kNoUpdate),
terelius006d93d2015-11-05 12:02:15 -0800165 rampup_uma_stats_updated_(kNumUmaRampupMetrics, false),
stefan3821ff82016-09-04 05:07:26 -0700166 event_log_(event_log),
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200167 last_rtc_event_log_(Timestamp::MinusInfinity()),
sprangc1b57a12017-02-28 08:50:47 -0800168 in_timeout_experiment_(
Stefan Holmer9c79ed92017-03-31 15:53:27 +0200169 webrtc::field_trial::IsEnabled("WebRTC-FeedbackTimeout")),
170 low_loss_threshold_(kDefaultLowLossThreshold),
171 high_loss_threshold_(kDefaultHighLossThreshold),
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200172 bitrate_threshold_(kDefaultBitrateThreshold) {
ivoc14d5dbe2016-07-04 07:06:55 -0700173 RTC_DCHECK(event_log);
Stefan Holmer9c79ed92017-03-31 15:53:27 +0200174 if (BweLossExperimentIsEnabled()) {
175 uint32_t bitrate_threshold_kbps;
176 if (ReadBweLossExperimentParameters(&low_loss_threshold_,
177 &high_loss_threshold_,
178 &bitrate_threshold_kbps)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100179 RTC_LOG(LS_INFO) << "Enabled BweLossExperiment with parameters "
180 << low_loss_threshold_ << ", " << high_loss_threshold_
181 << ", " << bitrate_threshold_kbps;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200182 bitrate_threshold_ = DataRate::kbps(bitrate_threshold_kbps);
Stefan Holmer9c79ed92017-03-31 15:53:27 +0200183 }
184 }
ivoc14d5dbe2016-07-04 07:06:55 -0700185}
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000186
andresp@webrtc.org16b75c22014-03-21 14:00:51 +0000187SendSideBandwidthEstimation::~SendSideBandwidthEstimation() {}
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000188
Sebastian Jansson24643482018-11-14 14:19:45 +0100189void SendSideBandwidthEstimation::OnRouteChange() {
190 lost_packets_since_last_loss_update_ = 0;
191 expected_packets_since_last_loss_update_ = 0;
192 current_bitrate_ = DataRate::Zero();
193 min_bitrate_configured_ =
194 DataRate::bps(congestion_controller::GetMinBitrateBps());
195 max_bitrate_configured_ = kDefaultMaxBitrate;
196 last_low_bitrate_log_ = Timestamp::MinusInfinity();
197 has_decreased_since_last_fraction_loss_ = false;
198 last_loss_feedback_ = Timestamp::MinusInfinity();
199 last_loss_packet_report_ = Timestamp::MinusInfinity();
200 last_timeout_ = Timestamp::MinusInfinity();
201 last_fraction_loss_ = 0;
202 last_logged_fraction_loss_ = 0;
203 last_round_trip_time_ = TimeDelta::Zero();
204 bwe_incoming_ = DataRate::Zero();
205 delay_based_bitrate_ = DataRate::Zero();
206 time_last_decrease_ = Timestamp::MinusInfinity();
207 first_report_time_ = Timestamp::MinusInfinity();
208 initially_lost_packets_ = 0;
209 bitrate_at_2_seconds_ = DataRate::Zero();
210 uma_update_state_ = kNoUpdate;
211 uma_rtt_state_ = kNoUpdate;
212 last_rtc_event_log_ = Timestamp::MinusInfinity();
213
214 rtt_backoff_.OnRouteChange();
215}
216
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200217void SendSideBandwidthEstimation::SetBitrates(
218 absl::optional<DataRate> send_bitrate,
219 DataRate min_bitrate,
220 DataRate max_bitrate,
221 Timestamp at_time) {
philipel1b965312017-04-18 06:55:32 -0700222 SetMinMaxBitrate(min_bitrate, max_bitrate);
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200223 if (send_bitrate)
224 SetSendBitrate(*send_bitrate, at_time);
philipelc6957c72016-04-28 15:52:49 +0200225}
226
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200227void SendSideBandwidthEstimation::SetSendBitrate(DataRate bitrate,
228 Timestamp at_time) {
229 RTC_DCHECK(bitrate > DataRate::Zero());
230 // Reset to avoid being capped by the estimate.
231 delay_based_bitrate_ = DataRate::Zero();
Christoffer Rodbro3a837482018-11-19 15:30:23 +0100232 if (loss_based_bandwidth_estimation_.Enabled()) {
233 loss_based_bandwidth_estimation_.MaybeReset(bitrate);
234 }
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200235 CapBitrateToThresholds(at_time, bitrate);
andresp@webrtc.org44caf012014-03-26 21:00:21 +0000236 // Clear last sent bitrate history so the new value can be used directly
237 // and not capped.
238 min_bitrate_history_.clear();
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000239}
240
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200241void SendSideBandwidthEstimation::SetMinMaxBitrate(DataRate min_bitrate,
242 DataRate max_bitrate) {
michaeltf082c2a2016-11-07 04:17:14 -0800243 min_bitrate_configured_ =
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200244 std::max(min_bitrate, congestion_controller::GetMinBitrate());
245 if (max_bitrate > DataRate::Zero() && max_bitrate.IsFinite()) {
246 max_bitrate_configured_ = std::max(min_bitrate_configured_, max_bitrate);
Stefan Holmere5904162015-03-26 11:11:06 +0100247 } else {
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200248 max_bitrate_configured_ = kDefaultMaxBitrate;
Stefan Holmere5904162015-03-26 11:11:06 +0100249 }
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000250}
251
Stefan Holmere5904162015-03-26 11:11:06 +0100252int SendSideBandwidthEstimation::GetMinBitrate() const {
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200253 return min_bitrate_configured_.bps<int>();
henrik.lundin@webrtc.org845862f2014-03-06 07:19:28 +0000254}
255
Stefan Holmere5904162015-03-26 11:11:06 +0100256void SendSideBandwidthEstimation::CurrentEstimate(int* bitrate,
andresp@webrtc.org07bc7342014-03-21 16:51:01 +0000257 uint8_t* loss,
pkasting@chromium.org16825b12015-01-12 21:51:21 +0000258 int64_t* rtt) const {
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200259 *bitrate = current_bitrate_.bps<int>();
andresp@webrtc.org07bc7342014-03-21 16:51:01 +0000260 *loss = last_fraction_loss_;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200261 *rtt = last_round_trip_time_.ms<int64_t>();
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000262}
263
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200264void SendSideBandwidthEstimation::UpdateReceiverEstimate(Timestamp at_time,
265 DataRate bandwidth) {
andresp@webrtc.org07bc7342014-03-21 16:51:01 +0000266 bwe_incoming_ = bandwidth;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200267 CapBitrateToThresholds(at_time, current_bitrate_);
andresp@webrtc.org07bc7342014-03-21 16:51:01 +0000268}
269
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200270void SendSideBandwidthEstimation::UpdateDelayBasedEstimate(Timestamp at_time,
271 DataRate bitrate) {
272 delay_based_bitrate_ = bitrate;
273 CapBitrateToThresholds(at_time, current_bitrate_);
stefan32f81542016-01-20 07:13:58 -0800274}
275
Christoffer Rodbro3a837482018-11-19 15:30:23 +0100276void SendSideBandwidthEstimation::IncomingPacketFeedbackVector(
277 const TransportPacketsFeedback& report,
278 absl::optional<uint32_t> acked_bitrate_bps) {
279 if (!loss_based_bandwidth_estimation_.Enabled())
280 return;
281 if (acked_bitrate_bps) {
282 DataRate acked_bitrate = DataRate::bps(*acked_bitrate_bps);
283 loss_based_bandwidth_estimation_.UpdateAcknowledgedBitrate(
284 acked_bitrate, report.feedback_time);
285 }
286 loss_based_bandwidth_estimation_.UpdateLossStatistics(report.packet_feedbacks,
287 report.feedback_time);
288}
289
andresp@webrtc.org07bc7342014-03-21 16:51:01 +0000290void SendSideBandwidthEstimation::UpdateReceiverBlock(uint8_t fraction_loss,
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200291 TimeDelta rtt,
andresp@webrtc.org07bc7342014-03-21 16:51:01 +0000292 int number_of_packets,
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200293 Timestamp at_time) {
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100294 const int kRoundingConstant = 128;
295 int packets_lost = (static_cast<int>(fraction_loss) * number_of_packets +
296 kRoundingConstant) >>
297 8;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200298 UpdatePacketsLost(packets_lost, number_of_packets, at_time);
299 UpdateRtt(rtt, at_time);
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100300}
301
302void SendSideBandwidthEstimation::UpdatePacketsLost(int packets_lost,
303 int number_of_packets,
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200304 Timestamp at_time) {
305 last_loss_feedback_ = at_time;
306 if (first_report_time_.IsInfinite())
307 first_report_time_ = at_time;
stefan@webrtc.org83d48042014-11-10 13:55:16 +0000308
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000309 // Check sequence number diff and weight loss report
310 if (number_of_packets > 0) {
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000311 // Accumulate reports.
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100312 lost_packets_since_last_loss_update_ += packets_lost;
pbosb7edb882015-10-22 08:52:20 -0700313 expected_packets_since_last_loss_update_ += number_of_packets;
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000314
pbosb7edb882015-10-22 08:52:20 -0700315 // Don't generate a loss rate until it can be based on enough packets.
316 if (expected_packets_since_last_loss_update_ < kLimitNumPackets)
andresp@webrtc.org07bc7342014-03-21 16:51:01 +0000317 return;
pbosb7edb882015-10-22 08:52:20 -0700318
319 has_decreased_since_last_fraction_loss_ = false;
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100320 int64_t lost_q8 = lost_packets_since_last_loss_update_ << 8;
321 int64_t expected = expected_packets_since_last_loss_update_;
322 last_fraction_loss_ = std::min<int>(lost_q8 / expected, 255);
pbosb7edb882015-10-22 08:52:20 -0700323
324 // Reset accumulators.
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100325
326 lost_packets_since_last_loss_update_ = 0;
pbosb7edb882015-10-22 08:52:20 -0700327 expected_packets_since_last_loss_update_ = 0;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200328 last_loss_packet_report_ = at_time;
329 UpdateEstimate(at_time);
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000330 }
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200331 UpdateUmaStatsPacketsLost(at_time, packets_lost);
stefan@webrtc.orgdb262472014-11-04 19:32:10 +0000332}
333
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200334void SendSideBandwidthEstimation::UpdateUmaStatsPacketsLost(Timestamp at_time,
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100335 int packets_lost) {
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200336 DataRate bitrate_kbps = DataRate::kbps((current_bitrate_.bps() + 500) / 1000);
stefan@webrtc.org474e36e2015-01-19 15:44:47 +0000337 for (size_t i = 0; i < kNumUmaRampupMetrics; ++i) {
338 if (!rampup_uma_stats_updated_[i] &&
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200339 bitrate_kbps.kbps() >= kUmaRampupMetrics[i].bitrate_kbps) {
asapersson1d02d3e2016-09-09 22:40:25 -0700340 RTC_HISTOGRAMS_COUNTS_100000(i, kUmaRampupMetrics[i].metric_name,
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200341 (at_time - first_report_time_).ms());
stefan@webrtc.org474e36e2015-01-19 15:44:47 +0000342 rampup_uma_stats_updated_[i] = true;
343 }
344 }
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200345 if (IsInStartPhase(at_time)) {
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100346 initially_lost_packets_ += packets_lost;
stefan@webrtc.orgdb262472014-11-04 19:32:10 +0000347 } else if (uma_update_state_ == kNoUpdate) {
348 uma_update_state_ = kFirstDone;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200349 bitrate_at_2_seconds_ = bitrate_kbps;
asapersson1d02d3e2016-09-09 22:40:25 -0700350 RTC_HISTOGRAM_COUNTS("WebRTC.BWE.InitiallyLostPackets",
351 initially_lost_packets_, 0, 100, 50);
asapersson1d02d3e2016-09-09 22:40:25 -0700352 RTC_HISTOGRAM_COUNTS("WebRTC.BWE.InitialBandwidthEstimate",
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200353 bitrate_at_2_seconds_.kbps(), 0, 2000, 50);
stefan@webrtc.orgdb262472014-11-04 19:32:10 +0000354 } else if (uma_update_state_ == kFirstDone &&
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200355 at_time - first_report_time_ >= kBweConverganceTime) {
stefan@webrtc.orgdb262472014-11-04 19:32:10 +0000356 uma_update_state_ = kDone;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200357 int bitrate_diff_kbps = std::max(
358 bitrate_at_2_seconds_.kbps<int>() - bitrate_kbps.kbps<int>(), 0);
asapersson1d02d3e2016-09-09 22:40:25 -0700359 RTC_HISTOGRAM_COUNTS("WebRTC.BWE.InitialVsConvergedDiff", bitrate_diff_kbps,
360 0, 2000, 50);
stefan@webrtc.org548b2282014-11-03 14:42:43 +0000361 }
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000362}
363
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200364void SendSideBandwidthEstimation::UpdateRtt(TimeDelta rtt, Timestamp at_time) {
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100365 // Update RTT if we were able to compute an RTT based on this RTCP.
366 // FlexFEC doesn't send RTCP SR, which means we won't be able to compute RTT.
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200367 if (rtt > TimeDelta::Zero())
368 last_round_trip_time_ = rtt;
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100369
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200370 if (!IsInStartPhase(at_time) && uma_rtt_state_ == kNoUpdate) {
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100371 uma_rtt_state_ = kDone;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200372 RTC_HISTOGRAM_COUNTS("WebRTC.BWE.InitialRtt", rtt.ms<int>(), 0, 2000, 50);
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100373 }
374}
375
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200376void SendSideBandwidthEstimation::UpdateEstimate(Timestamp at_time) {
377 DataRate new_bitrate = current_bitrate_;
Sebastian Jansson24643482018-11-14 14:19:45 +0100378 if (rtt_backoff_.RttLowerBound(at_time) > rtt_backoff_.rtt_limit_) {
379 if (at_time - time_last_decrease_ >= rtt_backoff_.drop_interval_) {
Sebastian Jansson2e068e82018-10-08 12:49:53 +0200380 time_last_decrease_ = at_time;
Sebastian Jansson24643482018-11-14 14:19:45 +0100381 new_bitrate = current_bitrate_ * rtt_backoff_.drop_fraction_;
Sebastian Jansson2e068e82018-10-08 12:49:53 +0200382 }
383 CapBitrateToThresholds(at_time, new_bitrate);
384 return;
385 }
386
stefanfa156692016-01-21 08:55:03 -0800387 // We trust the REMB and/or delay-based estimate during the first 2 seconds if
388 // we haven't had any packet loss reported, to allow startup bitrate probing.
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200389 if (last_fraction_loss_ == 0 && IsInStartPhase(at_time)) {
philipel1b965312017-04-18 06:55:32 -0700390 new_bitrate = std::max(bwe_incoming_, new_bitrate);
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200391 new_bitrate = std::max(delay_based_bitrate_, new_bitrate);
Christoffer Rodbro3a837482018-11-19 15:30:23 +0100392 if (loss_based_bandwidth_estimation_.Enabled()) {
393 loss_based_bandwidth_estimation_.SetInitialBitrate(new_bitrate);
394 }
philipel1b965312017-04-18 06:55:32 -0700395
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200396 if (new_bitrate != current_bitrate_) {
stefanfa156692016-01-21 08:55:03 -0800397 min_bitrate_history_.clear();
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200398 min_bitrate_history_.push_back(std::make_pair(at_time, current_bitrate_));
399 CapBitrateToThresholds(at_time, new_bitrate);
stefanfa156692016-01-21 08:55:03 -0800400 return;
401 }
stefan@webrtc.org82462aa2014-10-23 11:57:05 +0000402 }
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200403 UpdateMinHistory(at_time);
404 if (last_loss_packet_report_.IsInfinite()) {
Stefan Holmer52200d02016-09-20 14:14:23 +0200405 // No feedback received.
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200406 CapBitrateToThresholds(at_time, current_bitrate_);
Stefan Holmer52200d02016-09-20 14:14:23 +0200407 return;
408 }
Christoffer Rodbro3a837482018-11-19 15:30:23 +0100409
410 if (loss_based_bandwidth_estimation_.Enabled()) {
411 loss_based_bandwidth_estimation_.Update(
412 at_time, min_bitrate_history_.front().second, last_round_trip_time_);
413 new_bitrate = MaybeRampupOrBackoff(new_bitrate, at_time);
414 CapBitrateToThresholds(at_time, new_bitrate);
415 return;
416 }
417
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200418 TimeDelta time_since_loss_packet_report = at_time - last_loss_packet_report_;
419 TimeDelta time_since_loss_feedback = at_time - last_loss_feedback_;
420 if (time_since_loss_packet_report < 1.2 * kMaxRtcpFeedbackInterval) {
Stefan Holmer9c79ed92017-03-31 15:53:27 +0200421 // We only care about loss above a given bitrate threshold.
422 float loss = last_fraction_loss_ / 256.0f;
423 // We only make decisions based on loss when the bitrate is above a
424 // threshold. This is a crude way of handling loss which is uncorrelated
425 // to congestion.
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200426 if (current_bitrate_ < bitrate_threshold_ || loss <= low_loss_threshold_) {
andresp@webrtc.org44caf012014-03-26 21:00:21 +0000427 // Loss < 2%: Increase rate by 8% of the min bitrate in the last
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200428 // kBweIncreaseInterval.
andresp@webrtc.org44caf012014-03-26 21:00:21 +0000429 // Note that by remembering the bitrate over the last second one can
430 // rampup up one second faster than if only allowed to start ramping
431 // at 8% per second rate now. E.g.:
Christoffer Rodbro3a837482018-11-19 15:30:23 +0100432 // If sending a constant 100kbps it can rampup immediately to 108kbps
andresp@webrtc.org44caf012014-03-26 21:00:21 +0000433 // whenever a receiver report is received with lower packet loss.
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200434 // If instead one would do: current_bitrate_ *= 1.08^(delta time),
philipel1b965312017-04-18 06:55:32 -0700435 // it would take over one second since the lower packet loss to achieve
Stefan Holmer52200d02016-09-20 14:14:23 +0200436 // 108kbps.
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200437 new_bitrate =
438 DataRate::bps(min_bitrate_history_.front().second.bps() * 1.08 + 0.5);
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000439
andresp@webrtc.org07bc7342014-03-21 16:51:01 +0000440 // Add 1 kbps extra, just to make sure that we do not get stuck
441 // (gives a little extra increase at low rates, negligible at higher
442 // rates).
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200443 new_bitrate += DataRate::bps(1000);
444 } else if (current_bitrate_ > bitrate_threshold_) {
Stefan Holmer9c79ed92017-03-31 15:53:27 +0200445 if (loss <= high_loss_threshold_) {
446 // Loss between 2% - 10%: Do nothing.
447 } else {
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200448 // Loss > 10%: Limit the rate decreases to once a kBweDecreaseInterval
Stefan Holmer9c79ed92017-03-31 15:53:27 +0200449 // + rtt.
450 if (!has_decreased_since_last_fraction_loss_ &&
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200451 (at_time - time_last_decrease_) >=
452 (kBweDecreaseInterval + last_round_trip_time_)) {
453 time_last_decrease_ = at_time;
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000454
Stefan Holmer9c79ed92017-03-31 15:53:27 +0200455 // Reduce rate:
456 // newRate = rate * (1 - 0.5*lossRate);
457 // where packetLoss = 256*lossRate;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200458 new_bitrate =
459 DataRate::bps((current_bitrate_.bps() *
460 static_cast<double>(512 - last_fraction_loss_)) /
461 512.0);
Stefan Holmer9c79ed92017-03-31 15:53:27 +0200462 has_decreased_since_last_fraction_loss_ = true;
463 }
andresp@webrtc.org44caf012014-03-26 21:00:21 +0000464 }
andresp@webrtc.org07bc7342014-03-21 16:51:01 +0000465 }
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200466 } else if (time_since_loss_feedback >
467 kFeedbackTimeoutIntervals * kMaxRtcpFeedbackInterval &&
468 (last_timeout_.IsInfinite() ||
469 at_time - last_timeout_ > kTimeoutInterval)) {
Stefan Holmer52200d02016-09-20 14:14:23 +0200470 if (in_timeout_experiment_) {
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200471 RTC_LOG(LS_WARNING) << "Feedback timed out ("
472 << ToString(time_since_loss_feedback)
473 << "), reducing bitrate.";
474 new_bitrate = new_bitrate * 0.8;
Stefan Holmer52200d02016-09-20 14:14:23 +0200475 // Reset accumulators since we've already acted on missing feedback and
476 // shouldn't to act again on these old lost packets.
Sebastian Jansson439f0bc2018-02-20 10:46:39 +0100477 lost_packets_since_last_loss_update_ = 0;
Stefan Holmer52200d02016-09-20 14:14:23 +0200478 expected_packets_since_last_loss_update_ = 0;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200479 last_timeout_ = at_time;
Stefan Holmer52200d02016-09-20 14:14:23 +0200480 }
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000481 }
philipel1b965312017-04-18 06:55:32 -0700482
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200483 CapBitrateToThresholds(at_time, new_bitrate);
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000484}
andresp@webrtc.org4e69f782014-03-17 17:07:48 +0000485
Sebastian Jansson2e068e82018-10-08 12:49:53 +0200486void SendSideBandwidthEstimation::UpdatePropagationRtt(
487 Timestamp at_time,
488 TimeDelta propagation_rtt) {
Sebastian Jansson24643482018-11-14 14:19:45 +0100489 rtt_backoff_.UpdatePropagationRtt(at_time, propagation_rtt);
Sebastian Jansson2e068e82018-10-08 12:49:53 +0200490}
491
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200492bool SendSideBandwidthEstimation::IsInStartPhase(Timestamp at_time) const {
493 return first_report_time_.IsInfinite() ||
494 at_time - first_report_time_ < kStartPhase;
stefan@webrtc.org548b2282014-11-03 14:42:43 +0000495}
496
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200497void SendSideBandwidthEstimation::UpdateMinHistory(Timestamp at_time) {
andresp@webrtc.org44caf012014-03-26 21:00:21 +0000498 // Remove old data points from history.
499 // Since history precision is in ms, add one so it is able to increase
500 // bitrate if it is off by as little as 0.5ms.
501 while (!min_bitrate_history_.empty() &&
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200502 at_time - min_bitrate_history_.front().first + TimeDelta::ms(1) >
503 kBweIncreaseInterval) {
andresp@webrtc.org44caf012014-03-26 21:00:21 +0000504 min_bitrate_history_.pop_front();
505 }
506
507 // Typical minimum sliding-window algorithm: Pop values higher than current
508 // bitrate before pushing it.
509 while (!min_bitrate_history_.empty() &&
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200510 current_bitrate_ <= min_bitrate_history_.back().second) {
andresp@webrtc.org44caf012014-03-26 21:00:21 +0000511 min_bitrate_history_.pop_back();
512 }
513
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200514 min_bitrate_history_.push_back(std::make_pair(at_time, current_bitrate_));
andresp@webrtc.org44caf012014-03-26 21:00:21 +0000515}
516
Christoffer Rodbro3a837482018-11-19 15:30:23 +0100517DataRate SendSideBandwidthEstimation::MaybeRampupOrBackoff(DataRate new_bitrate,
518 Timestamp at_time) {
519 // TODO(crodbro): reuse this code in UpdateEstimate instead of current
520 // inlining of very similar functionality.
521 const TimeDelta time_since_loss_packet_report =
522 at_time - last_loss_packet_report_;
523 const TimeDelta time_since_loss_feedback = at_time - last_loss_feedback_;
524 if (time_since_loss_packet_report < 1.2 * kMaxRtcpFeedbackInterval) {
525 new_bitrate = min_bitrate_history_.front().second * 1.08;
526 new_bitrate += DataRate::bps(1000);
527 } else if (time_since_loss_feedback >
528 kFeedbackTimeoutIntervals * kMaxRtcpFeedbackInterval &&
529 (last_timeout_.IsInfinite() ||
530 at_time - last_timeout_ > kTimeoutInterval)) {
531 if (in_timeout_experiment_) {
532 RTC_LOG(LS_WARNING) << "Feedback timed out ("
533 << ToString(time_since_loss_feedback)
534 << "), reducing bitrate.";
535 new_bitrate = new_bitrate * 0.8;
536 // Reset accumulators since we've already acted on missing feedback and
537 // shouldn't to act again on these old lost packets.
538 lost_packets_since_last_loss_update_ = 0;
539 expected_packets_since_last_loss_update_ = 0;
540 last_timeout_ = at_time;
541 }
542 }
543 return new_bitrate;
544}
545
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200546void SendSideBandwidthEstimation::CapBitrateToThresholds(Timestamp at_time,
547 DataRate bitrate) {
548 if (bwe_incoming_ > DataRate::Zero() && bitrate > bwe_incoming_) {
549 bitrate = bwe_incoming_;
andresp@webrtc.org4e69f782014-03-17 17:07:48 +0000550 }
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200551 if (delay_based_bitrate_ > DataRate::Zero() &&
552 bitrate > delay_based_bitrate_) {
553 bitrate = delay_based_bitrate_;
stefan32f81542016-01-20 07:13:58 -0800554 }
Christoffer Rodbro3a837482018-11-19 15:30:23 +0100555 if (loss_based_bandwidth_estimation_.Enabled() &&
556 loss_based_bandwidth_estimation_.GetEstimate() > DataRate::Zero()) {
557 bitrate = std::min(bitrate, loss_based_bandwidth_estimation_.GetEstimate());
558 }
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200559 if (bitrate > max_bitrate_configured_) {
560 bitrate = max_bitrate_configured_;
andresp@webrtc.org4e69f782014-03-17 17:07:48 +0000561 }
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200562 if (bitrate < min_bitrate_configured_) {
563 if (last_low_bitrate_log_.IsInfinite() ||
564 at_time - last_low_bitrate_log_ > kLowBitrateLogPeriod) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100565 RTC_LOG(LS_WARNING) << "Estimated available bandwidth "
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200566 << ToString(bitrate)
567 << " is below configured min bitrate "
568 << ToString(min_bitrate_configured_) << ".";
569 last_low_bitrate_log_ = at_time;
stefanb6b0b922015-09-04 03:04:56 -0700570 }
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200571 bitrate = min_bitrate_configured_;
andresp@webrtc.org4e69f782014-03-17 17:07:48 +0000572 }
philipel1b965312017-04-18 06:55:32 -0700573
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200574 if (bitrate != current_bitrate_ ||
philipel1b965312017-04-18 06:55:32 -0700575 last_fraction_loss_ != last_logged_fraction_loss_ ||
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200576 at_time - last_rtc_event_log_ > kRtcEventLogPeriod) {
Karl Wiberg918f50c2018-07-05 11:40:33 +0200577 event_log_->Log(absl::make_unique<RtcEventBweUpdateLossBased>(
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200578 bitrate.bps(), last_fraction_loss_,
Elad Alon4a87e1c2017-10-03 16:11:34 +0200579 expected_packets_since_last_loss_update_));
philipel1b965312017-04-18 06:55:32 -0700580 last_logged_fraction_loss_ = last_fraction_loss_;
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200581 last_rtc_event_log_ = at_time;
philipel1b965312017-04-18 06:55:32 -0700582 }
Sebastian Jansson7c1744d2018-10-08 11:00:50 +0200583 current_bitrate_ = bitrate;
andresp@webrtc.org4e69f782014-03-17 17:07:48 +0000584}
pwestin@webrtc.org1cd11622012-04-19 12:13:52 +0000585} // namespace webrtc