Preamplifier_Gain.c

Go to the documentation of this file.

 
#include "tutti_gli_header.h"
 
 
/*****DOCUMENTAZIONE DOXYGEN             (premi il - a sinistra per ridurla a icona) il manuale html \'e nella cartella************/
/// \file
 
/*!
\page Preamplifier_Gain_page Preamplifier_Gain
\brief <span style="color:red;"> <b> Preamfier gain setting </b> </span>
 
*\tableofcontents
 
 \b SUMMARY:
*\arg \ref pre_gain_operation
*\arg \ref pre_gain_fw
 
*\section pre_gain_operation User use of preamplifier gain
<hr width="75%" size="10" align="left">
 
\n Preamplifier gain set is equivalent to PGA_set_reset_pre_PGA_gain(). The function name this time is 
preamplifier_set_reset_pre_gain(uint8_t scheda_su_scheda_giu, uint8_t canale, uint8_t set_2_reset_1_idle_0  ), where
the parameter \b set_2_reset_1_idle_0 is not the gain value and it is suggested to use the following definitions for it:
- #preamplifier_Gain_alto  , the gain is 210 V/V
- #preamplifier_Gain_basso , the gain is 21 V/V
- #preamplifier_Gain_set_idle , switch to idle (done by the function at the end of every setting)
 
\n Here an example to set high gain:
<span style="color:orange;"> <I>
\code {.c}
preamplifier_set_reset_pre_gain ( scheda_su_scheda_giu,  canale,  preamplifier_Gain_alto  );
\endcode
</I> </span>
 
*\section pre_gain_fw Preamplifier gain fw
<hr width="75%" size="10" align="left">
 
\n The code of the function is:
\snippetlineno Preamplifier_Gain.c fun_preamplifier_set_reset_pre_gain
 
\n The codes for mamnaging the preamplifier gain are: 
 - \ref  Preamplifier_Gain.c
 - \ref  Preamplifier_Gain.h
 
*/
 
 
/*! \brief Here the 2 digital signals of the preamplifier's trimmer are exploited to set the gain of the preamplifier itself
 
 *\param[in] scheda_su_scheda_giu one of the 2 boards that the postfrontend manages
 *\param[in] canale the channel for which we need to manage the trimmer
 *\param[in] set_2_reset_1_idle_0 use here the definitions: 
                                - #preamplifier_Gain_alto
                                - #preamplifier_Gain_basso 
                                - #preamplifier_Gain_set_idle                                                                       
 *\return No Parameters
 
 *\snippetlineno Preamplifier_Gain.c fun_preamplifier_set_reset_pre_gain
 */
 //! <!-- [fun_preamplifier_set_reset_pre_gain] -->
void preamplifier_set_reset_pre_gain (uint8_t scheda_su_scheda_giu, uint8_t canale, uint8_t set_2_reset_1_idle_0  ){
    
        uint8_t spedizione[2];
    if(scheda_su_scheda_giu) scheda_su_scheda_giu=6;
 
        spedizione[1] = contenuto_trimmer_preamplifier[canale + scheda_su_scheda_giu][0] ; //The trimmer content has to be 
                                                                    //written each time the digital signals are set/reset
      
    I2C_mux_select_ch(  scheda_su_scheda_giu,  I2C_mainboard, address_preamplifier_trimmer[canale].quale_I2C);  //Select the I2C to be used 
    
    if( set_2_reset_1_idle_0) {  //We operate only if we have to set
        
            spedizione[0] = set_2_reset_1_idle_0 << 1 ;  //The 2 bits are at position 1 and 2 of the byte
        
            
            I2C_mux->MasterTransmit( (uint8_t) address_preamplifier_trimmer[canale].indirizzo_I2C , spedizione, 2,false); //Write the selected trimmer of the selcted channel
            
            while( I2C_mux->GetStatus().busy);  // White transmission complete
            
            Aspetta_tanti_ms(wait_time_for_rele_setting);
            if( Error_bad_operation) ERROR_codifica_errore( scheda_su_scheda_giu, error_address_I2C0 , I2C_Error_trimmer_0 + canale ,1);
    }       
        
        spedizione[0] =preamplifier_Gain_set_idle; // Both switches OFF, this operation is made always and can be made at the initialization
        
        I2C_mux->MasterTransmit( (uint8_t) address_preamplifier_trimmer[canale].indirizzo_I2C , spedizione, 1,false); ///Set the trimmer to read
        
        while( I2C_mux->GetStatus().busy);  // White transmission complete
        
        I2C_mux->MasterReceive( address_preamplifier_trimmer[canale].indirizzo_I2C, &tappo, 1,false);  //Read back, the trimmer value
        
        while( I2C_mux->GetStatus().busy){};
        
                contenuto_trimmer_preamplifier[canale + scheda_su_scheda_giu][0]  = tappo;
}
 //! <!-- [fun_preamplifier_set_reset_pre_gain] -->