CC3000_Hostdriver - Driver for CC3000 Wi-Fi module

Users » frankvnk » Code » CC3000_Hostdriver

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:

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: netapp.h

Revision:: 5:854f9b13a0f9
Parent:: 4:d8255a5aad46
Child:: 6:d733efcc2c56

--- a/netapp.h	Mon Jul 15 14:19:46 2013 +0000
+++ b/netapp.h	Mon Jul 15 19:54:53 2013 +0000
@@ -41,6 +41,13 @@
 #include "evnt_handler.h"
 #include "nvmem.h"
 
+//*****************************************************************************
+//
+//! \addtogroup netapp
+//! @{
+//
+//*****************************************************************************
+
 /** CC3000 Host driver - netapp
 *
 */
@@ -96,8 +103,8 @@
 
 /**
 * Configure device MAC address and store it in NVMEM. 
-* The value of the MAC address configured through the API will be
-* stored in CC3000 non volatile memory, thus preserved over resets.
+* The value of the MAC address configured through the API will be\n
+* stored in CC3000 non volatile memory, thus preserved over resets.\n
 * @param  mac   device mac address, 6 bytes. Saved: yes 
 * @return       return on success 0, otherwise error.
 */
@@ -105,62 +112,62 @@
 
 /**
 * Configure the network interface, static or dynamic (DHCP).
-* In order to activate DHCP mode, aucIP, aucSubnetMask, aucDefaultGateway must be 0.
-* The default mode of CC3000 is DHCP mode. The configuration is saved in non volatile memory
-* and thus preserved over resets.
+* In order to activate DHCP mode, aucIP, aucSubnetMask, aucDefaultGateway must be 0.\n
+* The default mode of CC3000 is DHCP mode. The configuration is saved in non volatile memory\n
+* and thus preserved over resets.\n
 * @param  aucIP               device mac address, 6 bytes. Saved: yes 
 * @param  aucSubnetMask       device mac address, 6 bytes. Saved: yes 
 * @param  aucDefaultGateway   device mac address, 6 bytes. Saved: yes 
 * @param  aucDNSServer        device mac address, 6 bytes. Saved: yes 
 * @return       0 on success, otherwise error.
-* @note         If the mode is altered, a reset of CC3000 device is required to apply the changes.
-*               Also note that an asynchronous event of type 'DHCP_EVENT' is generated only when
-*               a connection to the AP was established. This event is generated when an IP address
-*               is allocated either by the DHCP server or by static allocation.
+* @note         If the mode is altered, a reset of CC3000 device is required to apply the changes.\n
+*               Also note that an asynchronous event of type 'DHCP_EVENT' is generated only when\n
+*               a connection to the AP was established. This event is generated when an IP address\n
+*               is allocated either by the DHCP server or by static allocation.\n
 */
 extern long netapp_dhcp(unsigned long *aucIP, unsigned long *aucSubnetMask,unsigned long *aucDefaultGateway, unsigned long *aucDNSServer);
 
 /**
 * Set new timeout values for DHCP lease timeout, ARP  refresh timeout, keepalive event timeout and socket inactivity timeout 
-* @param  aucDHCP    DHCP lease time request, also impact 
-*                    the DHCP renew timeout.
-*                    Range:               [0-0xffffffff] seconds,
-*                                         0 or 0xffffffff = infinite lease timeout.
-*                    Resolution:          10 seconds.
-*                    Influence:           only after reconnecting to the AP. 
-*                    Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 seconds.
-*                    The parameter is saved into the CC3000 NVMEM. 
-*                    The default value on CC3000 is 14400 seconds.
+* @param  aucDHCP    DHCP lease time request, also impact\n 
+*                    the DHCP renew timeout.\n
+*                    Range:               [0-0xffffffff] seconds,\n
+*                                         0 or 0xffffffff = infinite lease timeout.\n
+*                    Resolution:          10 seconds.\n
+*                    Influence:           only after reconnecting to the AP. \n
+*                    Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 seconds.\n
+*                    The parameter is saved into the CC3000 NVMEM.\n 
+*                    The default value on CC3000 is 14400 seconds.\n
 *
-* @param  aucARP     ARP refresh timeout, if ARP entry is not updated by
-*                    incoming packet, the ARP entry will be  deleted by
-*                    the end of the timeout. 
-*                    Range:               [0-0xffffffff] seconds, 0 = infinite ARP timeout
-*                    Resolution:          10 seconds.
-*                    Influence:           at runtime.
-*                    Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 seconds
-*                    The parameter is saved into the CC3000 NVMEM. 
-*                    The default value on CC3000 is 3600 seconds.
+* @param  aucARP     ARP refresh timeout, if ARP entry is not updated by\n
+*                    incoming packet, the ARP entry will be  deleted by\n
+*                    the end of the timeout. \n
+*                    Range:               [0-0xffffffff] seconds, 0 = infinite ARP timeout\n
+*                    Resolution:          10 seconds.\n
+*                    Influence:           at runtime.\n
+*                    Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 seconds\n
+*                    The parameter is saved into the CC3000 NVMEM.\n 
+*                    The default value on CC3000 is 3600 seconds.\n
 *
-* @param  aucKeepalive   Keepalive event sent by the end of keepalive timeout
-*                        Range:               [0-0xffffffff] seconds, 0 == infinite timeout
-*                        Resolution:          10 seconds.
-*                        Influence:           at runtime.
-*                        Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 sec
-*                        The parameter is saved into the CC3000 NVMEM. 
-*                        The default value on CC3000 is 10 seconds.
+* @param  aucKeepalive   Keepalive event sent by the end of keepalive timeout\n
+*                        Range:               [0-0xffffffff] seconds, 0 == infinite timeout\n
+*                        Resolution:          10 seconds.\n
+*                        Influence:           at runtime.\n
+*                        Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 sec\n
+*                        The parameter is saved into the CC3000 NVMEM. \n
+*                        The default value on CC3000 is 10 seconds.\n
 *
-* @param  aucInactivity   Socket inactivity timeout, socket timeout is
-*                         refreshed by incoming or outgoing packet, by the
-*                         end of the socket timeout the socket will be closed
-*                         Range:               [0-0xffffffff] sec, 0 == infinite timeout.
-*                         Resolution:          10 seconds.
-*                         Influence:           at runtime.
-*                         Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 sec
-*                         The parameter is saved into the CC3000 NVMEM. 
-*                         The default value on CC3000 is 60 seconds.
+* @param  aucInactivity   Socket inactivity timeout, socket timeout is\n
+*                         refreshed by incoming or outgoing packet, by the\n
+*                         end of the socket timeout the socket will be closed\n
+*                         Range:               [0-0xffffffff] sec, 0 == infinite timeout.\n
+*                         Resolution:          10 seconds.\n
+*                         Influence:           at runtime.\n
+*                         Minimal bound value: MIN_TIMER_VAL_SECONDS - 20 sec\n
+*                         The parameter is saved into the CC3000 NVMEM.\n 
+*                         The default value on CC3000 is 60 seconds.\n
 *
-* @return 0 on success 0,otherwise error.
+* @return 0 on success,otherwise error.
 *
 * @note   A parameter set to a non zero value less than 20s automatically changes to 20s.
 */
@@ -176,8 +183,8 @@
 * @param  pingTimeout     Time to wait for a response,in milliseconds.
 * @return 0 on success, otherwise error.
 *
-* @note     A succesful operation will generate an asynchronous ping report event.
-*           The report structure is defined by structure netapp_pingreport_args_t.
+* @note     A succesful operation will generate an asynchronous ping report event.\n
+*           The report structure is defined by structure netapp_pingreport_args_t.\n
 * @warning  Calling this function while a Ping Request is in progress will kill the ping request in progress.
 */
 #ifndef CC3000_TINY_DRIVER
@@ -195,15 +202,15 @@
 #endif
 
 /**
-* Ping status request. This API triggers the CC3000 to send 
-* asynchronous events: HCI_EVNT_WLAN_ASYNC_PING_REPORT.
-* This event will create the report structure in netapp_pingreport_args_t.
-* This structure is filled with ping results until the API is triggered.
-* netapp_pingreport_args_t: packets_sent     - echo sent
-*                           packets_received - echo reply
-*                           min_round_time   - minimum round time
-*                           max_round_time   - max round time
-*                           avg_round_time   - average round time
+* Ping status request.
+* This API triggers the CC3000 to send asynchronous events: HCI_EVNT_WLAN_ASYNC_PING_REPORT.\n
+* This event will create the report structure in netapp_pingreport_args_t.\n
+* This structure is filled with ping results until the API is triggered.\n
+* netapp_pingreport_args_t: packets_sent     - echo sent\n
+*                           packets_received - echo reply\n
+*                           min_round_time   - minimum round time\n
+*                           max_round_time   - max round time\n
+*                           avg_round_time   - average round time\n
 *
 * @param   none
 * @return  none
@@ -216,20 +223,20 @@
 
 /**
 * Get the CC3000 Network interface information.
-* This information is only available after establishing a WLAN connection.
-* Undefined values are returned when this function is called before association.
-* @param[out]  ipconfig  pointer to a tNetappIpconfigRetArgs structure for storing the network interface configuration.
-*                        tNetappIpconfigRetArgs: aucIP             - ip address,
+* This information is only available after establishing a WLAN connection.\n
+* Undefined values are returned when this function is called before association.\n
+* @param[out]  ipconfig  pointer to a tNetappIpconfigRetArgs structure for storing the network interface configuration.\n
+*                        tNetappIpconfigRetArgs: aucIP             - ip address,\n
 *                                                aucSubnetMask     - mask
-*                                                aucDefaultGateway - default gateway address
-*                                                aucDHCPServer     - dhcp server address
-*                                                aucDNSServer      - dns server address
-*                                                uaMacAddr         - mac address
-*                                                uaSSID            - connected AP ssid
+*                                                aucDefaultGateway - default gateway address\n
+*                                                aucDHCPServer     - dhcp server address\n
+*                                                aucDNSServer      - dns server address\n
+*                                                uaMacAddr         - mac address\n
+*                                                uaSSID            - connected AP ssid\n
 * @return  none
-* @note    This function is useful for figuring out the IP Configuration of
-*          the device when DHCP is used and for figuring out the SSID of
-*          the Wireless network the device is associated with.
+* @note    This function is useful for figuring out the IP Configuration of\n
+*          the device when DHCP is used and for figuring out the SSID of\n
+*          the Wireless network the device is associated with.\n
 */
 extern void netapp_ipconfig( tNetappIpconfigRetArgs * ipconfig );
 
@@ -248,6 +255,13 @@
 }
 #endif // __cplusplus
 
+//*****************************************************************************
+//
+// Close the Doxygen group.
+//! @}
+//
+//*****************************************************************************
+
 #endif    // __NETAPP_H__

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	28 Jun 2013
Imports:	120
Forks:	0
Commits:	14
Dependents:	2
Dependencies:	1
Followers:	9
Issues:	0

The code in this repository is Apache licensed.

Components

SimpleLink Wi-Fi CC3000