netconfcentral logo

openconfig-wifi-phy

HTML

openconfig-wifi-phy@2017-11-06



  module openconfig-wifi-phy {

    yang-version 1;

    namespace
      "http://openconfig.net/yang/wifi/phy";

    prefix oc-wifi-phy;

    import openconfig-yang-types {
      prefix oc-yang;
    }
    import openconfig-extensions {
      prefix oc-ext;
    }
    import openconfig-types {
      prefix oc-types;
    }
    import openconfig-wifi-types {
      prefix oc-wifi-types;
    }

    organization "OpenConfig working group";

    contact
      "OpenConfig working group
    www.openconfig.net";

    description
      "Model for managing PHY layer configuration of Radio interfaces.";

    revision "2017-11-06" {
      description
        "Add SSID to neighbor-table.";
      reference
        "0.1.1";

    }

    revision "2017-07-25" {
      description "Initial revision.";
      reference
        "0.1.0";

    }

    oc-ext:openconfig-version "0.1.1";

    grouping radio-common-config {
      description
        "Configuration items common to all Radio interfaces, independent
      of frequency";
      leaf id {
        type uint8;
        description
          "Unique ID of the radio.";
      }

      leaf operating-frequency {
        type identityref {
          base oc-wifi-types:OPERATING_FREQUENCY;
        }
        description
          "Operating frequency of this radio.";
      }

      leaf enabled {
        type boolean;
        default "true";
        description
          "The desired operational state (up/down) of this radio interface.";
      }

      leaf transmit-power {
        type uint8;
        units "dBm";
        default '9';
        description
          "Transmit power of the radio, in dBm.";
      }

      leaf channel {
        type uint8 {
          range "1..165";
        }
        description
          "Operating channel of this radio. If using channel-bonding this
        will represent the Primary 20MHz channel of the 40,80,160MHz channel.";
      }

      leaf channel-width {
        type uint8;
        units "MHz";
        default '20';
        description
          "Operating channel-width of this radio.";
      }

      leaf dca {
        type boolean;
        default "true";
        description
          "Utilize Dynamic Channel Assignment on this Radio.";
      }

      leaf-list allowed-channels {
        type oc-wifi-types:channels-type;
        description
          "Allowed channel list for this Radio to utilize.";
      }

      leaf dtp {
        type boolean;
        default "true";
        description
          "Utilize dynamic transmit-power on this Radio.";
      }

      leaf dtp-min {
        when "../dtp = 'true'";
        type uint8;
        default '3';
        description
          "Minimum allowed transmit-power on this radio, if utilizing dtp.
        Expressed in dBm.";
      }

      leaf dtp-max {
        when "../dtp = 'true'";
        type uint8;
        default '15';
        description
          "Maximum allowed transmit-power on this radio, if utilizing dtp.
        Expressed in dBm.";
      }

      leaf antenna-gain {
        type int8;
        description
          "Antenna gain applied to this Radio; typically used when
        external antennae connected.";
      }

      leaf scanning {
        type boolean;
        default "true";
        description
          "Whether the radio will perform off-channel scanning, to collect
        neighboring RF information.";
      }

      leaf scanning-interval {
        type uint8;
        units "seconds";
        description
          "How often, in seconds, the radio will go off-channel to perform
        scanning.";
      }

      leaf scanning-dwell-time {
        type uint16;
        units "milliseconds";
        description
          "Amount of time, in milliseconds, the radio will spend on a
        channel during scanning-interval. If a Monitor-mode Radio, it will
        cycle through scanning-allowed-channels spending this amount of time
        on each.";
      }

      leaf scanning-defer-clients {
        type uint8;
        description
          "Do not perform scanning if this amount of Stations are Associated
        to the Radio.";
      }

      leaf scanning-defer-traffic {
        type boolean;
        description
          "Do not perform scanning if any traffic received from an active Station
        in the past 100ms marked as AC_VO or AC_VI.";
      }
    }  // grouping radio-common-config

    grouping radio-common-state {
      description
        "Grouping for defining radio-specific operational state";
      leaf base-radio-mac {
        type oc-yang:mac-address;
        description
          "Represents the 'burned-in' base-radio MAC
        address for the a Radio interface.";
      }

      leaf dfs-hit-time {
        type oc-types:timeticks64;
        description
          "Reports the time of the last DFS hit. The value is the timestamp
        in seconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).";
      }

      leaf channel-change-reason {
        type identityref {
          base oc-wifi-types:CHANGE_REASON_TYPE;
        }
        description
          "When an Access Point changes channels, this will
        provide the reason that led to the change.";
      }

      leaf total-channel-utilization {
        type oc-types:percentage;
        description
          "Total 802.11 and non-802.11 channel utilization on this Radio. The
        total channel utilization should include all time periods the AP
        spent actively receiving and transmitting 802.11 frames, and also
        include all time spent with clear channel assessment (CCA) in a
        busy state";
      }

      leaf rx-dot11-channel-utilization {
        type oc-types:percentage;
        description
          "Received channel-utilization due to 802.11 frames";
      }

      leaf rx-noise-channel-utilization {
        type oc-types:percentage;
        description
          "Received channel-utilization percentage due to Noise.";
      }

      leaf tx-dot11-channel-utilization {
        type oc-types:percentage;
        description
          "Transmit channel-utilization percentage.";
      }
    }  // grouping radio-common-state

    grouping radio-counters-state {
      description
        "Radio telemetry statistics.";
      container counters {
        description
          "A collection of radio-related statistics objects.";
        leaf failed-fcs-frames {
          type oc-yang:counter64;
          description
            "Number of frames that failed the FCS";
        }

        leaf noise-floor {
          type int8;
          description
            "Noise Floor, as measured by this radio.";
        }
      }  // container counters
    }  // grouping radio-counters-state

    grouping neighbor-list-state {
      description
        "Operational state data relating to neighboring
       BSSIDs and their received signal strength.";
      leaf bssid {
        type oc-yang:mac-address;
        description "Neighboring BSSID.";
      }

      leaf ssid {
        type string;
        description
          "The SSID of this neighboring BSSID.";
      }

      leaf rssi {
        type int8;
        description
          "The RSSI of this neighboring BSSID.";
      }

      leaf channel {
        type uint16;
        description
          "The channel of this neighboring BSSID. This is to utilize 802.11ac
        nomenclature. For example, 40MHz channel 36-40 represented as
        channel 38. primary-channel used to identify the primary
        20MHz channel of the neighbor.";
      }

      leaf primary-channel {
        type uint16;
        description
          "The primary 20MHz channel, if the neighbor is operating on bonded
        channel.";
      }
    }  // grouping neighbor-list-state

    grouping neighbor-bssid-top {
      description
        "Top-level grouping for neighbor table
    operational state data.";
      container neighbors {
        description
          "Top-level container for RF neighbors.";
        list neighbor {
          key "bssid";
          config false;
          description
            "The mac address, or BSSID, of a neighbor, and
          their corresponding RSSI.";
          leaf bssid {
            type leafref {
              path "../state/bssid";
            }
            config false;
            description
              "Reference to neighbor bssid.";
          }

          container state {
            config false;
            description
              "State container for RF neighbors.";
            uses neighbor-list-state;
          }  // container state
        }  // list neighbor
      }  // container neighbors
    }  // grouping neighbor-bssid-top

    grouping radio-top {
      description
        "Top-level grouping for radio configuration and
      operational state data";
      container radios {
        description
          "Top level container for radios, including configuration
        and state data.";
        list radio {
          key "id";
          description
            "The list of radios on the device.";
          leaf id {
            type leafref {
              path "../config/id";
            }
            description
              "References the configured id of the radio";
          }

          container config {
            description
              "Configurable items at the global, radio interface
            level";
            uses radio-common-config;
          }  // container config

          container state {
            config false;
            description
              "Operational state data at the global radio level";
            uses radio-common-config;

            uses radio-common-state;

            uses radio-counters-state;
          }  // container state

          uses neighbor-bssid-top;
        }  // list radio
      }  // container radios
    }  // grouping radio-top

    uses radio-top;
  }  // module openconfig-wifi-phy

Summary

  
  
Organization OpenConfig working group
  
Module openconfig-wifi-phy
Version 2017-11-06
File openconfig-wifi-phy.yang
  
Prefix oc-wifi-phy
Namespace http://openconfig.net/yang/wifi/phy
  
Cooked /cookedmodules/openconfig-wifi-phy/2017-11-06
YANG /src/openconfig-wifi-phy@2017-11-06.yang
XSD /xsd/openconfig-wifi-phy@2017-11-06.xsd
  
Abstract Model for managing PHY layer configuration of Radio interfaces.
  
Contact
OpenConfig working group
www.openconfig.net

Description

 
Model for managing PHY layer configuration of Radio interfaces.

Groupings

Grouping Objects Abstract
neighbor-bssid-top neighbors Top-level grouping for neighbor table operational state data.
neighbor-list-state bssid ssid rssi channel primary-channel Operational state data relating to neighboring BSSIDs and their received signal strength.
radio-common-config id operating-frequency enabled transmit-power channel channel-width dca allowed-channels dtp dtp-min dtp-max antenna-gain scanning scanning-interval scanning-dwell-time scanning-defer-clients scanning-defer-traffic Configuration items common to all Radio interfaces, independent of frequency
radio-common-state base-radio-mac dfs-hit-time channel-change-reason total-channel-utilization rx-dot11-channel-utilization rx-noise-channel-utilization tx-dot11-channel-utilization Grouping for defining radio-specific operational state
radio-counters-state counters Radio telemetry statistics.
radio-top radios Top-level grouping for radio configuration and operational state data

Objects

Type Key
Mandatory config
Optional config
Not config
Object Type Abstract
radios container Top level container for radios, including configuration and state data.
   radio list The list of radios on the device.
      config container Configurable items at the global, radio interface level
         allowed-channels leaf-list Allowed channel list for this Radio to utilize.
         antenna-gain leaf Antenna gain applied to this Radio; typically used when external antennae connected.
         channel leaf Operating channel of this radio. If using channel-bonding this will represent the Primary 20MHz channel of the 40,80,160MHz channel.
         channel-width leaf Operating channel-width of this radio.
         dca leaf Utilize Dynamic Channel Assignment on this Radio.
         dtp leaf Utilize dynamic transmit-power on this Radio.
         dtp-max leaf Maximum allowed transmit-power on this radio, if utilizing dtp. Expressed in dBm.
         dtp-min leaf Minimum allowed transmit-power on this radio, if utilizing dtp. Expressed in dBm.
         enabled leaf The desired operational state (up/down) of this radio interface.
         id leaf Unique ID of the radio.
         operating-frequency leaf Operating frequency of this radio.
         scanning leaf Whether the radio will perform off-channel scanning, to collect neighboring RF information.
         scanning-defer-clients leaf Do not perform scanning if this amount of Stations are Associated to the Radio.
         scanning-defer-traffic leaf Do not perform scanning if any traffic received from an active Station in the past 100ms marked as AC_VO or AC_VI.
         scanning-dwell-time leaf Amount of time, in milliseconds, the radio will spend on a channel during scanning-interval. If a Monitor-mode Radio, it will cycle through scanning-allowed-channels spending this amount of time on each.
         scanning-interval leaf How often, in seconds, the radio will go off-channel to perform scanning.
         transmit-power leaf Transmit power of the radio, in dBm.
      id leaf References the configured id of the radio
      neighbors container Top-level container for RF neighbors.
         neighbor list The mac address, or BSSID, of a neighbor, and their corresponding RSSI.
            bssid leaf Reference to neighbor bssid.
            state container State container for RF neighbors.
               bssid leaf Neighboring BSSID.
               channel leaf The channel of this neighboring BSSID. This is to utilize 802.11ac nomenclature. For example, 40MHz channel 36-40 represented as channel 38. primary-channel used to identify the primary 20MHz channel of the neighbor.
               primary-channel leaf The primary 20MHz channel, if the neighbor is operating on bonded channel.
               rssi leaf The RSSI of this neighboring BSSID.
               ssid leaf The SSID of this neighboring BSSID.
      state container Operational state data at the global radio level
         allowed-channels leaf-list Allowed channel list for this Radio to utilize.
         antenna-gain leaf Antenna gain applied to this Radio; typically used when external antennae connected.
         base-radio-mac leaf Represents the 'burned-in' base-radio MAC address for the a Radio interface.
         channel leaf Operating channel of this radio. If using channel-bonding this will represent the Primary 20MHz channel of the 40,80,160MHz channel.
         channel-change-reason leaf When an Access Point changes channels, this will provide the reason that led to the change.
         channel-width leaf Operating channel-width of this radio.
         counters container A collection of radio-related statistics objects.
            failed-fcs-frames leaf Number of frames that failed the FCS
            noise-floor leaf Noise Floor, as measured by this radio.
         dca leaf Utilize Dynamic Channel Assignment on this Radio.
         dfs-hit-time leaf Reports the time of the last DFS hit. The value is the timestamp in seconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
         dtp leaf Utilize dynamic transmit-power on this Radio.
         dtp-max leaf Maximum allowed transmit-power on this radio, if utilizing dtp. Expressed in dBm.
         dtp-min leaf Minimum allowed transmit-power on this radio, if utilizing dtp. Expressed in dBm.
         enabled leaf The desired operational state (up/down) of this radio interface.
         id leaf Unique ID of the radio.
         operating-frequency leaf Operating frequency of this radio.
         rx-dot11-channel-utilization leaf Received channel-utilization due to 802.11 frames
         rx-noise-channel-utilization leaf Received channel-utilization percentage due to Noise.
         scanning leaf Whether the radio will perform off-channel scanning, to collect neighboring RF information.
         scanning-defer-clients leaf Do not perform scanning if this amount of Stations are Associated to the Radio.
         scanning-defer-traffic leaf Do not perform scanning if any traffic received from an active Station in the past 100ms marked as AC_VO or AC_VI.
         scanning-dwell-time leaf Amount of time, in milliseconds, the radio will spend on a channel during scanning-interval. If a Monitor-mode Radio, it will cycle through scanning-allowed-channels spending this amount of time on each.
         scanning-interval leaf How often, in seconds, the radio will go off-channel to perform scanning.
         total-channel-utilization leaf Total 802.11 and non-802.11 channel utilization on this Radio. The total channel utilization should include all time periods the AP spent actively receiving and transmitting 802.11 frames, and also include all time spent with clear channel assessment (CCA...
         transmit-power leaf Transmit power of the radio, in dBm.
         tx-dot11-channel-utilization leaf Transmit channel-utilization percentage.