<?xml version='1.0' encoding='utf-8'?>
<?xml-model href="rfc7991bis.rnc"?>
<!DOCTYPE rfc SYSTEM "rfc2629-xhtml.ent">
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" category="std" docName="draft-ietf-manet-dlep-radio-quality-04" ipr="trust200902" obsoletes="" updates="" submissionType="IETF" xml:lang="en" tocInclude="true" tocDepth="4" symRefs="true" sortRefs="true" version="3" consensus="true">
  <front>
    <title abbrev="DLEP PHY quality">DLEP Radio Quality Extension</title>
    <seriesInfo name="Internet-Draft" value="draft-ietf-manet-dlep-radio-quality-04"/>
    <author fullname="Henning Rogge" initials="H.R." surname="Rogge">
      <organization>Fraunhofer FKIE</organization>
      <address>
        <postal>
          <street>Fraunhofer Strasse 20</street>
          <city>Wachtberg</city>
          <region/>
          <code>53343</code>
          <country>DE</country>
        </postal>
        <email>henning.rogge@fkie.fraunhofer.de</email>
      </address>
    </author>
    <date year="2026"/>
    <area>Routing</area>
    <workgroup>Manet</workgroup>
    <keyword>DLEP</keyword>
    <keyword>PHY</keyword>
    <keyword>TLV</keyword>
    <abstract>
      <t>This document defines an extension to the Dynamic Link Exchange Protocol (DLEP) to provide the quality of incoming radio signals.</t>
    </abstract>
  </front>
  <middle>
    <section numbered="true" toc="default">
      <name>Introduction</name>
      <t>The dynamic Link Exchange Protocol (DLEP) is defined in
        <xref target="RFC8175" format="default"/>.
        It provides the exchange of link-related control information
        between DLEP peers. DLEP peers are comprised of a modem and
        a router.  DLEP defines a base set of mechanisms as well as
        support for possible extensions. This document defines one such
        extension.</t>
      <section numbered="true" toc="default">
        <name>Requirements Language</name>
        <t>In many IETF documents, several words, when they are in all capitals
          as shown below, are used to signify the requirements in the
          specification.  These capitalized words can bring significant clarity
          and consistency to documents because their meanings are well defined.
          This document defines how those words are interpreted in IETF
          documents when the words are in all capitals.</t>
        <ul>
          <li>These words can be used as defined here, but using them is not
            required.  Specifically, normative text does not require the use
            of these key words.  They are used for clarity and consistency
            when that is what's wanted, but a lot of normative text does not
            use them and is still normative.</li>
          <li>The words have the meanings specified herein only when they are in
            all capitals.</li>
          <li>When these words are not capitalized, they have their normal
            English meanings and are not affected by this document.</li>
        </ul>
        <t>Authors who follow these guidelines should incorporate this phrase
          near the beginning of their document:</t>
        <ul empty="true">
          <li>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
            NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED",
            "MAY", and "OPTIONAL" in this document are to be interpreted as
            described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
            appear in all capitals, as shown here.</li>
        </ul>
      </section>
    </section>
    <section numbered="true" toc="default">
      <name>Extension Usage and Identification</name>
      <t>The use of the Radio Quality Extension SHOULD be
        configurable. To indicate that the Radio Quality Extension
        is to be used, an implementation MUST include the Radio Quality
        Extension Type Value in the Extensions Supported Data Item. The Extensions Supported Data Item is sent and processed according to
        <xref target="RFC8175" format="default"/>.</t>
      <t>The Radio Quality Extension Type Value is TBD; see <xref target="iana-exttype"/>.</t>
    </section>
    <section numbered="true" toc="default">
      <name>Radio Quality Data Items</name>
      <t>This section describes the quality related Data Items of this extension.</t>
      <t>All Data Items available in this extension provide access to the radios physical layer measurements related to signal quality. Because of different designs of Radio PHY layers,
        this quality can be expressed in different ways, by referring to signal-to-noise ratio or by measuring the biterror rate (e.g. by using a forward error correction).
        Both of these possible informations are very valuable for calculating MANET metrics for radio networks with moving nodes and low datarates, e.g. VHF radio networks. Estimating channel quality
        based on packet loss can be impractical, because the estimated value changes too fast (because of movement) compared to the number of received frames. Biterror rate (and Signal Strength)
        can provice the additional information necessary to build a reasonable stable and agile metric. Biterror rate (before error correction) is a more generic way to represent this value, because
        it is a radio independent measurement.</t>
      <t>The Biterror Rate data item is mandatory when using the Radio Quality extension. All other TLVs presented in this document are optional.</t>
      <section numbered="true" toc="default">
        <name>Radio Biterror Rate Data Item</name>
        <t>Radio Biterror Rate Data Item is a mandatory TLV that contains information about the radio receivers estimate how often a transmitted bit will be received wrong. This value can often be either directly measured
          by the radio by comparing the result of a forward-error-correction to the original received data or calculated from the received signal-to-noise ratio and knowledge about the current
          modulation coding scheme. This Data Item can be both interface and neighbor specific.</t>
        <t>The format of the Radio Biterror Rate Data Item is:</t>
        <figure anchor="radio_biterror">
          <artwork align="left" name="" type="" alt=""><![CDATA[
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Data Item Type                | Length                        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|    Biterror   |
+-+-+-+-+-+-+-+-+
          ]]></artwork>
        </figure>
        <dl>
          <dt>Data Item Type:</dt>
          <dd>TBD</dd>
          <dt>Length:</dt>
          <dd>1</dd>
          <dt>Biterror:</dt>
          <dd>Biterror rate measured as a negative exponent multiplied by 10 (to base 10),
            e.g. "40" for an error rate of 1 to 10^-4. An error rate of 0 is encoded with a 255.</dd>
        </dl>
      </section>
      <section numbered="true" toc="default">
        <name>Radio SNR Data Item</name>
        <t>Radio SNR Data Item contains information which signal to noise ratio the
          radio measured. This Data Item can be both interface and neighbor specific.</t>
        <t>The format of the Radio SNR Data Item is:</t>
        <figure anchor="radio_snr">
          <artwork align="left" name="" type="" alt=""><![CDATA[
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Data Item Type                | Length                        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              SNR              |     Flags     |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
          ]]></artwork>
        </figure>
        <dl>
          <dt>Data Item Type:</dt>
          <dd>TBD</dd>
          <dt>Length:</dt>
          <dd>3</dd>
          <dt>SNR:</dt>
          <dd>SNR measured in dB multiplied by 10 as a signed integer.</dd>
          <dt>Flags:</dt>
          <dd>Flags field as defined below.</dd>
        </dl>
        <t>The Flags field is defined as:</t>
        <figure anchor="radio_quality_flags">
          <artwork align="left" name="" type="" alt=""><![CDATA[
0 1 2 3 4 5 6 7
+-+-+-+-+-+-+-+-+
|   Reserved  |I|
+-+-+-+-+-+-+-+-+
          ]]></artwork>
        </figure>
        <dl>
          <dt>I:</dt>
          <dd>Interference Flag, indicating the the data includes interference into the noise value (SINR).</dd>
          <dt>Reserved:</dt>
          <dd>MUST be written as zero. Ignored on receipt and left for future assignment.</dd>
        </dl>
      </section>
      <section numbered="true" toc="default">
        <name>Radio Signal Strength Data Item (also called RSSI)</name>
        <t>Radio Signal Strength Data Item contains information which absolute signal strength the radio measured. This Data Item can be both interface and neighbor specific.</t>
        <t>This Data Item could also be used together with the Request Link Characteristics message to reconfigure the outgoing signal strength, either to reduce the size of
          the collision domain or to increase the range of the radio.</t>
        <t>The format of the Radio Signal Strength Data Item is:</t>
        <figure anchor="radio_signal">
          <artwork align="left" name="" type="" alt=""><![CDATA[
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Data Item Type                | Length                        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|            Signal             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
          ]]></artwork>
        </figure>
        <dl>
          <dt>Data Item Type:</dt>
          <dd>TBD</dd>
          <dt>Length:</dt>
          <dd>2</dd>
          <dt>Signal:</dt>
          <dd>Signal Strength measured in dBm multiplied by 10 as a signed integer.</dd>
        </dl>
      </section>
      <section numbered="true" toc="default">
        <name>Radio Noise Data Item</name>
        <t>Radio Noise Data Item contains information which absolute noise value the radio measured. This Data Item SHOULD be interface specific.</t>
        <t>The format of the Radio Noise Data Item is:</t>
        <figure anchor="radio_noise">
          <artwork align="left" name="" type="" alt=""><![CDATA[
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Data Item Type                | Length                        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|             Noise             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
          ]]></artwork>
        </figure>
        <dl>
          <dt>Data Item Type:</dt>
          <dd>TBD</dd>
          <dt>Length:</dt>
          <dd>2</dd>
          <dt>Noise:</dt>
          <dd>Noise measured in dBm multiplied by 10 as a signed integer.</dd>
        </dl>
      </section>
    </section>
    <section numbered="true" toc="default">
      <name>Security Considerations</name>
      <t>The extension introduces a new Data Item for DLEP.
        The extension does not inherently introduce any additional
        vulnerabilities above those documented in
        <xref target="RFC8175" format="default"/>.
        The approach taken to security in that document applies
        equally when running the extension defined in this document.</t>
    </section>
    <section numbered="true" toc="default">
      <name>IANA Considerations</name>
      <t>As described below, IANA has assigned two values per this document.
        Both assignments are to registries defined by
        <xref target="RFC8175" format="default"/>.</t>
      <section numbered="true" toc="default" anchor="iana-exttype">
        <name>Extension Type Value</name>
        <t>IANA has assigned the following value in the "Extension Type Values"
          registry within the "Dynamic Link Exchange Protocol (DLEP)
          Parameters" registry.  The new value is in the range with the
          "Specification Required" <xref target="RFC8126" format="default"/> policy:</t>
        <table>
          <name>New Extension Type Value</name>
          <thead>
            <tr>
              <td>Code</td>
              <td>Description</td>
              <td>Reference</td>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td>TBD</td>
              <td>Radio Quality</td>
              <td>This document</td>
            </tr>
          </tbody>
        </table>
      </section>
      <section numbered="true" toc="default">
        <name>Data Item Value</name>
        <t>IANA has assigned the following value in the "Data Item Type
          Values" registry within the "Dynamic Link Exchange Protocol
          (DLEP) Parameters" registry.  The new value is in the range
          with the "Specification Required"
          <xref target="RFC8126" format="default"/>
          policy:</t>
        <table>
          <name>New Data Item Value</name>
          <thead>
            <tr>
              <td>Type Code</td>
              <td>Description</td>
              <td>Reference</td>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td>TBD</td>
              <td>Radio Biterror Rate</td>
              <td>This document</td>
            </tr>
            <tr>
              <td>TBD</td>
              <td>Radio SNR</td>
              <td>This document</td>
            </tr>
            <tr>
              <td>TBD</td>
              <td>Radio Signal</td>
              <td>This document</td>
            </tr>
            <tr>
              <td>TBD</td>
              <td>Radio Noise</td>
              <td>This document</td>
            </tr>
          </tbody>
        </table>
      </section>
    </section>
  </middle>
  <back>
    <references>
      <name>Normative References</name>
      <reference anchor="RFC2119" target="https://www.rfc-editor.org/info/rfc2119" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml">
        <front>
          <title>Key words for use in RFCs to Indicate Requirement Levels</title>
          <author fullname="S. Bradner" initials="S." surname="Bradner"/>
          <date month="March" year="1997"/>
          <abstract>
            <t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
          </abstract>
        </front>
        <seriesInfo name="BCP" value="14"/>
        <seriesInfo name="RFC" value="2119"/>
        <seriesInfo name="DOI" value="10.17487/RFC2119"/>
      </reference>
      <reference anchor="RFC8174" target="https://www.rfc-editor.org/info/rfc8174" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml">
        <front>
          <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
          <author fullname="B. Leiba" initials="B." surname="Leiba"/>
          <date month="May" year="2017"/>
          <abstract>
            <t>RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.</t>
          </abstract>
        </front>
        <seriesInfo name="BCP" value="14"/>
        <seriesInfo name="RFC" value="8174"/>
        <seriesInfo name="DOI" value="10.17487/RFC8174"/>
      </reference>
      <reference anchor="RFC8175" target="https://www.rfc-editor.org/info/rfc8175" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8175.xml">
        <front>
          <title>Dynamic Link Exchange Protocol (DLEP)</title>
          <author fullname="S. Ratliff" initials="S." surname="Ratliff"/>
          <author fullname="S. Jury" initials="S." surname="Jury"/>
          <author fullname="D. Satterwhite" initials="D." surname="Satterwhite"/>
          <author fullname="R. Taylor" initials="R." surname="Taylor"/>
          <author fullname="B. Berry" initials="B." surname="Berry"/>
          <date month="June" year="2017"/>
          <abstract>
            <t>When routing devices rely on modems to effect communications over wireless links, they need timely and accurate knowledge of the characteristics of the link (speed, state, etc.) in order to make routing decisions. In mobile or other environments where these characteristics change frequently, manual configurations or the inference of state through routing or transport protocols does not allow the router to make the best decisions. This document introduces a new protocol called the Dynamic Link Exchange Protocol (DLEP), which provides a bidirectional, event-driven communication channel between the router and the modem to facilitate communication of changing link characteristics.</t>
          </abstract>
        </front>
        <seriesInfo name="RFC" value="8175"/>
        <seriesInfo name="DOI" value="10.17487/RFC8175"/>
      </reference>
    </references>
    <references>
      <name>Informative References</name>
      <reference anchor="RFC8126" target="https://www.rfc-editor.org/info/rfc8126" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8126.xml">
        <front>
          <title>Guidelines for Writing an IANA Considerations Section in RFCs</title>
          <author fullname="M. Cotton" initials="M." surname="Cotton"/>
          <author fullname="B. Leiba" initials="B." surname="Leiba"/>
          <author fullname="T. Narten" initials="T." surname="Narten"/>
          <date month="June" year="2017"/>
          <abstract>
            <t>Many protocols make use of points of extensibility that use constants to identify various protocol parameters. To ensure that the values in these fields do not have conflicting uses and to promote interoperability, their allocations are often coordinated by a central record keeper. For IETF protocols, that role is filled by the Internet Assigned Numbers Authority (IANA).</t>
            <t>To make assignments in a given registry prudently, guidance describing the conditions under which new values should be assigned, as well as when and how modifications to existing values can be made, is needed. This document defines a framework for the documentation of these guidelines by specification authors, in order to assure that the provided guidance for the IANA Considerations is clear and addresses the various issues that are likely in the operation of a registry.</t>
            <t>This is the third edition of this document; it obsoletes RFC 5226.</t>
          </abstract>
        </front>
        <seriesInfo name="BCP" value="26"/>
        <seriesInfo name="RFC" value="8126"/>
        <seriesInfo name="DOI" value="10.17487/RFC8126"/>
      </reference>
    </references>
  </back>
</rfc>
