A YANG Data Model for Microwave Topology

module: ietf-network
  +--rw networks
     +--rw network* [network-id]
        +--rw network-id            network-id
        +--rw network-types
        |  +--rw tet:te-topology!
        |     +--rw mwtopo:mw-topology!
        +--rw supporting-network* [network-ref]
        |  +--rw network-ref    -> /networks/network/network-id
        +--rw node* [node-id]
        |  +--rw node-id                 node-id
        |  +--rw supporting-node* [network-ref node-ref]
        |  |  +--rw network-ref
        |  |  |           -> ../../../supporting-network/network-ref
        |  |  +--rw node-ref       -> /networks/network/node/node-id
        |  +--rw nt:termination-point* [tp-id]
        |     +--rw nt:tp-id                           tp-id
        |     +--rw nt:supporting-termination-point*
        |     |  |                     [network-ref node-ref tp-ref]
        |     |  +--rw nt:network-ref
        |     |  |        -> ../../../nw:supporting-node/network-ref
        |     |  +--rw nt:node-ref
        |     |  |           -> ../../../nw:supporting-node/node-ref
        |     |  +--rw nt:tp-ref
        |     |        -> /nw:networks/network[nw:network-id=current()
        |     |           /../network-ref]/node[nw:node-id=current()
        |     |           /../node-ref]/termination-point/tp-id
        |     +--rw tet:te!
        |        +--rw tet:name?          string
        |        +--ro tet:geolocation
        |        |  +--ro tet:altitude?   int64
        |        |  +--ro tet:latitude?   geographic-coordinate-degree
        |        |  +--ro tet:longitude?  geographic-coordinate-degree
        |        +--rw ifref:tp-to-interface-path?
        |        |       -> /if:interfaces/if:interface/if:name
        |        +--rw mwtopo:mw-tp-choice
        |           +--rw (mwtopo:mw-tp-option)?
        |              +--:(mwtopo:microwave-rltp)
        |              |  +--rw mwtopo:microwave-rltp!
        |              +--:(mwtopo:microwave-ctp)
        |                 +--rw mwtopo:microwave-ctp!
        +--rw nt:link* [link-id]
           +--rw nt:link-id                link-id
           +--rw nt:source
           |  +--rw nt:source-node?   -> ../../../nw:node/node-id
           |  +--rw nt:source-tp?
           |         -> ../../../nw:node[nw:node-id=current()
           |           /../source-node]/termination-point/tp-id
           +--rw nt:destination
           |  +--rw nt:dest-node?   -> ../../../nw:node/node-id
           |  +--rw nt:dest-tp?
           |        -> ../../../nw:node[nw:node-id=current()
           |          /../dest-node]/termination-point/tp-id
           +--rw tet:te!
              +--rw (tet:bundle-stack-level)?
              |  +--:(tet:bundle)
              |     +--rw tet:bundled-links
              |        +--rw tet:bundled-link* [sequence]
              |           +--rw tet:sequence      uint32
              |           +--rw tet:src-tp-ref?   -> ../../../../../
              |           |     nw:node[nw:node-id current()/../../..
              |           |     /../nt:source/source-node]/
              |           |     termination-point/tp-id
              |           +--rw tet:des-tp-ref?   -> ../../../../../
              |                 nw:node[nw:node-id = current()/../../
              |                 ../../nt:destination/dest-node]/
              |                 termination-point/tp-id
              +--rw tet:te-link-attributes
              |  +--rw tet:name?            string
              |  +--rw tet:admin-status?    te-types:te-admin-status
              |  +--rw tet:max-link-bandwidth
              |  |  +--rw tet:te-bandwidth
              |  |     +--rw (tet:technology)?
              |  |        +--:(mwtopo:microwave)
              |  |           +--ro mwtopo:mw-bandwidth? uint64
              |  +--rw mwtopo:mw-link-choice
              |  |   +--rw (mwtopo:mw-link-option)?
              |  |     +--:(mwtopo:microwave-radio-link)
              |  |     |  +--rw mwtopo:microwave-radio-link!
              |  |     |     +--rw mwtopo:mode?   identityref
              |  |     +--:(mwtopo:microwave-carrier)
              |  |        +--rw mwtopo:microwave-carrier!
              |  |           +--rw mwtopo:tx-frequency?       uint32
              |  |           +--rw mwtopo:rx-frequency?       uint32
              |  |           +--rw mwtopo:channel-separation? uint32
              |  |           +--ro actual-tx-cm?         identityref
              |  |           +--ro actual-snir?            decimal64
              |  |           +--ro actual-transmitted-level?   power
              |  +--rw bwatopo:link-availability* [availability]
              |  |  +--rw bwatopo:availability      decimal64
              |  |  +--rw bwatopo:link-bandwidth?   uint64
              |  +--ro bwatopo:actual-bandwidth?    yang:gauge64
              +--ro tet:oper-status?         te-types:te-oper-status

     Node N1                          Node N2
+--------------+                 +--------------+
| +----------+ |                 | +----------+ | L2-network
| | L2-N1-   | |    L2-N1-N2     | |    L2-N2-| | -L2 topology
| | TP1      o---------------------o    TP2   | |
| +----------+ |        '        | +----------+ | Supporting
|          :   |        '        |   :          | ' mw link
|          :   |        '        |   :          | : TPs
| +----------+ |        '        | +----------+ |
| |mw-N1-    | |   mwrl-N1-N2    | |    mw-N2-| | MW-network
| |RLTP1     o---------------------o    RLTP2 | | -MW topology
| +----------+ |        *        | +----------+ |
|         ::   | *************** |   ::         |
|         ::   |**             **|   ::         | Supporting
| +-------:--+ * *             * * +--:-------+ | : TPs
| |mw-N1- :  |*| * mwc-N1-N2-A * |*|  : mw-N1-| | * carriers as
| |CTP1   :  o---------------------o  : CTP2  | |   bundled links
| +-------:--+ | *             * | +--:-------+ |
|         :    |*               *|    :         |
| +----------+ *                 * +----------+ |
| |mw-N1-    |*|   mwc-N1-N2-B   |*|    mw-N1-| |
| |CTP3      o---------------------o    CTP4  | |
| +----------+ |                 | +----------+ |
+--------------+                 +--------------+
 Figure 3: L2 transported over a (2+0) microwave radio link

     Node N1                            Interfaces
+---------------+                    +----------------+
| +-----------+ |tp-to-interface-path| +------------+ |
| | L2-N1-TP1 |************************|L2Interface1| |
| +-----------+ |                    | +------------+ |
|               |                    |                |
| +-----------+ |tp-to-interface-path| +------------+ |
| |mw-N1-RLTP1|************************|   RLT-1    | |
| +-----------+ |                    | +------------+ |
|               |                    |                |
| +-----------+ |tp-to-interface-path| +------------+ |
| |mw-N1-CTP1 |************************|    CT-1    | |
| +-----------+ |                    | +------------+ |
|               |                    |                |
| +-----------+ |tp-to-interface-path| +------------+ |
| |mw-N1-CTP3 |************************|    CT-3    | |
| +-----------+ |                    | +------------+ |
+---------------+                    +----------------+
 Figure 4: References from the topology model information to
 the associated interface management model information

   The example above, a L2 network with a supporting microwave
   network, including microwave-topology (MW) and
   bandwidth-availability-topology (BWA) models as well as
   the reference to the associated interface management
   information, is encoded in JSON as follows:

<CODE BEGINS> file "example.json"
{
  "ietf-network:networks": {
    "network": [
      {
        "network-id": "L2-network",
        "network-types": {
          "ietf-l2-topology:l2-topology": {
          }
        },
        "supporting-network": [
          {
            "network-ref": "mw-network"
          }
        ],
        "node": [
          {
            "node-id": "L2-N1",
            "supporting-node": [
              {
                "network-ref": "mw-network",
                "node-ref": "mw-N1"
              }
            ],
            "ietf-network-topology:termination-point": [
              {
                "tp-id": "L2-N1-TP1",
                "supporting-termination-point": [
                  {
                    "network-ref": "mw-network",
                    "node-ref": "mw-N1",
                    "tp-ref": "mw-N1-RLTP1"
                  }
                ]
              }
            ]
          },
          {
            "node-id": "L2-N2",
            "supporting-node": [
              {
                "network-ref": "mw-network",
                "node-ref": "mw-N2"
              }
            ],
            "ietf-network-topology:termination-point": [
              {
                "tp-id": "L2-N2-TP2",
                "supporting-termination-point": [
                  {
                    "network-ref": "mw-network",
                    "node-ref": "mw-N2",
                    "tp-ref": "mw-N2-RLTP2"
                  }
                ]
              }
            ]
          }
        ],
        "ietf-network-topology:link": [
          {
            "link-id": "L2-N1-N2",
            "source": {
              "source-node": "L2-N1",
              "source-tp": "L2-N1-TP1"
            },
            "destination": {
              "dest-node": "L2-N2",
              "dest-tp": "L2-N2-TP2"
            },
            "supporting-link": [
              {
                "network-ref": "mw-network",
                "link-ref": "mwrl-N1-N2"
              }
            ]
          }
        ]
      },
      {
        "network-id": "mw-network",
        "network-types": {
          "ietf-te-topology:te-topology": {
            "ietf-microwave-topology:mw-topology": {
            }
          }
        },
        "node": [
          {
            "node-id": "mw-N1",
            "ietf-network-topology:termination-point": [
              {
                "tp-id": "mw-N1-RLTP1",
                "supporting-termination-point": [
                  {
                    "network-ref": "mw-network",
                    "node-ref": "mw-N1",
                    "tp-ref": "mw-N1-CTP1"
                  },
                  {
                    "network-ref": "mw-network",
                    "node-ref": "mw-N1",
                    "tp-ref": "mw-N1-CTP3"
                  }
                ],
                "ietf-te-topology:te-tp-id": "10.10.10.1",
                "ietf-te-topology:te": {
                  "ietf-microwave-topology:mw-tp-choice": {
                    "microwave-rltp": {}
                  },
                  "ietf-tp-interface-reference-topology:
                   tp-to-interface-path":"RLT-1"
                }
              },
              {
                "tp-id": "mw-N1-CTP1",
                "ietf-te-topology:te-tp-id": 1,
                "ietf-te-topology:te": {
                  "ietf-microwave-topology:mw-tp-choice": {
                    "microwave-ctp": {}
                  },
                  "ietf-tp-interface-reference-topology:
                  tp-to-interface-path":"CT-1"
                }
              },
              {
                "tp-id": "mw-N1-CTP3",
                "ietf-te-topology:te-tp-id": 2,
                "ietf-te-topology:te": {
                  "ietf-microwave-topology:mw-tp-choice": {
                    "microwave-ctp": {}
                  },
                  "ietf-tp-interface-reference-topology:
                  tp-to-interface-path":"CT-3"
                }
              }
            ]
          },
          {
            "node-id": "mw-N2",
            "ietf-network-topology:termination-point": [
              {
                "tp-id": "mw-N2-RLTP2",
                "supporting-termination-point": [
                  {
                    "network-ref": "mw-network",
                    "node-ref": "mw-N2",
                    "tp-ref": "mw-N2-CTP2"
                  },
                  {
                    "network-ref": "mw-network",
                    "node-ref": "mw-N2",
                    "tp-ref": "mw-N2-CTP4"
                  }
                ],
                "ietf-te-topology:te-tp-id": "10.10.10.1",
                "ietf-te-topology:te": {
                  "ietf-microwave-topology:mw-tp-choice": {
                    "microwave-rltp": {}
                  },
                  "ietf-tp-interface-reference-topology:
                  tp-to-interface-path":"RLT-2"
                }
              },
              {
                "tp-id": "mw-N2-CTP2",
                "ietf-te-topology:te-tp-id": 1,
                "ietf-te-topology:te": {
                  "ietf-microwave-topology:mw-tp-choice": {
                    "microwave-ctp": {}
                  },
                  "ietf-tp-interface-reference-topology:
                  tp-to-interface-path":"CT-2"
                }
              },
              {
                "tp-id": "mw-N2-CTP4",
                "ietf-te-topology:te-tp-id": 2,
                "ietf-te-topology:te": {
                  "ietf-microwave-topology:mw-tp-choice": {
                    "microwave-ctp": {}
                  },
                  "ietf-tp-interface-reference-topology:
                  tp-to-interface-path":"CT-4"
                }
              }
            ]
          }
        ],
        "ietf-network-topology:link": [
          {
            "link-id": "mwrl-N1-N2",
            "source": {
              "source-node": "mw-N1",
              "source-tp": "mw-N1-RLTP1"
            },
            "destination": {
              "dest-node": "mw-N2",
              "dest-tp": "mw-N2-RLTP2"
            },
            "ietf-te-topology:te": {
              "bundled-links": {
                "bundled-link": [
                  {
                    "sequence": 1,
                    "src-tp-ref": "mw-N1-CTP1",
                    "des-tp-ref": "mw-N2-CTP2"
                  },
                  {
                    "sequence": 2,
                    "src-tp-ref": "mw-N1-CTP3",
                    "des-tp-ref": "mw-N2-CTP4"
                  }
                ]
              },
              "te-link-attributes": {
                "ietf-bandwidth-availability-topology:
                link-availability": [
                  {
                    "availability": "0.999",
                    "link-bandwidth": "1572864"
                  },
                  {
                    "availability": "0.95",
                    "link-bandwidth": "2097152"
                  }
                ],
                "ietf-bandwidth-availability-topology:
                "actual-bandwidth": "2097152",
                "ietf-microwave-topology:mw-link-choice": {
                  "microwave-radio-link": {
                    "mode": "ietf-microwave-types:two-plus-zero"
                  }
                }
              }
            }
          },
          {
            "link-id": "mwc-N1-N2-A",
            "source": {
              "source-node": "mw-N1",
              "source-tp": "mw-N1-CTP1"
            },
            "destination": {
              "dest-node": "mw-N2",
              "dest-tp": "mw-N2-CTP2"
            },
            "ietf-te-topology:te": {
              "te-link-attributes": {
                "ietf-bandwidth-availability-topology:
                link-availability": [
                  {
                    "availability": "0.99",
                    "link-bandwidth": "1048576"
                  }
                ],
                "ietf-bandwidth-availability-topology:
                "actual-bandwidth": "1048576",
                "ietf-microwave-topology:mw-link-choice": {
                  "microwave-carrier": {
                    "tx-frequency": 10728000,
                    "rx-frequency": 10615000,
                    "channel-separation": 28000,
                    "actual-tx-cm": "ietf-microwave-types:qam-512",
                    "actual-snir": "46.2",
                    "actual-transmitted-level": "20.0"
                  }
                }
              }
            }
          },
          {
            "link-id": "mwc-N1-N2-B",
            "source": {
              "source-node": "mw-N1",
              "source-tp": "mw-N1-CTP3"
            },
            "destination": {
              "dest-node": "mw-N2",
              "dest-tp": "mw-N2-CTP4"
            },
            "ietf-te-topology:te": {
              "te-link-attributes": {
                "ietf-bandwidth-availability-topology:
                link-availability": [
                  {
                    "availability": "0.99",
                    "link-bandwidth": "1048576"
                  }
                ],
                "ietf-bandwidth-availability-topology:
                "actual-bandwidth": "1048576",
                "ietf-microwave-topology:mw-link-choice": {
                  "microwave-carrier": {
                    "tx-frequency": 10528000,
                    "rx-frequency": 10415000,
                    "channel-separation": 28000,
                    "actual-tx-cm": "ietf-microwave-types:qam-512",
                    "actual-snir": "46.4",
                    "actual-transmitted-level": "20.0"
                  }
                }
              }
            }
          }
        ]
      }
    ]
  },
  "ietf-interfaces:interfaces": {
    "interface": [
      {
        "name": "L2Interface1",
        "description": "'Ethernet Interface 1'",
        "type": "iana-if-type:ethernetCsmacd",
        "admin-status": "up",
        "oper-status": "up",
        "if-index": 1,
        "statistics": {
           "discontinuity-time": "2021-10-22T06:47:00-08:00"
        }
      },
      {
        "name": "L2Interface2",
        "description": "'Ethernet Interface 2'",
        "type": "iana-if-type:ethernetCsmacd",
        "admin-status": "up",
        "oper-status": "up",
        "if-index": 1,
        "statistics": {
           "discontinuity-time": "2021-10-22T06:47:00-08:00"
        }
      },
      {
        "name": "RLT-1",
        "description": "'Radio Link Terminal 1'",
        "type": "iana-if-type:microwaveRadioLinkTerminal",
        "admin-status": "up",
        "oper-status": "up",
        "if-index": 1,
        "statistics": {
           "discontinuity-time": "2021-10-22T06:47:00-08:00"
        },
        "ietf-microwave-radio-link:mode":
        "ietf-microwave-types:one-plus-zero",
        "ietf-microwave-radio-link:carrier-terminations": [
          "CT-1",
          "CT-3"
        ]
      },
      {
        "name": "RLT-2",
        "description": "'Radio Link Terminal 2'",
        "type": "iana-if-type:microwaveRadioLinkTerminal",
        "admin-status": "up",
        "oper-status": "up",
        "if-index": 1,
        "statistics": {
           "discontinuity-time": "2021-10-22T06:47:00-08:00"
        },
        "ietf-microwave-radio-link:mode":
        "ietf-microwave-types:one-plus-zero",
        "ietf-microwave-radio-link:carrier-terminations": [
          "CT-2",
          "CT-4"
        ]
      },
      {
        "name": "CT-1",
        "description": "'Carrier Termination 1'",
        "type": "iana-if-type:microwaveCarrierTermination",
        "admin-status": "up",
        "oper-status": "up",
        "if-index": 1,
        "statistics": {
           "discontinuity-time": "2021-10-22T06:47:00-08:00"
        },
        "ietf-microwave-radio-link:tx-frequency": 10728000,
        "ietf-microwave-radio-link:duplex-distance": 644000,
        "ietf-microwave-radio-link:channel-separation": 28000,
        "ietf-microwave-radio-link:rtpc": {
          "maximum-nominal-power": "20.0"
        },
        "ietf-microwave-radio-link:single": {
          "selected-cm": "ietf-microwave-types:qam-512"
        }
      },
      {
        "name": "CT-3",
        "description": "'Carrier Termination 3'",
        "type": "iana-if-type:microwaveCarrierTermination",
        "admin-status": "up",
        "oper-status": "up",
        "if-index": 1,
        "statistics": {
           "discontinuity-time": "2021-10-22T06:47:00-08:00"
        },
        "ietf-microwave-radio-link:tx-frequency": 10528000,
        "ietf-microwave-radio-link:duplex-distance": 644000,
        "ietf-microwave-radio-link:channel-separation": 28000,
        "ietf-microwave-radio-link:rtpc": {
          "maximum-nominal-power": "20.0"
        },
        "ietf-microwave-radio-link:single": {
          "selected-cm": "ietf-microwave-types:qam-512"
        }
      },
      {
        "name": "CT-2",
        "description": "'Carrier Termination 2'",
        "type": "iana-if-type:microwaveCarrierTermination",
        "admin-status": "up",
        "oper-status": "up",
        "if-index": 1,
        "statistics": {
           "discontinuity-time": "2021-10-22T06:47:00-08:00"
        },
        "ietf-microwave-radio-link:tx-frequency": 10615000,
        "ietf-microwave-radio-link:duplex-distance": 644000,
        "ietf-microwave-radio-link:channel-separation": 28000,
        "ietf-microwave-radio-link:rtpc": {
          "maximum-nominal-power": "20.0"
        },
        "ietf-microwave-radio-link:single": {
          "selected-cm": "ietf-microwave-types:qam-512"
        }
      },
      {
        "name": "CT-4",
        "description": "'Carrier Termination 4'",
        "type": "iana-if-type:microwaveCarrierTermination",
        "admin-status": "up",
        "oper-status": "up",
        "if-index": 1,
        "statistics": {
           "discontinuity-time": "2021-10-22T06:47:00-08:00"
        },
        "ietf-microwave-radio-link:tx-frequency": 10415000,
        "ietf-microwave-radio-link:duplex-distance": 644000,
        "ietf-microwave-radio-link:channel-separation": 28000,
        "ietf-microwave-radio-link:rtpc": {
          "maximum-nominal-power": "20.0"
        },
        "ietf-microwave-radio-link:single": {
          "selected-cm": "ietf-microwave-types:qam-512"
        }
      }
    ]
  }
}
<CODE ENDS>

 Note that the example above just shows one particular link
 (unidirectional) and not a complete network topology.