common/src/main/java/org/opendaylight/transportpce/common/mapping/PortMapping.java

   1 /*
   2  * Copyright © 2017 AT&T and others.  All rights reserved.
   3  *
   4  * This program and the accompanying materials are made available under the
   5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
   6  * and is available at http://www.eclipse.org/legal/epl-v10.html
   7  */
   8
   9 package org.opendaylight.transportpce.common.mapping;
  10
  11
  12 import java.util.List;
  13 import java.util.Map;
  14 import org.opendaylight.yang.gen.v1.http.org.opendaylight.transportpce.portmapping.rev220316.mapping.Mapping;
  15 import org.opendaylight.yang.gen.v1.http.org.opendaylight.transportpce.portmapping.rev220316.mc.capabilities.McCapabilities;
  16 import org.opendaylight.yang.gen.v1.http.org.opendaylight.transportpce.portmapping.rev220316.network.Nodes;
  17 import org.opendaylight.yang.gen.v1.http.org.openroadm.device.rev200529.org.openroadm.device.container.org.openroadm.device.OduSwitchingPools;
  18 import org.opendaylight.yang.gen.v1.http.org.openroadm.device.rev200529.org.openroadm.device.container.org.openroadm.device.odu.switching.pools.non.blocking.list.PortList;
  19 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
  20 import org.opendaylight.yangtools.yang.common.Uint16;
  21
  22
  23 public interface PortMapping {
  24
  25     PortMappingVersion221 getPortMappingVersion221();
  26
  27     PortMappingVersion710 getPortMappingVersion710();
  28
  29     /**
  30      * This method creates logical to physical port mapping for a given device.
  31      * Instead of parsing all the circuit packs/ports in the device, this methods
  32      * does a selective read operation on degree/srg subtree to get circuit
  33      * packs/ports that map to :
  34      *
  35      * <p>
  36      * 1. DEGn-TTP-TX, DEGn-TTP-RX, DEGn-TTP-TXRX
  37      *
  38      * <p>
  39      * 2. SRGn-PPp-TX, SRGn-PPp-RX, SRGn-PPp-TXRX
  40      *
  41      * <p>
  42      * 3. LINEn
  43      *
  44      * <p>
  45      * 4. CLNTn.
  46      *
  47      * <p>
  48      * If the port is Mw it also store the OMS, OTS interface provisioned on the
  49      * port. It skips the logical ports that are internal. If operation is
  50      * successful the mapping gets stored in datastore corresponding to
  51      * portmapping.yang data model.
  52      *
  53      * @param nodeId
  54      *            node ID
  55      * @param nodeVersion
  56      *            node version
  57      *
  58      * @return true/false based on status of operation
  59      */
  60     boolean createMappingData(String nodeId, String nodeVersion);
  61
  62     /**
  63      * This method removes all mapping data of a given node from the datastore
  64      * after disconnecting ODL from a Netconf device.
  65      *
  66      * @param nodeId
  67      *            node ID
  68      */
  69     void deletePortMappingNode(String nodeId);
  70
  71     /**
  72      * This method for a given node's termination point returns the Mapping object
  73      * based on portmapping.yang model stored in the MD-SAL data store which is
  74      * created when the node is connected for the first time. The mapping object
  75      * basically contains the following attributes of interest:
  76      *
  77      * <p>
  78      * 1. Supporting circuit pack
  79      *
  80      * <p>
  81      * 2. Supporting port
  82      *
  83      * <p>
  84      * 3. Supporting OTS/OMS interface (if port on ROADM)
  85      *
  86      * @param nodeId
  87      *            Unique Identifier for the node of interest.
  88      * @param logicalConnPoint
  89      *            Name of the logical point
  90      *
  91      * @return Result Mapping object if success otherwise null.
  92      */
  93     Mapping getMapping(String nodeId, String logicalConnPoint);
  94
  95     /**
  96      * This method allows retrieving a Mapping object from the mapping list stored in
  97      * the MD-SAL data store. The main interest is to retrieve the
  98      * logical-connection-point associated with a given port on a supporting
  99      * circuit-pack
 100      *
 101      * @param nodeId
 102      *            Unique Identifier for the node of interest.
 103      * @param circuitPackName
 104      *            Name of the supporting circuit-pack
 105      * @param portName
 106      *            Name of the supporting port
 107      *
 108      * @return Result Mapping object if success otherwise null.
 109      */
 110     Mapping getMapping(String nodeId, String circuitPackName, String portName);
 111
 112     /**
 113      * This method removes a given mapping data from the mapping list
 114      * stored in the datastore while the Netconf device is already
 115      * connected to the controller.
 116      *
 117      * @param nodeId
 118      *            node ID
 119      * @param logicalConnectionPoint
 120      *            key of the mapping inside the mapping list
 121      */
 122     void deleteMapping(String nodeId, String logicalConnectionPoint);
 123
 124     /**
 125      * This method, for a given node media channel-capabilities, returns the object
 126      * based on portmapping.yang model stored in the MD-SAL data store which is
 127      * created when the node is connected for the first time. The mapping object
 128      * basically contains the following attributes of interest:
 129      *
 130      * <p>
 131      * 1. slot width granularity
 132      *
 133      * <p>
 134      * 2. center frequency granularity
 135      *
 136      * <p>
 137      * 3. Supporting OMS interface (if port on ROADM)
 138      *
 139      * <p>
 140      * 4. Supporting OTS interface (if port on ROADM)
 141      *
 142      * @param nodeId
 143      *            Unique Identifier for the node of interest.
 144      * @param mcLcp
 145      *            Name of the MC-capability
 146      *
 147      * @return Result McCapabilities.
 148      */
 149     McCapabilities getMcCapbilities(String nodeId, String mcLcp);
 150
 151     /**
 152      * This method for a given node, allows to update a specific mapping based on
 153      * portmapping.yang model already stored in the MD-SAL data store, following
 154      * some changes on the device port (creation of interface supported on this
 155      * port, change of port admin state, etc).
 156      *
 157     * @param nodeId
 158      *            Unique Identifier for the node of interest.
 159      * @param mapping
 160      *            Old mapping to be updated.
 161      *
 162      * @return Result true/false based on status of operation.
 163      */
 164     boolean updateMapping(String nodeId, Mapping mapping);
 165
 166     /**
 167      * Returns all Mapping informations for a given ordm device. This method returns
 168      * all Mapping informations already stored in the MD-SAL data store for a given
 169      * openroadm device. Beyound the list of mappings, it gives access to general
 170      * node information as its version or its node type, etc.
 171      *
 172      * @param nodeId
 173      *            Unique Identifier for the node of interest.
 174      *
 175      * @return node data if success otherwise null.
 176      */
 177     Nodes getNode(String nodeId);
 178
 179     /**
 180      * This method allows to update a port-mapping node with odu-connection-map data.
 181      * This method is used for an otn xponder in version 7.1, when a device sends a
 182      * change-notification advertising controller that odu-switching-pools containers
 183      * have been populated inside its configuration
 184      * (appears after creation of an OTSI-Group interface).
 185      *
 186      * @param nodeId
 187      *            Unique Identifier for the node of interest.
 188      * @param ospIID
 189      *            Instance Identifier of the odu-switching-pools.
 190      * @param nbliidMap
 191      *            Map containing the non-blocking-list number as key,
 192      *            and the list of Instance Identifier corresponding to each port-list
 193      *            as value.
 194      *
 195      * @return Result true/false based on status of operation.
 196      */
 197     boolean updatePortMappingWithOduSwitchingPools(String nodeId, InstanceIdentifier<OduSwitchingPools> ospIID,
 198         Map<Uint16, List<InstanceIdentifier<PortList>>> nbliidMap);
 199
 200     /**
 201      * This method check the presence or not of a given node inside the PortMapping
 202      * datastore.
 203      *
 204      * @param nodeId
 205      *            Unique Identifier for the node of interest.
 206      *
 207      * @return Result true/false based on existance or not of a given node.
 208      */
 209     boolean isNodeExist(String nodeId);
 210
 211 }