add new sketch and update library

zeynepdicle · zeynepdicle · commit bbdda1b9164c · 2022-09-21T10:35:32.000+03:00
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-# Deneyap UV Light Sensor LTR390 Library
+# Deneyap UV Light Sensor Arduino Library
 [FOR TURKISH VERSION](docs/README_tr.md) ![trflag](https://github.com/deneyapkart/deneyapkart-arduino-core/blob/master/docs/tr.png)
 
 ***** Add photo ****
@@ -7,23 +7,27 @@ Arduino library for Deneyap UV Light Sensor LTR390
 
 ## Specifications 
 - `Product ID` **M41** ,**mpv1.0**
-- `MCU` LTR390
+- `MCU` LITE-ON LTR-390UV-01
 - `Weight` 
-- `Module Dimension`
+- `Module Dimension` 25,4 mm x 25,4 mm
 - `I2C address` 0x53
 
 | Address |  | 
 | :---    | :---     |
 | 0x53 | default address |
 
 ## :closed_book:Documentation
-Deneyap UV Light Sensor
+[Deneyap UV Light Sensor](https://docs.deneyapkart.org/en/content/contentDetail/deneyap-module-deneyap-uv-light-and-ambient-light-)
 
-[LTR390 datasheet](https://optoelectronics.liteon.com/upload/download/DS86-2015-0004/LTR-390UV_Final_%20DS_V1%201.pdf)
+[Deneyap UV Light Sensor Shematic](https://cdn.deneyapkart.org/media/upload/userFormUpload/rpg5nuYZ4nRmF6koyt8opWJk0g1mW6tX.pdf)
+
+[Deneyap UV Light Sensor Mechanical Drawing](https://cdn.deneyapkart.org/media/upload/userFormUpload/ts4p78WD1a4OfMgkSmOPG9Jm2hrBhzXY.pdf)
+
+[LITE-ON LTR-390UV-01_datasheet](https://optoelectronics.liteon.com/upload/download/DS86-2015-0004/LTR-390UV_Final_%20DS_V1%201.pdf)
 
 [How to install a Arduino Library](https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries)
 
-## :pushpin:Deneyap UV Light Sensor LTR390
+## :pushpin:Deneyap UV Light Sensor
 This Arduino library allows you to use Deneyap UV Light Sensor LTR390 with I2C peripheral. You can use this library in your projects with any Arduino compatible board with I2C peripheral.
 
 ## :globe_with_meridians:Repository Contents
@@ -34,6 +38,8 @@ This Arduino library allows you to use Deneyap UV Light Sensor LTR390 with I2C p
 - `library.properties ` General library properties for the Arduino package manager
 
 ## Version History
+1.0.1 - update library function (`begin`),add new sketch(`IsikAlgilamaOkumaAyarlama`), update texts info
+
 1.0.0 - initial release
 
 ## :rocket:Hardware Connections
diff --git a/docs/README_tr.md b/docs/README_tr.md
@@ -1,28 +1,32 @@
-# Deneyap Ultraviyole Işık Algılayıcı LTR390 Arduino Kütüphanesi
+# Deneyap Ultraviyole Işık Algılayıcı Arduino Kütüphanesi
 
 ***** Fotoğraf eklenecek ****
 
 Deneyap Ultraviyole Işık Algılayıcı LTR390 için Arduino kütüphanesidir.
 
 ## :mag_right:Özellikler 
 - `Ürün ID` **M41** ,**mpv1.0**
-- `MCU` LTR390
+- `MCU` LITE-ON LTR-390UV-01
 - `Ağırlık`
-- `Modul Boyutları`
+- `Modul Boyutları` 25,4 mm x 25,4 mm
 - `I2C Adres` 0x53
 
 | Adres |  | 
 | :---  | :---     |
 | 0x53   | varsayılan adres |
 
 ## :closed_book:Dokümanlar
-Deneyap Ultraviyole Işık Algılayıcı
+[Deneyap Ultraviyole Işık Algılayıcı](https://docs.deneyapkart.org/tr/content/contentDetail/deneyap-module-deneyap-uv-light-and-ambient-light-)
 
-[LTR390 datasheet](https://optoelectronics.liteon.com/upload/download/DS86-2015-0004/LTR-390UV_Final_%20DS_V1%201.pdf)
+[Deneyap Ultraviyole Işık Algılayıcı Şematik](https://cdn.deneyapkart.org/media/upload/userFormUpload/rpg5nuYZ4nRmF6koyt8opWJk0g1mW6tX.pdf)
 
-[Arduino Kütüphanesi Nasıl İndirilir](https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries)
+[Deneyap Ultraviyole Işık Algılayıcı Teknik Çizim](https://cdn.deneyapkart.org/media/upload/userFormUpload/ts4p78WD1a4OfMgkSmOPG9Jm2hrBhzXY.pdf)
 
-## :pushpin:Deneyap Ultraviyole Işık Algılayıcı LTR390
+[LITE-ON LTR-390UV-01_datasheet](https://optoelectronics.liteon.com/upload/download/DS86-2015-0004/LTR-390UV_Final_%20DS_V1%201.pdf)
+
+[Arduino IDE'de Kütüphane Nasıl İndirilir](https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries)
+
+## :pushpin:Deneyap Ultraviyole Işık Algılayıcı
 Bu Arduino kütüphanesi Deneyap Ultraviyole Işık Algılayıcı LTR390 I2C çevre birimi ile kullanılmasını sağlar. Arduino ile uyumlu, I2C çevre birimine sahip herhangi bir geliştirme kartı ile bu kütüphaneyi projelerinizde kullanabilirsiniz. 
 
 ## :globe_with_meridians:Repo İçeriği
@@ -33,6 +37,8 @@ Bu Arduino kütüphanesi Deneyap Ultraviyole Işık Algılayıcı LTR390 I2C çe
 - `library.properties` Arduino yöneticisi için genel kütüphane özellikleri
 
 ## Sürüm Geçmişi
+1.0.1 - yeni örnek(`IsikAlgilamaOkumaAyarlama`) eklendi, kütüphane fonksiyonu(`begin`) ve metin bilgileri güncellendi
+
 1.0.0 - ilk sürüm
 
 ## :rocket:Donanım Bağlantıları
@@ -41,10 +47,10 @@ Bu Arduino kütüphanesi Deneyap Ultraviyole Işık Algılayıcı LTR390 I2C çe
 
 |Ultraviyole Işık Algılayıcı| Fonksiyon| Kart pinleri |
 | :---     | :---   |   :---  |
-| 3.3V     | Güç    | 3.3V    |
-| GND      | Toprak |GND      |
-| SDA      | I2C Data  | SDA pini |
-| SCL      | I2C Clock | SCL pini|
+| 3.3V     |3.3V Besleme Gerilimi| 3.3V    |
+| GND      |Toprak |GND      |
+| SDA      |Çift Yönlü Veri Hattı| SDA pini |
+| SCL      |Veri Hattı Zaman Senkronizasyon İşareti| SCL pini|
 | INT      | Interrupt | |
 
 ## :bookmark_tabs:Lisans Bilgisi 
diff --git a/examples/IsikAlgilama/IsikAlgilama.ino b/examples/IsikAlgilama/IsikAlgilama.ino
@@ -1,36 +1,39 @@
 /*
- *   Işık Algılama örneği,
- *
+ *   IsikAlgilama örneği,
  *   Bu örnekte temel konfigürasyon ayarları yapılmaktadır.
- *   Sensörden gelen Işık Yoğunluğu okumaktadır. Işık Yoğunluğunu seri terminale yazdırmaktadır.
+ *   Sensörden gelen ışık yoğunluklarını okumaktadır. Işık yoğunluğunu seri port ekranına yazdırmaktadır.
  *
  *   Bu algılayıcı I2C haberleşme protokolü ile çalışmaktadır.
  *
  *   Bu örnek Deneyap Ultraviyole Işık Algılayıcı için oluşturulmuştur
- *      ------> www.....com <------ //docs
+ *      ------> https://docs.deneyapkart.org/tr/content/contentDetail/deneyap-module-deneyap-uv-light-and-ambient-light- <------
  *      ------> https://github.com/deneyapkart/deneyap-ultraviyole-isik-algilayici-arduino-library <------
- *
-*/
-#include <Deneyap_UltraviyoleIsikAlgilici.h>
+ */
+#include <Deneyap_UltraviyoleIsikAlgilici.h>        // Deneyap Ultraviyole Işık Algılayıcı kütüphanesi eklenmmesi
 
-UVlight LTR;
-
-float UltraviyoleIsikYogunlugu;
-float OrtamIsikYogunlugu;
+UVlight UVlight;                                    // UVlight için class tanımlanması
 
 void setup() {
-    Serial.begin(115200);
-    LTR.begin(0x53);
+    Serial.begin(115200);                           // Seri haberleşme başlatılması
+    UVlight.begin(0x53);                            // begin(slaveAdress) fonksiyonu ile cihazların haberleşmesi başlatılması
+    UVlight.setMode(LTR390_MODE_ALS);               // Ortam ışığını okumaya ayarlanması.  LTR390_MODE_UVS: ultraviyole ışık verisi
 }
 
 void loop() {
-    UltraviyoleIsikYogunlugu = LTR.getLUX();
-    Serial.print("ULTRaviyole Işık Yoğunluğu: ");
-    Serial.print(UltraviyoleIsikYogunlugu);
+    if (UVlight.getMode() == LTR390_MODE_ALS) {     // Ortam ışığı verileri okunursa
+        // Ortam ışık verisinin okunması ve seri port ekranına yazdırılması
+        Serial.print("LUX: ");
+        Serial.print(UVlight.getLUX());
+
+        Serial.print("\tALS: ");
+        Serial.println(UVlight.readALS());
+    } else {                                        // Ultraviyole ışık verisi okunursa
+        // Ultraviyole ışık verisinin okunması ve seri port ekranına yazdırılması
+        Serial.print("UVI: ");
+        Serial.print(UVlight.getUVI());
 
-    OrtamIsikYogunlugu = LTR.readALS();
-    Serial.print("\tOrtam Işık Yuğunluğu: ");
-    Serial.println(OrtamIsikYogunlugu);
-    
-    delay(50);
+        Serial.print("\tUVS: ");
+        Serial.println(UVlight.readUVS());
+    }
+    delay(50);                                      // 50 milisaniye bekletilmesi
 }
diff --git a/examples/IsikAlgilamaOkumaAyarlama/IsikAlgilamaOkumaAyarlama.ino b/examples/IsikAlgilamaOkumaAyarlama/IsikAlgilamaOkumaAyarlama.ino
@@ -0,0 +1,44 @@
+/*
+ *   IsikAlgilamaOkumaAyarlama örneği,
+ *   Bu örnekte temel konfigürasyon ayarları yapılmaktadır.
+ *   Sensörden okunma ayarlarını değiştirmektedir.
+ *   Sensörden gelen ışık yoğunluklarını okumaktadır. Işık yoğunluğunu seri port ekranına yazdırmaktadır.
+ *
+ *   Bu algılayıcı I2C haberleşme protokolü ile çalışmaktadır.
+ *
+ *   Bu örnek Deneyap Ultraviyole Işık Algılayıcı için oluşturulmuştur
+ *      ------> https://docs.deneyapkart.org/tr/content/contentDetail/deneyap-module-deneyap-uv-light-and-ambient-light- <------
+ *      ------> https://github.com/deneyapkart/deneyap-ultraviyole-isik-algilayici-arduino-library <------
+ */
+#include <Deneyap_UltraviyoleIsikAlgilici.h>      // Deneyap Ultraviyole Işık Algılayıcı kütüphanesi eklenmmesi
+
+UVlight UVlight;                                  // UVlight için class tanımlanması
+
+void setup() {
+  Serial.begin(115200);                           // Seri haberleşme başlatılması
+  UVlight.begin(0x53);                            // begin(slaveAdress) fonksiyonu ile cihazların haberleşmesi başlatılması
+  UVlight.setMode(LTR390_MODE_ALS);               // Ortam ışığını okumaya ayarlanması.  LTR390_MODE_UVS: ultraviyole ışık verisi
+  UVlight.setGain(LTR390_GAIN_3);                 // Gain(kazanç) ayarlanması. LTR390_GAIN_1, LTR390_GAIN_6, LTR390_GAIN_9, LTR390_GAIN_18
+  UVlight.setResolution(LTR390_RESOLUTION_16BIT); // Resolution(çözünürlük) ayarlanması. LTR390_RESOLUTION_16BIT, LTR390_RESOLUTION_17BIT, LTR390_RESOLUTION_18BIT, LTR390_RESOLUTION_19BIT, LTR390_RESOLUTION_20BIT
+}
+
+void loop() {
+  if (UVlight.newDataAvailable()) {               // Yeni veri gelirse
+    if (UVlight.getMode() == LTR390_MODE_ALS) {   // Ortam ışığı verileri okunursa
+      // Ortam ışık verisinin okunması ve seri port ekranına yazdırılması
+      Serial.print("LUX: ");
+      Serial.print(UVlight.getLUX());
+
+      Serial.print("\tALS: ");
+      Serial.println(UVlight.readALS());
+    } else {                                      // Ultraviyole ışık verisi okunursa
+      // Ultraviyole ışık verisinin okunması ve seri port ekranına yazdırılması
+      Serial.print("UVI: ");
+      Serial.print(UVlight.getUVI());
+
+      Serial.print("\tUVS: ");
+      Serial.println(UVlight.readUVS());
+    }
+  }
+  delay(50);                                      // 50 milisaniye bekletilmesi
+}
diff --git a/library.properties b/library.properties
@@ -1,5 +1,5 @@
 name=Deneyap Ultraviyole Isik Algilayici
-version=1.0.0
+version=1.0.1
 author=RFtek Electronics <techsupport@rftek.com.tr>
 maintainer=Turkish Technnology Team Foundation (T3)
 sentence=Arduino library for Deneyap UV Light Sensor LTR390
diff --git a/src/Deneyap_UltraviyoleIsikAlgilici.cpp b/src/Deneyap_UltraviyoleIsikAlgilici.cpp
diff --git a/src/Deneyap_UltraviyoleIsikAlgilici.h b/src/Deneyap_UltraviyoleIsikAlgilici.h
