module ieee802-dot1q-preemption {

    yang-version 1.1;

    namespace
      'urn:ieee:std:802.1Q:yang:ieee802-dot1q-preemption';

    prefix preempt;

    organization "IEEE 802.1 Working Group";

    contact
      "WG-URL: http://www.ieee802.org/1/
    WG-EMail: stds-802-1-l@ieee.org
    
    Contact: IEEE 802.1 Working Group Chair
    Postal: C/O IEEE 802.1 Working Group
    IEEE Standards Association
    445 Hoes Lane
    Piscataway, NJ 08854
    USA
    
    E-mail: STDS-802-1-CHAIRS@IEEE.ORG";

    description
      "This module provides for management of IEEE Std 802.1Q Bridges that
    support frame preemption.
    
    Copyright (C) IEEE (2023).
    
    This version of this YANG module is part of IEEE Std 802.1Q; see the
    standard itself for full legal notices.";

    revision "2023-10-26" {
      description
        "Published as part of IEEE Std 802.1Qcw-2023.
      
      The following reference statement identifies each referenced IEEE
      Standard as updated by applicable amendments.";
      reference
        "IEEE Std 802.1Q Bridges and Bridged Networks:
        IEEE Std 802.1Q-2022, IEEE Std 802.1Qcz-2023, IEEE Std 802.1Qcw-2023.";

    }


    feature frame-preemption {
      description
        "Frame preemption supported.";
      reference
        "IEEE Std 802.1Q";

    }

    typedef frame-preemption-status-enum {
      type enumeration {
        enum "express" {
          value 0;
          description
            "Frames queued for the priority are to be transmitted using the
          express service for the Port.";
        }
        enum "preemptable" {
          value 1;
          description
            "Frames queued for the priority are to be transmitted using the
          preemptable service for the Port.";
        }
      }
      description
        "Frame preemption status of each priority.";
    }

    grouping preemption-parameters {
      description
        "preemption-parameters comprises all of the parameters associated with
      frame preemption configuration.";
      container frame-preemption-parameters {
        description
          "A table containing a set of frame preemption parameters, one for
        each Port. All writeable objects in this table must be persistent
        over power up restart/reboot.";
        reference
          "12.30.1 of IEEE Std 802.1Q";

        container frame-preemption-status-table {
          description
            "The framePreemptionStatusTable consists of 8 frame-preemption
          status parameter leafs, one per priority";
          reference
            "12.30.1.1 of IEEE Std 802.1Q";

          leaf priority0 {
            type frame-preemption-status-enum;
            default "express";
            description
              "The value of the frame-preemption status parameter for the
            priority 0. The default value of the parameter is express (1).
            The value of this object MUST be retained across
            reinitializations of the management system.";
            reference
              "12.30.1.1.1 of IEEE Std 802.1Q";

          }

          leaf priority1 {
            type frame-preemption-status-enum;
            default "express";
            description
              "The value of the frame-preemption status parameter for the
            priority 1. The default value of the parameter is express (1).
            The value of this object MUST be retained across
            reinitializations of the management system.";
            reference
              "12.30.1.1.1 of IEEE Std 802.1Q";

          }

          leaf priority2 {
            type frame-preemption-status-enum;
            default "express";
            description
              "The value of the frame-preemption status parameter for the
            priority 2. The default value of the parameter is express (1).
            The value of this object MUST be retained across
            reinitializations of the management system.";
            reference
              "12.30.1.1.1 of IEEE Std 802.1Q";

          }

          leaf priority3 {
            type frame-preemption-status-enum;
            default "express";
            description
              "The value of the frame-preemption status parameter for the
            priority 3. The default value of the parameter is express (1).
            The value of this object MUST be retained across
            reinitializations of the management system.";
            reference
              "12.30.1.1.1 of IEEE Std 802.1Q";

          }

          leaf priority4 {
            type frame-preemption-status-enum;
            default "express";
            description
              "The value of the frame-preemption-status parameter for the
            priority 4. The default value of the parameter is express (1).
            The value of this object MUST be retained across
            reinitializations of the management system.";
            reference
              "12.30.1.1.1 of IEEE Std 802.1Q";

          }

          leaf priority5 {
            type frame-preemption-status-enum;
            default "express";
            description
              "The value of the frame-preemption status parameter for the
            priority 5. The default value of the parameter is express (1).
            The value of this object MUST be retained across
            reinitializations of the management system.";
            reference
              "12.30.1.1.1 of IEEE Std 802.1Q";

          }

          leaf priority6 {
            type frame-preemption-status-enum;
            default "express";
            description
              "The value of the frame-preemption status parameter for the
            priority 6. The default value of the parameter is express (1).
            The value of this object MUST be retained across
            reinitializations of the management system.";
            reference
              "12.30.1.1.1 of IEEE Std 802.1Q";

          }

          leaf priority7 {
            type frame-preemption-status-enum;
            default "express";
            description
              "The value of the frame-preemption status parameter for the
            priority 7. The default value of the parameter is express (1).
            The value of this object MUST be retained across
            reinitializations of the management system.";
            reference
              "12.30.1.1.1 of IEEE Std 802.1Q";

          }
        }  // container frame-preemption-status-table

        leaf hold-advance {
          type uint32;
          units "nanoseconds";
          config false;
          description
            "The value of the holdAdvance parameter for the Port in
          nanoseconds. There is no default value; the holdAdvance is a
          property of the underlying MAC.";
          reference
            "12.30.1.2 of IEEE Std 802.1Q";

        }

        leaf release-advance {
          type uint32;
          units "nanoseconds";
          config false;
          description
            "The value of the releaseAdvance parameter for the Port in
          nanoseconds. There is no default value; the releaseAdvance is a
          property of the underlying MAC.";
          reference
            "12.30.1.3 of IEEE Std 802.1Q";

        }

        leaf preemption-active {
          type boolean;
          config false;
          description
            "TRUE if preemption is both supported by the MAC and currently
          active.";
          reference
            "12.30.1.4 of IEEE Std 802.1Q";

        }

        leaf hold-request {
          type enumeration {
            enum "hold" {
              value 1;
              description
                "A hold request has been issued to the MAC.";
            }
            enum "release" {
              value 2;
              description
                "A release request has been issued to the MAC.";
            }
          }
          config false;
          description
            "The value of the holdRequest parameter for the Port, either hold
          (1) or release (2). The value of this object is release (2) on
          system initialization.";
          reference
            "12.30.1.5 of IEEE Std 802.1Q";

        }
      }  // container frame-preemption-parameters
    }  // grouping preemption-parameters
  }  // module ieee802-dot1q-preemption