LibEsptouchForIOS: An Objective-C repository from codywon

ESPRSSIF MIT License

Permission is hereby granted for use on ESPRESSIF SYSTEMS ESP8266 only, in which case, it is free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

乐鑫 MIT 许可证

该许可证授权仅限于乐鑫信息科技 ESP8266 产品的应用开发。在此情况下，该许可证免费授权任何获得该软件及其相关文档（统称为“软件”）的人无限制地经营该软件，包括无限制的使用、复制、修改、合并、出版发行、散布、再授权、及贩售软件及软件副本的权利。被授权人在享受这些权利的同时，需服从下面的条件：

该软件按本来的样子提供，没有任何明确或暗含的担保，包括但不仅限于关于试销性、适合某一特定用途和非侵权的保证。作者和版权持有人在任何情况下均不就由软件或软件使用引起的以合同形式、民事侵权或其它方式提出的任何索赔、损害或其它责任负责。 ==================================v0.3.4.3==================================

Espressif's Smart Config is updated to v2.4.

Esptouch v0.3.4.3 only support Espressif's Smart Config v2.4
Usage:

The same as v0.3.4.2.(fix some bugs in v0.3.4.2).

==================================v0.3.4.2==================================

Espressif's Smart Config is updated to v2.4, and some paremeters are changed.

Esptouch v0.3.4 only support Espressif's Smart Config v2.4
ESPTouchDelegate is added. It support callback when new device is connected to wifi.
Usage:

The same as v0.3.3.

==================================v0.3.4.1==================================

fix the bug when iphone or ipad lock screen while doing esptouch, it will

crash when back from lock screen state.

thx for the engineer in Lenovo discovery
Espressif's Smart Config is updated to v2.4, and some paremeters are changed.

Esptouch v0.3.4 only support Espressif's Smart Config v2.4
Usage:

The same as v0.3.4.

==================================v0.3.4==================================

Espressif's Smart Config is updated to v2.4, and some paremeters are changed.

Esptouch v0.3.4 only support Espressif's Smart Config v2.4
Usage:

The same as v0.3.3.

==================================v0.3.3==================================

Espressif's Smart Config is updated to v2.2, and the protocol is changed.

Esptouch v0.3.3 only support Espressif's Smart Config v2.2
Usage:

The usage of v0.3.0 is supported, besides one new API is added:

(NSArray*) executeForResults:(int) expectTaskResultCount

The only differece is that it return array, and require expectTaskResultCount

==================================v0.3.2==================================

Espressif's Smart Config is updated to v2.2, and the protocol is changed.

Esptouch v0.3.2 only support Espressif's Smart Config v2.2
Usage:

The same as v0.3.0.

==================================v0.3.1==================================

Espressif's Smart Config is updated to v2.1, and the protocol is changed.

Esptouch v0.3.1 only support Espressif's Smart Config v2.1
Usage:

The same as v0.3.0.(fix some bugs in v0.3.0)

==================================v0.3.0==================================

Espressif's Smart Config is updated to v2.1, and the protocol is changed.

Esptouch v0.3.0 only support Espressif's Smart Config v2.1

Usage:

// build esptouch task

NSString *apSsid = @"wifi-1";

NSString *apBssid = @"12:34:56:78:9a:bc";

NSString *apPwd = @"1234567890";

BOOL isSsidHidden = NO;// whether the Ap's ssid is hidden, it is NO usually

ESPTouchTask *task = [[ESPTouchTask alloc]initWithApSsid:apSsid

                                          andApBssid:apBssid

                                            andApPwd:apPwd

                                      andIsSsidHiden:isSsidHidden];

// if you'd like to determine the timeout by yourself, use the follow:

int timeoutMillisecond = 58000;// it should >= 18000, 58000 is default

ESPTouchTask *task = [[ESPTouchTask alloc]initWithApSsid:apSsid

                                          andApBssid:apBssid

                                            andApPwd:apPwd

                                      andIsSsidHiden:isSsidHidden

                               andTimeoutMillisecond:timeoutMillisecond];

// execute for result

ESPTouchResult *esptouchReult = [task executeForResult];

// note: one task can't executed more than once:

ESPTouchTask *esptouchTask = [[ESPTouchTask alloc]initXXX...];

// wrong usage, which shouldn't happen

{

[esptouchTask executeForResult];

[esptouchTask executeForResult];

}

// correct usage

{

[esptouchTask executeForResult];

EsptouchTask *esptouchTask = [[ESPTouchTask alloc]initXXX...];

[esptouchTask executeForResult];

}

==================================v0.2.2==================================

add isCancelled API in ESPTouchTask and ESPTouchResult to check whether the task

is cancelled by user directly.

==================================v0.2.1==================================

fix the bug when SSID char is more than one byte value(0xff), esptouch will fail forever

thx for the engineer in NATop YoungYang's discovery
the encoding charset could be set, the default one is "NSUTF8StringEncoding":

change the macro ESPTOUCH_NSStringEncoding in ESP_ByteUtil.h

(It will lead to ESPTOUCH fail for wrong CHARSET is set.

Whether the CHARSET is correct is depend on the phone or pad.

More info and discussion please refer to http://bbs.espressif.com/viewtopic.php?f=8&t=397)

==================================v0.2.0==================================

add check valid mechanism to forbid such situation:

NSString *apSsid = @"";// or apSsid = null

NSString *apPassword = @"pwd";

EsptouchTask *esptouchTask = [[ESPTouchTask alloc]initWithApSsid:apSsid andApPwd:apPwd];

add check whether the task is executed to forbid such situation,

thx for the engineer in smartline YuguiYu's proposal:

NSString *apSsid = @"ssid";

NSString *apPassword = @"pwd";

EsptouchTask *esptouchTask = [[ESPTouchTask alloc]initWithApSsid:apSsid andApPwd:apPwd]; 

// wrong usage, which shouldn't happen

{

    [esptouchTask execute];

    [esptouchTask execute];

}

// correct usage

{

    [esptouchTask execute];

    EsptouchTask *esptouchTask = [[ESPTouchTask alloc]initWithApSsid:apSsid andApPwd:apPwd]; 

    [esptouchTask execute];

}

==================================v0.1.9==================================

fix some old bugs in the App

Add new Interface of Esptouch task( Smart Configure must v1.1 to support it)

The usage of it is like this:

// create the Esptouch task

EsptouchTask *esptouchTask = [[ESPTouchTask alloc]initWithApSsid:apSsid andApPwd:apPwd]; 

// execute syn util it suc or timeout

EsptouchResult *result = [esptouchTask executeForResult];

// check whehter the execute is suc

BOOL isSuc = result.isSuc;

// get the device's bssid, the format of the bssid is like this format: @"18fe3497f310"

NSString *bssid = result.bssid;

// when you'd like to interrupt it, just call the method below, and [esptouchTask execute] will return NO after it:

[esptouchTask interrupt];

==================================v0.1.7==================================

The entrance of the Demo is ESPViewController.m

EsptouchTask.h is the interface of Esptouch task.

The usage of it is like this:

// create the Esptouch task

EsptouchTask *esptouchTask = [[ESPTouchTask alloc]initWithApSsid:apSsid andApPwd:apPwd]; 

// execute syn util it suc or timeout

BOOL result = [esptouchTask execute];

// when you'd like to interrupt it, just call the method below, and [esptouchTask execute] will return NO after it:

[esptouchTask interrupt];

The abstract interface is in the group esptouch
More info about the EspTouch Demo, please read the source code and annotation

codywon/LibEsptouchForIOS