2017-07-25 00:46:30 +02:00
|
|
|
/******************************************************************************
|
2019-12-05 18:49:12 +01:00
|
|
|
* drivers/wireless/spirit/lib/spirit_spi.c
|
2017-07-25 00:46:30 +02:00
|
|
|
* NuttX SPIRIT SPI driver interface.
|
|
|
|
*
|
|
|
|
* Copyright (C) 2017 Gregory Nutt. All rights reserved.
|
|
|
|
* Authors: Gregory Nutt <gnutt@nuttx.org>
|
|
|
|
*
|
|
|
|
* Derives loosely from simlilarly licensed, platform-specific, example
|
|
|
|
* implementations from STMicro:
|
|
|
|
*
|
|
|
|
* Copyright(c) 2015 STMicroelectronics
|
|
|
|
* Author: VMA division - AMS
|
|
|
|
* Version 3.2.2 08-July-2015
|
|
|
|
*
|
|
|
|
* 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
|
|
|
|
******************************************************************************/
|
|
|
|
|
2017-07-31 03:10:51 +02:00
|
|
|
#include <stdio.h>
|
2017-07-25 00:46:30 +02:00
|
|
|
#include <assert.h>
|
2017-08-01 18:31:12 +02:00
|
|
|
#include <errno.h>
|
2017-08-01 21:48:59 +02:00
|
|
|
#include <debug.h>
|
2017-07-25 00:46:30 +02:00
|
|
|
|
2017-08-01 18:31:12 +02:00
|
|
|
#include <nuttx/clock.h>
|
2017-07-25 00:46:30 +02:00
|
|
|
#include <nuttx/spi/spi.h>
|
|
|
|
|
|
|
|
#include "spirit_regs.h"
|
|
|
|
#include "spirit_types.h"
|
|
|
|
#include "spirit_spi.h"
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Pre-processor Definitions
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
#ifndef CONFIG_WL_SPIRIT_SPIFREQUENCY
|
|
|
|
# define CONFIG_WL_SPIRIT_SPIFREQUENCY (10000000)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Private Functions
|
|
|
|
******************************************************************************/
|
|
|
|
|
2017-07-27 19:56:26 +02:00
|
|
|
/******************************************************************************
|
|
|
|
* Name: spirit_dump_buffer
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Dump a data buffer to the SYSLOG.
|
|
|
|
*
|
2018-03-13 16:52:27 +01:00
|
|
|
* Input Parameters:
|
2017-07-27 19:56:26 +02:00
|
|
|
* buffer - The buffer to be dumped
|
|
|
|
* buflen - The length of the buffer in bytes.
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
#if defined(CONFIG_WL_SPIRIT_REGDEBUG) || defined(CONFIG_WL_SPIRIT_FIFODUMP)
|
|
|
|
static void spirit_dump_buffer(FAR const uint8_t *buffer, unsigned int buflen)
|
|
|
|
{
|
2019-12-05 18:49:12 +01:00
|
|
|
char outbuf[16 * 3 + 3]; /* 16 hex bytes + 2 space separator + NUL termination */
|
2017-07-27 19:56:26 +02:00
|
|
|
FAR char *ptr;
|
|
|
|
unsigned int i;
|
2017-07-31 03:10:51 +02:00
|
|
|
unsigned int j;
|
|
|
|
unsigned int maxj;
|
2017-07-27 19:56:26 +02:00
|
|
|
|
|
|
|
for (i = 0; i < buflen; i += 16)
|
|
|
|
{
|
|
|
|
maxj = 16;
|
|
|
|
if (i + maxj > buflen)
|
|
|
|
{
|
|
|
|
maxj = buflen - i;
|
|
|
|
}
|
|
|
|
|
|
|
|
ptr = outbuf;
|
|
|
|
for (j = 0; j < maxj; j++)
|
|
|
|
{
|
2017-07-31 03:10:51 +02:00
|
|
|
if (j == 8)
|
2017-07-27 19:56:26 +02:00
|
|
|
{
|
2017-07-31 03:10:51 +02:00
|
|
|
*ptr++ = ' ';
|
|
|
|
*ptr++ = ' ';
|
2017-07-27 19:56:26 +02:00
|
|
|
}
|
|
|
|
|
2017-07-31 03:10:51 +02:00
|
|
|
sprintf(ptr, "%02x ", *buffer++);
|
|
|
|
ptr += 3;
|
2017-07-27 19:56:26 +02:00
|
|
|
}
|
|
|
|
|
2017-07-31 03:10:51 +02:00
|
|
|
*ptr = '\0';
|
|
|
|
wlinfo(" %s\n", ptr);
|
2017-07-27 19:56:26 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Name: spirit_regdebug
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Dump a register access.
|
|
|
|
*
|
2018-03-13 16:52:27 +01:00
|
|
|
* Input Parameters:
|
2017-07-27 19:56:26 +02:00
|
|
|
* msg - Describes the access
|
|
|
|
* header - Two byte header before the access
|
|
|
|
* buffer - The buffer to be dumped
|
|
|
|
* buflen - The length of the buffer in bytes.
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
#ifdef CONFIG_WL_SPIRIT_REGDEBUG
|
|
|
|
static void spirit_regdebug(FAR const char *msg, FAR uint8_t *header,
|
|
|
|
FAR const uint8_t *buffer, unsigned int buflen)
|
|
|
|
{
|
|
|
|
wlinfo("%-8s: %02x %02x\n", header[0], header[1]);
|
|
|
|
spirit_dump_buffer(buffer, buflen);
|
|
|
|
}
|
|
|
|
#else
|
|
|
|
# define spirit_regdebug(msg,header,buffer,buflen)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Name: spirit_fifodebug
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Dump a FIFO access.
|
|
|
|
*
|
2018-03-13 16:52:27 +01:00
|
|
|
* Input Parameters:
|
2017-07-27 19:56:26 +02:00
|
|
|
* msg - Describes the access
|
|
|
|
* header - Two byte header before the access
|
|
|
|
* buffer - The buffer to be dumped
|
|
|
|
* buflen - The length of the buffer in bytes.
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
#ifdef CONFIG_WL_SPIRIT_FIFODUMP
|
|
|
|
static void spirit_fifodebug(FAR const char *msg, FAR uint8_t *header,
|
|
|
|
FAR const uint8_t *buffer, unsigned int buflen)
|
|
|
|
{
|
|
|
|
wlinfo("%-8s: %02x %02x\n", header[0], header[1]);
|
|
|
|
spirit_dump_buffer(buffer, buflen);
|
|
|
|
}
|
|
|
|
#else
|
|
|
|
# define spirit_fifodebug(msg,header,buffer,buflen)
|
|
|
|
#endif
|
|
|
|
|
2017-07-25 00:46:30 +02:00
|
|
|
/******************************************************************************
|
|
|
|
* Name: spirit_lock
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Lock the SPI bus before each transfer, setting the correct SPI
|
|
|
|
* characteristics for the Spirit device. These must be set if there are
|
|
|
|
* multiple devices on the bus because while the bus was unlocked, another
|
|
|
|
* device may have re-configured the SPIO.
|
|
|
|
*
|
2018-03-13 16:52:27 +01:00
|
|
|
* Input Parameters:
|
2017-07-25 00:46:30 +02:00
|
|
|
* spi - Reference to the SPI driver structure
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
* Assumptions:
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
static void spirit_lock(FAR struct spi_dev_s *spi)
|
|
|
|
{
|
|
|
|
/* Lock the SPI bus because there are multiple devices competing for the
|
|
|
|
* SPI bus
|
|
|
|
*/
|
|
|
|
|
2020-01-02 17:49:34 +01:00
|
|
|
SPI_LOCK(spi, true);
|
2017-07-25 00:46:30 +02:00
|
|
|
|
|
|
|
/* We have the lock. Now make sure that the SPI bus is configured for the
|
|
|
|
* Spirit (it might have gotten configured for a different device while
|
|
|
|
* unlocked)
|
|
|
|
*
|
|
|
|
* NOTES:
|
|
|
|
* - The SPIRIT1 SPI is mode 0 (CPOL=0, CPHA=0)
|
|
|
|
* - Data word is 8-bits
|
|
|
|
* - Maximum clock frequency is 10MHz
|
|
|
|
* - Transfers are MS bit first
|
|
|
|
*/
|
|
|
|
|
|
|
|
SPI_SETMODE(spi, SPIDEV_MODE0);
|
|
|
|
SPI_SETBITS(spi, 8);
|
2020-01-02 17:49:34 +01:00
|
|
|
SPI_HWFEATURES(spi, 0);
|
|
|
|
SPI_SETFREQUENCY(spi, CONFIG_WL_SPIRIT_SPIFREQUENCY);
|
2017-07-25 00:46:30 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Name: spirit_unlock
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Un-lock the SPI bus after each transfer, possibly losing the current
|
|
|
|
* configuration if we are sharing the SPI bus with other devices.
|
|
|
|
*
|
2018-03-13 16:52:27 +01:00
|
|
|
* Input Parameters:
|
2017-07-25 00:46:30 +02:00
|
|
|
* spi - Reference to the SPI driver structure
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
* Assumptions:
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
static void spirit_unlock(FAR struct spi_dev_s *spi)
|
|
|
|
{
|
|
|
|
/* Relinquish the SPI bus. */
|
|
|
|
|
2020-01-02 17:49:34 +01:00
|
|
|
SPI_LOCK(spi, false);
|
2017-07-25 00:46:30 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Public Functions
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Name: spirit_reg_read
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Read single or multiple SPIRIT1 register
|
|
|
|
*
|
2018-02-01 17:00:02 +01:00
|
|
|
* Input Parameters:
|
2017-07-25 00:46:30 +02:00
|
|
|
*
|
|
|
|
* regaddr: Base register's address to be read
|
|
|
|
* buffer: Pointer to the buffer of registers' values to be read
|
|
|
|
* buflen: Number of register values to be read
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* Zero (OK) is returned on success. A negated errno value is returned on
|
|
|
|
* any failure. On success, spirit->state is updated.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
int spirit_reg_read(FAR struct spirit_library_s *spirit, uint8_t regaddr,
|
|
|
|
FAR uint8_t *buffer, unsigned int buflen)
|
|
|
|
{
|
|
|
|
uint8_t header[2];
|
|
|
|
uint8_t status[2];
|
|
|
|
|
|
|
|
/* Setup the header bytes */
|
|
|
|
|
|
|
|
header[0] = READ_HEADER;
|
|
|
|
header[1] = regaddr;
|
|
|
|
|
|
|
|
/* Lock the SPI bus and select the Spirit device */
|
|
|
|
|
|
|
|
spirit_lock(spirit->spi);
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), true);
|
|
|
|
|
|
|
|
/* Write the header bytes and read the SPIRIT1 status bytes */
|
|
|
|
|
|
|
|
SPI_EXCHANGE(spirit->spi, header, status, 2);
|
|
|
|
|
2017-08-04 17:03:08 +02:00
|
|
|
/* Update Spirit status. 16-bit status is returned MS byte first */
|
2017-07-25 00:46:30 +02:00
|
|
|
|
|
|
|
spirit->u.u16 = ((uint16_t)status[0] << 8) | (uint16_t)status[1];
|
|
|
|
|
|
|
|
/* Read the register values */
|
|
|
|
|
|
|
|
SPI_RECVBLOCK(spirit->spi, buffer, buflen);
|
|
|
|
|
|
|
|
/* Deselect the Spirit device and return the result */
|
|
|
|
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), false);
|
|
|
|
spirit_unlock(spirit->spi);
|
2017-07-27 19:56:26 +02:00
|
|
|
|
|
|
|
spirit_regdebug("READ", header, buffer, buflen);
|
2017-07-25 00:46:30 +02:00
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Name: spirit_reg_write
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Read single or multiple SPIRIT1 register.
|
|
|
|
*
|
2018-02-01 17:00:02 +01:00
|
|
|
* Input Parameters:
|
2020-02-22 19:31:14 +01:00
|
|
|
* spirit - Reference to an instance of the driver state structure.
|
2017-07-25 00:46:30 +02:00
|
|
|
* regaddr - Base register's address to write
|
|
|
|
* buffer - Pointer to the buffer of register values to write
|
|
|
|
* buflen - Number of registers values to be written.
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* Zero (OK) is returned on success. A negated errno value is returned on
|
|
|
|
* any failure. On success, spirit->state is updated.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
int spirit_reg_write(FAR struct spirit_library_s *spirit, uint8_t regaddr,
|
|
|
|
FAR const uint8_t *buffer, unsigned int buflen)
|
|
|
|
{
|
|
|
|
uint8_t header[2];
|
|
|
|
uint8_t status[2];
|
|
|
|
|
|
|
|
/* Setup the header bytes */
|
|
|
|
|
|
|
|
header[0] = WRITE_HEADER;
|
|
|
|
header[1] = regaddr;
|
2017-07-27 19:56:26 +02:00
|
|
|
spirit_regdebug("WRITE", header, buffer, buflen);
|
2017-07-25 00:46:30 +02:00
|
|
|
|
|
|
|
/* Lock the SPI bus and select the Spirit device */
|
|
|
|
|
|
|
|
spirit_lock(spirit->spi);
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), true);
|
|
|
|
|
|
|
|
/* Write the header bytes and read the SPIRIT1 status bytes */
|
|
|
|
|
|
|
|
SPI_EXCHANGE(spirit->spi, header, status, 2);
|
|
|
|
|
2017-08-04 17:03:08 +02:00
|
|
|
/* Update Spirit status. 16-bit status is returned MS byte first */
|
2017-07-25 00:46:30 +02:00
|
|
|
|
|
|
|
spirit->u.u16 = ((uint16_t)status[0] << 8) | (uint16_t)status[1];
|
|
|
|
|
|
|
|
/* Write the register values */
|
|
|
|
|
|
|
|
SPI_SNDBLOCK(spirit->spi, buffer, buflen);
|
|
|
|
|
|
|
|
/* Deselect the Spirit device and return the result */
|
|
|
|
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), false);
|
|
|
|
spirit_unlock(spirit->spi);
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
2017-08-03 17:55:30 +02:00
|
|
|
/******************************************************************************
|
|
|
|
* Name: spirit_reg_modify
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Perform atomic read/modify/write on a single SPIRIT1 register.
|
|
|
|
*
|
2018-02-01 17:00:02 +01:00
|
|
|
* Input Parameters:
|
2020-02-22 19:31:14 +01:00
|
|
|
* spirit - Reference to an instance of the driver state structure.
|
2017-08-03 17:55:30 +02:00
|
|
|
* regaddr - Base register's address to write
|
|
|
|
* clrbits - Bits to clear in the register
|
2020-02-23 09:50:23 +01:00
|
|
|
* setbits - Bits to set in the register
|
2017-08-03 17:55:30 +02:00
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* Zero (OK) is returned on success. A negated errno value is returned on
|
|
|
|
* any failure. On success, spirit->state is updated.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
int spirit_reg_modify(FAR struct spirit_library_s *spirit, uint8_t regaddr,
|
|
|
|
uint8_t setbits, uint8_t clrbits)
|
|
|
|
{
|
|
|
|
uint8_t header[2];
|
|
|
|
uint8_t status[2];
|
|
|
|
uint8_t regval;
|
|
|
|
|
|
|
|
/* Setup the header byte to read the register */
|
|
|
|
|
|
|
|
header[0] = READ_HEADER;
|
|
|
|
header[1] = regaddr;
|
|
|
|
|
|
|
|
/* Lock the SPI bus and select the Spirit device */
|
|
|
|
|
|
|
|
spirit_lock(spirit->spi);
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), true);
|
|
|
|
|
|
|
|
/* Write the header bytes (ignoring the returned SPIRIT1 status bytes) */
|
|
|
|
|
|
|
|
SPI_SNDBLOCK(spirit->spi, header, 2);
|
|
|
|
|
|
|
|
/* Read the register value */
|
|
|
|
|
|
|
|
regval = SPI_SEND(spirit->spi, 0xff);
|
|
|
|
spirit_regdebug("READ", header, ®val, 1);
|
|
|
|
|
|
|
|
/* Modify the register value */
|
|
|
|
|
|
|
|
regval &= ~clrbits;
|
2017-08-04 17:03:08 +02:00
|
|
|
regval |= setbits;
|
2017-08-03 17:55:30 +02:00
|
|
|
|
|
|
|
/* Setup the header byte for the write operation */
|
|
|
|
|
|
|
|
header[0] = WRITE_HEADER;
|
|
|
|
header[1] = regaddr;
|
|
|
|
spirit_regdebug("WRITE", header, ®val, 1);
|
|
|
|
|
2017-08-03 23:15:15 +02:00
|
|
|
/* Toggle Chip select so that we get the correct status */
|
|
|
|
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), false);
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), true);
|
|
|
|
|
2017-08-03 17:55:30 +02:00
|
|
|
/* Write the header bytes and read the SPIRIT1 status bytes */
|
|
|
|
|
|
|
|
SPI_EXCHANGE(spirit->spi, header, status, 2);
|
|
|
|
|
2017-08-04 17:03:08 +02:00
|
|
|
/* Update Spirit status. 16-bit status is returned MS byte first */
|
2017-08-03 17:55:30 +02:00
|
|
|
|
|
|
|
spirit->u.u16 = ((uint16_t)status[0] << 8) | (uint16_t)status[1];
|
|
|
|
|
|
|
|
/* Write the register value */
|
|
|
|
|
2020-01-02 17:49:34 +01:00
|
|
|
SPI_SEND(spirit->spi, regval);
|
2017-08-03 17:55:30 +02:00
|
|
|
|
|
|
|
/* Deselect the Spirit device and return the result */
|
|
|
|
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), false);
|
|
|
|
spirit_unlock(spirit->spi);
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
2017-07-25 00:46:30 +02:00
|
|
|
/******************************************************************************
|
|
|
|
* Name: spirit_command
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Send a command
|
|
|
|
*
|
2018-02-01 17:00:02 +01:00
|
|
|
* Input Parameters:
|
2020-02-22 19:31:14 +01:00
|
|
|
* spirit - Reference to an instance of the driver state structure.
|
2017-07-25 00:46:30 +02:00
|
|
|
* cmd - Command code to be sent
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* Zero (OK) is returned on success. A negated errno value is returned on
|
|
|
|
* any failure. On success, spirit->state is updated.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
int spirit_command(FAR struct spirit_library_s *spirit, uint8_t cmd)
|
|
|
|
{
|
|
|
|
uint8_t header[2];
|
|
|
|
uint8_t status[2];
|
|
|
|
|
|
|
|
/* Setup the header bytes */
|
|
|
|
|
|
|
|
header[0] = COMMAND_HEADER;
|
|
|
|
header[1] = cmd;
|
2017-07-27 19:56:26 +02:00
|
|
|
spirit_regdebug("CMD", header, NULL, 0);
|
2017-07-25 00:46:30 +02:00
|
|
|
|
|
|
|
/* Lock the SPI bus and select the Spirit device */
|
|
|
|
|
|
|
|
spirit_lock(spirit->spi);
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), true);
|
|
|
|
|
|
|
|
/* Write the header bytes and read the SPIRIT1 status bytes */
|
|
|
|
|
|
|
|
SPI_EXCHANGE(spirit->spi, header, status, 2);
|
|
|
|
|
2017-08-04 17:03:08 +02:00
|
|
|
/* Update Spirit status. 16-bit status is returned MS byte first */
|
2017-07-25 00:46:30 +02:00
|
|
|
|
|
|
|
spirit->u.u16 = ((uint16_t)status[0] << 8) | (uint16_t)status[1];
|
|
|
|
|
|
|
|
/* Deselect the Spirit device and return the result */
|
|
|
|
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), false);
|
|
|
|
spirit_unlock(spirit->spi);
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
/******************************************************************************
|
2017-07-25 23:14:35 +02:00
|
|
|
* Name: spirit_fifo_read
|
2017-07-25 00:46:30 +02:00
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Read data from RX FIFO
|
|
|
|
*
|
2018-02-01 17:00:02 +01:00
|
|
|
* Input Parameters:
|
2020-02-22 19:31:14 +01:00
|
|
|
* spirit - Reference to an instance of the driver state structure.
|
2017-07-25 00:46:30 +02:00
|
|
|
* buffer - Pointer to the buffer of data values to write
|
|
|
|
* buflen - Number of bytes to be written
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* Zero (OK) is returned on success. A negated errno value is returned on
|
|
|
|
* any failure. On success, spirit->state is updated.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
2017-07-25 23:14:35 +02:00
|
|
|
int spirit_fifo_read(FAR struct spirit_library_s *spirit, FAR uint8_t *buffer,
|
|
|
|
unsigned int buflen)
|
2017-07-25 00:46:30 +02:00
|
|
|
{
|
|
|
|
uint8_t header[2];
|
|
|
|
uint8_t status[2];
|
|
|
|
|
|
|
|
/* Setup the header bytes */
|
|
|
|
|
|
|
|
header[0] = READ_HEADER;
|
|
|
|
header[1] = LINEAR_FIFO_ADDRESS;
|
|
|
|
|
|
|
|
/* Lock the SPI bus and select the Spirit device */
|
|
|
|
|
|
|
|
spirit_lock(spirit->spi);
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), true);
|
|
|
|
|
|
|
|
/* Write the header bytes and read the SPIRIT1 status bytes */
|
|
|
|
|
|
|
|
SPI_EXCHANGE(spirit->spi, header, status, 2);
|
|
|
|
|
2017-08-04 17:03:08 +02:00
|
|
|
/* Update Spirit status. 16-bit status is returned MS byte first */
|
2017-07-25 00:46:30 +02:00
|
|
|
|
|
|
|
spirit->u.u16 = ((uint16_t)status[0] << 8) | (uint16_t)status[1];
|
|
|
|
|
|
|
|
/* Read the register values */
|
|
|
|
|
|
|
|
SPI_RECVBLOCK(spirit->spi, buffer, buflen);
|
|
|
|
|
|
|
|
/* Deselect the Spirit device and return the result */
|
|
|
|
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), false);
|
|
|
|
spirit_unlock(spirit->spi);
|
2017-07-27 19:56:26 +02:00
|
|
|
|
|
|
|
spirit_fifodebug("FIFO IN", header, buffer, buflen);
|
2017-07-25 00:46:30 +02:00
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
/******************************************************************************
|
2017-07-25 23:14:35 +02:00
|
|
|
* Name: spirit_fifo_write
|
2017-07-25 00:46:30 +02:00
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Write data into TX FIFO.
|
|
|
|
*
|
2018-02-01 17:00:02 +01:00
|
|
|
* Input Parameters:
|
2020-02-22 19:31:14 +01:00
|
|
|
* spirit - Reference to an instance of the driver state structure.
|
2017-07-25 00:46:30 +02:00
|
|
|
* buffer - Pointer to the buffer of data values to write
|
|
|
|
* buflen - Number of data values to be written.
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* Zero (OK) is returned on success. A negated errno value is returned on
|
|
|
|
* any failure. On success, spirit->state is updated.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
2017-07-25 23:14:35 +02:00
|
|
|
int spirit_fifo_write(FAR struct spirit_library_s *spirit,
|
|
|
|
FAR const uint8_t *buffer, unsigned int buflen)
|
2017-07-25 00:46:30 +02:00
|
|
|
{
|
|
|
|
uint8_t header[2];
|
|
|
|
uint8_t status[2];
|
|
|
|
|
|
|
|
/* Setup the header bytes */
|
|
|
|
|
|
|
|
header[0] = WRITE_HEADER;
|
|
|
|
header[1] = LINEAR_FIFO_ADDRESS;
|
2017-07-27 19:56:26 +02:00
|
|
|
spirit_fifodebug("FIFO OUT", header, buffer, buflen);
|
2017-07-25 00:46:30 +02:00
|
|
|
|
|
|
|
/* Lock the SPI bus and select the Spirit device */
|
|
|
|
|
|
|
|
spirit_lock(spirit->spi);
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), true);
|
|
|
|
|
|
|
|
/* Write the header bytes and read the SPIRIT1 status bytes */
|
|
|
|
|
|
|
|
SPI_EXCHANGE(spirit->spi, header, status, 2);
|
|
|
|
|
2017-08-04 17:03:08 +02:00
|
|
|
/* Update Spirit status. 16-bit status is returned MS byte first */
|
2017-07-25 00:46:30 +02:00
|
|
|
|
|
|
|
spirit->u.u16 = ((uint16_t)status[0] << 8) | (uint16_t)status[1];
|
|
|
|
|
|
|
|
/* Write the fifo values */
|
|
|
|
|
|
|
|
SPI_SNDBLOCK(spirit->spi, buffer, buflen);
|
|
|
|
|
|
|
|
/* Deselect the Spirit device and return the result */
|
|
|
|
|
|
|
|
SPI_SELECT(spirit->spi, SPIDEV_WIRELESS(0), false);
|
|
|
|
spirit_unlock(spirit->spi);
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
* Name: spirit_update_status
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Updates the state field in the driver instance, reading the MC_STATE
|
|
|
|
* register of SPIRIT.
|
|
|
|
*
|
|
|
|
* Input Parameters:
|
2020-02-22 19:31:14 +01:00
|
|
|
* spirit - Reference to an instance of the driver state structure.
|
2017-07-25 00:46:30 +02:00
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* Zero (OK) is returned on success. A negated errno value is returned on
|
|
|
|
* any failure. On success, spirit->state is updated.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
int spirit_update_status(FAR struct spirit_library_s *spirit)
|
|
|
|
{
|
|
|
|
uint8_t regval;
|
|
|
|
|
|
|
|
DEBUGASSERT(spirit != NULL);
|
|
|
|
|
|
|
|
/* Reads the MC_STATUS register to update the spirit->state */
|
|
|
|
|
|
|
|
return spirit_reg_read(spirit, MC_STATE1_BASE, ®val, 1);
|
|
|
|
}
|
2017-08-01 18:31:12 +02:00
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: spirit_waitstatus
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Poll until the Spirit status is the requested value or until a timeout
|
|
|
|
* occurs.
|
|
|
|
*
|
2018-03-13 16:52:27 +01:00
|
|
|
* Input Parameters:
|
2017-08-01 18:31:12 +02:00
|
|
|
* spirit - Reference to a Spirit library state structure instance
|
|
|
|
* state - That that we are waiting for.
|
|
|
|
* msec - Timeout in millisedonds
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* OK on success; a negated errno on a timeout
|
|
|
|
*
|
|
|
|
* Assumptions:
|
|
|
|
* We have exclusive access to the driver state and to the spirit library.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
int spirit_waitstatus(FAR struct spirit_library_s *spirit,
|
|
|
|
enum spirit_state_e state, unsigned int msec)
|
|
|
|
{
|
2018-06-16 20:16:13 +02:00
|
|
|
clock_t start;
|
|
|
|
clock_t ticks;
|
|
|
|
clock_t elapsed;
|
2017-08-01 18:31:12 +02:00
|
|
|
int ret;
|
|
|
|
|
2017-08-01 21:48:59 +02:00
|
|
|
#ifdef CONFIG_DEBUG_SPI_INFO
|
|
|
|
/* If the SPI logic is generating debug output, then a longer timeout is
|
|
|
|
* probably needed.
|
|
|
|
*/
|
|
|
|
|
|
|
|
msec <<= 4;
|
|
|
|
#endif
|
|
|
|
|
2017-08-01 18:31:12 +02:00
|
|
|
/* Convert the MSEC timedelay to clock ticks, making sure that the
|
|
|
|
* resulting delay in ticks is greater than or equal to the requested time
|
|
|
|
* in MSEC.
|
|
|
|
*
|
|
|
|
* REVIST: If USEC_PER_TICK and 'msec' are large, then the second
|
|
|
|
* computation may overflow!
|
|
|
|
*/
|
|
|
|
|
|
|
|
#if (MSEC_PER_TICK * USEC_PER_MSEC) == USEC_PER_TICK
|
|
|
|
ticks = (msec + (MSEC_PER_TICK - 1)) / MSEC_PER_TICK;
|
|
|
|
#else
|
2018-06-16 20:16:13 +02:00
|
|
|
ticks = ((clock_t)msec * USEC_PER_MSEC + (USEC_PER_TICK - 1)) /
|
2017-08-01 18:31:12 +02:00
|
|
|
USEC_PER_TICK;
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* The time that we started the wait */
|
|
|
|
|
|
|
|
start = clock_systimer();
|
|
|
|
|
|
|
|
/* Loop until the status change occurs (or the wait times out) */
|
|
|
|
|
|
|
|
do
|
|
|
|
{
|
|
|
|
ret = spirit_update_status(spirit);
|
|
|
|
if (ret < 0)
|
|
|
|
{
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
|
|
|
elapsed = clock_systimer() - start;
|
|
|
|
}
|
|
|
|
while (spirit->u.state.MC_STATE != state && elapsed <= ticks);
|
|
|
|
|
2017-08-01 21:48:59 +02:00
|
|
|
if (spirit->u.state.MC_STATE == state)
|
|
|
|
{
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
2017-08-07 17:22:16 +02:00
|
|
|
/* This is probably not an error. In a busy radio environment, there
|
|
|
|
* are many race conditions. Most typically, just when the driver is
|
|
|
|
* setting up to perform a transmission, the hardware commits to a
|
|
|
|
* reception. The symptom is that the the above loop times out out
|
|
|
|
* waiting to go into the TX state (because it is in the RX state).
|
|
|
|
*
|
|
|
|
* Complaining with too much debug output just aggravates the problem.
|
|
|
|
*/
|
|
|
|
|
|
|
|
wlinfo("Timed out: %lu > %lu (%u msec)\n",
|
2017-08-01 21:48:59 +02:00
|
|
|
(unsigned long)elapsed, (unsigned long)ticks, msec);
|
2017-08-07 17:22:16 +02:00
|
|
|
wlinfo("with MC status: current=%02x desired=%02x\n",
|
2017-08-01 21:48:59 +02:00
|
|
|
spirit->u.state.MC_STATE, state);
|
|
|
|
return -ETIMEDOUT;
|
2017-08-01 18:31:12 +02:00
|
|
|
}
|