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):
  • 1 byte for the First time config parameter (Useful when connecting).
  • 2 bytes for the PatchProgrammer version.
  • 2 bytes for the Service Pack version (used in the PatchProgrammer code).
  • 3 bytes for the Driver Version (used in the PatchProgrammer code).
  • 3 bytes for the Firmware Version (used in the PatchProgrammer code).
  • 1 byte for CIK validation.
  • 40 bytes for the CIK data (Client Interface Key - used with the exosite).

Using the Library¶

A user API is needed to access the CC3000 functions.
PatchProgrammer and CC3000_Simple_Socket are examples of how the user API is implemented.

Using the library with other processors¶

cc3000_common.cpp loads the KL25Z_irq_proirities tool:

#include "KL25Z_irq_prio.h"

For another processor, the user needs to create a library similar to KL25Z_irq_proirities, while keeping the function name NVIC_SetAllPriority the same. To facilitate the change, use this file as a template and add/remove the necessary NVIC_SetPriority calls.

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


// Wlan controls
#define WLAN_ISF_PCR        PORTA->PCR[16] // PTA16
#define WLAN_ISF_ISFR       PORTA->ISFR    // Interrupt flag register
#define WLAN_ISF_MASK       (1<<16)        // bit to clear PTA16 irq

#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     NVIC_EnableIRQ(PORTA_IRQn);
#define WLAN_DISABLE_IRQ    NVIC_DisableIRQ(PORTA_IRQn);

#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