iOS-App-Source-Code-v1.6.7.4.zip_ios app_ios code

// // XPGLeDiscovery.h // uEnergy // // XPGBatteryProtocol.h // uEnergy // // // Copyright (C) 2013-2014 CSR Ltd. All Rights Reserved. // // Initial development provided by XPG. Customisation and app development services // available at www.xtremeprog.com // #import <Foundation/Foundation.h> #import "XPGPeripheral.h" #import <CoreBluetooth/CoreBluetooth.h> @protocol XPGLeDiscoveryDelegate; @interface XPGLeDiscovery : NSObject <CBCentralManagerDelegate> { } /*! * @property delegate * * @discussion The delegate object that will receive Discovery events. * */ @property (nonatomic, assign) NSObject <XPGLeDiscoveryDelegate> *delegate; /*! * @method removeAllFoundXPGPeripherals * * * @discussion Refresh Found <code>XPGPeripheral</code> * */ - (void)removeAllFoundXPGPeripherals; /*! * @method foundXPGPeripherals * * * @discussion Return Array of <code>XPGPeripheral</code> * * @see XPGLeDiscovery:didDisconnectPeripheral:error: */ - (NSMutableArray*)foundXPGPeripherals; /*! * @method forgetSavedXPGPeripheral: * @param peripheral A <code>XPGPeripheral</code>. * * * @discussion forget Saved XPGPeripheral * * @see XPGLeDiscovery:didDisconnectPeripheral:error: */ - (void)forgetSavedXPGPeripheral:(XPGPeripheral *)peripheral; /*! * @method cancelPeripheralConnection: * * @param peripheral A <code>XPGPeripheral</code>. * * @discussion Cancel a pending connection or a connection to the peripheral. * * @see XPGLeDiscovery:didDisconnectPeripheral:error: */ - (void)cancelPeripheralConnection:(XPGPeripheral *)peripheral; /*! * @method connectPeripheral: * * @param peripheral A <code>XPGPeripheral</code>. * * @discussion Establish a connection to the peripheral. This method never times out. * Use -[cancelPeripheralConnection:] to cancel a pending connection. * * @see XPGLeDiscovery:didConnectPeripheral:error: * @see XPGLeDiscovery:didFailToConnectPeripheral:error: */ - (void)connectPeripheral:(XPGPeripheral *)peripheral; /*! * @method discoverPeripheralsWithServices:peripheralNames * * @param serviceUUIDs An array of UUIDs the APP is interested in. Only peripherals that advertise one or more of these services will be returned. If nil, doesn’t filter peripherals with service UUIDs. * @param names An array of names the APP is interested in. If nil, doesn’t filter peripherals with names. * @discussion The relevant delegate callback will be invoked for each discovered peripheral. And the same peripheral * may invoked the callback more than once in order to update advertising data. * * @see XPGLeDiscovery:didDiscoverPeripheral: */ - (NSError *)discoverPeripheralsWithServices:(NSArray *)serviceUUIDs peripheralNames:(NSArray *)names; /** * saveConnectedPeripheral:withType: * * @param xbgPer save XPGPeripheral * @param type type of XPGPeripheral */ - (void)saveConnectedPeripheral:(XPGPeripheral *)xbgPer withType:(NSString *)type; /*! * @method getSavedPeripherals * * @discussion Return Array of NSString * */ - (NSMutableArray *)getSavedPeripherals; /** * getSavedPeripheralsWithType: * * @param type Search Type * * @return array of SavedPeripherals */ - (NSMutableArray *)getSavedPeripheralsWithType:(NSString *)type; /*! * @method removeSavedPeripheralAtIndex * * @param index the index of Saved Peripheral */ - (void)removeSavedPeripheralAtIndex:(NSInteger)index; /** * removeSavedPeripheralAtIndex:withType: * * @param index the index of Saved Peripheral * @param type */ - (void)removeSavedPeripheralAtIndex:(NSInteger)index withType:(NSString *)type; /*! * @method sharedXPGLeDiscoveryWithDelegate: * * * @discussion Initializes or get the XPGLeDiscovery instance ,you must assign the delegate later. */ + (XPGLeDiscovery *)sharedXPGLeDiscovery; /*! * @method sharedXPGLeDiscoveryWithDelegate: * * @param delegate The delegate to receive XPGLeDiscovery events. * * @discussion Initializes or get the XPGLeDiscovery instance with a specified delegate. If you use +[sharedXPGLeDiscovery] to get XPGLeDiscovery instance * instead this method, you must assign the delegate later. */ + (XPGLeDiscovery *)sharedXPGLeDiscoveryWithDelegate:(NSObject<XPGLeDiscoveryDelegate>*)delegate; /*! * @method stopDiscoverPeripherals: * * @discussion Stop discovering peripherals. */ - (void) stopDiscoverPeripherals; /*! * @method version * * @discussion Return SDK version. */ - (NSString *) version; @end @protocol XPGLeDiscoveryDelegate @optional /*! * @method XPGLeDiscovery:didDiscoverPeripheral: * * @param manager The XPGLeDiscovery providing this information. * @param peripheral A <code>XPGPeripheral</code> object. * * @discussion Invoked when XPGLeDiscovery discovers a peripheral. * * @seealso XPGPeripheral.h */ - (void)XPGLeDiscovery: (XPGLeDiscovery *)manager didDiscoverPeripheral:(XPGPeripheral *)peripheral; /*! * @method XPGLeDiscovery:didConnectPeripheral: * * @param manager The XPGLeDiscovery providing this information. * @param peripheral The <code>XPGPeripheral</code> that has connected. * * @discussion Invoked whenever a connection is successfully created with the peripheral. */ - (void)XPGLeDiscovery: (XPGLeDiscovery *)manager didConnectPeripheral:(XPGPeripheral *)peripheral; /*! * @method XPGLeDiscovery:didDisconnectPeripheral:error: * * @param manager The XPGLeDiscovery providing this information. * @param peripheral The <code>XPGPeripheral</code> that has connected. * * @discussion Invoked whenever a connection is successfully created with the peripheral. */ - (void)XPGLeDiscovery: (XPGLeDiscovery *)manager didDisconnectPeripheral:(XPGPeripheral *)peripheral error:(NSError *)error; /*! * @method XPGLeDiscovery:didFailToConnectPeripheral:error: * * @param manager The XPGLeDiscovery providing this information. * @param peripheral The <code>XPGPeripheral</code> that has failed to connect * @param error The cause of the failure. * * @discussion Invoked whenever it fails to create a connection with the peripheral. */ - (void)XPGLeDiscovery: (XPGLeDiscovery *)manager didFailToConnectPeripheral:(XPGPeripheral *)peripheral error:(NSError *)error; /*! * @method XPGLeDiscovery:didErrorReport:error: * * @param manager The XPGLeDiscovery providing this information. * @param error The cause of the failure. * * @discussion Invoked whenever XPGLeDiscovery raise an unexpected issue. */ - (void)XPGLeDiscovery:(XPGLeDiscovery *)manager didErrorReport:(NSError *)error; @end