Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/chenliangloveyou/EasyBluetooth

一款iOS BLE蓝牙调试工具，非常简单容易，也可以作为一个蓝牙库，快速集成和开发。可以两步搞定蓝牙开发操作。第一步连接设备，第二步特征读写数据。
https://github.com/chenliangloveyou/EasyBluetooth

ble bluetooth bluetoothkit ios ios-ble ios-bluetooth iosbluetooth lightblue sdk

Last synced: about 2 months ago
JSON representation

一款iOS BLE蓝牙调试工具，非常简单容易，也可以作为一个蓝牙库，快速集成和开发。可以两步搞定蓝牙开发操作。第一步连接设备，第二步特征读写数据。

Host: GitHub
URL: https://github.com/chenliangloveyou/EasyBluetooth
Owner: chenliangloveyou
Created: 2017-03-16T06:31:27.000Z (almost 8 years ago)
Default Branch: master
Last Pushed: 2018-03-01T07:42:11.000Z (almost 7 years ago)
Last Synced: 2023-11-07T14:12:29.228Z (about 1 year ago)
Topics: ble, bluetooth, bluetoothkit, ios, ios-ble, ios-bluetooth, iosbluetooth, lightblue, sdk
Language: Objective-C
Homepage:
Size: 9.36 MB
Stars: 334
Watchers: 13
Forks: 95
Open Issues: 11
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

awesome - EasyBluetooth - 一款iOS BLE蓝牙调试工具，非常简单容易，也可以作为一个蓝牙库，快速集成和开发。可以两步搞定蓝牙开发操作。第一步连接设备，第二步特征读写数据。【 [Priview 1](https://github.com/chenliangloveyou/EasyBluetooth/raw/master/EasyBlueTooth/EasyBlueTooth/preview/preview_1.gif) | [Priview 2](https://github.com/chenliangloveyou/EasyBluetooth/raw/master/EasyBlueTooth/EasyBlueTooth/preview/preview_2.gif) | [Priview 3](https://github.com/chenliangloveyou/EasyBluetooth/raw/master/EasyBlueTooth/EasyBlueTooth/preview/preview_3.png) | [Priview 4](https://github.com/chenliangloveyou/EasyBluetooth/raw/master/EasyBlueTooth/EasyBlueTooth/preview/preview_4.png) 】 (OOM-Leaks-Crash / Bluetooth)

README

        # EasyBluetooth

一款iOS BLE蓝牙调试工具，非常简单容易，也可以作为一个蓝牙库，快速集成和开发。

可以两步搞定蓝牙开发操作。

第一步连接设备，第二步特征读写数据。

# Preview

![image](https://github.com/chenliangloveyou/EasyBluetooth/blob/master/EasyBlueTooth/EasyBlueTooth/preview/preview_1.gif)

![image](https://github.com/chenliangloveyou/EasyBluetooth/blob/master/EasyBlueTooth/EasyBlueTooth/preview/preview_2.gif)

![image](https://github.com/chenliangloveyou/EasyBluetooth/blob/master/EasyBlueTooth/EasyBlueTooth/preview/preview_3.png)

![image](https://github.com/chenliangloveyou/EasyBluetooth/blob/master/EasyBlueTooth/EasyBlueTooth/preview/preview_4.png)

# 使用方法

*[(第一步)参数配置](###(第一步)参数配置)<这一步可以省略>

*[(第二步)扫描并连接设备](###(第二步)扫描并连接设备)

*[(第三步)读写操作](###(第三步)读写操作)

### (第一步)参数配置

#### 参数讲解(如下参数都可不传)

    note：如果传入线程，那么返回数据的UI操作需要放到主线程上

    @property (nonatomic,strong)dispatch_queue_t managerQueue ;

    

    CBCentralManagerOptionShowPowerAlertKey  默认为NO，系统当蓝牙关闭时是否弹出一个警告框

    CBCentralManagerOptionRestoreIdentifierKey 系统被杀死，重新恢复centermanager的ID

    @property (nonatomic,strong)NSDictionary *managerDictionary ;

    

    CBCentralManagerScanOptionAllowDuplicatesKey  默认为NO，过滤功能是否启用，每次寻找都会合并相同的peripheral。如果设备YES的话每次都能接受到来自peripherals的广播包数据。

    CBCentralManagerScanOptionSolicitedServiceUUIDsKey  想要扫描的服务的UUID，以一个数组的形式存在。扫描的时候只会扫描到包含这些UUID的设备。

    @property (nonatomic,strong)NSDictionary *scanOptions ;

  

    连接设备所需的服务.

    @property (nonatomic,strong)NSArray *scanServiceArray ;

    

    CBConnectPeripheralOptionNotifyOnConnectionKey    默认为NO，APP被挂起时，这时如果连接到peripheral时，是否要给APP一个提示框。

    CBConnectPeripheralOptionNotifyOnDisconnectionKey 默认为NO，APP被挂起时，恰好在这个时候断开连接，要不要给APP一个断开提示。 

    CBConnectPeripheralOptionNotifyOnNotificationKey  默认为NO，APP被挂起时，是否接受到所有的来自peripheral的包都要弹出提示框。

    @property (nonatomic,strong)NSDictionary *connectOptions ;//连接设备时所带的条件`

    扫描所需时间。默认为永久

    @property (nonatomic,assign)NSUInteger scanTimeOut ;

    连接设备最大时长 默认为5秒

    @property (nonatomic,assign)NSUInteger connectTimeOut ;

    断开连接后重新连接

    @property (nonatomic,assign)BOOL autoConnectAfterDisconnect ;

  

    

#### 获取单例，并赋值配置信息

    /**

     * 获取单例

    */

     + (instancetype)shareInstance ;

    /**

     * 创建配置信息

     */

    EasyManagerOptions *options = [EasyManagerOptions alloc]init];

    options.autoConnectAfterDisconnect - YES ;

    options.connectTimeOut = 6 ;

    /**

     * 设置配置信息

     */

     [EasyBlueToothManager shareInstance].managerOptions = options ;

### (第二步)扫描并连接设备 

#### 场景1，扫描设备名称后直接连接设备

```

/**

 * 连接一个已知名字的设备

 * name 设备名称

 * callback 连接设备的回调信息

 */

- (void)scanAndConnectDeviceWithName:(NSString *)name

                            callback:(blueToothScanCallback)callback ;

   ```

   

#### 场景2，扫描设备后选择一些符合规则的设备后连接

```

/**

 * 连接一个一定规则的设备，依据peripheral里面的名称，广播数据，RSSI来赛选需要的连接的设备

 * name 设备名称

 * callback 连接设备的回调信息

 */

- (void)scanAndConnectDeviceWithRule:(blueToothScanRule)rule

                            callback:(blueToothScanCallback)callback ;

```

#### 场景3，需要保存设备，然后直接连接单个设备

```

1，先扫描符合规则的设备 选择一个保存设备的uuid到本地

/**

 * 根据规则扫描符合名称的所有设备

 */

- (void)scanAllDeviceWithRule:(blueToothScanRule)rule

                     callback:(blueToothScanAllCallback)callback ;

 ```

```

2，取出上一步中保存的uuid直接连接

/**

 * 连接一个确定ID的设备，一般此ID可以保存在本地。然后直接连接

 * name 设备名称

 * callback 连接设备的回调信息

 */

- (void)scanAndConnectDeviceWithIdentifier:(NSString *)identifier

                                  callback:(blueToothScanCallback)callback ;

  ```

#### 场景4，单纯的操作一些设备信息，可以采用一行代码

```

/**

 * 一行代码连接所有的设备

 * name         一直设别的名称

 * serviceuuid  服务id

 * notifyuuid   监听端口的id

 * writeuuid    写数据的id

 * data         需要发送给设备的数据

 * callback     回调信息

 */

- (void)connectDeviceWithName:(NSString *)name

                  serviceUUID:(NSString *)serviceUUID

                   notifyUUID:(NSString *)notifyUUID

                    wirteUUID:(NSString *)writeUUID

                    writeData:(NSData *)data

                     callback:(blueToothOperationCallback)callback;

```

#### 场景5，需要连接多个设备

```

/**

 * 连接已知名称的所有设备（返回的是一组此名称的设备全部连接成功）

 * name 设备名称

 * callback 连接设备的回调信息

 */

- (void)scanAndConnectAllDeviceWithName:(NSString *)name

                               callback:(blueToothScanAllCallback)callback ;

/**

 * 连接已知规则的全部设备（返回的是一组此名称的设备全部连接成功）

 * name 设备名称

 * callback 连接设备的回调信息

 */

- (void)scanAndConnectAllDeviceWithRule:(blueToothScanRule)rule

                               callback:(blueToothScanAllCallback)callback ;

  ```

    

### (第三步)读写操作

#### 写数据

```

/**

 * peripheral 写数据的设备

 * data  需要写入的数据

 * uuid 数据需要写入到哪个特征下面

 * writeCallback 写入数据后的回调

 */

- (void)writeDataWithPeripheral:(EasyPeripheral *)peripheral

                    serviceUUID:(NSString *)serviceUUID

                      writeUUID:(NSString *)writeUUID

                           data:(NSData *)data

                       callback:(blueToothOperationCallback)callback ;

```

#### 读数据

```

/**

 * peripheral 写数据的设备

 * uuid 需要读取数据的特征

 * writeCallback 读取数据后的回调

 */

- (void)readValueWithPeripheral:(EasyPeripheral *)peripheral

                    serviceUUID:(NSString *)serviceUUID

                       readUUID:(NSString *)uuid

                       callback:(blueToothOperationCallback)callback ;

```

#### 监听特征

     建议此方法放在读写操作的前面

```

/**

 * peripheral 写数据的设备

 * uuid 需要监听的特征值

 * writeCallback 读取数据后的回调

 */

- (void)notifyDataWithPeripheral:(EasyPeripheral *)peripheral

                     serviceUUID:(NSString *)serviceUUID

                      notifyUUID:(NSString *)notifyUUID

                     notifyValue:(BOOL)notifyValue

                    withCallback:(blueToothOperationCallback )callback ;

```              

# 蓝牙学习资料

- [iOS Bluetooth 蓝牙(1)- 蓝牙基本原理](http://www.jianshu.com/p/a72a005190c7)

- [iOS Bluetooth 蓝牙(2)- 类详细介绍](http://www.jianshu.com/p/6e3984aa76c2)

- [iOS Bluetooth 蓝牙(3)- Easybluetooth讲解](http://www.jianshu.com/p/f23d04284c61)

- [iOS Bluetooth 蓝牙(4)- 蓝牙后台模式](http://www.jianshu.com/p/9974a19ff9aa)

# 联系作者

如果在使用过程中遇到任务问题，或者发现使用不够恰当。希望能Issues我。

email: [email protected]