[ IWOWN ]

Iwown Bluetooth BLE SDK User Guide

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

Modify the record:

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

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()

• 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

• Get device information: dataType=0x00

public byte[] getFirmwareInformation()

• Set the time:

public byte[] setTime()

• Synchronize heart rate for 24 hours: dataType=0x53

public byte[] syncHeartRateHourData(int type)

- Synchronization interval heart rate: dataType=0x51

public byte[] syncHeartRateSegmentData(int type)

• Set the alarm

public void writeAlarmClock(Context context, int id, int weekRepeat, int hour, int minute, String text)

- Turn off / read the alarm

public void closeAlarm(int id,Context context)
public void getAlarmClock(Context context, int id)

• Set / close the schedule

 public void setSchedule(Context context,int year, int month, int day, int hour, int minute, String text)
public void closeSchedule(Context context,int year, int month, int day, int hour, int minute)

- Clear all / read schedule

public void clearAllSchedule(Context context)
public void readScheduleInfo(Context context)

• Set / read time

public byte[] setTime(int year, int month, int day, int hour, int minute, int second, int week)
public byte[] getTime()

- Read power

public byte[] getBattery()

• Set the bracelet to enter upgrade mode

public byte[] setUpgrade()

• Bracelet unbundled

public byte[] setUnbind()

• Set the ring is not disturbing mode

public byte[] setQuietMode(int startHour, int startMin, int endHour, int endMin)

- Set the bracelet specific time period Do not disturb mode

public byte[] setQuietMode(int type)

• Clear Do Not Disturb Mode / Read Quiet Mode Setup Parameters

public byte[]  clearQuietMode()
public byte[] getQuietModeInfo()

• Bracelet synchronized weather

public byte[] setWeather(int unitType, int temperature, int weather, int pm)

• Set Goals / Get Supported Sports Type / Clear All Sports / Get Moving Target

public byte[] setSportGole(ArrayList<Byte> datas)
public byte[] getSportType()
public void clearAllSport(Context context)
public byte[] getSportGoles(int week)

• Bracelet set sedentary reminder

public byte[] setSedentary(int id, int week, int startHour, int endHour, int alertDuration, int workCount)

- Read a long reminder

public byte[] getSedentary()

• Set the bracelet setting

public byte[] setWristBandGestureAndLight(SparseBooleanArray array, int backLightStartTime, int backLightEndTime, int languageType, int dataFormat,int wristLightFuncStartTime, int wristLightFuncEndTime)

- Read the bracelet settings

public byte[] getDeviceStateDate()

• Set user information

public byte[] setUserProfile(int height, int weight, boolean gender, int age, int steps)

- Read user information

public byte[] getUserProfile()

• Set heart rate warning

public byte[] setHeartRateWarming(boolean isOn, int high, int low, int timeOut, int interval)

• Read heart rate warning

 public byte[] getHeartRateWarming()

• Selfie

public byte[] setWristBandSelfie(boolean flag)

- Bracelet vibration mode setting

public byte[] setShakeMode(int type, int shakeModeIndex, int num, ArrayList<Map<String, Integer>> model)

• Bracelet data storage capacity

public byte[] readDataInfoStored()

• Synchronize the segmented data

public byte[] setDialydata28(int value, boolean flag, int index)

- Synchronic total data

public byte[] setDialydata29(int value)

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 firmware class:FMdeviceInfo

public class FMdeviceInfo{
    //model eg:i6hr
    private String model="";
    private int oadmode;
    //firmware version:1.0.0.0
    private String swversion;
    //Firmware version number int type
    private long intSwversion;
    //bracelet mac address
    private String bleAddr;
｝

Bracelet bettary class:Power

public class Power {
    //bettary
    private int power;
｝

Bracelet set class:IWDevSetting

    //The value of 1 indicates that the LED is blinking, and 0 means the LED is off
    private int light;
    //A value of 1 indicates that gesture recognition is on, and a value of 0 means off
    private int gesture;
    //A value of 0 means that metric units are used and 1 means an English unit
    private int unit;
    //A value of 0 means that the use of hexadecimal display, 1 for 12-hexadecimal display
    private int is24Hour;
    //A value of 1 means automatic sleep, and a value of 0 means manual sleep
    private int autoSleep;
    //Backlight automatically open time, unit hours, 0 ~ 23, the default 0
    private int backLightSt;
    //Backlight automatically shut down time, unit hours, 0 ~ 23, the default 23
    private int backLightEt;
    //A value of 0 means a black background, and a value of 1 means a white background
    private int screen;
    //0: English 1: Chinese Simplified, default 0
    private int language;
    //Disconnect reminder, the value of 1 open disconnected reminder, the value of 0 turn off the reminder
    private int isConnectTipOpen;
    //Date format: 0: month / day, 1: day / month, default: 0
    private int is_dd_mm_format = -1;
    //Turn wrist bright screen function open time
    private int reverse_light_St = -1;
    //Turn wrist bright screen function off time
    private int reverse_light_Et = -1;
    //Automatic heart rate switch
    private int autoHr = -1;
    private int canFindPhone = -1;
    private int autoSpt = -1;
    private int isSmartTrackOpen = -1;
    private int wearingManner = -1;
    ｝

Bracelet button touch control:KeyModel

public class KeyModel {
    //Key event
    //A value of 0 means that normal mode is returned
    //A value of 1 indicates that the camera mode is entered
    //The value of 2 means to find the phone
    //A value of 8 indicates that the request is muted
    //A value of 9 indicates that the request is dropped
   //A value of 12 indicates a request to answer
    private int keyCode;
    ｝

Bracelet data synchronization information:StoredDataInfoTotal

public class StoredDataInfoTotal{
    //data type
    private int dataTypeNum;
    private List<StoredDataInfoDetail> infoList = new ArrayList();
    ｝

public class StoredDataInfoDetail {
    //type of data：0x28,0x29,0x51,0x53
    private int type;
    //start seq
    private int start_index;
    //end seq
    private int end_index;
    //max range
    private int max_range;
    ｝

Bracelet sleep data:ZeronerSleepData

public class ZeronerSleepData {
    private int year;
    private int month;
    private int day;
    //1:Fall asleep 2:get up 3:Deep sleep 4:Shallow sleep 5:place 6:wide awake
    private int type;
    //Some time to start a minute
    private int start;
    //Some end time
    private int end;
    //Reserved words
    private int allStart;
    private int allEnd;
    //seq
    public  int index;
    //duration
    private int times;
    //2 or 5 2：sleep 5：place
    private int mode;
    //Into sleep time
    private int sleep_enter;
    //Wake up time
    private int sleep_exit;
｝

Bracelet movement data:ZeronerSleepData

public class ZeronerDetailSportData {
    private int year;
    private int month;
    private int day;
    // Type of exercise
    private int sport_type;
    //Duration of exercise
    private int activity;
    //Movement start time (minutes)
    private int startMin;
    //End of exercise (minutes)
    private int endMin;
    //Step count
    private int steps;
    //Distance in meters:
    private float distance;
    //kcal
    private float calories;
    //Number of units of movement
    private int otherCount;
    public  int index;
｝

Bracelet daily total data freeze:TotalSportData

public class TotalSportData {
    private int year;
    private int month;
    private int day;
    private int steps;
    //unit kcal
    private float calories;
    //unit m
    private float distance;
    //The last tag of the data
    private boolean last;
    //type
    private int sport_type;
｝

Bracelet hour heart rate data:DataHourHeart

public class DataHourHeart {
    private int year;
    private int month;
    private int day;
    private int hour;
    //An hour 60 heart rate point
    private int[] rates;
    private int nowAdd53;
    //Last data tag
    private boolean last;
｝