Modules | Files | Functions
The TI CC2538 System-on-Chip

CPU-Specific functionality - available to all cc2538-based platforms. More...


 CC2538 Built-In Sensors
 Module controlling sensors on the CC2538 SoC (Tmp and VDD3)
 CC2538 Cortex-M3
 CC2538 Cortex-M3 CMSIS definitions.
 CC2538 GPIO HAL implementation
 CC2538 PWM driver
 Driver for the CC2538 PWM on GPTIMER.
 CC2538 master interrupt manipulation
 Master interrupt manipulation routines for the CC2538 CPU.
 cc2538 ADC
 Driver for the cc2538 ADC controller.
 cc2538 ADC and RNG
 Register declarations for the cc2538 ADC and H/W RNG.
 cc2538 AES/SHA cryptoprocessor
 Driver for the cc2538 AES/SHA cryptoprocessor.
 cc2538 CPU
 CPU-specific functions for the cc2538 core.
 cc2538 Clock
 Implementation of the clock module for the cc2538.
 cc2538 Coffee port module
 Module for the cc2538 Coffee port.
 cc2538 General-Purpose I/O
 Driver for the cc2538 GPIO controller.
 cc2538 General-Purpose Timers
 Driver for the cc2538 General Purpose Timers.
 cc2538 I/O Control
 Driver for the cc2538 I/O Control Module.
 cc2538 I2C Control
 cc2538 I2C Control Module
 cc2538 IEEE Address Control
 Driver for the retrieval of an IEEE address from flash.
 cc2538 Low Power Modes
 Driver for the cc2538 power modes.
 cc2538 Nested Vectored Interrupt Controller
 Driver for the cc2538 NVIC controller.
 cc2538 PKA engine
 Driver for the cc2538 PKA engine.
 cc2538 RF Core
 Declarations of RF Core registers.
 cc2538 RF Driver
 Driver implementation for the cc2538 RF transceiver.
 cc2538 ROM utility function library
 Driver for the cc2538 ROM utility function library.
 cc2538 Random Number Generator
 Driver for the cc2538 Hardware Random Number Generator.
 cc2538 Register Manipulation
 Macros for hardware access, both direct and via the bit-band region.
 cc2538 Sleep Timer and Watchdog
 Register declarations for the cc2538 Sleep Timer and Watchdog.
 cc2538 SoC
 Driver for the cc2538 SoC.
 cc2538 Synchronous Serial Interface
 Driver for the cc2538 SPI peripheral.
 cc2538 System Control (SysCtrl)
 Driver for the cc2538 System Control Module.
 cc2538 UART
 Driver for the cc2538 UART controller.
 cc2538 USB controller
 Driver for the cc2538 USB controller.
 cc2538 family of devices
 Definitions for the cc2538 family of devices.
 cc2538 flash memory
 Definitions for the cc2538 flash memory.
 cc2538 micro-DMA
 Driver for the cc2538 uDMA controller.
 cc2538 rtimer
 Implementation of the rtimer module for the cc2538.
 cc2538 watchdog timer driver
 Driver for the cc2538 Watchdog Timer.


file  startup-gcc.c
 Startup code for the cc2538 chip, to be used when building with gcc.


void clock_isr (void)
 The clock Interrupt Service Routine. More...
void rtimer_isr (void)
 The rtimer ISR. More...
void cc2538_rf_rx_tx_isr (void)
 The cc2538 RF RX/TX ISR. More...
void cc2538_rf_err_isr (void)
 The cc2538 RF Error ISR. More...
void crypto_isr (void)
 The AES/SHA cryptoprocessor ISR. More...
void pka_isr (void)
 The PKA engine ISR. More...

CFS configuration


CC2538 System Control configuration

 Use the on-board 32.768-kHz crystal.

Watchdog Timer configuration

 Enable the watchdog timer.

USB 'core' configuration

Those values are not meant to be modified by the user, except where stated otherwise

#define CTRL_EP_SIZE   8
#define USB_EP1_SIZE   32
#define USB_EP2_SIZE   64
#define USB_EP3_SIZE   64
#define USB_ARCH_CONF_DMA   1
 Change to Enable/Disable USB DMA.

uDMA Configuration and channel allocations

 USB -> RAM DMA channel.
 RAM -> USB DMA channel.
#define CC2538_RF_CONF_TX_DMA_CHAN   2
 RF -> RAM DMA channel.
#define CC2538_RF_CONF_RX_DMA_CHAN   3
 RAM -> RF DMA channel.

Character I/O Configuration

#define UART_CONF_ENABLE   1
 Enable/Disable UART I/O.
#define UART0_CONF_BAUD_RATE   115200
 Default UART0 baud rate.
#define UART1_CONF_BAUD_RATE   115200
 Default UART1 baud rate.
#define SLIP_ARCH_CONF_USB   0
 SLIP over UART by default.
#define DBG_CONF_USB   0
 All debugging over UART by default.
 UART to use with serial line.
 UART to use with SLIP.
#define DBG_CONF_UART   0
 UART to use for debugging.
#define UART1_CONF_UART   0
 UART to use for examples relying on the uart1_* API.
#define CC2538_CONF_QUIET   0
 Define this as 1 to build a headless node. More...
 Enable the USB core only if we need it.
#define UART_IN_USE_BY_SLIP(u)
#define UART_IN_USE_BY_DBG(u)   (!DBG_CONF_USB && DBG_CONF_UART == (u))
#define UART_IN_USE_BY_UART1(u)   (UART1_CONF_UART == (u))
#define UART_IN_USE(u)

RF configuration

#define CC2538_RF_CONF_AUTOACK   1
 RF H/W generates ACKs.
#define CC2538_RF_CONF_TX_USE_DMA   1
 RF TX over DMA.
#define CC2538_RF_CONF_RX_USE_DMA   1
 RF RX over DMA.

LPM configuration

#define LPM_CONF_ENABLE   1
 Set to 0 to disable LPM entirely.
#define LPM_CONF_MAX_PM   1
 Maximum PM. More...
#define LPM_CONF_STATS   0
 Set to 1 to enable LPM-related stats.

Radio Configuration

#define NETSTACK_CONF_RADIO   cc2538_rf_driver

IEEE address configuration

Used to generate our link-layer & IPv6 address

 Location of the IEEE address 0 => Read from InfoPage, 1 => Use a hardcoded address, configured by IEEE_ADDR_CONF_ADDRESS.
#define IEEE_ADDR_CONF_ADDRESS   { 0x00, 0x12, 0x4B, 0x00, 0x89, 0xAB, 0xCD, 0xEF }
 The hardcoded IEEE address to be used when IEEE_ADDR_CONF_HARDCODED is defined as 1.
 Location of the IEEE address in the InfoPage when IEEE_ADDR_CONF_HARDCODED is defined as 0 0 => Use the primary address location 1 => Use the secondary address location.


#define CRYPTO_CONF_INIT   1
 Whether to init cryptoprocessor.
#define AES_128_CONF   cc2538_aes_128_driver
 AES-128 driver.
#define CCM_STAR_CONF   cc2538_ccm_star_driver
 AES-CCM* driver.

Detailed Description

CPU-Specific functionality - available to all cc2538-based platforms.

Macro Definition Documentation


#define CC2538_CONF_QUIET   0

Define this as 1 to build a headless node.

The UART will not be initialised its clock will be gated, offering some energy savings. The USB will not be initialised either

Definition at line 165 of file cc2538-conf.h.


#define LPM_CONF_MAX_PM   1

Maximum PM.

The SoC will never drop to a Power Mode deeper than the one specified here. 0 for PM0, 1 for PM1 and 2 for PM2

Definition at line 251 of file cc2538-conf.h.

Function Documentation

◆ cc2538_rf_err_isr()

void cc2538_rf_err_isr ( void  )

The cc2538 RF Error ISR.

This is the interrupt service routine for all RF errors. We acknowledge every error type and instead of trying to be smart and act differently depending on error condition, we simply reset the transceiver. RX FIFO overflow is an exception, we ignore this error since read() handles it anyway.

However, we don't want to reset within this ISR. If the error occurs while we are reading a frame out of the FIFO, trashing the FIFO in the middle of read(), would result in further errors (RX underflows).

Instead, we set a flag and poll the driver process. The process will reset the transceiver without any undesirable consequences.

Definition at line 1188 of file cc2538-rf.c.

◆ cc2538_rf_rx_tx_isr()

void cc2538_rf_rx_tx_isr ( void  )

The cc2538 RF RX/TX ISR.

This is the interrupt service routine for all RF interrupts relating to RX and TX. Error conditions are handled by cc2538_rf_err_isr(). Currently, we only acknowledge the FIFOP interrupt source.

Definition at line 1161 of file cc2538-rf.c.

◆ clock_isr()

void clock_isr ( void  )

The clock Interrupt Service Routine.

It polls the etimer process if an etimer has expired. It also updates the software clock tick and seconds counter.

Definition at line 242 of file clock.c.

References update_ticks().

◆ crypto_isr()

void crypto_isr ( void  )

The AES/SHA cryptoprocessor ISR.

This is the interrupt service routine for the AES/SHA cryptoprocessor.

This ISR is called at worst from PM0, so lpm_exit() does not need to be called.

Definition at line 59 of file crypto.c.

References AES_IRQn, NVIC_ClearPendingIRQ(), and NVIC_DisableIRQ().

◆ pka_isr()

void pka_isr ( void  )

The PKA engine ISR.

This is the interrupt service routine for the PKA engine.

This ISR is called at worst from PM0, so lpm_exit() does not need to be called.

Definition at line 62 of file pka.c.

References NVIC_ClearPendingIRQ(), NVIC_DisableIRQ(), and PKA_IRQn.

◆ rtimer_isr()

void rtimer_isr ( void  )

The rtimer ISR.

Interrupts are only turned on when we have an rtimer task to schedule Once the interrupt fires, the task is called and then interrupts no longer get acknowledged until the next task needs scheduled.

Definition at line 136 of file rtimer-arch.c.