Adding a Bluetooth Data Source User Guide

1. Log in to the Kuika platform and open the mobile project you will work on from the Apps screen.
2. Go to the Datasources module. Here you can view existing data sources, actions and tables or add a new data source.

3. Click on the + icon next to the Sources heading.

4. Select the Bluetooth data source and give it a name.
5. Create the data source by clicking the CREATE button.
6. On the screen that opens, fill in the following fields:

• Device Name: Display name of the device (Mandatory)
• Device ID: Unique ID of the device (Optional)
• Device Address: The Bluetooth address of the device. For example, the address of a Bluetooth device: “00:1A:2B:3C:4D:5E.” (Optional).

    7. Complete the registration by clicking the CREATE button.

Characteristics are used to accurately distinguish and make sense of data measurements between Bluetooth devices. Each characteristic represents a specific type of data.

1. After adding the Bluetooth data source, click the ADD NEW METHOD button.

2. GATT (Generic Attribute Profile) is the standard protocol that regulates the data communication of BLE devices. Fill in the following fields when adding a new method:

• Name Method name
• Characteristic ID: Unique ID that identifies the data
• Service ID Service ID of BLE devices
• Characteristic Type: UUID indicating the type of data (Read, write, etc.) Each characteristic is identified by a UUID (Universally Unique Identifier) and can allow operations such as read (Read), write (Write) or mark (Notify or Indicate).

3. Save your method by clicking the SAVE button.
4. Select your method and add an action by clicking the ADD ACTION button in the Properties panel.

• Sub Array: Used to select a specific part of the data. For example, click +ADD ACTION > Sub Array to ensure that the first two values read from a device are converted to Byte (divide by 128) and converted to temperature value. Click Symbol Picker in Sub Array.

• In the “Count” field, enter the value “2” since the first two values are requested.

• Click “+ADD ACTION>Arithmetic>Divide” for byte conversion.

• Divide: Allows data conversion by dividing by a specific value. Click the Symbol Picker in Value in Divide and select Action Results>Sub Array to call the value from Sub Array. Then type “128” in the value2 field.

   5. Complete the process by clicking the UPDATE button.

Method Input defines the inputs required for the Bluetooth method to work.

1. Click the ADD METHOD INPUT button in the Properties panel.
2. In the screen that opens, fill in the following fields:
   
   • Input Name: Name of the input (“temperature” etc.)
   • Type: Data type of the input (“String”, “Integer” etc.)
3. Add the input by clicking the CREATE button.

Once these steps are complete, your Bluetooth data source connection is ready and can be effectively used in your applications on the Kuika platform. To learn more about Bluetooth actions and how to integrate them into your applications, check out our Getting Started with Bluetooth Actions content.