# MinewSensorKit说明文档

本套SDK仅支持Minew公司出品的蓝牙传感器设备。通过SDK可以帮助开发者处理手机和传感器之间的一切工作，包括：扫描设备，广播数据、连接设备，向设备写入数据，从设备接收数据等。

目前SDK仅支持门磁传感器的使用。

# 前期工作

整体框架：S4SensorBleManager为设备管理类，在APP运行时始终是单例。S4SensorEntity是设备实例类，此套件会为每一个设备生成一个实例，在扫描和连接后都会使用，内部包含设备广播数据，在扫描期间该数据会随着设备不停广播而更新。

S4SensorBleManager：设备管理类，可以扫描周围的设备，并且可以连接它们，校验它们等；

S4SensorEntity：扫描时获取到的门磁传感器设备实例，继承自BaseBleDeviceEntity；

# 导入到工程

  1. 开发环境

    sdk最低支持Android 5.0，对应API Level为18。在module的build.gradle中设置minSdkVersion为21或21以上

    android {

    defaultConfig {
        applicationId "com.xxx.xxx"
        minSdkVersion 21
    }
}
    1
    2
    3
    4
    5
    6
    7

  2. 将 jar包添加到module的libs文件夹下，并在该module的build.gradle中添加如下语句（直接添加依赖）：

    implementation files('libs/base_ble_library.jar')
implementation files('libs/minew_s4.jar')
implementation 'org.lucee:bcprov-jdk15on:1.52.0'
    1
    2
    3

    或者右键该jar文件，选择Add as Library，添加到当前module。

    添加.so库文件，App目录下build.gradle添加如下配置

    android {
    defaultConfig {
  
        ndk {
            abiFilters 'armeabi-v7a','arm64-v8a','x86','x86_64'
        }

    }
    sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }
}
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14

  3. 在AndroidManifest.xml需要以下权限，如果targetSdkVersion大于23，则需要做权限管理以获取权限：

        <uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" tools:node="replace" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" tools:node="replace" />
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
    <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

    <!-- Required to maintain app compatibility. -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
        android:maxSdkVersion="32" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
        android:maxSdkVersion="32"
        />
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20

​

# 使用

sdk分为扫描、连接和读写三个阶段。

# 扫描部分

# 开始扫描

Android6.0系统以上，进行BLE扫描时，需要先申请到蓝牙权限后并且打开定位开关才能进行。

开启蓝牙扫描需要首先打开蓝牙，如果未打开蓝牙就去扫描，会导致报错。可通过BLETool.checkBluetooth(this)来判断蓝牙是否已经打开。如果没有打开，可以先打开蓝牙。

S4SensorBleManager mBleManager = 	S4SensorBleManager.getInstance();

switch (BLETool.checkBluetooth(this)){
    case BLE_NOT_SUPPORT:
        Toast.makeText(this, "Not Support BLE", Toast.LENGTH_SHORT).show();
        break;
    case BLUETOOTH_ON:
		//设置扫描时长5分钟，sdk默认扫描时长5分钟
		mBleManager.startScan(this, 5 * 60 * 1000, new OnScanDevicesResultListener<S4SensorEntity>() {

            @Override
            public void onScanResult(List<S4SensorEntity> list) {
                
            }

            @Override
            public void onStopScan(List<S4SensorEntity> list) {

            }

        });
        
        break;
    case BLUETOOTH_OFF:
        Intent enableIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
        startActivityForResult(enableIntent, 4);
        break;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

sdk内部并没有对蓝牙扫描时长进行处理，但是扫描是耗电操作，SDK默认5分钟就停止扫描了，如果还需要继续扫描，可以提供定时器或者刷新等操作以便继续调用扫描方法继续扫描设备。

# 取出数据

在扫描期间，APP能够通过sdk获取到设备当前的一部分数据。如下所示通过S4SensorEntity获取设备门磁传感器数据，该数据保存在广播帧对象中。

sdk提供了BaseBleDeviceEntity作为S4SensorEntity的基类，用于存储传感器设备的公有数据，如下表所示：

名称 类型 说明
macAddress String 设备mac
name String 设备名称
rssi int 信号强度

BaseBleDeviceEntity还保存了一个Map，内部用于存储其在扫描期间获取到的设备广播数据帧，可通过如下方式取出：

S4SensorEntity module;
DeviceStaticInfoFrame deviceInforFrame = (DeviceStaticInfoFrame)module.getMinewFrame(FrameType.DEVICE_INFORMATION_FRAME);
CombinationFrame combinationFrame = (CombinationFrame) module.getMinewFrame(FrameType.INDUSTRIAL_HT_FRAME);
if (deviceInforFrame != null) {
    //设备mac地址
    String macAddress = deviceInforFrame.getMacAddress();
    //电量百分比
    int battery = deviceInforFrame.getBattery();
    //固件版本
    String firmwareVersion = deviceInforFrame.getFirmwareVersion();
}

if (combinationFrame != null) {
    float doorSensorAlarmStatus = combinationFrame.getDoorSensorAlarmStatus();
    float tamperProofAlarmStatus = combinationFrame.getTamperProofAlarmStatus();
    float triggerAlarmStatus = combinationFrame.getTriggerAlarmStatus();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

门磁传感器设备有2种广播帧类型。

  1. 设备静态信息帧

    • DeviceStaticInfoFrame

      名称 类型 说明
      frameVersion int 设备类型
      firmwareVersion String 固件版本
      batteryLevel int 电池电量百分比
      macAddress String 固件mac
      peripheralSupportInfo PeripheralSupportInfo 外设支持描述，包含设备产品id

  2. 组合帧

    • CombinationFrame

      名称 类型 说明
      doorSensorAlarmStatus int 门磁报警状态，1打开，0关闭
      tamperProofAlarmStatus int 防拆报警状态，1触发，0正常
      triggerAlarmStatus int 触发报警状态，1打开，0关闭
      openCount int 门磁开门次数，最大 255，超过 255 后从零开始重新计数
      closeCount int 门磁关门次数，最大 255，超过 255 后从零开始重新计数
      tamperProofCount int 防拆开关开启次数，最大 255，超过 255 后从零开始重新计数

# 连接

连接前一般需要先停止扫描。sdk提供了连接和断开连接方法。

S4SensorBleManager mBleManager = 	S4SensorBleManager.getInstance();
//停止扫描
mBleManager.stopScan(context);
//设置设备秘钥
String key="3141592653589793";
mBleManager.setSecretKey(key);
//连接，module为准备连接的设备 
S4SensorEntity module;
mBleManager.connect(context,module);
1
2
3
4
5
6
7
8
9
10

注意：连接设备前，请确认是否扫描到设备，如果没扫描到设备广播，调用连接方法，将连接失败。

# 断开连接

S4SensorBleManager mBleManager = 	S4SensorBleManager.getInstance();
MST03Entity module;
//断开连接。macAddress为设备mac
mBleManager.disConnect(module.getMacAddress());
1
2
3
4

在调用connect()后，sdk中会对连接过程会有状态监听。

//设置监听器
mBleManager.setOnConnStateListener(new OnConnStateListener() {
    
    /*
     * 连接过程中的状态回调
     *
     * @param macAddress      设备mac
     * @param connectionState 状态
     */
    @Override
    public void onUpdateConnState(String address, BleConnectionState state) {
        switch (state) {
            case Disconnect:
				//连接失败或者设备断开连接会回调，主动断开不会回调该状态
                break;

            case Connecting:
				//调用connect()后就会回调该状态
                break;
            case Connected:
                //初步连接成功，作为一个过渡阶段，此时并未真正成功
                break;
            case AuthenticateFail:
				//秘钥检验失败。
                break;
            case AuthenticateSuccess:
				//秘钥检验成功，
                break;
            case ConnectComplete:
				//连接完成，此时设备可进行读写操作
                break;
            default:
                break;
        }
    }
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

在连接过程中，sdk会返回多个连接状态到app中，app需要做好处理。

  • BleConnectionState.Connecting，BleConnectionState.Connected: 连接设备中，在这里状态下不要做耗时操作，因为此时在连接设备发现服务，并发送认证数据等。
  • BleConnectionState.ConnectComplete: 此时传感器设备已经连接成功，可以进行读写操作，比如配置广播参数、传感器配置、读取历史数据等。
  • BleConnectionState.AuthenticateFail：认证过程中校验秘钥，输入的秘钥不正确，将回调这个状态并且设备主动断开连接。
  • BleConnectionState.AuthenticateSuccess：认证过程中校验秘钥，输入的秘钥正确，将回调这个状态。
  • BleConnectionState.Disconnect: 连接失败或者设备断开连接会回调。

# 读写

读写API如下：

    /**
     * 设置设备秘钥
     * @param macAddress 设备mac
     * @param secretKey 秘钥key
     * @param listener
     */
    void setDeviceSecretKey(String macAddress, String secretKey, OnModifyConfigurationListener listener);

    /**
     * 获取设备运行状态
     * @param macAddress mac地址
     * @param listener 监听器
     */
    void queryDeviceOperationStatus(String macAddress,OnQueryResultListener<DeviceOperationStatusConfig> listener);

    /**
     * 查询设备版本信息
     * @param macAddress 设备mac
     * @param listener   监听器
     */
    void queryDeviceFirmwareInfo(String macAddress, OnQueryResultListener<FirmwareVersionModel>  listener);

    /**
     * 读取历史数据
     *
     * @param macAddress 设备mac
     * @param rules 历史数据获取规则，0 表示获取所有数据, 1 表示获取某个时间段的数据,当rules==0,startTime、endTime 都不需要传，默认传0
     * @param startTime 起始时间戳 单位：秒
     * @param endTime 结束时间戳 单位：秒，不能大于systemTime
     * @param systemTime 系统实时时间戳 单位：秒
     * @param listener   监听器
     */
    void queryHistoryData(String macAddress,int rules,long startTime,long endTime,long systemTime, OnQueryResultListener<HistoryDoorMagnetData>  listener);




    /**
     * 查询广播帧广播参数
     * @param macAddress 设备mac
     * @param slot 查询广播的通道值，默认值0，DeviceStaticInfoFrame slot=0,CombinationFrame slot=1
     * @param listener   监听器
     */
    void queryAdvParametersConfiguration(String macAddress,int slot,  OnQueryResultListener<AdvParametersConfig>  listener);
    /**
     * 设置广播帧广播参数
     *
     * @param macAddress 设备mac
     * @param frameType FrameType枚举获取 getFrameTypeVersion()
     * @param slotNumber 设置广播对应的通道值
     * @param advertisingInterval 广播间隔 单位毫秒,广播间隔 1s ~ 60s 可调，刻度为 1s；
     * @param txPower -40 -20 -16 -12 -8 -4 0 4dBm
     * @param listener   监听器
     */
    void setAdvParametersConfiguration(String macAddress,String frameType, int slotNumber,int advertisingInterval, int txPower, OnModifyConfigurationListener listener);



    /**
     * 查询触发器
     * @param macAddress mac地址
     * @param listener 监听器
     */
    void queryTriggerConfiguration(String macAddress, OnQueryResultListener<List<TriggerConfigBean>> listener);

    /**
     * 设置触发器
     * @param macAddress mac地址
     * @param triggerConfigList 触发器配置数据
     * @param listener 监听器
     */
    void setTriggerConfiguration(String macAddress, List<TriggerConfigBean> triggerConfigList, OnModifyConfigurationListener listener);

    /**
     * 查询开关功能选项
     * @param macAddress mac地址
     * @param listener 监听器
     */
    void queryOptionSwitch(String macAddress, OnQueryResultListener<List<OptionSwitchConfig>> listener);


    /**
     * 设置开关功能选项
     * @param macAddress mac地址
     * @param optionValue 开关值 0或者1
     * @param listener 监听器
     */
    void setLightOptionSwitch(String macAddress, int optionValue, OnModifyConfigurationListener listener);


    /**
     * 设置数据存储功能选项
     * @param macAddress mac地址
     * @param optionValue 开关值 0或者1
     * @param listener 监听器
     */
    void setDataStoreOptionSwitch(String macAddress, int optionValue, OnModifyConfigurationListener listener);

    /**
     * 同步设备Linux时间
     * @param macAddress mac地址
     * @param timestamp 系统当前时间，单位：秒
     * @param listener 监听器
     */
    void setSyncTime(String macAddress,long timestamp,OnModifyConfigurationListener listener);

    /**
     * 查询工作的时间段
     * @param macAddress mac地址
     * @param listener 监听器
     */
    void queryWorkPeriodsConfiguration(String macAddress, OnQueryResultListener<WorkPeriodsListConfig> listener);

    /**
     * 设置工作的时间段
     * @param macAddress mac地址
     * @param workPeriodConfigList 工作的时间段数据
     * @param listener 监听器
     */
    void setWorkPeriodsConfiguration(String macAddress, List<WorkPeriodConfig> workPeriodConfigList, OnModifyConfigurationListener listener);


    /**
     * 校验OTA升级文件的正确性
     * @param zipFilePath ota升级文件路径
     * @return true=s4升级文件，false= 不是s4文件
     */
    boolean verifyOtaFile(String zipFilePath);

	/**
     * 固件升级
     *
     * @param macAddress  设备mac
     * @param isLinkUpgrade true url升级，false 固件包升级。默认值false,不支持url升级方式
     * @param dfuTarget isLinkUpgrade =true, dfuTarget = 0
     * @param upgradeData 升级包数据
     * @param listener    监听器
     */
    public void firmwareUpgrade(String macAddress,boolean isLinkUpgrade,int dfuTarget,byte[] upgradeData, 		 OnFirmwareUpgradeListener listener);


    /**String macAddress
     * 恢复出厂设置
     *
     * @param macAddress 设备mac
     * @param listener   监听器
     */
    public void reset(String macAddress, OnModifyConfigurationListener listener);

    /**
     * 关机
     * @param macAddress 设备mac
     * @param listener   监听器
     */
    public void powerOff(String macAddress, OnModifyConfigurationListener listener);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

# 对部分方法进行补充说明：

连接设备成功后下发命令，请确保在子线程中进行，并且不能并发执行多条命令。

  1. 设置设备秘钥。连接设备前必须先调用该方法设置秘钥。

    S4SensorBleManager mBleManager = S4SensorBleManager.getInstance();
String secretKey = "3141592653589793"
mBleManager.setSecretKey(mAddress,secretKey);
    1
    2
    3
    4

  2. 同步设备时间。

    S4SensorBleManager mBleManager = S4SensorBleManager.getInstance();
mBleManager.setSyncTime(mMac, System.currentTimeMillis() / 1000, new OnModifyConfigurationListener() {
    @Override
    public void onModifyResult(boolean b) {
        Toast.makeText(context,"SyncTime Result:"+b,Toast.LENGTH_LONG).show();
    }
});
    1
    2
    3
    4
    5
    6
    7

  3. 查询设备运行状态。

    S4SensorBleManager mBleManager = S4SensorBleManager.getInstance();
mBleManager.queryDeviceOperationStatus(macAddress,new OnQueryResultListener<DeviceOperationStatusConfig>() {
            @Override
            public void OnQueryResult(boolean b, DeviceOperationStatusConfig deviceOperationStatus) {
				//b true查询成功，false查询失败
                Toast.makeText(context,"Query Result:"+b,Toast.LENGTH_LONG).show();
                if(b){
                    int battery = deviceOperationStatus.getBattery();
                    long sinceBootInSeconds = deviceOperationStatus.getSinceBootInSeconds();
                }
            }
        });
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12

  4. 查询设备版本信息。

    S4SensorBleManager mBleManager = S4SensorBleManager.getInstance();
    /**
     * 查询设备版本信息
     * @param macAddress 设备mac
     * @param listener   监听器
     */
mBleManager.queryDeviceFirmwareInfo(macAddress,new OnQueryResultListener<FirmwareVersionModel>() {
            @Override
            public void OnQueryResult(boolean b, FirmwareVersionModel firmwareVersionModel) {
				//b true查询成功，false查询失败firmwareVersionModel=null。
                Toast.makeText(context,"Query Result:"+b,Toast.LENGTH_LONG).show();
                if(b){
                    List<VersionInfo> versionInfoList = firmwareVersionModel.getVersionInfoList();
                    String firmwareName = versionInfoList.get(0).getFirmwareName();
                    int firmwareType = versionInfoList.get(0).getFirmwareType();
                    String firmwareVersion = versionInfoList.get(0).getFirmwareVersion();
                }
            }
        });
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19

  5. 查询广播帧广播参数和配置广播参数。

        /**
     * 设置广播帧广播参数
     *
     * @param macAddress 设备mac
     * @param frameType FrameType枚举获取 
     * @param slotNumber 设置广播对应的通道值 默认值0，最大不超过1，DeviceStaticInfoFrame slot=0,CombinationFrame slot=1
     * @param advertisingInterval 广播间隔 单位毫秒,(DeviceStaticInfoFrame, 广播间隔100ms ~ 60000ms 可调，刻度为 100ms)；		   		 *	(CombinationFrame, 广播间隔 1s ~ 60s 可调，刻度为 1s)；
     * @param txPower -40 -20 -16 -12 -8 -4 0 4dBm
     * @param listener   监听器
     */
S4SensorBleManager mBleManager = S4SensorBleManager.getInstance();
S4SensorEntity module
String macAddress = module.getMacAddress();
//slot = 0 DeviceStaticInfoFrame 、slot = 1 CombinationFrame
//查询DeviceStaticInfoFrame广播帧广播  
AdvParametersConfig deviceInfoAdvParametersConfig = null;
mBleManager.queryAdvParametersConfiguration(macAddress, 0, new OnQueryResultListener<AdvParametersConfig>() {
    @Override
    public void OnQueryResult(boolean b, AdvParametersConfig advParametersConfig) {
        if(b){
            deviceInfoAdvParametersConfig = advParametersConfig;
        }
        Toast.makeText(context,"Query Adv Result:"+b,Toast.LENGTH_LONG).show();
    }
});
//设置DeviceStaticInfoFrame广播帧参数
mBleManager.setAdvParametersConfiguration(macAddress, 
         deviceInfoAdvParametersConfig.getFrameType(), 	
         deviceInfoAdvParametersConfig.getSlotNumber(),
        deviceInfoAdvParametersConfig.getAdvertisingInterval(),
        deviceInfoAdvParametersConfig.getTxPower(),new OnModifyConfigurationListener() {
    @Override
    public void onModifyResult(boolean b) {

        Toast.makeText(context,"Set Adv Parameters Result:"+b,Toast.LENGTH_LONG).show();
    }
});

//查询CombinationFrame广播帧广播 
AdvParametersConfig combinationAdvParametersConfig= null
mBleManager.queryAdvParametersConfiguration(macAddress, 1, new OnQueryResultListener<AdvParametersConfig>() {
    @Override
    public void OnQueryResult(boolean b, AdvParametersConfig advParametersConfiguration) {
        if(b){
            combinationAdvParametersConfiguration = advParametersConfiguration;
        }
        Toast.makeText(context,"Query Adv Result:"+b,Toast.LENGTH_LONG).show();
    }
});
//设置CombinationFrame广播帧参数
mBleManager.setAdvParametersConfiguration(macAddress, 
         combinationAdvParametersConfig.getFrameType(), 		
         combinationAdvParametersConfig.getSlotNumber(),
        combinationAdvParametersConfig.getAdvertisingInterval(),
        combinationAdvParametersConfig.getTxPower(),new OnModifyConfigurationListener() {
    @Override
    public void onModifyResult(boolean b) {

        Toast.makeText(context,"Set Adv Parameters Result:"+b,Toast.LENGTH_LONG).show();
    }
});
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61

  6. 查询触发器参数和配置触发器参数。

    S4SensorBleManager mBleManager = S4SensorBleManager.getInstance();
S4SensorEntity module;
String macAddress = module.getMacAddress();
List<TriggerConfigBean> mTriggerConfigBeanList = new ArrayList<>()
//查询触发器
mBleManager.queryTriggerConfiguration(macAddress, new OnQueryResultListener<List<TriggerConfigBean>>() {
    @Override
    public void OnQueryResult(boolean b, List<TriggerConfigBean> triggerConfigBeanList) {
        if(b){
               mTriggerConfigBeanList.clear();
               mTriggerConfigBeanList.addAll(triggerConfigBeanList);
               for (TriggerConfigBean triggerConfigBean : triggerConfigBeanList) {
                    LogUtil.d("triggerConfig:"+triggerConfigBean.toString());
               }
        }
        Toast.makeText(context,"Query Adv Result:"+b,Toast.LENGTH_LONG).show();
    }
});
//设置触发器
//广播间隔 广播间隔 100ms ~ 60000ms 可调，刻度为 100ms； 
//广播时长 1s~900s可调，刻度为1s
//广播功率 -40 -20 -16 -12 -8 -4 0 4dBm
mBleManager.setTriggerConfiguration(macAddress, mTriggerConfigBeanList, new OnModifyConfigurationListener() {
            @Override
   public void onModifyResult(boolean b) {
           Toast.makeText(context,"Set Trigge Parameters Result:"+b,Toast.LENGTH_LONG).show();
    }
});
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28

  7. 查询和配置设备开关状态。

    S4SensorBleManager mBleManager = S4SensorBleManager.getInstance();
S4SensorEntity module;
String macAddress = module.getMacAddress();
//查询开关状态
List<OptionSwitchConfig> mOptionSwitchConfigList = new ArrayList<>()
mBleManager.queryOptionSwitch(macAddress,  new OnQueryResultListener<List<OptionSwitchConfig>>(){
    @Override
    public void OnQueryResult(boolean b, List<OptionSwitchConfig> optionSwitchConfigs) {
        if(b){
            mOptionSwitchConfigList.clear();
            mOptionSwitchConfigList.addAll(optionSwitchConfigs);
            for (OptionSwitchConfig optionSwitchConfig : optionSwitchConfigs) {
                //type == 5,light effect switch; optionStatus == 1, open ;optionStatus == 0,close;
                // type == 6, data store switch; optionStatus == 1, open ;optionStatus == 0,close;
                LogUtil.d("optionSwitchConfig:"+optionSwitchConfig.toString());
            }
        }
        Toast.makeText(context,"Query Switch Result:"+b,Toast.LENGTH_LONG).show();
    }
});

//设置门磁灯效开关
//optionStatus == 1, open ;optionStatus == 0,close;
int optionStatus = 1;
mBleManager.setLightOptionSwitch(macAddress, optionStatus,
        new OnModifyConfigurationListener(){

            @Override
            public void onModifyResult(boolean b) {
				Toast.makeText(context,"Set Switch Result:"+b,Toast.LENGTH_LONG).show();
            }
});
//设置存储数据开关
//optionStatus == 1, open ;optionStatus == 0,close;
int optionStatus = 1;
mBleManager.setDataStoreOptionSwitch(macAddress, optionStatus,
        new OnModifyConfigurationListener(){

            @Override
            public void onModifyResult(boolean b) {
				Toast.makeText(context,"Set Switch Result:"+b,Toast.LENGTH_LONG).show();
            }
});
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43

  8. 查询和设置设备工作时间段。

    S4SensorBleManager mBleManager = S4SensorBleManager.getInstance();
S4SensorEntity module;
String macAddress = module.getMacAddress();
//查询工作时间段
mBleManager.queryWorkPeriodsConfiguration(mMac, new OnQueryResultListener<WorkPeriodsListConfig>() {
    @Override
    public void OnQueryResult(boolean b, WorkPeriodsListConfig workPeriodsListConfig) {
        if(b){
            mWorkPeriodsListConfig = workPeriodsListConfig;
            for (WorkPeriodConfig workPeriodConfig : mWorkPeriodsListConfig.getConfigList()) {
            	//开始时间，单位秒
                long startTime = workPeriodConfig.getStartTime();
                int hours = startTime / 3600;
        		int minutes = (startTime % 3600) / 60;
        		int seconds = startTime % 60;
                //结束时间，单位秒：getStartTime()+getDuration()
                long endTime = workPeriodConfig.getStartTime()+workPeriodConfig.getDuration();
                int hours2 = endTime / 3600;
        		int minutes2 = (endTime % 3600) / 60;
        		int seconds2 = endTime % 60;
                //workPeriodConfig.getDuration()==0,disable;workPeriodConfig.getDuration()>0,enable;
                LogUtil.d("workPeriodConfig:"+workPeriodConfig.toString());
            }
        }
        Toast.makeText(context,"Query WorkPeriods Result:"+b,Toast.LENGTH_LONG).show();
    }
});

//设置工作时间段
mBleManager.setWorkPeriodsConfiguration(mMac, mWorkPeriodsListConfig.getConfigList(), new OnModifyConfigurationListener() {
    @Override
    public void onModifyResult(boolean b) {
		Toast.makeText(context,"Set WorkPeriods Result:"+b,Toast.LENGTH_LONG).show();
    }
});
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35

  9. 查询门磁历史数据

        /**
     * 读取历史数据
     *
     * @param macAddress 设备mac
     * @param rules 历史数据获取规则，0 表示获取所有数据, 1 表示获取某个时间段的数据,当rules==0,startTime、endTime 都不需要传，默认传0
     * @param startTime 起始时间戳 单位：秒
     * @param endTime 结束时间戳 单位：秒
     * @param systemTime 实时时间戳 单位：秒
     * @param listener   监听器
     */
long systemTime = System.currentTimeMillis()/1000;
long startTime = (systemTime-60*60*1000*24)/1000;
long endTime = systemTime/1000;

int rule = 0;

mBleManager.queryHistoryData(macAddress,rule, startTime, endTime, systemTime, new OnQueryResultListener<HistoryHtData>() {

    @Override
    public void OnQueryResult(boolean b, HistoryHtData historyHtData) {
        if(b){
               List<HtData> htDataList = historyHtData.getHistoryDataList();
               for (HtData htData : htDataList) {
                        
               }
        }else{
            Toast.makeText(context,"selectHTHistoryData Result: fail",Toast.LENGTH_LONG).show();
        }

    }


});
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33

  10. 固件升级。

    /**
 * 固件升级
 *
 * @param macAddress  设备mac
 * @param upgradeData 升级包数据
 * @param listener    监听器
 */
mBleManager.firmwareUpgrade(mac,false,0 upgradeData, new OnFirmwareUpgradeListener() {
    
    /**
     * 升级包数据写入进度
     */
    @Override
    public void updateProgress(int progress) {
		
    }

    /**
     * 升级成功回调，此时设备会主动跟手机断开连接，所以会触发OnConnStateListener回调，返回
     * BleConnectionState.Disconnect状态
     */
    @Override
    public void upgradeSuccess() {

    }
    
    /**
     * 升级失败
     */
    @Override
    public void upgradeFailed() {

    }
});
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34

  11. 恢复出厂设置

    /**
 * 恢复出厂设置
 *
 * @param macAddress 设备mac
 */
mBleManager.reset(macAddress, new OnModifyConfigurationListener() {
    @Override
    public void onModifyResult(boolean success) {

    }
});
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11

  12. 关机。

    /**
 * 关机
 *
 * @param macAddress 设备mac
 */
mBleManager.powerOff(macAddress, new OnModifyConfigurationListener() {
    @Override
    public void onModifyResult(boolean success) {

    }
});
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11

# 历史记录

  • **2024/03/27添加编辑文档；
上次更新:: 2024/3/27 10:42:30