# TPMSBleSDK instructions

[中文版](README_CN.md)

| Version | Update time	| Author	| Update information |
|---------|------------:| ---------: | ----------------- |
| v1.0    |	2019/07/08  |JosonXiong	| Preliminary version |
			
			

## Table of Contents

## 一、The conditions of use
> * Minimum version iOS 8.0
> * The Bluetooth version used by the device requires 4.0 and above.
## 二、Use
1. Apply the key and secret of sdk, application address: http://sdk.aicare.net.cn;
2. Add "Privacy-Bluetooth Always Usage Description" to the info.plist file;
3.Import TPSMSleSDK.framework into the Xcode project.
4. Enter the following code in AppDelegate:
```
#import <TPMSBleSDK/ELTPMSBleManager.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    [ELTPMSBleManager setAppKey:@"key" appSecret:@"secret"];
    return YES;
}
```
5.Set the bitcode of the build setting to NO
6.Import "#import <TPMSBleSDK/ELTPMSBleManager.h>" to the controller you want to use, and follow the "<ELTPMSBleManagerDelegate>" protocol.
7.Set delegate
```
[ELTPMSBleManager shareManager].delegate = self;
```
8.Implementing proxy method
```
 -(void)TPMSBleManagerUpdateBleState:(TPMSBluetoothState)state;
-(void)TPMSBleManagerReceiveData:(ELTPMSDataModel *_Nonnull)model;
```
   
## 三、Get broadcast data
### 1.Determine if the phone Bluetooth is available
Proxy method：
````
-(void)TPMSBleManagerUpdateBleState:(TPMSBluetoothState)state;
```
Get the current Bluetooth status
Or
```
[ELTPMSBleManager shareManager].isOn
```
Get current Bluetooth enabled is available；
### 2.Start scanning
```
[[ELTPMSBleManager shareManager] startScan];
```
### 3.Stop scanning
```
[[ELTPMSBleManager shareManager] stopScan];
```
### 4.Method description
```
-(void)TPMSBleManagerUpdateBleState:(TPMSBluetoothState)state;
```
  This method is used to get the current state of Bluetooth, where the parameter "state" is an enumeration TPMSBluetoothState
   The enumerated elements include: TPMSBluetoothStateAvailable (Bluetooth on TPMSBluetoothStateUnavailable), TPMSBluetoothStateBroadcasting, TPMSBluetoothStateStopBroadcasting
```
 -(void)TPMSBleManagerReceiveData:(ELTPMSDataModel *_Nonnull)model;
```
This method is used to call back the TPMS Bluetooth module broadcast data. The model is an ELTPMSDataModel data model. For details on the ELTPMSDataModel class, please see "Remarks".
## 四、Remarks
ELTPMSDataModel(Broadcast data model)
|Type	|Parameter	|Description|
|----   |-------:   |----------:|
|ELTPMSDataType|type|Type of data|
|int|classID|Product number|
|double|v|Voltage coefficient (unit: V)|
|double	|p|Pressure coefficient (unit: kPa)|
|int	|t|Temperature coefficient (unit: °C)|
|ELTPMSDeviceState|state|Tire pressure status|
|int|	mcuVersion|MCU version number|
|int	|startCount|Operation counts|
|int	|stopCount|	Number of sneak stops|
|NSString|bleVersion|Bluetooth version number|
|NSString	|macAddress|MAC address|
|NSString|	name|Bluetooth name|
|NSInteger|createTime|Time when data was received|

ELTPMSHeader.h(head File)
Provide tire pressure unit, temperature unit, and the conversion method between units and the name symbol of the corresponding unit.