Skip to content
This repository has been archived by the owner on May 13, 2024. It is now read-only.

Add RTP header extension transport-wide-cc-02 #219

Merged
merged 1 commit into from
Mar 8, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions experiments/rtp-hdrext/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,6 @@ Underneath this page, RTP header extensions are listed.
* [abs-send-time](abs-send-time)
* [color-space](color-space)
* [playout-delay](playout-delay)
* [transport-wide-cc-02](transport-wide-cc-02)
* [video-content-type](video-content-type)
* [video-timing](video-timing)
66 changes: 66 additions & 0 deletions experiments/rtp-hdrext/transport-wide-cc-02/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
layout: default
title: transport-wide-cc-02
permalink: /experiments/rtp-hdrext/transport-wide-cc-02/
---

This RTP header extension is an extended version of the extension defined in
<https://tools.ietf.org/html/draft-holmer-rmcat-transport-wide-cc-extensions-01>
Copy link
Contributor

@alvestrand alvestrand Mar 4, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are you going to submit version -02 of the internet-draft also? I'd recommend doing that before starting to use (or document) the extension.
Submitting I-Ds is free (as long as you can get the format right).

(on second read - no real reason to keep the -02 in sync with the draft number apart from the appearance of tidiness. This isn't a full draft name anyway.)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are no plans to submit a new internet-draft at the moment. The ambition is to have a valid URI for Chromium M74 that branches on March 7.


**Name:** "Transport-wide congenstion control 02"

**Formal name:**
<http://www.webrtc.org/experiments/rtp-hdrext/transport-wide-cc-02>

**Status:** This extension is defined here to allow for experimentation. Once
experience has shown that it is useful, we intend to make a proposal based on
it for standardization in the IETF.

The original extension defines a transport-wide sequence number that is used in
feedback packets for congestion control. The original implementation sends these
feedback packets at a periodic interval. The extended version presented here has
two changes compared to the original version:
* Feedback is sent only on request by the sender, therefore, the extension has
two optional bytes that signals that a feedback packet is requested.
* The sender determines if timing information should be included or not in the
feedback packet. The original version always include timing information.

Contact <[email protected]> or <[email protected]> for more info.

## RTP header extension format

### Data layout overview
Data layout of transport-wide sequence number
1-byte header + 2 bytes of data:

0              1 2 
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| ID   | L=1 |transport-wide sequence number |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Data layout of transport-wide sequence number and optional feedback request
1-byte header + 4 bytes of data:

0              1 2                   3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| ID   | L=3 |transport-wide sequence number |T|  seq count |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|seq count cont.|
+-+-+-+-+-+-+-+-+

### Data layout details
The data is written in the following order,
* transport-wide sequence number (16-bit unsigned integer)
* feedback request (optional) (16-bit unsigned integer)<br>
If the extension contains two extra bytes for feedback request, this means
that a feedback packet should be generated and sent immediately. The feedback
request consists of a one-bit field giving the flag value T and a 15-bit
field giving the sequence count as an unsigned number.
- If the bit T is set the feedback packet must contain timing information.
- seq count specifies how many packets of history that should be included in
the feedback packet. If seq count is zero no feedback should be be
generated, which is equivalent of sending the two-byte extension above.
This is added as an option to allow for a fixed packet header size.