29 918
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 30 :
Ligne 30 : − + − You can also change the integration time, which is how long it will collect light data for. The longer the integration time, the more precision the sensor has when collecting light samples.+ − New to v2.0 of the driver, there is also an '''auto-gain''' option that is useful when measuring in mixed lighting-situations. This will automatically enable or disable the gain depending on the light level. This is still an experimental feature and the trigger levels to switch may need to be tweeked, but this should be useful to collect light both indoors and outdoors without having to change the code yourself. + + − + − /*+ − Configures the gain and integration time for the TSL2561+ − */+ − /**************************************************************************/+ − void configureSensor(void)+ − {+ − + − + − + − + − + − + − + − + + + − + + − + − }</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:+ − 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: + − + − + − Serial.print(event.light); Serial.println(" lux");+ − /* If event.light = 0 lux the sensor is probably saturated+ − and no reliable data could be generated! */+ − Serial.println("Sensor overload");+ − This function will return a reading in SI lux units, which is probably the easiest unit to understand when working with light.+ − 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:+ − + − That's it! The example should be easy to understand and work into your own projects from here!+
→Auto-gain
Ensuite, vous aurez besoin de configurer le senseur avec '''gain''' et '''integration time''' (temps d'intégration).
Ensuite, vous aurez besoin de configurer le senseur avec '''gain''' et '''integration time''' (temps d'intégration).
Vous pouvez avoir soit un gain de 0 (pas de gain supplémentaire, excellent pour les situations de faible illumination) ou un gain de 16 which will boost the light considerably in dim situations.
Vous pouvez avoir soit un gain de 0 (pas de gain supplémentaire, excellent pour les situations de fortes/moyennes luminosités) ou un gain de 16 qui boostera considérablement la lumière dans les situation de lumière très diffuse.
Vous pouvez également modifier le temps d'intégration qui représente le temps utilisé pour collecter les données de luminosité. Plus le temps d'intégration est grand et meilleur sera la précision du senseur lorsqu'il échantillonnera la lumière.
== Auto-gain ==
La version v2.0 introduit une nouvelle fonctionnalité qui est l'option '''auto-gain'''. Elle est vraiment utile lorsque les mesures sont effectuées dans des situations mélangeant des cas de luminosités diffuse et luminosité normale.
<nowiki> /**************************************************************************/
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>/**************************************************************************/
/*
Configurer le gain et temps d'intégration pour le TSL2561
*/
/**************************************************************************/
/* You can also manually set the gain or enable auto-gain support */
void configureSensor(void)
// tsl.setGain(TSL2561_GAIN_1X); /* No gain ... use in bright light to avoid sensor saturation */
{
// tsl.setGain(TSL2561_GAIN_16X); /* 16x gain ... use in low light to boost sensitivity */
/* Vous pouvez également activer manuellement le gain ou activer le support auto-gain */
tsl.enableAutoGain(true); /* Auto-gain ... switches automatically between 1x and 16x */
// tsl.setGain(TSL2561_GAIN_1X); /* pas de gain ... a utiliser avec le lumière brillante pour éviter la saturation du senseur */
/* Changing the integration time gives you better sensor resolution (402ms = 16-bit data) */
// tsl.setGain(TSL2561_GAIN_16X); /* gain de 16x ... a utiliser en situation de faible luminosité pour booster la sensibilité */
tsl.setIntegrationTime(TSL2561_INTEGRATIONTIME_13MS); /* fast but low resolution */
tsl.enableAutoGain(true); /* Auto-gain ... passe automatiquement le gain entre 1x et 16x */
// tsl.setIntegrationTime(TSL2561_INTEGRATIONTIME_101MS); /* medium resolution and speed */
/* Changer le temps d'intégration permet d'augmenter la résolution du senseur (402ms = 16-bit de données) */
// tsl.setIntegrationTime(TSL2561_INTEGRATIONTIME_402MS); /* 16-bit data but slowest conversions */
tsl.setIntegrationTime(TSL2561_INTEGRATIONTIME_13MS); /* Rapide mais faible résolution */
// tsl.setIntegrationTime(TSL2561_INTEGRATIONTIME_101MS); /* vitesse et résolution moyenne */
// tsl.setIntegrationTime(TSL2561_INTEGRATIONTIME_402MS); /* 16-bit de donnée mais conversion la plus lente */
/* Update these values depending on what you've set above! */
/* N'oubliez pas de modifier les textes ci-dessous en fonction de la configuration
utilisée ci-dessus! */
Serial.println("------------------------------------");
Serial.println("------------------------------------");
Serial.print ("Gain: "); Serial.println("Auto");
Serial.print ("Gain: "); Serial.println("Auto");
Serial.print ("Timing: "); Serial.println("13 ms");
Serial.print ("Temps: "); Serial.println("13 ms");
Serial.println("------------------------------------");
Serial.println("------------------------------------");
}</nowiki>
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]]
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");
}
}
else
else
{
{
/* Si event.light = 0 lux alors le senseur est probablement saturé
et aucune donnée fiable ne peut être obtenu! */
Serial.println("Sensor saturé");
}</nowiki>
}</nowiki>
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.
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>
Voila! L'exemple devrait être facile a comprendre et facile à intégrer dès maintenant dans vos propres projets!
{{TSL2561-TRAILER}}
{{TSL2561-TRAILER}}