Initial commit

2017-08-15 16:59:01 +08:00
commit bdc83e07ef
5766 changed files with 423223 additions and 0 deletions
@@ -0,0 +1,91 @@
+//
+//  ESPTouchTask.h
+//  EspTouchDemo
+//
+//  Created by 白 桦 on 4/14/15.
+//  Copyright (c) 2015 白 桦. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "ESPTouchResult.h"
+#import "ESPTouchDelegate.h"
+
+#define DEBUG_ON   YES
+
+@interface ESPTouchTask : NSObject
+
+@property (atomic,assign) BOOL isCancelled;
+
+/**
+ * Constructor of EsptouchTask
+ *
+ * @param apSsid
+ *            the Ap's ssid
+ * @param apBssid
+ *            the Ap's bssid
+ * @param apPassword
+ *            the Ap's password
+ * @param isSsidHidden
+ *            whether the Ap's ssid is hidden
+ */
+- (id) initWithApSsid: (NSString *)apSsid andApBssid: (NSString *) apBssid andApPwd: (NSString *)apPwd andIsSsidHiden: (BOOL) isSsidHidden;
+
+/**
+ * Constructor of EsptouchTask
+ *
+ * @param apSsid
+ *            the Ap's ssid
+ * @param apBssid
+ *            the Ap's bssid
+ * @param apPassword
+ *            the Ap's password
+ * @param isSsidHidden
+ *            whether the Ap's ssid is hidden
+ * @param timeoutMillisecond(it should be >= 15000+6000)
+ * 			  millisecond of total timeout
+ * @param context
+ *            the Context of the Application
+ */
+- (id) initWithApSsid: (NSString *)apSsid andApBssid: (NSString *) apBssid andApPwd: (NSString *)apPwd andIsSsidHiden: (BOOL) isSsidHidden andTimeoutMillisecond: (int) timeoutMillisecond;
+
+/**
+ * Interrupt the Esptouch Task when User tap back or close the Application.
+ */
+
+- (void) interrupt;
+
+/**
+ * Note: !!!Don't call the task at UI Main Thread
+ *
+ * Smart Config v2.4 support the API
+ *
+ * @return the ESPTouchResult
+ */
+- (ESPTouchResult*) executeForResult;
+
+/**
+ * Note: !!!Don't call the task at UI Main Thread
+ *
+ * Smart Config v2.4 support the API
+ *
+ * It will be blocked until the client receive result count >= expectTaskResultCount.
+ * If it fail, it will return one fail result will be returned in the list.
+ * If it is cancelled while executing,
+ *     if it has received some results, all of them will be returned in the list.
+ *     if it hasn't received any results, one cancel result will be returned in the list.
+ *
+ * @param expectTaskResultCount
+ *            the expect result count(if expectTaskResultCount <= 0,
+ *            expectTaskResultCount = INT32_MAX)
+ * @return the NSArray of EsptouchResult
+ * @throws RuntimeException
+ */
+- (NSArray*) executeForResults:(int) expectTaskResultCount;
+
+/**
+ * set the esptouch delegate, when one device is connected to the Ap, it will be called back
+ * @param esptouchDelegate when one device is connected to the Ap, it will be called back
+ */
+- (void) setEsptouchDelegate: (NSObject<ESPTouchDelegate> *) esptouchDelegate;
+
+@end