I2C_termometro.c

Go to the documentation of this file.

 
 
#include "tutti_gli_header.h"
 
// DOCUMENTAZIONE DOXYGEN
 
/// \file 
 
/*! \page Thermometer
*\brief  <span style="color:red;"> <b> Managing of the thermometer on preamplifiers  </b> </span>
*\tableofcontents
 
 \b SUMMARY:
*\arg \ref thermometer_readout
*\arg \ref thermometer_sw
 
*\section thermometer_readout User use of thermometer on preamplifiers
<hr width="75%" size="10" align="left">
 
\n The thermometer is the <a href="./File_pdf/lm73.pdf"  target=_blank><b>LM73</b></a> tha has a 14-bits digital ouput via I2C bus. Its schematic is 
in figure \ref Figure_I2C_mux. It has been developed one function ofr its managing: termometro_lettura() with input parameters: <i> uint8_t scheda_su_scheda_giu,   uint8_t canale, uint32_t *temperatura_in_microK </i>,
 the ouput is the pointer to \b temperatura_in_microK
 
 <span style="color:orange;"> <I>
\code {.c}
uint32_t temperatura_in_microK;
termometro_lettura(  scheda_su_scheda_giu_provvisorio,   canale_ ,  &temperatura_in_microK )
\endcode
</I> </span>
 
*\anchor Figure_I2C_mux
*\image html LM73_scheme.png "FigureLM73 1: LM73 scheme" width=40%  
*\image latex LM73_scheme.png "FigureLM73 1: LM73 scheme" width=40% 
 
*\section thermometer_sw Thermometer function 
<hr width="75%" size="10" align="left">
\n Thermometrs are sent into shut down mode at the startup by means of termometro_sht_down( uint8_t scheda_su_scheda_giu,   uint8_t canale ).
\n Here is the reading thermometer function termometro_lettura():
\snippetlineno I2C_termometro.c fun_termometro_lettura
 
\n The selction of the thermometr needs 2 parameters: the I2C and its I2C address. These parameters are found in the const strucure #termometro_adrress[6].
\n The I2C addresses are:
- #termometro_I2C_Address_pari
- #termometro_I2C_Address_dispari.
 
\n The codes for mamnaging the trimmer are: 
 - \ref  I2C_termometro.c
 - \ref  I2C_termometro.h
 
<!-- pappa -->  
*/
 
 
//INIZIO CROSS
/*!\brief Thermometer selection structure
*/
const struct address_detector_bias_trimmer_type /*{
//  uint8_t quale_I2C;  
//  uint8_t indirizzo_I2C   
}*/ termometro_adrress[6]={I2C_mux_abilita_0, termometro_I2C_Address_pari, 
                                                    I2C_mux_abilita_0, termometro_I2C_Address_dispari, 
                                                    I2C_mux_abilita_1,termometro_I2C_Address_pari,
                                                    I2C_mux_abilita_1, termometro_I2C_Address_dispari,  
                                                    I2C_mux_abilita_2, termometro_I2C_Address_pari, 
                                                    I2C_mux_abilita_2,termometro_I2C_Address_dispari };  //< Address of the memoies onboard, this is a 16k bits
 
 
 /*! \brief Read the termometer on preamplifier
 
*\param[in] scheda_su_scheda_giu one of the 2 boards that the postfrontend manages
*\param[in] canale the channel of the mux to be enabled
*\param[out] *temperatura_in_microK pointer to the temperature to read.                                 
*\return No Parameters
\showrefby
\showrefs 
\snippetlineno I2C_termometro.c fun_termometro_lettura
*/
 //! <!-- [fun_termometro_lettura] -->
void termometro_lettura( uint8_t scheda_su_scheda_giu,  uint8_t canale, uint32_t *temperatura_in_microK ){
    
    //< registri termometro
    #define reg_temperatura 0
    #define reg_configuration   1
    #define reg_control_status   4
    //< Commands
    #define Shut_down_and_one_shot_command_for_config_reg 0x84
    #define Max_accuracy_command_for_control_reg  0x60
    #define maschera_DAV 1
    
    uint8_t comando1[]={reg_control_status,Max_accuracy_command_for_control_reg};
    uint8_t comando2[]={reg_configuration, Shut_down_and_one_shot_command_for_config_reg};
//  uint8_t comando2[]={reg_configuration, 0};  
    uint8_t comando3[]={reg_temperatura};
    uint8_t comando4[]={reg_control_status};
    uint8_t lettura[2];
 
 
//void I2C_mux_select_ch( uint8_t scheda_su_scheda_giu, I2C_mainboard,uint8_t  canale_da_abilitare)
         I2C_mux_select_ch(  scheda_su_scheda_giu,  I2C_mainboard, termometro_adrress[canale].quale_I2C);
            
            I2C_mux -> MasterTransmit( termometro_adrress[canale].indirizzo_I2C, comando1, 2,false); //bestacuracy
            while( I2C_mux -> GetStatus().busy);  // White transmission complete
            Aspetta_tanti_ms(5);
            I2C_mux -> MasterTransmit( termometro_adrress[canale].indirizzo_I2C, comando2, 2,false); //onseshot meas
            while( I2C_mux -> GetStatus().busy);  // White transmission complete
            Aspetta_tanti_ms(150);
            if(Error_bad_operation) ERROR_codifica_errore(scheda_su_scheda_giu ,error_address_I2C0_B  , I2C_error_termometro_0  + canale, 1);   
            
            lettura[0]=0;
            uint8_t conta_err=0;
            while(  ((lettura[0] & maschera_DAV) == 0) && (conta_err<10) ){
                I2C_mux -> MasterTransmit( termometro_adrress[canale].indirizzo_I2C, comando4 , 1,false); //lettura control reg per dato pronto
                while( I2C_mux -> GetStatus().busy);  // White transmission complete    
                Aspetta_tanti_ms(5);    
 
                I2C_mux -> MasterReceive( termometro_adrress[canale].indirizzo_I2C, lettura, 2,false);  //Read back the temperature
                while( I2C_mux -> GetStatus().busy);
                conta_err ++;
            }
            if(conta_err >=10) ERROR_codifica_errore(scheda_su_scheda_giu ,error_address_I2C0_B  , I2C_error_termometro_0  + canale, 1);
    
            I2C_mux -> MasterTransmit( termometro_adrress[canale].indirizzo_I2C, comando3, 1,false); //read temperature
            while( I2C_mux -> GetStatus().busy);  // White transmission complete    
            Aspetta_tanti_ms(5);    
 
            I2C_mux -> MasterReceive( termometro_adrress[canale].indirizzo_I2C, lettura, 2,false);  //Read back the temperature
            while( I2C_mux -> GetStatus().busy);    
    
            *temperatura_in_microK = ((uint32_t)lettura[0] <<8 ) + (uint32_t) lettura[1] ;
            *temperatura_in_microK = *temperatura_in_microK & 0x7FFF ; 
            *temperatura_in_microK = (*temperatura_in_microK  >> 2 ) *31250; //Resilt in microK
    
            I2C_mux_select_ch(  scheda_su_scheda_giu, I2C_mainboard,  I2C_mux_disabilita_tutto);
            
}
//! <!-- [fun_termometro_lettura] -->                                                   
 
 /*! \brief Thermometer in shtdown
 
*\param[in] scheda_su_scheda_giu one of the 2 boards that the postfrontend manages
*\param[in] canale the channel of the mux to be enabled                                 
*\return No Parameters
\showrefby
\showrefs 
\snippetlineno I2C_termometro.c fun_termometro_sht_down
*/
 //! <!-- [fun_termometro_sht_down] -->
void termometro_sht_down( uint8_t scheda_su_scheda_giu,     uint8_t canale ){
    
    //< registri termometro
    #define reg_temperatura 0
    #define reg_configuration   1
    #define reg_control_status   4
    //< Commands
    #define Shut_down_and_one_shot_command_for_config_reg 0x84
    #define Shut_down_config_reg 0x80
    #define Max_accuracy_command_for_control_reg  0x60
    #define maschera_DAV 1
    
    uint8_t comando1[]={reg_control_status,Max_accuracy_command_for_control_reg};
    uint8_t comando2[]={reg_configuration, Shut_down_config_reg};
//  uint8_t comando2[]={reg_configuration, 0};  
    uint8_t comando3[]={reg_temperatura};
    uint8_t comando4[]={reg_control_status};
    uint8_t lettura[2];
 
 
//void I2C_mux_select_ch( uint8_t scheda_su_scheda_giu, I2C_mainboard,uint8_t  canale_da_abilitare)
         I2C_mux_select_ch(  scheda_su_scheda_giu,  I2C_mainboard, termometro_adrress[canale].quale_I2C);
            
            I2C_mux -> MasterTransmit( termometro_adrress[canale].indirizzo_I2C, comando1, 2,false); //bestacuracy
            while( I2C_mux -> GetStatus().busy);  // White transmission complete
            Aspetta_tanti_ms(5);
            I2C_mux -> MasterTransmit( termometro_adrress[canale].indirizzo_I2C, comando2, 2,false); //onseshot meas
            while( I2C_mux -> GetStatus().busy);  // White transmission complete
            Aspetta_tanti_ms(150);
            if(Error_bad_operation) ERROR_codifica_errore(scheda_su_scheda_giu ,error_address_I2C0_B  , I2C_error_termometro_0  + canale, 1);   
                
            I2C_mux_select_ch(  scheda_su_scheda_giu, I2C_mainboard,  I2C_mux_disabilita_tutto);
            
}
//! <!-- [fun_termometro_sht_down] -->  
 
//FINE CROSS
 
extern ARM_DRIVER_I2C Driver_I2C2;                                                                          // Viene inclusa la Periferica I2C2
 
//ARM_DRIVER_I2C * I2C_termometro_drv = &Driver_I2C2;                           // Viene creato un puntatore a Driver_I2C2
 
 
 
/*****************************************************************************
  Interrupt della Periferica I2C_termometro
 ******************************************************************************/
void I2C_termometro_SignalEvent_t (uint32_t event)
{
        if(event==ARM_I2C_EVENT_TRANSFER_DONE)              // Ricezione e trasmissione finita sia del master che dello slave
        {
            __NOP();
        }
        if(event==ARM_I2C_EVENT_SLAVE_TRANSMIT)
        {
            __NOP();
        }
        if(event==ARM_I2C_EVENT_SLAVE_RECEIVE)
        {
            __NOP();    
        }           
}
 
 
 
 
/*****************************************************************************
 I2C_termometro_Initialize
 *****************************************************************************/
void I2C_termometro_Initialize (void) 
{
 
  I2C_termometro_drv->Initialize   (I2C_termometro_SignalEvent_t);                              // Viene inizializzata la periferica I2C
  I2C_termometro_drv->PowerControl (ARM_POWER_FULL);                                                            // Viene accesa la periferica
  I2C_termometro_drv->Control      (ARM_I2C_BUS_SPEED, ARM_I2C_BUS_SPEED_FAST);     // Viene impostata la velocit\'a del Bus
  I2C_termometro_drv->Control      (ARM_I2C_BUS_CLEAR, 0);                                           
}