<?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-band-04" ipr="trust200902" obsoletes="" updates="" submissionType="IETF" xml:lang="en" tocInclude="true" tocDepth="4" symRefs="true" sortRefs="true" version="3" consensus="true">
  <front>
    <title>DLEP Radio Band Extension</title>
    <seriesInfo name="Internet-Draft" value="draft-ietf-manet-dlep-radio-band-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 information about frequency bands used by the radio.</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 consist 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 to provide information about the frequency
        bands used by the radio.</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 Band Extension SHOULD be
        configurable. To indicate that the Radio Band Extension
        is to be used, an implementation MUST include the Radio Band
        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 Band Extension Type Value is described in <xref target="extensiontypes" format="default"/>.</t>
    </section>
    <section numbered="true" toc="default">
      <name>Radio Band Data Item</name>
      <t>Radio Band Data Item contains information which radio frequency resources
        are being used. These values are usually interface specific and static during the DLEP session.</t>
      <t>The Radio Band Data Item can be used multiple times to represent multiple radio bands.</t>
      <t>The Item can be used in a neighbor specific message if the radio uses dedicated subcarriers to talk to neighbors.</t>
      <t>Frequency selection is often controlled by the radio configuration. By giving the radio a standardized way to transmit its
         selected frequency configuration the router can aggregate multiple radios settings into a common information page, can do
         some basic checking for configuration mistakes by comparing known radio group configuration with their frequency by radio
         (if the routers have a second communication channel) or forward the data to an upper layer for visualization.</t>
      <t>The information in this Item gives the router an easy way to calculate the spectral efficiency of a radio link,
         how much bandwidth is used for the current data-rate reported by DLEP. This can be integrated into the routing metric
         to focus traffic on links that use the spectrum efficiently.</t>
      <t>The Item can also be used as an interface to a cognitive radio controller on the router, analyzing the correlation of
         transmission disruptions with the frequency bands and could (together with the Request Link Characteristics message) be
         used to change the frequency of the radio in a standardized way.</t>
      <t>Both values in the TLV (Carrier Frequency and Bandwidth) are 64 bit unsigned integers.</t>
      <t>The format of the Radio Band Data Item is:</t>
      <figure anchor="radio_band">
        <name>Radio Band Data Item Format</name>
        <artwork align="left"><![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                        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
+                       Carrier Frequency                       +
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
+                           Bandwidth                           +
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|     Flags     |
+-+-+-+-+-+-+-+-+
        ]]></artwork>
      </figure>
      <dl>
        <dt>Data Item Type:</dt>
        <dd>TBD1</dd>
        <dt>Length:</dt>
        <dd>17</dd>
        <dt>Center Frequency:</dt>
        <dd>The center frequency of the band in Hz.</dd>
        <dt>Bandwidth:</dt>
        <dd>The bandwidth of the band in Hz.</dd>
        <dt>Flags:</dt>
        <dd>Flags field as defined below.</dd>
      </dl>
      <t>The Flags field is defined as:</t>
      <figure anchor="radio_band_flags">
        <name>Radio Band Data Item Flags</name>
        <artwork align="left" name="" type="" alt=""><![CDATA[
0 1 2 3 4 5 6 7
+-+-+-+-+-+-+-+-+
| Reserved  |U|D|
+-+-+-+-+-+-+-+-+
        ]]></artwork>
      </figure>
      <dl>
        <dt>U:</dt>
        <dd>Uplink Flag, indicating the band is used for transmitting data.</dd>
        <dt>D:</dt>
        <dd>Downlink Flag, indicating the band is used for receiving data.</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>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="extensiontypes">
        <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>TBD2</td>
              <td>Radio Band</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>TBD1</td>
              <td>Radio Band</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>
