Driver for CC3000 Wi-Fi module
Dependencies: NVIC_set_all_priorities
Dependents: CC3000_Simple_Socket Wi-Go_IOT_Demo
Information
The current code has been reworked to a full object oriented application and contains an mbed socket compatible API.
CC3000 Wi-Fi module library
Info
This is the low level driver for TI's SimpleLink CC3000 device.
Port from Avnet's Wi-Go KEIL code (based on TI's CC3000 code).
Special thanks to Jim Carver from Avnet for providing the Wi-Go board and for his assistance.
Differences with TI's original code
The code functionality stays exactly the same.
In order to make it easier to use the code, following changes were made :
- Addition of a tool to shift all IRQ priorities to a lower level since it is very important to keep the SPI handler at the highest system priority, the WLAN interrupt the second highest and all other system interrupts at a lower priority, so their handlers can be preempted by the CC3000 interrupts.
- Addition of low level I/O controls and conditional compiler controls in cc3000_common.h.
- CC3000 initialisation, pin declarations, SPI and WLAN irq priorities are set in
Init_HostDriver
, we need to call this function at the start of the main function. - The SPI and HCI code are joined into one file.
- The include list has been rearranged - Only
#include "wlan.h"
is needed in the user API.
- Part of the CC3000's user eeprom memory is used to store additional info (52 bytes in NVMEM_USER_FILE_1):
# bytes | Description | Info |
1 | First time config parameter | Useful when connecting |
2 | Firmware updater version | used with the Firmware update tool |
2 | Service Pack version | used with the Firmware update tool |
3 | Driver Version | used with the Firmware update tool |
3 | Firmware Version | used with the Firmware update tool |
1 | CIK validation (Client Interface Key) | |
40 | CIK data (Client Interface Key) | used with the exosite |
Using the Library
A user API is needed to access the CC3000 functions.
Examples:
- Internet Of Things full WiGo demo (SmartConfig - WebServer - Exosite - Android sensor Fusion App)
- CC3000_Simple_Socket
Using the library with other processors
cc3000_common.cpp
loads the irq tool for all targets:
All current mbed targets are supported by this library.
#include "NVIC_set_all_priorities.h"
All low level settings that need to change are available in cc3000_common.h
//***************************************************************************** // PIN CONTROLS & COMPILE CONTROLS //***************************************************************************** // Compiler control #define CC3000_UNENCRYPTED_SMART_CONFIG // No encryption //#define CC3000_TINY_DRIVER // Driver for small memory model CPUs //Interrupt controls #define NVIC_ALL_IRQ NVIC_set_all_irq_priorities(3); // Set ALL interrupt priorities to level 3 #define NVIC_SPI_IRQ NVIC_SetPriority(SPI0_IRQn, 0x0); // Wi-Fi SPI interrupt must be higher priority than SysTick #define NVIC_PORT_IRQ NVIC_SetPriority(PORTA_IRQn, 0x1); #define NVIC_SYSTICK_IRQ NVIC_SetPriority(SysTick_IRQn, 0x2); // SysTick set to lower priority than Wi-Fi SPI bus interrupt //#define NVIC_ADC_IRQ NVIC_SetPriority(ADC0_IRQn, 0x3); // ADC is the lowest of all // Wlan controls #define WLAN_ISF_PCR PORTA->PCR[16] #define WLAN_ISF_ISFR PORTA->ISFR #define WLAN_ISF_MASK (1<<16) #define WLAN_ASSERT_CS wlan_cs = 0; //CS : active low #define WLAN_DEASSERT_CS wlan_cs = 1; #define WLAN_ASSERT_EN wlan_en = 1; //EN : active high #define WLAN_DEASSERT_EN wlan_en = 0; #define WLAN_READ_IRQ wlan_int #define WLAN_ENABLE_IRQ wlan_int.fall(&WLAN_IRQHandler); #define WLAN_DISABLE_IRQ wlan_int.fall(NULL); #define WLAN_IRQ_PIN_CREATE InterruptIn wlan_int (PTA16); #define WLAN_EN_PIN_CREATE DigitalOut wlan_en (PTA13); #define WLAN_CS_PIN_CREATE DigitalOut wlan_cs (PTD0); #define WLAN_SPI_PORT_CREATE SPI wlan(PTD2, PTD3, PTC5); // mosi, miso, sclk #define WLAN_SPI_PORT_INIT wlan.format(8,1); #define WLAN_SPI_SET_FREQ wlan.frequency(12000000); #define WLAN_SPI_SET_IRQ_HANDLER wlan_int.fall(&WLAN_IRQHandler); #define WLAN_SPI_WRITE wlan.write(*data++); #define WLAN_SPI_READ wlan.write(0x03); // !! DO NOT MODIFY the 0x03 parameter (CC3000 will not respond).
API documentation
Due to a little problem with the links on the mbed site, the API documentation is not directly accessible (will be solved in a next release).
Currently, it is only accessible by adding modules.html
to the API doc link: http://mbed.org/users/frankvnk/code/CC3000_Hostdriver/docs/tip/modules.html
Diff: evnt_handler.cpp
- Revision:
- 4:d8255a5aad46
- Parent:
- 3:3818c9c7b14e
- Child:
- 6:d733efcc2c56
--- a/evnt_handler.cpp Sat Jul 13 13:12:46 2013 +0000 +++ b/evnt_handler.cpp Mon Jul 15 14:19:46 2013 +0000 @@ -32,103 +32,22 @@ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * *****************************************************************************/ -//***************************************************************************** -// -//! \addtogroup evnt_handler_api -//! @{ -// -//****************************************************************************** - -//****************************************************************************** -// INCLUDE FILES -//****************************************************************************** #include "evnt_handler.h" //***************************************************************************** -// COMMON DEFINES -//***************************************************************************** - -#define FLOW_CONTROL_EVENT_HANDLE_OFFSET (0) -#define FLOW_CONTROL_EVENT_BLOCK_MODE_OFFSET (1) -#define FLOW_CONTROL_EVENT_FREE_BUFFS_OFFSET (2) -#define FLOW_CONTROL_EVENT_SIZE (4) - -#define BSD_RSP_PARAMS_SOCKET_OFFSET (0) -#define BSD_RSP_PARAMS_STATUS_OFFSET (4) - -#define GET_HOST_BY_NAME_RETVAL_OFFSET (0) -#define GET_HOST_BY_NAME_ADDR_OFFSET (4) - -#define ACCEPT_SD_OFFSET (0) -#define ACCEPT_RETURN_STATUS_OFFSET (4) -#define ACCEPT_ADDRESS__OFFSET (8) - -#define SL_RECEIVE_SD_OFFSET (0) -#define SL_RECEIVE_NUM_BYTES_OFFSET (4) -#define SL_RECEIVE__FLAGS__OFFSET (8) - - -#define SELECT_STATUS_OFFSET (0) -#define SELECT_READFD_OFFSET (4) -#define SELECT_WRITEFD_OFFSET (8) -#define SELECT_EXFD_OFFSET (12) - - -#define NETAPP_IPCONFIG_IP_OFFSET (0) -#define NETAPP_IPCONFIG_SUBNET_OFFSET (4) -#define NETAPP_IPCONFIG_GW_OFFSET (8) -#define NETAPP_IPCONFIG_DHCP_OFFSET (12) -#define NETAPP_IPCONFIG_DNS_OFFSET (16) -#define NETAPP_IPCONFIG_MAC_OFFSET (20) -#define NETAPP_IPCONFIG_SSID_OFFSET (26) - -#define NETAPP_IPCONFIG_IP_LENGTH (4) -#define NETAPP_IPCONFIG_MAC_LENGTH (6) -#define NETAPP_IPCONFIG_SSID_LENGTH (32) - - -#define NETAPP_PING_PACKETS_SENT_OFFSET (0) -#define NETAPP_PING_PACKETS_RCVD_OFFSET (4) -#define NETAPP_PING_MIN_RTT_OFFSET (8) -#define NETAPP_PING_MAX_RTT_OFFSET (12) -#define NETAPP_PING_AVG_RTT_OFFSET (16) - -#define GET_SCAN_RESULTS_TABlE_COUNT_OFFSET (0) -#define GET_SCAN_RESULTS_SCANRESULT_STATUS_OFFSET (4) -#define GET_SCAN_RESULTS_ISVALID_TO_SSIDLEN_OFFSET (8) -#define GET_SCAN_RESULTS_FRAME_TIME_OFFSET (10) -#define GET_SCAN_RESULTS_SSID_MAC_LENGTH (38) - - - -//***************************************************************************** // GLOBAL VARAIABLES //***************************************************************************** - unsigned long socket_active_status = SOCKET_STATUS_INIT_VAL; //***************************************************************************** // Prototypes for the static functions //***************************************************************************** - static long hci_event_unsol_flowcontrol_handler(char *pEvent); - static void update_socket_active_status(char *resp_params); -//***************************************************************************** -// -//! hci_unsol_handle_patch_request -//! -//! @param event_hdr event header -//! -//! @return none -//! -//! @brief Handle unsolicited event from type patch request -// -//***************************************************************************** void hci_unsol_handle_patch_request(char *event_hdr) { char *params = (char *)(event_hdr) + HCI_EVENT_HEADER_SIZE; @@ -144,14 +63,12 @@ if (patch) { -// ----------------------------- printf("HCI_EVENT_PATCHES_DRV_REQ\n"); hci_patch_send(HCI_EVENT_PATCHES_DRV_REQ, tSLInformation.pucTxCommandBuffer, patch, ucLength); return; } } // Send 0 length Patches response event -// ----------------------------- printf("HCI_EVENT_PATCHES_DRV_REQ - NULL\n"); hci_patch_send(HCI_EVENT_PATCHES_DRV_REQ, tSLInformation.pucTxCommandBuffer, 0, 0); break; @@ -164,25 +81,19 @@ // Build and send a patch if (patch) { -// ----------------------------- printf("HCI_EVENT_PATCHES_FW_REQ\n"); hci_patch_send(HCI_EVENT_PATCHES_FW_REQ, tSLInformation.pucTxCommandBuffer, patch, ucLength); return; } } // Send 0 length Patches response event -// ----------------------------- printf("HCI_EVENT_PATCHES_FW_REQ - NULL\n"); -//printf("HEPFR %04X\n",HCI_EVENT_PATCHES_FW_REQ); -//printf("pucTCB %04X\n",*tSLInformation.pucTxCommandBuffer); hci_patch_send(HCI_EVENT_PATCHES_FW_REQ, tSLInformation.pucTxCommandBuffer, 0, 0); -//printf("HEPFR-E\n"); break; case HCI_EVENT_PATCHES_BOOTLOAD_REQ: if (tSLInformation.sBootLoaderPatches) { -// ----------------------------- printf("HCI_EVENT_PATCHES_BOOTLOAD_REQ\n"); patch = tSLInformation.sBootLoaderPatches(&ucLength); if (patch) { @@ -192,30 +103,12 @@ } // Send 0 length Patches response event -// ----------------------------- printf("HCI_EVENT_PATCHES_BOOTLOAD_REQ - NULL\n"); hci_patch_send(HCI_EVENT_PATCHES_BOOTLOAD_REQ, tSLInformation.pucTxCommandBuffer, 0, 0); break; } } - -//***************************************************************************** -// -//! hci_event_handler -//! -//! @param pRetParams incoming data buffer -//! @param from from information (in case of data received) -//! @param fromlen from information length (in case of data received) -//! -//! @return none -//! -//! @brief Parse the incoming events packets and issues corresponding -//! event handler from global array of handlers pointers -// -//***************************************************************************** - - unsigned char *hci_event_handler(void *pRetParams, unsigned char *from, unsigned char *fromlen) { unsigned char *pucReceivedData, ucArgsize; @@ -225,27 +118,20 @@ unsigned long retValue32; unsigned char * RecvParams; unsigned char *RetParams; -// unsigned long tout_cnt = 0; while (1) { if (tSLInformation.usEventOrDataReceived != 0) { pucReceivedData = (tSLInformation.pucReceivedData); -// ----------------------------- if((*((char *)(pucReceivedData) + HCI_EVENT_HEADER_SIZE)) == HCI_EVENT_PATCHES_FW_REQ) -// ----------------------------- printf("%02X\n",tSLInformation.usEventOrDataReceived); -// ----------------------------- printf("pucReceivedData : %04X\n",*pucReceivedData); - if (*pucReceivedData == HCI_TYPE_EVNT) { // Event Received -//printf("STREAM - usReceivedEventOpcode : %04X\n",usReceivedEventOpcode); STREAM_TO_UINT16((char *)pucReceivedData, HCI_EVENT_OPCODE_OFFSET,usReceivedEventOpcode); pucReceivedParams = pucReceivedData + HCI_EVENT_HEADER_SIZE; -//printf("STREAM - usReceivedEventOpcode : %04X\n",usReceivedEventOpcode); RecvParams = pucReceivedParams; RetParams = (unsigned char *)pRetParams; - // In case unsolicited event received - here the handling finished + // unsolicited event received - finish handling if (hci_unsol_event_handler((char *)pucReceivedData) == 0) { STREAM_TO_UINT8(pucReceivedData, HCI_DATA_LENGTH_OFFSET, usLength); @@ -417,9 +303,6 @@ } } -// ----------------------------- printf(" REO : %04X\n",usReceivedEventOpcode); -// ----------------------------- printf("RxREO : %04X\n",tSLInformation.usRxEventOpcode); - if (usReceivedEventOpcode == tSLInformation.usRxEventOpcode) { tSLInformation.usRxEventOpcode = 0; @@ -447,83 +330,22 @@ tSLInformation.usEventOrDataReceived = 0; - SpiResumeSpi(); + tSLInformation.WlanInterruptEnable(); // Since we are going to TX - we need to handle this event after the ResumeSPi since we need interrupts if ((*pucReceivedData == HCI_TYPE_EVNT) && (usReceivedEventOpcode == HCI_EVNT_PATCHES_REQ)) { -// ----------------------------- printf("HUHPR\n"); - hci_unsol_handle_patch_request((char *)pucReceivedData); -//int we = wlan_en; -//int wc = wlan_cs; -//int wi = tSLInformation.ReadWlanInterruptPin(); //wlan_int -//printf("%02X %02X %02X\n",we, wc, wi); -//printf("%02X %02X \n",tSLInformation.usRxEventOpcode,tSLInformation.usRxDataPending); } -//if((*((char *)(pucReceivedData) + HCI_EVENT_HEADER_SIZE)) == HCI_EVENT_PATCHES_FW_REQ) -//printf("%02X\n",tSLInformation.usEventOrDataReceived); -//printf("%02X %02X\n",tSLInformation.usRxEventOpcode,tSLInformation.usRxDataPending); -//Re-enable printf in IRQ -//tSLInformation.usEventOrDataReceived is at least once = 1 for all previous calls, why not for HCI_EVENT_PATCHES_FW_REQ? -//compare with original code (uVision - add printfs in evnt_handler and try to find out where/how tSLInformation.usEventOrDataReceived is modified) -//call hci_unsolicited_event_handler in hci_unsol_handle_patch_request?? -//try no-systick modifs in Jim's V3.1?? -//Is the latest original TI code working?? if ((tSLInformation.usRxEventOpcode == 0) && (tSLInformation.usRxDataPending == 0)) { -// ----------------------------- printf("EXIT\n"); return NULL; } -/* -//Check if interrupts are still active : -//When we enable this code, an interrupt is detected - read back = R 10 : 02 00 FF 00 00 00 00 00 00 00 -// should be = R 10 : 02 00 00 00 05 04 00 40 01 00 -//Perhaps the last write (HCI_EVENT_PATCHES_FW_REQ) was incorrect? -if(((*((char *)(pucReceivedData) + HCI_EVENT_HEADER_SIZE)) == HCI_EVENT_PATCHES_FW_REQ) && (wlan_cs == 1)) -{ -wlan_cs = 0; -}*/ } - -//if(*((char *)(pucReceivedData) + HCI_EVENT_HEADER_SIZE) == HCI_EVENT_PATCHES_FW_REQ) && () -/*tout_cnt++; -if(((*((char *)(pucReceivedData) + HCI_EVENT_HEADER_SIZE)) == HCI_EVENT_PATCHES_FW_REQ) && (tout_cnt > 25000000)) -{ - printf("ERROR\n"); - int we = wlan_en; - int wc = wlan_cs; - int wi = tSLInformation.ReadWlanInterruptPin(); //wlan_int - printf("tSLInformation.usRxEventOpcode : %04X\n",tSLInformation.usRxEventOpcode); - printf("tSLInformation.usRxDataPending : %u\n",tSLInformation.usRxDataPending); - printf("WLAN int pin : %u\n",wi); - printf("WLAN en pin : %u\n",we); - printf("WLAN cs pin : %u\n",wc); - printf("*(pucReceivedData + HCI_EVENT_HEADER_SIZE) : %04X\n",*(pucReceivedData + HCI_EVENT_HEADER_SIZE)); - printf("usReceivedEventOpcode : %04X\n",usReceivedEventOpcode); - printf("pucReceivedData : %04X\n",*pucReceivedData); - printf("HCI_EVENT_HEADER_SIZE : %02X\n",HCI_EVENT_HEADER_SIZE); - printf("HCI_EVENT_PATCHES_FW_REQ : %02X\n",HCI_EVENT_PATCHES_FW_REQ); - printf("HCI_TYPE_EVNT : %02X\n",HCI_TYPE_EVNT); - printf("HCI_EVNT_PATCHES_REQ : %02X\n\n",HCI_EVNT_PATCHES_REQ); - while(1){} -}*/ -//printf("."); } } -//***************************************************************************** -// -//! hci_unsol_event_handler -//! -//! @param event_hdr event header -//! -//! @return 1 if event supported and handled -//! 0 if event is not supported -//! -//! @brief Handle unsolicited events -// -//***************************************************************************** + long hci_unsol_event_handler(char *event_hdr) { char * data = NULL; @@ -648,23 +470,11 @@ return(0); } -//***************************************************************************** -// -//! hci_unsolicited_event_handler -//! -//! @param None -//! -//! @return ESUCCESS if successful, EFAIL if an error occurred -//! -//! @brief Parse the incoming unsolicited event packets and issues -//! corresponding event handler. -// -//***************************************************************************** + long hci_unsolicited_event_handler(void) { - unsigned long res = 0; + unsigned long res = 0; unsigned char *pucReceivedData; -// ----------------------------- printf("UEH\n"); if (tSLInformation.usEventOrDataReceived != 0) { pucReceivedData = (tSLInformation.pucReceivedData); @@ -672,34 +482,23 @@ if (*pucReceivedData == HCI_TYPE_EVNT) { - // In case unsolicited event received - here the handling finished + // unsolicited event received - finish handling if (hci_unsol_event_handler((char *)pucReceivedData) == 1) { - // There was an unsolicited event received - we can release the buffer - // and clean the event received + // An unsolicited event was received: + // release the buffer and clean the event received tSLInformation.usEventOrDataReceived = 0; res = 1; - SpiResumeSpi(); + tSLInformation.WlanInterruptEnable(); } } } return res; } -//***************************************************************************** -// -//! set_socket_active_status -//! -//! @param Sd -//! @param Status -//! @return none -//! -//! @brief Check if the socket ID and status are valid and set -//! accordingly the global socket status -// -//***************************************************************************** + void set_socket_active_status(long Sd, long Status) { if(M_IS_VALID_SD(Sd) && M_IS_VALID_STATUS(Status)) @@ -710,19 +509,6 @@ } -//***************************************************************************** -// -//! hci_event_unsol_flowcontrol_handler -//! -//! @param pEvent pointer to the string contains parameters for IPERF -//! @return ESUCCESS if successful, EFAIL if an error occurred -//! -//! @brief Called in case unsolicited event from type -//! HCI_EVNT_DATA_UNSOL_FREE_BUFF has received. -//! Keep track on the number of packets transmitted and update the -//! number of free buffer in the SL device. -// -//***************************************************************************** long hci_event_unsol_flowcontrol_handler(char *pEvent) { @@ -748,16 +534,6 @@ return(ESUCCESS); } -//***************************************************************************** -// -//! get_socket_active_status -//! -//! @param Sd Socket IS -//! @return Current status of the socket. -//! -//! @brief Retrieve socket status -// -//***************************************************************************** long get_socket_active_status(long Sd) { @@ -768,16 +544,7 @@ return SOCKET_STATUS_INACTIVE; } -//***************************************************************************** -// -//! update_socket_active_status -//! -//! @param resp_params Socket IS -//! @return Current status of the socket. -//! -//! @brief Retrieve socket status -// -//***************************************************************************** + void update_socket_active_status(char *resp_params) { long status, sd; @@ -792,48 +559,16 @@ } -//***************************************************************************** -// -//! SimpleLinkWaitEvent -//! -//! @param usOpcode command operation code -//! @param pRetParams command return parameters -//! -//! @return none -//! -//! @brief Wait for event, pass it to the hci_event_handler and -//! update the event opcode in a global variable. -// -//***************************************************************************** - void SimpleLinkWaitEvent(unsigned short usOpcode, void *pRetParams) { -//printf("SLWE-I\n"); // In the blocking implementation the control to caller will be returned only // after the end of current transaction tSLInformation.usRxEventOpcode = usOpcode; hci_event_handler(pRetParams, 0, 0); -//printf("SLWE-E\n"); } -//***************************************************************************** -// -//! SimpleLinkWaitData -//! -//! @param pBuf data buffer -//! @param from from information -//! @param fromlen from information length -//! -//! @return none -//! -//! @brief Wait for data, pass it to the hci_event_handler -//! and update in a global variable that there is -//! data to read. -// -//***************************************************************************** -void -SimpleLinkWaitData(unsigned char *pBuf, unsigned char *from, unsigned char *fromlen) +void SimpleLinkWaitData(unsigned char *pBuf, unsigned char *from, unsigned char *fromlen) { // In the blocking implementation the control to caller will be returned only // after the end of current transaction, i.e. only after data will be received @@ -841,13 +576,3 @@ hci_event_handler(pBuf, from, fromlen); } -//***************************************************************************** -// -// Close the Doxygen group. -//! @} -// -//***************************************************************************** - - - -