Contiki-NG
Loading...
Searching...
No Matches
board.h File Reference
Hardware support » Platforms » TI CC2538-powered platforms » Zolertia Zoul-based platforms » Zolertia Zoul platforms » RE-Mote platform revision A

Header file with definitions related to the I/O connections on the Zolertia's RE-Mote platform (revision A), cc2538-based. More...

#include "dev/gpio.h"
#include "dev/nvic.h"

Go to the source code of this file.

Macros

RE-Mote LED configuration

LEDs on the RE-Mote are connected as follows:

  • LED1 (Red) -> PD5
  • LED2 (Green) -> PD4
  • LED3 (Blue) -> PD3

LED1 pin shared with EXT_WDT and exposed in JP6 connector LED2 pin shared with UART1 CTS, pin exposed in JP6 connector LED3 pin shared with UART1 RTS, exposed in JP6 connector

UART configuration

On the RE-Mote, the UARTs are connected to the following ports/pins:

  • UART0:
    • RX: PA0, connected to CP2104 serial-to-usb converter TX pin
    • TX: PA1, connected to CP2104 serial-to-usb converter RX pin
  • UART1:
    • RX: PC1
    • TX: PC0
    • CTS: PD4, shared with LED2 (Green), disabled as default
    • RTS: PD3, shared with LED3 (Blue), disabled as default

We configure the port to use UART0 and UART1, CTS/RTS only for UART1, both without a HW pull-up resistor UART0 and UART1 pins are exposed over the JP6 connector

ADC configuration

These values configure which CC2538 pins and ADC channels to use for the ADC inputs.

By default the RE-Mote allows two out-of-the-box ADC ports with a phidget-like 3-pin connector (GND/VDD/ADC)

The RE-Mote allows both 3.3V and 5V analogue sensors as follow:

  • ADC1: up to 3.3V.
  • ADC2: up to 3.3V, shared with RTC_INT
  • ADC3: up to 5V, by means of a 2/3 voltage divider.

Also there are other ADC channels shared by default with Micro SD card and user button implementations:

  • ADC4: up to 3.3V.
  • ADC5: up to 3.3V.
  • ADC6: up to 3.3V.

ADC inputs can only be on port A. All ADCx are exposed in JP5 connector, but only ADC1 and ADC3 have GND and VDD (3/5V) pins next to it, so these can be exposed into a 3-pin phidget-like connector, for ADC2 either solder a wire to connect, or use a 4-pin connector to expose both ADC1 and ADC2 in a single connector, but this will leave no space for a ADC3 connector. The internal ADC reference is 1190mV, use either a voltage divider as input, or a different voltage reference, like AVDD5 or other externally (AIN7), but note the PA7 is shared with the Micro-SD CSn pin, likewise for PA6 (AIN6) shared witht the Micro-SD select pin To use the ADC2 pin, remove the resistor on the Zoul's PA4 pin (JP1, pin 10) and enable below (replace -1 with 4).

#define ADC_SENSORS_PORT   GPIO_A_NUM
 ADC GPIO control port.
 
#define ADC_SENSORS_ADC1_PIN   5
 ADC1 to PA5, 3V3

 
#define ADC_SENSORS_ADC3_PIN   2
 ADC3 to PA2, 5V

 
#define ADC_SENSORS_ADC2_PIN   (-1)
 ADC2 no declared

 
#define ADC_SENSORS_ADC4_PIN   (-1)
 ADC4 not declared

 
#define ADC_SENSORS_ADC5_PIN   (-1)
 ADC5 not declared

 
#define ADC_SENSORS_ADC6_PIN   (-1)
 ADC6 not declared

 
#define ADC_SENSORS_MAX   2
 Maximum sensors

 
RE-Mote Button configuration

Buttons on the RE-Mote are connected as follows:

  • BUTTON_USER -> PA3, S1 user button, shared with bootloader and RTC_INT1
  • BUTTON_RESET -> RESET_N line, S2 reset both CC2538 and CoP
  • BUTTON_PIC1W -> shared with SHUTDOWN_ENABLE, not mounted.
#define BUTTON_USER_PORT   GPIO_A_NUM
 BUTTON_USER -> PA3.
 
SPI (SSI0) configuration

These values configure which CC2538 pins to use for the SPI (SSI0) lines, reserved exclusively for the CC1200 RF transceiver.

These pins are not exposed to any connector, and should be avoid to use it. TX -> MOSI, RX -> MISO

SPI (SSI1) configuration

These values configure which CC2538 pins to use for the SPI (SSI1) lines, shared with the microSD and exposed over JP5 connector.

It is advisable to use a CSn pin other than the Micro-SD's. TX -> MOSI, RX -> MISO

I2C configuration

These values configure which CC2538 pins to use for the I2C lines, exposed over JP6 connector, also available as testpoints T2 (PC2) and T3 (PC3).

The I2C bus is shared with the on-board RTC. The I2C is exposed over the JP6 header, using a 5-pin connector with 2.54 mm spacing, providing also D+3.3V, GND and a generic pin that can be used as an interrupt pin

Antenna switch configuration

These values configure the required pin to drive the RF antenna switch, to either enable the sub-1Ghz RF interface (power-up the CC1200) or the 2.4GHz RF interface of the CC2538, both alternatively routed to a RP-SMA connector to allow using an external antenna for both cases.

Note it is also possible to enable both RF interfaces at the same time, by switching On the sub-1GHz RF interface, and placing an 0Ohm resistor (R19), to select between using a ceramic chip antenna (not mounted), or to connect and external antenna over a pigtail to the U.Fl connector (not mounted).

RF switch state:

  • LOW: 2.4GHz RF interface on RP-SMA connector, CC1200 powered-off.
  • HIGH: Sub-1GHz RF interface on RP-SMA connector.
Dual RF interface support

Enables support for dual band operation (both CC1200 and 2.4GHz enabled).

The driver checks the selected Radio stack, and forces the antenna switch to either position. Enabling the definition below forces to skip this check.

CC1200 configuration

These values configure the required pins to drive the CC1200 None of the following pins are exposed to any connector, kept for internal use only

microSD configuration

These values configure the required pins to drive the built-in microSD external module, to be used with SSI1

Power management and shutdown mode

The shutdown mode is an ultra-low power operation mode that effectively powers-down the entire RE-Mote (CC2538, CC1200, attached sensors, etc) and only keeps running a power gating timer (NanoTimer), the on-board RTC and an ultra-low power consumption MCU (PIC12F635).

The Shutdown mode allows:

  • Put the RE-Mote in an ultra-low power sleep (shutdown) drawing <200nA avg.
  • Periodically awake and execute tasks, being the shutdown period selectable via R47 resistor value (22KOhm as default for 1 minute shutdown period).
  • Enter shutdown mode before the shutdown period expiration, by invoking the PM_SHUTDOWN_NOW macrp

The shutdown mode can be disabled by hardware by short-circuiting or placing an 0Ohm resistor across W1 pad.

On-board RTC

The shutdown mode can be disabled by hardware by short-circuiting or placing an 0Ohm resistor across W1 pad.

As the RTC_INT1 pin is also shared with the BUTTON_USER, so either disable or not use the user button, or upon receiving an interrupt, poll the RTC.

The RTC_INT1 can be used to exit the CC2538's LPM3 mode. A second interruption pin is connected to the PIC12F635, for applications requiring to put the PIC into deep-sleep and waking up at a certain time.

On-board external WDT

The RE-Mote features an on-board external WDT and battery monitor, which adds more robustness and prevents the mote to run wild if any unexpected problem shows-up.

The external WDT requires a short pulse (<1ms) to be sent before a 2-second period. The battery monitor keeps the device in Reset if the voltage input is lower than 2.5V. The external WDT can be disabled by removing the R40 0Ohm resistor. The EXT_WDT pin is shared with LED1 (Red). For long-time operation, it is advised to remove R14 resistor to disable LED1. As default the Texas Instrument's TPS3823 WDT is not mounted.

Device string used on startup

Detailed Description

Header file with definitions related to the I/O connections on the Zolertia's RE-Mote platform (revision A), cc2538-based.

Note
Do not include this file directly. It gets included by contiki-conf after all relevant directives have been set.

Definition in file board.h.