From 9d30cd2935c7f03899a3a43b848d56abedbbccde Mon Sep 17 00:00:00 2001 From: Gregory Nutt Date: Thu, 20 Jun 2013 13:50:16 -0600 Subject: [PATCH] Add framework for managing SPI-related discretes on the Freedom KL25Z board. --- configs/freedom-kl25z/src/Makefile | 8 +- .../freedom-kl25z/src/kl_boardinitialize.c | 12 +- configs/freedom-kl25z/src/kl_spi.c | 237 ++++++++++++++++++ 3 files changed, 250 insertions(+), 7 deletions(-) create mode 100644 configs/freedom-kl25z/src/kl_spi.c diff --git a/configs/freedom-kl25z/src/Makefile b/configs/freedom-kl25z/src/Makefile index 68db441bca..5164f93104 100644 --- a/configs/freedom-kl25z/src/Makefile +++ b/configs/freedom-kl25z/src/Makefile @@ -46,6 +46,10 @@ ifeq ($(CONFIG_KL_TSI),y) CSRCS += kl_tsi.c endif +ifeq ($(CONFIG_KL_SPI0),y) +CSRCS += kl_spi.c +endif + ifeq ($(CONFIG_HAVE_CXX),y) CSRCS += kl_cxxinitialize.c endif @@ -54,8 +58,8 @@ ifeq ($(CONFIG_ARCH_LEDS),y) CSRCS += kl_led.c endif -ifeq ($(CONFIG_NUC1XX_USBD),y) -CSRCS += kl_usbd.c +ifeq ($(CONFIG_KL_USBOTG),y) +CSRCS += kl_usb.c endif ifeq ($(CONFIG_PWM),y) diff --git a/configs/freedom-kl25z/src/kl_boardinitialize.c b/configs/freedom-kl25z/src/kl_boardinitialize.c index eff2873b12..378de8ea4a 100644 --- a/configs/freedom-kl25z/src/kl_boardinitialize.c +++ b/configs/freedom-kl25z/src/kl_boardinitialize.c @@ -75,19 +75,20 @@ void kl_boardinitialize(void) * kl_spiinitialize() has been brought into the link. */ -#if defined(CONFIG_NUC1XX_SPI1) || defined(CONFIG_NUC1XX_SPI2) || defined(CONFIG_NUC1XX_SPI3) +#if defined(CONFIG_KL_SPI0) || defined(CONFIG_KL_SPI1) if (kl_spiinitialize) { kl_spiinitialize(); } #endif - /* Initialize USB if the 1) USB device controller is in the configuration and 2) - * disabled, and 3) the weak function kl_usbinitialize() has been brought - * into the build. Presumeably either CONFIG_USBDEV is also selected. + /* Initialize USB if the 1) USB device controller is in the configuration + * and 2) disabled, and 3) the weak function kl_usbinitialize() has been + * brought into the build. Presumeably either CONFIG_USBHOST or + * CONFIG_USBDEV is also selected. */ -#ifdef CONFIG_NUC1XX_USB +#ifdef CONFIG_KL_USBOTG if (kl_usbinitialize) { kl_usbinitialize(); @@ -100,6 +101,7 @@ void kl_boardinitialize(void) kl_ledinit(); #endif } + /**************************************************************************** * Name: board_initialize * diff --git a/configs/freedom-kl25z/src/kl_spi.c b/configs/freedom-kl25z/src/kl_spi.c new file mode 100644 index 0000000000..4d927d89b7 --- /dev/null +++ b/configs/freedom-kl25z/src/kl_spi.c @@ -0,0 +1,237 @@ +/**************************************************************************** + * configs/freedom-kl25z/src/kl_spi.c + * + * Copyright (C) 2013 Gregory Nutt. All rights reserved. + * Author: Gregory Nutt + * + * 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 NuttX 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 OWNER 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. + * + ****************************************************************************/ + +/**************************************************************************** + * Included Files + ****************************************************************************/ + +#include + +#include +#include +#include + +#include + +#include "kl_gpio.h" +#include "kl_spi.h" +#include "freedom-kl25z.h" + +#if defined(CONFIG_KL_SPI0) || defined(CONFIG_KL_SPI1) + +/**************************************************************************** + * Definitions + ****************************************************************************/ + +/* Enables debug output from this file (needs CONFIG_DEBUG too) */ + +#undef SPI_DEBUG /* Define to enable debug */ +#undef SPI_VERBOSE /* Define to enable verbose debug */ + +#ifdef SPI_DEBUG +# define spidbg lldbg +# ifdef SPI_VERBOSE +# define spivdbg lldbg +# else +# define spivdbg(x...) +# endif +#else +# undef SPI_VERBOSE +# define spidbg(x...) +# define spivdbg(x...) +#endif + +/**************************************************************************** + * Private Functions + ****************************************************************************/ + +/**************************************************************************** + * Public Functions + ****************************************************************************/ + +/**************************************************************************** + * Name: kl_spiinitialize + * + * Description: + * Called to configure SPI chip select GPIO pins for the FRDM-KL25Z board. + * + ****************************************************************************/ + +void weak_function kl_spiinitialize(void) +{ + /* Configure SPI0 chip selects */ + +#ifdef CONFIG_KL_SPI0 +#endif + + /* Configure SPI1 chip selects */ + +#ifdef CONFIG_KL_SPI1 +#endif +} + +/**************************************************************************** + * Name: kl_spi[n]select, kl_spi[n]status, and kl_spi[n]cmddata + * + * Description: + * These external functions must be provided by board-specific logic. They + * are implementations of the select, status, and cmddata methods of the SPI + * interface defined by struct spi_ops_s (see include/nuttx/spi.h). All + * other methods including up_spiinitialize()) are provided by common + * Kinetis logic. To use this common SPI logic on your board: + * + * 1. Provide logic in kl_boardinitialize() to configure SPI chip select + * pins. + * 2. Provide kl_spi[n]select() and kl_spi[n]status() functions + * in your board-specific logic. These functions will perform chip + * selection and status operations using GPIOs in the way your board + * is configured. + * 2. If CONFIG_SPI_CMDDATA is defined in the NuttX configuration, provide + * kl_spi[n]cmddata() functions in your board-specific logic. These + * functions will perform cmd/data selection operations using GPIOs in + * the way your board is configured. + * 3. Add a call to up_spiinitialize() in your low level application + * initialization logic + * 4. The handle returned by up_spiinitialize() may then be used to bind + * the SPI driver to higher level logic (e.g., calling + * mmcsd_spislotinitialize(), for example, will bind the SPI driver to + * the SPI MMC/SD driver). + * + ****************************************************************************/ +/**************************************************************************** + * Name: kl_spi[n]select + * + * Description: + * PIO chip select pins may be programmed by the board specific logic in + * one of two different ways. First, the pins may be programmed as SPI + * peripherals. In that case, the pins are completely controlled by the + * SPI driver. This method still needs to be provided, but it may be only + * a stub. + * + * An alternative way to program the PIO chip select pins is as a normal + * GPIO output. In that case, the automatic control of the CS pins is + * bypassed and this function must provide control of the chip select. + * NOTE: In this case, the GPIO output pin does *not* have to be the + * same as the NPCS pin normal associated with the chip select number. + * + * Input Parameters: + * devid - Identifies the (logical) device + * selected - TRUE:Select the device, FALSE:De-select the device + * + * Returned Values: + * None + * + ****************************************************************************/ + +#ifdef CONFIG_KL_SPI0 +void kl_spi0select(FAR struct spi_dev_s *dev, enum spi_dev_e devid, + bool selected) +{ + spivdbg("devid: %d CS: %s\n", + (int)devid, selected ? "assert" : "de-assert"); +} +#endif + +#ifdef CONFIG_KL_SPI1 +void kl_spi1select(FAR struct spi_dev_s *dev, enum spi_dev_e devid, + bool selected) +{ + spivdbg("devid: %d CS: %s\n", + (int)devid, selected ? "assert" : "de-assert"); +} +#endif + +/**************************************************************************** + * Name: kl_spi[n]status + * + * Description: + * Return status information associated with the SPI device. + * + * Input Parameters: + * devid - Identifies the (logical) device + * + * Returned Values: + * Bit-encoded SPI status (see include/nuttx/spi.h. + * + ****************************************************************************/ + +#ifdef CONFIG_KL_SPI0 +uint8_t kl_spi0status(FAR struct spi_dev_s *dev, enum spi_dev_e devid) +{ + return 0; +} +#endif + +#ifdef CONFIG_KL_SPI1 +uint8_t kl_spi2status(FAR struct spi_dev_s *dev, enum spi_dev_e devid) +{ + return 0; +} +#endif + +/**************************************************************************** + * Name: kl_spi[n]cmddata + * + * Description: + * Some SPI interfaces, particularly with LCDs, and an auxilary 9th data + * input that determines where the other 8 data bits represent command or + * data. These interfaces control that CMD/DATA GPIO output + * + * Input Parameters: + * devid - Identifies the (logical) device + * cmd - Determines where command or data should be selected. + * + * Returned Values: + * Bit-encoded SPI status (see include/nuttx/spi.h. + * + ****************************************************************************/ + +#ifdef CONFIG_SPI_CMDDATA +#ifdef CONFIG_KL_SPI0 +int kl_spi0cmddata(FAR struct spi_dev_s *dev, enum spi_dev_e devid, bool cmd) +{ + return 0; +} +#endif + +#ifdef CONFIG_KL_SPI1 +int kl_spi1cmddata(FAR struct spi_dev_s *dev, enum spi_dev_e devid, bool cmd) +{ + return 0; +} +#endif +#endif + +#endif /* CONFIG_KL_SPI */