<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
        targetNamespace="http://www.cablelabs.com/namespaces/DOCSIS/3.0/xsd/ipdr/DOCSIS-SPECTRUM"
        xmlns:DOCSIS-SPECTRUM="http://www.cablelabs.com/namespaces/DOCSIS/3.0/xsd/ipdr/DOCSIS-SPECTRUM"
        xmlns:ipdr="http://mibs.cablelabs.com/namespaces/DOCSIS/tmforum/xsd/ipdr/"
        elementFormDefault="qualified"
        attributeFormDefault="unqualified"
        version="3.7-A.2.0.0">
  <import namespace="http://mibs.cablelabs.com/namespaces/DOCSIS/tmforum/xsd/ipdr/" schemaLocation="http://mibs.cablelabs.com/namespaces/DOCSIS/tmforum/xsd/ipdr/IPDRDoc3.5.1.xsd"/>
  <include schemaLocation="http://mibs.cablelabs.com/namespaces/DOCSIS/tmforum/xsd/ipdr/IPDRTypes.xsd"/>
  <annotation>
    <documentation>
      DOCSIS-SPECTRUM is an auxiliary schema which defines Spectrum
      Analysis and Measurement information. OSSIv3.0-N-10.0968-2 and
      published as I14.

      Revision History:
      3.5.1-A.1   Initial version.
      3.5.1-A.2   Revised version includes ECN
      3.7-A.2.0.0 Add semantic versioning. Remove ipdr.org references. Fix import versions.
                  Fix spacing. Add contact info.
                  Error corrections announced via errata sheet attached to CM-SP-OSSIv3.0-C01-171207.

      Contact:
        Postal: Cable Television Laboratories, Inc.
        858 Coal Creek Circle
        Louisville, Colorado 80027-9750
        U.S.A.
        Phone: +1 303-661-9100
        Fax: +1 303-661-9199
        Email: data-model-support@cablelabs.com

      Copyright 2019-2026 Cable Television Laboratories, Inc.
        All rights reserved.
    </documentation>
    <documentation>
      <ipdr:reference>
        DOCSIS 3.0 Operations Support System Interface Specification
        CM-SP-OSSIv3.0-C01-171207.
      </ipdr:reference>
    </documentation>
  </annotation>
  <element name="SpectrumAnalysisMeasIfIndex" type="unsignedInt">
    <annotation>
      <documentation>
        Contains the ifIndex of the CMTS logical upstream channel.
      </documentation>
    </annotation>
  </element>
  <element name="ChId" type="unsignedByte">
    <annotation>
      <documentation>
        The US/DS channel id as defined in docsIf3MdChCfgChId.
      </documentation>
    </annotation>
  </element>
  <element name="SpectrumAnalysisMeasChCenterFreq" type="integer">
    <annotation>
      <documentation>
        Contains the center of the frequency band associated with the
        CMTS physical upstream interface. It contains zero if the frequency
        is undefined or unknown.
      </documentation>
      <documentation>
        <ipdr:units>hertz</ipdr:units>
      </documentation>
    </annotation>
  </element>
  <element name="SpectrumAnalysisMeasFreqSpan" type="unsignedInt">
    <annotation>
      <documentation>
        Contains the width of the band across which the spectral
        amplitudes characterizing the channel are measured.
      </documentation>
      <documentation>
        <ipdr:units>hertz</ipdr:units>
      </documentation>
    </annotation>
  </element>
  <element name="SpectrumAnalysisMeasNumOfBins" type="unsignedInt">
    <annotation>
      <documentation>
        The number of data points or bins that compose the spectral
        data. The leftmost bin corresponds to the lower band edge, the
        rightmost bin corresponds to the upper band edge, and the
        middle bin center is aligned with the center frequency of the
        analysis span.
      </documentation>
      <documentation>
        <ipdr:units>bins</ipdr:units>
      </documentation>
    </annotation>
  </element>
  <element name="SpectrumAnalysisMeasResolutionBW" type="unsignedInt">
    <annotation>
      <documentation>
        Contains the resolution bandwidth
        (defined as the equivalent noise bandwidth) of each bin.
      </documentation>
      <documentation>
        <ipdr:units>hertz</ipdr:units>
      </documentation>
    </annotation>
  </element>
  <element name="SpectrumAnalysisMeasBinSpacing" type="unsignedInt">
    <annotation>
      <documentation>
        Contains the frequency separation between adjacent bins,
        not to exceed 25 kHz for channel widths less than or equal 6.4 MHz.
      </documentation>
      <documentation>
        <ipdr:units>hertz</ipdr:units>
      </documentation>
    </annotation>
  </element>
  <element name="SpectrumAnalysisMeasAmplitude" type="hexBinary">
    <annotation>
      <documentation>
        A sequence of two byte elements. Each element represents the
        spectral amplitudes in relation to the expected received signal
        power of a bin, in units of 0.01dB. That is, a test CMTS input
        signal with square-root raised-cosine spectrum, bandwidth equal
        to the expected received signal bandwidth, and power equal to
        the expected received signal power, which is present for the
        entire spectrum sampling period, will exhibit a spectrum
        measurement of 0 dB average power in each bin of the signal
        passband. Each bin element amplitude value format is 2's
        complement which provides a range of -327.68 dB to 327.67 dB
        amplitude value for the bin measurement.
      </documentation>
    </annotation>
  </element>
</schema>
