Martin Kojtal / cc3000_hostdriver_mbedsocket Featured

cc3000 hostdriver with the mbed socket interface

Dependents:   cc3000_hello_world_demo cc3000_simple_socket_demo cc3000_ntp_demo cc3000_ping_demo ... more

cc3000.h@44:960b73df5981, 2013-10-13 (annotated)

Committer:
Kojto
Date:
Sun Oct 13 11:46:21 2013 +0200
Revision:
44:960b73df5981
Parent:
43:864437b6c058
Child:
45:50ab13d8f2dc
all _DEBUG_ are set to 0, toggle to enable/disable, doxygen doc for new ethernet interface functions

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Kojto 20:30b6ed7bf8fd 1 /*****************************************************************************
Kojto 20:30b6ed7bf8fd 2 *
Kojto 20:30b6ed7bf8fd 3 * C++ interface/implementation created by Martin Kojtal (0xc0170). Thanks to
Kojto 20:30b6ed7bf8fd 4 * Jim Carver and Frank Vannieuwkerke for their inital cc3000 mbed port and
Kojto 20:30b6ed7bf8fd 5 * provided help.
Kojto 20:30b6ed7bf8fd 6 *
Kojto 20:30b6ed7bf8fd 7 * This version of "host driver" uses CC3000 Host Driver Implementation. Thus
Kojto 20:30b6ed7bf8fd 8 * read the following copyright:
Kojto 20:30b6ed7bf8fd 9 *
Kojto 20:30b6ed7bf8fd 10 * Copyright (C) 2011 Texas Instruments Incorporated - http://www.ti.com/
Kojto 20:30b6ed7bf8fd 11 *
Kojto 20:30b6ed7bf8fd 12 * Redistribution and use in source and binary forms, with or without
Kojto 20:30b6ed7bf8fd 13 * modification, are permitted provided that the following conditions
Kojto 20:30b6ed7bf8fd 14 * are met:
Kojto 20:30b6ed7bf8fd 15 *
Kojto 20:30b6ed7bf8fd 16 * Redistributions of source code must retain the above copyright
Kojto 20:30b6ed7bf8fd 17 * notice, this list of conditions and the following disclaimer.
Kojto 20:30b6ed7bf8fd 18 *
Kojto 20:30b6ed7bf8fd 19 * Redistributions in binary form must reproduce the above copyright
Kojto 20:30b6ed7bf8fd 20 * notice, this list of conditions and the following disclaimer in the
Kojto 20:30b6ed7bf8fd 21 * documentation and/or other materials provided with the
Kojto 20:30b6ed7bf8fd 22 * distribution.
Kojto 20:30b6ed7bf8fd 23 *
Kojto 20:30b6ed7bf8fd 24 * Neither the name of Texas Instruments Incorporated nor the names of
Kojto 20:30b6ed7bf8fd 25 * its contributors may be used to endorse or promote products derived
Kojto 20:30b6ed7bf8fd 26 * from this software without specific prior written permission.
Kojto 20:30b6ed7bf8fd 27 *
Kojto 20:30b6ed7bf8fd 28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
Kojto 20:30b6ed7bf8fd 29 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
Kojto 20:30b6ed7bf8fd 30 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
Kojto 20:30b6ed7bf8fd 31 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
Kojto 20:30b6ed7bf8fd 32 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
Kojto 20:30b6ed7bf8fd 33 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
Kojto 20:30b6ed7bf8fd 34 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
Kojto 20:30b6ed7bf8fd 35 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
Kojto 20:30b6ed7bf8fd 36 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
Kojto 20:30b6ed7bf8fd 37 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Kojto 20:30b6ed7bf8fd 38 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Kojto 20:30b6ed7bf8fd 39 *
Kojto 20:30b6ed7bf8fd 40 *****************************************************************************/
Kojto 20:30b6ed7bf8fd 41 #ifndef CC3000_H
Kojto 20:30b6ed7bf8fd 42 #define CC3000_H
Kojto 20:30b6ed7bf8fd 43
Kojto 20:30b6ed7bf8fd 44 #include "mbed.h"
Kojto 20:30b6ed7bf8fd 45 #include "cc3000_common.h"
Kojto 20:30b6ed7bf8fd 46 #include "cc3000_spi.h"
Kojto 20:30b6ed7bf8fd 47 #include "cc3000_simplelink.h"
Kojto 20:30b6ed7bf8fd 48 #include "cc3000_netapp.h"
Kojto 20:30b6ed7bf8fd 49 #include "cc3000_nvmem.h"
Kojto 20:30b6ed7bf8fd 50 #include "cc3000_socket.h"
Kojto 20:30b6ed7bf8fd 51
Kojto 20:30b6ed7bf8fd 52 #define MAX_SOCKETS 4
Kojto 44:960b73df5981 53 // cc3000 Ethernet Interface - enabled by default
Kojto 44:960b73df5981 54 #define CC3000_ETH_COMPAT 1
Kojto 20:30b6ed7bf8fd 55
Kojto 44:960b73df5981 56 /** Enable debug messages - set 1 */
SolderSplashLabs 24:ba3fa29197ac 57 // Debug - Socket interface messages
Kojto 44:960b73df5981 58 #define CC3000_DEBUG_SOCKET 0
SolderSplashLabs 24:ba3fa29197ac 59 // Debug - HCI TX messages
Kojto 44:960b73df5981 60 #define CC3000_DEBUG_HCI_TX 0
SolderSplashLabs 24:ba3fa29197ac 61 // Debug - HCI Rx messages
Kojto 44:960b73df5981 62 #define CC3000_DEBUG_HCI_RX 0
SolderSplashLabs 24:ba3fa29197ac 63 // Debug - General Debug
Kojto 44:960b73df5981 64 #define CC3000_DEBUG 0
SolderSplashLabs 26:456f73ed2a75 65 // Add colour to the debug messages, requires a VT100 terminal like putty, comment out to remove
Kojto 44:960b73df5981 66 #define VT100_COLOUR 0
SolderSplashLabs 22:d23c59fec0dc 67
Kojto 44:960b73df5981 68 #if (CC3000_DEBUG_SOCKET == 1)
Kojto 44:960b73df5981 69 #if (VT100_COLOUR == 1)
SolderSplashLabs 22:d23c59fec0dc 70 #define DBG_SOCKET(x, ...) std::printf("\x1b[2;32;40m[CC3000 : SOCKET] "x"\x1b[0;37;40m\r\n", ##__VA_ARGS__);
SolderSplashLabs 22:d23c59fec0dc 71 #else
SolderSplashLabs 22:d23c59fec0dc 72 #define DBG_SOCKET(x, ...) std::printf("[CC3000 : SOCKET] "x"\r\n", ##__VA_ARGS__);
SolderSplashLabs 22:d23c59fec0dc 73 #endif
Kojto 20:30b6ed7bf8fd 74 #else
Kojto 20:30b6ed7bf8fd 75 #define DBG_SOCKET(x, ...)
SolderSplashLabs 22:d23c59fec0dc 76 #endif
SolderSplashLabs 22:d23c59fec0dc 77
Kojto 44:960b73df5981 78 #if (CC3000_DEBUG_HCI_TX == 1)
Kojto 44:960b73df5981 79 #if (VT100_COLOUR == 1)
SolderSplashLabs 22:d23c59fec0dc 80 #define DBG_HCI(x, ...) std::printf("\x1b[2;35;40m[CC3000 : HCI RX] "x"\x1b[0;37;40m\r\n", ##__VA_ARGS__);
SolderSplashLabs 22:d23c59fec0dc 81 #else
SolderSplashLabs 22:d23c59fec0dc 82 #define DBG_HCI(x, ...) std::printf("[CC3000 : HCI RX] "x"\r\n", ##__VA_ARGS__);
SolderSplashLabs 22:d23c59fec0dc 83 #endif
SolderSplashLabs 22:d23c59fec0dc 84 #else
Kojto 20:30b6ed7bf8fd 85 #define DBG_HCI(x, ...)
SolderSplashLabs 22:d23c59fec0dc 86 #endif
SolderSplashLabs 22:d23c59fec0dc 87
Kojto 44:960b73df5981 88 #if (CC3000_DEBUG_HCI_RX == 1)
Kojto 44:960b73df5981 89 #if (VT100_COLOUR == 1)
SolderSplashLabs 22:d23c59fec0dc 90 #define DBG_HCI_CMD(x, ...) std::printf("\x1b[2;36;40m[CC3000 : HCI TX] "x"\x1b[0;37;40m\r\n", ##__VA_ARGS__);
SolderSplashLabs 22:d23c59fec0dc 91 #else
SolderSplashLabs 22:d23c59fec0dc 92 #define DBG_HCI_CMD(x, ...) std::printf("[CC3000 : HCI TX] "x"\r\n", ##__VA_ARGS__);
SolderSplashLabs 22:d23c59fec0dc 93 #endif
SolderSplashLabs 22:d23c59fec0dc 94 #else
SolderSplashLabs 22:d23c59fec0dc 95 #define DBG_HCI_CMD(x, ...)
SolderSplashLabs 22:d23c59fec0dc 96 #endif
SolderSplashLabs 22:d23c59fec0dc 97
Kojto 44:960b73df5981 98 #if (CC3000_DEBUG == 1)
Kojto 44:960b73df5981 99 #if (VT100_COLOUR == 1)
SolderSplashLabs 22:d23c59fec0dc 100 #define DBG_CC(x, ...) std::printf("\x1b[2;32;40m[CC3000] "x"\x1b[0;37;40m\r\n", ##__VA_ARGS__);
SolderSplashLabs 22:d23c59fec0dc 101 #else
SolderSplashLabs 22:d23c59fec0dc 102 #define DBG_CC(x, ...) std::printf("[CC3000] "x"\r\n", ##__VA_ARGS__);
SolderSplashLabs 22:d23c59fec0dc 103 #endif
SolderSplashLabs 22:d23c59fec0dc 104 #else
SolderSplashLabs 24:ba3fa29197ac 105 #define DBG_CC(x, ...)
Kojto 20:30b6ed7bf8fd 106 #endif
Kojto 20:30b6ed7bf8fd 107
Kojto 20:30b6ed7bf8fd 108 namespace mbed_cc3000 {
Kojto 20:30b6ed7bf8fd 109
Kojto 20:30b6ed7bf8fd 110 /** User info structure
Kojto 20:30b6ed7bf8fd 111 */
Kojto 20:30b6ed7bf8fd 112 typedef struct {
Kojto 20:30b6ed7bf8fd 113 uint8_t FTC; // First time config performed
Kojto 20:30b6ed7bf8fd 114 uint8_t PP_version[2]; // Patch Programmer version
Kojto 20:30b6ed7bf8fd 115 uint8_t SERV_PACK[2]; // Service Pack Version
Kojto 20:30b6ed7bf8fd 116 uint8_t DRV_VER[3]; // Driver Version
Kojto 20:30b6ed7bf8fd 117 uint8_t FW_VER[3]; // Firmware Version
Kojto 20:30b6ed7bf8fd 118 uint8_t validCIK; // CIK[] is valid (Client Interface Key)
Kojto 20:30b6ed7bf8fd 119 uint8_t CIK[40];
Kojto 20:30b6ed7bf8fd 120 } tUserFS;
Kojto 20:30b6ed7bf8fd 121
Kojto 20:30b6ed7bf8fd 122 /** Function pointers which are not yet implemented
Kojto 20:30b6ed7bf8fd 123 */
Kojto 20:30b6ed7bf8fd 124 enum FunctionNumber {
Kojto 20:30b6ed7bf8fd 125 FW_PATCHES = 0,
Kojto 20:30b6ed7bf8fd 126 DRIVER_PATCHES = 1,
Kojto 20:30b6ed7bf8fd 127 BOOTLOADER_PATCHES = 2,
Kojto 20:30b6ed7bf8fd 128 };
Kojto 20:30b6ed7bf8fd 129
Kojto 20:30b6ed7bf8fd 130 /** CC3000 Simple Link class which contains status of cc3000.
Kojto 20:30b6ed7bf8fd 131 */
Kojto 20:30b6ed7bf8fd 132 class cc3000_simple_link {
Kojto 20:30b6ed7bf8fd 133 public:
Kojto 33:9e23b24fb4f3 134 /**
Kojto 33:9e23b24fb4f3 135 * \brief ctor - sets magic number in the buffers (overflow mark).
Kojto 33:9e23b24fb4f3 136 * \param none
Kojto 33:9e23b24fb4f3 137 * \return none
Kojto 20:30b6ed7bf8fd 138 */
Kojto 20:30b6ed7bf8fd 139 cc3000_simple_link();
Kojto 33:9e23b24fb4f3 140 /**
Kojto 33:9e23b24fb4f3 141 * \brief dtor
Kojto 33:9e23b24fb4f3 142 * \param none
Kojto 33:9e23b24fb4f3 143 * \return none
Kojto 20:30b6ed7bf8fd 144 */
Kojto 20:30b6ed7bf8fd 145 ~cc3000_simple_link();
Kojto 33:9e23b24fb4f3 146 /**
Kojto 33:9e23b24fb4f3 147 * \brief Returns data received flag.
Kojto 33:9e23b24fb4f3 148 * \return Data received flag.
Kojto 20:30b6ed7bf8fd 149 */
Kojto 20:30b6ed7bf8fd 150 uint8_t get_data_received_flag();
Kojto 33:9e23b24fb4f3 151 /**
Kojto 33:9e23b24fb4f3 152 * \brief Set data received flag.
Kojto 20:30b6ed7bf8fd 153 * \param value The value to be set.
Kojto 20:30b6ed7bf8fd 154 */
Kojto 20:30b6ed7bf8fd 155 void set_data_received_flag(uint8_t value);
Kojto 20:30b6ed7bf8fd 156 /** Returns if tx was completed.
Kojto 20:30b6ed7bf8fd 157 * \return
Kojto 20:30b6ed7bf8fd 158 * true if tx was completed,
Kojto 20:30b6ed7bf8fd 159 * false otherwise.
Kojto 20:30b6ed7bf8fd 160 */
Kojto 20:30b6ed7bf8fd 161 bool get_tx_complete_signal();
Kojto 20:30b6ed7bf8fd 162 /**
Kojto 33:9e23b24fb4f3 163 * \brief Sets flag that tx was completed.
Kojto 33:9e23b24fb4f3 164 * \param value Value to be set
Kojto 33:9e23b24fb4f3 165 * \return none
Kojto 20:30b6ed7bf8fd 166 */
Kojto 20:30b6ed7bf8fd 167 void set_tx_complete_signal(bool value);
Kojto 20:30b6ed7bf8fd 168 /**
Kojto 33:9e23b24fb4f3 169 * \brief Get receive buffer.
Kojto 33:9e23b24fb4f3 170 * \param none
Kojto 33:9e23b24fb4f3 171 * \return Pointer to the receive buffer.
Kojto 20:30b6ed7bf8fd 172 */
Kojto 20:30b6ed7bf8fd 173 uint8_t *get_received_buffer();
Kojto 20:30b6ed7bf8fd 174 /**
Kojto 33:9e23b24fb4f3 175 * \brief Get transmit buffer.
Kojto 33:9e23b24fb4f3 176 * \param none
Kojto 33:9e23b24fb4f3 177 * \return Pointer to the transmit buffer.
Kojto 20:30b6ed7bf8fd 178 */
Kojto 20:30b6ed7bf8fd 179 uint8_t *get_transmit_buffer();
Kojto 20:30b6ed7bf8fd 180 /**
Kojto 33:9e23b24fb4f3 181 * \brief Get number of free buffers.
Kojto 33:9e23b24fb4f3 182 * \param none
Kojto 29:c40918cd9b6d 183 * \return
Kojto 33:9e23b24fb4f3 184 * Number of free buffers.
Kojto 20:30b6ed7bf8fd 185 */
Kojto 20:30b6ed7bf8fd 186 uint16_t get_number_free_buffers();
Kojto 20:30b6ed7bf8fd 187 /**
Kojto 33:9e23b24fb4f3 188 * \brief Set number of free buffers.
Kojto 33:9e23b24fb4f3 189 * \param value Number of free buffers.
Kojto 33:9e23b24fb4f3 190 * \return none
Kojto 20:30b6ed7bf8fd 191 */
Kojto 20:30b6ed7bf8fd 192 void set_number_free_buffers(uint16_t value);
Kojto 20:30b6ed7bf8fd 193 /**
Kojto 33:9e23b24fb4f3 194 * \brief Retrieve buffer length.
Kojto 33:9e23b24fb4f3 195 * \param none
Kojto 33:9e23b24fb4f3 196 * \return Buffer length
Kojto 20:30b6ed7bf8fd 197 */
Kojto 20:30b6ed7bf8fd 198 uint16_t get_buffer_length();
Kojto 20:30b6ed7bf8fd 199 /**
Kojto 33:9e23b24fb4f3 200 * \brief Set buffer length
Kojto 33:9e23b24fb4f3 201 * \param value The length
Kojto 33:9e23b24fb4f3 202 * \return none
Kojto 20:30b6ed7bf8fd 203 */
Kojto 20:30b6ed7bf8fd 204 void set_buffer_length(uint16_t value);
Kojto 20:30b6ed7bf8fd 205 /**
Kojto 33:9e23b24fb4f3 206 * \brief Retrieve pending data flag.
Kojto 33:9e23b24fb4f3 207 * \param none
Kojto 33:9e23b24fb4f3 208 * \return Pending data flag
Kojto 20:30b6ed7bf8fd 209 */
Kojto 20:30b6ed7bf8fd 210 uint16_t get_pending_data();
Kojto 20:30b6ed7bf8fd 211 /**
Kojto 33:9e23b24fb4f3 212 * \brief Set pending data flag.
Kojto 33:9e23b24fb4f3 213 * \param value Pending data value.
Kojto 33:9e23b24fb4f3 214 * \return none
Kojto 20:30b6ed7bf8fd 215 */
Kojto 20:30b6ed7bf8fd 216 void set_pending_data(uint16_t value);
Kojto 20:30b6ed7bf8fd 217 /**
Kojto 33:9e23b24fb4f3 218 * \brief Retreive op code.
Kojto 33:9e23b24fb4f3 219 * \param none
Kojto 33:9e23b24fb4f3 220 * \return Op code
Kojto 20:30b6ed7bf8fd 221 */
Kojto 20:30b6ed7bf8fd 222 uint16_t get_op_code();
Kojto 20:30b6ed7bf8fd 223 /**
Kojto 33:9e23b24fb4f3 224 * \brief Set op code.
Kojto 33:9e23b24fb4f3 225 * \param code op code.
Kojto 33:9e23b24fb4f3 226 * \return none
Kojto 20:30b6ed7bf8fd 227 */
Kojto 20:30b6ed7bf8fd 228 void set_op_code(uint16_t code);
Kojto 20:30b6ed7bf8fd 229 /**
Kojto 33:9e23b24fb4f3 230 * \brief Get number of released packets.
Kojto 33:9e23b24fb4f3 231 * \param none
Kojto 33:9e23b24fb4f3 232 * \return Number of released packets.
Kojto 20:30b6ed7bf8fd 233 */
Kojto 20:30b6ed7bf8fd 234 uint16_t get_released_packets();
Kojto 20:30b6ed7bf8fd 235 /**
Kojto 33:9e23b24fb4f3 236 * \brief Set number of released packets.
Kojto 33:9e23b24fb4f3 237 * \param value Number of released packets.
Kojto 33:9e23b24fb4f3 238 * \return none
Kojto 20:30b6ed7bf8fd 239 */
Kojto 20:30b6ed7bf8fd 240 void set_number_of_released_packets(uint16_t value);
Kojto 20:30b6ed7bf8fd 241 /**
Kojto 33:9e23b24fb4f3 242 * \brief Get number of sent packats
Kojto 33:9e23b24fb4f3 243 * \param none
Kojto 33:9e23b24fb4f3 244 * \return Number of sent packets.
Kojto 20:30b6ed7bf8fd 245 */
Kojto 20:30b6ed7bf8fd 246 uint16_t get_sent_packets();
Kojto 20:30b6ed7bf8fd 247 /**
Kojto 33:9e23b24fb4f3 248 * \brief Set number of sent packets
Kojto 33:9e23b24fb4f3 249 * \param value Number of sent packets.
Kojto 33:9e23b24fb4f3 250 * \return none
Kojto 20:30b6ed7bf8fd 251 */
Kojto 20:30b6ed7bf8fd 252 void set_sent_packets(uint16_t value);
Kojto 29:c40918cd9b6d 253 /**
Kojto 33:9e23b24fb4f3 254 * \brief Retrieve transmit error
Kojto 33:9e23b24fb4f3 255 * \param none
Kojto 33:9e23b24fb4f3 256 * \return Transmit error
Kojto 29:c40918cd9b6d 257 */
Kojto 20:30b6ed7bf8fd 258 int32_t get_transmit_error();
Kojto 29:c40918cd9b6d 259 /**
Kojto 33:9e23b24fb4f3 260 * \brief Set transmit error.
Kojto 33:9e23b24fb4f3 261 * \param value Error to be set.
Kojto 33:9e23b24fb4f3 262 * \return none
Kojto 29:c40918cd9b6d 263 */
Kojto 20:30b6ed7bf8fd 264 void set_transmit_error(int32_t value);
Kojto 29:c40918cd9b6d 265 /**
Kojto 33:9e23b24fb4f3 266 * \brief Get buffer size.
Kojto 33:9e23b24fb4f3 267 * \param none
Kojto 33:9e23b24fb4f3 268 * \return Size of buffer.
Kojto 29:c40918cd9b6d 269 */
Kojto 33:9e23b24fb4f3 270 uint16_t get_buffer_size();
Kojto 29:c40918cd9b6d 271 /**
Kojto 33:9e23b24fb4f3 272 * \brief Set buffer size.
Kojto 33:9e23b24fb4f3 273 * \param value Buffer size.
Kojto 33:9e23b24fb4f3 274 * \return none
Kojto 29:c40918cd9b6d 275 */
Kojto 20:30b6ed7bf8fd 276 void set_buffer_size(uint16_t value);
Kojto 29:c40918cd9b6d 277 /**
Kojto 33:9e23b24fb4f3 278 * \brief Not used currently.
Kojto 33:9e23b24fb4f3 279 * \param function Number of desired function.
Kojto 33:9e23b24fb4f3 280 * \return void pointer to the function (need to recast).
Kojto 29:c40918cd9b6d 281 */
Kojto 20:30b6ed7bf8fd 282 void *get_func_pointer(FunctionNumber function);
Kojto 29:c40918cd9b6d 283 /**
Kojto 33:9e23b24fb4f3 284 * \brief Retreive pointer to the received data.
Kojto 33:9e23b24fb4f3 285 * \param none
Kojto 33:9e23b24fb4f3 286 * \return Pointer to the received data buffer.
Kojto 29:c40918cd9b6d 287 */
Kojto 33:9e23b24fb4f3 288 uint8_t *get_received_data();
Kojto 29:c40918cd9b6d 289 /**
Kojto 33:9e23b24fb4f3 290 * \brief Set received data pointer.
Kojto 33:9e23b24fb4f3 291 * \param pointer Pointer to the buffer.
Kojto 33:9e23b24fb4f3 292 * \return none
Kojto 29:c40918cd9b6d 293 */
Kojto 20:30b6ed7bf8fd 294 void set_received_data(uint8_t *pointer);
Kojto 20:30b6ed7bf8fd 295 private:
Kojto 20:30b6ed7bf8fd 296 uint8_t _data_received_flag;
Kojto 20:30b6ed7bf8fd 297 bool _tx_complete_signal;
Kojto 20:30b6ed7bf8fd 298 uint16_t _rx_event_opcode;
Kojto 20:30b6ed7bf8fd 299 uint16_t _free_buffers;
Kojto 20:30b6ed7bf8fd 300 uint16_t _buffer_length;
Kojto 20:30b6ed7bf8fd 301 uint16_t _buffer_size;
Kojto 20:30b6ed7bf8fd 302 uint16_t _rx_data_pending;
Kojto 20:30b6ed7bf8fd 303 uint16_t _sent_packets;
Kojto 20:30b6ed7bf8fd 304 uint16_t _released_packets;
Kojto 20:30b6ed7bf8fd 305 int32_t _transmit_data_error;
Kojto 20:30b6ed7bf8fd 306 uint8_t *_received_data;
Kojto 20:30b6ed7bf8fd 307 uint8_t _rx_buffer[CC3000_RX_BUFFER_SIZE];
Kojto 20:30b6ed7bf8fd 308 uint8_t _tx_buffer[CC3000_TX_BUFFER_SIZE];
Kojto 20:30b6ed7bf8fd 309 private:
Kojto 33:9e23b24fb4f3 310 /* Not used currently */
Kojto 20:30b6ed7bf8fd 311 int8_t *(* _fFWPatches)(uint32_t *length);
Kojto 20:30b6ed7bf8fd 312 int8_t *(* _fDriverPatches)(uint32_t *length);
Kojto 20:30b6ed7bf8fd 313 int8_t *(* _fBootLoaderPatches)(uint32_t *length);
Kojto 20:30b6ed7bf8fd 314 };
Kojto 20:30b6ed7bf8fd 315
Kojto 20:30b6ed7bf8fd 316 /** Forward declaration classes
Kojto 20:30b6ed7bf8fd 317 */
Kojto 20:30b6ed7bf8fd 318 class cc3000_hci;
Kojto 20:30b6ed7bf8fd 319 class cc3000_nvmem;
Kojto 20:30b6ed7bf8fd 320 class cc3000_spi;
Kojto 20:30b6ed7bf8fd 321 class cc3000;
Kojto 20:30b6ed7bf8fd 322
Kojto 31:7b6e85b68b01 323 /** Event layer
Kojto 20:30b6ed7bf8fd 324 */
Kojto 20:30b6ed7bf8fd 325 class cc3000_event {
Kojto 20:30b6ed7bf8fd 326 public:
Kojto 29:c40918cd9b6d 327 /**
Kojto 29:c40918cd9b6d 328 * \brief
Kojto 34:1ad18123bf11 329 * \param simplelink Reference to simple link object.
Kojto 34:1ad18123bf11 330 * \param hci Reference to hci object.
Kojto 34:1ad18123bf11 331 * \param spi Reference to spi object.
Kojto 34:1ad18123bf11 332 * \param cc3000 Reference to cc3000 object.
Kojto 34:1ad18123bf11 333 * \return none
Kojto 29:c40918cd9b6d 334 */
Kojto 20:30b6ed7bf8fd 335 cc3000_event(cc3000_simple_link &simplelink, cc3000_hci &hci, cc3000_spi &spi, cc3000 &cc3000);
Kojto 29:c40918cd9b6d 336 /**
Kojto 34:1ad18123bf11 337 * \brief Ctor
Kojto 34:1ad18123bf11 338 * \param none
Kojto 34:1ad18123bf11 339 * \return none
Kojto 29:c40918cd9b6d 340 */
Kojto 29:c40918cd9b6d 341 ~cc3000_event();
Kojto 34:1ad18123bf11 342 /**
Kojto 34:1ad18123bf11 343 * \brief Handle unsolicited event from type patch request.
Kojto 34:1ad18123bf11 344 * \param event_hdr event header
Kojto 34:1ad18123bf11 345 * \return none
Kojto 29:c40918cd9b6d 346 */
Kojto 20:30b6ed7bf8fd 347 void hci_unsol_handle_patch_request(uint8_t *event_hdr);
Kojto 29:c40918cd9b6d 348 /**
Kojto 34:1ad18123bf11 349 * \brief Parse the incoming event packets and issue corresponding event handler from global array of handlers pointers.
Kojto 34:1ad18123bf11 350 * \param ret_param incoming data buffer
Kojto 34:1ad18123bf11 351 * \param from from information (in case of data received)
Kojto 34:1ad18123bf11 352 * \param fromlen from information length (in case of data received)
Kojto 34:1ad18123bf11 353 * \return none
Kojto 34:1ad18123bf11 354 */
Kojto 20:30b6ed7bf8fd 355 uint8_t *hci_event_handler(void *ret_param, uint8_t *from, uint8_t *fromlen);
Kojto 29:c40918cd9b6d 356 /**
Kojto 34:1ad18123bf11 357 * \brief Handle unsolicited events.
Kojto 34:1ad18123bf11 358 * \param event_hdr Event header
Kojto 34:1ad18123bf11 359 * \return 1 if event supported and handled
Kojto 34:1ad18123bf11 360 * \return 0 if event is not supported
Kojto 34:1ad18123bf11 361 */
Kojto 20:30b6ed7bf8fd 362 int32_t hci_unsol_event_handler(uint8_t *event_hdr);
Kojto 29:c40918cd9b6d 363 /**
Kojto 34:1ad18123bf11 364 * \brief Parse the incoming unsolicited event packets and start corresponding event handler.
Kojto 34:1ad18123bf11 365 * \param None
Kojto 34:1ad18123bf11 366 * \return ESUCCESS if successful, EFAIL if an error occurred.
Kojto 34:1ad18123bf11 367 */
Kojto 20:30b6ed7bf8fd 368 int32_t hci_unsolicited_event_handler(void);
Kojto 29:c40918cd9b6d 369 /**
Kojto 34:1ad18123bf11 370 * \brief Get the socket status.
Kojto 34:1ad18123bf11 371 * \param Sd Socket IS
Kojto 34:1ad18123bf11 372 * \return Current status of the socket.
Kojto 34:1ad18123bf11 373 */
Kojto 20:30b6ed7bf8fd 374 int32_t get_socket_active_status(int32_t sd);
Kojto 29:c40918cd9b6d 375 /**
Kojto 34:1ad18123bf11 376 * \brief Check if the socket ID and status are valid and set the global socket status accordingly.
Kojto 34:1ad18123bf11 377 * \param Sd Sock descr
Kojto 34:1ad18123bf11 378 * \param Status status to be set
Kojto 34:1ad18123bf11 379 * \return none
Kojto 34:1ad18123bf11 380 */
Kojto 20:30b6ed7bf8fd 381 void set_socket_active_status(int32_t sd, int32_t status);
Kojto 29:c40918cd9b6d 382 /**
Kojto 34:1ad18123bf11 383 * \brief Keep track on the number of packets transmitted and update the number of free buffer in the SL device.
Kojto 34:1ad18123bf11 384 * \brief Called when unsolicited event = HCI_EVNT_DATA_UNSOL_FREE_BUFF has received.
Kojto 34:1ad18123bf11 385 * \param event pointer to the string contains parameters for IPERF.
Kojto 34:1ad18123bf11 386 * \return ESUCCESS if successful, EFAIL if an error occurred.
Kojto 34:1ad18123bf11 387 */
Kojto 20:30b6ed7bf8fd 388 int32_t hci_event_unsol_flowcontrol_handler(uint8_t *event);
Kojto 29:c40918cd9b6d 389 /**
Kojto 34:1ad18123bf11 390 * \brief Update the socket status.
Kojto 34:1ad18123bf11 391 * \param resp_params Socket IS
Kojto 34:1ad18123bf11 392 * \return Current status of the socket.
Kojto 34:1ad18123bf11 393 */
Kojto 20:30b6ed7bf8fd 394 void update_socket_active_status(uint8_t *resp_params);
Kojto 29:c40918cd9b6d 395 /**
Kojto 34:1ad18123bf11 396 * \brief Wait for event, pass it to the hci_event_handler and update the event opcode in a global variable.
Kojto 34:1ad18123bf11 397 * \param op_code Command operation code
Kojto 34:1ad18123bf11 398 * \param ret_param Command return parameters
Kojto 34:1ad18123bf11 399 * \return none
Kojto 29:c40918cd9b6d 400 */
Kojto 20:30b6ed7bf8fd 401 void simplelink_wait_event(uint16_t op_code, void *ret_param);
Kojto 29:c40918cd9b6d 402 /**
Kojto 34:1ad18123bf11 403 * \brief Wait for data, pass it to the hci_event_handler and set the data available flag.
Kojto 34:1ad18123bf11 404 * \param buffer Data buffer
Kojto 34:1ad18123bf11 405 * \param from From information
Kojto 34:1ad18123bf11 406 * \param fromlen From information length
Kojto 34:1ad18123bf11 407 * \return none
Kojto 29:c40918cd9b6d 408 */
Kojto 20:30b6ed7bf8fd 409 void simplelink_wait_data(uint8_t *buffer, uint8_t *from, uint8_t *fromlen);
Kojto 29:c40918cd9b6d 410 /**
Kojto 34:1ad18123bf11 411 * \brief Trigger Received event/data processing - called from the SPI library to receive the data
Kojto 34:1ad18123bf11 412 * \param buffer pointer to the received data buffer\n
Kojto 34:1ad18123bf11 413 * The function triggers Received event/data processing\n
Kojto 34:1ad18123bf11 414 * \return none
Kojto 29:c40918cd9b6d 415 */
Kojto 20:30b6ed7bf8fd 416 void received_handler(uint8_t *buffer);
Kojto 34:1ad18123bf11 417 private:
Kojto 20:30b6ed7bf8fd 418 uint32_t socket_active_status;
Kojto 20:30b6ed7bf8fd 419 cc3000_simple_link &_simple_link;
Kojto 20:30b6ed7bf8fd 420 cc3000_hci &_hci;
Kojto 20:30b6ed7bf8fd 421 cc3000_spi &_spi;
Kojto 20:30b6ed7bf8fd 422 cc3000 &_cc3000;
Kojto 20:30b6ed7bf8fd 423 };
Kojto 20:30b6ed7bf8fd 424
Kojto 31:7b6e85b68b01 425 /** Netapp layer
Kojto 31:7b6e85b68b01 426 */
Kojto 20:30b6ed7bf8fd 427 class cc3000_netapp {
Kojto 20:30b6ed7bf8fd 428 public:
Kojto 29:c40918cd9b6d 429 /**
Kojto 34:1ad18123bf11 430 * \brief Ctor
Kojto 34:1ad18123bf11 431 * \param simple_link Reference to the simple link object.
Kojto 34:1ad18123bf11 432 * \param nvmem Reference to the nvmem object.
Kojto 34:1ad18123bf11 433 * \param hci Reference to the hci object.
Kojto 34:1ad18123bf11 434 * \param event Reference to the event object.
Kojto 34:1ad18123bf11 435 * \return none
Kojto 29:c40918cd9b6d 436 */
Kojto 20:30b6ed7bf8fd 437 cc3000_netapp(cc3000_simple_link &simple_link, cc3000_nvmem &nvmem, cc3000_hci &hci, cc3000_event &event);
Kojto 29:c40918cd9b6d 438 /**
Kojto 34:1ad18123bf11 439 * \brief Dtor
Kojto 34:1ad18123bf11 440 * \param none
Kojto 34:1ad18123bf11 441 * \return none
Kojto 29:c40918cd9b6d 442 */
Kojto 20:30b6ed7bf8fd 443 ~cc3000_netapp();
Kojto 29:c40918cd9b6d 444 /**
Kojto 34:1ad18123bf11 445 * \brief Configure device MAC address and store it in NVMEM.
Kojto 34:1ad18123bf11 446 * The value of the MAC address configured through the API will be\n
Kojto 34:1ad18123bf11 447 * stored in CC3000 non volatile memory, thus preserved over resets.\n
Kojto 34:1ad18123bf11 448 * \param mac device mac address, 6 bytes. Saved: yes
Kojto 34:1ad18123bf11 449 * \return return on success 0, otherwise error.
Kojto 29:c40918cd9b6d 450 */
Kojto 20:30b6ed7bf8fd 451 int32_t config_mac_adrress(uint8_t *mac);
Kojto 29:c40918cd9b6d 452 /**
Kojto 34:1ad18123bf11 453 * \brief Configure the network interface, static or dynamic (DHCP).
Kojto 34:1ad18123bf11 454 * In order to activate DHCP mode, ip, subnet_mask, default_gateway must be 0.\n
Kojto 34:1ad18123bf11 455 * The default mode of CC3000 is DHCP mode. The configuration is saved in non volatile memory\n
Kojto 34:1ad18123bf11 456 * and thus preserved over resets.\n
Kojto 34:1ad18123bf11 457 * \param ip device mac address, 6 bytes. Saved: yes
Kojto 34:1ad18123bf11 458 * \param subnet_mask device mac address, 6 bytes. Saved: yes
Kojto 34:1ad18123bf11 459 * \param default_gateway device mac address, 6 bytes. Saved: yes
Kojto 34:1ad18123bf11 460 * \param dns_server device mac address, 6 bytes. Saved: yes
Kojto 34:1ad18123bf11 461 * \return 0 on success, otherwise error.
Kojto 34:1ad18123bf11 462 * \note If the mode is altered, a reset of CC3000 device is required to apply the changes.\n
Kojto 34:1ad18123bf11 463 * Also note that an asynchronous event of type 'DHCP_EVENT' is generated only when\n
Kojto 34:1ad18123bf11 464 * a connection to the AP was established. This event is generated when an IP address\n
Kojto 34:1ad18123bf11 465 * is allocated either by the DHCP server or by static allocation.\n
Kojto 29:c40918cd9b6d 466 */
Kojto 20:30b6ed7bf8fd 467 int32_t dhcp(uint32_t *ip, uint32_t *subnet_mask,uint32_t *default_gateway, uint32_t *dns_server);
Kojto 20:30b6ed7bf8fd 468 #ifndef CC3000_TINY_DRIVER
Kojto 29:c40918cd9b6d 469 /**
Kojto 34:1ad18123bf11 470 * \brief Get the CC3000 Network interface information.
Kojto 34:1ad18123bf11 471 * This information is only available after establishing a WLAN connection.\n
Kojto 34:1ad18123bf11 472 * Undefined values are returned when this function is called before association.\n
Kojto 34:1ad18123bf11 473 * \param ipconfig pointer to a tNetappIpconfigRetArgs structure for storing the network interface configuration.\n
Kojto 34:1ad18123bf11 474 * tNetappIpconfigRetArgs: aucIP - ip address,\n
Kojto 34:1ad18123bf11 475 * aucSubnetMask - mask
Kojto 34:1ad18123bf11 476 * aucDefaultGateway - default gateway address\n
Kojto 34:1ad18123bf11 477 * aucDHCPServer - dhcp server address\n
Kojto 34:1ad18123bf11 478 * aucDNSServer - dns server address\n
Kojto 34:1ad18123bf11 479 * uaMacAddr - mac address\n
Kojto 34:1ad18123bf11 480 * uaSSID - connected AP ssid\n
Kojto 34:1ad18123bf11 481 * \return none
Kojto 34:1ad18123bf11 482 * \note This function is useful for figuring out the IP Configuration of\n
Kojto 34:1ad18123bf11 483 * the device when DHCP is used and for figuring out the SSID of\n
Kojto 34:1ad18123bf11 484 * the Wireless network the device is associated with.\n
Kojto 29:c40918cd9b6d 485 */
Kojto 20:30b6ed7bf8fd 486 void ipconfig(tNetappIpconfigRetArgs *ipconfig);
Kojto 29:c40918cd9b6d 487 /**
Kojto 34:1ad18123bf11 488 * \brief Set new timeout values for DHCP lease timeout, ARP refresh timeout, keepalive event timeout and socket inactivity timeout
Kojto 34:1ad18123bf11 489 * \param dhcp DHCP lease time request, also impact\n
Kojto 34:1ad18123bf11 490 * the DHCP renew timeout.\n
Kojto 34:1ad18123bf11 491 * Range: [0-0xffffffff] seconds,\n
Kojto 34:1ad18123bf11 492 * 0 or 0xffffffff = infinite lease timeout.\n
Kojto 34:1ad18123bf11 493 * Resolution: 10 seconds.\n
Kojto 34:1ad18123bf11 494 * Influence: only after reconnecting to the AP. \n
Kojto 34:1ad18123bf11 495 * Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 seconds.\n
Kojto 34:1ad18123bf11 496 * The parameter is saved into the CC3000 NVMEM.\n
Kojto 34:1ad18123bf11 497 * The default value on CC3000 is 14400 seconds.\n
Kojto 34:1ad18123bf11 498 *
Kojto 34:1ad18123bf11 499 * \param arp ARP refresh timeout, if ARP entry is not updated by\n
Kojto 34:1ad18123bf11 500 * incoming packet, the ARP entry will be deleted by\n
Kojto 34:1ad18123bf11 501 * the end of the timeout. \n
Kojto 34:1ad18123bf11 502 * Range: [0-0xffffffff] seconds, 0 = infinite ARP timeout\n
Kojto 34:1ad18123bf11 503 * Resolution: 10 seconds.\n
Kojto 34:1ad18123bf11 504 * Influence: at runtime.\n
Kojto 34:1ad18123bf11 505 * Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 seconds\n
Kojto 34:1ad18123bf11 506 * The parameter is saved into the CC3000 NVMEM.\n
Kojto 34:1ad18123bf11 507 * The default value on CC3000 is 3600 seconds.\n
Kojto 34:1ad18123bf11 508 *
Kojto 34:1ad18123bf11 509 * \param keep_alive Keepalive event sent by the end of keepalive timeout\n
Kojto 34:1ad18123bf11 510 * Range: [0-0xffffffff] seconds, 0 == infinite timeout\n
Kojto 34:1ad18123bf11 511 * Resolution: 10 seconds.\n
Kojto 34:1ad18123bf11 512 * Influence: at runtime.\n
Kojto 34:1ad18123bf11 513 * Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 sec\n
Kojto 34:1ad18123bf11 514 * The parameter is saved into the CC3000 NVMEM. \n
Kojto 34:1ad18123bf11 515 * The default value on CC3000 is 10 seconds.\n
Kojto 34:1ad18123bf11 516 *
Kojto 34:1ad18123bf11 517 * \param inactivity Socket inactivity timeout, socket timeout is\n
Kojto 34:1ad18123bf11 518 * refreshed by incoming or outgoing packet, by the\n
Kojto 34:1ad18123bf11 519 * end of the socket timeout the socket will be closed\n
Kojto 34:1ad18123bf11 520 * Range: [0-0xffffffff] sec, 0 == infinite timeout.\n
Kojto 34:1ad18123bf11 521 * Resolution: 10 seconds.\n
Kojto 34:1ad18123bf11 522 * Influence: at runtime.\n
Kojto 34:1ad18123bf11 523 * Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 sec\n
Kojto 34:1ad18123bf11 524 * The parameter is saved into the CC3000 NVMEM.\n
Kojto 34:1ad18123bf11 525 * The default value on CC3000 is 60 seconds.\n
Kojto 34:1ad18123bf11 526 *
Kojto 34:1ad18123bf11 527 * \return 0 on success,otherwise error.
Kojto 34:1ad18123bf11 528 *
Kojto 34:1ad18123bf11 529 * \note A parameter set to a non zero value less than 20s automatically changes to 20s.
Kojto 29:c40918cd9b6d 530 */
Kojto 20:30b6ed7bf8fd 531 int32_t timeout_values(uint32_t *dhcp, uint32_t *arp,uint32_t *keep_alive, uint32_t *inactivity);
Kojto 29:c40918cd9b6d 532 /**
Kojto 34:1ad18123bf11 533 * \brief send ICMP ECHO_REQUEST to network hosts
Kojto 34:1ad18123bf11 534 * \param ip destination IP address
Kojto 34:1ad18123bf11 535 * \param ping_attempts number of echo requests to send
Kojto 34:1ad18123bf11 536 * \param ping_size send buffer size which may be up to 1400 bytes
Kojto 34:1ad18123bf11 537 * \param ping_timeout Time to wait for a response,in milliseconds.
Kojto 34:1ad18123bf11 538 * \return 0 on success, otherwise error.
Kojto 34:1ad18123bf11 539 *
Kojto 34:1ad18123bf11 540 * \note A succesful operation will generate an asynchronous ping report event.\n
Kojto 34:1ad18123bf11 541 * The report structure is defined by structure netapp_pingreport_args_t.\n
Kojto 34:1ad18123bf11 542 * \warning Calling this function while a Ping Request is in progress will kill the ping request in progress.
Kojto 29:c40918cd9b6d 543 */
Kojto 20:30b6ed7bf8fd 544 int32_t ping_send(uint32_t *ip, uint32_t ping_attempts, uint32_t ping_size, uint32_t ping_timeout);
Kojto 29:c40918cd9b6d 545 /**
Kojto 34:1ad18123bf11 546 * \brief Ping status request.
Kojto 34:1ad18123bf11 547 * This API triggers the CC3000 to send asynchronous events: HCI_EVNT_WLAN_ASYNC_PING_REPORT.\n
Kojto 34:1ad18123bf11 548 * This event will create the report structure in netapp_pingreport_args_t.\n
Kojto 34:1ad18123bf11 549 * This structure is filled with ping results until the API is triggered.\n
Kojto 34:1ad18123bf11 550 * netapp_pingreport_args_t: packets_sent - echo sent\n
Kojto 34:1ad18123bf11 551 * packets_received - echo reply\n
Kojto 34:1ad18123bf11 552 * min_round_time - minimum round time\n
Kojto 34:1ad18123bf11 553 * max_round_time - max round time\n
Kojto 34:1ad18123bf11 554 * avg_round_time - average round time\n
Kojto 34:1ad18123bf11 555 *
Kojto 34:1ad18123bf11 556 * \param none
Kojto 34:1ad18123bf11 557 * \return none
Kojto 34:1ad18123bf11 558 * \note When a ping operation is not active, the returned structure fields are 0.
Kojto 29:c40918cd9b6d 559 */
Kojto 20:30b6ed7bf8fd 560 void ping_report();
Kojto 29:c40918cd9b6d 561 /**
Kojto 34:1ad18123bf11 562 * \brief Stop any ping request.
Kojto 34:1ad18123bf11 563 * \param none
Kojto 34:1ad18123bf11 564 * \return 0 on success
Kojto 34:1ad18123bf11 565 * -1 on error
Kojto 29:c40918cd9b6d 566 */
Kojto 20:30b6ed7bf8fd 567 int32_t ping_stop();
Kojto 29:c40918cd9b6d 568 /**
Kojto 34:1ad18123bf11 569 * \brief Flush ARP table
Kojto 34:1ad18123bf11 570 * \param none
Kojto 34:1ad18123bf11 571 * \return none
Kojto 29:c40918cd9b6d 572 */
Kojto 20:30b6ed7bf8fd 573 int32_t arp_flush();
Kojto 20:30b6ed7bf8fd 574 #endif
Kojto 20:30b6ed7bf8fd 575 private:
Kojto 20:30b6ed7bf8fd 576 cc3000_simple_link &_simple_link;
Kojto 20:30b6ed7bf8fd 577 cc3000_nvmem &_nvmem;
Kojto 20:30b6ed7bf8fd 578 cc3000_hci &_hci;
Kojto 20:30b6ed7bf8fd 579 cc3000_event &_event;
Kojto 20:30b6ed7bf8fd 580 };
Kojto 20:30b6ed7bf8fd 581
Kojto 20:30b6ed7bf8fd 582 #ifndef CC3000_UNENCRYPTED_SMART_CONFIG
Kojto 31:7b6e85b68b01 583 /** Security class used only if encrypted smart config is set
Kojto 31:7b6e85b68b01 584 */
Kojto 20:30b6ed7bf8fd 585 class cc3000_security {
Kojto 20:30b6ed7bf8fd 586 public:
Kojto 29:c40918cd9b6d 587 /**
Kojto 34:1ad18123bf11 588 * \brief Expand a 16 bytes key for AES128 implementation.
Kojto 34:1ad18123bf11 589 * \param expanded_key expanded AES128 key
Kojto 34:1ad18123bf11 590 * \param key AES128 key - 16 bytes
Kojto 34:1ad18123bf11 591 * \return none
Kojto 29:c40918cd9b6d 592 */
Kojto 20:30b6ed7bf8fd 593 void expandKey(uint8_t *expanded_key, uint8_t *key);
Kojto 29:c40918cd9b6d 594 /**
Kojto 34:1ad18123bf11 595 * \brief multiply by 2 in the galois field.
Kojto 34:1ad18123bf11 596 * \param value Argument to multiply
Kojto 34:1ad18123bf11 597 * \return multiplied argument
Kojto 29:c40918cd9b6d 598 */
Kojto 20:30b6ed7bf8fd 599 uint8_t galois_mul2(uint8_t value);
Kojto 29:c40918cd9b6d 600 /**
Kojto 34:1ad18123bf11 601 * \brief internal implementation of AES128 encryption.
Kojto 34:1ad18123bf11 602 * straight forward aes encryption implementation\n
Kojto 34:1ad18123bf11 603 * first the group of operations
Kojto 34:1ad18123bf11 604 * - addRoundKey
Kojto 34:1ad18123bf11 605 * - subbytes
Kojto 34:1ad18123bf11 606 * - shiftrows
Kojto 34:1ad18123bf11 607 * - mixcolums\n
Kojto 34:1ad18123bf11 608 *
Kojto 34:1ad18123bf11 609 * is executed 9 times, after this addroundkey to finish the 9th\n
Kojto 34:1ad18123bf11 610 * round, after that the 10th round without mixcolums\n
Kojto 34:1ad18123bf11 611 * no further subfunctions to save cycles for function calls\n
Kojto 34:1ad18123bf11 612 * no structuring with "for (....)" to save cycles.\n
Kojto 34:1ad18123bf11 613 * \param[in] expanded_key expanded AES128 key
Kojto 34:1ad18123bf11 614 * \param[in/out] state 16 bytes of plain text and cipher text
Kojto 34:1ad18123bf11 615 * \return none
Kojto 29:c40918cd9b6d 616 */
Kojto 20:30b6ed7bf8fd 617 void aes_encr(uint8_t *state, uint8_t *expanded_key);
Kojto 29:c40918cd9b6d 618 /**
Kojto 34:1ad18123bf11 619 * \brief internal implementation of AES128 decryption.
Kojto 34:1ad18123bf11 620 * straightforward aes decryption implementation\n
Kojto 34:1ad18123bf11 621 * the order of substeps is the exact reverse of decryption\n
Kojto 34:1ad18123bf11 622 * inverse functions:
Kojto 34:1ad18123bf11 623 * - addRoundKey is its own inverse
Kojto 34:1ad18123bf11 624 * - rsbox is inverse of sbox
Kojto 34:1ad18123bf11 625 * - rightshift instead of leftshift
Kojto 34:1ad18123bf11 626 * - invMixColumns = barreto + mixColumns\n
Kojto 34:1ad18123bf11 627 *
Kojto 34:1ad18123bf11 628 * no further subfunctions to save cycles for function calls\n
Kojto 34:1ad18123bf11 629 * no structuring with "for (....)" to save cycles\n
Kojto 34:1ad18123bf11 630 * \param[in] expanded_key expanded AES128 key
Kojto 34:1ad18123bf11 631 * \param[in\out] state 16 bytes of cipher text and plain text
Kojto 34:1ad18123bf11 632 * \return none
Kojto 29:c40918cd9b6d 633 */
Kojto 20:30b6ed7bf8fd 634 void aes_decr(uint8_t *state, uint8_t *expanded_key);
Kojto 29:c40918cd9b6d 635 /**
Kojto 34:1ad18123bf11 636 * \brief AES128 encryption.
Kojto 34:1ad18123bf11 637 * Given AES128 key and 16 bytes plain text, cipher text of 16 bytes is computed.\n
Kojto 34:1ad18123bf11 638 * The AES implementation is in mode ECB (Electronic Code Book).\n
Kojto 34:1ad18123bf11 639 * \param[in] key AES128 key of size 16 bytes
Kojto 34:1ad18123bf11 640 * \param[in\out] state 16 bytes of plain text and cipher text
Kojto 34:1ad18123bf11 641 * \return none
Kojto 29:c40918cd9b6d 642 */
Kojto 20:30b6ed7bf8fd 643 void aes_encrypt(uint8_t *state, uint8_t *key);
Kojto 29:c40918cd9b6d 644 /**
Kojto 34:1ad18123bf11 645 * \brief AES128 decryption.
Kojto 34:1ad18123bf11 646 * Given AES128 key and 16 bytes cipher text, plain text of 16 bytes is computed.\n
Kojto 34:1ad18123bf11 647 * The AES implementation is in mode ECB (Electronic Code Book).\n
Kojto 34:1ad18123bf11 648 * \param[in] key AES128 key of size 16 bytes
Kojto 34:1ad18123bf11 649 * \param[in\out] state 16 bytes of cipher text and plain text
Kojto 34:1ad18123bf11 650 * \return none
Kojto 29:c40918cd9b6d 651 */
Kojto 20:30b6ed7bf8fd 652 void aes_decrypt(uint8_t *state, uint8_t *key);
Kojto 29:c40918cd9b6d 653 /**
Kojto 34:1ad18123bf11 654 * \brief Read the AES128 key from fileID #12 in EEPROM.
Kojto 34:1ad18123bf11 655 * \param[out] key AES128 key of size 16 bytes
Kojto 34:1ad18123bf11 656 * \return 0 on success, error otherwise.
Kojto 29:c40918cd9b6d 657 */
Kojto 20:30b6ed7bf8fd 658 int32_t aes_read_key(uint8_t *key);
Kojto 29:c40918cd9b6d 659 /**
Kojto 34:1ad18123bf11 660 * \brief Write the AES128 key to fileID #12 in EEPROM.
Kojto 34:1ad18123bf11 661 * \param[out] key AES128 key of size 16 bytes
Kojto 34:1ad18123bf11 662 * \return on success 0, error otherwise.
Kojto 29:c40918cd9b6d 663 */
Kojto 20:30b6ed7bf8fd 664 int32_t aes_write_key(uint8_t *key);
Kojto 20:30b6ed7bf8fd 665 private:
Kojto 20:30b6ed7bf8fd 666 uint8_t _expanded_key[176];
Kojto 20:30b6ed7bf8fd 667 };
Kojto 20:30b6ed7bf8fd 668 #endif
Kojto 20:30b6ed7bf8fd 669
Kojto 31:7b6e85b68b01 670 /** Socket layer
Kojto 31:7b6e85b68b01 671 */
Kojto 20:30b6ed7bf8fd 672 class cc3000_socket {
Kojto 20:30b6ed7bf8fd 673 public:
Kojto 29:c40918cd9b6d 674 /**
Kojto 34:1ad18123bf11 675 * \brief Ctor
Kojto 34:1ad18123bf11 676 * \param simplelink Reference to simple link object.
Kojto 34:1ad18123bf11 677 * \param hci Reference to hci object.
Kojto 34:1ad18123bf11 678 * \param event Reference to event object.
Kojto 34:1ad18123bf11 679 * \return none
Kojto 29:c40918cd9b6d 680 */
Kojto 20:30b6ed7bf8fd 681 cc3000_socket(cc3000_simple_link &simplelink, cc3000_hci &hci, cc3000_event &event);
Kojto 29:c40918cd9b6d 682 /**
Kojto 34:1ad18123bf11 683 * \brief Dtor
Kojto 29:c40918cd9b6d 684 * \param
Kojto 34:1ad18123bf11 685 * \return none
Kojto 29:c40918cd9b6d 686 */
Kojto 20:30b6ed7bf8fd 687 ~cc3000_socket();
Kojto 29:c40918cd9b6d 688 /**
Kojto 34:1ad18123bf11 689 * \brief create an endpoint for communication.
Kojto 34:1ad18123bf11 690 * The socket function creates a socket that is bound to a specific transport service provider.\n
Kojto 34:1ad18123bf11 691 * This function is called by the application layer to obtain a socket handle.\n
Kojto 34:1ad18123bf11 692 *
Kojto 34:1ad18123bf11 693 * \param domain selects the protocol family which will be used for\n
Kojto 34:1ad18123bf11 694 * communication. On this version only AF_INET is supported\n
Kojto 34:1ad18123bf11 695 * \param type specifies the communication semantics. On this version\n
Kojto 34:1ad18123bf11 696 * only SOCK_STREAM, SOCK_DGRAM, SOCK_RAW are supported\n
Kojto 34:1ad18123bf11 697 * \param protocol specifies a particular protocol to be used with the\n
Kojto 34:1ad18123bf11 698 * socket IPPROTO_TCP, IPPROTO_UDP or IPPROTO_RAW are supported.\n
Kojto 34:1ad18123bf11 699 * \return On success, socket handle that is used for consequent socket operations\n
Kojto 34:1ad18123bf11 700 * On error, -1 is returned.\n
Kojto 29:c40918cd9b6d 701 */
Kojto 20:30b6ed7bf8fd 702 int32_t socket(int32_t domain, int32_t type, int32_t protocol);
Kojto 29:c40918cd9b6d 703 /**
Kojto 34:1ad18123bf11 704 * \brief accept a connection on a socket.
Kojto 34:1ad18123bf11 705 * This function is used with connection-based socket types\n
Kojto 34:1ad18123bf11 706 * (SOCK_STREAM). It extracts the first connection request on the\n
Kojto 34:1ad18123bf11 707 * queue of pending connections, creates a new connected socket, and\n
Kojto 34:1ad18123bf11 708 * returns a new file descriptor referring to that socket.\n
Kojto 34:1ad18123bf11 709 * The newly created socket is not in the listening state.\n
Kojto 34:1ad18123bf11 710 * The original socket sd is unaffected by this call.\n
Kojto 34:1ad18123bf11 711 * The argument sd is a socket that has been created with socket(),\n
Kojto 34:1ad18123bf11 712 * bound to a local address with bind(), and is listening for \n
Kojto 34:1ad18123bf11 713 * connections after a listen(). The argument addr is a pointer \n
Kojto 34:1ad18123bf11 714 * to a sockaddr structure. This structure is filled in with the \n
Kojto 34:1ad18123bf11 715 * address of the peer socket, as known to the communications layer.\n
Kojto 34:1ad18123bf11 716 * The exact format of the address returned addr is determined by the \n
Kojto 34:1ad18123bf11 717 * socket's address family. The addrlen argument is a value-result\n
Kojto 34:1ad18123bf11 718 * argument: it should initially contain the size of the structure\n
Kojto 34:1ad18123bf11 719 * pointed to by addr, on return it will contain the actual\n
Kojto 34:1ad18123bf11 720 * length (in bytes) of the address returned.\n
Kojto 34:1ad18123bf11 721 *
Kojto 34:1ad18123bf11 722 * \param[in] sd socket descriptor (handle)\n
Kojto 34:1ad18123bf11 723 * \param[out] addr the argument addr is a pointer to a sockaddr structure\n
Kojto 34:1ad18123bf11 724 * This structure is filled in with the address of the \n
Kojto 34:1ad18123bf11 725 * peer socket, as known to the communications layer. \n
Kojto 34:1ad18123bf11 726 * determined. The exact format of the address returned \n
Kojto 34:1ad18123bf11 727 * addr is by the socket's address sockaddr. \n
Kojto 34:1ad18123bf11 728 * On this version only AF_INET is supported.\n
Kojto 34:1ad18123bf11 729 * This argument returns in network order.\n
Kojto 34:1ad18123bf11 730 * \param[out] addrlen the addrlen argument is a value-result argument: \n
Kojto 34:1ad18123bf11 731 * it should initially contain the size of the structure\n
Kojto 34:1ad18123bf11 732 * pointed to by addr.\n
Kojto 34:1ad18123bf11 733 * \return For socket in blocking mode:\n
Kojto 34:1ad18123bf11 734 * - On success, socket handle. on failure negative\n
Kojto 34:1ad18123bf11 735 * For socket in non-blocking mode:\n
Kojto 34:1ad18123bf11 736 * - On connection establishment, socket handle\n
Kojto 34:1ad18123bf11 737 * - On connection pending, SOC_IN_PROGRESS (-2)\n
Kojto 34:1ad18123bf11 738 * - On failure, SOC_ERROR (-1)\n
Kojto 34:1ad18123bf11 739 * \sa socket ; bind ; listen
Kojto 29:c40918cd9b6d 740 */
Kojto 20:30b6ed7bf8fd 741 int32_t accept(int32_t sd, sockaddr *addr, socklen_t *addrlen);
Kojto 29:c40918cd9b6d 742 /**
Kojto 34:1ad18123bf11 743 * \brief assign a name to a socket.
Kojto 34:1ad18123bf11 744 * This function gives the socket the local address addr.\n
Kojto 34:1ad18123bf11 745 * addr is addrlen bytes long. Traditionally, this is called when a \n
Kojto 34:1ad18123bf11 746 * socket is created with socket, it exists in a name space (address \n
Kojto 34:1ad18123bf11 747 * family) but has no name assigned.\n
Kojto 34:1ad18123bf11 748 * It is necessary to assign a local address before a SOCK_STREAM\n
Kojto 34:1ad18123bf11 749 * socket may receive connections.\n
Kojto 34:1ad18123bf11 750 *
Kojto 34:1ad18123bf11 751 * \param[in] sd socket descriptor (handle)
Kojto 34:1ad18123bf11 752 * \param[out] addr specifies the destination address. On this version\n
Kojto 34:1ad18123bf11 753 * only AF_INET is supported.\n
Kojto 34:1ad18123bf11 754 * \param[out] addrlen contains the size of the structure pointed to by addr.\n
Kojto 34:1ad18123bf11 755 * \return On success, zero is returned.\n
Kojto 34:1ad18123bf11 756 * On error, -1 is returned.\n
Kojto 34:1ad18123bf11 757 * \sa socket ; accept ; listen
Kojto 29:c40918cd9b6d 758 */
Kojto 20:30b6ed7bf8fd 759 int32_t bind(int32_t sd, const sockaddr *addr, int32_t addrlen);
Kojto 29:c40918cd9b6d 760 /**
Kojto 34:1ad18123bf11 761 * \brief HostFlowControlConsumeBuff.
Kojto 34:1ad18123bf11 762 * if SEND_NON_BLOCKING is not defined - block until a free buffer is available,\n
Kojto 34:1ad18123bf11 763 * otherwise return the status of the available buffers.\n
Kojto 34:1ad18123bf11 764 *
Kojto 34:1ad18123bf11 765 * \param sd socket descriptor
Kojto 34:1ad18123bf11 766 * \return 0 in case there are buffers available, \n
Kojto 34:1ad18123bf11 767 * -1 in case of bad socket\n
Kojto 34:1ad18123bf11 768 * -2 if there are no free buffers present (only when SEND_NON_BLOCKING is enabled)\n
Kojto 29:c40918cd9b6d 769 */
Kojto 20:30b6ed7bf8fd 770 int32_t HostFlowControlConsumeBuff(int32_t sd);
Kojto 29:c40918cd9b6d 771 /**
Kojto 34:1ad18123bf11 772 * \brief The socket function closes a created socket.
Kojto 34:1ad18123bf11 773 * \param sd socket handle.
Kojto 34:1ad18123bf11 774 * \return On success, zero is returned. On error, -1 is returned.
Kojto 29:c40918cd9b6d 775 */
Kojto 20:30b6ed7bf8fd 776 int32_t closesocket(int32_t sd);
Kojto 29:c40918cd9b6d 777 /**
Kojto 34:1ad18123bf11 778 * \brief listen for connections on a socket.
Kojto 34:1ad18123bf11 779 * The willingness to accept incoming connections and a queue\n
Kojto 34:1ad18123bf11 780 * limit for incoming connections are specified with listen(),\n
Kojto 34:1ad18123bf11 781 * and then the connections are accepted with accept.\n
Kojto 34:1ad18123bf11 782 * The listen() call applies only to sockets of type SOCK_STREAM\n
Kojto 34:1ad18123bf11 783 * The backlog parameter defines the maximum length the queue of\n
Kojto 34:1ad18123bf11 784 * pending connections may grow to. \n
Kojto 34:1ad18123bf11 785 *
Kojto 34:1ad18123bf11 786 * \param[in] sd socket descriptor (handle)
Kojto 34:1ad18123bf11 787 * \param[in] backlog specifies the listen queue depth. On this version\n
Kojto 34:1ad18123bf11 788 * backlog is not supported.\n
Kojto 34:1ad18123bf11 789 * \return On success, zero is returned.\n
Kojto 34:1ad18123bf11 790 * On error, -1 is returned.\n
Kojto 34:1ad18123bf11 791 * \sa socket ; accept ; bind
Kojto 34:1ad18123bf11 792 * \note On this version, backlog is not supported
Kojto 29:c40918cd9b6d 793 */
Kojto 20:30b6ed7bf8fd 794 int32_t listen(int32_t sd, int32_t backlog);
Kojto 29:c40918cd9b6d 795 /**
Kojto 34:1ad18123bf11 796 * \brief initiate a connection on a socket.
Kojto 34:1ad18123bf11 797 * Function connects the socket referred to by the socket descriptor\n
Kojto 34:1ad18123bf11 798 * sd, to the address specified by addr. The addrlen argument \n
Kojto 34:1ad18123bf11 799 * specifies the size of addr. The format of the address in addr is \n
Kojto 34:1ad18123bf11 800 * determined by the address space of the socket. If it is of type \n
Kojto 34:1ad18123bf11 801 * SOCK_DGRAM, this call specifies the peer with which the socket is \n
Kojto 34:1ad18123bf11 802 * to be associated; this address is that to which datagrams are to be\n
Kojto 34:1ad18123bf11 803 * sent, and the only address from which datagrams are to be received. \n
Kojto 34:1ad18123bf11 804 * If the socket is of type SOCK_STREAM, this call attempts to make a \n
Kojto 34:1ad18123bf11 805 * connection to another socket. The other socket is specified by \n
Kojto 34:1ad18123bf11 806 * address, which is an address in the communications space of the\n
Kojto 34:1ad18123bf11 807 * socket. Note that the function implements only blocking behavior \n
Kojto 34:1ad18123bf11 808 * thus the caller will be waiting either for the connection \n
Kojto 34:1ad18123bf11 809 * establishment or for the connection establishment failure.\n
Kojto 34:1ad18123bf11 810 *
Kojto 34:1ad18123bf11 811 * \param[in] sd socket descriptor (handle)
Kojto 34:1ad18123bf11 812 * \param[in] addr specifies the destination addr. On this version\n
Kojto 34:1ad18123bf11 813 * only AF_INET is supported.\n
Kojto 34:1ad18123bf11 814 * \param[out] addrlen contains the size of the structure pointed to by addr
Kojto 34:1ad18123bf11 815 * \return On success, zero is returned.\n
Kojto 34:1ad18123bf11 816 On error, -1 is returned\n
Kojto 34:1ad18123bf11 817 * \sa socket
Kojto 29:c40918cd9b6d 818 */
Kojto 20:30b6ed7bf8fd 819 int32_t connect(int32_t sd, const sockaddr *addr, int32_t addrlen);
Kojto 29:c40918cd9b6d 820 /**
Kojto 34:1ad18123bf11 821 * \brief Monitor socket activity.
Kojto 34:1ad18123bf11 822 * Select allow a program to monitor multiple file descriptors,\n
Kojto 34:1ad18123bf11 823 * waiting until one or more of the file descriptors become \n
Kojto 34:1ad18123bf11 824 * "ready" for some class of I/O operation \n
Kojto 34:1ad18123bf11 825 *
Kojto 34:1ad18123bf11 826 * \param[in] nfds the highest-numbered file descriptor in any of the\n
Kojto 34:1ad18123bf11 827 * three sets, plus 1. \n
Kojto 34:1ad18123bf11 828 * \param[out] readsds socket descriptors list for read monitoring\n
Kojto 34:1ad18123bf11 829 * \param[out] writesds socket descriptors list for write monitoring\n
Kojto 34:1ad18123bf11 830 * \param[out] exceptsds socket descriptors list for exception monitoring\n
Kojto 34:1ad18123bf11 831 * \param[in] timeout is an upper bound on the amount of time elapsed\n
Kojto 34:1ad18123bf11 832 * before select() returns. Null means infinity \n
Kojto 34:1ad18123bf11 833 * timeout. The minimum timeout is 5 milliseconds,\n
Kojto 34:1ad18123bf11 834 * less than 5 milliseconds will be set\n
Kojto 34:1ad18123bf11 835 * automatically to 5 milliseconds.\n
Kojto 34:1ad18123bf11 836 * \return On success, select() returns the number of file descriptors\n
Kojto 34:1ad18123bf11 837 * contained in the three returned descriptor sets (that is, the\n
Kojto 34:1ad18123bf11 838 * total number of bits that are set in readfds, writefds,\n
Kojto 34:1ad18123bf11 839 * exceptfds) which may be zero if the timeout expires before\n
Kojto 34:1ad18123bf11 840 * anything interesting happens.\n
Kojto 34:1ad18123bf11 841 * On error, -1 is returned.\n
Kojto 34:1ad18123bf11 842 * *readsds - return the sockets on which Read request will\n
Kojto 34:1ad18123bf11 843 * return without delay with valid data.\n
Kojto 34:1ad18123bf11 844 * *writesds - return the sockets on which Write request \n
Kojto 34:1ad18123bf11 845 * will return without delay.\n
Kojto 34:1ad18123bf11 846 * *exceptsds - return the sockets which closed recently.\n
Kojto 34:1ad18123bf11 847 * \Note If the timeout value set to less than 5ms it will automatically\n
Kojto 34:1ad18123bf11 848 * change to 5ms to prevent overload of the system\n
Kojto 34:1ad18123bf11 849 * \sa socket
Kojto 29:c40918cd9b6d 850 */
Kojto 20:30b6ed7bf8fd 851 int32_t select(int32_t nfds, fd_set *readsds, fd_set *writesds, fd_set *exceptsds, struct timeval *timeout);
Kojto 29:c40918cd9b6d 852 /**
Kojto 34:1ad18123bf11 853 * \brief get socket options.
Kojto 34:1ad18123bf11 854 * This function manipulate the options associated with a socket.\n
Kojto 34:1ad18123bf11 855 * Options may exist at multiple protocol levels; they are always\n
Kojto 34:1ad18123bf11 856 * present at the uppermost socket level.\n
Kojto 34:1ad18123bf11 857 * When manipulating socket options the level at which the option \n
Kojto 34:1ad18123bf11 858 * resides and the name of the option must be specified. \n
Kojto 34:1ad18123bf11 859 * To manipulate options at the socket level, level is specified as \n
Kojto 34:1ad18123bf11 860 * SOL_SOCKET. To manipulate options at any other level the protocol \n
Kojto 34:1ad18123bf11 861 * number of the appropriate protocol controlling the option is \n
Kojto 34:1ad18123bf11 862 * supplied. For example, to indicate that an option is to be \n
Kojto 34:1ad18123bf11 863 * interpreted by the TCP protocol, level should be set to the \n
Kojto 34:1ad18123bf11 864 * protocol number of TCP; \n
Kojto 34:1ad18123bf11 865 * The parameters optval and optlen are used to access optval -\n
Kojto 34:1ad18123bf11 866 * use for setsockopt(). For getsockopt() they identify a buffer\n
Kojto 34:1ad18123bf11 867 * in which the value for the requested option(s) are to \n
Kojto 34:1ad18123bf11 868 * be returned. For getsockopt(), optlen is a value-result \n
Kojto 34:1ad18123bf11 869 * parameter, initially containing the size of the buffer \n
Kojto 34:1ad18123bf11 870 * pointed to by option_value, and modified on return to \n
Kojto 34:1ad18123bf11 871 * indicate the actual size of the value returned. If no option \n
Kojto 34:1ad18123bf11 872 * value is to be supplied or returned, option_value may be NULL.\n
Kojto 34:1ad18123bf11 873 *
Kojto 34:1ad18123bf11 874 * \param[in] sd socket handle
Kojto 34:1ad18123bf11 875 * \param[in] level defines the protocol level for this option
Kojto 34:1ad18123bf11 876 * \param[in] optname defines the option name to Interrogate
Kojto 34:1ad18123bf11 877 * \param[out] optval specifies a value for the option
Kojto 34:1ad18123bf11 878 * \param[out] optlen specifies the length of the option value
Kojto 34:1ad18123bf11 879 * \return On success, zero is returned. On error, -1 is returned
Kojto 34:1ad18123bf11 880 *
Kojto 34:1ad18123bf11 881 * \Note On this version the following two socket options are enabled:\n
Kojto 34:1ad18123bf11 882 * The only protocol level supported in this version is SOL_SOCKET (level).\n
Kojto 34:1ad18123bf11 883 * 1. SOCKOPT_RECV_TIMEOUT (optname)\n
Kojto 34:1ad18123bf11 884 * SOCKOPT_RECV_TIMEOUT configures recv and recvfrom timeout in milliseconds.\n
Kojto 34:1ad18123bf11 885 * In that case optval should be pointer to unsigned long.\n
Kojto 34:1ad18123bf11 886 * 2. SOCKOPT_NONBLOCK (optname). sets the socket non-blocking mode on or off.\n
Kojto 34:1ad18123bf11 887 * In that case optval should be SOCK_ON or SOCK_OFF (optval).\n
Kojto 34:1ad18123bf11 888 * \sa setsockopt
Kojto 29:c40918cd9b6d 889 */
Kojto 20:30b6ed7bf8fd 890 int32_t getsockopt (int32_t sd, int32_t level, int32_t optname, void *optval, socklen_t *optlen);
Kojto 29:c40918cd9b6d 891 /**
Kojto 34:1ad18123bf11 892 * \brief Read data from socket (simple_link_recv).
Kojto 34:1ad18123bf11 893 * Return the length of the message on successful completion.\n
Kojto 34:1ad18123bf11 894 * If a message is too long to fit in the supplied buffer, excess bytes may\n
Kojto 34:1ad18123bf11 895 * be discarded depending on the type of socket the message is received from.\n
Kojto 34:1ad18123bf11 896 *
Kojto 34:1ad18123bf11 897 * \param sd socket handle
Kojto 34:1ad18123bf11 898 * \param buf read buffer
Kojto 34:1ad18123bf11 899 * \param len buffer length
Kojto 34:1ad18123bf11 900 * \param flags indicates blocking or non-blocking operation
Kojto 34:1ad18123bf11 901 * \param from pointer to an address structure indicating source address
Kojto 34:1ad18123bf11 902 * \param fromlen source address structure size
Kojto 34:1ad18123bf11 903 * \return Return the number of bytes received, or -1 if an error occurred
Kojto 29:c40918cd9b6d 904 */
Kojto 20:30b6ed7bf8fd 905 int32_t simple_link_recv(int32_t sd, void *buf, int32_t len, int32_t flags, sockaddr *from, socklen_t *fromlen, int32_t opcode);
Kojto 29:c40918cd9b6d 906 /**
Kojto 34:1ad18123bf11 907 * \brief Transmit a message to another socket (simple_link_send).
Kojto 34:1ad18123bf11 908 * \param sd socket handle
Kojto 34:1ad18123bf11 909 * \param buf write buffer
Kojto 34:1ad18123bf11 910 * \param len buffer length
Kojto 34:1ad18123bf11 911 * \param flags On this version, this parameter is not supported
Kojto 34:1ad18123bf11 912 * \param to pointer to an address structure indicating destination address
Kojto 34:1ad18123bf11 913 * \param tolen destination address structure size
Kojto 34:1ad18123bf11 914 * \return Return the number of bytes transmitted, or -1 if an error\n
Kojto 34:1ad18123bf11 915 * occurred, or -2 in case there are no free buffers available\n
Kojto 34:1ad18123bf11 916 * (only when SEND_NON_BLOCKING is enabled)\n
Kojto 29:c40918cd9b6d 917 */
Kojto 20:30b6ed7bf8fd 918 int32_t simple_link_send(int32_t sd, const void *buf, int32_t len, int32_t flags, const sockaddr *to, int32_t tolen, int32_t opcode);
Kojto 29:c40918cd9b6d 919 /**
Kojto 34:1ad18123bf11 920 * \brief Receive a message from a connection-mode socket.
Kojto 34:1ad18123bf11 921 * \param[in] sd socket handle
Kojto 34:1ad18123bf11 922 * \param[out] buf Points to the buffer where the message should be stored
Kojto 34:1ad18123bf11 923 * \param[in] len Specifies the length in bytes of the buffer pointed to \n
Kojto 34:1ad18123bf11 924 * by the buffer argument.\n
Kojto 34:1ad18123bf11 925 * \param[in] flags Specifies the type of message reception. \n
Kojto 34:1ad18123bf11 926 * On this version, this parameter is not supported.\n
Kojto 34:1ad18123bf11 927 * \return Return the number of bytes received, or -1 if an error occurred
Kojto 34:1ad18123bf11 928 * \sa recvfrom
Kojto 34:1ad18123bf11 929 * \Note On this version, only blocking mode is supported.
Kojto 29:c40918cd9b6d 930 */
Kojto 20:30b6ed7bf8fd 931 int32_t recv(int32_t sd, void *buf, int32_t len, int32_t flags);
Kojto 29:c40918cd9b6d 932 /**
Kojto 34:1ad18123bf11 933 * \brief read data from socket (recvfrom).
Kojto 34:1ad18123bf11 934 * Receives a message from a connection-mode or connectionless-mode socket.\n
Kojto 34:1ad18123bf11 935 * Note that raw sockets are not supported.\n
Kojto 34:1ad18123bf11 936 *
Kojto 34:1ad18123bf11 937 * \param[in] sd socket handle
Kojto 34:1ad18123bf11 938 * \param[out] buf Points to the buffer where the message should be stored
Kojto 34:1ad18123bf11 939 * \param[in] len Specifies the length in bytes of the buffer pointed to \n
Kojto 34:1ad18123bf11 940 * by the buffer argument.\n
Kojto 34:1ad18123bf11 941 * \param[in] flags Specifies the type of message reception.\n
Kojto 34:1ad18123bf11 942 * On this version, this parameter is not supported.\n
Kojto 34:1ad18123bf11 943 * \param[in] from pointer to an address structure indicating the source\n
Kojto 34:1ad18123bf11 944 * address: sockaddr. On this version only AF_INET is\n
Kojto 34:1ad18123bf11 945 * supported.\n
Kojto 34:1ad18123bf11 946 * \param[in] fromlen source address structure size
Kojto 34:1ad18123bf11 947 * \return Return the number of bytes received, or -1 if an error occurred
Kojto 34:1ad18123bf11 948 * \sa recv
Kojto 34:1ad18123bf11 949 * \Note On this version, only blocking mode is supported.
Kojto 29:c40918cd9b6d 950 */
Kojto 20:30b6ed7bf8fd 951 int32_t recvfrom(int32_t sd, void *buf, int32_t len, int32_t flags, sockaddr *from, socklen_t *fromlen);
Kojto 29:c40918cd9b6d 952 /**
Kojto 34:1ad18123bf11 953 * \brief Transmit a message to another socket (send).
Kojto 34:1ad18123bf11 954 * \param sd socket handle
Kojto 34:1ad18123bf11 955 * \param buf Points to a buffer containing the message to be sent
Kojto 34:1ad18123bf11 956 * \param len message size in bytes
Kojto 34:1ad18123bf11 957 * \param flags On this version, this parameter is not supported
Kojto 34:1ad18123bf11 958 * \return Return the number of bytes transmitted, or -1 if an\n
Kojto 34:1ad18123bf11 959 * error occurred\n
Kojto 34:1ad18123bf11 960 * \Note On this version, only blocking mode is supported.
Kojto 34:1ad18123bf11 961 * \sa sendto
Kojto 29:c40918cd9b6d 962 */
Kojto 20:30b6ed7bf8fd 963 int32_t send(int32_t sd, const void *buf, int32_t len, int32_t flags);
Kojto 29:c40918cd9b6d 964 /**
Kojto 34:1ad18123bf11 965 * \brief Transmit a message to another socket (sendto).
Kojto 34:1ad18123bf11 966 * \param sd socket handle
Kojto 34:1ad18123bf11 967 * \param buf Points to a buffer containing the message to be sent
Kojto 34:1ad18123bf11 968 * \param len message size in bytes
Kojto 34:1ad18123bf11 969 * \param flags On this version, this parameter is not supported
Kojto 34:1ad18123bf11 970 * \param to pointer to an address structure indicating the destination\n
Kojto 34:1ad18123bf11 971 * address: sockaddr. On this version only AF_INET is\n
Kojto 34:1ad18123bf11 972 * supported.\n
Kojto 34:1ad18123bf11 973 * \param tolen destination address structure size
Kojto 34:1ad18123bf11 974 * \return Return the number of bytes transmitted, or -1 if an error occurred
Kojto 34:1ad18123bf11 975 * \Note On this version, only blocking mode is supported.
Kojto 34:1ad18123bf11 976 * \sa send
Kojto 29:c40918cd9b6d 977 */
Kojto 20:30b6ed7bf8fd 978 int32_t sendto(int32_t sd, const void *buf, int32_t len, int32_t flags, const sockaddr *to, socklen_t tolen);
Kojto 29:c40918cd9b6d 979 /**
Kojto 34:1ad18123bf11 980 * \brief Set CC3000 in mDNS advertiser mode in order to advertise itself.
Kojto 34:1ad18123bf11 981 * \param[in] mdns_enabled flag to enable/disable the mDNS feature
Kojto 34:1ad18123bf11 982 * \param[in] device_service_name Service name as part of the published\n
Kojto 34:1ad18123bf11 983 * canonical domain name\n
Kojto 34:1ad18123bf11 984 * \param[in] device_service_name_length Length of the service name
Kojto 34:1ad18123bf11 985 * \return On success, zero is returned,\n
Kojto 34:1ad18123bf11 986 * return SOC_ERROR if socket was not opened successfully, or if an error occurred.\n
Kojto 29:c40918cd9b6d 987 */
Kojto 20:30b6ed7bf8fd 988 int32_t mdns_advertiser(uint16_t mdns_enabled, uint8_t * device_service_name, uint16_t device_service_name_length);
SolderSplashLabs 42:bd2c631a031a 989 /**
Kojto 44:960b73df5981 990 * \brief
SolderSplashLabs 42:bd2c631a031a 991 * \param[in] s_addr in host format ( little endian )
SolderSplashLabs 42:bd2c631a031a 992 * \param[in] *buf buffer to write too
SolderSplashLabs 42:bd2c631a031a 993 * \param[in] buflen length of supplied buffer
SolderSplashLabs 42:bd2c631a031a 994 * \return pointer to buf \n
SolderSplashLabs 42:bd2c631a031a 995 */
SolderSplashLabs 42:bd2c631a031a 996 char * inet_ntoa_r(uint32_t s_addr, char *buf, int buflen);
Kojto 20:30b6ed7bf8fd 997 #ifndef CC3000_TINY_DRIVER
Kojto 33:9e23b24fb4f3 998 /**
Kojto 34:1ad18123bf11 999 * \brief Get host IP by name.\n
Kojto 34:1ad18123bf11 1000 * Obtain the IP Address of machine on network\n
Kojto 34:1ad18123bf11 1001 *
Kojto 34:1ad18123bf11 1002 * \param[in] hostname host name
Kojto 34:1ad18123bf11 1003 * \param[in] name_length name length
Kojto 34:1ad18123bf11 1004 * \param[out] out_ip_addr This parameter is filled in with host IP address.\n
Kojto 34:1ad18123bf11 1005 * In case that host name is not resolved, \n
Kojto 34:1ad18123bf11 1006 * out_ip_addr is zero.\n
Kojto 34:1ad18123bf11 1007 * \return On success, positive is returned.\n
Kojto 34:1ad18123bf11 1008 * On error, negative is returned by its name.\n
Kojto 34:1ad18123bf11 1009 * \note On this version, only blocking mode is supported. Also note that\n
Kojto 34:1ad18123bf11 1010 * The function requires DNS server to be configured prior to its usage.\n
Kojto 33:9e23b24fb4f3 1011 */
Kojto 20:30b6ed7bf8fd 1012 int32_t gethostbyname(uint8_t *hostname, uint16_t name_length, uint32_t *out_ip_addr);
Kojto 29:c40918cd9b6d 1013 /**
Kojto 34:1ad18123bf11 1014 * \brief set socket options.
Kojto 34:1ad18123bf11 1015 * This function manipulate the options associated with a socket.\n
Kojto 34:1ad18123bf11 1016 * Options may exist at multiple protocol levels; they are always\n
Kojto 34:1ad18123bf11 1017 * present at the uppermost socket level.\n
Kojto 34:1ad18123bf11 1018 * When manipulating socket options the level at which the option \n
Kojto 34:1ad18123bf11 1019 * resides and the name of the option must be specified.\n
Kojto 34:1ad18123bf11 1020 * To manipulate options at the socket level, level is specified as\n
Kojto 34:1ad18123bf11 1021 * SOL_SOCKET. To manipulate options at any other level the protocol \n
Kojto 34:1ad18123bf11 1022 * number of the appropriate protocol controlling the option is \n
Kojto 34:1ad18123bf11 1023 * supplied. For example, to indicate that an option is to be \n
Kojto 34:1ad18123bf11 1024 * interpreted by the TCP protocol, level should be set to the \n
Kojto 34:1ad18123bf11 1025 * protocol number of TCP; \n
Kojto 34:1ad18123bf11 1026 * The parameters optval and optlen are used to access optval - \n
Kojto 34:1ad18123bf11 1027 * use for setsockopt(). For getsockopt() they identify a buffer\n
Kojto 34:1ad18123bf11 1028 * in which the value for the requested option(s) are to \n
Kojto 34:1ad18123bf11 1029 * be returned. For getsockopt(), optlen is a value-result \n
Kojto 34:1ad18123bf11 1030 * parameter, initially containing the size of the buffer \n
Kojto 34:1ad18123bf11 1031 * pointed to by option_value, and modified on return to \n
Kojto 34:1ad18123bf11 1032 * indicate the actual size of the value returned. If no option \n
Kojto 34:1ad18123bf11 1033 * value is to be supplied or returned, option_value may be NULL.\n
Kojto 34:1ad18123bf11 1034 *
Kojto 34:1ad18123bf11 1035 * \param[in] sd socket handle
Kojto 34:1ad18123bf11 1036 * \param[in] level defines the protocol level for this option
Kojto 34:1ad18123bf11 1037 * \param[in] optname defines the option name to Interrogate
Kojto 34:1ad18123bf11 1038 * \param[in] optval specifies a value for the option
Kojto 34:1ad18123bf11 1039 * \param[in] optlen specifies the length of the option value
Kojto 34:1ad18123bf11 1040 * \return On success, zero is returned.\n
Kojto 34:1ad18123bf11 1041 * On error, -1 is returned\n
Kojto 34:1ad18123bf11 1042 *
Kojto 34:1ad18123bf11 1043 * \Note On this version the following two socket options are enabled:\n
Kojto 34:1ad18123bf11 1044 * The only protocol level supported in this version is SOL_SOCKET (level).\n
Kojto 34:1ad18123bf11 1045 * 1. SOCKOPT_RECV_TIMEOUT (optname)\n
Kojto 34:1ad18123bf11 1046 * SOCKOPT_RECV_TIMEOUT configures recv and recvfrom timeout in milliseconds.\n
Kojto 34:1ad18123bf11 1047 * In that case optval should be pointer to unsigned long.\n
Kojto 34:1ad18123bf11 1048 * 2. SOCKOPT_NONBLOCK (optname). sets the socket non-blocking mode on or off.\n
Kojto 34:1ad18123bf11 1049 * In that case optval should be SOCK_ON or SOCK_OFF (optval).\n
Kojto 34:1ad18123bf11 1050 * \sa getsockopt
Kojto 29:c40918cd9b6d 1051 */
Kojto 20:30b6ed7bf8fd 1052 int32_t setsockopt(int32_t sd, int32_t level, int32_t optname, const void *optval, socklen_t optlen);
Kojto 20:30b6ed7bf8fd 1053 #endif
Kojto 20:30b6ed7bf8fd 1054 private:
Kojto 20:30b6ed7bf8fd 1055 cc3000_simple_link &_simple_link;
Kojto 20:30b6ed7bf8fd 1056 cc3000_hci &_hci;
Kojto 20:30b6ed7bf8fd 1057 cc3000_event &_event;
Kojto 20:30b6ed7bf8fd 1058 };
Kojto 20:30b6ed7bf8fd 1059
Kojto 31:7b6e85b68b01 1060 /** SPI communication layer
Kojto 20:30b6ed7bf8fd 1061 */
Kojto 20:30b6ed7bf8fd 1062 class cc3000_spi {
Kojto 20:30b6ed7bf8fd 1063 public:
Kojto 33:9e23b24fb4f3 1064 /**
Kojto 33:9e23b24fb4f3 1065 * \brief Ctor
Kojto 34:1ad18123bf11 1066 * \param irq IRQ pin
Kojto 34:1ad18123bf11 1067 * \param cc3000_en Enable pin
Kojto 34:1ad18123bf11 1068 * \param cc3000_cs Chip select pin
Kojto 34:1ad18123bf11 1069 * \param cc3000_spi SPI object
Kojto 34:1ad18123bf11 1070 * \param irq_port Port for IRQ pin (needed for enable/disable interrupts)
Kojto 34:1ad18123bf11 1071 * \param event Reference to the event object.
Kojto 34:1ad18123bf11 1072 * \param simple_link Reference to the simple link object.
Kojto 33:9e23b24fb4f3 1073 * \return none
Kojto 20:30b6ed7bf8fd 1074 */
Kojto 20:30b6ed7bf8fd 1075 cc3000_spi(PinName cc3000_irq, PinName cc3000_en, PinName cc3000_cs, SPI cc3000_spi, IRQn_Type irq_port, cc3000_event &event, cc3000_simple_link &simple_link);
Kojto 33:9e23b24fb4f3 1076 /**
Kojto 33:9e23b24fb4f3 1077 * \brief Dtor
Kojto 33:9e23b24fb4f3 1078 * \param none
Kojto 33:9e23b24fb4f3 1079 * \return none
Kojto 20:30b6ed7bf8fd 1080 */
Kojto 20:30b6ed7bf8fd 1081 ~cc3000_spi();
Kojto 33:9e23b24fb4f3 1082 /**
Kojto 33:9e23b24fb4f3 1083 * \brief Close SPI - disables IRQ and set received buffer to 0
Kojto 20:30b6ed7bf8fd 1084 * \param none
Kojto 20:30b6ed7bf8fd 1085 * \return none
Kojto 20:30b6ed7bf8fd 1086 */
Kojto 20:30b6ed7bf8fd 1087 void close();
Kojto 34:1ad18123bf11 1088 /**
Kojto 34:1ad18123bf11 1089 * \brief Open the SPI interface
Kojto 34:1ad18123bf11 1090 * \param none
Kojto 34:1ad18123bf11 1091 * \return none
Kojto 20:30b6ed7bf8fd 1092 */
Kojto 20:30b6ed7bf8fd 1093 void open();
Kojto 34:1ad18123bf11 1094 /**
Kojto 34:1ad18123bf11 1095 * \brief First SPI write after powerup (delay needed between SPI header and body)
Kojto 34:1ad18123bf11 1096 * \param buffer pointer to write buffer
Kojto 34:1ad18123bf11 1097 * \param length buffer length
Kojto 34:1ad18123bf11 1098 * \return 0
Kojto 20:30b6ed7bf8fd 1099 */
Kojto 20:30b6ed7bf8fd 1100 uint32_t first_write(uint8_t *buffer, uint16_t length);
Kojto 34:1ad18123bf11 1101 /**
Kojto 34:1ad18123bf11 1102 * \brief SPI Write function
Kojto 34:1ad18123bf11 1103 * \param buffer pointer to write buffer
Kojto 34:1ad18123bf11 1104 * \param length buffer length
Kojto 34:1ad18123bf11 1105 * \return 0
Kojto 20:30b6ed7bf8fd 1106 */
Kojto 20:30b6ed7bf8fd 1107 uint32_t write(uint8_t *buffer, uint16_t length);
Kojto 34:1ad18123bf11 1108 /**
Kojto 34:1ad18123bf11 1109 * \brief Low level SPI write
Kojto 34:1ad18123bf11 1110 * \param data pointer to data buffer
Kojto 34:1ad18123bf11 1111 * \param size number of bytes
Kojto 34:1ad18123bf11 1112 * \return none
Kojto 20:30b6ed7bf8fd 1113 */
Kojto 20:30b6ed7bf8fd 1114 void write_synchronous(uint8_t *data, uint16_t size);
Kojto 34:1ad18123bf11 1115 /**
Kojto 34:1ad18123bf11 1116 * \brief Low level SPI read
Kojto 34:1ad18123bf11 1117 * \param data pointer to data buffer
Kojto 34:1ad18123bf11 1118 * \param size number of bytes
Kojto 34:1ad18123bf11 1119 * \return none
Kojto 20:30b6ed7bf8fd 1120 */
Kojto 20:30b6ed7bf8fd 1121 void read_synchronous(uint8_t *data, uint16_t size);
Kojto 34:1ad18123bf11 1122 /**
Kojto 34:1ad18123bf11 1123 * \brief Process the received SPI Header and in accordance with it - continue reading the packet
Kojto 34:1ad18123bf11 1124 * \param None
Kojto 34:1ad18123bf11 1125 * \return 0
Kojto 20:30b6ed7bf8fd 1126 */
Kojto 20:30b6ed7bf8fd 1127 uint32_t read_data_cont();
Kojto 20:30b6ed7bf8fd 1128 /**
Kojto 34:1ad18123bf11 1129 * \brief Enable WLAN interrutp
Kojto 34:1ad18123bf11 1130 * \param None
Kojto 34:1ad18123bf11 1131 * \return None
Kojto 20:30b6ed7bf8fd 1132 */
Kojto 20:30b6ed7bf8fd 1133 void wlan_irq_enable();
Kojto 34:1ad18123bf11 1134 /**
Kojto 34:1ad18123bf11 1135 * \brief Disable WLAN interrutp
Kojto 34:1ad18123bf11 1136 * \param None
Kojto 34:1ad18123bf11 1137 * \return None
Kojto 20:30b6ed7bf8fd 1138 */
Kojto 20:30b6ed7bf8fd 1139 void wlan_irq_disable();
Kojto 20:30b6ed7bf8fd 1140 /**
Kojto 34:1ad18123bf11 1141 * \brief Get WLAN interrupt status
Kojto 34:1ad18123bf11 1142 * \param None
Kojto 34:1ad18123bf11 1143 * \return 0 : No interrupt occured
Kojto 34:1ad18123bf11 1144 * 1 : Interrupt occured
Kojto 20:30b6ed7bf8fd 1145 */
Kojto 20:30b6ed7bf8fd 1146 uint32_t wlan_irq_read();
Kojto 20:30b6ed7bf8fd 1147 /**
Kojto 34:1ad18123bf11 1148 * \brief SPI interrupt Handler.
Kojto 34:1ad18123bf11 1149 * The external WLAN device asserts the IRQ line when data is ready.\n
Kojto 34:1ad18123bf11 1150 * The host CPU needs to acknowledges the IRQ by asserting CS.\n
Kojto 34:1ad18123bf11 1151 *
Kojto 34:1ad18123bf11 1152 * \param none
Kojto 34:1ad18123bf11 1153 * \return none
Kojto 20:30b6ed7bf8fd 1154 */
Kojto 20:30b6ed7bf8fd 1155 void WLAN_IRQHandler();
Kojto 20:30b6ed7bf8fd 1156 /**
Kojto 34:1ad18123bf11 1157 * \brief Enable/Disable the WLAN module
Kojto 34:1ad18123bf11 1158 * \param value 1 : Enable
Kojto 34:1ad18123bf11 1159 * 0 : Disable
Kojto 34:1ad18123bf11 1160 * \return None
Kojto 20:30b6ed7bf8fd 1161 */
Kojto 34:1ad18123bf11 1162 void set_wlan_en(uint8_t value);
Kojto 20:30b6ed7bf8fd 1163 private:
Kojto 20:30b6ed7bf8fd 1164 tSpiInfo _spi_info;
Kojto 20:30b6ed7bf8fd 1165 InterruptIn _wlan_irq;
Kojto 20:30b6ed7bf8fd 1166 DigitalOut _wlan_en;
Kojto 20:30b6ed7bf8fd 1167 DigitalOut _wlan_cs;
Kojto 20:30b6ed7bf8fd 1168 SPI _wlan_spi;
Kojto 20:30b6ed7bf8fd 1169 IRQn_Type _irq_port;
Kojto 20:30b6ed7bf8fd 1170 pFunctionPointer_t _function_pointer;
Kojto 20:30b6ed7bf8fd 1171 cc3000_event &_event;
Kojto 20:30b6ed7bf8fd 1172 cc3000_simple_link &_simple_link;
Kojto 20:30b6ed7bf8fd 1173 };
Kojto 20:30b6ed7bf8fd 1174
Kojto 31:7b6e85b68b01 1175 /** HCI layer
Kojto 31:7b6e85b68b01 1176 */
Kojto 20:30b6ed7bf8fd 1177 class cc3000_hci {
Kojto 20:30b6ed7bf8fd 1178 public:
Kojto 29:c40918cd9b6d 1179 /**
Kojto 29:c40918cd9b6d 1180 * \brief Ctor
Kojto 34:1ad18123bf11 1181 * \param spi Reference to the spi object.
Kojto 29:c40918cd9b6d 1182 * \return none
Kojto 29:c40918cd9b6d 1183 */
Kojto 20:30b6ed7bf8fd 1184 cc3000_hci(cc3000_spi &spi);
Kojto 29:c40918cd9b6d 1185 /**
Kojto 29:c40918cd9b6d 1186 * \brief Dtor
Kojto 29:c40918cd9b6d 1187 * \param none
Kojto 29:c40918cd9b6d 1188 * \return none
Kojto 29:c40918cd9b6d 1189 */
Kojto 20:30b6ed7bf8fd 1190 ~cc3000_hci();
Kojto 29:c40918cd9b6d 1191 /**
Kojto 29:c40918cd9b6d 1192 * \brief Initiate an HCI command.
Kojto 29:c40918cd9b6d 1193 * \param op_code command operation code
Kojto 29:c40918cd9b6d 1194 * \param buffer pointer to the command's arguments buffer
Kojto 29:c40918cd9b6d 1195 * \param length length of the arguments
Kojto 34:1ad18123bf11 1196 * \return 0
Kojto 29:c40918cd9b6d 1197 */
Kojto 20:30b6ed7bf8fd 1198 uint16_t command_send(uint16_t op_code, uint8_t *buffer, uint8_t length);
Kojto 29:c40918cd9b6d 1199 /**
Kojto 29:c40918cd9b6d 1200 * \brief Initiate an HCI data write operation
Kojto 29:c40918cd9b6d 1201 * \param op_code command operation code
Kojto 29:c40918cd9b6d 1202 * \param args pointer to the command's arguments buffer
Kojto 29:c40918cd9b6d 1203 * \param arg_length length of the arguments
Kojto 29:c40918cd9b6d 1204 * \param data_length length od data
Kojto 29:c40918cd9b6d 1205 * \param tail pointer to the data buffer
Kojto 29:c40918cd9b6d 1206 * \param tail_length buffer length
Kojto 34:1ad18123bf11 1207 * \return ESUCCESS
Kojto 29:c40918cd9b6d 1208 */
Kojto 20:30b6ed7bf8fd 1209 uint32_t data_send(uint8_t op_code, uint8_t *args, uint16_t arg_length,
Kojto 20:30b6ed7bf8fd 1210 uint16_t data_length, const uint8_t *tail, uint16_t tail_length);
Kojto 29:c40918cd9b6d 1211 /**
Kojto 29:c40918cd9b6d 1212 * \brief Prepare HCI header and initiate an HCI data write operation.
Kojto 29:c40918cd9b6d 1213 * \param op_code command operation code
Kojto 29:c40918cd9b6d 1214 * \param buffer pointer to the data buffer
Kojto 29:c40918cd9b6d 1215 * \param arg_length arguments length
Kojto 29:c40918cd9b6d 1216 * \param data_length data length
Kojto 29:c40918cd9b6d 1217 * \return none
Kojto 29:c40918cd9b6d 1218 */
Kojto 20:30b6ed7bf8fd 1219 void data_command_send(uint16_t op_code, uint8_t *buffer, uint8_t arg_length,
Kojto 20:30b6ed7bf8fd 1220 uint16_t data_length);
Kojto 29:c40918cd9b6d 1221 /**
Kojto 29:c40918cd9b6d 1222 * \brief Prepare HCI header and initiate an HCI patch write operation.
Kojto 29:c40918cd9b6d 1223 * \param op_code command operation code
Kojto 29:c40918cd9b6d 1224 * \param buffer pointer to the command's arguments buffer
Kojto 29:c40918cd9b6d 1225 * \param patch pointer to patch content buffer
Kojto 29:c40918cd9b6d 1226 * \param data_length data length
Kojto 29:c40918cd9b6d 1227 * \return none
Kojto 29:c40918cd9b6d 1228 */
Kojto 20:30b6ed7bf8fd 1229 void patch_send(uint8_t op_code, uint8_t *buffer, uint8_t *patch, uint16_t data_length);
Kojto 20:30b6ed7bf8fd 1230 private:
Kojto 20:30b6ed7bf8fd 1231 cc3000_spi &_spi;
Kojto 20:30b6ed7bf8fd 1232 };
Kojto 20:30b6ed7bf8fd 1233
Kojto 31:7b6e85b68b01 1234 /** NVMEM layer
Kojto 31:7b6e85b68b01 1235 */
Kojto 20:30b6ed7bf8fd 1236 class cc3000_nvmem {
Kojto 20:30b6ed7bf8fd 1237 public:
Kojto 29:c40918cd9b6d 1238 /**
Kojto 29:c40918cd9b6d 1239 * \brief Ctor
Kojto 34:1ad18123bf11 1240 * \param hci Reference to the hci object.
Kojto 34:1ad18123bf11 1241 * \param event Reference to the event object.
Kojto 34:1ad18123bf11 1242 * \param simple_link Reference to the simple link object.
Kojto 29:c40918cd9b6d 1243 * \return none
Kojto 29:c40918cd9b6d 1244 */
Kojto 29:c40918cd9b6d 1245 cc3000_nvmem(cc3000_hci &hci, cc3000_event &event, cc3000_simple_link &simple_link);
Kojto 29:c40918cd9b6d 1246 /**
Kojto 29:c40918cd9b6d 1247 * \brief Dtor
Kojto 29:c40918cd9b6d 1248 * \param none
Kojto 29:c40918cd9b6d 1249 * \return none
Kojto 29:c40918cd9b6d 1250 */
Kojto 20:30b6ed7bf8fd 1251 ~cc3000_nvmem();
Kojto 29:c40918cd9b6d 1252 /**
Kojto 29:c40918cd9b6d 1253 * \brief Reads data from the file referred by the file_id parameter.
Kojto 29:c40918cd9b6d 1254 * Reads data from file offset till length. Err if the file can't be used,
Kojto 29:c40918cd9b6d 1255 * is invalid, or if the read is out of bounds.
Kojto 29:c40918cd9b6d 1256 * \param file_id nvmem file id.
Kojto 29:c40918cd9b6d 1257 * \param length number of bytes to read.
Kojto 29:c40918cd9b6d 1258 * \param offset offset in file from where to read.
Kojto 29:c40918cd9b6d 1259 * \param buff output buffer pointer.
Kojto 29:c40918cd9b6d 1260 * \return
Kojto 29:c40918cd9b6d 1261 * Number of bytes read, otherwise error.
Kojto 29:c40918cd9b6d 1262 */
Kojto 20:30b6ed7bf8fd 1263 int32_t read(uint32_t file_id, uint32_t length, uint32_t offset, uint8_t *buff);
Kojto 29:c40918cd9b6d 1264 /**
Kojto 29:c40918cd9b6d 1265 * \brief Write data to nvmem.
Kojto 29:c40918cd9b6d 1266 * \param file_id Nvmem file id
Kojto 29:c40918cd9b6d 1267 * \param length number of bytes to write
Kojto 29:c40918cd9b6d 1268 * \param entry_offset offset in file to start write operation from
Kojto 29:c40918cd9b6d 1269 * \param buff data to write
Kojto 29:c40918cd9b6d 1270 * \return
Kojto 29:c40918cd9b6d 1271 * On success 0, error otherwise.
Kojto 29:c40918cd9b6d 1272 */
Kojto 20:30b6ed7bf8fd 1273 int32_t write(uint32_t file_id, uint32_t length, uint32_t entry_offset, uint8_t *buff);
Kojto 29:c40918cd9b6d 1274 /**
Kojto 29:c40918cd9b6d 1275 * \brief Write MAC address to EEPROM.
Kojto 29:c40918cd9b6d 1276 * \param mac Mac address to be set
Kojto 29:c40918cd9b6d 1277 * \return
Kojto 29:c40918cd9b6d 1278 * On success 0, error otherwise.
Kojto 29:c40918cd9b6d 1279 */
Kojto 20:30b6ed7bf8fd 1280 uint8_t set_mac_address(uint8_t *mac);
Kojto 29:c40918cd9b6d 1281 /**
Kojto 29:c40918cd9b6d 1282 * \brief Read MAC address from EEPROM.
Kojto 29:c40918cd9b6d 1283 * \param mac Mac address
Kojto 29:c40918cd9b6d 1284 * \return
Kojto 33:9e23b24fb4f3 1285 * On success 0, error otherwise.
Kojto 29:c40918cd9b6d 1286 */
Kojto 20:30b6ed7bf8fd 1287 uint8_t get_mac_address(uint8_t *mac);
Kojto 29:c40918cd9b6d 1288 /**
Kojto 29:c40918cd9b6d 1289 * \brief Program a patch to a specific file ID. The SP data is assumed to be organized in 2-dimensional.
Kojto 29:c40918cd9b6d 1290 * Each line is SP_PORTION_SIZE bytes long.
Kojto 29:c40918cd9b6d 1291 * \param file_id nvmem file id/
Kojto 29:c40918cd9b6d 1292 * \param length number of bytes to write
Kojto 29:c40918cd9b6d 1293 * \param data SP data to write
Kojto 29:c40918cd9b6d 1294 * \return
Kojto 29:c40918cd9b6d 1295 * On success 0, error otherwise.
Kojto 29:c40918cd9b6d 1296 */
Kojto 20:30b6ed7bf8fd 1297 uint8_t write_patch(uint32_t file_id, uint32_t length, const uint8_t *data);
Kojto 29:c40918cd9b6d 1298 /**
Kojto 29:c40918cd9b6d 1299 * \brief Create new file entry and allocate space on the NVMEM. Applies only to user files.
Kojto 29:c40918cd9b6d 1300 * \param file_id nvmem file Id
Kojto 29:c40918cd9b6d 1301 * \param new_len entry ulLength
Kojto 29:c40918cd9b6d 1302 * \return
Kojto 29:c40918cd9b6d 1303 */
Kojto 20:30b6ed7bf8fd 1304 int32_t create_entry(uint32_t file_id, uint32_t new_len);
Kojto 20:30b6ed7bf8fd 1305 #ifndef CC3000_TINY_DRIVER
Kojto 29:c40918cd9b6d 1306 /**
Kojto 29:c40918cd9b6d 1307 * \brief Read patch version. read package version (WiFi FW patch, river-supplicant-NS patch,
Kojto 29:c40918cd9b6d 1308 * bootloader patch)
Kojto 29:c40918cd9b6d 1309 * \param patch_ver First number indicates package ID and the second number indicates
Kojto 29:c40918cd9b6d 1310 * package build number
Kojto 29:c40918cd9b6d 1311 * \return
Kojto 29:c40918cd9b6d 1312 * On success 0, error otherwise.
Kojto 29:c40918cd9b6d 1313 */
Kojto 20:30b6ed7bf8fd 1314 uint8_t read_sp_version(uint8_t* patch_ver);
Kojto 20:30b6ed7bf8fd 1315 #endif
Kojto 20:30b6ed7bf8fd 1316 private:
Kojto 20:30b6ed7bf8fd 1317 cc3000_hci &_hci;
Kojto 20:30b6ed7bf8fd 1318 cc3000_event &_event;
Kojto 20:30b6ed7bf8fd 1319 cc3000_simple_link &_simple_link;
Kojto 20:30b6ed7bf8fd 1320 };
Kojto 20:30b6ed7bf8fd 1321
Kojto 31:7b6e85b68b01 1322 /** WLAN layer
Kojto 31:7b6e85b68b01 1323 */
Kojto 20:30b6ed7bf8fd 1324 class cc3000_wlan {
Kojto 20:30b6ed7bf8fd 1325 public:
Kojto 29:c40918cd9b6d 1326 /**
Kojto 29:c40918cd9b6d 1327 * \brief Ctor
Kojto 34:1ad18123bf11 1328 * \param simple_link Reference to the simple link object.
Kojto 34:1ad18123bf11 1329 * \param event Reference to the event object.
Kojto 34:1ad18123bf11 1330 * \param spi Reference to the spi object.
Kojto 34:1ad18123bf11 1331 * \param hci Reference to the hci object.
Kojto 29:c40918cd9b6d 1332 * \return none
Kojto 29:c40918cd9b6d 1333 */
Kojto 20:30b6ed7bf8fd 1334 cc3000_wlan(cc3000_simple_link &simple_link, cc3000_event &event, cc3000_spi &spi, cc3000_hci &hci);
Kojto 29:c40918cd9b6d 1335 /**
Kojto 29:c40918cd9b6d 1336 * \brief Dtor
Kojto 29:c40918cd9b6d 1337 * \param none
Kojto 29:c40918cd9b6d 1338 * \return none
Kojto 29:c40918cd9b6d 1339 */
Kojto 20:30b6ed7bf8fd 1340 ~cc3000_wlan();
Kojto 29:c40918cd9b6d 1341 /**
Kojto 29:c40918cd9b6d 1342 * \brief Send SIMPLE LINK START to cc3000.
Kojto 29:c40918cd9b6d 1343 * \param patches_available_host Flag to indicate if patches are available.
Kojto 20:30b6ed7bf8fd 1344 * \return none
Kojto 20:30b6ed7bf8fd 1345 */
Kojto 20:30b6ed7bf8fd 1346 void simpleLink_init_start(uint16_t patches_available_host);
Kojto 29:c40918cd9b6d 1347 /**
Kojto 29:c40918cd9b6d 1348 * \brief Start wlan device. Blocking call until init is completed.
Kojto 29:c40918cd9b6d 1349 * \param patches_available_host Flag to indicate if patches are available.
Kojto 20:30b6ed7bf8fd 1350 * \return none
Kojto 20:30b6ed7bf8fd 1351 */
Kojto 20:30b6ed7bf8fd 1352 void start(uint16_t patches_available_host);
Kojto 29:c40918cd9b6d 1353 /**
Kojto 29:c40918cd9b6d 1354 * \brief Stop wlan device
Kojto 20:30b6ed7bf8fd 1355 * \param none
Kojto 20:30b6ed7bf8fd 1356 * \return none
Kojto 20:30b6ed7bf8fd 1357 */
Kojto 20:30b6ed7bf8fd 1358 void stop(void);
Kojto 20:30b6ed7bf8fd 1359 #ifndef CC3000_TINY_DRIVER
Kojto 29:c40918cd9b6d 1360 /**
Kojto 29:c40918cd9b6d 1361 * \brief Connect to AP.
Kojto 29:c40918cd9b6d 1362 * \param sec_type Security option.
Kojto 29:c40918cd9b6d 1363 * \param ssid up to 32 bytes, ASCII SSID
Kojto 29:c40918cd9b6d 1364 * \param ssid_length length of SSID
Kojto 29:c40918cd9b6d 1365 * \param b_ssid 6 bytes specified the AP bssid
Kojto 29:c40918cd9b6d 1366 * \param key up to 16 bytes specified the AP security key
Kojto 29:c40918cd9b6d 1367 * \param key_len key length
Kojto 29:c40918cd9b6d 1368 * \return
Kojto 29:c40918cd9b6d 1369 * On success, zero is returned. On error, negative is returned.
Kojto 29:c40918cd9b6d 1370 */
Kojto 20:30b6ed7bf8fd 1371 int32_t connect(uint32_t sec_type, const uint8_t *ssid, int32_t ssid_length, uint8_t *b_ssid, uint8_t *key, int32_t key_len);
Kojto 29:c40918cd9b6d 1372 /**
Kojto 29:c40918cd9b6d 1373 * \brief Add profile. Up to 7 profiles are supported.
Kojto 29:c40918cd9b6d 1374 * \param sec_type Security option.
Kojto 29:c40918cd9b6d 1375 * \param ssid Up to 32 bytes, ASCII SSID
Kojto 29:c40918cd9b6d 1376 * \param ssid_length Length of SSID
Kojto 29:c40918cd9b6d 1377 * \param b_ssid 6 bytes specified the AP bssid
Kojto 29:c40918cd9b6d 1378 * \param priority Up to 16 bytes specified the AP security key
Kojto 29:c40918cd9b6d 1379 * \param pairwise_cipher_or_tx_key_len Key length
Kojto 29:c40918cd9b6d 1380 * \param group_cipher_tx_key_index Key length for WEP security
Kojto 29:c40918cd9b6d 1381 * \param key_mgmt KEY management
Kojto 29:c40918cd9b6d 1382 * \param pf_or_key Security key
Kojto 29:c40918cd9b6d 1383 * \param pass_phrase_length Security key length for WPA\WPA2
Kojto 29:c40918cd9b6d 1384 * \return
Kojto 29:c40918cd9b6d 1385 * On success, zero is returned. On error, negative is returned.
Kojto 29:c40918cd9b6d 1386 */
Kojto 20:30b6ed7bf8fd 1387 int32_t add_profile(uint32_t sec_type, uint8_t* ssid, uint32_t ssid_length, uint8_t *b_ssid, uint32_t priority, uint32_t pairwise_cipher_or_tx_key_len, uint32_t group_cipher_tx_key_index,
Kojto 20:30b6ed7bf8fd 1388 uint32_t key_mgmt, uint8_t* pf_or_key, uint32_t pass_phrase_length);
Kojto 29:c40918cd9b6d 1389 /**
Kojto 29:c40918cd9b6d 1390 * \brief Gets entry from scan result table. The scan results are returned
Kojto 29:c40918cd9b6d 1391 * one by one, and each entry represents a single AP found in the area.
Kojto 29:c40918cd9b6d 1392 * \param scan_timeout Not supported yet
Kojto 29:c40918cd9b6d 1393 * \param results Scan result
Kojto 29:c40918cd9b6d 1394 * \return
Kojto 29:c40918cd9b6d 1395 * On success, zero is returned. On error, -1 is returned
Kojto 29:c40918cd9b6d 1396 */
Kojto 20:30b6ed7bf8fd 1397 int32_t ioctl_get_scan_results(uint32_t scan_timeout, uint8_t *results);
Kojto 29:c40918cd9b6d 1398 /**
Kojto 29:c40918cd9b6d 1399 * \brief Start and stop scan procedure. Set scan parameters.
Kojto 29:c40918cd9b6d 1400 * \param enable Start/stop application scan
Kojto 29:c40918cd9b6d 1401 * \param min_dwell_time Minimum dwell time value to be used for each channel, in ms. (Default: 20)
Kojto 29:c40918cd9b6d 1402 * \param max_dwell_time Maximum dwell time value to be used for each channel, in ms. (Default: 30)
Kojto 29:c40918cd9b6d 1403 * \param num_probe_requests Max probe request between dwell time. (Default:2)
Kojto 29:c40918cd9b6d 1404 * \param channel_mask Bitwise, up to 13 channels (0x1fff).
Kojto 29:c40918cd9b6d 1405 * \param rssi_threshold RSSI threshold. Saved: yes (Default: -80)
Kojto 29:c40918cd9b6d 1406 * \param snr_threshold NSR threshold. Saved: yes (Default: 0)
Kojto 29:c40918cd9b6d 1407 * \param default_tx_power probe Tx power. Saved: yes (Default: 205)
Kojto 29:c40918cd9b6d 1408 * \param interval_list Pointer to array with 16 entries (16 channels)
Kojto 29:c40918cd9b6d 1409 * \return
Kojto 29:c40918cd9b6d 1410 * On success, zero is returned. On error, -1 is returned.
Kojto 29:c40918cd9b6d 1411 */
Kojto 20:30b6ed7bf8fd 1412 int32_t ioctl_set_scan_params(uint32_t enable, uint32_t min_dwell_time, uint32_t max_dwell_time, uint32_t num_probe_requests,
Kojto 20:30b6ed7bf8fd 1413 uint32_t channel_mask, int32_t rssi_threshold, uint32_t snr_threshold, uint32_t default_tx_power, uint32_t *interval_list);
Kojto 29:c40918cd9b6d 1414 /**
Kojto 29:c40918cd9b6d 1415 * \brief Get wlan status: disconnected, scanning, connecting or connected
Kojto 29:c40918cd9b6d 1416 * \param none
Kojto 29:c40918cd9b6d 1417 * \return
Kojto 29:c40918cd9b6d 1418 * WLAN_STATUS_DISCONNECTED, WLAN_STATUS_SCANING, STATUS_CONNECTING or WLAN_STATUS_CONNECTED
Kojto 29:c40918cd9b6d 1419 */
Kojto 20:30b6ed7bf8fd 1420 int32_t ioctl_statusget(void);
Kojto 20:30b6ed7bf8fd 1421 #else
Kojto 29:c40918cd9b6d 1422 /**
Kojto 29:c40918cd9b6d 1423 * \brief Connect to AP
Kojto 29:c40918cd9b6d 1424 * \param ssid Up to 32 bytes and is ASCII SSID of the AP
Kojto 29:c40918cd9b6d 1425 * \param ssid_length Length of the SSID
Kojto 29:c40918cd9b6d 1426 * \return
Kojto 29:c40918cd9b6d 1427 * On success, zero is returned. On error, negative is returned.
Kojto 29:c40918cd9b6d 1428 */
Kojto 20:30b6ed7bf8fd 1429 int32_t connect(const uint8_t *ssid, int32_t ssid_length);
Kojto 29:c40918cd9b6d 1430 /**
Kojto 29:c40918cd9b6d 1431 * \brief When auto start is enabled, the device connects to station from the profiles table.
Kojto 29:c40918cd9b6d 1432 * If several profiles configured the device choose the highest priority profile.
Kojto 29:c40918cd9b6d 1433 * \param sec_type WLAN_SEC_UNSEC,WLAN_SEC_WEP,WLAN_SEC_WPA,WLAN_SEC_WPA2
Kojto 29:c40918cd9b6d 1434 * \param ssid SSID up to 32 bytes
Kojto 29:c40918cd9b6d 1435 * \param ssid_length SSID length
Kojto 29:c40918cd9b6d 1436 * \param b_ssid bssid 6 bytes
Kojto 29:c40918cd9b6d 1437 * \param priority Profile priority. Lowest priority:0.
Kojto 29:c40918cd9b6d 1438 * \param pairwise_cipher_or_tx_key_len Key length for WEP security
Kojto 29:c40918cd9b6d 1439 * \param group_cipher_tx_key_index Key index
Kojto 29:c40918cd9b6d 1440 * \param key_mgmt KEY management
Kojto 29:c40918cd9b6d 1441 * \param pf_or_key Security key
Kojto 29:c40918cd9b6d 1442 * \param pass_phrase_length Security key length for WPA\WPA2
Kojto 29:c40918cd9b6d 1443 * \return
Kojto 29:c40918cd9b6d 1444 * On success, zero is returned. On error, -1 is returned
Kojto 29:c40918cd9b6d 1445 */
Kojto 20:30b6ed7bf8fd 1446 int32_t add_profile(uint32_t sec_type, uint8_t *ssid, uint32_t ssid_length, uint8_t *b_ssid, uint32_t priority,
Kojto 20:30b6ed7bf8fd 1447 uint32_t pairwise_cipher_or_tx_key_len, uint32_t group_cipher_tx_key_index, uint32_t key_mgmt,
Kojto 20:30b6ed7bf8fd 1448 uint8_t* pf_or_key, uint32_t pass_phrase_length);
Kojto 20:30b6ed7bf8fd 1449 #endif
Kojto 20:30b6ed7bf8fd 1450 #ifndef CC3000_UNENCRYPTED_SMART_CONFIG
Kojto 29:c40918cd9b6d 1451 /**
Kojto 29:c40918cd9b6d 1452 * \brief Process the acquired data and store it as a profile.
Kojto 29:c40918cd9b6d 1453 * \param none
Kojto 29:c40918cd9b6d 1454 * \return
Kojto 29:c40918cd9b6d 1455 * On success, zero is returned. On error, -1 is returned.
Kojto 29:c40918cd9b6d 1456 */
Kojto 20:30b6ed7bf8fd 1457 int32_t smart_config_process(void);
Kojto 20:30b6ed7bf8fd 1458 #endif
Kojto 29:c40918cd9b6d 1459 /**
Kojto 29:c40918cd9b6d 1460 * \brief Disconnect connection from AP.
Kojto 29:c40918cd9b6d 1461 * \param none
Kojto 29:c40918cd9b6d 1462 * \return
Kojto 29:c40918cd9b6d 1463 * 0 if disconnected done, other CC3000 already disconnected.
Kojto 29:c40918cd9b6d 1464 */
Kojto 20:30b6ed7bf8fd 1465 int32_t disconnect();
Kojto 29:c40918cd9b6d 1466 /**
Kojto 29:c40918cd9b6d 1467 * \brief When auto is enabled, the device tries to connect according the following policy:
Kojto 29:c40918cd9b6d 1468 * 1) If fast connect is enabled and last connection is valid, the device will try to
Kojto 29:c40918cd9b6d 1469 * connect to it without the scanning procedure (fast). The last connection will be
Kojto 29:c40918cd9b6d 1470 * marked as invalid, due to adding/removing profile.
Kojto 29:c40918cd9b6d 1471 * 2) If profile exists, the device will try to connect it (Up to seven profiles).
Kojto 29:c40918cd9b6d 1472 * 3) If fast and profiles are not found, and open mode is enabled, the device
Kojto 29:c40918cd9b6d 1473 * will try to connect to any AP.
Kojto 29:c40918cd9b6d 1474 * Note that the policy settings are stored in the CC3000 NVMEM.
Kojto 29:c40918cd9b6d 1475 * \param should_connect_to_open_ap Enable(1), disable(0) connect to any available AP.
Kojto 29:c40918cd9b6d 1476 * \param use_fast_connect Enable(1), disable(0). if enabled, tries to
Kojto 29:c40918cd9b6d 1477 * connect to the last connected AP.
Kojto 29:c40918cd9b6d 1478 * \param use_profiles Enable(1), disable(0) auto connect after reset.
Kojto 29:c40918cd9b6d 1479 * and periodically reconnect if needed.
Kojto 29:c40918cd9b6d 1480 * \return
Kojto 29:c40918cd9b6d 1481 * On success, zero is returned. On error, -1 is returned
Kojto 29:c40918cd9b6d 1482 */
Kojto 20:30b6ed7bf8fd 1483 int32_t ioctl_set_connection_policy(uint32_t should_connect_to_open_ap, uint32_t use_fast_connect, uint32_t use_profiles);
Kojto 29:c40918cd9b6d 1484 /**
Kojto 29:c40918cd9b6d 1485 * \brief Delete WLAN profile
Kojto 29:c40918cd9b6d 1486 * \param index Number of profile to delete
Kojto 29:c40918cd9b6d 1487 * \return
Kojto 29:c40918cd9b6d 1488 * On success, zero is returned. On error, -1 is returned
Kojto 29:c40918cd9b6d 1489 */
Kojto 20:30b6ed7bf8fd 1490 int32_t ioctl_del_profile(uint32_t index);
Kojto 29:c40918cd9b6d 1491 /**
Kojto 29:c40918cd9b6d 1492 * \brief Mask event according to bit mask. In case that event is
Kojto 29:c40918cd9b6d 1493 * masked (1), the device will not send the masked event to host.
Kojto 29:c40918cd9b6d 1494 * \param mask event mask
Kojto 29:c40918cd9b6d 1495 * \return
Kojto 29:c40918cd9b6d 1496 * On success, zero is returned. On error, -1 is returned
Kojto 29:c40918cd9b6d 1497 */
Kojto 20:30b6ed7bf8fd 1498 int32_t set_event_mask(uint32_t mask);
Kojto 29:c40918cd9b6d 1499 /**
Kojto 29:c40918cd9b6d 1500 * \brief Start to acquire device profile. The device acquire its own
Kojto 29:c40918cd9b6d 1501 * profile, if profile message is found.
Kojto 29:c40918cd9b6d 1502 * \param encrypted_flag Indicates whether the information is encrypted
Kojto 29:c40918cd9b6d 1503 * \return
Kojto 29:c40918cd9b6d 1504 * On success, zero is returned. On error, -1 is returned.
Kojto 29:c40918cd9b6d 1505 */
Kojto 20:30b6ed7bf8fd 1506 int32_t smart_config_start(uint32_t encrypted_flag);
Kojto 29:c40918cd9b6d 1507 /**
Kojto 29:c40918cd9b6d 1508 * \brief Stop the acquire profile procedure.
Kojto 29:c40918cd9b6d 1509 * \param none
Kojto 29:c40918cd9b6d 1510 * \return
Kojto 29:c40918cd9b6d 1511 * On success, zero is returned. On error, -1 is returned
Kojto 29:c40918cd9b6d 1512 */
Kojto 20:30b6ed7bf8fd 1513 int32_t smart_config_stop(void);
Kojto 29:c40918cd9b6d 1514 /**
Kojto 29:c40918cd9b6d 1515 * \brief Configure station ssid prefix.
Kojto 29:c40918cd9b6d 1516 * \param new_prefix 3 bytes identify the SSID prefix for the Smart Config.
Kojto 29:c40918cd9b6d 1517 * \return
Kojto 29:c40918cd9b6d 1518 * On success, zero is returned. On error, -1 is returned.
Kojto 29:c40918cd9b6d 1519 */
Kojto 20:30b6ed7bf8fd 1520 int32_t smart_config_set_prefix(uint8_t *new_prefix);
Kojto 20:30b6ed7bf8fd 1521 private:
Kojto 20:30b6ed7bf8fd 1522 cc3000_simple_link &_simple_link;
Kojto 20:30b6ed7bf8fd 1523 cc3000_event &_event;
Kojto 20:30b6ed7bf8fd 1524 cc3000_spi &_spi;
Kojto 20:30b6ed7bf8fd 1525 cc3000_hci &_hci;
Kojto 20:30b6ed7bf8fd 1526 };
Kojto 20:30b6ed7bf8fd 1527
Kojto 31:7b6e85b68b01 1528 /** The main object of cc3000 implementation
Kojto 20:30b6ed7bf8fd 1529 */
Kojto 20:30b6ed7bf8fd 1530 class cc3000 {
Kojto 20:30b6ed7bf8fd 1531 public:
Kojto 29:c40918cd9b6d 1532 /** status structure */
Kojto 20:30b6ed7bf8fd 1533 typedef struct {
Kojto 29:c40918cd9b6d 1534 bool dhcp;
Kojto 29:c40918cd9b6d 1535 bool connected;
Kojto 20:30b6ed7bf8fd 1536 uint8_t socket;
Kojto 29:c40918cd9b6d 1537 bool smart_config_complete;
Kojto 29:c40918cd9b6d 1538 bool stop_smart_config;
Kojto 29:c40918cd9b6d 1539 bool dhcp_configured;
Kojto 29:c40918cd9b6d 1540 bool ok_to_shut_down;
SolderSplashLabs 39:03ac37ab34eb 1541 bool enabled;
Kojto 20:30b6ed7bf8fd 1542 } tStatus;
Kojto 29:c40918cd9b6d 1543 /**
Kojto 29:c40918cd9b6d 1544 * \brief Ctor.
Kojto 20:30b6ed7bf8fd 1545 * \param cc3000_irq IRQ pin
Kojto 20:30b6ed7bf8fd 1546 * \param cc3000_en Enable pin
Kojto 20:30b6ed7bf8fd 1547 * \param cc3000_cs Chip select pin
Kojto 20:30b6ed7bf8fd 1548 * \param cc3000_spi SPI interface
Kojto 20:30b6ed7bf8fd 1549 * \param irq_port IRQ pin's port
Kojto 20:30b6ed7bf8fd 1550 */
Kojto 20:30b6ed7bf8fd 1551 cc3000(PinName cc3000_irq, PinName cc3000_en, PinName cc3000_cs, SPI cc3000_spi, IRQn_Type irq_port);
Kojto 29:c40918cd9b6d 1552 /**
Kojto 29:c40918cd9b6d 1553 * \brief Dtor.
Kojto 20:30b6ed7bf8fd 1554 */
Kojto 20:30b6ed7bf8fd 1555 ~cc3000();
Kojto 29:c40918cd9b6d 1556 /**
Kojto 29:c40918cd9b6d 1557 * \brief Initiate cc3000. It starts the wlan communication and deletes profiles.
Kojto 20:30b6ed7bf8fd 1558 * \param patch Patch
Kojto 20:30b6ed7bf8fd 1559 */
Kojto 20:30b6ed7bf8fd 1560 void start(uint8_t patch);
Kojto 29:c40918cd9b6d 1561 /**
Kojto 29:c40918cd9b6d 1562 * \brief Stops the wlan communication.
Kojto 20:30b6ed7bf8fd 1563 */
Kojto 20:30b6ed7bf8fd 1564 void stop();
Kojto 29:c40918cd9b6d 1565 /**
Kojto 29:c40918cd9b6d 1566 * \brief Restarts the wlan communication.
Kojto 20:30b6ed7bf8fd 1567 */
Kojto 20:30b6ed7bf8fd 1568 void restart(uint8_t patch);
Kojto 29:c40918cd9b6d 1569 /**
Kojto 29:c40918cd9b6d 1570 * \brief Disconnect wlan device
Kojto 20:30b6ed7bf8fd 1571 *
Kojto 20:30b6ed7bf8fd 1572 */
Kojto 20:30b6ed7bf8fd 1573 bool disconnect(void);
Kojto 29:c40918cd9b6d 1574 /**
Kojto 29:c40918cd9b6d 1575 * \brief Callback which is called from the event class. This updates status of cc3000.
Kojto 20:30b6ed7bf8fd 1576 * \param event_type Type of the event
Kojto 20:30b6ed7bf8fd 1577 * \param data Pointer to data
Kojto 20:30b6ed7bf8fd 1578 * \param length Length of data
Kojto 20:30b6ed7bf8fd 1579 * \return none
Kojto 20:30b6ed7bf8fd 1580 */
Kojto 20:30b6ed7bf8fd 1581 void usync_callback(int32_t event_type, uint8_t *data, uint8_t length);
Kojto 29:c40918cd9b6d 1582 /**
SolderSplashLabs 39:03ac37ab34eb 1583 * \brief Start connection to SSID (open/secured) non-blocking
SolderSplashLabs 39:03ac37ab34eb 1584 * \param ssid SSID name
SolderSplashLabs 39:03ac37ab34eb 1585 * \param key Security key (if key = 0, open connection)
SolderSplashLabs 39:03ac37ab34eb 1586 * \param security_mode Security mode
SolderSplashLabs 39:03ac37ab34eb 1587 * \return true if connection was established, false otherwise.
SolderSplashLabs 39:03ac37ab34eb 1588 */
SolderSplashLabs 39:03ac37ab34eb 1589 bool connect_non_blocking(const uint8_t *ssid, const uint8_t *key, int32_t security_mode);
SolderSplashLabs 39:03ac37ab34eb 1590 /**
SolderSplashLabs 39:03ac37ab34eb 1591 * \brief Connect to SSID (open/secured) with timeout (10s).
Kojto 20:30b6ed7bf8fd 1592 * \param ssid SSID name
Kojto 20:30b6ed7bf8fd 1593 * \param key Security key (if key = 0, open connection)
Kojto 20:30b6ed7bf8fd 1594 * \param security_mode Security mode
Kojto 20:30b6ed7bf8fd 1595 * \return true if connection was established, false otherwise.
Kojto 20:30b6ed7bf8fd 1596 */
Kojto 20:30b6ed7bf8fd 1597 bool connect_to_AP(const uint8_t *ssid, const uint8_t *key, int32_t security_mode);
Kojto 29:c40918cd9b6d 1598 /**
Kojto 29:c40918cd9b6d 1599 * \brief Connect to SSID which is secured
Kojto 20:30b6ed7bf8fd 1600 * \param ssid SSID name
Kojto 20:30b6ed7bf8fd 1601 * \param key Security key
Kojto 20:30b6ed7bf8fd 1602 * \param security_mode Security mode
Kojto 20:30b6ed7bf8fd 1603 * \return true if connection was established, false otherwise.
Kojto 20:30b6ed7bf8fd 1604 */
Kojto 20:30b6ed7bf8fd 1605 bool connect_secure(const uint8_t *ssid, const uint8_t *key, int32_t security_mode);
Kojto 29:c40918cd9b6d 1606 /**
Kojto 29:c40918cd9b6d 1607 * \brief Connect to SSID which is open (no security)
Kojto 20:30b6ed7bf8fd 1608 * \param ssid SSID name
Kojto 20:30b6ed7bf8fd 1609 * \return true if connection was established, false otherwise.
Kojto 20:30b6ed7bf8fd 1610 */
Kojto 20:30b6ed7bf8fd 1611 bool connect_open(const uint8_t *ssid);
Kojto 29:c40918cd9b6d 1612 /**
SolderSplashLabs 39:03ac37ab34eb 1613 * \brief Status of the cc3000 module.
SolderSplashLabs 39:03ac37ab34eb 1614 * \return true if it's enabled, false otherwise.
SolderSplashLabs 39:03ac37ab34eb 1615 */
SolderSplashLabs 39:03ac37ab34eb 1616 bool is_enabled();
SolderSplashLabs 39:03ac37ab34eb 1617 /**
Kojto 29:c40918cd9b6d 1618 * \brief Status of the cc3000 connection.
Kojto 20:30b6ed7bf8fd 1619 * \return true if it's connected, false otherwise.
Kojto 20:30b6ed7bf8fd 1620 */
Kojto 20:30b6ed7bf8fd 1621 bool is_connected();
Kojto 29:c40918cd9b6d 1622 /**
Kojto 29:c40918cd9b6d 1623 * \brief Status of DHCP.
Kojto 20:30b6ed7bf8fd 1624 * \param none
Kojto 20:30b6ed7bf8fd 1625 * \return true if DCHP is configured, false otherwise.
Kojto 20:30b6ed7bf8fd 1626 */
Kojto 20:30b6ed7bf8fd 1627 bool is_dhcp_configured();
Kojto 29:c40918cd9b6d 1628 /**
Kojto 29:c40918cd9b6d 1629 * \brief Status of smart confing completation.
Kojto 20:30b6ed7bf8fd 1630 * \param none
Kojto 20:30b6ed7bf8fd 1631 * \return smart config was set, false otherwise.
Kojto 20:30b6ed7bf8fd 1632 */
Kojto 20:30b6ed7bf8fd 1633 bool is_smart_confing_completed();
Kojto 29:c40918cd9b6d 1634 /**
Kojto 29:c40918cd9b6d 1635 * \brief Return the cc3000's mac address.
Kojto 20:30b6ed7bf8fd 1636 * \param address Retreived mac address.
Kojto 20:30b6ed7bf8fd 1637 * \return
Kojto 20:30b6ed7bf8fd 1638 */
Kojto 20:30b6ed7bf8fd 1639 uint8_t get_mac_address(uint8_t address[6]);
Kojto 29:c40918cd9b6d 1640 /**
Kojto 29:c40918cd9b6d 1641 * \brief Set the cc3000's mac address.
Kojto 29:c40918cd9b6d 1642 * \param address Mac address to be set.
Kojto 20:30b6ed7bf8fd 1643 * \return
Kojto 20:30b6ed7bf8fd 1644 */
Kojto 20:30b6ed7bf8fd 1645 uint8_t set_mac_address(uint8_t address[6]);
Kojto 29:c40918cd9b6d 1646 /**
Kojto 29:c40918cd9b6d 1647 * \brief Get user file info.
Kojto 29:c40918cd9b6d 1648 * \param info_file Pointer where info will be stored.
Kojto 29:c40918cd9b6d 1649 * \param size Available size.
Kojto 20:30b6ed7bf8fd 1650 * \return none
Kojto 20:30b6ed7bf8fd 1651 */
Kojto 20:30b6ed7bf8fd 1652 void get_user_file_info(uint8_t *info_file, size_t size);
Kojto 29:c40918cd9b6d 1653 /**
Kojto 29:c40918cd9b6d 1654 * \brief Set user filo info.
Kojto 29:c40918cd9b6d 1655 * \param info_file Pointer to user's info.
Kojto 20:30b6ed7bf8fd 1656 * \return none
Kojto 20:30b6ed7bf8fd 1657 */
Kojto 20:30b6ed7bf8fd 1658 void set_user_file_info(uint8_t *info_file, size_t size);
Kojto 29:c40918cd9b6d 1659 /**
Kojto 29:c40918cd9b6d 1660 * \brief Start smart config.
Kojto 29:c40918cd9b6d 1661 * \param smart_config_key Pointer to smart config key.
Kojto 20:30b6ed7bf8fd 1662 * \return none
Kojto 20:30b6ed7bf8fd 1663 */
Kojto 20:30b6ed7bf8fd 1664 void start_smart_config(const uint8_t *smart_config_key); /* TODO enable AES ? */
Kojto 20:30b6ed7bf8fd 1665 #ifndef CC3000_TINY_DRIVER
Kojto 29:c40918cd9b6d 1666 /**
Kojto 29:c40918cd9b6d 1667 * \brief Return ip configuration.
Kojto 29:c40918cd9b6d 1668 * \param ip_config Pointer to ipconfig data.
Kojto 29:c40918cd9b6d 1669 * \return true if it's connected and info was retrieved, false otherwise.
Kojto 20:30b6ed7bf8fd 1670 */
Kojto 20:30b6ed7bf8fd 1671 bool get_ip_config(tNetappIpconfigRetArgs *ip_config);
Kojto 20:30b6ed7bf8fd 1672 #endif
Kojto 29:c40918cd9b6d 1673 /**
Kojto 33:9e23b24fb4f3 1674 * \brief Delete all stored profiles.
Kojto 29:c40918cd9b6d 1675 * \param none
Kojto 20:30b6ed7bf8fd 1676 * \return none
Kojto 20:30b6ed7bf8fd 1677 */
Kojto 20:30b6ed7bf8fd 1678 void delete_profiles(void);
Kojto 20:30b6ed7bf8fd 1679 /**
Kojto 33:9e23b24fb4f3 1680 * \brief Ping an ip address.
Kojto 29:c40918cd9b6d 1681 * \param ip Destination IP address
Kojto 29:c40918cd9b6d 1682 * \param attempts Number of attempts
Kojto 29:c40918cd9b6d 1683 * \param timeout Time to wait for a response,in milliseconds.
Kojto 29:c40918cd9b6d 1684 * \param size Send buffer size which may be up to 1400 bytes
Kojto 20:30b6ed7bf8fd 1685 */
Kojto 20:30b6ed7bf8fd 1686 uint32_t ping(uint32_t ip, uint8_t attempts, uint16_t timeout, uint8_t size);
Kojto 29:c40918cd9b6d 1687 /**
Kojto 33:9e23b24fb4f3 1688 * \brief Returns cc3000 instance. Used in Socket interface.
Kojto 29:c40918cd9b6d 1689 * \param none
Kojto 29:c40918cd9b6d 1690 * \return Pointer to cc3000 object
Kojto 29:c40918cd9b6d 1691 */
Kojto 20:30b6ed7bf8fd 1692 static cc3000 *get_instance() {
Kojto 20:30b6ed7bf8fd 1693 return _inst;
Kojto 20:30b6ed7bf8fd 1694 }
Kojto 44:960b73df5981 1695 #if (CC3000_ETH_COMPAT == 1)
SolderSplashLabs 39:03ac37ab34eb 1696 /**
Kojto 44:960b73df5981 1697 * \brief Get the MAC address of your Ethernet interface.
Kojto 44:960b73df5981 1698 * \param none
Kojto 44:960b73df5981 1699 * \return
Kojto 44:960b73df5981 1700 * Pointer to a string containing the MAC address.
SolderSplashLabs 39:03ac37ab34eb 1701 */
SolderSplashLabs 39:03ac37ab34eb 1702 char* getMACAddress();
SolderSplashLabs 39:03ac37ab34eb 1703
SolderSplashLabs 39:03ac37ab34eb 1704 /**
Kojto 44:960b73df5981 1705 * \brief Get the IP address of your Ethernet interface.
Kojto 44:960b73df5981 1706 * \param none
Kojto 44:960b73df5981 1707 * \return
Kojto 44:960b73df5981 1708 * Pointer to a string containing the IP address.
SolderSplashLabs 39:03ac37ab34eb 1709 */
SolderSplashLabs 39:03ac37ab34eb 1710 char* getIPAddress();
SolderSplashLabs 39:03ac37ab34eb 1711
SolderSplashLabs 39:03ac37ab34eb 1712 /**
Kojto 44:960b73df5981 1713 * \brief Get the Gateway address of your Ethernet interface
Kojto 44:960b73df5981 1714 * \param none
Kojto 44:960b73df5981 1715 * \return
Kojto 44:960b73df5981 1716 * Pointer to a string containing the Gateway address
SolderSplashLabs 39:03ac37ab34eb 1717 */
SolderSplashLabs 39:03ac37ab34eb 1718 char* getGateway();
SolderSplashLabs 39:03ac37ab34eb 1719
SolderSplashLabs 39:03ac37ab34eb 1720 /**
Kojto 44:960b73df5981 1721 * \brief Get the Network mask of your Ethernet interface
Kojto 44:960b73df5981 1722 * \param none
Kojto 44:960b73df5981 1723 * \return
Kojto 44:960b73df5981 1724 * Pointer to a string containing the Network mask
SolderSplashLabs 39:03ac37ab34eb 1725 */
SolderSplashLabs 39:03ac37ab34eb 1726 char* getNetworkMask();
SolderSplashLabs 39:03ac37ab34eb 1727 #endif
Kojto 20:30b6ed7bf8fd 1728 public:
Kojto 20:30b6ed7bf8fd 1729 cc3000_simple_link _simple_link;
Kojto 20:30b6ed7bf8fd 1730 cc3000_event _event;
Kojto 20:30b6ed7bf8fd 1731 #ifndef CC3000_UNENCRYPTED_SMART_CONFIG
Kojto 20:30b6ed7bf8fd 1732 cc3000_security _security;
Kojto 20:30b6ed7bf8fd 1733 #endif
Kojto 20:30b6ed7bf8fd 1734 cc3000_socket _socket;
Kojto 20:30b6ed7bf8fd 1735 cc3000_spi _spi;
Kojto 20:30b6ed7bf8fd 1736 cc3000_hci _hci;
Kojto 20:30b6ed7bf8fd 1737 cc3000_nvmem _nvmem;
Kojto 20:30b6ed7bf8fd 1738 cc3000_netapp _netapp;
Kojto 20:30b6ed7bf8fd 1739 cc3000_wlan _wlan;
Kojto 20:30b6ed7bf8fd 1740 protected:
Kojto 20:30b6ed7bf8fd 1741 static cc3000 *_inst;
Kojto 20:30b6ed7bf8fd 1742 private:
Kojto 20:30b6ed7bf8fd 1743 tStatus _status;
Kojto 20:30b6ed7bf8fd 1744 netapp_pingreport_args_t _ping_report;
Kojto 20:30b6ed7bf8fd 1745 bool _closed_sockets[MAX_SOCKETS];
Kojto 20:30b6ed7bf8fd 1746 };
Kojto 20:30b6ed7bf8fd 1747
Kojto 20:30b6ed7bf8fd 1748 /**
Kojto 29:c40918cd9b6d 1749 * Copy 32 bit to stream while converting to little endian format.
Kojto 29:c40918cd9b6d 1750 * @param p pointer to the new stream
Kojto 29:c40918cd9b6d 1751 * @param u32 pointer to the 32 bit
Kojto 29:c40918cd9b6d 1752 * @return pointer to the new stream
Kojto 29:c40918cd9b6d 1753 */
Kojto 20:30b6ed7bf8fd 1754 uint8_t *UINT32_TO_STREAM_f (uint8_t *p, uint32_t u32);
Kojto 20:30b6ed7bf8fd 1755
Kojto 20:30b6ed7bf8fd 1756 /**
Kojto 29:c40918cd9b6d 1757 * Copy 16 bit to stream while converting to little endian format.
Kojto 29:c40918cd9b6d 1758 * @param p pointer to the new stream
Kojto 29:c40918cd9b6d 1759 * @param u32 pointer to the 16 bit
Kojto 29:c40918cd9b6d 1760 * @return pointer to the new stream
Kojto 29:c40918cd9b6d 1761 */
Kojto 20:30b6ed7bf8fd 1762 uint8_t *UINT16_TO_STREAM_f (uint8_t *p, uint16_t u16);
Kojto 20:30b6ed7bf8fd 1763
Kojto 20:30b6ed7bf8fd 1764 /**
Kojto 29:c40918cd9b6d 1765 * Copy received stream to 16 bit in little endian format.
Kojto 29:c40918cd9b6d 1766 * @param p pointer to the stream
Kojto 29:c40918cd9b6d 1767 * @param offset offset in the stream
Kojto 29:c40918cd9b6d 1768 * @return pointer to the new 16 bit
Kojto 29:c40918cd9b6d 1769 */
Kojto 20:30b6ed7bf8fd 1770 uint16_t STREAM_TO_UINT16_f(uint8_t* p, uint16_t offset);
Kojto 20:30b6ed7bf8fd 1771
Kojto 20:30b6ed7bf8fd 1772 /**
Kojto 29:c40918cd9b6d 1773 * Copy received stream to 32 bit in little endian format.
Kojto 29:c40918cd9b6d 1774 * @param p pointer to the stream
Kojto 29:c40918cd9b6d 1775 * @param offset offset in the stream
Kojto 29:c40918cd9b6d 1776 * @return pointer to the new 32 bit
Kojto 29:c40918cd9b6d 1777 */
Kojto 20:30b6ed7bf8fd 1778 uint32_t STREAM_TO_UINT32_f(uint8_t* p, uint16_t offset);
Kojto 20:30b6ed7bf8fd 1779
Kojto 20:30b6ed7bf8fd 1780 } /* end of mbed_cc3000 namespace */
Kojto 20:30b6ed7bf8fd 1781
Kojto 20:30b6ed7bf8fd 1782
Kojto 20:30b6ed7bf8fd 1783 #endif