米纽传感器套件SDK

# MTSensorKit Documentation
This set of SDK only supports the Bluetooth Sensor device produced by Minew, 目前是温湿度传感器和门磁传感器. SDK可以帮助开发者处理手机和Sensor之间的所有工作, 包括: 扫描设备, 连接设备, 将数据写入设备, 从设备接收数据, ETC.

## Preliminary work

Overall framework: MTCentralManager是设备管理类, APP运行时始终是单例. MTPeripheral是设备实例类. 该套件将为每个设备生成一个MTPeripheral实例，方便监控和操作设备.
MTCentralManager : 设备管理类, 可以扫描周围的Sensor设备, 并可以连接它们, 验证它们, ETC.

**MTP外设** : 设备实例类. 当 MTCentralManager 发现物理设备时, MTCentralManager会生成一个MTPeripheral实例, 对应物理设备.

**MTBroadcastHandler** : 设备广播类, 可以在设备广播时获取数据.

**MTConnectionHandler** : 用于从设备接收和发送数据的设备连接类.

**MTU 直到** : 写数据指令.

## 开始
### 开发环境:
-Xcode10 +, 目前的SDK是用Xcode11编译的, 请使用Xcode10及以上版本进行开发; -iOS11, 最低系统版本为iOS11;
### 导入到项目中:

1. CocoaPods
MTSensorKit is available through CocoaPods. 安装它, 只需将以下行添加到您的 Podfile 中, 然后导入 <MTSensorKit>:

```c
pod 'MTSensorKit'
```

2. Manually
Copy the development kit files: 将MTSensorKit.framework文件复制到工程项目目录下, 然后将它们添加到项目中.

聚苯乙烯:
!!! 在iOS10及以上版本, Apple 添加了蓝牙 APi 的权限限制. 您需要将一个字符串添加到项目的 info.plist 文件中: 隐私-蓝牙周边使用说明-"您的使用说明".
!!! 在iOS13及以上版本, Apple 添加了蓝牙 APi 的权限限制. 您需要将一个字符串添加到项目的 info.plist 文件中: 隐私-蓝牙始终使用说明-"您的使用说明".
### 开始开发
#### Scanning equipment
First you need to get the singleton of MTCentralManager, 然后查看手机当前的蓝牙状态, 然后你可以扫描设备.

````c
// Get Manager singleton
MTCentralManager * 经理= [MTCentralManager共享实例];

调度_之后 (调度时间 (DISPATCH_TIME_NOW, (int64_t) (1 * NSEC_PER_SEC)), 调度获取主队列 (), ^ {
    // The current state of the Bluetooth switch on the mobile phone
    if (self-> manager.status == PowerStatePoweredOn) {
        // 开始设备扫描
        [管理员开始扫描: ^ (NSArray <MTPeripheral *> * 设备) {
        //根据广播属性类型, 可以过滤所需的传感器类型.
        self-> deviceAry = devices;
    }];
    }
});
// 扫描的设备也可以使用manager.scannedPeris获取
// 如果您需要响应手机蓝牙状态. 请监听回调.
[经理 didChangesBluetoothStatus: ^ (电源状态) {
  转变 (地位) {
    案例 PowerStatePoweredOn:
        NS日志 (@ "蓝牙状态更改为开机");
        休息;
    案例 PowerStatePoweredOff:
        NS日志 (@ "蓝牙状态更改为关机");
        休息;
    案例电源状态未知:
        NS日志 (@ "蓝牙状态更改为未知");
	}
}];
```

**PS: 整个SDK仅在手机蓝牙状态为Poweron时才起作用。**
#### Connect to device
```c
// The scanned device can be obtained from the previous step
MTPeripheral * 设备=设备Ary [0];
// 连接设备
[连接外设管理器: 设备];
// 监听设备连接状态.
[p.connector didChangeConnection: ^ (连接方式 连接方式) {
    如果 (连接==已验证) {
      // 验证成功, successfully connected to the device
        NSLog (@ "已验证的");
      //需要写密码, 密码验证成功后进行其他操作
    }
    如果 (连接==断开) {
        NS日志 (@ "设备已断开连接。");
    }
}];
````
#### Write data to the device
Take the next step, 当手机与设备成功建立连接且认证成功时, 该设备可以读写.
1. Write data

```c
//Obtain the corresponding command data through MTUtils, 例如:
NSData *数据= [MTUtils 验证密码:@"123456"];
[self-> _ per.connector writeData: 数据补全: ^ (布尔成功, NS错误 * _一些错误) {
   如果 (错误) {
       NS日志 (@ "写入数据失败:% @", 错误);
   }
   别的 {
       NS日志 (@ "写入数据成功");
   }
}];
````

2. Receive data

```c
[_per.connector didReceiveData: ^ (国家数据中心 * _非空日期) {
   如果 (数据) {
       NS日志 (@ "接收数据成功:% @", 数据);
    }
    别的 {
       NS日志 (@ "接收数据失败");
    }
   }
}];
````
## 日程

### MTCentralManager 属性说明

| 姓名 | 类型 | 描述 |
| -------- | -------- | -------- |
| 地位     | 电源状态     | 手机的蓝牙状态     |
| 扫描佩里斯     | NSArray     | 扫描设备    |

### MTPeripheral 属性说明
| 姓名	 | 类型  |	描述 |
| -------- | -------- | -------- |
| 标识符	| NS字符串	| 设备标识符 |
| 播送	| MT广播处理程序	| MTBroadcastHandler 对象 |
| 连接器 |	MT连接处理程序	| MTConnectionHandler 对象 |

### MTBroadcastHanler 属性说明
| 姓名	 | 类型  |	描述 |
| -------- | -------- | -------- |
| 姓名	| NS字符串	| 设备名称 | 
| 接收信号强度	| NS整数	| 设备接收信号强度指示 | 
| 电池	| NS字符串	| 设备电池 | 
| 苹果	| NS字符串	| 设备 Mac | 
| 标识符	| NS字符串	| 设备标识符 | 
| 温度	| 双倍的	| 设备温度 | 
| 在地面上	| 双倍的	| 设备湿度 | 
| 资源信息	| uint8_t	| 设备温度单位标志 | 
| 类型	| 传感器类型	| 设备类型 | 
| 按状态	| NS字符串	| 设备门状态| 
| 警告状态	| uint8_t	| 设备报警状态 |

| 姓名	 | 类型  |	描述 |
| -------- | -------- | -------- |
| 姓名	| NS字符串	| 设备名称 | 
| 接收信号强度	| NS整数	| 设备接收信号强度指示 | 
| 苹果	| NS字符串	| 设备 Mac | 
| 标识符	| NS字符串	| 设备标识符 | 
| 固定版本	| NS字符串	| 固件版本 | 
| 硬件版本	| NS字符串	| 硬件版本 | 
| 屏幕信息	| NS字符串	| 屏幕信息 | 
| 电池	| NS字符串	| 电池 | 
| 芯片温度	| 双倍的	| 芯片温度 | 
| 心跳	| NS字符串	| 心跳 | 
| 标签RSSI	| NS字符串	| 标签RSSI | 
| 芯片信息	| NS字符串	| 芯片信息 | 
| 图像ID数据	| 国家数据中心	| 图像ID数据 | 
| 错误代码	| NS整数	| 错误代码 | 
| 外设支持	| NS字符串	| 外设支持 | 
	
### MTConnectionHandler 属性说明
| 姓名	 | 类型  |	描述 |
| -------- | -------- | -------- |
| mac字符串	| NS字符串	| 设备 Mac | 
| 联系	| 联系	| 设备连接状态 |