ErrorCross

Table of Contents

• Page Summary
• Error registers and flags
  • Error registers
  • Flags
• Error managing functions
• Anatomy of errors

Errors Managing

Page Summary

---

Here you can find informations about the follwoing topics:

• Error registers and flags
  • Error registers
  • Flags
• Error managing functions
• Anatomy of errors

Error registers and flags

---

Error registers

---

A large number of flags are available to take account of the presence of errors or not adequate performances of both the hw and fw. The errors are in a vector of unsigned int. Every element of the vector cotains 32 flags of information. A flag in true state means that the corresponding error has been verified. The vector with the errors is Post_frontend_errors:

 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

its registers are addressed according to the enum ERROR_CROSS_address_ whose list follows. Note that the length of the half vector is error_number_of_errors_registers, the last element of the list for board down. A similar number of elements with the same name offset by error_offset_for_board_up account for board up. The number on left of the list is the register address whithin Post_frontend_errors:

0. error_address_reg_ADC0 flags list at flags_error_ADC
1. error_address_reg_ADC1 flags list at flags_error_ADC
2. error_address_Power_Supply_in_General flags list at flags_error_PowerSupply
3. error_address_I2C0 Error register for I2C0 flags list at flags_error_I2C
4. error_address_I2C1 Error register for I2C1 flags list at flags_error_I2C
5. error_address_SPI Error register for SPI flags list at flags_error_SPI
6. error_preamplifier_down flags list at flags_error_preamplifier
7. error_preamplifier_up flags list at flags_error_preamplifier
8. error_address_CAN flags list at flags_error_CAN
9. error_address_PGA_DetectorTrimmer_down flags list at flags_error_PGA_DetectorTrimmer
10. error_address_PGA_DetectorTrimmer_up flags list at flags_error_PGA_DetectorTrimmer
11. error_address_Bias_adjustment flags list at flags_error_Bias_Adj
12. error_number_of_errors_registers (this is not an address, it is the lenght of the vector)
13. error_offset_for_board_up registers for board up start from this addres and replica the firsts above

The first regsiters, from address 0 to error_number_of_errors_registers, are for the lower board. The registers whose address starts from error_offset_for_board_up registers, are for board up and are a replica in meaning of the first ones. So, for instance, a fail in reading power supply for board down is found at address error_address_Power_Supply_in_General, or 2, while the same fail on board up is found at address error_offset_for_board_up registers + error_address_Power_Supply_in_General.

Flags

---

Every register of the Post_frontend_errors vector is a set of 32 homogenous flags, that summmmarize the behaviour of some subjects, ADC, I2, SPI, etc. The signature of an error is the value of 1 of a flag and every flag. As an instance, to consult the error during I2C0 communication one has to look at the register Post_frontend_errors[error_address_I2C0]. Each flag of that registers that is 1 marks the verification of any not expected bahaviour.
Now, to manage the flags a few function are available, described below.
Let's start to interpet the flags. To each register an enum is built that lists the flags. They are all listed below. The number on the left of the lists are the position of the flag in the register. As an instance, if the error Vbol_neg_large_for_switching happens, than a 1 is stored at 1 << Vbol_neg_large_for_switching in the error_address_Power_Supply_in_General register.
Here is the list:

Register name: error_address_reg_ADC0 and error_address_reg_ADC1 (ADC's errors)

ADC errors flags

Da implementare ADC_internal_General_fails ADC general fault ADC_SPI_fault (its value is 0) for SPI Communication fault ADC_RDY_pin_fault for ADC ready signal not received ADC_RDY_pin_fault_during_calibration for ADC ready not during calibration VREF_ADC_too_small for ADC VREF measured out of its tolerance, too small VREF_ADC_too_large for ADC VREF measured out of its tolerance, too large ADC_external_fails measurement form an external ADC went wrong

Register name: error_address_Power_Supply_in_General (eorrors with any Power Supply)
Errors flags for Vbol for switching	Da implementare Vbol_pos_small_for_switching (its value is 0) for Positive Vbol too small for switching from internal to external power or vice-versa Vbol_pos_large_for_switching for Positive Vbol too large for switching from internal to external power or vice-versa Vbol_neg_small_for_switching for Negative Vbol too small for switching from internal to external power or vice-versa Vbol_neg_large_for_switching for Negative Vbol too large for switching from internal to external power or vice-versa ADC_RDY_pin_fault_during_calibration for ADC ready not during calibration VREF_ADC_too_small for ADC VREF measured out of its tolerance, too small VREF_ADC_too_large for ADC VREF measured out of its tolerance, too large
Errors flags for Vbol limiting values	Da implementare Vbol_pos_too_large for Positive Vbol exceeds the maximum Vbol_pos_too_small for Positive Vbol is below the lower limit Vbol_neg_too_large for Negative Vbol exceeds the maximum Vbol_neg_too_small for Negative Vbol is below the lower limit
Errors flags for VREF_POS_PRE	Da implementare Vref_pos_too_large for Positive Vref too large Vref_pos_too_small for Positive Vref too small
Errors flags for VREF_NEG_PRE	Da implementare Vref_neg_absolute_val_too_large for Negative Vref too large Vref_neg_absolute_val_too_small for Negative Vref too small
Errors flags for VCC_PRE	Da implementare VCC_PRE_pos_too_large for Positive supply for preamplifier too large VCC_PRE_pos_too_small for Positive supply for preamplifier too small
Errors flags for VEE_PRE	Da implementare VEE_PRE_absolute_val_too_large for Negative supply for preamplifier too large VEE_PRE_absolute_val_too_small for Negative supply for preamplifier too small
Errors flags rotation for VCC_PGA	Da implementare VCC_PGA_pos_too_large Positive supply for PGA too large VCC_PGA_pos_too_small for Positive supply for PGA too small
Errors flags rotation for VEE_PGA	Da implementare VEE_PGA_absolute_val_too_large for Negative supply for PGA too large VEE_PGA_absolute_val_too_small for Negative supply for PGA too small
Errors flags for V__dig_5V	Da implementare V__dig_5V_val_too_large for Digital 5 V supply too large V__dig_5V_val_too_small for Digital 5 V supply too small
Errors flags for V__dig_3e3V	Da implementare V__dig_3e3V_val_too_large for Digital 3.3 V supply too large V__dig_3e3V_val_too_small for Digital 3.3 V supply too small

Register name: error_address_I2C0 and error_address_I2C1 (errors with any I2C)
Trouble with I2C communication	parziale I2C_Error_NONE it would be EVENT_TRANSFER_DONE. The definition from CMSIS is "ARM_I2C_" + "EVENT_TRANSFER_DONE" I2C_Error_EVENT_TRANSFER_INCOMPLETE this and the following follows the rule above I2C_Error_EVENT_SLAVE_TRANSMIT I2C_Error_EVENT_SLAVE_RECEIVE I2C_Error_EVENT_ADDRESS_NACK I2C_Error_NONE this would be "ARM_I2C_" + "EVENT_GENERAL_CALL" I2C_Error_EVENT_ARBITRATION_LOST I2C_Error_EVENT_BUS_ERROR I2C_Error_EVENT_BUS_CLEAR
I2C Mux0 settings	parziale I2C_Error_I2C_mux I2C mux distribution error
I2C to parallel conversion PCA9554	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
Preamplifier trimmer	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
EPROM	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

Register name: error_address_I2C0_B and error_address_I2C1_B (errors with any I2C)
Trouble with preamplifier thermometer	parziale 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
Bias trimmer	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

Register name: error_address_SPI
Trouble with SPI communication	parziale 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

Register name: error_address_CAN (errors with CAN bus communication)
Trouble with CAN communication	Da implementare CAN_error_comunichiamo_qualche_dato_timeout_on_transmission (its value is 0) for Transmission CAN error

Register name: error_preamplifier_down and error_preamplifier_up
Trouble in temperature reading	Da implementare preamplifier_Error_in_reading_temperature_0 for Preaamplifier temperature missed of CH0 preamplifier_Error_in_reading_temperature_1 for Preaamplifier temperature missed of CH1 preamplifier_Error_in_reading_temperature_2 for Preaamplifier temperature missed of CH2 preamplifier_Error_in_reading_temperature_3 for Preaamplifier temperature missed of CH3 preamplifier_Error_in_reading_temperature_4 for Preaamplifier temperature missed of CH4 preamplifier_Error_in_reading_temperature_5 for Preaamplifier temperature missed of CH5
Troubles with reading preamplifier trimmer	Da implementare preamplifier_Error_offset_not_accurate_0 for Preaamplifier trimmer reading error CH0 preamplifier_Error_offset_not_accurate_1 for Preaamplifier trimmer reading error CH1 preamplifier_Error_offset_not_accurate_2 for Preaamplifier trimmer reading error CH2 preamplifier_Error_offset_not_accurate_3 for Preaamplifier trimmer reading error CH3 preamplifier_Error_offset_not_accurate_4 for Preaamplifier trimmer reading error CH4 preamplifier_Error_offset_not_accurate_5 for Preaamplifier trimmer reading error CH5
Troubles with writing preamplifier trimmer	Da implementare preamplifier_Error_with_its_trimmer_0 for Preaamplifier trimmer writing error CH0 preamplifier_Error_with_its_trimmer_1 for Preaamplifier trimmer writing error CH1 preamplifier_Error_with_its_trimmer_2 for Preaamplifier trimmer writing error CH2 preamplifier_Error_with_its_trimmer_3 for Preaamplifier trimmer writing error CH3 preamplifier_Error_with_its_trimmer_4 for Preaamplifier trimmer writing error CH4 preamplifier_Error_with_its_trimmer_5 for Preaamplifier trimmer writing error CH5
Troubles in writing the preamplifier EEPROMs	parziale preamplifier_Error_with_its_EEPROM_0 for Preamplifier EEPROM writing error CH0 preamplifier_Error_with_its_EEPROM_1 for Preamplifier EEPROM writing error CH1 preamplifier_Error_with_its_EEPROM_2 for Preamplifier EEPROM writing error CH2 preamplifier_Error_with_its_EEPROM_3 for Preamplifier EEPROM writing error CH3 preamplifier_Error_with_its_EEPROM_4 for Preamplifier EEPROM writing error CH4 preamplifier_Error_with_its_EEPROM_5 for Preamplifier EEPROM writing error CH5

Register name: error_address_CAN (errors with CAN bus communication)
Trouble with CAN communication	Da implementare CAN_error_comunichiamo_qualche_dato_timeout_on_transmission (its value is 0) for Transmission CAN error

Register name: error_address_PGA_DetectorTrimmer_down and error_address_PGA_DetectorTrimmer_up
Troubles with detector trimmer ommunication	Da implementare DetectorTrimmer_error_0 for onboard trimmer error communication CH0 DetectorTrimmer_error_1 for onboard trimmer error communication CH1 DetectorTrimmer_error_2 for onboard trimmer error communication CH2 DetectorTrimmer_error_3 for onboard trimmer error communication CH3 DetectorTrimmer_error_4 for onboard trimmer error communication CH4 DetectorTrimmer_error_5 for onboard trimmer error communication CH5
Troubles with PGA settings	Da implementare PGA_error_0 for onboard trimmer error communication CH0 PGA_error_1 for onboard trimmer error communication CH1 PGA_error_2 for onboard trimmer error communication CH2 PGA_error_3 for onboard trimmer error communication CH3 PGA_error_4 for onboard trimmer error communication CH4 PGA_error_5 for onboard trimmer error communication CH5

Register name: error_address_Bias_adjustment (detector bias errors)
Final differential bias out of tolerance	Da implementare Error_detector_realy_setting Error in setting any the relay Final_bias_diff_not_accurate_0 (its value is 0) for detector bias setting out of tolerance CH0 Final_bias_diff_not_accurate_1 for detector bias setting out of tolerance CH1 Final_bias_diff_not_accurate_2 for detector bias setting out of tolerance CH2 Final_bias_diff_not_accurate_3 for detector bias setting out of tolerance CH3 Final_bias_diff_not_accurate_4 for detector bias setting out of tolerance CH4 Final_bias_diff_not_accurate_5 for detector bias setting out of tolerance CH5
Final positive bias out of tolerance	Da implementare Final_bias_pos_not_accurate_0 for positive detector bias setting out of tolerance CH0 Final_bias_pos_not_accurate_1 for positive detector bias setting out of tolerance CH1 Final_bias_pos_not_accurate_2 for positive detector bias setting out of tolerance CH2 Final_bias_pos_not_accurate_3 for positive detector bias setting out of tolerance CH3 Final_bias_pos_not_accurate_4 for positive detector bias setting out of tolerance CH4 Final_bias_pos_not_accurate_5 for positive detector bias setting out of tolerance CH5
Final negative bias out of tolerance	Da implementare Final_bias_neg_not_accurate_0 for negative detector bias setting out of tolerance CH0 Final_bias_neg_not_accurate_1 for negative detector bias setting out of tolerance CH1 Final_bias_neg_not_accurate_2 for negative detector bias setting out of tolerance CH2 Final_bias_neg_not_accurate_3 for negative detector bias setting out of tolerance CH3 Final_bias_neg_not_accurate_4 for negative detector bias setting out of tolerance CH4 Final_bias_neg_not_accurate_5 for negative detector bias setting out of tolerance CH5 Detector_bias_slopes_not_available since one or more channels have not the slope set
Slopes not available	Detector_bias_slopes_not_available since one or more channels have not the slope set

Error managing functions

---

The user makes use of the function instr_ERROR_inspection_function() which is passed a parameter, via Byte6 of the CAN instruction, tha can take one of the following 4 values:

1. : this case the returned parameter is the address of the register where the last error has been detected;
2. : the content of the register queried in the instruction is sent back;
3. : the errors are all reset;
4. : the state of the immidieate echos of errors, when verified. Note that the echos can be set ON or OFF by instr_ERROR_echo_on_off_function() via CAN bus.

As an example, to verify the presence of negative bias adjustment error for CH2 we test true:

Post_frontend_errors[error_address_Bias_adjustment] & ( 1 << Final_bias_pos_not_accurate_2)

Anatomy of errors

---

There are 4 functions that are used in the fw to manage the errors:

1. The first allows to set the error in the register; it is ERROR_codifica_errore() with input parameters: uint8_t scheda_su_scheda_giu, unsigned char error_addres, unsigned char code_to_shift, uint8_t reset_count_se_0 in which error_addres is the address of the register, see sub-section Error registers, while code_to_shift is the position of the flag to set whitihn the register, see for this case the sub-section Flags. Here an axample of its use:

                           I2C_mux -> MasterTransmit( I2C_mux_address_postmainboard_down, &canale_da_abilitare, 1,false);
                           while( I2C_mux -> GetStatus().busy);  // White transmission complete
                           if( Error_bad_operation) ERROR_codifica_errore(scheda_su_scheda_giu, error_address_I2C0  , I2C_Error_I2C_mux, 1 );

   Note that ERROR_codifica_errore() set the flag whithin the register, but does not veirfy if the error has been generated. In the above example the presence of error is marked by Error_bad_operation when different from zero.
   Error_bad_operation is located whithin I2C_0_SignalEvent_t(), I2C_1_SignalEvent_t(), SPI_callback() to mark communication errors.
   Error_bad_operation is not the only parameter to test for errors. As an instance, with CAN bus this other way is used:

       //Before here a CAN message has been sent with success, we hope
       while(   (ii <50) && ( evento_CAN  != ARM_CAN_EVENT_RECEIVE ) ){
           Aspetta_tanti_ms(200);
           ii++;
       }   
       if(ii>=50)      ERROR_codifica_errore(  0, error_address_CAN, CAN_error_comunichiamo_qualche_dato_timeout_on_transmission,1);

2. The second function is store_errors() that serves to push the whole registers.
3. Then, the function restore_errors() pop's the whole regsiters.
4. The function Error_imposta_la_istruzione() has to be located at the end of every instruction function to mark the error at Byte5, if present. If there is an error it sets the value 0xff at Byte5, if Byte5 is different from 0xff, otherwise it sets 0xfa.

---

See also

The instructions to manage errors via CAN bus are instr_ERROR_inspection and instr_ERROR_echo_on_off.