Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2018-present Open Networking Foundation |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | * |
| 16 | * This work was partially supported by EC H2020 project METRO-HAUL (761727). |
| 17 | */ |
| 18 | package org.onosproject.drivers.odtn.tapi; |
| 19 | |
| 20 | import com.fasterxml.jackson.databind.JsonNode; |
| 21 | import com.fasterxml.jackson.databind.ObjectMapper; |
| 22 | import com.google.common.collect.ImmutableList; |
| 23 | import com.google.common.collect.Lists; |
| 24 | import org.onlab.packet.ChassisId; |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 25 | import org.onosproject.net.DefaultAnnotations; |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 26 | import org.onosproject.net.Device; |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 27 | import org.onosproject.net.DeviceId; |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 28 | import org.onosproject.net.OchSignal; |
| 29 | import org.onosproject.net.OduSignalType; |
| 30 | import org.onosproject.net.PortNumber; |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 31 | import org.onosproject.net.device.DefaultDeviceDescription; |
| 32 | import org.onosproject.net.device.DeviceDescription; |
| 33 | import org.onosproject.net.device.DeviceDescriptionDiscovery; |
| 34 | import org.onosproject.net.device.DeviceService; |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 35 | import org.onosproject.net.device.PortDescription; |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 36 | import org.onosproject.net.driver.AbstractHandlerBehaviour; |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 37 | import org.onosproject.protocol.rest.RestSBController; |
| 38 | import org.slf4j.Logger; |
| 39 | |
| 40 | import javax.ws.rs.core.MediaType; |
| 41 | import java.io.IOException; |
| 42 | import java.io.InputStream; |
| 43 | import java.util.Iterator; |
| 44 | import java.util.List; |
| 45 | |
| 46 | import static com.google.common.base.Preconditions.checkNotNull; |
Andrea Campanella | 3d2ba46 | 2019-08-22 16:29:21 +0200 | [diff] [blame^] | 47 | import static org.onosproject.drivers.odtn.tapi.TapiDeviceHelper.CONTEXT; |
Andrea Campanella | 2bdf204 | 2019-01-28 13:47:11 +0100 | [diff] [blame] | 48 | import static org.onosproject.drivers.odtn.tapi.TapiDeviceHelper.LAYER_PROTOCOL_NAME; |
Andrea Campanella | 2bdf204 | 2019-01-28 13:47:11 +0100 | [diff] [blame] | 49 | import static org.onosproject.drivers.odtn.tapi.TapiDeviceHelper.MC_POOL; |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 50 | import static org.onosproject.drivers.odtn.tapi.TapiDeviceHelper.MEDIA_CHANNEL_SERVICE_INTERFACE_POINT_SPEC; |
Andrea Campanella | 2bdf204 | 2019-01-28 13:47:11 +0100 | [diff] [blame] | 51 | import static org.onosproject.drivers.odtn.tapi.TapiDeviceHelper.PHOTONIC_LAYER_QUALIFIER_NMC; |
| 52 | import static org.onosproject.drivers.odtn.tapi.TapiDeviceHelper.PHOTONIC_MEDIA; |
| 53 | import static org.onosproject.drivers.odtn.tapi.TapiDeviceHelper.SERVICE_INTERFACE_POINT; |
| 54 | import static org.onosproject.drivers.odtn.tapi.TapiDeviceHelper.SUPPORTED_LAYER_PROTOCOL_QUALIFIER; |
Andrea Campanella | 2bdf204 | 2019-01-28 13:47:11 +0100 | [diff] [blame] | 55 | import static org.onosproject.drivers.odtn.tapi.TapiDeviceHelper.UUID; |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 56 | import static org.onosproject.drivers.odtn.tapi.TapiDeviceHelper.getOchSignal; |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 57 | import static org.onosproject.net.optical.device.OchPortHelper.ochPortDescription; |
| 58 | import static org.slf4j.LoggerFactory.getLogger; |
| 59 | |
| 60 | /** |
| 61 | * Driver Implementation of the DeviceDescrption discovery for ONF Transport-API (TAPI) v2.1 based |
| 62 | * open line systems (OLS). |
| 63 | */ |
| 64 | |
| 65 | public class TapiDeviceDescriptionDiscovery |
| 66 | extends AbstractHandlerBehaviour |
| 67 | implements DeviceDescriptionDiscovery { |
| 68 | |
| 69 | private static final Logger log = getLogger(TapiDeviceDescriptionDiscovery.class); |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 70 | private static final String SIP_REQUEST_DATA_API = "/restconf/data/tapi-common:context"; |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 71 | |
| 72 | /** |
| 73 | * Get the deviceId for which the methods apply. |
| 74 | * |
| 75 | * @return The deviceId as contained in the handler data |
| 76 | */ |
| 77 | private DeviceId did() { |
| 78 | return handler().data().deviceId(); |
| 79 | } |
| 80 | |
| 81 | @Override |
| 82 | public DeviceDescription discoverDeviceDetails() { |
| 83 | log.debug("Getting device description"); |
| 84 | DeviceService deviceService = checkNotNull(handler().get(DeviceService.class)); |
| 85 | DeviceId deviceId = handler().data().deviceId(); |
| 86 | Device device = deviceService.getDevice(deviceId); |
| 87 | |
| 88 | if (device == null) { |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 89 | //TODO need to obtain from the device. |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 90 | return new DefaultDeviceDescription(deviceId.uri(), |
| 91 | Device.Type.OLS, |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 92 | "Tapi", |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 93 | "0", |
| 94 | "2.1", |
| 95 | "Unknown", |
Boyuan Yan | 6b23b38 | 2019-06-04 11:59:35 -0700 | [diff] [blame] | 96 | new ChassisId(), |
| 97 | DefaultAnnotations.builder().set("protocol", "REST").build()); |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 98 | } else { |
| 99 | return new DefaultDeviceDescription(device.id().uri(), |
| 100 | Device.Type.OLS, |
| 101 | device.manufacturer(), |
| 102 | device.hwVersion(), |
| 103 | device.swVersion(), |
| 104 | device.serialNumber(), |
| 105 | device.chassisId()); |
| 106 | } |
| 107 | } |
| 108 | |
| 109 | @Override |
| 110 | public List<PortDescription> discoverPortDetails() { |
| 111 | log.debug("Discovering port details."); |
| 112 | RestSBController controller = checkNotNull(handler().get(RestSBController.class)); |
| 113 | DeviceId deviceId = handler().data().deviceId(); |
| 114 | |
| 115 | try { |
| 116 | InputStream inputStream = controller.get(deviceId, SIP_REQUEST_DATA_API, MediaType.APPLICATION_JSON_TYPE); |
| 117 | JsonNode jsonNode = new ObjectMapper().readTree(inputStream); |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 118 | if (jsonNode == null) { |
| 119 | log.error("Can't discover port details at {}", SIP_REQUEST_DATA_API); |
| 120 | return ImmutableList.of(); |
| 121 | } |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 122 | return parseTapiPorts(jsonNode); |
| 123 | } catch (IOException e) { |
| 124 | log.error("Exception discoverPortDetails() {}", did(), e); |
| 125 | return ImmutableList.of(); |
| 126 | } |
| 127 | } |
| 128 | |
| 129 | protected List<PortDescription> parseTapiPorts(JsonNode tapiContext) { |
| 130 | List<PortDescription> ports = Lists.newArrayList(); |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 131 | /* |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 132 | This annotations are used to store persistent mapping information between TAPI SIP's uuid |
| 133 | and ONOS device portNumbers. This is needed to be publicly available at least within ODTN app |
| 134 | when connectivity services will be sent to OLS Controller. |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 135 | */ |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 136 | DefaultAnnotations.Builder annotations = DefaultAnnotations.builder(); |
Andrea Campanella | 3d2ba46 | 2019-08-22 16:29:21 +0200 | [diff] [blame^] | 137 | Iterator<JsonNode> iter = tapiContext.get(CONTEXT).get(SERVICE_INTERFACE_POINT).iterator(); |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 138 | while (iter.hasNext()) { |
| 139 | JsonNode sipAttributes = iter.next(); |
| 140 | if (checkValidEndpoint(sipAttributes)) { |
| 141 | String uuid = sipAttributes.get(UUID).textValue(); |
Boyuan Yan | 8f9f6ad | 2019-06-12 16:54:42 -0700 | [diff] [blame] | 142 | String[] uuidSeg = uuid.split("-"); |
| 143 | PortNumber portNumber = PortNumber.portNumber(uuidSeg[uuidSeg.length - 1]); |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 144 | annotations.set(UUID, uuid); |
| 145 | |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 146 | JsonNode mcPool = sipAttributes.get(MEDIA_CHANNEL_SERVICE_INTERFACE_POINT_SPEC).get(MC_POOL); |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 147 | // We get the first OCH signal as reported by the device. |
| 148 | OchSignal ochSignal = getOchSignal(mcPool).iterator().next(); |
| 149 | //add och port |
| 150 | ports.add(ochPortDescription(portNumber, true, OduSignalType.ODU4, |
| 151 | false, ochSignal, annotations.build())); |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 152 | |
Diego Garcia | aab9947 | 2019-01-10 13:53:31 +0100 | [diff] [blame] | 153 | |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 154 | } else { |
| 155 | log.error("SIP {} is not valid", sipAttributes); |
| 156 | } |
| 157 | } |
| 158 | log.debug("PortList: {}", ports); |
| 159 | return ImmutableList.copyOf(ports); |
| 160 | } |
| 161 | |
| 162 | /** |
| 163 | * Create a filter method to identify just valid OLS SIPs.This method must check the |
| 164 | * tapi object: "layer-protocol-name" and matching only if equals to "PHOTONIC-MEDIA" SIPs. |
| 165 | * Moreover,the filtering could be enhanced by reading also: |
| 166 | * "supported-layer-protocol-qualifier", to identify valid protocol-qualifier values such: |
| 167 | * [PHOTONIC_LAYER_QUALIFIER_NMC, PHOTONIC_LAYER_QUALIFIER_NMCA, PHOTONIC_LAYER_QUALIFIER_OTSI...] |
| 168 | **/ |
| 169 | private boolean checkValidEndpoint(JsonNode sipAttributes) { |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 170 | return sipAttributes.has(LAYER_PROTOCOL_NAME) && |
| 171 | sipAttributes.get(LAYER_PROTOCOL_NAME).toString().contains(PHOTONIC_MEDIA) && |
| 172 | sipAttributes.has(SUPPORTED_LAYER_PROTOCOL_QUALIFIER) && |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 173 | sipAttributes.get(SUPPORTED_LAYER_PROTOCOL_QUALIFIER).toString() |
Andrea Campanella | b9e491b | 2019-02-18 17:45:01 +0100 | [diff] [blame] | 174 | .contains(PHOTONIC_LAYER_QUALIFIER_NMC); |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 175 | } |
| 176 | |
Diego Garcia | 09ab5e2 | 2018-12-18 11:47:01 +0100 | [diff] [blame] | 177 | } |