MinewSensorKit SDK

# MTSensorKit Documentation
This set of SDK only supports the Bluetooth Sensor device produced by Minew, 현재 온도 및 습도 센서와 도어 센서입니다.. SDK는 개발자가 휴대폰과 센서 간의 모든 작업을 처리하는 데 도움이 될 수 있습니다., 포함: 스캐닝 장치, 연결 장치, 장치에 데이터 쓰기, 장치로부터 데이터 수신, 등.

## Preliminary work

Overall framework: MTCentralManager는 장치 관리 클래스입니다., 이는 APP가 실행 중일 때 항상 싱글톤입니다.. MTPeripheral은 장치 인스턴스 클래스입니다.. 이 제품군은 장치 모니터링 및 작동을 용이하게 하기 위해 각 장치에 대해 MTPeripheral 인스턴스를 생성합니다..
MT센트럴매니저 : 장치 관리 클래스, 주변 센서 장치를 스캔할 수 있습니다., 그리고 그것들을 연결할 수 있습니다, 확인하세요, 등.

**MT주변장치** : 장치 인스턴스 클래스. MTCentralManager가 물리적 장치를 발견하는 경우, MTCentralManager는 MTPeripheral 인스턴스를 생성합니다., 물리적 장치에 해당하는 것.

**MTBroadcastHandler** : 장치 브로드캐스트 클래스, 장치가 브로드캐스트할 때 데이터를 얻을 수 있습니다..

**MTConnectionHandler** : 장치로부터 데이터를 수신하고 전송하기 위한 장치 연결 클래스.

**MTUtil** : 데이터 쓰기 명령.

## 시작하세요
### 개발 환경:
-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은 Bluetooth API에 대한 권한 제한을 추가했습니다.. 프로젝트의 info.plist 파일에 문자열을 추가해야 합니다.: 개인정보 보호 - 블루투스 주변기기 사용법 설명 -"귀하의 사용 설명".
!!! iOS13 이상, Apple은 Bluetooth API에 대한 권한 제한을 추가했습니다.. 프로젝트의 info.plist 파일에 문자열을 추가해야 합니다.: 개인 정보 보호 - 블루투스 상시 사용 설명 -"귀하의 사용 설명".
### 개발 시작
#### Scanning equipment
First you need to get the singleton of MTCentralManager, 그런 다음 전화기의 현재 Bluetooth 상태를 확인하십시오., 그런 다음 장치를 스캔할 수 있습니다.

``c
// Get Manager singleton
MTCentralManager * 매니저 = [MTCentralManager 공유 인스턴스];

파견_후 (파견_시간 (DISPATCH_TIME_NOW, (int64_t) (1 * NSEC_PER_SEC)), dispatch_get_main_queue (), ^ {
    // The current state of the Bluetooth switch on the mobile phone
    if (self-> manager.status == PowerStatePoweredOn) {
        // 장치 스캔 시작
        [관리자 startScan: ^ (NSArray <MTPeripheral *> * 장치) {
        //방송 속성의 종류에 따라, 필요한 센서 유형을 필터링할 수 있습니다..
        self-> deviceAry = devices;
    }];
    }
});
// 검색된 장치는 Manager.scannedPeris를 사용하여 얻을 수도 있습니다.
// 휴대폰의 블루투스 상태에 응답해야 하는 경우. 콜백을 들어주세요.
[관리자가 변경블루투스상태를 변경했습니다.: ^ (PowerState 상태) {
  스위치 (상태) {
    케이스 PowerStatePoweredOn:
        NSLog (@ "블루투스 상태가 poweron으로 변경됨");
        부서지다;
    케이스 PowerStatePoweredOff:
        NSLog (@ "블루투스 상태가 전원 꺼짐으로 변경됨");
        부서지다;
    사례 PowerStateUnknown:
        NSLog (@ "블루투스 상태가 알 수 없음으로 변경됨");
	}
}];
```

**PS: 전체 SDK는 휴대폰의 Bluetooth 상태가 Poweron인 경우에만 작동합니다.**
#### Connect to device
```c
// The scanned device can be obtained from the previous step
MTPeripheral * 장치 = 장치Ary [0];
// 장치를 연결하세요
[관리자 connectToPeriperal: 장치];
// 장치 연결 상태 듣기.
[p.connector didChangeConnection: ^ (연결 연결) {
    만약에 (연결 == 검증됨) {
      // 성공적인 검증, successfully connected to the device
        NSLog (@ "검증된");
      //비밀번호를 작성해야 합니다., 비밀번호가 성공적으로 확인된 후 다른 작업을 수행합니다.
    }
    만약에 (연결 == 연결 끊김) {
        NSLog (@ "장치가 연결 해제되었습니다.");
    }
}];
````
#### 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: 데이터 완성: ^ (BOOL 성공, NS오류 * _Nonnull 오류) {
   만약에 (오류) {
       NSLog (@ "데이터 쓰기 실패:% @", 오류);
   }
   또 다른 {
       NSLog (@ "데이터 쓰기 성공");
   }
}];
````

2. Receive data

```c
[_per.connector didReceiveData: ^ (NS데이터 * _null이 아닌 날짜) {
   만약에 (데이터) {
       NSLog (@ "데이터 수신 성공:% @", 데이터);
    }
    또 다른 {
       NSLog (@ "데이터 수신 실패");
    }
   }
}];
````
## 일정

### MTCentralManager 속성 설명

| 이름 | 유형 | 설명 |
| -------- | -------- | -------- |
| 상태     | 파워스테이트     | 휴대전화의 블루투스 상태     |
| 스캔 페리스     | NSArray     | 스캔된 장치    |

### MTPeripheral 속성 설명
| 이름	 | 유형  |	설명 |
| -------- | -------- | -------- |
| 식별자	| NSString	| 장치 식별자 |
| 방송	| MTBroadcastHandler	| MTBroadcastHandler의 객체 |
| 커넥터 |	MTConnectionHandler	| MTConnectionHandler의 객체 |

### MTBroadcastHanler 속성 설명
| 이름	 | 유형  |	설명 |
| -------- | -------- | -------- |
| 이름	| NSString	| 장치 이름 | 
| RSSI	| NS정수	| 장치 RSSI | 
| 배터리	| NSString	| 장치 배터리 | 
| 맥	| NSString	| 장치 맥 | 
| 식별자	| NSString	| 장치 식별자 | 
| 온도	| 더블	| 장치 온도 | 
| 지상에	| 더블	| 장치 습도 | 
| reseInfo	| uint8_t	| 장치 온도 단위 플래그 | 
| 유형	| 센서 유형	| 기기 종류 | 
| 상태별	| NSString	| 장치 도어 상태| 
| 경고상태	| uint8_t	| 장치 알람 상태 |

| 이름	 | 유형  |	설명 |
| -------- | -------- | -------- |
| 이름	| NSString	| 장치 이름 | 
| RSSI	| NS정수	| 장치 RSSI | 
| 맥	| NSString	| 장치 맥 | 
| 식별자	| NSString	| 장치 식별자 | 
| 회사 버전	| NSString	| 확고한 버전 | 
| 하드웨어 버전	| NSString	| 하드웨어 버전 | 
| 화면정보	| NSString	| 화면정보 | 
| 배터리	| NSString	| 배터리 | 
| 칩 온도	| 더블	| 칩 온도 | 
| 심장 박동	| NSString	| 심장 박동 | 
| 태그RS	| NSString	| 태그RS | 
| 칩정보	| NSString	| 칩정보 | 
| 이미지 ID 데이터	| NS데이터	| 이미지 ID 데이터 | 
| 에러 코드	| NS정수	| 에러 코드 | 
| 주변기기지원	| NSString	| 주변기기지원 | 
	
### MTConnectionHandler 속성 설명
| 이름	 | 유형  |	설명 |
| -------- | -------- | -------- |
| macString	| NSString	| 장치 맥 | 
| 연결	| 연결	| 장치 연결 상태 |