Modifications

Auto-gain activera/désactivera automatiquement le gain en fonction du niveau d'illumination. Il s'agit toujours d'une fonctionnalité expérimentale et utilise différents niveaux de luminosités pour activer (adapter) le gain. Cela devrait être utile pour échantillonner la lumière en intérieur et extérieur sans devoir adapter/modifier le code.  

Auto-gain activera/désactivera automatiquement le gain en fonction du niveau d'illumination. Il s'agit toujours d'une fonctionnalité expérimentale et utilise différents niveaux de luminosités pour activer (adapter) le gain. Cela devrait être utile pour échantillonner la lumière en intérieur et extérieur sans devoir adapter/modifier le code.  

  <nowiki>   /**************************************************************************/

  <nowiki>/**************************************************************************/

    /*

/*

    Configurer le gain et temps d'intégration pour le TSL2561

Configurer le gain et temps d'intégration pour le TSL2561

    */

*/

    /**************************************************************************/

/**************************************************************************/

    void configureSensor(void)

void configureSensor(void)

    {

{

     /* Vous pouvez également activer manuellement le gain ou activer le support auto-gain */

     /* Vous pouvez également activer manuellement le gain ou activer le support auto-gain */

     // tsl.setGain(TSL2561_GAIN_1X); /* pas de gain ... a utiliser avec le lumière brillante pour éviter la saturation du senseur */

     // tsl.setGain(TSL2561_GAIN_1X); /* pas de gain ... a utiliser avec le lumière brillante pour éviter la saturation du senseur */

     Serial.print ("Temps: "); Serial.println("13 ms");

     Serial.print ("Temps: "); Serial.println("13 ms");

     Serial.println("------------------------------------");

     Serial.println("------------------------------------");

    }</nowiki>

}</nowiki>

By default, the driver will return light in standard SI lux units, which are a result of some complex calculations based on both photo diodes on the TSL2561 (one for full spectrum and one for IR). The sensitivity of the two diodes can be seen in the chart below:

Par défaut, le pilote retour la lumière en Lux (le Lux est une unité SI du standard internationale). Ce résultat est le résultat de calculs complexes basés sur les deux photo diodes du TSL2561 (une pour le spectre lumineux entier et l'autre pour le spectre infrarouge). La sensibilité des deux diodes peut être examiné sur le graphe ci-dessous:

[[Fichier:TSL2561-Intro-02.jpg|350px]]

[[Fichier:TSL2561-Intro-02.jpg|350px]]

When you're ready to get your measurement in standard SI lux units, simply call getEvent with a reference to the 'sensors_event_t' object where the sensor data will be stored. This example assumes we are using the 'tsl' instance of Adafruit_TSL2561 at the top of the example code:  

Lorsque vous êtes prêt à effectuer vos mesures en Lux, appelez simplement '''getEvent''' avec la référence vers un objet 'sensors_event_t' où les données du senseur seront stockées. Cet exemple part du principe que nous utilisons une instance Adafruit_TSL2561 déjà initialisée et nommée 'tsl':  

  <nowiki>    /* Get a new sensor event */

  <nowiki>    /* Obtenir un nouvel évènement du senseur */

     sensors_event_t event;

     sensors_event_t event;

     tsl.getEvent(&event);

     tsl.getEvent(&event);

     /* Display the results (light is measured in lux) */

     /* Affiche le résultat (la lumière est mesurée en lux) */

     if (event.light)

     if (event.light)

     {

     {

    Serial.print(event.light); Serial.println(" lux");

        Serial.print(event.light); Serial.println(" lux");

     }

     }

     else

     else

     {

     {

    /* If event.light = 0 lux the sensor is probably saturated

        /* Si event.light = 0 lux alors le senseur est probablement saturé

    and no reliable data could be generated! */

          et aucune donnée fiable ne peut être obtenu! */

    Serial.println("Sensor overload");

        Serial.println("Sensor saturé");

     }</nowiki>

     }</nowiki>

This function will return a reading in SI lux units, which is probably the easiest unit to understand when working with light.

Cette fonction retourne une lecture en unité internationale (SI). Le Lux est probablement l'unité la plus facule à comprendre lorsque l'on travaille avec la lumière.

If you wish to manually read the individual photo diodes, though, you can still do this in the latest library by calling the '''getLuminosity''' function, and passing in two variables where the sensor data will be stored:

Si vous désirez lire manuellement les valeurs individuelles des photo diodes, vous pouvez le faire dans la dernière version de la librairie en appelant la fonction '''getLuminosity''' et en passant deux variables où les données du senseur seront stockées:

  <nowiki>    uint16_t broadband = 0;

  <nowiki>    uint16_t broadband = 0;

     uint16_t infrared = 0;

     uint16_t infrared = 0;

      

      

     /* Populate broadband and infrared with the latest values */

     /* Collecte les dernières valeurs dans kes variables broadband et infrared */

     getLuminosity (&broadband, &infrared);</nowiki>

     getLuminosity (&broadband, &infrared);</nowiki>

That's it! The example should be easy to understand and work into your own projects from here!

Voila! L'exemple devrait être facile a comprendre et facile à intégrer dès maintenant dans vos propres projets!

{{TSL2561-TRAILER}}

{{TSL2561-TRAILER}}