| # |
| # Copyright 2019 the original author or authors. |
| # |
| # Licensed under the Apache License, Version 2.0 (the "License"); |
| # you may not use this file except in compliance with the License. |
| # You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, software |
| # distributed under the License is distributed on an "AS IS" BASIS, |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| # See the License for the specific language governing permissions and |
| # limitations under the License. |
| # |
| import threading |
| import binascii |
| import grpc |
| import structlog |
| import time |
| from twisted.internet import reactor |
| from scapy.layers.l2 import Ether, Dot1Q |
| from transitions import Machine |
| |
| from voltha.protos.device_pb2 import Port |
| from voltha.protos.common_pb2 import ConnectStatus |
| from voltha.registry import registry |
| from voltha.adapters.openolt.protos import openolt_pb2_grpc, openolt_pb2 |
| from voltha.adapters.openolt.openolt_utils import OpenoltUtils |
| from voltha.extensions.alarms.onu.onu_discovery_alarm import OnuDiscoveryAlarm |
| |
| |
| class OpenoltDevice(object): |
| """ |
| OpenoltDevice state machine: |
| |
| null ----> init ------> connected -----> up -----> down |
| ^ ^ | ^ | | |
| | | | | | | |
| | +-------------+ +---------+ | |
| | | |
| +-----------------------------------------+ |
| """ |
| # pylint: disable=too-many-instance-attributes |
| # pylint: disable=R0904 |
| states = [ |
| 'state_null', |
| 'state_init', |
| 'state_connected', |
| 'state_up', |
| 'state_down'] |
| |
| transitions = [ |
| {'trigger': 'go_state_init', |
| 'source': ['state_null', 'state_connected', 'state_down'], |
| 'dest': 'state_init', |
| 'before': 'do_state_init', |
| 'after': 'post_init'}, |
| {'trigger': 'go_state_connected', |
| 'source': 'state_init', |
| 'dest': 'state_connected', |
| 'before': 'do_state_connected'}, |
| {'trigger': 'go_state_up', |
| 'source': ['state_connected', 'state_down'], |
| 'dest': 'state_up', |
| 'before': 'do_state_up'}, |
| {'trigger': 'go_state_down', |
| 'source': ['state_up'], |
| 'dest': 'state_down', |
| 'before': 'do_state_down', |
| 'after': 'post_down'}] |
| |
| def __init__(self, **kwargs): |
| super(OpenoltDevice, self).__init__() |
| |
| self.admin_state = "up" |
| |
| self.adapter_agent = kwargs['adapter_agent'] |
| self.device_num = kwargs['device_num'] |
| device = kwargs['device'] |
| |
| self.data_model_class = kwargs['support_classes']['data_model'] |
| self.platform_class = kwargs['support_classes']['platform'] |
| self.platform = self.platform_class() |
| self.resource_mgr_class = kwargs['support_classes']['resource_mgr'] |
| self.flow_mgr_class = kwargs['support_classes']['flow_mgr'] |
| self.alarm_mgr_class = kwargs['support_classes']['alarm_mgr'] |
| self.stats_mgr_class = kwargs['support_classes']['stats_mgr'] |
| self.bw_mgr_class = kwargs['support_classes']['bw_mgr'] |
| |
| is_reconciliation = kwargs.get('reconciliation', False) |
| self.device_id = device.id |
| self.host_and_port = device.host_and_port |
| self.extra_args = device.extra_args |
| self.log = structlog.get_logger(id=self.device_id, |
| ip=self.host_and_port) |
| self.proxy = registry('core').get_proxy('/') |
| |
| self.log.info('openolt-device-init') |
| |
| if not is_reconciliation: |
| self.log.info('create data model') |
| self.data_model = self.data_model_class(device, |
| self.adapter_agent, |
| self.platform) |
| else: |
| self.log.info('reconcile data model') |
| assert device.parent_id is not None |
| assert self.data_model is not None |
| self.data_model.reconcile() |
| |
| # Initialize the OLT state machine |
| self.machine = Machine(model=self, states=OpenoltDevice.states, |
| transitions=OpenoltDevice.transitions, |
| send_event=True, initial='state_null') |
| |
| self.device_info = None |
| |
| self.go_state_init() |
| |
| def do_state_init(self, event): |
| # Initialize gRPC |
| self.channel = grpc.insecure_channel(self.host_and_port) |
| self.channel_ready_future = grpc.channel_ready_future(self.channel) |
| |
| self.log.info('openolt-device-created', device_id=self.device_id) |
| |
| def post_init(self, event): |
| self.log.debug('post_init') |
| |
| # We have reached init state, starting the indications thread |
| |
| # Catch RuntimeError exception |
| try: |
| # Start indications thread |
| self.indications_thread_handle = threading.Thread( |
| target=self.indications_thread) |
| # Old getter/setter API for daemon; use it directly as a |
| # property instead. The Jinkins error will happon on the reason of |
| # Exception in thread Thread-1 (most likely raised # during |
| # interpreter shutdown) |
| self.indications_thread_handle.setDaemon(True) |
| self.indications_thread_handle.start() |
| except Exception as e: |
| self.log.exception('post_init failed', e=e) |
| |
| def do_state_connected(self, event): |
| self.log.debug("do_state_connected") |
| |
| # Check that device_info was successfully retrieved |
| assert(self.device_info is not None |
| and self.device_info.device_serial_number is not None |
| and self.device_info.device_serial_number != '') |
| |
| self.data_model.olt_create(self.device_info) |
| |
| self.resource_mgr = self.resource_mgr_class(self.device_id, |
| self.host_and_port, |
| self.extra_args, |
| self.device_info) |
| self.flow_mgr = self.flow_mgr_class(self.adapter_agent, self.log, |
| self.stub, self.device_id, |
| self.data_model.logical_device_id, |
| self.platform, self.resource_mgr) |
| |
| self.alarm_mgr = self.alarm_mgr_class( |
| self.log, self.adapter_agent, self.device_id, |
| self.data_model.logical_device_id, self.platform) |
| self.stats_mgr = self.stats_mgr_class(self, self.log, self.platform) |
| self.bw_mgr = self.bw_mgr_class(self.log, self.proxy) |
| |
| def do_state_up(self, event): |
| self.log.debug("do_state_up") |
| self.data_model.olt_oper_up() |
| |
| def do_state_down(self, event): |
| self.log.debug("do_state_down") |
| self.data_model.olt_oper_down() |
| |
| def post_down(self, event): |
| self.log.debug('post_down') |
| self.flow_mgr.reset_flows() |
| |
| def indications_thread(self): |
| self.log.debug('starting-indications-thread') |
| self.log.debug('connecting to olt', device_id=self.device_id) |
| |
| self.stub = openolt_pb2_grpc.OpenoltStub(self.channel) |
| |
| timeout = 60*60 |
| delay = 1 |
| exponential_back_off = False |
| while True: |
| try: |
| self.device_info = self.stub.GetDeviceInfo(openolt_pb2.Empty()) |
| break |
| except Exception as e: |
| if delay > timeout: |
| self.log.error("timed out connecting to olt") |
| return |
| else: |
| self.log.warn("retry connecting to olt in %ds: %s" |
| % (delay, repr(e))) |
| time.sleep(delay) |
| if exponential_back_off: |
| delay += delay |
| else: |
| delay += 1 |
| |
| self.log.info('connected to olt', device_info=self.device_info) |
| |
| self.go_state_connected() |
| |
| self.indications = self.stub.EnableIndication(openolt_pb2.Empty()) |
| |
| while True: |
| try: |
| # get the next indication from olt |
| ind = next(self.indications) |
| except Exception as e: |
| self.log.warn('gRPC connection lost', error=e) |
| reactor.callFromThread(self.go_state_down) |
| reactor.callFromThread(self.go_state_init) |
| break |
| else: |
| self.log.debug("rx indication", indication=ind) |
| |
| if self.admin_state is "down": |
| if ind.HasField('intf_oper_ind') \ |
| and (ind.intf_oper_ind.type == "nni"): |
| self.log.warn('olt is admin down, allow nni ind', |
| admin_state=self.admin_state, |
| indications=ind) |
| else: |
| self.log.warn('olt is admin down, ignore indication', |
| admin_state=self.admin_state, |
| indications=ind) |
| continue |
| |
| # indication handlers run in the main event loop |
| if ind.HasField('olt_ind'): |
| reactor.callFromThread(self.olt_indication, ind.olt_ind) |
| elif ind.HasField('intf_ind'): |
| reactor.callFromThread(self.intf_indication, ind.intf_ind) |
| elif ind.HasField('intf_oper_ind'): |
| reactor.callFromThread(self.intf_oper_indication, |
| ind.intf_oper_ind) |
| elif ind.HasField('onu_disc_ind'): |
| reactor.callFromThread(self.onu_discovery_indication, |
| ind.onu_disc_ind) |
| elif ind.HasField('onu_ind'): |
| reactor.callFromThread(self.onu_indication, ind.onu_ind) |
| elif ind.HasField('omci_ind'): |
| reactor.callFromThread(self.omci_indication, ind.omci_ind) |
| elif ind.HasField('pkt_ind'): |
| reactor.callFromThread(self.packet_indication, ind.pkt_ind) |
| elif ind.HasField('port_stats'): |
| reactor.callFromThread( |
| self.stats_mgr.port_statistics_indication, |
| ind.port_stats) |
| elif ind.HasField('flow_stats'): |
| reactor.callFromThread( |
| self.stats_mgr.flow_statistics_indication, |
| ind.flow_stats) |
| elif ind.HasField('alarm_ind'): |
| reactor.callFromThread(self.alarm_mgr.process_alarms, |
| ind.alarm_ind) |
| else: |
| self.log.warn('unknown indication type') |
| |
| def olt_indication(self, olt_indication): |
| if olt_indication.oper_state == "up": |
| self.go_state_up() |
| elif olt_indication.oper_state == "down": |
| self.go_state_down() |
| |
| def intf_indication(self, intf_indication): |
| self.log.debug("intf indication", intf_id=intf_indication.intf_id, |
| oper_state=intf_indication.oper_state) |
| # NOTE - BAL only sends interface indications for PON ports, |
| # not for NNI ports. |
| self.data_model.olt_port_add_update(intf_indication.intf_id, |
| "pon", |
| intf_indication.oper_state) |
| |
| def intf_oper_indication(self, intf_oper_indication): |
| self.log.debug("Received interface oper state change indication", |
| intf_id=intf_oper_indication.intf_id, |
| type=intf_oper_indication.type, |
| oper_state=intf_oper_indication.oper_state) |
| self.data_model.olt_port_add_update(intf_oper_indication.intf_id, |
| intf_oper_indication.type, |
| intf_oper_indication.oper_state) |
| |
| def onu_discovery_indication(self, onu_disc_indication): |
| intf_id = onu_disc_indication.intf_id |
| serial_number = onu_disc_indication.serial_number |
| serial_number_str = OpenoltUtils.stringify_serial_number(serial_number) |
| |
| self.log.debug("onu discovery indication", intf_id=intf_id, |
| serial_number=serial_number_str) |
| |
| # Post ONU Discover alarm 20180809_0805 |
| try: |
| OnuDiscoveryAlarm(self.alarm_mgr.alarms, pon_id=intf_id, |
| serial_number=serial_number_str).raise_alarm() |
| except Exception as disc_alarm_error: |
| self.log.exception("onu-discovery-alarm-error", |
| errmsg=disc_alarm_error.message) |
| # continue for now. |
| |
| onu_id = self.data_model.onu_id(serial_number_str) |
| |
| if onu_id == 0: |
| onu_id = self.resource_mgr.get_onu_id(intf_id) |
| if onu_id is None: |
| raise Exception("onu-id-unavailable") |
| |
| self.data_model.onu_create(intf_id, onu_id, serial_number_str) |
| |
| self.activate_onu(intf_id, onu_id, serial_number, serial_number_str) |
| |
| def onu_indication(self, onu_indication): |
| self.log.debug("onu indication", intf_id=onu_indication.intf_id, |
| onu_id=onu_indication.onu_id, |
| serial_number=onu_indication.serial_number, |
| oper_state=onu_indication.oper_state, |
| admin_state=onu_indication.admin_state) |
| |
| # Admin state |
| if onu_indication.admin_state == 'down': |
| if onu_indication.oper_state != 'down': |
| self.log.error('ONU-admin-state-down-and-oper-status-not-down', |
| oper_state=onu_indication.oper_state) |
| # Forcing the oper state change code to execute |
| onu_indication.oper_state = 'down' |
| |
| # Port and logical port update is taken care of by oper state block |
| |
| self.log.debug('admin-state-dealt-with') |
| |
| # Operating state |
| if onu_indication.oper_state == 'down': |
| self.data_model.onu_oper_down(onu_indication.intf_id, |
| onu_indication.onu_id) |
| |
| elif onu_indication.oper_state == 'up': |
| self.data_model.onu_oper_up(onu_indication.intf_id, |
| onu_indication.onu_id) |
| |
| def omci_indication(self, omci_indication): |
| |
| self.log.debug("omci indication", intf_id=omci_indication.intf_id, |
| onu_id=omci_indication.onu_id) |
| |
| onu_device = self.adapter_agent.get_child_device( |
| self.device_id, onu_id=omci_indication.onu_id, |
| parent_port_no=self.platform.intf_id_to_port_no( |
| omci_indication.intf_id, Port.PON_OLT), ) |
| |
| self.adapter_agent.receive_proxied_message(onu_device.proxy_address, |
| omci_indication.pkt) |
| |
| def packet_indication(self, pkt_indication): |
| |
| self.log.debug("packet indication", |
| intf_type=pkt_indication.intf_type, |
| intf_id=pkt_indication.intf_id, |
| port_no=pkt_indication.port_no, |
| cookie=pkt_indication.cookie, |
| gemport_id=pkt_indication.gemport_id, |
| flow_id=pkt_indication.flow_id) |
| |
| if pkt_indication.intf_type == "pon": |
| if pkt_indication.port_no: |
| logical_port_num = pkt_indication.port_no |
| else: |
| # TODO Remove this else block after openolt device has been |
| # fully rolled out with cookie protobuf change |
| try: |
| onu_id_uni_id = self.resource_mgr. \ |
| get_onu_uni_from_ponport_gemport( |
| pkt_indication.intf_id, pkt_indication.gemport_id) |
| onu_id = int(onu_id_uni_id[0]) |
| uni_id = int(onu_id_uni_id[1]) |
| self.log.debug("packet indication-kv", onu_id=onu_id, |
| uni_id=uni_id) |
| if onu_id is None: |
| raise Exception("onu-id-none") |
| if uni_id is None: |
| raise Exception("uni-id-none") |
| logical_port_num = self.platform.mk_uni_port_num( |
| pkt_indication.intf_id, onu_id, uni_id) |
| except Exception as e: |
| self.log.error("no-onu-reference-for-gem", |
| gemport_id=pkt_indication.gemport_id, e=e) |
| return |
| |
| elif pkt_indication.intf_type == "nni": |
| logical_port_num = self.platform.intf_id_to_port_no( |
| pkt_indication.intf_id, |
| Port.ETHERNET_NNI) |
| |
| pkt = Ether(pkt_indication.pkt) |
| |
| self.log.debug("packet indication", |
| logical_device_id=self.data_model.logical_device_id, |
| logical_port_no=logical_port_num) |
| |
| self.adapter_agent.send_packet_in( |
| logical_device_id=self.data_model.logical_device_id, |
| logical_port_no=logical_port_num, |
| packet=str(pkt)) |
| |
| def packet_out(self, egress_port, msg): |
| pkt = Ether(msg) |
| self.log.debug('packet out', egress_port=egress_port, |
| device_id=self.device_id, |
| logical_device_id=self.data_model.logical_device_id, |
| packet=str(pkt).encode("HEX")) |
| |
| # Find port type |
| egress_port_type = self.platform.intf_id_to_port_type_name(egress_port) |
| if egress_port_type == Port.ETHERNET_UNI: |
| |
| if pkt.haslayer(Dot1Q): |
| outer_shim = pkt.getlayer(Dot1Q) |
| if isinstance(outer_shim.payload, Dot1Q): |
| # If double tag, remove the outer tag |
| payload = ( |
| Ether(src=pkt.src, dst=pkt.dst, |
| type=outer_shim.type) / |
| outer_shim.payload |
| ) |
| else: |
| payload = pkt |
| else: |
| payload = pkt |
| |
| send_pkt = binascii.unhexlify(str(payload).encode("HEX")) |
| |
| self.log.debug( |
| 'sending-packet-to-ONU', egress_port=egress_port, |
| intf_id=self.platform.intf_id_from_uni_port_num(egress_port), |
| onu_id=self.platform.onu_id_from_port_num(egress_port), |
| uni_id=self.platform.uni_id_from_port_num(egress_port), |
| port_no=egress_port, |
| packet=str(payload).encode("HEX")) |
| |
| onu_pkt = openolt_pb2.OnuPacket( |
| intf_id=self.platform.intf_id_from_uni_port_num(egress_port), |
| onu_id=self.platform.onu_id_from_port_num(egress_port), |
| port_no=egress_port, |
| pkt=send_pkt) |
| |
| self.stub.OnuPacketOut(onu_pkt) |
| |
| elif egress_port_type == Port.ETHERNET_NNI: |
| self.log.debug('sending-packet-to-uplink', egress_port=egress_port, |
| packet=str(pkt).encode("HEX")) |
| |
| send_pkt = binascii.unhexlify(str(pkt).encode("HEX")) |
| |
| uplink_pkt = openolt_pb2.UplinkPacket( |
| intf_id=self.platform.intf_id_from_nni_port_num(egress_port), |
| pkt=send_pkt) |
| |
| self.stub.UplinkPacketOut(uplink_pkt) |
| |
| else: |
| self.log.warn('Packet-out-to-this-interface-type-not-implemented', |
| egress_port=egress_port, |
| port_type=egress_port_type) |
| |
| def send_proxied_message(self, proxy_address, msg): |
| onu_device = self.adapter_agent.get_child_device( |
| self.device_id, onu_id=proxy_address.onu_id, |
| parent_port_no=self.platform.intf_id_to_port_no( |
| proxy_address.channel_id, Port.PON_OLT) |
| ) |
| if onu_device.connect_status != ConnectStatus.REACHABLE: |
| self.log.debug('ONU is not reachable, cannot send OMCI', |
| serial_number=onu_device.serial_number, |
| intf_id=onu_device.proxy_address.channel_id, |
| onu_id=onu_device.proxy_address.onu_id) |
| return |
| omci = openolt_pb2.OmciMsg(intf_id=proxy_address.channel_id, |
| onu_id=proxy_address.onu_id, pkt=str(msg)) |
| self.stub.OmciMsgOut(omci) |
| |
| def update_flow_table(self, flows): |
| self.log.debug('No updates here now, all is done in logical flows ' |
| 'update') |
| |
| def update_logical_flows(self, flows_to_add, flows_to_remove, |
| device_rules_map): |
| if not self.is_state_up(): |
| self.log.info('The OLT is not up, we cannot update flows', |
| flows_to_add=[f.id for f in flows_to_add], |
| flows_to_remove=[f.id for f in flows_to_remove]) |
| return |
| |
| try: |
| self.flow_mgr.update_children_flows(device_rules_map) |
| except Exception as e: |
| self.log.error('Error updating children flows', error=e) |
| |
| self.log.debug('logical flows update', flows_to_add=flows_to_add, |
| flows_to_remove=flows_to_remove) |
| |
| for flow in flows_to_add: |
| |
| try: |
| self.flow_mgr.add_flow(flow) |
| except Exception as e: |
| self.log.error('failed to add flow', flow=flow, e=e) |
| |
| for flow in flows_to_remove: |
| |
| try: |
| self.flow_mgr.remove_flow(flow) |
| except Exception as e: |
| self.log.error('failed to remove flow', flow=flow, e=e) |
| |
| self.flow_mgr.repush_all_different_flows() |
| |
| def disable(self): |
| self.log.debug('sending-deactivate-olt-message', |
| device_id=self.device_id) |
| |
| try: |
| # Send grpc call |
| self.stub.DisableOlt(openolt_pb2.Empty()) |
| self.admin_state = "down" |
| self.log.info('openolt device disabled') |
| except Exception as e: |
| self.log.error('Failure to disable openolt device', error=e) |
| |
| def delete(self): |
| self.log.info('deleting-olt', device_id=self.device_id, |
| logical_device_id=self.data_model.logical_device_id) |
| |
| # Clears up the data from the resource manager KV store |
| # for the device |
| del self.resource_mgr |
| |
| try: |
| # Rebooting to reset the state |
| self.reboot() |
| self.data_model.olt_delete() |
| del self.data_model |
| except Exception as e: |
| self.log.error('Failure to delete openolt device', error=e) |
| raise e |
| else: |
| self.log.info('successfully-deleted-olt', device_id=self.device_id) |
| |
| def reenable(self): |
| self.log.debug('reenabling-olt', device_id=self.device_id) |
| |
| try: |
| self.stub.ReenableOlt(openolt_pb2.Empty()) |
| except Exception as e: |
| self.log.error('Failure to reenable openolt device', error=e) |
| else: |
| self.log.info('openolt device reenabled') |
| self.admin_state = "up" |
| |
| def activate_onu(self, intf_id, onu_id, serial_number, |
| serial_number_str): |
| pir = self.bw_mgr.pir(serial_number_str) |
| self.log.debug("activating-onu", intf_id=intf_id, onu_id=onu_id, |
| serial_number_str=serial_number_str, |
| serial_number=serial_number, pir=pir) |
| onu = openolt_pb2.Onu(intf_id=intf_id, onu_id=onu_id, |
| serial_number=serial_number, pir=pir) |
| try: |
| self.stub.ActivateOnu(onu) |
| except grpc.RpcError as grpc_e: |
| if grpc_e.code() == grpc.StatusCode.ALREADY_EXISTS: |
| self.log.info('onu activation in progress', |
| serial_number=serial_number_str, |
| e=grpc_e) |
| else: |
| self.log.error('onu activation failed', |
| serial_number=serial_number_str, |
| grpc_error=grpc_e) |
| else: |
| self.log.info('onu-activated', serial_number=serial_number_str) |
| |
| # FIXME - instead of passing child_device around, delete_child_device |
| # needs to change to use serial_number. |
| def delete_child_device(self, child_device): |
| self.log.debug('sending-deactivate-onu', |
| olt_device_id=self.device_id, |
| onu_device=child_device, |
| onu_serial_number=child_device.serial_number) |
| |
| self.data_model.onu_delete(child_device.serial_number) |
| |
| # TODO FIXME - For each uni. |
| # TODO FIXME - Flows are not deleted |
| uni_id = 0 # FIXME |
| try: |
| self.flow_mgr.delete_tech_profile_instance( |
| child_device.proxy_address.channel_id, |
| child_device.proxy_address.onu_id, |
| uni_id, None) |
| except Exception as e: |
| self.log.exception("error-removing-tp-instance") |
| |
| try: |
| pon_intf_id_onu_id = (child_device.proxy_address.channel_id, |
| child_device.proxy_address.onu_id, |
| uni_id) |
| # Free any PON resources that were reserved for the ONU |
| self.resource_mgr.free_pon_resources_for_onu(pon_intf_id_onu_id) |
| except Exception as e: |
| self.log.exception("error-removing-pon-resources-for-onu") |
| |
| serial_number = OpenoltUtils.destringify_serial_number( |
| child_device.serial_number) |
| try: |
| onu = openolt_pb2.Onu( |
| intf_id=child_device.proxy_address.channel_id, |
| onu_id=child_device.proxy_address.onu_id, |
| serial_number=serial_number) |
| self.stub.DeleteOnu(onu) |
| except Exception as e: |
| self.log.exception("error-deleting-the-onu-on-olt-device", error=e) |
| |
| def reboot(self): |
| self.log.debug('rebooting openolt device', device_id=self.device_id) |
| try: |
| self.stub.Reboot(openolt_pb2.Empty()) |
| except Exception as e: |
| self.log.error('something went wrong with the reboot', error=e) |
| else: |
| self.log.info('device rebooted') |
| |
| def trigger_statistics_collection(self): |
| try: |
| self.stub.CollectStatistics(openolt_pb2.Empty()) |
| except Exception as e: |
| self.log.error('Error while triggering statistics collection', |
| error=e) |
| else: |
| self.log.info('statistics requested') |
| |
| def simulate_alarm(self, alarm): |
| self.alarm_mgr.simulate_alarm(alarm) |