openconfig-wifi-phy

Model for managing PHY layer configuration of Radio interfaces.

  • Version: 2021-08-02

    openconfig-wifi-phy@2021-08-02


    
      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 "2021-08-02" {
          description
            "Add BSS color to radio config and neighbor table.";
          reference
            "1.0.0";
    
        }
    
        revision "2020-03-24" {
          description
            "Update namespace based on new directory structure";
          reference
            "0.4.2";
    
        }
    
        revision "2020-03-02" {
          description
            "Bug fix, add semicolon to previous revision statement.";
          reference
            "0.4.1";
    
        }
    
        revision "2019-12-20" {
          description "Add supported-channels.";
          reference
            "0.4.0";
    
        }
    
        revision "2018-12-19" {
          description
            "Add opmode to neighbor-table, transmit-eirp, and change
    transmit-power to int8.";
          reference
            "0.3.0";
    
        }
    
        revision "2017-12-21" {
          description
            "Add last-seen to neighbor-table.";
          reference
            "0.2.0";
    
        }
    
        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 "1.0.0";
    
        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. Each ID has a corresponding
    operating-frequency.";
          }
    
          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 configured state (enabled/disabled) of this radio
    interface.";
          }
    
          leaf transmit-power {
            type int8;
            units "dBm";
            default "9";
            description
              "Transmit power of the radio, in dBm.";
          }
    
          leaf transmit-eirp {
            type uint8;
            units "dBm";
            description
              "Transmit eirp of the radio + antenna, 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 bss-coloring {
            type boolean;
            default "true";
            description
              "Utilize BSS coloring on this radio.";
          }
    
          leaf bss-color-id {
            type uint8 {
              range "1..63";
            }
            description
              "Numerical identifier of the BSS.";
          }
    
          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 int8;
            units "dBm";
            default "3";
            description
              "Minimum allowed transmit-power on this radio, if utilizing
    dtp. Expressed in dBm.";
          }
    
          leaf dtp-max {
            when "../dtp = 'true'";
            type int8;
            units "dBm";
            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
              "Sets the number of associated stations after which the radio
    should not perform scanning";
          }
    
          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-list allowed-regulatory-channels {
            type oc-wifi-types:channels-type;
            description
              "Allowed channels, per regulatory restrictions, this Radio is
    capable of using. This is typically a combination of AP
    certification and allowed frequencies per country.";
          }
    
          leaf software-selectable {
            type boolean;
            description
              "Indicates whether or not the operating frequency can be
    configured by the operator.";
          }
    
          leaf dfs-hit-time {
            type oc-types:timeticks64;
            units "nanoseconds";
            description
              "Reports the time of the last DFS hit. The value is the
    timestamp in nanoseconds relative to the Unix Epoch
    (Jan 1, 1970 00:00:00 UTC).";
          }
    
          leaf-list supported-channels {
            type oc-wifi-types:channels-type;
            description
              "Channels allowed by a combination of regulatory and AP certification
    restrictions.";
          }
    
          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. The primary-channel leaf is used to
    identify the primary 20MHz channel of a bonded channel.";
          }
    
          leaf primary-channel {
            type uint16;
            description
              "The primary 20MHz channel, if the neighbor is operating on
    bonded channel.";
          }
    
          leaf bss-color-id {
            type uint8 {
              range "1..63";
            }
            description
              "Numerical identifier of the BSS.";
          }
    
          leaf last-seen {
            type oc-types:timeticks64;
            units "nanoseconds";
            description
              "Reports the time this reading was taken, indicating when
    this neighbor was last seen. If a cache is used, it MUST be
    updated instantly when a neighbor BSS changes channels, or a
    new BSS is seen. The value is the timestamp in nanoseconds
    relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).";
          }
    
          leaf opmode {
            type enumeration {
              enum "OPEN" {
                value 0;
                description
                  "Open authentication.";
              }
              enum "WPA2_PERSONAL" {
                value 1;
                description "WPA2-Personal.";
              }
              enum "WPA2_ENTERPRISE" {
                value 2;
                description "WPA2-Enterprise.";
              }
              enum "WPA_PERSONAL" {
                value 3;
                description "WPA-Personal.";
              }
              enum "WPA_ENTERPRISE" {
                value 4;
                description "WPA-Enterprise.";
              }
              enum "WEP" {
                value 5;
                description
                  "Any flavor of WEP encryption.";
              }
            }
            description
              "Operating mode of the BSS.";
            reference
              "Section 12.6.1.3 of the 802.11-2016 specification.";
    
          }
        }  // 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 operating-frequency";
              description
                "The list of radios on the device.";
              leaf id {
                type leafref {
                  path "../config/id";
                }
                description
                  "List key referencing the configured radio id.";
              }
    
              leaf operating-frequency {
                type leafref {
                  path
                    "../config/operating-frequency";
                }
                description
                  "List key referencing the radio operating-frequency.";
              }
    
              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
    

© 2023 YumaWorks, Inc. All rights reserved.