[ IWOWN ]

Iwown Bluetooth BLE SDK User Guide

1. Author：hzy
2. Shenzhen IWOWN Technology Co., Ltd.
3. Version：1.0.1

Modify the record:

1. New SDK code, access the new I6hc color bracelet, P1 bracelet
2. Update Bluetooth input and output methods

Modify the record:(2018-02-06)

1. Increase color bracelet data synchronization
2. Increase color bracelet movement, heart rate, sleep display
3. increase Lottery bracelet settings
4. Debug message push
5. Increase color bracelet firmware upgrade
6. Increase the alarm, schedule, vibration settings demo

1.introduction

1.1Write purpose

Provide partner companies with an Android Bluetooth SDK that can be used with iwown devices that provide both basic and advanced features for the primary bracelet or other device. The documentation is intended to explain the usage context, functionality, etc. of the API.
Expected readers and reading suggestions
The expected reader and reader suggestions in this article are shown in Exhibit 1.

2.API instructions

2.1Access conditions

Android 4.3 and above, Bluetooth 4.0. A iwown-bracelet, bracelet can be skilled in the use of objects.

2.2Access steps

• A Iwown-bracelet boot
• SDK access APP, according to the document call the appropriate API
  

  Please refer to Annex SDK demo app:IWBle

2.3.1API method call description

• Bluetooth device to start scanning

public void startScan(boolean filter)

• Bluetooth device stops scanning

public void stopScan()

• Please select the SDK version before connecting:
  eg:

BleApplication.getInstance().getmService().setSDKType(context, sdkType);

1. SDK_Zeroner = 1;(i5 Plus,i7,i5 Pro,i6 Pro,i5 HR,i5 A,i3 HR,i3,16)

2. SDK_Zg = 3;(i6 Pro C,i6 HR C)

   • Connect Bluetooth device

public boolean connect(String address)
public boolean connect()
public boolean isConnecting()
 public void setWristBand(WristBand wristBand)
setNeedReconnect(boolean isNeedReconnect)
 public boolean isConnected()

1. Please refer to demo IWBle: BluetoothUtil class related to use

• Disconnect the Bluetooth device

public void disconnect(String address, boolean needCloseGatt)
SuperBleSDK.getSDKSendBluetoothCmdImpl(context).setUnbind()

1. Please refer to demo IWBle: BluetoothUtil class related to use

SDK TYPE =SDK_Zg Color screen bracelet

API Call the document:SDK_Zg = 3;(i6 Pro C,i6 HR C)

• Get device information: dataType=0x85

public byte[] getFirmwareInformation()

• language setting

public void setLanguage(Context context, int type)

• Set the metric system

 public void  setUnitSwitch(Context context, int type)

• Set the temperature unit

 public void setTemperatureUnitSwitch(Context context, int type)

• Set 24/12 hours

  public void  setTimeDisplay(Context context, int type)

• Set the user's weight

   public void  setUserWeight(Context context, int weight) 

• Set the user pace

    public void setStride(Context context, int wStride, int rStride) 

• Set the number of steps goal

    public void  setStepsTarget(Context context, int target) 

• Set the calorie goal

    public void  setKcalTarget(Context context, int target)

• Phone push switch

    public void  setCallNotificationSwitch(Context context, int type)

• Phone push effective time

    public void setComingCallHours(Context context, int startHour, int endHour)

• Information push switch

    public void  setMsgNotificationSwitch(Context context, int type)

• Information push effective time

    public void setComingMessageHours(Context context, int startHour, int endHour)

• Static heart rate switch and effective time

    public void  heartDetection(Context context, int heartOn, int startHour, int endHour)

• Heart rate warning switch and effective time

    public void setHeartAlarm(Context context, int warmingOn, int heartHighAlarm, int heartLowAlarm)

• Modify the bracelet vibration settings

    public void setShake(Context context,int phoneType,int phoneCount,int msgType,int msgCount,int setLongType,int setLongCount,int heartType,int heartCount)

• Set long switch and start and end time

   public void setLongSitAlarm(Context context, int alarm ,int startHour,int endHour)

• Bowl bright screen switch

    public void setGesture(Context context, int gestureOn, int startHour, int endHour) 

• Gets the total date the data is stored

    public byte[] getDataDate() 

• Get the data stored in the bracelet for 7 days

    public byte[] getTotalData(TDay tday)

• set time

    public byte[] setTimeAndWeather() 

• Set time and weather

   public byte[] setTimeAndWeather(@IntRange(from = 0, to = 10)int weather, int temperature)

• The phone hangs up

   public void closeCallPhone(Context context)

• Data synchronization ends

    public void syncDataOver(Context context)

• Get hardware information

    public byte[] getHardwareFeatures()

• Get details of the day in steps

    public byte[] getDetailWalk(int day)

• Get training data

     public byte[] getDetailSport(int day)

• Get sleep details data

  public byte[] getDetailSleep(int day)

• Test bracelet vibration

   public byte[] testShake(@IntRange(from = 1, to = 7) int mode, @IntRange(from = 0, to = 31) int times)

• Set up firmware upgrade

    public byte[] setUpgrade()

2.SDK returns data description

• SDK scan callback

public void onScanResult(WristBand dev) 

• SDK connection callback

public void onBluetoothInit()
public void connectStatue(boolean isConnect)
public void onDiscoverService(String serviceUUID)
public void onCharacteristicChange(String address)

• SDK data callback

 public void onDataArrived(Context context, int ble_sdk_type, int dataType, String data)

• SDK error callback

public void onBluetoothError()
public void noCallback()

• SDK data callback dataType data type description

- SDK returns json data corresponding data meaning

Bracelet there is 7 days of data information

public class SevenDayStore {
    //Bracelet total data N days
    public int totalDays;
    //The specific collection of each day
    public List<EveryDayInfo> storeDateObject = new ArrayList();
}
public class EveryDayInfo {
    //year
    public long year;
    //month
    public int month;
    //day
    public int day;
}

Data details for each day

public class bh_totalinfo {
    private int year;
    private int month;
    private int day;
    //Total calories
    private int calorie;
    //Total distances
    private int distance;
    //Training time /min
    private int exerciseMinutes;
    //Total sleep time /min
    private int sleepMinutes;
    //The last one to measure heart rate
    private int latestHeart;
    //The total number of steps
    private int step;
}

Bracelet walk data

public class ZgDetailWalkData {
    private int year;
    private int month;
    private int day;
    //walk arrays
    private List<Integer> data;
}

bracelet Sleep data

public class ZgSleepData {
    private int year;
    private int month;
    private int day;
    //start time
    private long startTime;
    //end time
    private long endTime;
    //Total sleep time
    private int totalSleep;
    //Deep sleep time
    private int deepSleep;
    //Light sleep time
    private int lightSleep;
    //Awake time
    private int wakeSleep;
    //Each sleep set
    private List<ZgSleepData.Sleep> data;
}
    public static class Sleep {
        //start time
        private int st;
        //end time
        private int et;
        //sleep type
        private int type;
        }

Bracelet sport data

public class ZgDetailSportData {
    private int year;
    private int month;
    private int day;
    private int count;
    //sport data array
    private List<ZgDetailSportData.Sport> sports;
}
    public static class Sport {
        //Total exercise time
        private int totalMin;
        //sport start time
        private int startMin;
        //end time
        private int endMin;
        //step
        private int steps;
        //Sport distances
        private float distance;
        //Sports calories
        private float calories;
        //This training record the largest pace
        private int spmMax;
        //The average pace of this training record
        private int spmAvg;
        //This training records the maximum heart rate
        private int heartMax;
        //The average heart rate of this training record
        private int heartAvg;
        //This type of training exercise
        private int sportType;
        //heart array
        private List<Integer> heart = new ArrayList();
    }

Bracelet Heart rate data

public class ZGHeartData {
    public int year;
    public int month;
    public int day;
    //The highest heart rate
    public int highestHeart;
    //The lowest heart rate
    public int lowHeart;
    //Average heart rate
    public int averageHeart;
    //Every day data heart rate point
    public int[] staticHeart = new int[144];
    public int index;
    }

Bracelet time

public class DeviceTime {
    int year = -1;
    int month = -1;
    int day = -1;
    int hour = -1;
    int minute = -1;
    int second = -1;
    int week = -1;
}

Get device settings information

public class DeviceSetting {
    //British unit
    private int unitSet;
    //weight
    private int weight;
     //stride
    private int walkStride;
    private int runStride;
    //Steps goal
    private int stepsOnceday;
    //kcal goal
    private int calorieOnceday;
    //distance goal
    private int distanceOnceday;
    private int stepsReachRing;
    private int caloriesReachRing;
    private int distanceReachRing;
     //call push switch
    private int comingCallEnable;
    //call push start time
    private int comingCallStartHour;
    //call push end time
    private int comingCallEndHour;
    //Phone push vibration mode
    private int comingCallRing;
    //Message push switch
    private int messageEnable;
    //Message push start time
    private int messageStartHour;
    //Message push end time
    private int messageEndHour;
    //Message push vibration mode
    private int messageRing;
    //Static heart rate switch
    private int quietHeartEnable;
    //Static heart rate measurement start time
    private int quietHeartStartHour;
    //Static heart rate measurement end time
    private int quietHeartEndHour;
    //Heart rate warning switch
    private int heartAlarmEnable;
    //Heart rate warning high value
    private int highHeartAlarm;
    //Low heart rate warning
    private int lowHeartAlarm;
    //Heart rate warning vibration mode
    private int heartRing;
    //Long seat switch
    private int sitLongAlarmEnable;
    //Long seat start time
    private int sitlongStartHour;
    //Long seat end time
    private int sitlongEndHour;
    //Block seat vibration mode
    private int sitlongRing;
    //Turn wrist switch
    private int rollEnable;
    //Turn wrist gesture start time
    private int rollStartHour;
    //Turn wrist gesture end  time
    private int rollEndHour;
    private int watchSelect;
    //battery
    private int batteryVolume;
}

Bracelet hardware information

public class ZGHardwareInfo extends Result {
    //Firmware version number
    private int dev_version;
    private int dev_screen;
    private int dev_key_type;
    private int dev_fontic;
    private int dev_gsensor;
    private int dev_moto;
    private int dev_heart;
    private int dev_cfca;
    private int dev_nfc;
    private int dev_reserve = 0;
    //Bracelets model number
    private String model = "";
}