########################################################################### # # Copyright (c) 2021-2025 Diality Inc. - All Rights Reserved. # # THIS CODE MAY NOT BE COPIED OR REPRODUCED IN ANY FORM, IN PART OR IN # WHOLE, WITHOUT THE EXPLICIT PERMISSION OF THE COPYRIGHT OWNER. # # @file events.py # # @author (last) Jonny Paguio # @date (last) 16-Sep-2025 # @author (original) Dara Navaei # @date (original) 12-Oct-2021 # ############################################################################ import struct from logging import Logger from leahi_dialin.common import * from leahi_dialin.common.msg_defs import MsgIds, MsgFieldPositions from leahi_dialin.protocols.CAN import DenaliChannels from leahi_dialin.utils.base import AbstractSubSystem, publish from datetime import datetime from time import time class FPEvents(AbstractSubSystem): """ FP Dialin API sub-class for events related commands. """ UNKNOWN_STATE = "UNKNOWN_PREVIOUS_STATE" def __init__(self, can_interface, logger: Logger): """ @param can_interface: Denali CAN Messenger object """ super().__init__() self.can_interface = can_interface self.logger = logger self.fp_events_timestamp = 0.0 self.fp_event_op_mode = 0 self.fp_event_sub_mode = 0 self.fp_event_op_mode_timestamp = 0.0 if self.can_interface is not None: channel_id = DenaliChannels.fp_sync_broadcast_ch_id self.msg_id_fp_event = MsgIds.MSG_ID_FP_EVENT.value self.can_interface.register_receiving_publication_function(channel_id, self.msg_id_fp_event, self._handler_events_sync) channel_id = DenaliChannels.fp_sync_broadcast_ch_id self.msg_id_fp_op_mode_data = MsgIds.MSG_ID_FP_OP_MODE_DATA.value self.can_interface.register_receiving_publication_function(channel_id, self.msg_id_fp_op_mode_data, self._handler_fp_op_mode_sync) # Define the dictionaries self._fp_event_dictionary = dict() self._fp_event_data_type = dict() # Dictionary of the mode as key and the sub mode states enum class as the value self._fp_op_mode_2_sub_mode = {FPOpModes.MODE_FAUL.name: FPFaultStates, FPOpModes.MODE_SERV.name: FPServiceStates, FPOpModes.MODE_INIT.name: FPPostStates, FPOpModes.MODE_STAN.name: FPStandbyStates, FPOpModes.MODE_PRE_GENP.name: FPPreGenPermeateStates, FPOpModes.MODE_GENP.name: FPGenPermeateStates, FPOpModes.MODE_DPGP.name: FPPreGenPDefStates, FPOpModes.MODE_DEGP.name: FPGenPermeateDefStates, FPOpModes.MODE_NLEG.name: FPNotLegalStates} # Loop through the list of the FP events enums and initial the event dictionary. Each event is a key in the # dictionary and the value is a list. for event in FPEventList: self._fp_event_dictionary[FPEventList(event).name] = [] # Loop through the list of the event data type enum and update the dictionary for data_type in FPEventDataType: event_data_type = FPEventDataType(data_type).name struct_unpack_type = None # If U32 is in the data type enum (i.e. EVENT_DATA_TYPE_U32), then the key is the enum and the value is # the corresponding format in the python struct if 'U32' in event_data_type or 'BOOL' in event_data_type: struct_unpack_type = 'I' elif 'S32' in event_data_type: struct_unpack_type = 'i' elif 'F32' in event_data_type: struct_unpack_type = 'f' self._fp_event_data_type[event_data_type] = struct_unpack_type def get_fp_nth_event(self, event_id, event_number=0): """ Returns the nth requested FP event @param event_id the ID of the FP event types (i.e. FP_EVENT_STARTUP) @param event_number the event number that is requested. The default is 0 meaning the last occurred event @returns the requested FP event number """ list_length = len(self._fp_event_dictionary[FPEventList(event_id).name]) if list_length == 0: event = [] elif event_number > list_length: event = self._fp_event_dictionary[FPEventList(event_id).name][list_length - 1] else: event = self._fp_event_dictionary[FPEventList(event_id).name][list_length - event_number - 1] return event def clear_fp_event_list(self): """ Clears the FP event list @returns none """ for key in self._fp_event_dictionary: self._fp_event_dictionary[key].clear() def get_fp_events(self, event_id, number_of_events=1): """ Returns the requested number of a certain FP event ID @param event_id the ID of the FP event types (i.e. FP_EVENT_STARTUP) @param number_of_events the last number of messages of a certain event type @returns a list of the requested FP event type """ list_of_events = [] # If there are not enough event lists send all the events that are available if len(self._fp_event_dictionary[FPEventList(event_id).name]) <= number_of_events: list_of_events = self._fp_event_dictionary[FPEventList(event_id).name] else: # Get the all the events complete_list = self._fp_event_dictionary[FPEventList(event_id).name] # Since the last are located at the end of the list, iterate backwards for the defined # event messages for i in range(len(complete_list) - 1, len(complete_list) - number_of_events - 1, -1): list_of_events.append(complete_list[i]) if number_of_events == 0: list_of_events = self._fp_event_dictionary[FPEventList(event_id).name] return list_of_events @publish(["msg_id_fp_event", "fp_events_timestamp", '_fp_event_dictionary']) def _handler_events_sync(self, message, timestamp=0.0): """ Handles published events message @param message: published FP events data message @returns none """ event_data_1 = 0 event_data_2 = 0 op_mode = 0 sub_mode = 0 sub_state = 0 current_sub_tuple = [] event_id = struct.unpack('i', bytearray( message['message'][MsgFieldPositions.START_POS_FIELD_1:MsgFieldPositions.END_POS_FIELD_1]))[0] if event_id == FPEventList.FP_EVENT_OPERATION_STATUS.value: # Get the data type event_data_type_1 = struct.unpack('i', bytearray( message['message'][MsgFieldPositions.START_POS_FIELD_2:MsgFieldPositions.END_POS_FIELD_2]))[0] struct_data_type = self._fp_event_data_type[FPEventDataType(event_data_type_1).name] op_mode = struct.unpack(' current_sub_mode_timestamp: # If the previous and current of the last two tuples do not match, then an operation mode transition # has occurred and the previous state is converted from the previous class and the current op mode # is converted from current operation states enum class. # i.e last = (timestamp, event type, 3, 8) and one before = (timestamp, event type, 8, 3) # previous and current do not match so in the last type (timestamp, event type, 8, 3) the prev state # should be from op mode 8 and the current state should be from op mode 3 previous_op_mode = last_op_tuple[len(last_op_tuple) - 2] if previous_op_mode != FPEvents.UNKNOWN_STATE: previous_sub_mode_enum_class = self._fp_op_mode_2_sub_mode[previous_op_mode] event_data_1 = previous_sub_mode_enum_class(event_data_1).name # Unknown previous state. Display value instead of name. else: event_data_1 = str(event_data_1) event_data_2 = current_sub_mode_enum_class(event_data_2).name else: if event_data_2 != 0: event_data_1 = current_sub_mode_enum_class(event_data_1).name event_data_2 = current_sub_mode_enum_class(event_data_2).name else: previous_sub_mode = current_sub_tuple[len(current_sub_tuple) - 2] previous_sub_mode_enum_class = self._fp_op_mode_2_sub_mode[previous_sub_mode] event_data_1 = previous_sub_mode_enum_class(event_data_1).name event_data_2 = current_sub_mode_enum_class(event_data_2).name event_tuple = (datetime.now().astimezone().strftime('%Y-%m-%d %H:%M:%S.%f'), event_state_name, event_data_1, event_data_2) elif event_state_name == FPEventList.FP_EVENT_OPERATION_STATUS.name: event_tuple = (time(), op_mode, sub_mode, sub_state) # Update event dictionary self._fp_event_dictionary[event_state_name].append(event_tuple) self.fp_events_timestamp = timestamp @publish(["msg_id_fp_op_mode_data", "fp_event_op_mode_timestamp", "fp_event_op_mode", "fp_event_sub_mode"]) def _handler_fp_op_mode_sync(self, message, timestamp=0.0): """ Handles published FP operation mode messages. Current FP operation mode is captured for reference. @param message: published FP operation mode broadcast message @return: None """ mode = struct.unpack('i', bytearray( message['message'][MsgFieldPositions.START_POS_FIELD_1:MsgFieldPositions.END_POS_FIELD_1])) smode = struct.unpack('i', bytearray( message['message'][MsgFieldPositions.START_POS_FIELD_2:MsgFieldPositions.END_POS_FIELD_2])) self.fp_event_op_mode = mode[0] self.fp_event_sub_mode = smode[0] self.fp_event_op_mode_timestamp = timestamp