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

SendCommand.cpp@29:b6af04b77a56, 2014-10-27 (annotated)

Committer:
dan_ackme
Date:
Mon Oct 27 13:42:26 2014 -0700
Revision:
29:b6af04b77a56
refactored library layout

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
dan_ackme 29:b6af04b77a56 30 #include "internal/CommandCommon.h"
dan_ackme 29:b6af04b77a56 31
dan_ackme 29:b6af04b77a56 32
dan_ackme 29:b6af04b77a56 33 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 34 WiconnectResult Wiconnect::sendCommand(const Callback &completeCallback, char *responseBuffer,
dan_ackme 29:b6af04b77a56 35 int responseBufferLen, TimerTimeout timeoutMs, const ReaderFunc &reader, void *user,
dan_ackme 29:b6af04b77a56 36 const char *cmd, va_list vaList)
dan_ackme 29:b6af04b77a56 37 {
dan_ackme 29:b6af04b77a56 38 // preprocessor assertion
dan_ackme 29:b6af04b77a56 39 ct_assert(sizeof(commandContext) >=sizeof(CommandContext));
dan_ackme 29:b6af04b77a56 40 CHECK_INITIALIZED();
dan_ackme 29:b6af04b77a56 41 CHECK_NULL_BUFFER(responseBuffer);
dan_ackme 29:b6af04b77a56 42 if(commandExecuting)
dan_ackme 29:b6af04b77a56 43 {
dan_ackme 29:b6af04b77a56 44 return checkCurrentCommand();
dan_ackme 29:b6af04b77a56 45 }
dan_ackme 29:b6af04b77a56 46
dan_ackme 29:b6af04b77a56 47 CommandContext *context = (CommandContext*)commandContext;
dan_ackme 29:b6af04b77a56 48 CommandHeader *header = (CommandHeader*)commandHeaderBuffer;
dan_ackme 29:b6af04b77a56 49
dan_ackme 29:b6af04b77a56 50 int len = vsnprintf(commandFormatBuffer, sizeof(commandFormatBuffer)-3, cmd, vaList);
dan_ackme 29:b6af04b77a56 51
dan_ackme 29:b6af04b77a56 52 if(len > (int)(sizeof(commandFormatBuffer)-3))
dan_ackme 29:b6af04b77a56 53 {
dan_ackme 29:b6af04b77a56 54 DEBUG_ERROR("Command overflowed: %d > %d", len, sizeof(commandFormatBuffer)-3);
dan_ackme 29:b6af04b77a56 55 return WICONNECT_OVERFLOW;
dan_ackme 29:b6af04b77a56 56 }
dan_ackme 29:b6af04b77a56 57
dan_ackme 29:b6af04b77a56 58 commandFormatBuffer[len++] = '\r';
dan_ackme 29:b6af04b77a56 59 commandFormatBuffer[len++] = '\n';
dan_ackme 29:b6af04b77a56 60 commandFormatBuffer[len] = 0;
dan_ackme 29:b6af04b77a56 61
dan_ackme 29:b6af04b77a56 62 RESET_CMD_HEADER(header);
dan_ackme 29:b6af04b77a56 63
dan_ackme 29:b6af04b77a56 64 memset(context, 0, sizeof(CommandContext));
dan_ackme 29:b6af04b77a56 65 context->responseBuffer = responseBuffer;
dan_ackme 29:b6af04b77a56 66 context->responseBufferPtr = context->responseBuffer;
dan_ackme 29:b6af04b77a56 67 context->responseBufferLen = responseBufferLen;
dan_ackme 29:b6af04b77a56 68 context->commandLen = len;
dan_ackme 29:b6af04b77a56 69 context->commandPtr = commandFormatBuffer;
dan_ackme 29:b6af04b77a56 70 context->reader = reader;
dan_ackme 29:b6af04b77a56 71 context->user = user;
dan_ackme 29:b6af04b77a56 72 context->timeoutMs = timeoutMs;
dan_ackme 29:b6af04b77a56 73 context->callback = completeCallback;
dan_ackme 29:b6af04b77a56 74 context->nonBlocking = nonBlocking;
dan_ackme 29:b6af04b77a56 75
dan_ackme 29:b6af04b77a56 76 DEBUG_CMD_SEND(commandFormatBuffer);
dan_ackme 29:b6af04b77a56 77
dan_ackme 29:b6af04b77a56 78 commandExecuting = true;
dan_ackme 29:b6af04b77a56 79 flush(0);
dan_ackme 29:b6af04b77a56 80 timeoutTimer.reset();
dan_ackme 29:b6af04b77a56 81
dan_ackme 29:b6af04b77a56 82 return checkCurrentCommand();
dan_ackme 29:b6af04b77a56 83 }
dan_ackme 29:b6af04b77a56 84
dan_ackme 29:b6af04b77a56 85
dan_ackme 29:b6af04b77a56 86 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 87 WiconnectResult Wiconnect::sendCommand(char *responseBuffer, int responseBufferLen, TimerTimeout timeoutMs,
dan_ackme 29:b6af04b77a56 88 const ReaderFunc &reader, void *user, const char *cmd, va_list vaList)
dan_ackme 29:b6af04b77a56 89 {
dan_ackme 29:b6af04b77a56 90 return sendCommand(Callback(), responseBuffer, responseBufferLen, timeoutMs, reader, user, cmd, vaList);
dan_ackme 29:b6af04b77a56 91 }
dan_ackme 29:b6af04b77a56 92
dan_ackme 29:b6af04b77a56 93 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 94 WiconnectResult Wiconnect::sendCommand(char *responseBuffer, int responseBufferLen, TimerTimeout timeoutMs,
dan_ackme 29:b6af04b77a56 95 const ReaderFunc &reader, void *user, const char *cmd, ...)
dan_ackme 29:b6af04b77a56 96 {
dan_ackme 29:b6af04b77a56 97 WiconnectResult result;
dan_ackme 29:b6af04b77a56 98 va_list args;
dan_ackme 29:b6af04b77a56 99 va_start(args, cmd);
dan_ackme 29:b6af04b77a56 100 result = sendCommand(Callback(), responseBuffer, responseBufferLen, timeoutMs, reader, user, cmd, args);
dan_ackme 29:b6af04b77a56 101 va_end(args);
dan_ackme 29:b6af04b77a56 102 return result;
dan_ackme 29:b6af04b77a56 103 }
dan_ackme 29:b6af04b77a56 104
dan_ackme 29:b6af04b77a56 105 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 106 WiconnectResult Wiconnect::sendCommand(TimerTimeout timeoutMs, const ReaderFunc &reader, void *user, const char *cmd, ...)
dan_ackme 29:b6af04b77a56 107 {
dan_ackme 29:b6af04b77a56 108 WiconnectResult result;
dan_ackme 29:b6af04b77a56 109 va_list args;
dan_ackme 29:b6af04b77a56 110 va_start(args, cmd);
dan_ackme 29:b6af04b77a56 111 result = sendCommand(Callback(), internalBuffer, internalBufferSize, timeoutMs, reader, user, cmd, args);
dan_ackme 29:b6af04b77a56 112 va_end(args);
dan_ackme 29:b6af04b77a56 113 return result;
dan_ackme 29:b6af04b77a56 114 }
dan_ackme 29:b6af04b77a56 115
dan_ackme 29:b6af04b77a56 116 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 117 WiconnectResult Wiconnect::sendCommand(const ReaderFunc &reader, void *user, const char *cmd, ...)
dan_ackme 29:b6af04b77a56 118 {
dan_ackme 29:b6af04b77a56 119 WiconnectResult result;
dan_ackme 29:b6af04b77a56 120 va_list args;
dan_ackme 29:b6af04b77a56 121 va_start(args, cmd);
dan_ackme 29:b6af04b77a56 122 result = sendCommand(Callback(), internalBuffer, internalBufferSize, defaultTimeoutMs, reader, user, cmd, args);
dan_ackme 29:b6af04b77a56 123 va_end(args);
dan_ackme 29:b6af04b77a56 124 return result;
dan_ackme 29:b6af04b77a56 125 }
dan_ackme 29:b6af04b77a56 126
dan_ackme 29:b6af04b77a56 127 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 128 WiconnectResult Wiconnect::sendCommand(char *responseBuffer, int responseBufferLen, TimerTimeout timeoutMs, const char *cmd, ...)
dan_ackme 29:b6af04b77a56 129 {
dan_ackme 29:b6af04b77a56 130 WiconnectResult result;
dan_ackme 29:b6af04b77a56 131 va_list args;
dan_ackme 29:b6af04b77a56 132 va_start(args, cmd);
dan_ackme 29:b6af04b77a56 133 result = sendCommand(Callback(), responseBuffer, responseBufferLen, timeoutMs, ReaderFunc(), NULL, cmd, args);
dan_ackme 29:b6af04b77a56 134 va_end(args);
dan_ackme 29:b6af04b77a56 135 return result;
dan_ackme 29:b6af04b77a56 136 }
dan_ackme 29:b6af04b77a56 137
dan_ackme 29:b6af04b77a56 138 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 139 WiconnectResult Wiconnect::sendCommand(const Callback &completeCallback, char *responseBuffer, int responseBufferLen, const char *cmd, ...)
dan_ackme 29:b6af04b77a56 140 {
dan_ackme 29:b6af04b77a56 141 WiconnectResult result;
dan_ackme 29:b6af04b77a56 142 va_list args;
dan_ackme 29:b6af04b77a56 143 va_start(args, cmd);
dan_ackme 29:b6af04b77a56 144 result = sendCommand(completeCallback, responseBuffer, responseBufferLen, defaultTimeoutMs, ReaderFunc(), NULL, cmd, args);
dan_ackme 29:b6af04b77a56 145 va_end(args);
dan_ackme 29:b6af04b77a56 146 return result;
dan_ackme 29:b6af04b77a56 147 }
dan_ackme 29:b6af04b77a56 148
dan_ackme 29:b6af04b77a56 149 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 150 WiconnectResult Wiconnect::sendCommand(char *responseBuffer, int responseBufferLen, const char *cmd, ...)
dan_ackme 29:b6af04b77a56 151 {
dan_ackme 29:b6af04b77a56 152 WiconnectResult result;
dan_ackme 29:b6af04b77a56 153 va_list args;
dan_ackme 29:b6af04b77a56 154 va_start(args, cmd);
dan_ackme 29:b6af04b77a56 155 result = sendCommand(Callback(), responseBuffer, responseBufferLen, defaultTimeoutMs, ReaderFunc(), NULL, cmd, args);
dan_ackme 29:b6af04b77a56 156 va_end(args);
dan_ackme 29:b6af04b77a56 157 return result;
dan_ackme 29:b6af04b77a56 158 }
dan_ackme 29:b6af04b77a56 159
dan_ackme 29:b6af04b77a56 160 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 161 WiconnectResult Wiconnect::sendCommand(const Callback &completeCallback, const char *cmd, ...)
dan_ackme 29:b6af04b77a56 162 {
dan_ackme 29:b6af04b77a56 163 WiconnectResult result;
dan_ackme 29:b6af04b77a56 164 va_list args;
dan_ackme 29:b6af04b77a56 165 va_start(args, cmd);
dan_ackme 29:b6af04b77a56 166 result = sendCommand(completeCallback, internalBuffer, internalBufferSize, defaultTimeoutMs, ReaderFunc(), NULL, cmd, args);
dan_ackme 29:b6af04b77a56 167 va_end(args);
dan_ackme 29:b6af04b77a56 168 return result;
dan_ackme 29:b6af04b77a56 169 }
dan_ackme 29:b6af04b77a56 170
dan_ackme 29:b6af04b77a56 171 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 172 WiconnectResult Wiconnect::sendCommand(const char *cmd, ...)
dan_ackme 29:b6af04b77a56 173 {
dan_ackme 29:b6af04b77a56 174 WiconnectResult result;
dan_ackme 29:b6af04b77a56 175 va_list args;
dan_ackme 29:b6af04b77a56 176 va_start(args, cmd);
dan_ackme 29:b6af04b77a56 177 result = sendCommand(Callback(), internalBuffer, internalBufferSize, defaultTimeoutMs, ReaderFunc(), NULL, cmd, args);
dan_ackme 29:b6af04b77a56 178 va_end(args);
dan_ackme 29:b6af04b77a56 179 return result;
dan_ackme 29:b6af04b77a56 180 }
dan_ackme 29:b6af04b77a56 181
dan_ackme 29:b6af04b77a56 182 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 183 WiconnectResult Wiconnect::sendCommand(const Callback &completeCallback, TimerTimeout timeoutMs, const char *cmd, ...)
dan_ackme 29:b6af04b77a56 184 {
dan_ackme 29:b6af04b77a56 185 WiconnectResult result;
dan_ackme 29:b6af04b77a56 186 va_list args;
dan_ackme 29:b6af04b77a56 187 va_start(args, cmd);
dan_ackme 29:b6af04b77a56 188 result = sendCommand(completeCallback, internalBuffer, internalBufferSize, timeoutMs, ReaderFunc(), NULL, cmd, args);
dan_ackme 29:b6af04b77a56 189 va_end(args);
dan_ackme 29:b6af04b77a56 190 return result;
dan_ackme 29:b6af04b77a56 191 }
dan_ackme 29:b6af04b77a56 192
dan_ackme 29:b6af04b77a56 193 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 194 WiconnectResult Wiconnect::sendCommand(TimerTimeout timeoutMs, const char *cmd, ...)
dan_ackme 29:b6af04b77a56 195 {
dan_ackme 29:b6af04b77a56 196 WiconnectResult result;
dan_ackme 29:b6af04b77a56 197 va_list args;
dan_ackme 29:b6af04b77a56 198 va_start(args, cmd);
dan_ackme 29:b6af04b77a56 199 result = sendCommand(Callback(), internalBuffer, internalBufferSize, timeoutMs, ReaderFunc(), NULL, cmd, args);
dan_ackme 29:b6af04b77a56 200 va_end(args);
dan_ackme 29:b6af04b77a56 201 return result;
dan_ackme 29:b6af04b77a56 202 }
dan_ackme 29:b6af04b77a56 203
dan_ackme 29:b6af04b77a56 204 /*************************************************************************************************/
dan_ackme 29:b6af04b77a56 205 WiconnectResult Wiconnect::sendCommand(const char *cmd, va_list vaList)
dan_ackme 29:b6af04b77a56 206 {
dan_ackme 29:b6af04b77a56 207 return sendCommand(Callback(), internalBuffer, internalBufferSize, defaultTimeoutMs, ReaderFunc(), NULL, cmd, vaList);
dan_ackme 29:b6af04b77a56 208 }
dan_ackme 29:b6af04b77a56 209