1. Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız Mobile projeyi açın.
2. “Datasources” (1) modülüne gidin. Datasources modülünde, geliştirdiğiniz uygulamada yer alan veri kaynaklarını, aksiyonları ve tabloları görüntüleyebilir, yeni bir veri kaynağı, yeni bir aksiyon ve yeni bir tablo ekleyebilirsiniz. 

3. Geliştirdiğiniz uygulamaya yeni bir veri kaynağı eklemek için Datasources modülünün sol kenarındaki “Sources” başlığı yanında bulunan “+” (2) ikonuna tıklayın. 

4. Datasources tipi olarak “Bluetooth”(1) seçin ve bir isim (2) verin. 
5. Daha sonra “CREATE” (3) butonuna tıklayın. 

6. Açılan ekranda Device Name, Device ID ve Device Address alanlarını doldurun. 

• Device Name (1) : Cihazın kullanıcı tarafından görünen ismidir. 

Device Name alanının girilmesi zorunludur. 

• Device ID (2): Cihazın benzersiz kimliğidir. 
• Device Address (3): Cihazın Bluetooth adresidir. Örneğin, bir Bluetooth cihazının adresi: “00:1A:2B:3C:4D:5E.” şeklinde görülebilir. 

Device ID ve Device Address’in girilmesi zorunlu değildir. 

7. Ardından “CREATE” (4)  butonuna tıklayın. 

Bluetooth cihazları arasında birden fazla veri ölçümü yapıldığında, bu verileri ayırt etmek ve doğru bir şekilde anlamlandırmak için karakteristikler kullanılır. Karakteristikler, belirli bir hizmetin veya veri türünün bir bileşeni olarak tanımlanır. Örneğin, bir sıcaklık sensörü birden fazla ölçüm yapıyorsa, her ölçüm farklı bir karakteristik altında iletilir. Her karakteristik, belirli bir veri türünü temsil eder; örneğin, bir karakteristik sıcaklık verisi içerirken, bir diğeri nem verisini içerebilir. Bu yapı sayesinde alıcı cihaz, hangi karakteristiğin hangi tür veriyi temsil ettiğini kolayca tanıyabilir ve bu verileri doğru bir şekilde ayırt edebilir. Bluetooth teknolojisi kullanılarak birden fazla veri ölçümü yapan cihazlar arasında veri paylaşımı yaparken, bu verilerin hangi tür veriler olduğunu belirlemek ve ayırt etmek için karakteristiklerin tanımlanması önemlidir. Bu bölümde, Bluetooth karakteristiklerinin nasıl tanımlandığını ve kullanıldığını öğreneceksiniz.

1. Uygulamanıza Bluetooth bağlantısı ekledikten sonra sağ köşede bulunan “ADD NEW METHOD” butonuna tıklayın. 

GATT, Bluetooth Low Energy (BLE) teknolojisinin temel bir bileşeni olan Generic Attribute Profile'ın (Genel Özellik Profili) kısaltmasıdır. GATT, BLE cihazlarının veri alışverişini ve iletişimini düzenleyen bir standart protokoldür. BLE cihazlarının nasıl veri paylaşacaklarını, kontrol edileceğini ve hangi verilerin paylaşılacağını belirler. Açılan ekranda, GATT'nin ana bileşenlerini açıklayan Name, Characteristic ID, Service ID, ve Characteristic Type alanları yer almaktadır.

2. Açılan pop-up’tan uygulamanızın metodundaki ayarları yapılandırın. 

• Name (1): Oluşturulan metod adının girildiği alandır.
• Characteristic ID (2): Bluetooth Low Energy (BLE) hizmetlerinin altında bulunan karakteristikleri benzersiz bir şekilde tanımlayan numaradır. Karakteristik kimliği genellikle her karakteristiği ayırt etmek için kullanılır.
• Service ID (3): GATT, cihazların belirli işlevleri veya veri türlerini temsil etmek için kullanabileceği servisleri tanımlar. Her servis, bir veya daha fazla karakteristik içerir. Service ID, BLE cihazlarının hizmetlerini tanımlayan servis numarasıdır. Hizmet kimliği, bir hizmeti benzersiz şekilde tanımlar.
• Characteristic Type (4): Servislerin altındaki birimler olarak karakteristikler, belirli bir işlevi veya veriyi temsil eder. Her karakteristik bir UUID (Universally Unique Identifier) ile tanımlanır ve okuma (Read), yazma (Write) veya işaretleme (Notify veya Indicate) gibi işlemlere izin verebilir.

Örneğin, bir sıcaklık ölçüm karakteristiği sıcaklık verisini temsil eder ve merkezi cihazın bu veriyi okumasına izin verebilir. Bir karakteristiğin taşıdığı verinin türünü veya niteliğini belirten bir değerdir. Bu, verinin sıcaklık, nem, basınç veya başka bir ölçüm türü olduğunu ifade eder. Karakteristik türü, genellikle spesifik bir Bluetooth profilinde veya kılavuzda tanımlanmış olan türlere karşılık gelir. Örneğin, Temperature Measurement (Sıcaklık Ölçümü).

3. Gerekli alanlar doldurulduktan sonra “SAVE” butonuna tıklayarak metodu oluşturun. 
4. Oluşturulan metodun Kuika platformu tarafından yorumlanabilmesi için metodu seçin.

5. Sağ kenarda bulunan Properties panelinden “ +ADD ACTION”a tıklayın. Örneğin bir cihazdan okunan ilk iki değerin Byte’a çevrilerek (128’e böl) sıcaklık değerine çevrilmesini sağlamak için “+ADD ACTION >Sub Array”e tıklayın. Sub Array içerisinde yer alan Symbol Picker’a tıklayın.

6. “Count” alanında ise ilk iki değer istendiği için “2” değerini giriniz.

7.  Byte çevrimi için “+ADD ACTION>Arithmetic>Divide”a tıklayın. 

8. Divide içerisinde yer alan Value’deki Symbol Picker’a tıklayarak Sub Array’den gelen değerlen çağrılması için “Action Results>Sub Array”i seçin. Ardından value2 alanına “128” yazın.
9. Daha sonra sağ köşedeki “UPDATE” butonuna tıklayın. 

Method Input Ekleme

Method Input, Bluetooth ile etkileşimde bulunan bir metodun başarılı bir şekilde çalışabilmesi için gerekli olan tüm girdileri tanımlamanıza olanak sağlar. Bir Bluetooth cihazından veri alırken ya da cihaz veri gönderirken kullanılan metodun girdilerini tanımlamak için Properties panelindeki “ADD METHOD INPUT” açılır menüsünü kullanabilirsiniz.

Yeni bir Method Input eklemek için: 

1. Properties panelinden “+ADD METHOD INPUT”a (1) tıklayın. 
2. Açılan menüden aşağıdaki alanları yapılandırın:

• Input Name (2): Metodun beklediği girdinin adını belirlediğiniz alandır. Örneğin, bir sıcaklık sensöründen veri alıyorsanız, girdiye “temperature” adını verebilirsiniz. 
• Type (3): Girdinin veri türünü belirlediğiniz alandır. Örneğin, metin verisi için “String”, görsel verisi için “Image” kullanılabilir. 

3. Ardından “CREATE” (4) butonuna tıklayın.