modified to get more signal info
Fork of WncControllerLibrary by
WncController.h@12:33290e9e6e5f, 2016-09-10 (annotated)
- Committer:
- fkellermavnet
- Date:
- Sat Sep 10 00:49:34 2016 +0000
- Revision:
- 12:33290e9e6e5f
- Parent:
- 10:2ec59906a24e
- Child:
- 13:73629a6e9122
Cleaned up the read loops a bit.
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
fkellermavnet | 0:affdbb35faa4 | 1 | /* |
fkellermavnet | 0:affdbb35faa4 | 2 | Copyright (c) 2016 Fred Kellerman |
fkellermavnet | 0:affdbb35faa4 | 3 | |
fkellermavnet | 0:affdbb35faa4 | 4 | Permission is hereby granted, free of charge, to any person obtaining a copy |
fkellermavnet | 0:affdbb35faa4 | 5 | of this software and associated documentation files (the "Software"), to deal |
fkellermavnet | 0:affdbb35faa4 | 6 | in the Software without restriction, including without limitation the rights |
fkellermavnet | 0:affdbb35faa4 | 7 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
fkellermavnet | 0:affdbb35faa4 | 8 | copies of the Software, and to permit persons to whom the Software is |
fkellermavnet | 0:affdbb35faa4 | 9 | furnished to do so, subject to the following conditions: |
fkellermavnet | 0:affdbb35faa4 | 10 | |
fkellermavnet | 0:affdbb35faa4 | 11 | The above copyright notice and this permission notice shall be included in |
fkellermavnet | 0:affdbb35faa4 | 12 | all copies or substantial portions of the Software. |
fkellermavnet | 0:affdbb35faa4 | 13 | |
fkellermavnet | 0:affdbb35faa4 | 14 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
fkellermavnet | 0:affdbb35faa4 | 15 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
fkellermavnet | 0:affdbb35faa4 | 16 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
fkellermavnet | 0:affdbb35faa4 | 17 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
fkellermavnet | 0:affdbb35faa4 | 18 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
fkellermavnet | 0:affdbb35faa4 | 19 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
fkellermavnet | 0:affdbb35faa4 | 20 | THE SOFTWARE. |
fkellermavnet | 0:affdbb35faa4 | 21 | |
fkellermavnet | 0:affdbb35faa4 | 22 | @file WncController.h |
fkellermavnet | 0:affdbb35faa4 | 23 | @purpose Controls WNC Cellular Modem |
fkellermavnet | 0:affdbb35faa4 | 24 | @version 1.0 |
fkellermavnet | 0:affdbb35faa4 | 25 | @date July 2016 |
fkellermavnet | 0:affdbb35faa4 | 26 | @author Fred Kellerman |
fkellermavnet | 0:affdbb35faa4 | 27 | */ |
fkellermavnet | 0:affdbb35faa4 | 28 | |
fkellermavnet | 0:affdbb35faa4 | 29 | #ifndef __WNCCONTROLLER_H_ |
fkellermavnet | 0:affdbb35faa4 | 30 | #define __WNCCONTROLLER_H_ |
fkellermavnet | 0:affdbb35faa4 | 31 | |
fkellermavnet | 0:affdbb35faa4 | 32 | #include <string> |
fkellermavnet | 0:affdbb35faa4 | 33 | #include <stdint.h> |
fkellermavnet | 0:affdbb35faa4 | 34 | |
fkellermavnet | 0:affdbb35faa4 | 35 | namespace WncController_fk { |
fkellermavnet | 0:affdbb35faa4 | 36 | |
fkellermavnet | 0:affdbb35faa4 | 37 | using namespace std; |
fkellermavnet | 0:affdbb35faa4 | 38 | |
fkellermavnet | 0:affdbb35faa4 | 39 | /** |
fkellermavnet | 0:affdbb35faa4 | 40 | * \file WncController.h |
fkellermavnet | 0:affdbb35faa4 | 41 | * \brief This mbed C++ class is for controlling the WNC |
fkellermavnet | 0:affdbb35faa4 | 42 | * Cellular modem via the AT command interface. This was |
fkellermavnet | 0:affdbb35faa4 | 43 | * developed with respect to version 1.3 of the WNC authored |
fkellermavnet | 0:affdbb35faa4 | 44 | * spec. This class is only designed to have 1 instantiation |
fkellermavnet | 0:affdbb35faa4 | 45 | * it is also not multi-thread safe. |
fkellermavnet | 0:affdbb35faa4 | 46 | */ |
fkellermavnet | 0:affdbb35faa4 | 47 | |
fkellermavnet | 0:affdbb35faa4 | 48 | |
fkellermavnet | 0:affdbb35faa4 | 49 | static const uint8_t MAX_LEN_IP_STR = 16; // Length includes room for the extra NULL |
fkellermavnet | 6:a656e820d7ff | 50 | static const uint16_t WNC_MAX_SMS_MSG_SLOTS = 3; // How many SMS messages the WNC can store and receive at a time. |
fkellermavnet | 6:a656e820d7ff | 51 | |
fkellermavnet | 6:a656e820d7ff | 52 | struct WncSmsInfo |
fkellermavnet | 6:a656e820d7ff | 53 | { |
fkellermavnet | 6:a656e820d7ff | 54 | char idx[WNC_MAX_SMS_MSG_SLOTS]; |
fkellermavnet | 6:a656e820d7ff | 55 | string msgText[WNC_MAX_SMS_MSG_SLOTS]; |
fkellermavnet | 6:a656e820d7ff | 56 | }; |
fkellermavnet | 0:affdbb35faa4 | 57 | |
fkellermavnet | 0:affdbb35faa4 | 58 | |
fkellermavnet | 0:affdbb35faa4 | 59 | /** |
fkellermavnet | 0:affdbb35faa4 | 60 | * \brief Contains info fields for the WNC Internet Attributes |
fkellermavnet | 0:affdbb35faa4 | 61 | */ |
fkellermavnet | 0:affdbb35faa4 | 62 | struct WncIpStats |
fkellermavnet | 0:affdbb35faa4 | 63 | { |
fkellermavnet | 0:affdbb35faa4 | 64 | char ip[MAX_LEN_IP_STR]; |
fkellermavnet | 0:affdbb35faa4 | 65 | char mask[MAX_LEN_IP_STR]; |
fkellermavnet | 0:affdbb35faa4 | 66 | char gateway[MAX_LEN_IP_STR]; |
fkellermavnet | 0:affdbb35faa4 | 67 | char dnsPrimary[MAX_LEN_IP_STR]; |
fkellermavnet | 0:affdbb35faa4 | 68 | char dnsSecondary[MAX_LEN_IP_STR]; |
fkellermavnet | 0:affdbb35faa4 | 69 | }; |
fkellermavnet | 0:affdbb35faa4 | 70 | |
fkellermavnet | 0:affdbb35faa4 | 71 | struct WncDateTime |
fkellermavnet | 0:affdbb35faa4 | 72 | { |
fkellermavnet | 0:affdbb35faa4 | 73 | uint8_t year; |
fkellermavnet | 0:affdbb35faa4 | 74 | uint8_t month; |
fkellermavnet | 0:affdbb35faa4 | 75 | uint8_t day; |
fkellermavnet | 0:affdbb35faa4 | 76 | uint8_t hour; |
fkellermavnet | 0:affdbb35faa4 | 77 | uint8_t min; |
fkellermavnet | 0:affdbb35faa4 | 78 | uint8_t sec; |
fkellermavnet | 0:affdbb35faa4 | 79 | }; |
fkellermavnet | 0:affdbb35faa4 | 80 | |
fkellermavnet | 0:affdbb35faa4 | 81 | class WncController |
fkellermavnet | 0:affdbb35faa4 | 82 | { |
fkellermavnet | 0:affdbb35faa4 | 83 | public: |
fkellermavnet | 0:affdbb35faa4 | 84 | |
fkellermavnet | 0:affdbb35faa4 | 85 | static const unsigned MAX_NUM_WNC_SOCKETS = 1; // Max number of simultaneous sockets that the WNC supports |
fkellermavnet | 0:affdbb35faa4 | 86 | static const unsigned MAX_POWERUP_TIMEOUT = 60; // How long the powerUp method will try to turn on the WNC Shield |
fkellermavnet | 0:affdbb35faa4 | 87 | // (this is the default if the user does not over-ride on power-up |
fkellermavnet | 0:affdbb35faa4 | 88 | |
fkellermavnet | 0:affdbb35faa4 | 89 | // Tracks mode of the WNC Shield hardware |
fkellermavnet | 0:affdbb35faa4 | 90 | enum WncState_e { |
fkellermavnet | 0:affdbb35faa4 | 91 | WNC_OFF = 0, |
fkellermavnet | 0:affdbb35faa4 | 92 | WNC_ON, // This is intended to mean all systems go, including cell link up but socket may not be open |
fkellermavnet | 0:affdbb35faa4 | 93 | WNC_ON_NO_CELL_LINK |
fkellermavnet | 0:affdbb35faa4 | 94 | }; |
fkellermavnet | 0:affdbb35faa4 | 95 | |
fkellermavnet | 0:affdbb35faa4 | 96 | /** |
fkellermavnet | 0:affdbb35faa4 | 97 | * \brief Constructor for UART controlled WNC |
fkellermavnet | 0:affdbb35faa4 | 98 | * |
fkellermavnet | 0:affdbb35faa4 | 99 | * \param [in] wnc_uart - Reference to a SerialBuffered object which will |
fkellermavnet | 0:affdbb35faa4 | 100 | * be used as the bus to control the WNC. apnStr = a text string for |
fkellermavnet | 0:affdbb35faa4 | 101 | * the cellular APN name. |
fkellermavnet | 0:affdbb35faa4 | 102 | * |
fkellermavnet | 0:affdbb35faa4 | 103 | * \return None. |
fkellermavnet | 0:affdbb35faa4 | 104 | * |
fkellermavnet | 0:affdbb35faa4 | 105 | * \details Adding another way to talk to the WNC, like I2C or USB, |
fkellermavnet | 0:affdbb35faa4 | 106 | * a constructor should be added for each type just like the SerialBuffered |
fkellermavnet | 0:affdbb35faa4 | 107 | * constructor below. Assumes UART is enabled, setup and ready to go. This |
fkellermavnet | 0:affdbb35faa4 | 108 | * class will read and write to this UART. |
fkellermavnet | 0:affdbb35faa4 | 109 | */ |
fkellermavnet | 1:ac2de545b981 | 110 | WncController(void); |
fkellermavnet | 0:affdbb35faa4 | 111 | |
fkellermavnet | 0:affdbb35faa4 | 112 | // WncController( const char * const apnStr, MODSERIAL * wnc_uart, MODSERIAL * debug_uart = NULL); |
fkellermavnet | 0:affdbb35faa4 | 113 | |
fkellermavnet | 0:affdbb35faa4 | 114 | /** |
fkellermavnet | 0:affdbb35faa4 | 115 | * \brief Used internally but also make public for a user of the Class to interrogate state as well. |
fkellermavnet | 0:affdbb35faa4 | 116 | * |
fkellermavnet | 0:affdbb35faa4 | 117 | * \param [in] None. |
fkellermavnet | 0:affdbb35faa4 | 118 | * |
fkellermavnet | 0:affdbb35faa4 | 119 | * \return The state of the WNC Modem. |
fkellermavnet | 0:affdbb35faa4 | 120 | * |
fkellermavnet | 0:affdbb35faa4 | 121 | * \details None. |
fkellermavnet | 0:affdbb35faa4 | 122 | */ |
fkellermavnet | 0:affdbb35faa4 | 123 | WncState_e getWncStatus(void); |
fkellermavnet | 0:affdbb35faa4 | 124 | |
fkellermavnet | 0:affdbb35faa4 | 125 | bool setApnName(const char * const apnStr); |
fkellermavnet | 0:affdbb35faa4 | 126 | |
fkellermavnet | 0:affdbb35faa4 | 127 | /** |
fkellermavnet | 0:affdbb35faa4 | 128 | * \brief Return signal quality dBm level |
fkellermavnet | 0:affdbb35faa4 | 129 | * |
fkellermavnet | 0:affdbb35faa4 | 130 | * \param [in] None. |
fkellermavnet | 0:affdbb35faa4 | 131 | * |
fkellermavnet | 0:affdbb35faa4 | 132 | * \return The dBm signal level at the time of the request. |
fkellermavnet | 0:affdbb35faa4 | 133 | * |
fkellermavnet | 0:affdbb35faa4 | 134 | * \details This polls (at the time of the call) the cell signal. |
fkellermavnet | 0:affdbb35faa4 | 135 | */ |
fkellermavnet | 0:affdbb35faa4 | 136 | int16_t getDbmRssi(void); |
fkellermavnet | 0:affdbb35faa4 | 137 | int16_t get3gBer(void); |
fkellermavnet | 0:affdbb35faa4 | 138 | |
fkellermavnet | 0:affdbb35faa4 | 139 | /** |
fkellermavnet | 0:affdbb35faa4 | 140 | * \brief Power up and down (down not implemented yet) |
fkellermavnet | 0:affdbb35faa4 | 141 | * |
fkellermavnet | 0:affdbb35faa4 | 142 | * \param [in] NXP Pins that are critical for the initialization of the WNC Shield. |
fkellermavnet | 0:affdbb35faa4 | 143 | * |
fkellermavnet | 0:affdbb35faa4 | 144 | * \return true if request successful else false. |
fkellermavnet | 0:affdbb35faa4 | 145 | * |
fkellermavnet | 0:affdbb35faa4 | 146 | * \details Power-on works but not power-down. This will manipulate WNC Shield hardware |
fkellermavnet | 0:affdbb35faa4 | 147 | * and bring it to life. It will also initialize the WNC enough to get it to be able to open sockets |
fkellermavnet | 0:affdbb35faa4 | 148 | * (with AT commands) |
fkellermavnet | 0:affdbb35faa4 | 149 | */ |
fkellermavnet | 1:ac2de545b981 | 150 | bool powerWncOn(const char * const apn, uint8_t powerUpTimeoutSecs = MAX_POWERUP_TIMEOUT); |
fkellermavnet | 0:affdbb35faa4 | 151 | |
fkellermavnet | 0:affdbb35faa4 | 152 | /** |
fkellermavnet | 0:affdbb35faa4 | 153 | * \brief Query the WNC modem for its Internet attributes |
fkellermavnet | 0:affdbb35faa4 | 154 | * |
fkellermavnet | 0:affdbb35faa4 | 155 | * \param [in] Pointer to a struct where to put the info. |
fkellermavnet | 0:affdbb35faa4 | 156 | * |
fkellermavnet | 0:affdbb35faa4 | 157 | * \return true if request successful else false. |
fkellermavnet | 0:affdbb35faa4 | 158 | * |
fkellermavnet | 0:affdbb35faa4 | 159 | * \details This method will do a few sanity checks and then gather the |
fkellermavnet | 0:affdbb35faa4 | 160 | * fields of the struct. |
fkellermavnet | 0:affdbb35faa4 | 161 | */ |
fkellermavnet | 0:affdbb35faa4 | 162 | bool getWncNetworkingStats(WncIpStats * s); |
fkellermavnet | 0:affdbb35faa4 | 163 | |
fkellermavnet | 0:affdbb35faa4 | 164 | /** |
fkellermavnet | 0:affdbb35faa4 | 165 | * \brief Look-up a URL text string and convert into an IP Address string. |
fkellermavnet | 0:affdbb35faa4 | 166 | * |
fkellermavnet | 0:affdbb35faa4 | 167 | * \param [in] url - the URL to lookup. numSock - the socket reference. |
fkellermavnet | 0:affdbb35faa4 | 168 | * |
fkellermavnet | 0:affdbb35faa4 | 169 | * \return true - if the IP address has been resolved. false - if the URL could not be resolved. |
fkellermavnet | 0:affdbb35faa4 | 170 | * |
fkellermavnet | 0:affdbb35faa4 | 171 | * \details None. |
fkellermavnet | 0:affdbb35faa4 | 172 | */ |
fkellermavnet | 0:affdbb35faa4 | 173 | bool resolveUrl(uint16_t numSock, const char * url); |
fkellermavnet | 0:affdbb35faa4 | 174 | |
fkellermavnet | 0:affdbb35faa4 | 175 | /** |
fkellermavnet | 0:affdbb35faa4 | 176 | * \brief Set IP Address string |
fkellermavnet | 0:affdbb35faa4 | 177 | * |
fkellermavnet | 0:affdbb35faa4 | 178 | * \param [in] numSock - socket reference to set the string for. ipStr - text string of the IP |
fkellermavnet | 0:affdbb35faa4 | 179 | * address you want to talk to. There is no sanity check - beware!!! |
fkellermavnet | 0:affdbb35faa4 | 180 | * |
fkellermavnet | 0:affdbb35faa4 | 181 | * \return true - if the IP address has been set. false - if the IP could not be set. |
fkellermavnet | 0:affdbb35faa4 | 182 | * |
fkellermavnet | 0:affdbb35faa4 | 183 | * \details None. |
fkellermavnet | 0:affdbb35faa4 | 184 | */ |
fkellermavnet | 0:affdbb35faa4 | 185 | bool setIpAddr(uint16_t numSock, const char * ipStr); |
fkellermavnet | 0:affdbb35faa4 | 186 | |
fkellermavnet | 0:affdbb35faa4 | 187 | /** |
fkellermavnet | 0:affdbb35faa4 | 188 | * \brief Opens a WNC socket. |
fkellermavnet | 0:affdbb35faa4 | 189 | * |
fkellermavnet | 0:affdbb35faa4 | 190 | * \param [in] sockNum - the number of the socket to open. ipAddr - a string containing |
fkellermavnet | 0:affdbb35faa4 | 191 | * the IP address. port - the IP port number to open the socket connection. |
fkellermavnet | 0:affdbb35faa4 | 192 | * |
fkellermavnet | 0:affdbb35faa4 | 193 | * \return true - if the socket is/was opened. false otherwise. |
fkellermavnet | 0:affdbb35faa4 | 194 | * |
fkellermavnet | 0:affdbb35faa4 | 195 | * \details None. |
fkellermavnet | 0:affdbb35faa4 | 196 | */ |
fkellermavnet | 0:affdbb35faa4 | 197 | bool openSocket(uint16_t numSock, uint16_t port, bool tcp, uint16_t timeOutSec = 30); |
fkellermavnet | 0:affdbb35faa4 | 198 | |
fkellermavnet | 0:affdbb35faa4 | 199 | /** |
fkellermavnet | 0:affdbb35faa4 | 200 | * \brief Write bytes of data to an open socket |
fkellermavnet | 0:affdbb35faa4 | 201 | * |
fkellermavnet | 0:affdbb35faa4 | 202 | * \param [in] sockNum - the number of the socket to write. s - a string containing |
fkellermavnet | 0:affdbb35faa4 | 203 | * the byte data to send. |
fkellermavnet | 0:affdbb35faa4 | 204 | * |
fkellermavnet | 0:affdbb35faa4 | 205 | * \return true - if the write was successful. false otherwise. |
fkellermavnet | 0:affdbb35faa4 | 206 | * |
fkellermavnet | 0:affdbb35faa4 | 207 | * \details The results of the write do not have anything to do with the data |
fkellermavnet | 0:affdbb35faa4 | 208 | * arriving at the endpoint. |
fkellermavnet | 0:affdbb35faa4 | 209 | */ |
fkellermavnet | 0:affdbb35faa4 | 210 | bool write(uint16_t numSock, const char * s, uint32_t n); |
fkellermavnet | 0:affdbb35faa4 | 211 | |
fkellermavnet | 0:affdbb35faa4 | 212 | /** |
fkellermavnet | 0:affdbb35faa4 | 213 | * \brief Poll and read back data from the WNC (if it has any) |
fkellermavnet | 0:affdbb35faa4 | 214 | * If auto poll is enabled this read might fail (return with no data). |
fkellermavnet | 0:affdbb35faa4 | 215 | * |
fkellermavnet | 0:affdbb35faa4 | 216 | * \param [in] sockNum - the number of the socket to read. result - a string pointer containing |
fkellermavnet | 0:affdbb35faa4 | 217 | * the byte data readback from the WNC. |
fkellermavnet | 0:affdbb35faa4 | 218 | * |
fkellermavnet | 0:affdbb35faa4 | 219 | * \return The number of bytes/chars that are read from the socket. |
fkellermavnet | 0:affdbb35faa4 | 220 | * |
fkellermavnet | 0:affdbb35faa4 | 221 | * \details DO NOT use the same string as is passed to the auto poll setup method! |
fkellermavnet | 0:affdbb35faa4 | 222 | */ |
fkellermavnet | 0:affdbb35faa4 | 223 | size_t read(uint16_t numSock, uint8_t * readBuf, uint32_t maxReadBufLen); |
fkellermavnet | 4:c5720f4d13ff | 224 | |
fkellermavnet | 4:c5720f4d13ff | 225 | size_t read(uint16_t numSock, const uint8_t ** readBuf); |
fkellermavnet | 0:affdbb35faa4 | 226 | |
fkellermavnet | 0:affdbb35faa4 | 227 | /** |
fkellermavnet | 0:affdbb35faa4 | 228 | * \brief Set how many times the above read method will retry if data is not returned. |
fkellermavnet | 0:affdbb35faa4 | 229 | * |
fkellermavnet | 0:affdbb35faa4 | 230 | * \param [in] sockNum - the number of the socket to set. retries - how many times to |
fkellermavnet | 0:affdbb35faa4 | 231 | * poll until data is found. |
fkellermavnet | 0:affdbb35faa4 | 232 | * |
fkellermavnet | 0:affdbb35faa4 | 233 | * \return None. |
fkellermavnet | 0:affdbb35faa4 | 234 | * |
fkellermavnet | 0:affdbb35faa4 | 235 | * \details None. |
fkellermavnet | 0:affdbb35faa4 | 236 | */ |
fkellermavnet | 0:affdbb35faa4 | 237 | void setReadRetries(uint16_t numSock, uint16_t retries); |
fkellermavnet | 0:affdbb35faa4 | 238 | |
fkellermavnet | 0:affdbb35faa4 | 239 | /** |
fkellermavnet | 0:affdbb35faa4 | 240 | * \brief Set how long between retries to wait. |
fkellermavnet | 0:affdbb35faa4 | 241 | * |
fkellermavnet | 0:affdbb35faa4 | 242 | * \param [in] sockNum - the number of the socket to set. waitMs - how long to wait |
fkellermavnet | 0:affdbb35faa4 | 243 | * before doing the read poll (calling read(...)). |
fkellermavnet | 0:affdbb35faa4 | 244 | * |
fkellermavnet | 0:affdbb35faa4 | 245 | * \return None. |
fkellermavnet | 0:affdbb35faa4 | 246 | * |
fkellermavnet | 0:affdbb35faa4 | 247 | * \details None. |
fkellermavnet | 0:affdbb35faa4 | 248 | */ |
fkellermavnet | 0:affdbb35faa4 | 249 | void setReadRetryWait(uint16_t numSock, uint16_t waitMs); |
fkellermavnet | 0:affdbb35faa4 | 250 | |
fkellermavnet | 0:affdbb35faa4 | 251 | /** |
fkellermavnet | 0:affdbb35faa4 | 252 | * \brief Close the socket. |
fkellermavnet | 0:affdbb35faa4 | 253 | * |
fkellermavnet | 0:affdbb35faa4 | 254 | * \param [in] sockNum - the number of the socket to close. |
fkellermavnet | 0:affdbb35faa4 | 255 | * |
fkellermavnet | 0:affdbb35faa4 | 256 | * \return None. |
fkellermavnet | 0:affdbb35faa4 | 257 | * |
fkellermavnet | 0:affdbb35faa4 | 258 | * \details None. |
fkellermavnet | 0:affdbb35faa4 | 259 | */ |
fkellermavnet | 0:affdbb35faa4 | 260 | bool closeSocket(uint16_t numSock); |
fkellermavnet | 0:affdbb35faa4 | 261 | |
fkellermavnet | 6:a656e820d7ff | 262 | void setWncCmdTimeout(uint16_t toMs); |
fkellermavnet | 6:a656e820d7ff | 263 | |
fkellermavnet | 0:affdbb35faa4 | 264 | bool getIpAddr(uint16_t numSock, char myIpAddr[MAX_LEN_IP_STR]); |
fkellermavnet | 0:affdbb35faa4 | 265 | |
fkellermavnet | 0:affdbb35faa4 | 266 | void enableDebug(bool on, bool moreDebugOn); |
fkellermavnet | 0:affdbb35faa4 | 267 | |
fkellermavnet | 0:affdbb35faa4 | 268 | /////////////////////////////////////////// |
fkellermavnet | 0:affdbb35faa4 | 269 | // SMS messaging |
fkellermavnet | 0:affdbb35faa4 | 270 | /////////////////////////////////////////// |
fkellermavnet | 0:affdbb35faa4 | 271 | |
fkellermavnet | 0:affdbb35faa4 | 272 | bool sendSMSText(const char * const phoneNum, const char * const text); |
fkellermavnet | 0:affdbb35faa4 | 273 | |
fkellermavnet | 0:affdbb35faa4 | 274 | size_t readSMSLog(const char ** log); |
fkellermavnet | 0:affdbb35faa4 | 275 | |
fkellermavnet | 0:affdbb35faa4 | 276 | bool saveSMSText(const char * const phoneNum, const char * const text, char * msgIdx); |
fkellermavnet | 0:affdbb35faa4 | 277 | |
fkellermavnet | 0:affdbb35faa4 | 278 | bool sendSMSTextFromMem(char msgIdx); |
fkellermavnet | 0:affdbb35faa4 | 279 | |
fkellermavnet | 0:affdbb35faa4 | 280 | bool deleteSMSTextFromMem(char msgIdx); |
fkellermavnet | 0:affdbb35faa4 | 281 | |
fkellermavnet | 6:a656e820d7ff | 282 | size_t readSMSText(const char n, const char ** msg); |
fkellermavnet | 6:a656e820d7ff | 283 | |
fkellermavnet | 6:a656e820d7ff | 284 | bool readUnreadSMSText(WncSmsInfo * w); |
fkellermavnet | 0:affdbb35faa4 | 285 | |
fkellermavnet | 0:affdbb35faa4 | 286 | /////////////////////////////////////////// |
fkellermavnet | 0:affdbb35faa4 | 287 | // Neighborhood Cell Info |
fkellermavnet | 0:affdbb35faa4 | 288 | /////////////////////////////////////////// |
fkellermavnet | 0:affdbb35faa4 | 289 | size_t getSignalQuality(const char ** log); |
fkellermavnet | 0:affdbb35faa4 | 290 | |
fkellermavnet | 0:affdbb35faa4 | 291 | // Date Time |
fkellermavnet | 0:affdbb35faa4 | 292 | bool getTimeDate(struct WncDateTime * tod); |
fkellermavnet | 0:affdbb35faa4 | 293 | |
fkellermavnet | 0:affdbb35faa4 | 294 | // Ping |
fkellermavnet | 0:affdbb35faa4 | 295 | bool pingUrl(const char * url); |
fkellermavnet | 0:affdbb35faa4 | 296 | bool pingIp(const char * ip); |
fkellermavnet | 0:affdbb35faa4 | 297 | |
fkellermavnet | 0:affdbb35faa4 | 298 | // User command: |
fkellermavnet | 0:affdbb35faa4 | 299 | size_t sendCustomCmd(const char * cmd, char * resp, size_t sizeRespBuf, int ms_timeout); |
fkellermavnet | 0:affdbb35faa4 | 300 | |
fkellermavnet | 0:affdbb35faa4 | 301 | protected: |
fkellermavnet | 0:affdbb35faa4 | 302 | |
fkellermavnet | 0:affdbb35faa4 | 303 | // Debug output methods |
fkellermavnet | 0:affdbb35faa4 | 304 | int dbgPutsNoTime(const char * s, bool crlf = true); |
fkellermavnet | 0:affdbb35faa4 | 305 | int dbgPuts(const char * s, bool crlf = true); |
fkellermavnet | 0:affdbb35faa4 | 306 | const char * _to_string(int64_t value); |
fkellermavnet | 1:ac2de545b981 | 307 | const char * _to_hex_string(uint8_t value); |
fkellermavnet | 0:affdbb35faa4 | 308 | |
fkellermavnet | 0:affdbb35faa4 | 309 | // Sends commands to WNC via |
fkellermavnet | 0:affdbb35faa4 | 310 | enum AtCmdErr_e { |
fkellermavnet | 0:affdbb35faa4 | 311 | WNC_AT_CMD_OK, |
fkellermavnet | 0:affdbb35faa4 | 312 | WNC_AT_CMD_ERR, |
fkellermavnet | 0:affdbb35faa4 | 313 | WNC_AT_CMD_ERREXT, |
fkellermavnet | 0:affdbb35faa4 | 314 | WNC_AT_CMD_ERRCME, |
fkellermavnet | 0:affdbb35faa4 | 315 | WNC_AT_CMD_INVALID_RESPONSE, |
fkellermavnet | 0:affdbb35faa4 | 316 | WNC_AT_CMD_TIMEOUT, |
fkellermavnet | 0:affdbb35faa4 | 317 | WNC_AT_CMD_NO_CELL_LINK, |
fkellermavnet | 0:affdbb35faa4 | 318 | WNC_AT_CMD_WNC_NOT_ON |
fkellermavnet | 0:affdbb35faa4 | 319 | }; |
fkellermavnet | 0:affdbb35faa4 | 320 | |
fkellermavnet | 0:affdbb35faa4 | 321 | // Users must define these functionalities: |
fkellermavnet | 0:affdbb35faa4 | 322 | virtual int putc(char c) = 0; |
fkellermavnet | 0:affdbb35faa4 | 323 | virtual int puts(const char * s) = 0; |
fkellermavnet | 0:affdbb35faa4 | 324 | virtual char getc(void) = 0; |
fkellermavnet | 1:ac2de545b981 | 325 | virtual int charReady(void) = 0; |
fkellermavnet | 1:ac2de545b981 | 326 | virtual int dbgWriteChar(char b) = 0; |
fkellermavnet | 1:ac2de545b981 | 327 | virtual int dbgWriteChars(const char *b) = 0; |
fkellermavnet | 0:affdbb35faa4 | 328 | virtual void waitMs(int t) = 0; |
fkellermavnet | 0:affdbb35faa4 | 329 | virtual void waitUs(int t) = 0; |
fkellermavnet | 0:affdbb35faa4 | 330 | virtual bool initWncModem(uint8_t powerUpTimeoutSecs) = 0; |
fkellermavnet | 0:affdbb35faa4 | 331 | |
fkellermavnet | 0:affdbb35faa4 | 332 | // Isolate OS timers |
fkellermavnet | 1:ac2de545b981 | 333 | virtual int getLogTimerTicks(void) = 0; |
fkellermavnet | 1:ac2de545b981 | 334 | virtual void startTimerA(void) = 0; |
fkellermavnet | 1:ac2de545b981 | 335 | virtual void stopTimerA(void) = 0; |
fkellermavnet | 1:ac2de545b981 | 336 | virtual int getTimerTicksA_mS(void) = 0; |
fkellermavnet | 1:ac2de545b981 | 337 | virtual void startTimerB(void) = 0; |
fkellermavnet | 1:ac2de545b981 | 338 | virtual void stopTimerB(void) = 0; |
fkellermavnet | 1:ac2de545b981 | 339 | virtual int getTimerTicksB_mS(void) = 0; |
fkellermavnet | 0:affdbb35faa4 | 340 | |
fkellermavnet | 0:affdbb35faa4 | 341 | bool waitForPowerOnModemToRespond(uint8_t powerUpTimeoutSecs); |
fkellermavnet | 2:30d78cda6779 | 342 | AtCmdErr_e sendWncCmd(const char * const s, string ** r, int ms_timeout); |
fkellermavnet | 2:30d78cda6779 | 343 | |
fkellermavnet | 0:affdbb35faa4 | 344 | private: |
fkellermavnet | 0:affdbb35faa4 | 345 | |
fkellermavnet | 0:affdbb35faa4 | 346 | bool softwareInitMdm(void); |
fkellermavnet | 0:affdbb35faa4 | 347 | bool checkCellLink(void); |
fkellermavnet | 0:affdbb35faa4 | 348 | AtCmdErr_e mdmSendAtCmdRsp(const char * cmd, int timeout_ms, string * rsp, bool crLf = true); |
fkellermavnet | 1:ac2de545b981 | 349 | size_t mdmGetline(string * buff, int timeout_ms); |
fkellermavnet | 0:affdbb35faa4 | 350 | bool at_at_wnc(void); |
fkellermavnet | 0:affdbb35faa4 | 351 | bool at_init_wnc(bool hardReset = false); |
fkellermavnet | 10:2ec59906a24e | 352 | int16_t at_sockopen_wnc(const char * const ip, uint16_t port, uint16_t numSock, bool tcp, uint16_t timeOutSec); |
fkellermavnet | 0:affdbb35faa4 | 353 | bool at_sockclose_wnc(uint16_t numSock); |
fkellermavnet | 0:affdbb35faa4 | 354 | bool at_dnsresolve_wnc(const char * s, string * ipStr); |
fkellermavnet | 0:affdbb35faa4 | 355 | AtCmdErr_e at_sockwrite_wnc(const char * s, uint32_t n, uint16_t numSock, bool isTcp); |
fkellermavnet | 12:33290e9e6e5f | 356 | AtCmdErr_e at_sockread_wnc(uint8_t * pS, uint16_t * numRead, uint16_t n, uint16_t numSock, bool isTcp); |
fkellermavnet | 4:c5720f4d13ff | 357 | AtCmdErr_e at_sockread_wnc(string * pS, uint16_t numSock, bool isTcp); |
fkellermavnet | 0:affdbb35faa4 | 358 | bool at_reinitialize_mdm(void); |
fkellermavnet | 0:affdbb35faa4 | 359 | AtCmdErr_e at_send_wnc_cmd(const char * s, string ** r, int ms_timeout); |
fkellermavnet | 0:affdbb35faa4 | 360 | bool at_setapn_wnc(const char * const apnStr); |
fkellermavnet | 0:affdbb35faa4 | 361 | bool at_sendSMStext_wnc(const char * const phoneNum, const char * const text); |
fkellermavnet | 0:affdbb35faa4 | 362 | bool at_get_wnc_net_stats(WncIpStats * s); |
fkellermavnet | 0:affdbb35faa4 | 363 | size_t at_readSMSlog_wnc(const char ** log); |
fkellermavnet | 0:affdbb35faa4 | 364 | size_t at_readSMStext_wnc(const char ** log); |
fkellermavnet | 6:a656e820d7ff | 365 | size_t at_readSMStext_wnc(const char n, const char ** log); |
fkellermavnet | 0:affdbb35faa4 | 366 | bool at_getrssiber_wnc(int16_t * dBm, int16_t * ber3g); |
fkellermavnet | 0:affdbb35faa4 | 367 | void closeOpenSocket(uint16_t numSock); |
fkellermavnet | 1:ac2de545b981 | 368 | bool sockWrite(const char * const s, uint32_t n, uint16_t numSock, bool isTcp); |
fkellermavnet | 0:affdbb35faa4 | 369 | bool at_sendSMStextMem_wnc(char n); |
fkellermavnet | 0:affdbb35faa4 | 370 | bool at_deleteSMSTextFromMem_wnc(char n); |
fkellermavnet | 0:affdbb35faa4 | 371 | bool at_saveSMStext_wnc(const char * const phoneNum, const char * const text, char * msgIdx); |
fkellermavnet | 0:affdbb35faa4 | 372 | size_t at_getSignalQuality_wnc(const char ** log); |
fkellermavnet | 0:affdbb35faa4 | 373 | bool at_gettimedate_wnc(struct WncDateTime * tod); |
fkellermavnet | 0:affdbb35faa4 | 374 | bool at_ping_wnc(const char * ip); |
fkellermavnet | 0:affdbb35faa4 | 375 | |
fkellermavnet | 0:affdbb35faa4 | 376 | // Utility methods |
fkellermavnet | 0:affdbb35faa4 | 377 | void sendCmd(const char * cmd, bool crLf); |
fkellermavnet | 0:affdbb35faa4 | 378 | void sendCmd(const char * cmd, unsigned n, unsigned wait_uS, bool crLf); |
fkellermavnet | 0:affdbb35faa4 | 379 | inline void rx_char_wait(void) { |
fkellermavnet | 0:affdbb35faa4 | 380 | // waitUs(1000); |
fkellermavnet | 0:affdbb35faa4 | 381 | } |
fkellermavnet | 0:affdbb35faa4 | 382 | |
fkellermavnet | 0:affdbb35faa4 | 383 | // Important constants |
fkellermavnet | 6:a656e820d7ff | 384 | static const uint16_t MAX_WNC_READ_BYTES = 1500; // This bounds the largest amount of data that the WNC read from a socket will return |
fkellermavnet | 6:a656e820d7ff | 385 | static const uint16_t MAX_WNC_WRITE_BYTES = MAX_WNC_READ_BYTES; // This is the largest amount of data that the WNC can write per sockwrite. |
fkellermavnet | 6:a656e820d7ff | 386 | static const uint16_t MAX_LEN_WNC_CMD_RESPONSE = (MAX_WNC_READ_BYTES * 2 + 100); // Max number of text characters in a WNC AT response *2 because bytes are converted into 2 hex-digits +100 for other AT@ chars. |
fkellermavnet | 6:a656e820d7ff | 387 | static const uint16_t WNC_AUTO_POLL_MS = 250; // Sets default (may be overriden with method) poll interval (currently not used, future possible feature. |
fkellermavnet | 6:a656e820d7ff | 388 | static const uint16_t WNC_CMD_TIMEOUT_MS = 40000; // Sets default (may be overriden) time that the software waits for an AT response from the WNC. |
fkellermavnet | 6:a656e820d7ff | 389 | static const uint16_t WNC_QUICK_CMD_TIMEOUT_MS = 2000; // Used for simple commands that should immediately respond such as "AT", cmds that are quicker than WNC_CMD_TIMEOUT_MS. |
fkellermavnet | 6:a656e820d7ff | 390 | static const uint16_t WNC_WAIT_FOR_AT_CMD_MS = 0; // Wait this much between multiple in a row AT commands to the WNC. |
fkellermavnet | 6:a656e820d7ff | 391 | static const uint16_t MAX_WNC_SMS_LENGTH = 150; // The maximum length of an SMS message the WNC can send and receive. |
fkellermavnet | 6:a656e820d7ff | 392 | static const uint16_t WNC_SOFT_INIT_RETRY_COUNT = 10; // How many times the WNC will be tried to revive if it stops responding. |
fkellermavnet | 6:a656e820d7ff | 393 | static const uint16_t WNC_DNS_RESOLVE_WAIT_MS = 60000; // How much time to wait for the WNC to respond to a DNS resolve/lookup. |
fkellermavnet | 6:a656e820d7ff | 394 | static const uint16_t WNC_TRUNC_DEBUG_LENGTH = 80; // Always make this an even number, how many chars for the debug output before shortening the debug ouput, this is used when moreDebug = false. |
fkellermavnet | 6:a656e820d7ff | 395 | static const uint16_t WNC_APNSET_TIMEOUT_MS = 60000; // How long to wait for the WNC to respond to setting the APN string. |
fkellermavnet | 6:a656e820d7ff | 396 | static const uint16_t WNC_PING_CMD_TIMEOUT_MS = 60000; // Amount of time to wait for the WNC to respond to AT@PINGREQ (with cmd default params for timeout, does not change WNC cmd's timeout) |
fkellermavnet | 6:a656e820d7ff | 397 | static const int WNC_REINIT_MAX_TIME_MS = 60000; // How long to wait for the WNC to reset after it was already up and running after power-up. |
fkellermavnet | 6:a656e820d7ff | 398 | static const char * const INVALID_IP_STR; // Just a string set to an IP address when DNS resolve fails. |
fkellermavnet | 0:affdbb35faa4 | 399 | |
fkellermavnet | 0:affdbb35faa4 | 400 | struct WncSocketInfo_s { |
fkellermavnet | 10:2ec59906a24e | 401 | int16_t numWncSock; |
fkellermavnet | 0:affdbb35faa4 | 402 | bool open; |
fkellermavnet | 0:affdbb35faa4 | 403 | string myIpAddressStr; |
fkellermavnet | 0:affdbb35faa4 | 404 | uint16_t myPort; |
fkellermavnet | 0:affdbb35faa4 | 405 | uint8_t readRetries; |
fkellermavnet | 0:affdbb35faa4 | 406 | uint16_t readRetryWaitMs; |
fkellermavnet | 0:affdbb35faa4 | 407 | bool isTcp; |
fkellermavnet | 0:affdbb35faa4 | 408 | uint16_t timeOutSec; |
fkellermavnet | 0:affdbb35faa4 | 409 | }; |
fkellermavnet | 0:affdbb35faa4 | 410 | |
fkellermavnet | 0:affdbb35faa4 | 411 | static WncSocketInfo_s m_sSock[MAX_NUM_WNC_SOCKETS]; |
fkellermavnet | 10:2ec59906a24e | 412 | static const WncSocketInfo_s defaultSockStruct; |
fkellermavnet | 0:affdbb35faa4 | 413 | static WncState_e m_sState; |
fkellermavnet | 0:affdbb35faa4 | 414 | static uint16_t m_sCmdTimeoutMs; |
fkellermavnet | 0:affdbb35faa4 | 415 | static string m_sApnStr; |
fkellermavnet | 0:affdbb35faa4 | 416 | static string m_sWncStr; |
fkellermavnet | 0:affdbb35faa4 | 417 | static uint8_t m_sPowerUpTimeoutSecs; |
fkellermavnet | 0:affdbb35faa4 | 418 | static bool m_sDebugEnabled; |
fkellermavnet | 0:affdbb35faa4 | 419 | static bool m_sMoreDebugEnabled; |
fkellermavnet | 0:affdbb35faa4 | 420 | static bool m_sCheckNetStatus; |
fkellermavnet | 0:affdbb35faa4 | 421 | static bool m_sReadyForSMS; |
fkellermavnet | 0:affdbb35faa4 | 422 | }; |
fkellermavnet | 0:affdbb35faa4 | 423 | |
fkellermavnet | 0:affdbb35faa4 | 424 | }; // End namespace WncController_fk |
fkellermavnet | 0:affdbb35faa4 | 425 | |
fkellermavnet | 0:affdbb35faa4 | 426 | #endif |