Error_handling.h

Go to the documentation of this file.

/*----------------------------------------------------------------------------
 * Name:    Error_handling.h
 * Purpose: Funzioni e variabili per la gestione degli errori
 * Version: V1.00
 * Note(s):
 *----------------------------------------------------------------------------
 * History:
 *          
 *----------------------------------------------------------------------------*/
 
/// \file
 
 /************Elenco variabili**************************************************/
 
 #include "stdint.h"
 
 extern volatile unsigned int   flag_error_verified; //Alla verifica di un qualsiasi errore questo flag viene posto ad 1, 0 altrimenti
 extern volatile unsigned int flag_error_verified_at_startup; //Alla cerifica di un qualsiasi errore questo flag viene posto ad 1, 0 altrimenti
 extern volatile unsigned char  flag_error_acknowledged ; //Il flag di errore veirifcato e tutti gli errori vengono resettati perch\'e acquisiti
 extern volatile unsigned char  last_error_address;  //The address of the last verified error
 extern volatile unsigned char last_code_to_shift;  //The shift bit of the last error
 extern volatile unsigned char last_error_address_at_startup;  //The address of the last verified error
 extern volatile unsigned char last_code_to_shift_at_startup;  //The shift bit of the last error
 extern volatile unsigned char can_send_error; //Error are notified via can if =1; not notified if =0
 
extern volatile uint32_t Error_good_operation;
extern volatile uint32_t Error_bad_operation;
 
 
 //Here the meaning of the flags withinthe elements of the vector.
 //Obviously, bit=0 means no-error, bit=1 means error
 //The elements here is the number of shifts of the flag on the left.
 //Example, suppose that Error_ADC_whatever is the third bit of Error_ADC0. We have to write:
 // Post_frontend_errors[ Error_ADC0 ] |= (1 << Error_ADC_whatever) ;
 
//! Here the indexes of the errors of the vector Post_frontend_errors
/*! Register Address for errors */
enum ERROR_CROSS_address_ {
    error_address_reg_ADC0,                                     ///< Error register for ADC0    
    error_address_reg_ADC1,                                     ///< Error register for ADC1    
    
    error_address_Power_Supply_in_General,      ///< Error register for channel power supplies
    
    error_address_I2C0 ,                                            ///< Error register A for I2C0
    error_address_I2C0_B ,                                              ///< Error register B for I2C0  
    error_address_I2C1,                                             ///< Error register A for I2C1  
    error_address_I2C1_B,                                           ///< Error register B for I2C1      
    
    error_address_SPI,                                              ///< Error register for SPI
    
    error_preamplifier_down,                ///< Error register preamflifier board down
    error_preamplifier_up,                  ///< Error register preamflifier board up
    
  error_address_CAN ,                                               ///< Error register for CAN bus 
    
  error_address_PGA_DetectorTrimmer_down    ,               ///< Error register for on board PGA/detector trimmer   
  error_address_PGA_DetectorTrimmer_up  ,               ///< Error register for on board PGA/detector trimmer   
    
    error_address_DAC_Trimmer_Pre_Detector_supply,    ///< Error register for preaamplifer and detector power supplies
 
    error_address_Bias_adjustment,                                      ///< Error register for channel detector bias adjustment
    error_number_of_errors_registers,                               ///< Number of errors (this is not an addres)
    error_offset_for_board_up=15                                            ///< =15, First addresss for board up errors
}; 
 
 // Erro vector: all'occorrenza di un errore si alza il bit corriposndente
 extern unsigned int Post_frontend_errors[error_number_of_errors_registers + error_offset_for_board_up];  ///< Vector that lists the flag registers. 
                                                            //First half for board down, second half for board up
 extern unsigned int Post_frontend_errors_copy[error_number_of_errors_registers+error_offset_for_board_up];  
 
 extern char flag_error_verified_vecchio;
 extern unsigned char  last_error_address_vecchio;
 
//Flags for "error_address_reg_ADCx, x=0,1":
//Flag errors rotation for ADC
enum ERROR_ADC_{
    ADC_internal_General_fails,                         ///< ADC general fault
    ADC_SPI_fault,                                                  ///< SPI Communication fault
    ADC_RDY_pin_fault,                                          ///< ADC ready not received
    ADC_RDY_pin_fault_during_calibration,       ///< ADC ready not during calibration
    VREF_ADC_too_small,                                         ///< ADC VREF measured out of its tolerance, too small
    VREF_ADC_too_large,                                         ///< ADC VREF measured out of its tolerance, too large
    ADC_external_fails                                          ///< measurement form an external ADC went wrong
};
 
//Flags for "error_address_Power_Supply_in_General", positive and negative
//Flag errors rotation for Vbol for switching
enum ERROR_BIAS_POWER_SUPPLY_{
 Vbol_pos_small_for_switching,          ///< Positive Vbol too small for switching from internal to external power or vice-versa
 Vbol_pos_large_for_switching,          ///< Positive Vbol too large for switching from internal to external power or vice-versa
 Vbol_neg_small_for_switching,          ///< Negative Vbol too small for switching from internal to external power or vice-versa
 Vbol_neg_large_for_switching,          ///< Negative Vbol too large for switching from internal to external power or vice-versa
//Flag errors rotation for Vbol limiting values
 Vbol_pos_too_large,                                ///< Positive Vbol exceeds the maximum
 Vbol_pos_too_small,                                ///< Positive Vbol is below the lower limit
 Vbol_neg_too_large,                                ///< Negative Vbol exceeds the maximum
 Vbol_neg_too_small,                                ///< Negative Vbol is below the lower limit
 //Flag errors rotation for VREF_POS_PRE
 Vref_pos_too_large,                                ///< Positive Vref too large
 Vref_pos_too_small,                                ///< Positive Vref too small
//Flag errors rotation for VREF_NEG_PRE
 Vref_neg_absolute_val_too_large,       ///< Negative Vref too large
 Vref_neg_absolute_val_too_small,       ///< Negative Vref too small
//Flag errors rotation for VCC_PRE
 VCC_PRE_pos_too_large,                         ///< Positive supply for preamplifier too large
 VCC_PRE_pos_too_small,                         ///< Positive supply for preamplifier too small
//Flag errors rotation for VEE_PRE
 VEE_PRE_absolute_val_too_large,        ///< Negative supply for preamplifier too large
 VEE_PRE_absolute_val_too_small,        ///< Negative supply for preamplifier too small
//Flag errors rotation for VCC_PGA
 VCC_PGA_pos_too_large,                       ///< Positive supply for PGA too large
 VCC_PGA_pos_too_small,                         ///< Positive supply for PGA too small
//Flag errors rotation for VEE_PGA
 VEE_PGA_absolute_val_too_large,     ///< Negative supply for PGA too large
 VEE_PGA_absolute_val_too_small,   ///< Negative supply for PGA too small
//Flag errors rotation for V__dig_5V
 V__dig_5V_val_too_large,               ///< Digital 5 V supply too large
 V__dig_5V_val_too_small,               ///< Digital 5 V supply too small
//Flag errors rotation for V__dig_3e3V
 V__dig_3e3V_val_too_large,             ///< Digital 3.3 V supply too large
 V__dig_3e3V_val_too_small           ///< Digital 3.3 V supply too small
};
 
 
//Flag errors for I2C error_address_I2C0 and I2C1, the same enum
enum ERROR_I2C_A{
 
 I2C_Error_EVENT_TRANSFER_DONE,             ///< I2C communications trouble
 I2C_Error_EVENT_TRANSFER_INCOMPLETE,   ///< I2C communications trouble
 I2C_Error_EVENT_SLAVE_TRANSMIT,        ///< I2C communications trouble
 I2C_Error_EVENT_SLAVE_RECEIVE,         ///< I2C communications trouble
 I2C_Error_EVENT_ADDRESS_NACK,          ///< I2C communications trouble
 I2C_Error_NONE,                                            ///< I2C communications trouble
 I2C_Error_EVENT_ARBITRATION_LOST,          ///< I2C communications trouble
 I2C_Error_EVENT_BUS_ERROR,                         ///< I2C communications trouble
 I2C_Error_EVENT_BUS_CLEAR,                         ///< I2C communications trouble
    
 I2C_Error_I2C_mux,                                         ///< Trouble with I2C mux communication
    
 I2C_Error_I2C_to_parallel_PCA9554_0,       ///< I2C to parallel conversion ch0
 I2C_Error_I2C_to_parallel_PCA9554_1,       ///< I2C to parallel conversion ch1
 I2C_Error_I2C_to_parallel_PCA9554_2,       ///< I2C to parallel conversion ch2
 I2C_Error_I2C_to_parallel_PCA9554_3,       ///< I2C to parallel conversion ch3
// I2C_Error_I2C_to_parallel_PCA9554_4,     ///< I2C to parallel conversion ch4
// I2C_Error_I2C_to_parallel_PCA9554_5,     ///< I2C to parallel conversion ch5 
// I2C_Error_I2C_to_parallel_PCA9554_6,     ///< I2C to parallel conversion ch6 
// I2C_Error_I2C_to_parallel_PCA9554_7,     ///< I2C to parallel conversion ch7 
// I2C_Error_I2C_to_parallel_PCA9554_8,     ///< I2C to parallel conversion ch8 
// I2C_Error_I2C_to_parallel_PCA9554_9,     ///< I2C to parallel conversion ch9 
// I2C_Error_I2C_to_parallel_PCA9554_10,    ///< I2C to parallel conversion ch10    
// I2C_Error_I2C_to_parallel_PCA9554_11,    ///< I2C to parallel conversion ch11
 
 I2C_Error_trimmer_0,       ///< trimmer ch0
 I2C_Error_trimmer_1,       ///< trimmer ch1
 I2C_Error_trimmer_2,       ///< trimmer ch2
 I2C_Error_trimmer_3,       ///< trimmer ch3
 I2C_Error_trimmer_4,       ///< trimmer ch4
 I2C_Error_trimmer_5,       ///< trimmer ch5    
// I2C_Error_trimmer_6,     ///< trimmer ch6    
// I2C_Error_trimmer_7,     ///< trimmer ch7    
// I2C_Error_trimmer_8,     ///< trimmer ch8    
// I2C_Error_trimmer_9,     ///< trimmer ch9    
// I2C_Error_trimmer_10,    ///< trimmer ch10   
// I2C_Error_trimmer_11,    ///< trimmer ch11
 
 I2C_error_EPROM_0,     ///< EPROM ch0
 I2C_error_EPROM_1,     ///< EPROM ch1
 I2C_error_EPROM_2,     ///< EPROM ch2
 I2C_error_EPROM_3,     ///< EPROM ch3
 I2C_error_EPROM_4,     ///< EPROM ch4
 I2C_error_EPROM_5,     ///< EPROM ch5  
// I2C_error_EPROM_6,       ///< EPROM ch6  
// I2C_error_EPROM_7,       ///< EPROM ch7  
// I2C_error_EPROM_8,       ///< EPROM ch8  
// I2C_error_EPROM_9,       ///< EPROM ch9  
// I2C_error_EPROM_10,  ///< EPROM ch10 
// I2C_error_EPROM_11,  ///< EPROM ch11
 };
 
enum ERROR_I2C_B{
 I2C_error_termometro_0,        ///< termometro ch0
 I2C_error_termometro_1,        ///< termometro ch1
 I2C_error_termometro_2,        ///< termometro ch2
 I2C_error_termometro_3,        ///< termometro ch3
 I2C_error_termometro_4,        ///< termometro ch4
 I2C_error_termometro_5,        ///< termometro ch5 
// I2C_error_termometro_6,      ///< termometro ch6 
// I2C_error_termometro_7,      ///< termometro ch7 
// I2C_error_termometro_8,      ///< termometro ch8 
// I2C_error_termometro_9,      ///< termometro ch9 
// I2C_error_termometro_10, ///< termometro ch10    
// I2C_error_termometro_11, ///< termometro ch11 
    
 I2C_error_trimmer_bias_0,      ///< trimmer_bias ch0
 I2C_error_trimmer_bias_1,      ///< trimmer_bias ch1
 I2C_error_trimmer_bias_2,      ///< trimmer_bias ch2
 I2C_error_trimmer_bias_3,      ///< trimmer_bias ch3
 I2C_error_trimmer_bias_4,      ///< trimmer_bias ch4
 I2C_error_trimmer_bias_5,      ///< trimmer_bias ch5       
};
 
enum error_SPI_{
    SPI_error_NONE,                             ///< this should be ARM_SPI_EVENT_TRANSFER_COMPLETE
    SPI_error_EVENT_DATA_LOST,    ///< This is ARM_SPI_EVENT_DATA_LOST
    SPI_error_EVENT_MODE_FAULT    ///< this is ARM_SPI_EVENT_MODE_FAULT
};
 
//Flag errors for I2C error_address_I2C0 and I2C1, the same enum
enum ERROR_preamplifier_{ 
    
 preamplifier_Error_in_reading_temperature_0,                              ///< Preaamplifier temperature missed CH0
 preamplifier_Error_in_reading_temperature_1,                              ///< Preaamplifier temperature missed CH1
 preamplifier_Error_in_reading_temperature_2,                              ///< Preaamplifier temperature missed CH2
 preamplifier_Error_in_reading_temperature_3,                          ///< Preaamplifier temperature missed CH3
 preamplifier_Error_in_reading_temperature_4,                            ///< Preaamplifier temperature missed CH4
 preamplifier_Error_in_reading_temperature_5,                            ///< Preaamplifier temperature missed CH5
    
 preamplifier_Error_offset_not_accurate_0,                                       ///< offset adjustment out of tolerance CH0
 preamplifier_Error_offset_not_accurate_1,                                       ///< offset adjustment out of tolerance CH1
 preamplifier_Error_offset_not_accurate_2,                                       ///< offset adjustment out of tolerance CH2
 preamplifier_Error_offset_not_accurate_3,                                       ///< offset adjustment out of tolerance CH3
 preamplifier_Error_offset_not_accurate_4,                                       ///< offset adjustment out of tolerance CH4
 preamplifier_Error_offset_not_accurate_5,                                       ///< offset adjustment out of tolerance CH5    
    
 preamplifier_Error_with_its_trimmer_0,                                      ///< Preaamplifier trimmer  error CH0
 preamplifier_Error_with_its_trimmer_1,                                        ///< Preaamplifier trimmer  error CH1
 preamplifier_Error_with_its_trimmer_2,                                          ///< Preaamplifier trimmer  error CH2
 preamplifier_Error_with_its_trimmer_3,                                            ///< Preaamplifier trimmer  error CH3
 preamplifier_Error_with_its_trimmer_4,                                            ///< Preaamplifier trimmer  error CH4
 preamplifier_Error_with_its_trimmer_5,                                            ///< Preaamplifier trimmer  error CH5
 
 preamplifier_Error_with_its_EEPROM_0,                                           ///< Preamplifier EEPROM  error CH0
 preamplifier_Error_with_its_EEPROM_1,                                               ///< Preamplifier EEPROM  error CH1
 preamplifier_Error_with_its_EEPROM_2,                                             ///< Preamplifier EEPROM  error CH2
 preamplifier_Error_with_its_EEPROM_3,                                               ///< Preamplifier EEPROM  error CH3
 preamplifier_Error_with_its_EEPROM_4,                                               ///< Preamplifier EEPROM  error CH4
 preamplifier_Error_with_its_EEPROM_5,                                               ///< Preamplifier EEPROM  error CH5
};
 
 
//error_address_CAN bits:
enum ERROR_CAN{
 CAN_error_comunichiamo_qualche_dato_timeout_on_transmission  ///< Transmission CAN error
};
 
// error_address_Bias_adjustment
enum ERROR_BIAS_setting{
 Error_detector_realy_setting,              ///< Error in setting any the relay
 Final_bias_diff_not_accurate_0,            ///< detector bias setting out of tolerance CH0
 Final_bias_diff_not_accurate_1,            ///< detector bias setting out of tolerance CH1
 Final_bias_diff_not_accurate_2,            ///< detector bias setting out of tolerance CH2
 Final_bias_diff_not_accurate_3,            ///< detector bias setting out of tolerance CH3
 Final_bias_diff_not_accurate_4,            ///< detector bias setting out of tolerance CH4
 Final_bias_diff_not_accurate_5,            ///< detector bias setting out of tolerance CH5
 
 Final_bias_pos_not_accurate_0,             ///< positive detector bias setting out of tolerance CH0
 Final_bias_pos_not_accurate_1,             ///< positive detector bias setting out of tolerance CH1
 Final_bias_pos_not_accurate_2,             ///< positive detector bias setting out of tolerance CH2
 Final_bias_pos_not_accurate_3,             ///< positive detector bias setting out of tolerance CH3
 Final_bias_pos_not_accurate_4,             ///< positive detector bias setting out of tolerance CH4
 Final_bias_pos_not_accurate_5,             ///< positive detector bias setting out of tolerance CH5
                                                                                                                                                                                                                            
 Final_bias_neg_not_accurate_0,             ///< negative detector bias setting out of tolerance CH0
 Final_bias_neg_not_accurate_1,             ///< negative detector bias setting out of tolerance CH1
 Final_bias_neg_not_accurate_2,             ///< negative detector bias setting out of tolerance CH2
 Final_bias_neg_not_accurate_3,             ///< negative detector bias setting out of tolerance CH3
 Final_bias_neg_not_accurate_4,             ///< negative detector bias setting out of tolerance CH4
 Final_bias_neg_not_accurate_5,             ///< negative detector bias setting out of tolerance CH5
 
 Detector_bias_slopes_not_available     ///< One or more channels have not the slope set 
};
 
enum DetectorTrimmer_error_{
    DetectorTrimmer_error_0,                        ///< detector trimmer setting error for CH0
    DetectorTrimmer_error_1,                        ///< detector trimmer setting error for CH1
    DetectorTrimmer_error_2,                        ///< detector trimmer setting error for CH2
    DetectorTrimmer_error_3,                        ///< detector trimmer setting error for CH3
    DetectorTrimmer_error_4,                        ///< detector trimmer setting error for CH4
    DetectorTrimmer_error_5,                        ///< detector trimmer setting error for CH5
    
    PGA_error_0,                                                ///< detector PGA setting error for CH0
    PGA_error_1,                                                ///< detector PGA setting error for CH1
    PGA_error_2,                                                ///< detector PGA setting error for CH2
    PGA_error_3,                                                ///< detector PGA setting error for CH3
    PGA_error_4,                                                ///< detector PGA setting error for CH4
    PGA_error_5                                                 ///< detector PGA setting error for CH5
};
 
 
    
 
/************Elenco Funzioni**************************************************/
void ERROR_codifica_errore(uint8_t scheda_su_scheda_giu, unsigned char error_addres, unsigned char   code_to_shift, uint8_t reset_count_se_0 );
    
int error_inspection ( char what_to_answer) ;
 
void store_errors (void);
 
void restore_errors (void);
 
void instr_ERROR_echo_on_off_function (void);
void instr_ERROR_inspection_function ( void);
void Error_imposta_la_istruzione(void);
 
//char test_supply_voltage_ON_OFF ( char channel) ;
 
//int test_supply_voltage_ON_OFF_CAN ( char channel_input);
 
 
 
 /************Fine Elenco funzioni**************************************************/