bbf-onu-management-proxy

This module contains a collection of YANG definitions for supporting the Broadband Forum requirements for ONU Management Proxy f...

  • Version: 2022-06-07

    bbf-onu-management-proxy@2022-06-07


    
      module bbf-onu-management-proxy {
    
        yang-version 1.1;
    
        namespace
          "urn:bbf:yang:bbf-onu-management-proxy";
    
        prefix bbf-onu-mgmt-p;
    
        import bbf-network-function {
          prefix bbf-nf;
        }
        import bbf-network-function-client {
          prefix bbf-nfc;
        }
        import bbf-network-function-server {
          prefix bbf-nfs;
        }
        import bbf-network-function-types {
          prefix bbf-nft;
        }
        import bbf-voltmf-common {
          prefix bbf-voltmf-c;
        }
        import bbf-voltmf-message-monitor {
          prefix bbf-voltmf-msg-mon;
        }
        import bbf-vomci-common {
          prefix bbf-vomci-c;
        }
        import bbf-vomci-types {
          prefix bbf-vomcit;
        }
        import bbf-yang-types {
          prefix bbf-yang;
        }
        import ietf-yang-schema-mount {
          prefix yangmnt;
        }
    
        organization
          "Broadband Forum <https://www.broadband-forum.org>
    SDN/NFV Work Area";
    
        contact
          "Comments or questions about this Broadband Forum YANG module
    should be directed to <mailto:help@broadband-forum.org>.
    
    Editor:      Tim Carey, Nokia
    
    Editor:      Jeff Hartley, Commscope
    
    WA Director: Mengmeng Li, China Mobile
    
    WA Director: Bruno Cornaglia, Vodafone";
    
        description
          "This module contains a collection of YANG definitions for
    supporting the Broadband Forum requirements for ONU
    Management Proxy functionality as described in TR-451.
    
    Copyright (c) 2019-2022, Broadband Forum
    
    Redistribution and use in source and binary forms, with or
    without modification, are permitted provided that the following
    conditions are met:
    
    1. Redistributions of source code must retain the above copyright
       notice, this list of conditions and the following disclaimer.
    
    2. Redistributions in binary form must reproduce the above
       copyright notice, this list of conditions and the following
       disclaimer in the documentation and/or other materials
       provided with the distribution.
    
    3. Neither the name of the copyright holder nor the names of its
       contributors may be used to endorse or promote products
       derived from this software without specific prior written
       permission.
    
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
    CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
    INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
    MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
    DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
    CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
    NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
    LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
    STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
    ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
    ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    
    The above license is used as a license under copyright only.
    Please reference the Forum IPR Policy for patent licensing terms
    <https://www.broadband-forum.org/ipr-policy>.
    
    Any moral rights which are necessary to exercise under the above
    license grant are also deemed granted under this license.
    
    This version of this YANG module is part of TR-451; see
    the TR itself for full legal notices.";
    
        revision "2022-06-07" {
          description
            "Issue 1.
    * Approval Date:    2022-06-07.
    * Publication Date: 2022-06-07.";
          reference
            "TR-451: vOMCI Specification
            	<https://www.broadband-forum.org/technical/download/
            		 TR-451_Issue-1.pdf>";
    
        }
    
    
        feature nf-client {
          description
            "Indicates that client connectivity to network function
    endpoints is supported.";
        }
    
        feature nf-server {
          description
            "Indicates that server connectivity to network function
    endpoints is supported.";
        }
    
        container onu-management-proxy {
          description
            "Data nodes associated with the ONU Management Proxy.";
          leaf message-timeout {
            type uint16 {
              range "10..max";
            }
            units "seconds";
            default "900";
            description
              "The maximum number of seconds for a response to be received
    to a transmitted message. The timeout is used to clean up
    stale messages.";
          }
    
          container nf-topology {
            description
              "The VNFs, VNF instances and network function links that
    cannot be discovered.
    
    The network function has knowledge of:
      VNFs: vOMCI Function, vOMCI Proxy, ONU Management Proxy
      VNF Instances and links of Network Functions:
        vOMCI function, vOMCI Proxy, OLT.";
            leaf type {
              type identityref {
                base bbf-nft:nf-topology;
              }
              description
                "The type of deployment topology used by this network
    function.";
            }
    
            leaf other-type {
              when
                "derived-from-or-self(../type,'bbf-nft:other-topology')" {
                description
                  "Only valid when the topology type is 'other-topology'.";
              }
              type bbf-yang:string-ascii64;
              description
                "The other type of deployment topology used by this network
    function, when 'type' is set to 'other-topology'.";
            }
    
            list vnf {
              key "name";
              description
                "Data nodes describing the VNF 'flavor' (not instance) being
    used. For example, vendor or version info.";
              leaf name {
                type bbf-yang:string-ascii64;
                description
                  "The VNF 'flavor' (not instance) being used.";
              }
    
              leaf vendor {
                type bbf-yang:string-ascii64;
                description
                  "The vendor of the VNF.";
              }
    
              leaf software-version {
                type bbf-yang:string-ascii64;
                description
                  "The software version of VNF.";
              }
    
              leaf nf-type {
                type identityref {
                  base bbf-nft:vnf-type;
                }
                mandatory true;
                description
                  "The type of the VNF within the solution context.
    For example: ONU-Management-Proxy, vOMCI-function,
    vOMCI-Proxy.";
              }
            }  // list vnf
    
            list vnf-instance {
              key "name";
              description
                "An instance of a VNF.";
              leaf name {
                type bbf-yang:string-ascii64;
                description
                  "The name of the instance.";
              }
    
              leaf vnf {
                type leafref {
                  path "../../vnf/name";
                }
                mandatory true;
                description
                  "The VNF 'flavor' (not instance) being used.";
              }
    
              container data {
                yangmnt:mount-point "device-yang-library" {
                  description "The YANG library associated with the device.";
                }
                description
                  "The data nodes of the device's schema.";
              }  // container data
            }  // list vnf-instance
    
            list nf-link {
              key "name";
              description
                "A link to a network function. Depending on usage, this may
    be to a physical or virtual NF, and may be one-ended or
    two-ended.";
              leaf name {
                type bbf-yang:string-ascii64;
                description
                  "The name of the link to the network function.";
              }
    
              list endpoint {
                key "nf-instance endpoint";
                max-elements 2;
                description
                  "An endpoint at the network function.";
                leaf nf-instance {
                  type bbf-yang:string-ascii64;
                  description
                    "The name of the instance of the network function at the
    remote end of the link.
    
    If the function is a PNF, then this value is the
    device identifier of the PNF.";
                }
    
                leaf endpoint {
                  type bbf-yang:string-ascii64;
                  description
                    "The name of the endpoint at the network function.";
                }
    
                leaf nf-type {
                  type bbf-yang:string-ascii64;
                  description
                    "The type of the network function endpoint.";
                }
              }  // list endpoint
            }  // list nf-link
          }  // container nf-topology
    
          container onu-vomci-assignment-policy {
            description
              "The policy rules to use to associate an ONU with a list of
    vOMCI functions.";
            list rule {
              key "name";
              ordered-by user;
              description
                "A rule to assign an ONU to vOMCI function types.
    
    A rule contains a classification of resources that match a
    criteria. The result is a list of vOMCI function types.
    
    The rule is applied for a given ONU according to priority,
    then list order as defined by the client for equal
    priorities. Once a match is achieved, the search is
    terminated and the list of vOMCI functions applied.";
              leaf name {
                type bbf-yang:string-ascii64;
                description "The rule name.";
              }
    
              leaf priority {
                type uint16 {
                  range "1..max";
                }
                mandatory true;
                description
                  "Indicates the priority for applying the match criteria of
    this rule against the priority of match criteria of other
    rules in this filter.
    
    The higher the value, the lower the priority, i.e.
    priority 1 is the highest priority.";
              }
    
              container match-criteria {
                description
                  "Match criteria for ONU assignment policies. Specific match
    criteria shall be provided using augments in a context
    dependent way, e.g. match criteria can be augmented for
    ONUs, or in another context match criteria can be
    augmented for another resource.";
                leaf criteria-type {
                  type identityref {
                    base bbf-vomcit:onu-vomci-criteria;
                  }
                  default "bbf-vomcit:any-onu";
                  description
                    "The type of ONU vOMCI selection criteria to apply to
    this rule.";
                }
    
                leaf onu-vendor {
                  when
                    "../criteria-type = 'bbf-vomcit:onu-vendor'";
                  type bbf-vomcit:onu-vendor-id;
                  mandatory true;
                  description
                    "ONU vendor as defined in the TC layer ONU-ID.";
                }
    
                leaf onu-software-version {
                  when
                    "(../criteria-type = 'bbf-vomcit:onu-vendor') or
    (../criteria-type =
    'bbf-vomcit:onu-software-version')";
                  type bbf-vomcit:onu-software-version;
                  mandatory true;
                  description
                    "ONU vendor's software version.";
                }
              }  // container match-criteria
    
              leaf-list vomci-function {
                type bbf-yang:string-ascii64;
                min-elements 1;
                description
                  "Data nodes describing the VNF 'flavor' (not instance) being
    used for the ONU. For example, vendor or version info.";
              }
            }  // list rule
          }  // container onu-vomci-assignment-policy
    
          container remote-nf {
            presence
              "Enables access to remote network functions";
            description
              "The remote network function (NF) configuration.";
            container nf-client {
              if-feature bbf-onu-mgmt-p:nf-client;
              description
                "Client network function configuration.";
              leaf enabled {
                type boolean;
                default "true";
                description
                  "Administratively enable the use of client connectivity
    capability to connect to network function endpoints.";
              }
    
              container initiate {
                description
                  "Configures client initiating underlying connections. If
    there are multiple remote-servers, they may be
    connected to in parallel.";
                list remote-server {
                  key "name";
                  description
                    "A remote server the client will connect to.";
                  leaf name {
                    type bbf-yang:string-ascii64;
                    description
                      "An arbitrary name for the remote server.";
                  }
    
                  leaf nf-type {
                    type identityref {
                      base bbf-nft:nf-type;
                    }
                    description
                      "The type of remote communication endpoint
    (e.g, vOMCI-proxy, vOMCI-function, vOLTMF, OLT).";
                  }
    
                  leaf on-demand {
                    type boolean;
                    default "false";
                    description
                      "Determines whether the client establishes a
    connection to the endpoint only on-demand ('true')
    or is establishes a connection permanently
    ('false').";
                  }
    
                  leaf local-service-endpoint {
                    type bbf-yang:string-ascii64;
                    description
                      "The name that the NF will use when reporting the
    NF as an endpoint. For example, see sections
    5.8.2.1 Hello vOMCI service and 5.7.1.2.1.1 Hello
    Message (service-endpoint-name) in TR-451 for how
    this parameter is used for vOMCI communication.";
                    reference
                      "TR-451: vOMCI Specification, sections 5.8.2.1,
                      5.7.1.2.1.1";
    
                  }
    
                  choice transport {
                    mandatory true;
                    description
                      "Selects between available client transports.";
                    case grpc {
                      description
                        "Selection for gRPC client transport.";
                      container grpc-client {
                        if-feature bbf-grpcc:grpc-client;
                        description
                          "A wrapper around the gRPC client parameters to avoid name
    collisions.";
                        container channel {
                          description
                            "The gRPC channel properties.";
                          leaf ping-interval {
                            type uint32 {
                              range "0..max";
                            }
                            units "seconds";
                            default "300";
                            description
                              "Sets the amount of time after which a ping request is sent.
    A value of 0 disables pings from being sent.";
                          }
                        }  // container channel
    
                        container connection-backoff {
                          if-feature bbf-grpcc:connection-backoff;
                          description
                            "The connection backoff directs how a client reconnects to a
    remote endpoint after discovering its connection to the
    remote endpoint has dropped.";
                          reference
                            "github.com/grpc/grpc/blob/master/doc/connection-backoff.md.";
    
                          leaf enable {
                            type boolean;
                            default "true";
                            description
                              "If 'true', connection-backoff is enabled.";
                          }
    
                          leaf initial-backoff {
                            type uint16 {
                              range "1..max";
                            }
                            units "seconds";
                            default "30";
                            description
                              "The initial wait period after the first failure before
    retrying.";
                          }
    
                          leaf min-connect-timeout {
                            type uint16 {
                              range "1..max";
                            }
                            units "seconds";
                            default "20";
                            description
                              "The minimum time to wait for the connection attempts.";
                          }
    
                          leaf multiplier {
                            type decimal64 {
                              fraction-digits
                                2;
                            }
                            default "1.60";
                            description
                              "The factor with which to multiply the backoff after a
    failed retry.";
                          }
    
                          leaf jitter {
                            type decimal64 {
                              fraction-digits
                                2;
                            }
                            default "0.20";
                            description
                              "The factor with which to randomize the backoff.";
                          }
    
                          leaf max-backoff {
                            type uint16 {
                              range "1..max";
                            }
                            default "10";
                            description
                              "The number of times the client tries to connect to a
    specific endpoint before moving on to the next endpoint
    in the list (round robin).";
                          }
                        }  // container connection-backoff
    
                        list access-point {
                          key "name";
                          min-elements 1;
                          ordered-by user;
                          description
                            "A user-ordered list of access points that the client will
    attempt to connect to in the specified sequence. Defining
    more than one enables high-availability.";
                          leaf name {
                            type bbf-yang:string-ascii64;
                            description
                              "An arbitrary name for the access point.";
                          }
    
                          container grpc-transport-parameters {
                            description
                              "gRPC agent transport parameters.";
                            choice tcp-client-options {
                              description
                                "Replicate some pre-standard IETF client/server
    options in-file, and provide a place to add IETF
    client/server stack options post-standard in the
    future.";
                              container remote-port {
                                description
                                  "The remote port identified by a client.";
                                leaf remote-port {
                                  type inet:port-number;
                                  default "8443";
                                  description
                                    "The client will attempt to connect to the
    common port value for 'grpc' (8443) if no
    value is specified.";
                                }
                              }  // container remote-port
                            }  // choice tcp-client-options
                          }  // container grpc-transport-parameters
    
                          notification remote-endpoint-status-change {
                            description
                              "A notification traceable to a client remote-endpoint
    and access-point. This notification is sent when a
    remote-endpoint is connected or disconnected.";
                            leaf connected {
                              type boolean;
                              mandatory true;
                              description
                                "New remote-endpoint status.";
                            }
    
                            leaf last-changed {
                              type yang:date-and-time;
                              mandatory true;
                              description
                                "The system date and time when the remote-endpoint was
    connected or disconnected.";
                            }
                          }  // notification remote-endpoint-status-change
                        }  // list access-point
                      }  // container grpc-client
                    }  // case grpc
    
                    case kafka {
                      description
                        "Selection for Kafka client transport.";
                      container kafka-agent {
                        if-feature bbf-kafkaa:kafka-agent;
                        description
                          "A wrapper around the Kafka agent parameters to avoid name
    collisions.";
                        leaf client-id {
                          type string;
                          mandatory true;
                          description
                            "The identifier that the client/consumer (agent) uses
    to identify the source of a message.";
                        }
    
                        container publication-parameters {
                          if-feature bbf-kafkaa:message-publication;
                          description
                            "The Kafka agent publication properties.";
                          list topic {
                            key "name";
                            description
                              "The topics the agent will publish.";
                            leaf name {
                              type string;
                              mandatory true;
                              description
                                "The name of the topic.";
                            }
    
                            leaf purpose {
                              type string;
                              description
                                "The purpose of the topic (e.g., VOMCI_NOTIFICATION,
    VOMCI_REQUEST, VOMCI_RESPONSE).";
                            }
    
                            leaf partition {
                              type string;
                              description
                                "For topics that are partitioned, the partition used for
    production and consumption.";
                            }
                          }  // list topic
                        }  // container publication-parameters
    
                        container consumption-parameters {
                          if-feature bbf-kafkaa:message-consumption;
                          description
                            "The Kafka agent consumption properties.";
                          leaf group-id {
                            type string;
                            mandatory true;
                            description
                              "The identifier of the group that the consumer can
    participate in.";
                          }
    
                          list topic {
                            key "name";
                            description
                              "The topics the agent will consume.";
                            leaf name {
                              type string;
                              mandatory true;
                              description
                                "The name of the topic.";
                            }
    
                            leaf purpose {
                              type string;
                              description
                                "The purpose of the topic (e.g., VOMCI_NOTIFICATION,
    VOMCI_REQUEST, VOMCI_RESPONSE).";
                            }
    
                            leaf partition {
                              type string;
                              description
                                "For topics that are partitioned, the partition used for
    production and consumption.";
                            }
                          }  // list topic
                        }  // container consumption-parameters
    
                        list access-point {
                          key "name";
                          min-elements 1;
                          ordered-by user;
                          description
                            "A user-ordered list of access points that the client will
    attempt to connect to in the specified sequence. Defining
    more than one enables high-availability.";
                          leaf name {
                            type bbf-yang:string-ascii64;
                            description
                              "An arbitrary name for the access point.";
                          }
    
                          container kafka-agent-transport-parameters {
                            description
                              "Kafka agent transport parameters.";
                            choice tcp-client-options {
                              description
                                "Replicate some pre-standard IETF client/server
    options in-file, and provide a place to add IETF
    client/server stack options post-standard in the
    future.";
                              container remote-port {
                                description
                                  "The remote port identified by a client.";
                                leaf remote-port {
                                  type inet:port-number;
                                  default "9092";
                                  description
                                    "The client will attempt to connect to the
    common port value for 'kafka' (9092) if no
    value is specified.";
                                }
                              }  // container remote-port
                            }  // choice tcp-client-options
                          }  // container kafka-agent-transport-parameters
    
                          notification remote-endpoint-status-change {
                            description
                              "A notification traceable to a client remote-endpoint
    and access-point. This notification is sent when a
    remote-endpoint is connected or disconnected.";
                            leaf connected {
                              type boolean;
                              mandatory true;
                              description
                                "New remote-endpoint status.";
                            }
    
                            leaf last-changed {
                              type yang:date-and-time;
                              mandatory true;
                              description
                                "The system date and time when the
    remote-endpoint was connected or disconnected.";
                            }
                          }  // notification remote-endpoint-status-change
                        }  // list access-point
                      }  // container kafka-agent
                    }  // case kafka
                  }  // choice transport
                }  // list remote-server
              }  // container initiate
            }  // container nf-client
    
            container nf-server {
              if-feature bbf-onu-mgmt-p:nf-server;
              description
                "Server network function configuration.";
              leaf enabled {
                type boolean;
                default "true";
                description
                  "Administratively enable the use of server connectivity
    capability to connect to network function endpoints.";
              }
    
              container listen {
                presence
                  "Enables server to listen for client connections.";
                description
                  "Configures listen behavior.";
                leaf idle-timeout {
                  type uint16;
                  units "seconds";
                  default "3600";
                  description
                    "The maximum number of seconds that a session may remain
    idle. A session will be dropped if it is idle for an
    interval longer than this number of seconds. If set to
    zero, then the server will never drop a session because
    it is idle. Sessions that have a notification subscription
    active are never dropped.";
                }
    
                list listen-endpoint {
                  key "name";
                  min-elements 1;
                  description
                    "The endpoints to listen for connections.";
                  leaf name {
                    type bbf-yang:string-ascii64;
                    description
                      "An arbitrary name for the listen endpoint.";
                  }
    
                  leaf local-service-endpoint {
                    type bbf-yang:string-ascii64;
                    description
                      "The name that this network function will use when
    reporting itself as an endpoint. For example, see section
    5.8.2.1 Hello vOMCI service in TR-451 for how this
    parameter is used for vOMCI communication. The value in
    this leaf is typically the same value as the name of the
    'listen-endpoint' but could be different for certain
    deployments. If this leaf is not configured the name of
    the 'listen-endpoint' is used.";
                    reference
                      "TR-451 section 5.8.2.1";
    
                  }
    
                  choice transport {
                    mandatory true;
                    description
                      "Selects between available transports.";
                    case grpc {
                      description
                        "Selection for gRPC server transport.";
                      container grpc-server {
                        if-feature bbf-grpcs:grpc-server;
                        description
                          "A wrapper around the gRPC server parameters to avoid name
    collisions.";
                        choice tcp-client-options {
                          description
                            "Replicate some pre-standard IETF client/server options
    in-file, and provide a place to add IETF client/server
    stack options post-standard in the future.";
                          leaf remote-port {
                            type inet:port-number;
                            default "8443";
                            description
                              "The client will attempt to connect to the well-known
    port value for 'grpc' (8443) if no value is
    specified.";
                          }
                        }  // choice tcp-client-options
                      }  // container grpc-server
                    }  // case grpc
                  }  // choice transport
    
                  container remote-clients {
                    config false;
                    description
                      "Remote clients that are currently connected to the
    server.";
                    list remote-client {
                      key "local-service-endpoint";
                      description
                        "A remote client that is currently connected.";
                      leaf local-service-endpoint {
                        type bbf-yang:string-ascii64;
                        description
                          "Identity of the local service endpoint of the remote
    endpoint as provided as part of the vOMCI hello
    exchange when the connection to the remote endpoint
    was established.";
                      }
                    }  // list remote-client
    
                    notification remote-client-status-change {
                      description
                        "A notification traceable to a server listen endpoint
    and a remote endpoint associated with the listen
    endpoint. This notification is sent when remote
    endpoint is connected or disconnected to/from the
    listen endpoint.";
                      leaf remote-client {
                        type leafref {
                          path "../../../remote-clients/remote-client/local-service-endpoint";
                          require-instance
                            false;
                        }
                        mandatory true;
                        description
                          "The remote endpoint that was connected or
    disconnected.";
                      }
    
                      leaf connected {
                        type boolean;
                        mandatory true;
                        description
                          "If 'true', the remote endpoint was connected.";
                      }
    
                      leaf remote-endpoint-state-last-change {
                        type yang:date-and-time;
                        mandatory true;
                        description
                          "The system date and time when the remote endpoint was
    connected or disconnected.";
                      }
                    }  // notification remote-client-status-change
                  }  // container remote-clients
                }  // list listen-endpoint
              }  // container listen
            }  // container nf-server
          }  // container remote-nf
    
          container statistics {
            config false;
            description
              "Counters for the YANG messages sent between the ONU
    Management Proxy and the vOMCI function or vOMCI Proxy
    that are not targeted to an ONU.";
            action reset {
              description
                "Reset the statistics counters.";
            }  // rpc reset
    
            leaf in-messages {
              type yang:counter64;
              units "messages";
              config false;
              description
                "The number of messages that have been received by the
    entity.";
            }
    
            leaf out-messages {
              type yang:counter64;
              units "messages";
              config false;
              description
                "The number of messages that have been transmitted by the
    entity.";
            }
    
            leaf in-errored-messages {
              type yang:counter64;
              units "messages";
              config false;
              description
                "The number of messages received by the entity that contain
    errors.";
            }
          }  // container statistics
    
          container managed-onus {
            description
              "The ONUs that are being managed by this entity.";
            action create-onu {
              description
                "Create an ONU within the ONU Management Proxy.";
              input {
                leaf name {
                  type bbf-vomcit:onu-name;
                  description
                    "The unique name of the ONU.";
                }
    
                leaf xpon-onu-type {
                  type identityref {
                    base bbf-vomcit:xpon-onu-type;
                  }
                  description
                    "The ONU's xPON type.";
                }
    
                leaf vendor-id {
                  type bbf-vomcit:onu-vendor-id;
                  description
                    "The vendor name of the ONU.";
                }
    
                leaf software-version {
                  type bbf-vomcit:onu-software-version;
                  description
                    "The software version associated with the ONU.";
                }
              }
            }  // rpc create-onu
    
            list managed-onu {
              key "name";
              config false;
              description
                "An ONU that is being managed by this entity.";
              leaf name {
                type bbf-vomcit:onu-name;
                description
                  "The unique name of the ONU.";
              }
    
              leaf xpon-onu-type {
                type identityref {
                  base bbf-vomcit:xpon-onu-type;
                }
                description
                  "The ONU's xPON type.";
              }
    
              action delete-onu {
                description
                  "Delete an ONU within the ONU Proxy. Note that this is not
    the YANG state data but the Managed Entities state data
    used to manage the ONU (e.g., MIB data sync valule).";
                input {
                  leaf delete-state-data {
                    type boolean;
                    default "true";
                    description
                      "When 'true', the ONU state data is deleted.";
                  }
                }
              }  // rpc delete-onu
    
              action delete-only-onu-state-data {
                description
                  "Delete remaining state data for ONUs that have already
    been deleted from the list of managed ONUS.  Note - Do
    not execute this unless the ONU has already been deleted
    with 'delete-onu' and with the 'delete-state-data' leaf
    set to 'true'. Note that this is not the YANG state data
    but the Managed Entities state data used to manage the
    ONU (e.g., MIB data sync valule).";
              }  // rpc delete-only-onu-state-data
    
              action set-onu-communication {
                description
                  "Dynamically configure the information necessary to
    establish if an ONU can be communicated with by the vOMCI
    Proxy along with remote endpoint to use.";
                input {
                  list onu-management-chain {
                    key "nf-type nf-instance";
                    ordered-by user;
                    description
                      "The ordered list of ONU Management Proxy, vOMCI
    function, vOMCI Proxy and OLT instances to use for
    this ONU's management.";
                    leaf nf-type {
                      type identityref {
                        base bbf-nft:nf-type;
                      }
                      description
                        "The type of NF.";
                    }
    
                    leaf nf-instance {
                      type bbf-yang:string-ascii64;
                      description
                        "The name of the NF.";
                    }
                  }  // list onu-management-chain
    
                  leaf onu-communication-available {
                    type boolean;
                    description
                      "When true, the ONU is able to be communicated with
    across the ONU management chain of entities.";
                  }
    
                  container onu-attachment-point {
                    description
                      "The current ONU attachment point";
                    leaf olt-name {
                      type bbf-vomcit:olt-name;
                      description
                        "The OLT name where the ONU is attached";
                    }
    
                    leaf channel-termination-name {
                      type string;
                      description
                        "The channel termination name where the ONU is attached.";
                    }
    
                    leaf onu-id {
                      type bbf-xpon-types:onu-id;
                      description
                        "This is the TC layer ONU-ID identifier assigned to the
    ONU by the OLT during ONU activation.";
                      reference
                        "ITU-T G.984.3 clause 5.5.2
                        ITU-T G.987.3 clause 6.4.2
                        ITU-T G.9807.1 clause C.6.1.5.6
                        ITU-T G.989.3 clause 6.1.5.6";
    
                    }
                  }  // container onu-attachment-point
    
                  leaf software-version {
                    type bbf-vomcit:onu-software-version;
                    description
                      "The software version associated with the ONU.";
                  }
    
                  leaf onu-management-chain-selection {
                    type enumeration {
                      enum "vomci-policy" {
                        value 0;
                        description
                          "Identifies that the ONU management chain is
    computed using a policy to select the vOMCI
    function instance.";
                      }
                      enum "configured" {
                        value 1;
                        description
                          "Identifies that the ONU management chain is
    configured by an external entity.";
                      }
                    }
                    description
                      "The option used to determine the ONU management
    chain.";
                  }
    
                  leaf xpon-onu-type {
                    type identityref {
                      base bbf-vomcit:xpon-onu-type;
                    }
                    description
                      "The ONU's xPON type.";
                  }
                }
              }  // rpc set-onu-communication
    
              notification onu-management-chain-updated {
                description
                  "The notification that reports that an ONU's management
    chain has been modified by the entity.";
                list current-onu-management-chain {
                  key "nf-type nf-instance";
                  ordered-by user;
                  description
                    "The ordered list of ONU Management Proxy, vOMCI
    function, vOMCI Proxy and OLT instances to use for
    this ONU's management.";
                  leaf nf-type {
                    type identityref {
                      base bbf-nft:vnf-type;
                    }
                    description
                      "The type of NF.";
                  }
    
                  leaf nf-instance {
                    type bbf-yang:string-ascii64;
                    description
                      "The name of the NF.";
                  }
                }  // list current-onu-management-chain
              }  // notification onu-management-chain-updated
    
              container onu-attachment-point {
                description
                  "The current ONU attachment point";
                leaf olt-name {
                  type bbf-vomcit:olt-name;
                  description
                    "The OLT name where the ONU is attached";
                }
    
                leaf channel-termination-name {
                  type string;
                  description
                    "The channel termination name where the ONU is attached.";
                }
    
                leaf onu-id {
                  type bbf-xpon-types:onu-id;
                  description
                    "This is the TC layer ONU-ID identifier assigned to the
    ONU by the OLT during ONU activation.";
                  reference
                    "ITU-T G.984.3 clause 5.5.2
                    ITU-T G.987.3 clause 6.4.2
                    ITU-T G.9807.1 clause C.6.1.5.6
                    ITU-T G.989.3 clause 6.1.5.6";
    
                }
              }  // container onu-attachment-point
    
              leaf vendor-id {
                type bbf-vomcit:onu-vendor-id;
                description
                  "The vendor name of the ONU.";
              }
    
              leaf software-version {
                type bbf-vomcit:onu-software-version;
                description
                  "The software version associated with the ONU.";
              }
    
              leaf voltmf-remote-endpoint {
                type bbf-yang:string-ascii64;
                description
                  "The name remote endpoint to use for transmitting YANG
    messages toward the vOLTMF.";
              }
    
              list onu-management-chain {
                key "nf-type nf-instance";
                config false;
                ordered-by user;
                description
                  "The ordered list of ONU Management Proxy, vOMCI function,
    vOMCI Proxy and OLT instances to use for this ONU's
    management.";
                leaf nf-type {
                  type identityref {
                    base bbf-nft:vnf-type;
                  }
                  description "The type of NF.";
                }
    
                leaf nf-instance {
                  type bbf-yang:string-ascii64;
                  description
                    "The name of the NF.";
                }
              }  // list onu-management-chain
    
              container statistics {
                config false;
                description
                  "Statistics for per ONU interactions sent between the
    entity and vOMCI function or ONU Management Proxy.";
                action reset {
                  description
                    "Reset the counters of the statistics.";
                }  // rpc reset
    
                leaf in-messages {
                  type yang:counter64;
                  units "messages";
                  config false;
                  description
                    "The number of messages that have been received by the
    entity.";
                }
    
                leaf out-messages {
                  type yang:counter64;
                  units "messages";
                  config false;
                  description
                    "The number of messages that have been transmitted by the
    entity.";
                }
    
                leaf in-errored-messages {
                  type yang:counter64;
                  units "messages";
                  config false;
                  description
                    "The number of messages received by the entity that contain
    errors.";
                }
              }  // container statistics
            }  // list managed-onu
          }  // container managed-onus
        }  // container onu-management-proxy
      }  // module bbf-onu-management-proxy
    

© 2023 YumaWorks, Inc. All rights reserved.