ACKme / WiConnect

Host library for controlling a WiConnect enabled Wi-Fi module.

Dependents:   wiconnect-ota_example wiconnect-web_setup_example wiconnect-test-console wiconnect-tcp_server_example ... more

NetworkJoin.cpp@33:9b690d76eedf, 2014-11-03 (annotated)

Committer:
dan_ackme
Date:
Mon Nov 03 23:48:38 2014 +0000
Revision:
33:9b690d76eedf
Parent:
29:b6af04b77a56 
Minor bug fixes.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dan_ackme 29:b6af04b77a56 1 /**
dan_ackme 29:b6af04b77a56 2 * ACKme WiConnect Host Library is licensed under the BSD licence:
dan_ackme 29:b6af04b77a56 3 *
dan_ackme 29:b6af04b77a56 4 * Copyright (c)2014 ACKme Networks.
dan_ackme 29:b6af04b77a56 5 * All rights reserved.
dan_ackme 29:b6af04b77a56 6 *
dan_ackme 29:b6af04b77a56 7 * Redistribution and use in source and binary forms, with or without modification,
dan_ackme 29:b6af04b77a56 8 * are permitted provided that the following conditions are met:
dan_ackme 29:b6af04b77a56 9 *
dan_ackme 29:b6af04b77a56 10 * 1. Redistributions of source code must retain the above copyright notice,
dan_ackme 29:b6af04b77a56 11 * this list of conditions and the following disclaimer.
dan_ackme 29:b6af04b77a56 12 * 2. Redistributions in binary form must reproduce the above copyright notice,
dan_ackme 29:b6af04b77a56 13 * this list of conditions and the following disclaimer in the documentation
dan_ackme 29:b6af04b77a56 14 * and/or other materials provided with the distribution.
dan_ackme 29:b6af04b77a56 15 * 3. The name of the author may not be used to endorse or promote products
dan_ackme 29:b6af04b77a56 16 * derived from this software without specific prior written permission.
dan_ackme 29:b6af04b77a56 17 *
dan_ackme 29:b6af04b77a56 18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS AND ANY EXPRESS OR IMPLIED
dan_ackme 29:b6af04b77a56 19 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
dan_ackme 29:b6af04b77a56 20 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
dan_ackme 29:b6af04b77a56 21 * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
dan_ackme 29:b6af04b77a56 22 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
dan_ackme 29:b6af04b77a56 23 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
dan_ackme 29:b6af04b77a56 24 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
dan_ackme 29:b6af04b77a56 25 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
dan_ackme 29:b6af04b77a56 26 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
dan_ackme 29:b6af04b77a56 27 * OF SUCH DAMAGE.
dan_ackme 29:b6af04b77a56 28 */
dan_ackme 29:b6af04b77a56 29 #include "Wiconnect.h"
dan_ackme 29:b6af04b77a56 30 #include "internal/common.h"
dan_ackme 29:b6af04b77a56 31
dan_ackme 29:b6af04b77a56 32 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 33 WiconnectResult NetworkInterface::join(const char* ssid, const char *password, const Callback &completeHandler_)
dan_ackme 29:b6af04b77a56 34 {
dan_ackme 29:b6af04b77a56 35 WiconnectResult result = WICONNECT_ERROR;
dan_ackme 29:b6af04b77a56 36
dan_ackme 29:b6af04b77a56 37 enum
dan_ackme 29:b6af04b77a56 38 {
dan_ackme 33:9b690d76eedf 39 FS_SET_NETWORK_DOWN,
dan_ackme 29:b6af04b77a56 40 FS_SET_SSID,
dan_ackme 29:b6af04b77a56 41 FS_SET_PASSWORD,
dan_ackme 29:b6af04b77a56 42 FS_NETWORK_UP,
dan_ackme 29:b6af04b77a56 43 FS_GET_STATUS
dan_ackme 29:b6af04b77a56 44 };
dan_ackme 29:b6af04b77a56 45
dan_ackme 29:b6af04b77a56 46 CHECK_CALLBACK_AVAILABLE(completeHandler_);
dan_ackme 29:b6af04b77a56 47
dan_ackme 29:b6af04b77a56 48 CHECK_OTHER_COMMAND_EXECUTING();
dan_ackme 29:b6af04b77a56 49
dan_ackme 33:9b690d76eedf 50 if(wiconnect->internalProcessingState == FS_SET_NETWORK_DOWN)
dan_ackme 33:9b690d76eedf 51 {
dan_ackme 33:9b690d76eedf 52 if(WICONNECT_SUCCEEDED(result, wiconnect->sendCommand("network_down")))
dan_ackme 33:9b690d76eedf 53 {
dan_ackme 33:9b690d76eedf 54 wiconnect->internalProcessingState = FS_SET_SSID;
dan_ackme 33:9b690d76eedf 55 }
dan_ackme 33:9b690d76eedf 56 }
dan_ackme 33:9b690d76eedf 57
dan_ackme 29:b6af04b77a56 58 if(wiconnect->internalProcessingState == FS_SET_SSID)
dan_ackme 29:b6af04b77a56 59 {
dan_ackme 29:b6af04b77a56 60 if(ssid == NULL ||
dan_ackme 29:b6af04b77a56 61 WICONNECT_SUCCEEDED(result, wiconnect->sendCommand("set wlan.ssid %s", ssid)))
dan_ackme 29:b6af04b77a56 62 {
dan_ackme 29:b6af04b77a56 63 wiconnect->internalProcessingState = FS_SET_PASSWORD;
dan_ackme 29:b6af04b77a56 64 }
dan_ackme 29:b6af04b77a56 65 }
dan_ackme 29:b6af04b77a56 66
dan_ackme 29:b6af04b77a56 67 if(wiconnect->internalProcessingState == FS_SET_PASSWORD)
dan_ackme 29:b6af04b77a56 68 {
dan_ackme 29:b6af04b77a56 69 if(password == NULL || *password == 0 ||
dan_ackme 29:b6af04b77a56 70 WICONNECT_SUCCEEDED(result, wiconnect->sendCommand("set wlan.passkey %s", password)))
dan_ackme 29:b6af04b77a56 71 {
dan_ackme 29:b6af04b77a56 72 wiconnect->internalProcessingState = FS_NETWORK_UP;
dan_ackme 29:b6af04b77a56 73 }
dan_ackme 29:b6af04b77a56 74 }
dan_ackme 29:b6af04b77a56 75
dan_ackme 29:b6af04b77a56 76 if(wiconnect->internalProcessingState == FS_NETWORK_UP)
dan_ackme 29:b6af04b77a56 77 {
dan_ackme 29:b6af04b77a56 78 if(WICONNECT_SUCCEEDED(result, wiconnect->sendCommand("network_up")))
dan_ackme 29:b6af04b77a56 79 {
dan_ackme 29:b6af04b77a56 80 if(!completeHandler_.isValid())
dan_ackme 29:b6af04b77a56 81 {
dan_ackme 29:b6af04b77a56 82 wiconnect->internalProcessingState = FS_GET_STATUS;
dan_ackme 29:b6af04b77a56 83 }
dan_ackme 29:b6af04b77a56 84 #ifdef WICONNECT_ASYNC_TIMER_ENABLED
dan_ackme 29:b6af04b77a56 85 else
dan_ackme 29:b6af04b77a56 86 {
dan_ackme 29:b6af04b77a56 87 monitorTimer.stop();
dan_ackme 29:b6af04b77a56 88 completeHandler = completeHandler_;
dan_ackme 29:b6af04b77a56 89 monitorTimer.start(this, &NetworkInterface::joinStatusMonitor, 1000);
dan_ackme 29:b6af04b77a56 90 }
dan_ackme 29:b6af04b77a56 91 #endif
dan_ackme 29:b6af04b77a56 92 }
dan_ackme 29:b6af04b77a56 93 }
dan_ackme 29:b6af04b77a56 94
dan_ackme 29:b6af04b77a56 95 if(wiconnect->internalProcessingState == FS_GET_STATUS)
dan_ackme 29:b6af04b77a56 96 {
dan_ackme 29:b6af04b77a56 97 #define MAX_JOIN_TIME 30000
dan_ackme 29:b6af04b77a56 98 TimeoutTimer timeout;
dan_ackme 29:b6af04b77a56 99
dan_ackme 29:b6af04b77a56 100 status_loop:
dan_ackme 29:b6af04b77a56 101 if(WICONNECT_SUCCEEDED(result, wiconnect->sendCommand("get wlan.join.result")))
dan_ackme 29:b6af04b77a56 102 {
dan_ackme 29:b6af04b77a56 103 int32_t status;
dan_ackme 29:b6af04b77a56 104 if(!WICONNECT_FAILED(result, wiconnect->responseToInt32(&status)))
dan_ackme 29:b6af04b77a56 105 {
dan_ackme 29:b6af04b77a56 106 if((NetworkJoinResult)status == NETWORK_JOIN_RESULT_JOINING)
dan_ackme 29:b6af04b77a56 107 {
dan_ackme 29:b6af04b77a56 108 if(timeout.timedOut(MAX_JOIN_TIME))
dan_ackme 29:b6af04b77a56 109 {
dan_ackme 29:b6af04b77a56 110 result = WICONNECT_TIMEOUT;
dan_ackme 29:b6af04b77a56 111 }
dan_ackme 29:b6af04b77a56 112 else if(!wiconnect->nonBlocking)
dan_ackme 29:b6af04b77a56 113 {
dan_ackme 29:b6af04b77a56 114 goto status_loop;
dan_ackme 29:b6af04b77a56 115 }
dan_ackme 29:b6af04b77a56 116 else
dan_ackme 29:b6af04b77a56 117 {
dan_ackme 29:b6af04b77a56 118 result = WICONNECT_PROCESSING;
dan_ackme 29:b6af04b77a56 119 }
dan_ackme 29:b6af04b77a56 120 }
dan_ackme 29:b6af04b77a56 121 else
dan_ackme 29:b6af04b77a56 122 {
dan_ackme 29:b6af04b77a56 123 result = ((NetworkJoinResult)status == NETWORK_JOIN_RESULT_SUCCESS) ? WICONNECT_SUCCESS : WICONNECT_NOT_CONNECTED;
dan_ackme 29:b6af04b77a56 124 }
dan_ackme 29:b6af04b77a56 125 }
dan_ackme 29:b6af04b77a56 126 }
dan_ackme 29:b6af04b77a56 127 }
dan_ackme 29:b6af04b77a56 128
dan_ackme 29:b6af04b77a56 129 CHECK_CLEANUP_COMMAND();
dan_ackme 29:b6af04b77a56 130
dan_ackme 29:b6af04b77a56 131 return result;
dan_ackme 29:b6af04b77a56 132 }
dan_ackme 29:b6af04b77a56 133
dan_ackme 29:b6af04b77a56 134
dan_ackme 29:b6af04b77a56 135
dan_ackme 29:b6af04b77a56 136 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 137 WiconnectResult NetworkInterface::leave()
dan_ackme 29:b6af04b77a56 138 {
dan_ackme 29:b6af04b77a56 139 WiconnectResult result;
dan_ackme 29:b6af04b77a56 140
dan_ackme 29:b6af04b77a56 141 CHECK_OTHER_COMMAND_EXECUTING();
dan_ackme 29:b6af04b77a56 142
dan_ackme 29:b6af04b77a56 143 #ifdef WICONNECT_ASYNC_TIMER_ENABLED
dan_ackme 29:b6af04b77a56 144 monitorTimer.stop();
dan_ackme 29:b6af04b77a56 145 #endif
dan_ackme 29:b6af04b77a56 146 result = wiconnect->sendCommand("network_down");
dan_ackme 29:b6af04b77a56 147
dan_ackme 29:b6af04b77a56 148 CHECK_CLEANUP_COMMAND();
dan_ackme 29:b6af04b77a56 149
dan_ackme 29:b6af04b77a56 150 return result;
dan_ackme 29:b6af04b77a56 151 }
dan_ackme 29:b6af04b77a56 152
dan_ackme 29:b6af04b77a56 153
dan_ackme 29:b6af04b77a56 154 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 155 WiconnectResult NetworkInterface::getNetworkStatus(NetworkStatus *statusPtr)
dan_ackme 29:b6af04b77a56 156 {
dan_ackme 29:b6af04b77a56 157 WiconnectResult result;
dan_ackme 29:b6af04b77a56 158
dan_ackme 29:b6af04b77a56 159 CHECK_OTHER_COMMAND_EXECUTING();
dan_ackme 29:b6af04b77a56 160
dan_ackme 29:b6af04b77a56 161 if(WICONNECT_SUCCEEDED(result, wiconnect->sendCommand("get network.status")))
dan_ackme 29:b6af04b77a56 162 {
dan_ackme 29:b6af04b77a56 163 int32_t status;
dan_ackme 29:b6af04b77a56 164 if(!WICONNECT_FAILED(result, wiconnect->responseToInt32(&status)))
dan_ackme 29:b6af04b77a56 165 {
dan_ackme 29:b6af04b77a56 166 if(status != NETWORK_STATUS_DOWN)
dan_ackme 29:b6af04b77a56 167 {
dan_ackme 29:b6af04b77a56 168 #ifdef WICONNECT_ASYNC_TIMER_ENABLED
dan_ackme 29:b6af04b77a56 169 monitorTimer.stop();
dan_ackme 29:b6af04b77a56 170 #endif
dan_ackme 29:b6af04b77a56 171 }
dan_ackme 29:b6af04b77a56 172 *statusPtr = (NetworkStatus)status;
dan_ackme 29:b6af04b77a56 173 }
dan_ackme 29:b6af04b77a56 174 }
dan_ackme 29:b6af04b77a56 175
dan_ackme 29:b6af04b77a56 176 CHECK_CLEANUP_COMMAND();
dan_ackme 29:b6af04b77a56 177
dan_ackme 29:b6af04b77a56 178 return result;
dan_ackme 29:b6af04b77a56 179 }
dan_ackme 29:b6af04b77a56 180
dan_ackme 29:b6af04b77a56 181 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 182 WiconnectResult NetworkInterface::getNetworkJoinResult(NetworkJoinResult *joinResultPtr)
dan_ackme 29:b6af04b77a56 183 {
dan_ackme 29:b6af04b77a56 184 WiconnectResult result;
dan_ackme 29:b6af04b77a56 185
dan_ackme 29:b6af04b77a56 186 CHECK_OTHER_COMMAND_EXECUTING();
dan_ackme 29:b6af04b77a56 187
dan_ackme 29:b6af04b77a56 188 if(WICONNECT_SUCCEEDED(result, wiconnect->sendCommand("get wlan.join.result")))
dan_ackme 29:b6af04b77a56 189 {
dan_ackme 29:b6af04b77a56 190 int32_t status;
dan_ackme 29:b6af04b77a56 191 if(!WICONNECT_FAILED(result, wiconnect->responseToInt32(&status)))
dan_ackme 29:b6af04b77a56 192 {
dan_ackme 29:b6af04b77a56 193 if(status != NETWORK_JOIN_RESULT_JOINING)
dan_ackme 29:b6af04b77a56 194 {
dan_ackme 29:b6af04b77a56 195 #ifdef WICONNECT_ASYNC_TIMER_ENABLED
dan_ackme 29:b6af04b77a56 196 monitorTimer.stop();
dan_ackme 29:b6af04b77a56 197 #endif
dan_ackme 29:b6af04b77a56 198 }
dan_ackme 29:b6af04b77a56 199 *joinResultPtr = (NetworkJoinResult)status;
dan_ackme 29:b6af04b77a56 200 }
dan_ackme 29:b6af04b77a56 201 }
dan_ackme 29:b6af04b77a56 202
dan_ackme 29:b6af04b77a56 203 CHECK_CLEANUP_COMMAND();
dan_ackme 29:b6af04b77a56 204
dan_ackme 29:b6af04b77a56 205 return result;
dan_ackme 29:b6af04b77a56 206 }
dan_ackme 29:b6af04b77a56 207
dan_ackme 29:b6af04b77a56 208 #ifdef WICONNECT_ASYNC_TIMER_ENABLED
dan_ackme 29:b6af04b77a56 209
dan_ackme 29:b6af04b77a56 210
dan_ackme 29:b6af04b77a56 211 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 212 // this is called every 1s by the monitorTimer
dan_ackme 29:b6af04b77a56 213 void NetworkInterface::joinStatusMonitor()
dan_ackme 29:b6af04b77a56 214 {
dan_ackme 29:b6af04b77a56 215 static char responseBuffer[4];
dan_ackme 29:b6af04b77a56 216 static uint8_t cmdBuffer[sizeof(QueuedCommand)];
dan_ackme 29:b6af04b77a56 217 QueuedCommand *cmd = (QueuedCommand*)cmdBuffer;
dan_ackme 29:b6af04b77a56 218
dan_ackme 29:b6af04b77a56 219 monitorTimer.stop();
dan_ackme 29:b6af04b77a56 220
dan_ackme 29:b6af04b77a56 221 *cmd = QueuedCommand(sizeof(responseBuffer), responseBuffer, "get wlan.join.result");
dan_ackme 29:b6af04b77a56 222
dan_ackme 29:b6af04b77a56 223 wiconnect->enqueueCommand(cmd, Callback(this, &NetworkInterface::joinStatusCheckCallback));
dan_ackme 29:b6af04b77a56 224 }
dan_ackme 29:b6af04b77a56 225
dan_ackme 29:b6af04b77a56 226 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 227 // this is called on the completion of the 'get'wlan.join.result' command above
dan_ackme 29:b6af04b77a56 228 void NetworkInterface::joinStatusCheckCallback(WiconnectResult result, void *arg1, void *arg2)
dan_ackme 29:b6af04b77a56 229 {
dan_ackme 29:b6af04b77a56 230 bool isComplete = false;
dan_ackme 29:b6af04b77a56 231 NetworkJoinResult joinResult = NETWORK_JOIN_RESULT_NONE;
dan_ackme 29:b6af04b77a56 232
dan_ackme 29:b6af04b77a56 233 QueuedCommand *cmd = (QueuedCommand*)arg1;
dan_ackme 29:b6af04b77a56 234
dan_ackme 29:b6af04b77a56 235 if(result == WICONNECT_SUCCESS)
dan_ackme 29:b6af04b77a56 236 {
dan_ackme 29:b6af04b77a56 237 int32_t status;
dan_ackme 29:b6af04b77a56 238 if(!StringUtil::strToInt32(cmd->responseBuffer, &status))
dan_ackme 29:b6af04b77a56 239 {
dan_ackme 29:b6af04b77a56 240 result = WICONNECT_RESPONSE_PARSE_ERROR;
dan_ackme 29:b6af04b77a56 241 }
dan_ackme 29:b6af04b77a56 242 else if((NetworkJoinResult)status != NETWORK_JOIN_RESULT_JOINING)
dan_ackme 29:b6af04b77a56 243 {
dan_ackme 29:b6af04b77a56 244 isComplete = true;
dan_ackme 29:b6af04b77a56 245 joinResult = (NetworkJoinResult)status;
dan_ackme 29:b6af04b77a56 246 result = (joinResult == NETWORK_JOIN_RESULT_SUCCESS) ? WICONNECT_SUCCESS : WICONNECT_NOT_CONNECTED;
dan_ackme 29:b6af04b77a56 247 }
dan_ackme 29:b6af04b77a56 248 }
dan_ackme 29:b6af04b77a56 249
dan_ackme 29:b6af04b77a56 250 if(isComplete || result != WICONNECT_SUCCESS)
dan_ackme 29:b6af04b77a56 251 {
dan_ackme 29:b6af04b77a56 252 completeHandler.call(result, (void*)joinResult, NULL);
dan_ackme 29:b6af04b77a56 253 }
dan_ackme 29:b6af04b77a56 254 else
dan_ackme 29:b6af04b77a56 255 {
dan_ackme 29:b6af04b77a56 256 monitorTimer.start(this, &NetworkInterface::joinStatusMonitor, 1000);
dan_ackme 29:b6af04b77a56 257 }
dan_ackme 29:b6af04b77a56 258 }
dan_ackme 29:b6af04b77a56 259
dan_ackme 29:b6af04b77a56 260 #endif