Zoul: added new Firefly revision A

platform/zoul/firefly-reva/Makefile.firefly-reva

@@ -0,0 +1,2 @@
+MOTELIST_ZOLERTIA = firefly
+BOARD_SOURCEFILES += board.c leds-arch.c

platform/zoul/firefly-reva/README.md

@@ -0,0 +1,41 @@
+Zolertia Firefly Revision A platform
+============================================
+
+![Zolertia Firefly Revision A breakout board][firefly-reva]
+
+The Firefly is a breakout board designed to inspire.
+
+It exposes the most basic Zoul features, sporting only the most down-to-core features to work with the Zoul, providing the following:
+
+* ARM Cortex-M3 with 512KB flash and 32KB RAM (16KB retention), 32MHz.
+* ISM 2.4-GHz IEEE 802.15.4 & Zigbee compliant.
+* ISM 868-, 915-, 920-, 950-MHz ISM/SRD Band.
+* On-board printed PCB sub-1GHz antenna and 2.4Ghz ceramic chip antenna.
+* AES-128/256, SHA2 Hardware Encryption Engine.
+* ECC-128/256, RSA Hardware Acceleration Engine for Secure Key Exchange.
+* Compatible with breadboards and protoboards.
+* On-board CP2104/PIC to flash over USB-A connector.
+* User and reset buttons.
+* RGB LED to allow more than 7 colour combinations.
+* Small form factor (68.78 x 25.80mm).
+
+The Firefly can be seen as the "small brother" of the RE-Mote, with a slick design and a lower cost.
+
+To work out of the box, the firefly includes a PCB antenna for the Sub-1GHz interface, and a ceramic chip antenna for the 2.4GHz radio interface.  Optionally 2 x u.Fl connectors for 2.4GHz and sub-1GHz external antennas can be mounted.
+
+The firefly can be programmed and debugged over JTAG and USB.  The board has a CP2104 USB to serial converter with a PIC, it allows to program the CC2538 without having to manually to put the device in bootloader mode.
+
+The most prominent changes respect to the previous Firefly release are:
+
+* On-board ceramic chip 2.4GHz antenna
+* Pin-out changes and CC1200 GPIO2 pin is exposed
+* RF matching improvements
+* Printed PCB USB A connector instead of Micro-USB connector
+
+Firefly pin-out
+=============
+
+![Firefly Revision A pin-out (front)][firefly-reva-pinout-front]
+
+[firefly-reva-pinout-front]: ../images/firefly-pinout-front.png "Firefly Revision A pin-out (front)"
+[firefly-reva]: ../images/firefly-reva.png "Zolertia Firefly Revision A breakout board"

platform/zoul/firefly-reva/board.c

@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2014, Texas Instruments Incorporated - http://www.ti.com/
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived
+ *    from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
+ * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+/*---------------------------------------------------------------------------*/
+/**
+ * \addtogroup firefly
+ * @{
+ *
+ * \file
+ *  Board-initialisation for the Zolertia's Firefly platform
+ *
+ */
+/*---------------------------------------------------------------------------*/
+#include "contiki-conf.h"
+#include <stdint.h>
+#include <string.h>
+/*---------------------------------------------------------------------------*/
+static void
+configure_unused_pins(void)
+{
+  /* FIXME */
+}
+/*---------------------------------------------------------------------------*/
+void
+board_init()
+{
+  configure_unused_pins();
+}
+/*---------------------------------------------------------------------------*/
+/**
+ * @}
+ */
+

platform/zoul/firefly-reva/board.h

@@ -0,0 +1,386 @@
+/*
+ * Copyright (c) 2012, Texas Instruments Incorporated - http://www.ti.com/
+ * Copyright (c) 2015, Zolertia
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived
+ *    from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
+ * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+/**
+ * \addtogroup zoul-platforms
+ * @{
+ *
+ * \defgroup firefly-reva Firefly platform
+ *
+ * The Zolertia Firefly is the most down-to-core development platform, exposing
+ * the Zoul core functionalities and features, with a slick design to allow a
+ * flexible and easier user experience.
+ *
+ * Defines related to the Firefly platform: a Zoul-based breakout board
+ *
+ * This file provides connectivity information on LEDs, Buttons, UART and
+ * other peripherals
+ *
+ * This file can be used as the basis to configure other platforms using the
+ * cc2538 SoC.
+ * @{
+ *
+ * \file
+ * Header file with definitions related to the I/O connections on the Zolertia's
+ * Firefly platform, Zoul-based
+ *
+ * \note   Do not include this file directly. It gets included by contiki-conf
+ *         after all relevant directives have been set.
+ */
+#ifndef BOARD_H_
+#define BOARD_H_
+
+#include "dev/gpio.h"
+#include "dev/nvic.h"
+/*---------------------------------------------------------------------------*/
+/** \name Connector headers
+ *
+ * The Firefly features two 2.54 mm header rows over which exposes the following
+ * pins (facing up, Zolertia logo above and USB connector below):
+ * -----------------------------+---+---+--------------------------------------
+ * PIN_NAME                     |JP3|JP2|   PIN_NAME
+ * -----------------------------+---+---+--------------------------------------
+ * PB5/CC1200.CS                |-01|15-|   PD2/SPI1.MISO
+ * PB2/SPI0.SCLK/CC1200.SCLK    |-02|16-|   PD0/SPI1.SCLK
+ * PB1/SPIO0.MOSI/CC1200.MOSI   |-03|17-|   ADC5/AIN7/PA7
+ * PB3/SPIO0.MISO/CC1200.MISO   |-04|18-|   ADC4/AIN6/PA6
+ * PB4/CC1200.GPIO0             |-05|19-|   DGND
+ * PB0/CC1200.GPIO2             |-06|20-|   +VDD
+ * PD1/I2C.INT                  |-07|21-|   ADC1/AIN5/PA5
+ * PC2/I2C.SDA                  |-08|22-|   ADC2/AIN4/PA4
+ * PC3/I2C.SCL                  |-09|23-|   BUTTON.USER/ADC6/AIN3/PA3
+ * DGND                         |-10|24-|   ADC3/AIN2/PA2
+ * +VDD                         |-11|25-|   PC0/UART1.TX
+ * PC6/SPI1.MOSI                |-12|26-|   PC1/UART1.RX
+ * USB.D+                       |-13|27-|   PC4
+ * USB.D-                       |-14|28-|   PC5
+ * ---------------------------+-+---+---+-+------------------------------------
+ */
+/*---------------------------------------------------------------------------*/
+/** \name Firefly LED configuration
+ *
+ * LEDs on the Firefly are connected as follows:
+ * - LED1 (Red)    -> PD5
+ * - LED2 (Green)  -> PD4
+ * - LED3 (Blue)   -> PD3
+ *
+ * LED1 pin exposed in JP2 connector
+ * LED2 pin exposed in JP2 connector
+ * LED3 pin exposed in JP2 connector
+ * @{
+ */
+/*---------------------------------------------------------------------------*/
+/* Some files include leds.h before us, so we need to get rid of defaults in
+ * leds.h before we provide correct definitions */
+#undef LEDS_GREEN
+#undef LEDS_YELLOW
+#undef LEDS_BLUE
+#undef LEDS_RED
+#undef LEDS_CONF_ALL
+
+/* In leds.h the LEDS_BLUE is defined by LED_YELLOW definition */
+#define LEDS_GREEN    (1 << 4) /**< LED1 (Green) -> PD4 */
+#define LEDS_BLUE     (1 << 3) /**< LED2 (Blue)  -> PD3 */
+#define LEDS_RED      (1 << 5) /**< LED3 (Red)   -> PD5 */
+
+#define LEDS_CONF_ALL (LEDS_GREEN | LEDS_BLUE | LEDS_RED)
+
+#define LEDS_LIGHT_BLUE (LEDS_GREEN | LEDS_BLUE) /**< Green + Blue (24)       */
+#define LEDS_YELLOW     (LEDS_GREEN | LEDS_RED)  /**< Green + Red  (48)       */
+#define LEDS_PURPLE     (LEDS_BLUE  | LEDS_RED)  /**< Blue + Red   (40)       */
+#define LEDS_WHITE      LEDS_ALL                 /**< Green + Blue + Red (56) */
+
+/* Notify various examples that we have LEDs */
+#define PLATFORM_HAS_LEDS        1
+/** @} */
+/*---------------------------------------------------------------------------*/
+/** \name USB configuration
+ *
+ * The USB pullup is to be enabled by an external resistor, as it is not mapped
+ * to a GPIO.
+ */
+#ifdef USB_PULLUP_PORT
+#undef USB_PULLUP_PORT
+#endif
+#ifdef USB_PULLUP_PIN
+#undef USB_PULLUP_PIN
+#endif
+/** @} */
+/*---------------------------------------------------------------------------*/
+/** \name UART configuration
+ *
+ * On the Firefly, 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: not used, one suggestion however is to use PC4
+ *   - RTS: not used, one suggestion however is to use PC5
+ *
+ * We configure the port to use UART0 and UART1, CTS/RTS only for UART1,
+ * both without a HW pull-up resistor.
+ * UART0 is not exposed anywhere, UART1 pins are exposed over the JP3 connector.
+ * @{
+ */
+#define UART0_RX_PORT            GPIO_A_NUM
+#define UART0_RX_PIN             0
+#define UART0_TX_PORT            GPIO_A_NUM
+#define UART0_TX_PIN             1
+
+#define UART1_RX_PORT            GPIO_C_NUM
+#define UART1_RX_PIN             1
+#define UART1_TX_PORT            GPIO_C_NUM
+#define UART1_TX_PIN             0
+#define UART1_CTS_PORT           (-1) /**< GPIO_D_NUM */
+#define UART1_CTS_PIN            (-1) /**< 1 */
+#define UART1_RTS_PORT           (-1) /**< GPIO_D_NUM */
+#define UART1_RTS_PIN            (-1) /**< 0 */
+/** @} */
+/*---------------------------------------------------------------------------*/
+/**
+ * \name ADC configuration
+ *
+ * These values configure which CC2538 pins and ADC channels to use for the ADC
+ * inputs. There pins are suggested as they can be changed, but note that only
+ * pins from PA can be configured as ADC.
+ *
+ * - ADC1: up to 3.3V.
+ * - ADC2: up to 3.3V.
+ * - ADC3: up to 3.3V.
+ * - ADC4: up to 3.3V.
+ * - ADC5: up to 3.3V.
+ * - ADC6: up to 3.3V, shared with user button.
+ *
+ * The internal ADC reference is 1190mV, use either a voltage divider as input,
+ * or a different voltage reference, like AVDD5 or other externally (AIN7 or
+ * AIN6).
+ *
+ * Warning: if using ADC6 (PA3), you will need to disable the bootloader by
+ * making FLASH_CCA_CONF_BOOTLDR_BACKDOOR equal to zero
+ * @{
+ */
+#define ADC_SENSORS_PORT         GPIO_A_NUM /**< ADC GPIO control port */
+
+#ifndef ADC_SENSORS_CONF_ADC1_PIN
+#define ADC_SENSORS_ADC1_PIN     5             /**< ADC1 to PA5  */
+#else
+#if ((ADC_SENSORS_CONF_ADC1_PIN != -1) && (ADC_SENSORS_CONF_ADC1_PIN != 5))
+#error "ADC1 channel should be mapped to PA5 or disabled with -1"
+#else
+#define ADC_SENSORS_ADC1_PIN ADC_SENSORS_CONF_ADC1_PIN
+#endif
+#endif
+
+#ifndef ADC_SENSORS_CONF_ADC2_PIN
+#define ADC_SENSORS_ADC2_PIN     4             /**< ADC2 to PA4  */
+#else
+#if ((ADC_SENSORS_CONF_ADC2_PIN != -1) && (ADC_SENSORS_CONF_ADC2_PIN != 4))
+#error "ADC2 channel should be mapped to PA4 or disabled with -1"
+#else
+#define ADC_SENSORS_ADC2_PIN ADC_SENSORS_CONF_ADC2_PIN
+#endif
+#endif
+
+#ifndef ADC_SENSORS_CONF_ADC3_PIN
+#define ADC_SENSORS_ADC3_PIN     2             /**< ADC3 to PA2  */
+#else
+#if ((ADC_SENSORS_CONF_ADC3_PIN != -1) && (ADC_SENSORS_CONF_ADC3_PIN != 2))
+#error "ADC3 channel should be mapped to PA2 or disabled with -1"
+#else
+#define ADC_SENSORS_ADC3_PIN ADC_SENSORS_CONF_ADC3_PIN
+#endif
+#endif
+
+#ifndef ADC_SENSORS_CONF_ADC4_PIN
+#define ADC_SENSORS_ADC4_PIN     6             /**< ADC4 to PA6   */
+#else
+#if ((ADC_SENSORS_CONF_ADC4_PIN != -1) && (ADC_SENSORS_CONF_ADC4_PIN != 6))
+#error "ADC4 channel should be mapped to PA6 or disabled with -1"
+#else
+#define ADC_SENSORS_ADC4_PIN ADC_SENSORS_CONF_ADC4_PIN
+#endif
+#endif
+
+#ifndef ADC_SENSORS_CONF_ADC5_PIN
+#define ADC_SENSORS_ADC5_PIN     7             /**< ADC5 to PA7   */
+#else
+#if ((ADC_SENSORS_CONF_ADC5_PIN != -1) && (ADC_SENSORS_CONF_ADC5_PIN != 7))
+#error "ADC5 channel should be mapped to PA7 or disabled with -1"
+#else
+#define ADC_SENSORS_ADC5_PIN ADC_SENSORS_CONF_ADC5_PIN
+#endif
+#endif
+
+#ifndef ADC_SENSORS_CONF_ADC6_PIN
+#define ADC_SENSORS_ADC6_PIN     (-1)          /**< ADC6 not declared    */
+#else
+#define ADC_SENSORS_ADC6_PIN     3             /**< Hard-coded to PA3    */
+#endif
+
+#ifndef ADC_SENSORS_CONF_MAX
+#define ADC_SENSORS_MAX          5            /**< Maximum sensors       */
+#else
+#define ADC_SENSORS_MAX          ADC_SENSORS_CONF_MAX
+#endif
+/** @} */
+/*---------------------------------------------------------------------------*/
+/** \name Firefly Button configuration
+ *
+ * Buttons on the Firefly are connected as follows:
+ * - BUTTON_USER  -> PA3, S1 user button, shared with bootloader
+ * - BUTTON_RESET -> RESET_N line
+ * @{
+ */
+/** BUTTON_USER -> PA3 */
+#define BUTTON_USER_PORT       GPIO_A_NUM
+#define BUTTON_USER_PIN        3
+#define BUTTON_USER_VECTOR     NVIC_INT_GPIO_PORT_A
+
+/* Notify various examples that we have an user button.
+ * If ADC6 channel is used, then disable the user button
+ */
+#ifdef PLATFORM_CONF_WITH_BUTTON
+#if (PLATFORM_CONF_WITH_BUTTON && (ADC_SENSORS_ADC6_PIN == 3))
+#error "The ADC6 (PA3) and user button cannot be enabled at the same time" 
+#else
+#define PLATFORM_HAS_BUTTON  (PLATFORM_CONF_WITH_BUTTON && \
+                              !(ADC_SENSORS_ADC6_PIN == 3))
+#endif /* (PLATFORM_CONF_WITH_BUTTON && (ADC_SENSORS_ADC6_PIN == 3)) */
+#else
+#define PLATFORM_HAS_BUTTON  !(ADC_SENSORS_ADC6_PIN == 3)
+#endif /* PLATFORM_CONF_WITH_BUTTON */
+/** @} */
+/*---------------------------------------------------------------------------*/
+/**
+ * \name 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 exposed
+ * to the JP3 connector.  To disable the CC1200 and use these pins, just
+ * remove the R10 resistor (0 ohm), which powers both the CC2538 and CC1200 to
+ * only power the SoC.
+ * TX -> MOSI, RX -> MISO
+ * @{
+ */
+#define SPI0_CLK_PORT             GPIO_B_NUM
+#define SPI0_CLK_PIN              2
+#define SPI0_TX_PORT              GPIO_B_NUM
+#define SPI0_TX_PIN               1
+#define SPI0_RX_PORT              GPIO_B_NUM
+#define SPI0_RX_PIN               3
+/** @} */
+/*---------------------------------------------------------------------------*/
+/**
+ * \name SPI (SSI1) configuration
+ *
+ * These values configure which CC2538 pins to use for the SPI (SSI1) lines,
+ * exposed over JP3 connector.
+ * TX -> MOSI, RX -> MISO
+ * @{
+ */
+#define SPI1_CLK_PORT            GPIO_D_NUM
+#define SPI1_CLK_PIN             0
+#define SPI1_TX_PORT             GPIO_C_NUM
+#define SPI1_TX_PIN              6
+#define SPI1_RX_PORT             GPIO_D_NUM
+#define SPI1_RX_PIN              2
+/** @} */
+/*---------------------------------------------------------------------------*/
+/**
+ * \name I2C configuration
+ *
+ * These values configure which CC2538 pins to use for the I2C lines, exposed
+ * over JP3 connector.
+ * @{
+ */
+#define I2C_SCL_PORT             GPIO_C_NUM
+#define I2C_SCL_PIN              3
+#define I2C_SDA_PORT             GPIO_C_NUM
+#define I2C_SDA_PIN              2
+#define I2C_INT_PORT             GPIO_D_NUM
+#define I2C_INT_PIN              1
+#define I2C_INT_VECTOR           NVIC_INT_GPIO_PORT_D
+/** @} */
+/*---------------------------------------------------------------------------*/
+/**
+ * \name Dual RF interface support
+ *
+ * Enables support for dual band operation (both CC1200 and 2.4GHz enabled).
+ * Unlike the RE-Mote, the Firefly doesn't have a RF switch, so both interfaces
+ * should be always enabled if the R10 resistor is mounted.  If only using the
+ * 2.4GHz RF interface, the resistor can be removed to power-off the CC1200.
+ * @{
+ */
+#define REMOTE_DUAL_RF_ENABLED 1
+/** @} */
+/*---------------------------------------------------------------------------*/
+/**
+ * \name 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
+ * @{
+ */
+#define CC1200_SPI_INSTANCE         0
+#define CC1200_SPI_SCLK_PORT        SPI0_CLK_PORT
+#define CC1200_SPI_SCLK_PIN         SPI0_CLK_PIN
+#define CC1200_SPI_MOSI_PORT        SPI0_TX_PORT
+#define CC1200_SPI_MOSI_PIN         SPI0_TX_PIN
+#define CC1200_SPI_MISO_PORT        SPI0_RX_PORT
+#define CC1200_SPI_MISO_PIN         SPI0_RX_PIN
+#define CC1200_SPI_CSN_PORT         GPIO_B_NUM
+#define CC1200_SPI_CSN_PIN          5
+#define CC1200_GDO0_PORT            GPIO_B_NUM
+#define CC1200_GDO0_PIN             4
+#define CC1200_GDO2_PORT            GPIO_B_NUM
+#define CC1200_GDO2_PIN             0
+#define CC1200_RESET_PORT           GPIO_C_NUM
+#define CC1200_RESET_PIN            7
+#define CC1200_GPIOx_VECTOR         NVIC_INT_GPIO_PORT_B
+/** @} */
+/*---------------------------------------------------------------------------*/
+/**
+ * \name Device string used on startup
+ * @{
+ */
+#define BOARD_STRING "Zolertia Firefly revision A platform"
+/** @} */
+
+#endif /* BOARD_H_ */
+
+/**
+ * @}
+ * @}
+ */