deac/osd-contiki
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity
osd-contiki/cpu/cc2538/dev/spi.c

143 lines
5.2 KiB
C
Raw Normal View History

Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
/*
* Copyright (c) 2013, University of Michigan.
* 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 University 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 INSTITUTE 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 INSTITUTE 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 cc2538-spi
* @{
*
* \file
Improve wording, fix warnigs in the SSI/SPI docs
2015-02-14 01:44:30 +01:00
* Implementation of the cc2538 SPI peripheral driver
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
*/
#include "contiki.h"
#include "reg.h"
cc2538: spi: Include spi-arch.h before dev/spi.h spi-arch.h configures dev/spi.h, so it must be #included first. Luckily, this mistake did not have any consequence here, but fix it in order to avoid possible future issues. Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-04 16:59:02 +01:00
#include "spi-arch.h"
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
#include "dev/ioc.h"
#include "dev/sys-ctrl.h"
#include "dev/spi.h"
#include "dev/ssi.h"
#include "dev/gpio.h"
cc2538: Clean up port and pin definitions Homogenize port and pin definitions naming: - PERIPHERAL_FUNCTION_PORT for the port ID, - PERIPHERAL_FUNCTION_PIN for the pin ID, - PERIPHERAL_FUNCTION_PORT_BASE for the port base, - PERIPHERAL_FUNCTION_PIN_MASK for the pin mask. Define only PERIPHERAL_FUNCTION_PORT and PERIPHERAL_FUNCTION_PIN in board.h, and deduce PERIPHERAL_FUNCTION_PORT_BASE and PERIPHERAL_FUNCTION_PIN_MASK in the driver from the former definitions. Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-25 15:00:41 +01:00
#define SPI_CLK_PORT_BASE GPIO_PORT_TO_BASE(SPI_CLK_PORT)
#define SPI_CLK_PIN_MASK GPIO_PIN_MASK(SPI_CLK_PIN)
#define SPI_MOSI_PORT_BASE GPIO_PORT_TO_BASE(SPI_MOSI_PORT)
#define SPI_MOSI_PIN_MASK GPIO_PIN_MASK(SPI_MOSI_PIN)
#define SPI_MISO_PORT_BASE GPIO_PORT_TO_BASE(SPI_MISO_PORT)
#define SPI_MISO_PIN_MASK GPIO_PIN_MASK(SPI_MISO_PIN)
cc2538: spi: Add format configuration options Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-04 18:39:52 +01:00
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
/**
* \brief Initialize the SPI bus.
*
Fix doxygen warning in the CC2538 SPI driver
2015-02-14 01:18:32 +01:00
* This SPI init() function uses the following defines to set the pins:
cc2538: Clean up port and pin definitions Homogenize port and pin definitions naming: - PERIPHERAL_FUNCTION_PORT for the port ID, - PERIPHERAL_FUNCTION_PIN for the pin ID, - PERIPHERAL_FUNCTION_PORT_BASE for the port base, - PERIPHERAL_FUNCTION_PIN_MASK for the pin mask. Define only PERIPHERAL_FUNCTION_PORT and PERIPHERAL_FUNCTION_PIN in board.h, and deduce PERIPHERAL_FUNCTION_PORT_BASE and PERIPHERAL_FUNCTION_PIN_MASK in the driver from the former definitions. Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-25 15:00:41 +01:00
* SPI_CLK_PORT SPI_CLK_PIN
* SPI_MOSI_PORT SPI_MOSI_PIN
* SPI_MISO_PORT SPI_MISO_PIN
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
*
cc2538: spi: Add format configuration options Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-04 18:39:52 +01:00
* This sets the mode to Motorola SPI with the following format options:
[CC2538-SPI] Implement SPI_FLUSH, spi mode, !CS Because the CC2538 has a multi-byte SPI RX FIFO, flushing the buffer requires more than just a single read. This adds a loop that empties the entire RX buffer on a FLUSH(). Different SPI chips needs different SPI settings. This commit adds a function that allows chip drivers to configure the SPI peripheral before using it. The frame pin the driver was using as a chip select does not work as most devices expect it to. It toggles after every byte, and most chips interpret that as end of message. To make drivers more reliable, each chip driver should setup a GPIO and assert it as needed.
2014-03-18 15:11:49 +01:00
* Clock phase: 1; data captured on second (rising) edge
* Clock polarity: 1; clock is high when idle
* Data size: 8 bits
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
*/
void
spi_init(void)
{
cc2538: spi: Add enable and disable functions This makes it possible to reduce the power consumption when the SPI is unused. Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-15 15:58:44 +01:00
spi_enable();
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
/* Start by disabling the peripheral before configuring it */
REG(SSI0_BASE + SSI_CR1) = 0;
/* Set the IO clock as the SSI clock */
REG(SSI0_BASE + SSI_CC) = 1;
/* Set the mux correctly to connect the SSI pins to the correct GPIO pins */
cc2538: Clean up port and pin definitions Homogenize port and pin definitions naming: - PERIPHERAL_FUNCTION_PORT for the port ID, - PERIPHERAL_FUNCTION_PIN for the pin ID, - PERIPHERAL_FUNCTION_PORT_BASE for the port base, - PERIPHERAL_FUNCTION_PIN_MASK for the pin mask. Define only PERIPHERAL_FUNCTION_PORT and PERIPHERAL_FUNCTION_PIN in board.h, and deduce PERIPHERAL_FUNCTION_PORT_BASE and PERIPHERAL_FUNCTION_PIN_MASK in the driver from the former definitions. Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-25 15:00:41 +01:00
ioc_set_sel(SPI_CLK_PORT, SPI_CLK_PIN, IOC_PXX_SEL_SSI0_CLKOUT);
ioc_set_sel(SPI_MOSI_PORT, SPI_MOSI_PIN, IOC_PXX_SEL_SSI0_TXD);
REG(IOC_SSIRXD_SSI0) = (SPI_MISO_PORT * 8) + SPI_MISO_PIN;
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
/* Put all the SSI gpios into peripheral mode */
cc2538: Clean up port and pin definitions Homogenize port and pin definitions naming: - PERIPHERAL_FUNCTION_PORT for the port ID, - PERIPHERAL_FUNCTION_PIN for the pin ID, - PERIPHERAL_FUNCTION_PORT_BASE for the port base, - PERIPHERAL_FUNCTION_PIN_MASK for the pin mask. Define only PERIPHERAL_FUNCTION_PORT and PERIPHERAL_FUNCTION_PIN in board.h, and deduce PERIPHERAL_FUNCTION_PORT_BASE and PERIPHERAL_FUNCTION_PIN_MASK in the driver from the former definitions. Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-25 15:00:41 +01:00
GPIO_PERIPHERAL_CONTROL(SPI_CLK_PORT_BASE, SPI_CLK_PIN_MASK);
GPIO_PERIPHERAL_CONTROL(SPI_MOSI_PORT_BASE, SPI_MOSI_PIN_MASK);
GPIO_PERIPHERAL_CONTROL(SPI_MISO_PORT_BASE, SPI_MISO_PIN_MASK);
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
/* Disable any pull ups or the like */
cc2538: Clean up port and pin definitions Homogenize port and pin definitions naming: - PERIPHERAL_FUNCTION_PORT for the port ID, - PERIPHERAL_FUNCTION_PIN for the pin ID, - PERIPHERAL_FUNCTION_PORT_BASE for the port base, - PERIPHERAL_FUNCTION_PIN_MASK for the pin mask. Define only PERIPHERAL_FUNCTION_PORT and PERIPHERAL_FUNCTION_PIN in board.h, and deduce PERIPHERAL_FUNCTION_PORT_BASE and PERIPHERAL_FUNCTION_PIN_MASK in the driver from the former definitions. Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-25 15:00:41 +01:00
ioc_set_over(SPI_CLK_PORT, SPI_CLK_PIN, IOC_OVERRIDE_DIS);
ioc_set_over(SPI_MOSI_PORT, SPI_MOSI_PIN, IOC_OVERRIDE_DIS);
ioc_set_over(SPI_MISO_PORT, SPI_MISO_PIN, IOC_OVERRIDE_DIS);
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
/* Configure the clock */
REG(SSI0_BASE + SSI_CPSR) = 2;
[CC2538-SPI] Implement SPI_FLUSH, spi mode, !CS Because the CC2538 has a multi-byte SPI RX FIFO, flushing the buffer requires more than just a single read. This adds a loop that empties the entire RX buffer on a FLUSH(). Different SPI chips needs different SPI settings. This commit adds a function that allows chip drivers to configure the SPI peripheral before using it. The frame pin the driver was using as a chip select does not work as most devices expect it to. It toggles after every byte, and most chips interpret that as end of message. To make drivers more reliable, each chip driver should setup a GPIO and assert it as needed.
2014-03-18 15:11:49 +01:00
/* Configure the default SPI options.
* mode: Motorola frame format
* clock: High when idle
* data: Valid on rising edges of the clock
* bits: 8 byte data
*/
REG(SSI0_BASE + SSI_CR0) = SSI_CR0_SPH | SSI_CR0_SPO | (0x07);
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
/* Enable the SSI */
REG(SSI0_BASE + SSI_CR1) |= SSI_CR1_SSE;
}
cc2538: spi: Add enable and disable functions This makes it possible to reduce the power consumption when the SPI is unused. Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-15 15:58:44 +01:00
/*---------------------------------------------------------------------------*/
void
[CC2538-SPI] Implement SPI_FLUSH, spi mode, !CS Because the CC2538 has a multi-byte SPI RX FIFO, flushing the buffer requires more than just a single read. This adds a loop that empties the entire RX buffer on a FLUSH(). Different SPI chips needs different SPI settings. This commit adds a function that allows chip drivers to configure the SPI peripheral before using it. The frame pin the driver was using as a chip select does not work as most devices expect it to. It toggles after every byte, and most chips interpret that as end of message. To make drivers more reliable, each chip driver should setup a GPIO and assert it as needed.
2014-03-18 15:11:49 +01:00
spi_cs_init(uint8_t port, uint8_t pin)
{
GPIO_SOFTWARE_CONTROL(GPIO_PORT_TO_BASE(port), GPIO_PIN_MASK(pin));
ioc_set_over(port, pin, IOC_OVERRIDE_DIS);
GPIO_SET_OUTPUT(GPIO_PORT_TO_BASE(port), GPIO_PIN_MASK(pin));
GPIO_SET_PIN(GPIO_PORT_TO_BASE(port), GPIO_PIN_MASK(pin));
}
/*---------------------------------------------------------------------------*/
void
cc2538: spi: Add enable and disable functions This makes it possible to reduce the power consumption when the SPI is unused. Signed-off-by: Benoît Thébaudeau <benoit.thebaudeau@advansee.com>
2013-11-15 15:58:44 +01:00
spi_enable(void)
{
/* Enable the clock for the SSI peripheral */
REG(SYS_CTRL_RCGCSSI) |= 1;
}
/*---------------------------------------------------------------------------*/
void
spi_disable(void)
{
/* Gate the clock for the SSI peripheral */
REG(SYS_CTRL_RCGCSSI) &= ~1;
}
[CC2538-SPI] Implement SPI_FLUSH, spi mode, !CS Because the CC2538 has a multi-byte SPI RX FIFO, flushing the buffer requires more than just a single read. This adds a loop that empties the entire RX buffer on a FLUSH(). Different SPI chips needs different SPI settings. This commit adds a function that allows chip drivers to configure the SPI peripheral before using it. The frame pin the driver was using as a chip select does not work as most devices expect it to. It toggles after every byte, and most chips interpret that as end of message. To make drivers more reliable, each chip driver should setup a GPIO and assert it as needed.
2014-03-18 15:11:49 +01:00
/*---------------------------------------------------------------------------*/
Improve wording, fix warnigs in the SSI/SPI docs
2015-02-14 01:44:30 +01:00
void
spi_set_mode(uint32_t frame_format, uint32_t clock_polarity,
uint32_t clock_phase, uint32_t data_size)
[CC2538-SPI] Implement SPI_FLUSH, spi mode, !CS Because the CC2538 has a multi-byte SPI RX FIFO, flushing the buffer requires more than just a single read. This adds a loop that empties the entire RX buffer on a FLUSH(). Different SPI chips needs different SPI settings. This commit adds a function that allows chip drivers to configure the SPI peripheral before using it. The frame pin the driver was using as a chip select does not work as most devices expect it to. It toggles after every byte, and most chips interpret that as end of message. To make drivers more reliable, each chip driver should setup a GPIO and assert it as needed.
2014-03-18 15:11:49 +01:00
{
/* Disable the SSI peripheral to configure it */
REG(SSI0_BASE + SSI_CR1) = 0;
/* Configure the SSI options */
REG(SSI0_BASE + SSI_CR0) = clock_phase | clock_polarity | frame_format | (data_size - 1);
/* Re-enable the SSI */
REG(SSI0_BASE + SSI_CR1) |= SSI_CR1_SSE;
}
Added SPI driver for CC2538 This uses the core/dev/spi.h header and implements the spi_init() function and the various macros for SPI operation. ssi.h contains all of the register locations and information. This implementation is not very versatile, mostly because I don't how to make it flexible in the contiki system. It supports pin muxing for the four spi pins, but other than that picks sensible defaults. The SPI macros (like SPI_READ()) are defined in cpu/cc2538/spi-arch.h. In order to use the SPI driver, add the following includes to your project: #include "spi-arch.h #include "dev/spi.h"
2013-09-05 20:59:56 +02:00
/** @} */
Reference in a new issue Copy permalink