Led.c

Go to the documentation of this file.

 
 
 
#include "tutti_gli_header.h"
 
 
// DOCUMENTAZIONE DOXYGEN
/// \file
 
/*! \page LEDs  The LEDs
\anchor LEDs
*\brief  <span style="color:red;"> <b> The RED and GREEN LEDs </b> </span>
*\tableofcontents
 
 \b SUMMARY:
- \ref LED_short_description
        - \ref Start_up
        - \ref Standby
        - \ref Command_Execution
- \ref  LED_functions   
        - \ref LED_on_off
        - \ref LED_flash
 
*\section LED_short_description Short Description about LED
<hr width="90%" size="10" align="left">
\n There are 4 LEDs on the front panel of the post front-end. A pair of RED and GREEN LEDs marks the activity of the CAN-bus over
the optical fibers. The second pair of LEDs, RED and GREEN, too, marks the activity of the board itself. The lighting modalities are descrbed in the following.
 
\subsection Start_up Start up
As soon as the board is powered the GREEN LED is maintained OFF and the RED LED is ON.
\subsection Standby Standby
When the &micro;-controler terminates the operations the GREEN LED is maintained ON and will flash just befor the &micro;-controler is going to power down.
\subsection Command_Execution Command Execution
During commands executions both the RED and GREEN LEDs flash, the GREEN one with a period that is one half that 
of the RED LED. 
In case of short commands the GREEN LED remain ON while the RED LED flashes at a fast speed for a time much longer 
of that of the command.
 
*\section LED_functions LED functions and switches
<hr width="90%" size="10" align="left">
\n LEDs are operated both with fixed light and flashing.
 
\subsection LED_on_off LEDs static operation
Top operate the LEDs at fixed light  the function LED_accendi_spegni(uint8_t LED, uint8_t accendi_1_spegni_0) 
must be run where
\b LED can be #LED_RED or #LED_GREEN, and  \b accendi_1_spegni_0 is #accendi or #spegni.
 
\subsection LED_flash LED flashing
Top operate the LEDs in flashing mode the variable #LED_verde_attivo and #LED_rosso_attivo must be set to \b true. 
When any of these variables are \b true the functions LED_RED_lampeggio() and/or LED_VERDE_lampeggio() are called at every interrupt of SysTick_Handler().
The flashing duty cycle is set in ms by #LED_rosso_fondo_scala and #LED_verde_fondo_scala.
 
*/
 
volatile uint16_t LED_rosso_tempo =0;
volatile uint16_t LED_rosso_fondo_scala =1000;      /**< ... */
volatile uint8_t LED_rosso_attivo =0;              /**< ... */
volatile uint8_t prolungamento=0;
volatile uint8_t acceso=1;
 
volatile uint8_t LED_verde_attivo =0;              /**< ... */
volatile uint16_t LED_verde_tempo =0;
volatile uint16_t LED_verde_fondo_scala =500;      /**< ... */
 
volatile bool LED_remote_control=false;
volatile uint8_t LED_remote_control_setting=0;
 
/*! \brief This function toggles the Red LED and it is launched by SysTick_Handler()
every time LED_rosso_tempo equals LED_rosso_fondo_scala. Count enable needs 
LED_rosso_attivo to be true
 
*\return No Parameters
 \showrefby
*\snippet{lineno} Led.c fun_LED_RED_lampeggio
 */
//! <!-- [fun_LED_RED_lampeggio] -->
void LED_RED_lampeggio(void){
 
    
    if (acceso) {
        acceso=0;
    }else{
        acceso=1;
    }   
    GPIO_PinWrite(LED_Red.porta_num, LED_Red.pin_num, acceso);
}
//! <!-- [fun_LED_RED_lampeggio] -->
 
 
 
/*! \brief This function toggles the green LED and it is launched by SysTick_Handler()
every time LED_verde_tempo equals LED_verde_fondo_scala. Count enable needs 
LED_verde_attivo to be true
 
*\return No Parameters
 \showrefby
*\snippet{lineno} Led.c fun_LED_VERDE_lampeggio
 */
//! <!-- [fun_LED_VERDE_lampeggio] -->
void LED_VERDE_lampeggio(void){
    static uint8_t acceso=1;
    
    if (acceso) {
        acceso=0;
    }else{
        acceso=1;
    }
    
    GPIO_PinWrite(LED_Green.porta_num, LED_Green.pin_num, acceso);
}
//! <!-- [fun_LED_VERDE_lampeggio] -->
 
 
/*! \brief This function turns ON or OFF any of the selcted LED
 
\param[in] LED                 : the LED to operate
\param[in] accendi_1_spegni_0  : what to do with the selcted LED
*\return No Parameters
 \showrefby
*\snippet{lineno} Led.c fun_LED_accendi_spegni
 */
//! <!-- [fun_LED_accendi_spegni] -->
void LED_accendi_spegni(uint8_t LED, uint8_t accendi_1_spegni_0){
 
    if(accendi_1_spegni_0 <=1){
        if (LED == LED_RED){
            GPIO_PinWrite(LED_Red.porta_num, LED_Red.pin_num, accendi_1_spegni_0);
         }else if(LED == LED_GREEN){
                GPIO_PinWrite(LED_Green.porta_num, LED_Green.pin_num, accendi_1_spegni_0);
            }
    }
}
//! <!-- [fun_LED_accendi_spegni] -->
 
 
/*! \brief LEDs can be set ON/OFF
                                
*\return No Parameters
\showrefby
\showrefs
*\snippet{lineno} Led.c fun_instr_LED_ON_OFF_function
 */
//! <!-- [fun_instr_LED_ON_OFF_function] -->
void instr_LED_ON_OFF_function(void){
 
    LED_remote_control = rx_data[5]; //! This is tested in the while(1): the setting below remains if it is 1
    LED_remote_control_setting=rx_data[6]; //! This is the setting that remains if the remote control is 1
    
}
//! <!-- [fun_instr_LED_ON_OFF_function] -->
 
 
/*! \brief LEDs can be set ON/OFF from remote
                                
*\return No Parameters
\showrefby
\showrefs
*\snippet{lineno} Led.c fun_LED_remote_ON_OFF
 */
//! <!-- [fun_LED_remote_ON_OFF] -->
void LED_remote_ON_OFF (void){
    
    if( LED_remote_control){    
        prolungamento=0;
        LED_verde_attivo=0;
        LED_rosso_attivo=0;
        if( LED_remote_control_setting & 1){
            //LED ON
            LED_accendi_spegni(LED_RED,accendi);
        }else{
            //LED OFF
            LED_accendi_spegni(LED_RED,spegni);
        }
        if( LED_remote_control_setting & 2){
            //LED on
            LED_accendi_spegni(LED_GREEN,accendi);
        }else{
            //Led off
            LED_accendi_spegni(LED_GREEN,spegni);
        }
    }
}
//! <!-- [fun_LED_remote_ON_OFF] -->