Files
nuttx/drivers/wireless/cc1101.c
Chip L. 075215cd5b wireless/cc1101: migrate to wlioc_rx_hdr_s and add operation modes
This commit refactors the CC1101 driver's read interface to comply with
the standard NuttX wireless character driver API and introduces extended
hardware operation modes.

- Migrate `cc1101_file_read` to accept and populate the standard
  `struct wlioc_rx_hdr_s` instead of returning raw byte arrays.
- Implement `cc1101_calc_rssi_dbm_x100` to preserve the hardware's
  0.5 dBm RSSI precision when scaling to 1/100 dBm units, eliminating
  the integer truncation loss present in the legacy calculation.
- Add `CC1101IOC_SETOPMODE` and `CC1101IOC_GETOPMODE` IOCTLs.
- Introduce four RF operation modes (`enum cc1101_opmode_e`):
  1. NORMAL: Standard packet mode with hardware filtering.
  2. PROMISCUOUS: Packet mode bypassing address filtering and retaining
     packets with CRC errors.
  3. SYNC_SERIAL: Bypasses FIFO, routes clock and data to GDO0/GDO2.
  4. ASYNC_SERIAL: Bypasses FIFO, routes async data to GDO2.
- Fix the `GS2200M_FIRST` IOCTL block offset in `wireless/ioctl.h` and
  allocate a dedicated IOCTL block for CC1101.

Signed-off-by: Chip L. <chplee@gmail.com>
2026-03-11 02:25:50 +08:00

2121 lines
57 KiB
C

/****************************************************************************
* drivers/wireless/cc1101.c
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership. The
* ASF licenses this file to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*
****************************************************************************/
/* Features:
* - Maximum data length: 61 bytes CC1101_PACKET_MAXDATALEN
* - Packet length includes two additional bytes: CC1101_PACKET_MAXTOTALLEN
* - Requires one GDO to trigger end-of-packets in RX and TX modes.
* - Variable packet length with data payload between 1..61 bytes
* (three bytes are reserved for packet length, and RSSI and LQI
* appended at the end of RXFIFO after each reception)
* - Support for General Digital Outputs with overload protection
* (single XOSC pin is allowed, otherwise error is returned)
* - Loadable RF settings, one for ISM Region 1 (Europe) and one for
* ISM Region 2 (Complete America)
*
* Todo:
* - Extend max packet length up to 255 bytes or rather
* infinite < 4096 bytes
* - Power up/down modes
* - Sequencing between states or add protection for correct termination of
* various different state (so that CC1101 does not block in case of
* improper use)
*
* RSSI and LQI value interpretation
*
* The LQI can be read from the LQI status register or it can be appended
* to the received packet in the RX FIFO. LQI is a metric of the current
* quality of the received signal. The LQI gives an estimate of how easily
* a received signal can be demodulated by accumulating the magnitude of
* the error between ideal constellations and the received signal over
* the 64 symbols immediately following the sync word. LQI is best used
* as a relative measurement of the link quality (a high value indicates
* a better link than what a low value does), since the value is dependent
* on the modulation format.
*
* To simplify: If the received modulation is FSK or GFSK, the receiver
* will measure the frequency of each "bit" and compare it with the
* expected frequency based on the channel frequency and the deviation
* and the measured frequency offset. If other modulations are used, the
* error of the modulated parameter (frequency for FSK/GFSK, phase for
* MSK, amplitude for ASK etc) will be measured against the expected
* ideal value
*
* RSSI (Received Signal Strength Indicator) is a signal strength
* indication. It does not care about the "quality" or "correctness" of
* the signal. LQI does not care about the actual signal strength, but
* the signal quality often is linked to signal strength. This is because
* a strong signal is likely to be less affected by noise and thus will
* be seen as "cleaner" or more "correct" by the receiver.
*
* There are four to five "extreme cases" that can be used to illustrate
* how RSSI and LQI work:
*
* 1. A weak signal in the presence of noise may give low RSSI and low LQI.
* 2. A weak signal in "total" absence of noise may give low RSSI and high
* LQI.
* 3. Strong noise (usually coming from an interferer) may give high RSSI
* and low LQI.
* 4. A strong signal without much noise may give high RSSI and high LQI.
* 5. A very strong signal that causes the receiver to saturate may give
* high RSSI and low LQI.
*
* Note that both RSSI and LQI are best used as relative measurements since
* the values are dependent on the modulation format.
*/
/****************************************************************************
* Included Files
****************************************************************************/
#include <nuttx/config.h>
#include <sys/types.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <fcntl.h>
#include <poll.h>
#include <assert.h>
#include <errno.h>
#include <debug.h>
#include <nuttx/kmalloc.h>
#include <nuttx/signal.h>
#include <nuttx/fs/fs.h>
#include <nuttx/wireless/ioctl.h>
#include <nuttx/wireless/cc1101.h>
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
#define CC1101_SPIFREQ_BURST 6500000 /* Hz, no delay */
#define CC1101_SPIFREQ_SINGLE 9000000 /* Hz, single access only - no delay */
#define CC1101_MCSM0_VALUE 0x1c
/****************************************************************************
* Chipcon CC1101 Internal Registers
****************************************************************************/
/* Configuration Registers */
#define CC1101_IOCFG2 0x00 /* GDO2 output pin configuration */
#define CC1101_IOCFG1 0x01 /* GDO1 output pin configuration */
#define CC1101_IOCFG0 0x02 /* GDO0 output pin configuration */
#define CC1101_FIFOTHR 0x03 /* RX FIFO and TX FIFO thresholds */
#define CC1101_SYNC1 0x04 /* Sync word, high byte */
#define CC1101_SYNC0 0x05 /* Sync word, low byte */
#define CC1101_PKTLEN 0x06 /* Packet length */
#define CC1101_PKTCTRL1 0x07 /* Packet automation control */
#define CC1101_PKTCTRL0 0x08 /* Packet automation control */
#define CC1101_ADDR 0x09 /* Device address */
#define CC1101_CHANNR 0x0a /* Channel number */
#define CC1101_FSCTRL1 0x0b /* Frequency synthesizer control */
#define CC1101_FSCTRL0 0x0c /* Frequency synthesizer control */
#define CC1101_FREQ2 0x0d /* Frequency control word, high byte */
#define CC1101_FREQ1 0x0e /* Frequency control word, middle byte */
#define CC1101_FREQ0 0x0f /* Frequency control word, low byte */
#define CC1101_MDMCFG4 0x10 /* Modem configuration */
#define CC1101_MDMCFG3 0x11 /* Modem configuration */
#define CC1101_MDMCFG2 0x12 /* Modem configuration */
#define CC1101_MDMCFG1 0x13 /* Modem configuration */
#define CC1101_MDMCFG0 0x14 /* Modem configuration */
#define CC1101_DEVIATN 0x15 /* Modem deviation setting */
#define CC1101_MCSM2 0x16 /* Main Radio Cntrl State Machine config */
#define CC1101_MCSM1 0x17 /* Main Radio Cntrl State Machine config */
#define CC1101_MCSM0 0x18 /* Main Radio Cntrl State Machine config */
#define CC1101_FOCCFG 0x19 /* Frequency Offset Compensation config */
#define CC1101_BSCFG 0x1a /* Bit Synchronization configuration */
#define CC1101_AGCCTRL2 0x1b /* AGC control */
#define CC1101_AGCCTRL1 0x1c /* AGC control */
#define CC1101_AGCCTRL0 0x1d /* AGC control */
#define CC1101_WOREVT1 0x1e /* High byte Event 0 timeout */
#define CC1101_WOREVT0 0x1f /* Low byte Event 0 timeout */
#define CC1101_WORCTRL 0x20 /* Wake On Radio control */
#define CC1101_FREND1 0x21 /* Front end RX configuration */
#define CC1101_FREND0 0x22 /* Front end TX configuration */
#define CC1101_FSCAL3 0x23 /* Frequency synthesizer calibration */
#define CC1101_FSCAL2 0x24 /* Frequency synthesizer calibration */
#define CC1101_FSCAL1 0x25 /* Frequency synthesizer calibration */
#define CC1101_FSCAL0 0x26 /* Frequency synthesizer calibration */
#define CC1101_RCCTRL1 0x27 /* RC oscillator configuration */
#define CC1101_RCCTRL0 0x28 /* RC oscillator configuration */
#define CC1101_FSTEST 0x29 /* Frequency synthesizer cal control */
#define CC1101_PTEST 0x2a /* Production test */
#define CC1101_AGCTEST 0x2b /* AGC test */
#define CC1101_TEST2 0x2c /* Various test settings */
#define CC1101_TEST1 0x2d /* Various test settings */
#define CC1101_TEST0 0x2e /* Various test settings */
/* Status registers */
#define CC1101_PARTNUM (0x30 | 0xc0) /* Part number */
#define CC1101_VERSION (0x31 | 0xc0) /* Current version number */
#define CC1101_FREQEST (0x32 | 0xc0) /* Frequency offset estimate */
#define CC1101_LQI (0x33 | 0xc0) /* Demodulator estimate for link quality */
#define CC1101_RSSI (0x34 | 0xc0) /* Received signal strength indication */
#define CC1101_MARCSTATE (0x35 | 0xc0) /* Control state machine state */
#define CC1101_WORTIME1 (0x36 | 0xc0) /* High byte of WOR timer */
#define CC1101_WORTIME0 (0x37 | 0xc0) /* Low byte of WOR timer */
#define CC1101_PKTSTATUS (0x38 | 0xc0) /* Current GDOx status and packet status */
#define CC1101_VCO_VC_DAC (0x39 | 0xc0) /* Current setting from PLL cal module */
#define CC1101_TXBYTES (0x3a | 0xc0) /* Underflow and # of bytes in TXFIFO */
#define CC1101_RXBYTES (0x3b | 0xc0) /* Overflow and # of bytes in RXFIFO */
#define CC1101_RCCTRL1_STATUS (0x3c | 0xc0) /* Last RC oscillator calibration results */
#define CC1101_RCCTRL0_STATUS (0x3d | 0xc0) /* Last RC oscillator calibration results */
/* Multi byte memory locations */
#define CC1101_PATABLE 0x3e
#define CC1101_TXFIFO 0x3f
#define CC1101_RXFIFO 0x3f
/* Definitions for burst/single access to registers */
#define CC1101_WRITE_BURST 0x40
#define CC1101_READ_SINGLE 0x80
#define CC1101_READ_BURST 0xc0
/* Strobe commands */
#define CC1101_SRES 0x30 /* Reset chip. */
#define CC1101_SFSTXON 0x31 /* Enable and calibrate frequency synthesizer (if MCSM0.FS_AUTOCAL=1). */
#define CC1101_SXOFF 0x32 /* Turn off crystal oscillator. */
#define CC1101_SCAL 0x33 /* Calibrate frequency synthesizer and turn it off */
#define CC1101_SRX 0x34 /* Enable RX. Perform calibration first if switching from IDLE and MCSM0.FS_AUTOCAL=1. */
#define CC1101_STX 0x35 /* Enable TX. Perform calibration first if IDLE and MCSM0.FS_AUTOCAL=1. */
/* If switching from RX state and CCA is enabled then go directly to TX if channel is clear. */
#define CC1101_SIDLE 0x36 /* Exit RX / TX, turn off frequency synthesizer and exit Wake-On-Radio mode if applicable. */
#define CC1101_SAFC 0x37 /* Perform AFC adjustment of the frequency synthesizer */
#define CC1101_SWOR 0x38 /* Start automatic RX polling sequence (Wake-on-Radio) */
#define CC1101_SPWD 0x39 /* Enter power down mode when CSn goes high. */
#define CC1101_SFRX 0x3a /* Flush the RX FIFO buffer. */
#define CC1101_SFTX 0x3b /* Flush the TX FIFO buffer. */
#define CC1101_SWORRST 0x3c /* Reset real time clock. */
#define CC1101_SNOP 0x3d /* No operation. */
/* Modem Control */
#define CC1101_MCSM0_XOSC_FORCE_ON 0x01
/* Chip Status Byte */
/* Bit fields in the chip status byte */
#define CC1101_STATUS_CHIP_RDYn_BM 0x80
#define CC1101_STATUS_STATE_BM 0x70
#define CC1101_STATUS_FIFO_BYTES_AVAILABLE_BM 0x0f
/* Chip states */
#define CC1101_STATE_MASK 0x70
#define CC1101_STATE_IDLE 0x00
#define CC1101_STATE_RX 0x10
#define CC1101_STATE_TX 0x20
#define CC1101_STATE_FSTXON 0x30
#define CC1101_STATE_CALIBRATE 0x40
#define CC1101_STATE_SETTLING 0x50
#define CC1101_STATE_RX_OVERFLOW 0x60
#define CC1101_STATE_TX_UNDERFLOW 0x70
/* Values of the MACRSTATE register */
#define CC1101_MARCSTATE_SLEEP 0x00
#define CC1101_MARCSTATE_IDLE 0x01
#define CC1101_MARCSTATE_XOFF 0x02
#define CC1101_MARCSTATE_VCOON_MC 0x03
#define CC1101_MARCSTATE_REGON_MC 0x04
#define CC1101_MARCSTATE_MANCAL 0x05
#define CC1101_MARCSTATE_VCOON 0x06
#define CC1101_MARCSTATE_REGON 0x07
#define CC1101_MARCSTATE_STARTCAL 0x08
#define CC1101_MARCSTATE_BWBOOST 0x09
#define CC1101_MARCSTATE_FS_LOCK 0x0a
#define CC1101_MARCSTATE_IFADCON 0x0b
#define CC1101_MARCSTATE_ENDCAL 0x0c
#define CC1101_MARCSTATE_RX 0x0d
#define CC1101_MARCSTATE_RX_END 0x0e
#define CC1101_MARCSTATE_RX_RST 0x0f
#define CC1101_MARCSTATE_TXRX_SWITCH 0x10
#define CC1101_MARCSTATE_RXFIFO_OVERFLOW 0x11
#define CC1101_MARCSTATE_FSTXON 0x12
#define CC1101_MARCSTATE_TX 0x13
#define CC1101_MARCSTATE_TX_END 0x14
#define CC1101_MARCSTATE_RXTX_SWITCH 0x15
#define CC1101_MARCSTATE_TXFIFO_UNDERFLOW 0x16
/* Part number and version */
#define CC1101_PARTNUM_VALUE 0x00
#define CC1101_VERSION_VALUE 0x14
/* Others ... */
#define CC1101_LQI_CRC_OK_BM 0x80
#define CC1101_LQI_EST_BM 0x7f
#define FLAGS_RXONLY 1 /* Indicates receive operation only */
#define FLAGS_XOSCENABLED 2 /* Indicates that one pin is configured as XOSC/n */
#ifndef CONFIG_WL_CC1101_RXFIFO_LEN
# define CONFIG_WL_CC1101_RXFIFO_LEN 5
#endif
/****************************************************************************
* Private Function Prototypes
****************************************************************************/
static int cc1101_file_open(FAR struct file *filep);
static int cc1101_file_close(FAR struct file *filep);
static ssize_t cc1101_file_read(FAR struct file *filep, FAR char *buffer,
size_t buflen);
static ssize_t cc1101_file_write(FAR struct file *filep,
FAR const char *buffer,
size_t buflen);
static int cc1101_file_poll(FAR struct file *filep, FAR struct pollfd *fds,
bool setup);
static int cc1101_file_ioctl(FAR struct file *filep, int cmd,
unsigned long arg);
/****************************************************************************
* Private Data
****************************************************************************/
static const struct file_operations g_cc1101ops =
{
cc1101_file_open, /* open */
cc1101_file_close, /* close */
cc1101_file_read, /* read */
cc1101_file_write, /* write */
NULL, /* seek */
cc1101_file_ioctl, /* ioctl */
NULL, /* mmap */
NULL, /* truncate */
cc1101_file_poll /* poll */
};
/****************************************************************************
* Private Functions
****************************************************************************/
/****************************************************************************
* Name: cc1101_file_open
*
* Description:
* This function is called whenever the CC1101 device is opened.
*
****************************************************************************/
static int cc1101_file_open(FAR struct file *filep)
{
FAR struct inode *inode;
FAR struct cc1101_dev_s *dev;
int ret;
wlinfo("Opening CC1101 dev\n");
inode = filep->f_inode;
DEBUGASSERT(inode->i_private);
dev = inode->i_private;
/* Get exclusive access to the driver data structure */
ret = nxmutex_lock(&dev->devlock);
if (ret < 0)
{
return ret;
}
/* Check if device is not already used */
if (dev->nopens > 0)
{
ret = -EBUSY;
goto errout;
}
dev->ops.irq(dev, true);
cc1101_receive(dev);
dev->nopens++;
errout:
nxmutex_unlock(&dev->devlock);
return ret;
}
/****************************************************************************
* Name: cc1101_file_close
*
* Description:
* This routine is called when the CC1101 device is closed.
* It waits for the last remaining data to be sent.
*
****************************************************************************/
static int cc1101_file_close(FAR struct file *filep)
{
FAR struct inode *inode;
FAR struct cc1101_dev_s *dev;
int ret;
wlinfo("Closing CC1101 dev\n");
inode = filep->f_inode;
DEBUGASSERT(inode->i_private);
dev = inode->i_private;
/* Get exclusive access to the driver data structure */
ret = nxmutex_lock(&dev->devlock);
if (ret < 0)
{
return ret;
}
dev->ops.irq(dev, false);
#if 0
nrf24l01_changestate(dev, ST_POWER_DOWN);
#endif
dev->nopens--;
nxmutex_unlock(&dev->devlock);
return OK;
}
/****************************************************************************
* Name: cc1101_file_write
*
* Description:
* Standard driver write method.
*
****************************************************************************/
static ssize_t cc1101_file_write(FAR struct file *filep,
FAR const char *buffer,
size_t buflen)
{
FAR struct inode *inode;
FAR struct cc1101_dev_s *dev;
int ret;
wlinfo("write CC1101 dev\n");
inode = filep->f_inode;
DEBUGASSERT(inode->i_private);
dev = inode->i_private;
/* Get exclusive access to the driver data structure */
ret = nxmutex_lock(&dev->devlock);
if (ret < 0)
{
return ret;
}
ret = cc1101_write(dev, (FAR const uint8_t *)buffer, buflen);
cc1101_send(dev);
nxmutex_unlock(&dev->devlock);
return ret;
}
/****************************************************************************
* Name: fifo_put
*
* Description:
*
****************************************************************************/
static void fifo_put(FAR struct cc1101_dev_s *dev, FAR uint8_t *buffer,
uint8_t buflen)
{
int ret;
int i;
ret = nxmutex_lock(&dev->lock_rx_buffer);
if (ret < 0)
{
return;
}
dev->fifo_len++;
if (dev->fifo_len > CONFIG_WL_CC1101_RXFIFO_LEN)
{
dev->fifo_len = CONFIG_WL_CC1101_RXFIFO_LEN;
dev->nxt_read = (dev->nxt_read + 1) % CONFIG_WL_CC1101_RXFIFO_LEN;
}
for (i = 0; i < (buflen + 1) && i < CC1101_FIFO_SIZE; i++)
{
*(dev->rx_buffer + i + dev->nxt_write * CC1101_FIFO_SIZE) = buffer[i];
}
dev->nxt_write = (dev->nxt_write + 1) % CONFIG_WL_CC1101_RXFIFO_LEN;
nxmutex_unlock(&dev->lock_rx_buffer);
}
/****************************************************************************
* Name: fifo_get
*
* Description:
*
****************************************************************************/
static uint8_t fifo_get(FAR struct cc1101_dev_s *dev, FAR uint8_t *buffer,
uint8_t buflen)
{
uint8_t pktlen;
uint8_t i;
int ret;
ret = nxmutex_lock(&dev->lock_rx_buffer);
if (ret < 0)
{
return ret;
}
if (dev->fifo_len == 0)
{
pktlen = 0;
goto no_data;
}
pktlen = *(dev->rx_buffer + dev->nxt_read * CC1101_FIFO_SIZE);
for (i = 0; i < pktlen && i < CC1101_PACKET_MAXTOTALLEN; i++)
{
*(buffer++) =
dev->rx_buffer[dev->nxt_read * CC1101_FIFO_SIZE + i + 1];
}
dev->nxt_read = (dev->nxt_read + 1) % CONFIG_WL_CC1101_RXFIFO_LEN;
dev->fifo_len--;
no_data:
nxmutex_unlock(&dev->lock_rx_buffer);
return pktlen;
}
/****************************************************************************
* Name: cc1101_file_read
*
* Description:
* Standard driver read method
*
****************************************************************************/
static ssize_t cc1101_file_read(FAR struct file *filep, FAR char *buffer,
size_t buflen)
{
uint8_t raw_buf[CC1101_PACKET_MAXTOTALLEN];
FAR struct wlioc_rx_hdr_s *hdr;
FAR struct cc1101_dev_s *dev;
size_t actual_payload_len;
FAR struct inode *inode;
size_t user_max_len;
size_t copy_len;
uint8_t lqi_crc;
uint8_t pktlen;
int raw_rssi;
int ret;
inode = filep->f_inode;
DEBUGASSERT(inode->i_private);
dev = inode->i_private;
ret = nxmutex_lock(&dev->devlock);
if (ret < 0)
{
return ret;
}
if ((filep->f_oflags & O_NONBLOCK) != 0)
{
nxsem_trywait(&dev->sem_rx);
ret = 0;
}
else
{
ret = nxsem_wait(&dev->sem_rx);
}
if (ret < 0)
{
return ret;
}
/* If in serial mode, return not supported directly, because data does
* not go over SPI and FIFO.
*/
if (dev->opmode == CC1101_OPMODE_SYNC_SERIAL ||
dev->opmode == CC1101_OPMODE_ASYNC_SERIAL)
{
nxmutex_unlock(&dev->devlock);
return -EOPNOTSUPP;
}
/* Verify if the user-passed buffer is a valid struct pointer. */
if (buflen != sizeof(struct wlioc_rx_hdr_s))
{
nxmutex_unlock(&dev->devlock);
return -EINVAL;
}
hdr = (FAR struct wlioc_rx_hdr_s *)buffer;
/* Get the user-provided max capacity of the receive buffer. */
user_max_len = hdr->payload_length;
if (hdr->payload_buffer == NULL)
{
nxmutex_unlock(&dev->devlock);
return -EINVAL;
}
pktlen = fifo_get(dev, raw_buf, sizeof(raw_buf));
if (pktlen == 0)
{
nxmutex_unlock(&dev->devlock);
return 0;
}
/* pktlen contains the payload plus 2 bytes of status. */
actual_payload_len = (size_t)(pktlen - 2);
/* Fill metadata (fixed index: subtract 2 and 1). */
raw_rssi = raw_buf[pktlen - 2];
lqi_crc = raw_buf[pktlen - 1];
hdr->rssi_dbm = cc1101_calc_rssi_dbm_x100(raw_rssi);
hdr->snr_db = (int32_t)(lqi_crc & CC1101_LQI_EST_BM) * 100;
hdr->error = (lqi_crc & CC1101_LQI_CRC_OK_BM) ? 0 : 1;
/* Copy the actual data to the user's payload_buffer (fixed starting
* point: raw_buf[0]).
*/
copy_len = (actual_payload_len > user_max_len) ?
user_max_len : actual_payload_len;
memcpy(hdr->payload_buffer, &raw_buf[0], copy_len);
/* Update the length to the actual written length. */
hdr->payload_length = copy_len;
nxmutex_unlock(&dev->devlock);
return sizeof(struct wlioc_rx_hdr_s);
}
/****************************************************************************
* Name: nrf24l01_poll
*
* Description:
* Standard driver poll method.
*
****************************************************************************/
static int cc1101_file_poll(FAR struct file *filep, FAR struct pollfd *fds,
bool setup)
{
FAR struct inode *inode;
FAR struct cc1101_dev_s *dev;
int ret;
wlinfo("setup: %d\n", (int)setup);
DEBUGASSERT(fds);
inode = filep->f_inode;
DEBUGASSERT(inode->i_private);
dev = inode->i_private;
/* Exclusive access */
ret = nxmutex_lock(&dev->devlock);
if (ret < 0)
{
return ret;
}
/* Are we setting up the poll? Or tearing it down? */
if (setup)
{
/* Ignore waits that do not include POLLIN */
if ((fds->events & POLLIN) == 0)
{
ret = -EDEADLK;
goto errout;
}
/* Check if we can accept this poll.
* For now, only one thread can poll the device at any time
* (shorter / simpler code)
*/
if (dev->pfd)
{
ret = -EBUSY;
goto errout;
}
dev->pfd = fds;
/* Is there is already data in the fifo? then trigger POLLIN now -
* don't wait for RX.
*/
nxmutex_lock(&dev->lock_rx_buffer);
if (dev->fifo_len > 0)
{
poll_notify(&fds, 1, POLLIN);
}
nxmutex_unlock(&dev->lock_rx_buffer);
}
else /* Tear it down */
{
dev->pfd = NULL;
}
errout:
nxmutex_unlock(&dev->devlock);
return ret;
}
/****************************************************************************
* Name: cc1101_access_begin
*
* Description:
*
****************************************************************************/
void cc1101_access_begin(FAR struct cc1101_dev_s *dev)
{
SPI_LOCK(dev->spi, true);
SPI_SELECT(dev->spi, dev->dev_id, true);
SPI_SETMODE(dev->spi, SPIDEV_MODE0); /* CPOL=0, CPHA=0 */
SPI_SETBITS(dev->spi, 8);
SPI_HWFEATURES(dev->spi, 0);
if (dev->ops.wait)
{
dev->ops.wait(dev, dev->miso_pin);
}
else
{
nxsched_usleep(150 * 1000);
}
}
/****************************************************************************
* Name: cc1101_access_end
*
* Description:
*
****************************************************************************/
void cc1101_access_end(FAR struct cc1101_dev_s *dev)
{
SPI_SELECT(dev->spi, dev->dev_id, false);
SPI_LOCK(dev->spi, false);
}
/****************************************************************************
* Name: cc1101_access
*
* Description:
* CC1101 Access with Range Check
*
* Input Parameters:
* dev - CC1101 Private Structure
* addr - CC1101 Address
* buf - Pointer to buffer, either for read or write access
* length - When >0 it denotes read access, when <0 it denotes write
* access of -length. abs(length) greater of 1 implies burst mode,
* however
*
* Returned Value:
* OK on success or a negated errno value on any failure.
*
****************************************************************************/
int cc1101_access(FAR struct cc1101_dev_s *dev, uint8_t addr,
FAR uint8_t *buf, int length)
{
int stabyte;
/* Address cannot explicitly define READ command while length WRITE.
* Also access to these cells is only permitted as one byte, even though
* transfer is marked as BURST!
*/
if ((addr & CC1101_READ_SINGLE) && length != 1)
{
return -EINVAL;
}
/* Prepare SPI */
cc1101_access_begin(dev);
if (length > 1 || length < -1)
{
SPI_SETFREQUENCY(dev->spi, CC1101_SPIFREQ_BURST);
}
else
{
SPI_SETFREQUENCY(dev->spi, CC1101_SPIFREQ_SINGLE);
}
/* Transfer */
if (length <= 0)
{
/* 0 length are command strobes */
if (length < -1)
{
addr |= CC1101_WRITE_BURST;
}
stabyte = SPI_SEND(dev->spi, addr);
if (length)
{
SPI_SNDBLOCK(dev->spi, buf, -length);
}
}
else
{
addr |= CC1101_READ_SINGLE;
if (length > 1)
{
addr |= CC1101_READ_BURST;
}
stabyte = SPI_SEND(dev->spi, addr);
SPI_RECVBLOCK(dev->spi, buf, length);
}
cc1101_access_end(dev);
return stabyte;
}
/****************************************************************************
* Name: cc1101_strobe
*
* Description:
* Strobes command and returns chip status byte
*
* By default commands are send as Write. To a command,
* CC1101_READ_SINGLE may be OR'ed to obtain the number of RX bytes
* pending in RX FIFO.
*
****************************************************************************/
uint8_t cc1101_strobe(struct cc1101_dev_s *dev, uint8_t command)
{
uint8_t status;
cc1101_access_begin(dev);
SPI_SETFREQUENCY(dev->spi, CC1101_SPIFREQ_SINGLE);
status = SPI_SEND(dev->spi, command);
cc1101_access_end(dev);
return status;
}
/****************************************************************************
* Name: cc1101_reset
*
* Description:
*
****************************************************************************/
int cc1101_reset(struct cc1101_dev_s *dev)
{
cc1101_strobe(dev, CC1101_SRES);
return OK;
}
/****************************************************************************
* Name: cc1101_checkpart
*
* Description:
*
****************************************************************************/
int cc1101_checkpart(struct cc1101_dev_s *dev)
{
uint8_t partnum;
uint8_t version;
if (cc1101_access(dev, CC1101_PARTNUM, &partnum, 1) < 0 ||
cc1101_access(dev, CC1101_VERSION, &version, 1) < 0)
{
return -ENODEV;
}
wlinfo("CC1101 cc1101_checkpart 0x%X 0x%X\n", partnum, version);
#ifndef CONFIG_WL_CC1101_IGNORE_VERSION
/* Strict official silicon validation */
if (partnum == CC1101_PARTNUM_VALUE && version == CC1101_VERSION_VALUE)
{
return OK;
}
#else
/* Bypass for third-party clone silicon (e.g., VERSION == 0x00) */
if (partnum == CC1101_PARTNUM_VALUE)
{
if (version != CC1101_VERSION_VALUE)
{
wlwarn("WARNING: Unofficial CC1101 version 0x%02x detected.\\n",
version);
}
return OK;
}
#endif
return -ENOTSUP;
}
/****************************************************************************
* Name: cc1101_dumpregs
*
* Description:
* Dump the specified range of registers to the syslog.
*
* WARNING: Uses around 75 bytes of stack!
*
****************************************************************************/
void cc1101_dumpregs(struct cc1101_dev_s *dev, uint8_t addr, uint8_t length)
{
char outbuf[3 * 16 + 1];
uint8_t regbuf[16];
int readsize;
int remaining;
int i;
int j;
for (remaining = length; remaining > 0; remaining -= 16, addr += 16)
{
/* Read up to 16 registers into a buffer */
readsize = remaining;
if (readsize > 16)
{
readsize = 16;
}
cc1101_access(dev, addr, (FAR uint8_t *)regbuf, readsize);
/* Format the output data */
for (i = 0, j = 0; i < readsize; i++, j += 3)
{
snprintf(&outbuf[j], sizeof(outbuf) - j, " %02x", regbuf[i]);
}
/* Dump the formatted data to the syslog output */
wlinfo("CC1101[%2x]:%s\n", addr, outbuf);
}
}
/****************************************************************************
* Name: cc1101_setpacketctrl
*
* Description:
*
****************************************************************************/
void cc1101_setpacketctrl(struct cc1101_dev_s *dev)
{
uint8_t values[3];
values[0] = dev->rfsettings->FIFOTHR;
values[1] = dev->rfsettings->SYNC1;
values[2] = dev->rfsettings->SYNC0;
cc1101_access(dev, CC1101_FIFOTHR, values, -3);
/* Packet length
* Limit it to 61 bytes in total: pktlen, data[61], rssi, lqi
*/
values[0] = CC1101_PACKET_MAXDATALEN;
cc1101_access(dev, CC1101_PKTLEN, values, -1);
/* Packet Control */
values[0] = dev->rfsettings->PKTCTRL1; /* Append status: RSSI and LQI at the
* end of received packet */
/* TODO: CRC Auto Flash bit 0x08 ??? */
values[1] = dev->rfsettings->PKTCTRL0; /* CRC in Rx and Tx Enabled: Variable
* Packet mode, defined by first byte */
/* TODO: Enable data whitening ... */
cc1101_access(dev, CC1101_PKTCTRL1, values, -2);
/* Main Radio Control State Machine */
values[0] = 0x07; /* No time-out */
values[1] = 0x03; /* Clear channel if RSSI < thr && !receiving;
* TX -> RX, RX -> RX: 0x3f */
values[2] =
CC1101_MCSM0_VALUE; /* Calibrate on IDLE -> RX/TX, OSC Timeout = ~500 us
* TODO: has XOSC_FORCE_ON */
cc1101_access(dev, CC1101_MCSM2, values, -3);
/* Wake-On Radio Control */
/* Not used yet. */
/* WOREVT1:WOREVT0 - 16-bit timeout register */
}
/****************************************************************************
* Public Functions
****************************************************************************/
/****************************************************************************
* Name: cc1101_init2
*
* Description:
*
****************************************************************************/
int cc1101_init2(FAR struct cc1101_dev_s *dev)
{
int ret;
DEBUGASSERT(dev);
/* Reset chip, check status bytes */
ret = cc1101_reset(dev);
if (ret < 0)
{
return ret;
}
/* Check part compatibility */
ret = cc1101_checkpart(dev);
if (ret < 0)
{
return ret;
}
cc1101_setgdo(dev, CC1101_PIN_GDO0, CC1101_GDO_HIZ);
cc1101_setgdo(dev, CC1101_PIN_GDO1, CC1101_GDO_HIZ);
cc1101_setgdo(dev, CC1101_PIN_GDO2, CC1101_GDO_HIZ);
cc1101_setrf(dev, dev->rfsettings);
cc1101_setpacketctrl(dev);
cc1101_setgdo(dev, dev->gdo, CC1101_GDO_SYNC);
cc1101_dumpregs(dev, CC1101_PIN_GDO2, 39);
dev->status = CC1101_IDLE;
return 0;
}
/****************************************************************************
* Name: cc1101_init
*
* Description:
*
****************************************************************************/
FAR struct cc1101_dev_s *cc1101_init(
FAR struct spi_dev_s *spi, uint32_t isr_pin, uint32_t miso_pin,
FAR const struct c1101_rfsettings_s *rfsettings, wait_cc1101_ready wait)
{
FAR struct cc1101_dev_s *dev;
DEBUGASSERT(spi);
dev = kmm_malloc(sizeof(struct cc1101_dev_s));
if (dev == NULL)
{
return NULL;
}
dev->isr_pin = isr_pin;
dev->miso_pin = miso_pin;
dev->rfsettings = rfsettings;
dev->spi = spi;
dev->flags = 0;
dev->channel = rfsettings->CHMIN;
dev->power = rfsettings->PAMAX;
/* Reset chip, check status bytes */
if (cc1101_reset(dev) < 0)
{
kmm_free(dev);
return NULL;
}
/* Check part compatibility */
if (cc1101_checkpart(dev) < 0)
{
kmm_free(dev);
return NULL;
}
/* Configure CC1101:
* - disable GDOx for best performance
* - load RF
* - and packet control
*/
cc1101_setgdo(dev, CC1101_PIN_GDO0, CC1101_GDO_HIZ);
cc1101_setgdo(dev, CC1101_PIN_GDO1, CC1101_GDO_HIZ);
cc1101_setgdo(dev, CC1101_PIN_GDO2, CC1101_GDO_HIZ);
cc1101_setrf(dev, rfsettings);
cc1101_setpacketctrl(dev);
/* Set the ISR to be triggered on falling edge of the:
*
* 6 (0x06) Asserts when sync word has been sent / received, and
* de-asserts at the end of the packet. In RX, the pin will de-assert
* when the optional address check fails or the RX FIFO overflows.
* In TX the pin will de-assert if the TX FIFO underflows.
*/
cc1101_setgdo(dev, dev->gdo, CC1101_GDO_SYNC);
/* Configure to receive interrupts on the external GPIO interrupt line.
*
* REVISIT: There is no MCU-independent way to do this in this
* context.
*/
return dev;
}
/****************************************************************************
* Name: cc1101_deinit
*
* Description:
*
****************************************************************************/
int cc1101_deinit(FAR struct cc1101_dev_s *dev)
{
DEBUGASSERT(dev);
/* Release the external GPIO interrupt
*
* REVISIT: There is no MCU-independent way to do this in this
* context.
*/
/* Power down chip */
cc1101_powerdown(dev);
/* Release external interrupt line */
kmm_free(dev);
return 0;
}
/****************************************************************************
* Name: cc1101_powerup
*
* Description:
*
****************************************************************************/
int cc1101_powerup(FAR struct cc1101_dev_s *dev)
{
DEBUGASSERT(dev);
return 0;
}
/****************************************************************************
* Name: cc1101_powerdown
*
* Description:
*
****************************************************************************/
int cc1101_powerdown(FAR struct cc1101_dev_s *dev)
{
DEBUGASSERT(dev);
return 0;
}
/****************************************************************************
* Name: cc1101_setgdo
*
* Description:
*
****************************************************************************/
int cc1101_setgdo(FAR struct cc1101_dev_s *dev, uint8_t pin,
uint8_t function)
{
DEBUGASSERT(dev);
DEBUGASSERT(pin <= CC1101_IOCFG0);
if (function >= CC1101_GDO_CLK_XOSC1)
{
/* Only one pin can be enabled at a time as XOSC/n */
if (dev->flags & FLAGS_XOSCENABLED)
{
return -EPERM;
}
/* Force XOSC to stay active even in sleep mode */
int value = CC1101_MCSM0_VALUE | CC1101_MCSM0_XOSC_FORCE_ON;
cc1101_access(dev, CC1101_MCSM0, (FAR uint8_t *)&value, -1);
dev->flags |= FLAGS_XOSCENABLED;
}
else if (dev->flags & FLAGS_XOSCENABLED)
{
/* Disable XOSC in sleep mode */
int value = CC1101_MCSM0_VALUE;
cc1101_access(dev, CC1101_MCSM0, (FAR uint8_t *)&value, -1);
dev->flags &= ~FLAGS_XOSCENABLED;
}
return cc1101_access(dev, pin, &function, -1);
}
/****************************************************************************
* Name: cc1101_setrf
*
* Description:
*
****************************************************************************/
int cc1101_setrf(FAR struct cc1101_dev_s *dev,
FAR const struct c1101_rfsettings_s *settings)
{
int ret;
DEBUGASSERT(dev);
DEBUGASSERT(settings);
ret = cc1101_access(dev, CC1101_FSCTRL1,
(FAR uint8_t *)&settings->FSCTRL1, -11);
if (ret < 0)
{
return -EIO;
}
ret = cc1101_access(dev, CC1101_FOCCFG,
(FAR uint8_t *)&settings->FOCCFG, -5);
if (ret < 0)
{
return -EIO;
}
ret = cc1101_access(dev, CC1101_FREND1,
(FAR uint8_t *)&settings->FREND1, -6);
if (ret < 0)
{
return -EIO;
}
/* Load Power Table */
ret = cc1101_access(dev, CC1101_PATABLE, (FAR uint8_t *)settings->PA, -8);
if (ret < 0)
{
return -EIO;
}
/* If channel is out of valid range, mark that. Limit power.
* We are not allowed to send any data, but are allowed to listen
* and receive.
*/
cc1101_setchannel(dev, dev->channel);
cc1101_setpower(dev, dev->power);
return OK;
}
/****************************************************************************
* Name: cc1101_setchannel
*
* Description:
*
****************************************************************************/
int cc1101_setchannel(FAR struct cc1101_dev_s *dev, uint8_t channel)
{
DEBUGASSERT(dev);
/* Store locally in further checks */
dev->channel = channel;
/* If channel is out of valid, we are allowed to listen and receive only */
if (channel < dev->rfsettings->CHMIN || channel > dev->rfsettings->CHMAX)
{
dev->flags |= FLAGS_RXONLY;
}
else
{
dev->flags &= ~FLAGS_RXONLY;
}
cc1101_access(dev, CC1101_CHANNR, &dev->channel, -1);
return dev->flags;
}
/****************************************************************************
* Name: cc1101_setpower
*
* Description:
*
****************************************************************************/
uint8_t cc1101_setpower(FAR struct cc1101_dev_s *dev, uint8_t power)
{
DEBUGASSERT(dev);
if (power > dev->rfsettings->PAMAX)
{
power = dev->rfsettings->PAMAX;
}
dev->power = power;
if (power == 0)
{
dev->flags |= FLAGS_RXONLY;
return 0;
}
else
{
dev->flags &= ~FLAGS_RXONLY;
}
/* Add remaining part from RF table (to get rid of readback) */
power--;
power |= dev->rfsettings->FREND0;
/* On error, report that as zero power */
if (cc1101_access(dev, CC1101_FREND0, &power, -1) < 0)
{
dev->power = 0;
}
return dev->power;
}
/****************************************************************************
* Name: cc1101_calc_rssi_dbm
*
* Description:
*
****************************************************************************/
int cc1101_calc_rssi_dbm(int rssi)
{
if (rssi >= 128)
{
rssi -= 256;
}
return (rssi >> 1) - 74;
}
/****************************************************************************
* Name: cc1101_calc_rssi_dbm_x100
*
* Description:
*
****************************************************************************/
int cc1101_calc_rssi_dbm_x100(int rssi)
{
if (rssi >= 128)
{
rssi -= 256;
}
/* (rssi / 2 - 74) * 100 => rssi * 50 - 7400 */
return (rssi * 50) - 7400;
}
/****************************************************************************
* Name: cc1101_receive
*
* Description:
*
****************************************************************************/
int cc1101_receive(FAR struct cc1101_dev_s *dev)
{
DEBUGASSERT(dev);
/* REVISIT: Wait for IDLE before going into another state? */
dev->status = CC1101_RECV;
cc1101_strobe(dev, CC1101_SRX | CC1101_READ_SINGLE);
return 0;
}
/****************************************************************************
* Name: cc1101_read
*
* Description:
*
****************************************************************************/
int cc1101_read(FAR struct cc1101_dev_s *dev, FAR uint8_t *buf, size_t size)
{
uint8_t nbytes = 0;
DEBUGASSERT(dev);
if (buf == NULL || size == 0)
{
cc1101_strobe(dev, CC1101_SRX);
return 0;
}
cc1101_access(dev, CC1101_RXFIFO, &nbytes, 1);
if (nbytes & 0x80)
{
wlwarn("RX FIFO full\n");
nbytes = 0;
goto breakout;
}
nbytes += 2; /* RSSI and LQI */
buf[0] = nbytes;
cc1101_access(dev, CC1101_RXFIFO, buf + 1,
(nbytes > size) ? size : nbytes);
/* Flush remaining bytes, if there is no room to receive or if there is a
* BAD CRC
*/
if (!(buf[nbytes] & 0x80))
{
wlwarn("RX CRC error\n");
/* Only clear nbytes and discard packet in non-promiscuous mode. */
if (dev->opmode != CC1101_OPMODE_PROMISCUOUS)
{
nbytes = 0;
}
}
breakout:
cc1101_strobe(dev, CC1101_SIDLE);
cc1101_strobe(dev, CC1101_SFRX);
cc1101_strobe(dev, CC1101_SRX);
return nbytes;
}
/****************************************************************************
* Name: cc1101_write
*
* Description:
*
****************************************************************************/
int cc1101_write(FAR struct cc1101_dev_s *dev, FAR const uint8_t *buf,
size_t size)
{
uint8_t packetlen;
DEBUGASSERT(dev);
DEBUGASSERT(buf);
if (dev->flags & FLAGS_RXONLY)
{
return -EPERM;
}
cc1101_strobe(dev, CC1101_SIDLE);
cc1101_strobe(dev, CC1101_SFTX);
dev->status = CC1101_SEND;
/* Present limit */
if (size > CC1101_PACKET_MAXDATALEN)
{
packetlen = CC1101_PACKET_MAXDATALEN;
}
else
{
packetlen = size;
}
cc1101_access(dev, CC1101_TXFIFO, &packetlen, -1);
cc1101_access(dev, CC1101_TXFIFO, (FAR uint8_t *)buf, -size);
return 0;
}
/****************************************************************************
* Name: cc1101_send
*
* Description:
*
****************************************************************************/
int cc1101_send(FAR struct cc1101_dev_s *dev)
{
DEBUGASSERT(dev);
if (dev->flags & FLAGS_RXONLY)
{
return -EPERM;
}
cc1101_strobe(dev, CC1101_STX);
nxsem_wait(&dev->sem_tx);
/* this is set MCSM1, send auto to rx */
dev->status = CC1101_RECV;
return 0;
}
/****************************************************************************
* Name: cc1101_idle
*
* Description:
*
****************************************************************************/
int cc1101_idle(FAR struct cc1101_dev_s *dev)
{
DEBUGASSERT(dev);
cc1101_strobe(dev, CC1101_SIDLE);
return 0;
}
/****************************************************************************
* Name: cc1101_unregister
*
* Description:
*
****************************************************************************/
int cc1101_unregister(FAR struct cc1101_dev_s *dev)
{
DEBUGASSERT(dev);
/* Release IRQ */
dev->ops.irq(dev, false);
/* Free memory */
kmm_free(dev->rx_buffer);
kmm_free(dev);
return OK;
}
/****************************************************************************
* Name: cc1101_register
*
* Description:
*
****************************************************************************/
int cc1101_register(FAR const char *path, FAR struct cc1101_dev_s *dev)
{
DEBUGASSERT(path);
DEBUGASSERT(dev);
dev->status = CC1101_INIT;
dev->rx_buffer =
kmm_malloc(CC1101_FIFO_SIZE * CONFIG_WL_CC1101_RXFIFO_LEN);
if (dev->rx_buffer == NULL)
{
return -ENOMEM;
}
dev->nxt_read = 0;
dev->nxt_write = 0;
dev->fifo_len = 0;
nxmutex_init(&dev->devlock);
nxmutex_init(&dev->lock_rx_buffer);
nxsem_init(&dev->sem_rx, 0, 0);
nxsem_init(&dev->sem_tx, 0, 0);
if (cc1101_init2(dev) < 0)
{
nxmutex_destroy(&dev->devlock);
nxmutex_destroy(&dev->lock_rx_buffer);
nxsem_destroy(&dev->sem_rx);
nxsem_destroy(&dev->sem_tx);
kmm_free(dev);
wlerr("ERROR: Failed to initialize cc1101_init\n");
return -ENODEV;
}
return register_driver(path, &g_cc1101ops, 0666, dev);
}
/****************************************************************************
* Name: cc1101_isr_process
*
* Description:
*
****************************************************************************/
void cc1101_isr_process(FAR void *arg)
{
DEBUGASSERT(arg);
FAR struct cc1101_dev_s *dev = (struct cc1101_dev_s *)arg;
switch (dev->status)
{
case CC1101_SEND:
nxsem_post(&dev->sem_tx);
break;
case CC1101_RECV:
{
uint8_t buf[CC1101_FIFO_SIZE];
uint8_t len;
memset(buf, 0, sizeof(buf));
len = cc1101_read(dev, buf, sizeof(buf));
wlinfo("recv==>[%d]\n", len);
if (len < 1)
{
return;
}
fifo_put(dev, buf, len);
nxsem_post(&dev->sem_rx);
if (dev->pfd)
{
poll_notify(&dev->pfd, 1, POLLIN);
}
}
break;
default:
wlwarn("WARNING: Interrupt not processed\n");
break;
}
}
/****************************************************************************
* Name: cc1101_isr
*
* Description:
*
****************************************************************************/
int cc1101_isr(int irq, FAR void *context, FAR void *arg)
{
FAR struct cc1101_dev_s *dev = (struct cc1101_dev_s *)arg;
DEBUGASSERT(arg);
work_queue(HPWORK, &dev->irq_work, cc1101_isr_process, arg, 0);
return 0;
}
/****************************************************************************
* Name: cc1101_file_ioctl
*
* Description:
* Standard driver ioctl method. Maps common RF IOCTLs to CC1101 registers.
*
****************************************************************************/
static int cc1101_file_ioctl(FAR struct file *filep, int cmd,
unsigned long arg)
{
FAR struct inode *inode;
FAR struct cc1101_dev_s *dev;
int ret = OK;
const uint32_t f_xosc = 26000000; /* CC1101 typical XOSC is 26 MHz */
/* Pointer castings moved to the top of the function per coding style */
FAR uint32_t *ptr32 = (FAR uint32_t *)((uintptr_t)arg);
FAR int32_t *ptr32_s = (FAR int32_t *)((uintptr_t)arg);
FAR uint8_t *ptr8 = (FAR uint8_t *)((uintptr_t)arg);
FAR enum wlioc_modulation_e *mod =
(FAR enum wlioc_modulation_e *)((uintptr_t)arg);
wlinfo("cmd: %d arg: %ld\n", cmd, arg);
inode = filep->f_inode;
DEBUGASSERT(inode->i_private);
dev = inode->i_private;
/* Get exclusive access to the driver data structure */
ret = nxmutex_lock(&dev->devlock);
if (ret < 0)
{
return ret;
}
/* Process the IOCTL by command */
switch (cmd)
{
/* 1. Radio Frequency */
case WLIOC_SETRADIOFREQ:
{
uint64_t freq_word;
uint8_t regs[3];
uint8_t channr;
DEBUGASSERT(ptr32 != NULL);
freq_word = ((uint64_t)(*ptr32) << 16) / f_xosc;
regs[0] = (uint8_t)((freq_word >> 16) & 0xff);
regs[1] = (uint8_t)((freq_word >> 8) & 0xff);
regs[2] = (uint8_t)(freq_word & 0xff);
ret = cc1101_access(dev, CC1101_FREQ2, regs, -3);
if (ret >= 0)
{
channr = 0;
ret = cc1101_access(dev, CC1101_CHANNR, &channr, -1);
if (ret >= 0)
{
ret = OK;
}
}
}
break;
case WLIOC_GETRADIOFREQ:
{
uint8_t regs[3];
uint32_t freq_word;
DEBUGASSERT(ptr32 != NULL);
ret = cc1101_access(dev, CC1101_FREQ2, regs, 3);
if (ret >= 0)
{
freq_word = (regs[0] << 16) | (regs[1] << 8) | regs[2];
*ptr32 = (uint32_t)(((uint64_t)freq_word * f_xosc) >> 16);
ret = OK;
}
}
break;
/* 2. Node Address */
case WLIOC_SETADDR:
{
DEBUGASSERT(ptr8 != NULL);
ret = cc1101_access(dev, CC1101_ADDR, ptr8, -1);
if (ret >= 0)
{
ret = OK;
}
}
break;
case WLIOC_GETADDR:
{
DEBUGASSERT(ptr8 != NULL);
ret = cc1101_access(dev, CC1101_ADDR, ptr8, 1);
if (ret >= 0)
{
ret = OK;
}
}
break;
/* 3. Output Power */
case WLIOC_SETTXPOWER:
{
DEBUGASSERT(ptr32_s != NULL);
cc1101_setpower(dev, (uint8_t)*ptr32_s);
ret = OK;
}
break;
case WLIOC_GETTXPOWER:
{
DEBUGASSERT(ptr32_s != NULL);
*ptr32_s = (int32_t)dev->power;
ret = OK;
}
break;
/* 4. Modulation Technology */
case WLIOC_SETMODU:
{
uint8_t mdmcfg2;
DEBUGASSERT(mod != NULL);
ret = cc1101_access(dev, CC1101_MDMCFG2, &mdmcfg2, 1);
if (ret >= 0)
{
mdmcfg2 &= ~0x70;
switch (*mod)
{
case WLIOC_FSK:
mdmcfg2 |= 0x00;
break;
case WLIOC_GFSK:
mdmcfg2 |= 0x10;
break;
case WLIOC_OOK:
mdmcfg2 |= 0x30;
break;
default:
ret = -ENOTSUP;
break;
}
if (ret >= 0)
{
ret = cc1101_access(dev, CC1101_MDMCFG2, &mdmcfg2, -1);
if (ret >= 0)
{
ret = OK;
}
}
}
}
break;
case WLIOC_GETMODU:
{
uint8_t mdmcfg2;
uint8_t mod_format;
DEBUGASSERT(mod != NULL);
ret = cc1101_access(dev, CC1101_MDMCFG2, &mdmcfg2, 1);
if (ret >= 0)
{
mod_format = (mdmcfg2 & 0x70) >> 4;
switch (mod_format)
{
case 0x00:
case 0x04:
*mod = WLIOC_FSK;
break;
case 0x01:
*mod = WLIOC_GFSK;
break;
case 0x03:
*mod = WLIOC_OOK;
break;
default:
ret = -ENOTSUP;
break;
}
if (ret >= 0)
{
ret = OK;
}
}
}
break;
/* 5. Bitrate / Data Rate */
case WLIOC_FSK_SETBITRATE:
case WLIOC_OOK_SETBITRATE:
{
uint64_t w;
uint8_t e = 0;
uint8_t m;
uint8_t mdmcfg4;
DEBUGASSERT(ptr32 != NULL);
w = ((uint64_t)(*ptr32) << 28) / f_xosc;
while (w > 511 && e < 15)
{
w >>= 1;
e++;
}
if (w < 256)
{
w = 256;
}
m = (uint8_t)(w - 256);
ret = cc1101_access(dev, CC1101_MDMCFG4, &mdmcfg4, 1);
if (ret >= 0)
{
mdmcfg4 = (mdmcfg4 & 0xf0) | (e & 0x0f);
ret = cc1101_access(dev, CC1101_MDMCFG4, &mdmcfg4, -1);
if (ret >= 0)
{
ret = cc1101_access(dev, CC1101_MDMCFG3, &m, -1);
if (ret >= 0)
{
ret = OK;
}
}
}
}
break;
case WLIOC_FSK_GETBITRATE:
case WLIOC_OOK_GETBITRATE:
{
uint8_t mdmcfg4;
uint8_t mdmcfg3;
uint8_t e;
uint8_t m;
DEBUGASSERT(ptr32 != NULL);
if (cc1101_access(dev, CC1101_MDMCFG4, &mdmcfg4, 1) >= 0 &&
cc1101_access(dev, CC1101_MDMCFG3, &mdmcfg3, 1) >= 0)
{
e = mdmcfg4 & 0x0f;
m = mdmcfg3;
*ptr32 = (uint32_t)((((uint64_t)(256 + m) << e) *
f_xosc) >> 28);
ret = OK;
}
else
{
ret = -EIO;
}
}
break;
/* 6. FSK Frequency Deviation */
case WLIOC_FSK_SETFDEV:
{
uint64_t w;
uint8_t e = 0;
uint8_t m;
uint8_t deviatn;
DEBUGASSERT(ptr32 != NULL);
w = ((uint64_t)(*ptr32) << 17) / f_xosc;
while (w > 15 && e < 7)
{
w >>= 1;
e++;
}
if (w < 8)
{
w = 8;
}
m = (uint8_t)(w - 8);
deviatn = (e << 4) | (m & 0x07);
ret = cc1101_access(dev, CC1101_DEVIATN, &deviatn, -1);
if (ret >= 0)
{
ret = OK;
}
}
break;
case WLIOC_FSK_GETFDEV:
{
uint8_t deviatn;
uint8_t e;
uint8_t m;
DEBUGASSERT(ptr32 != NULL);
ret = cc1101_access(dev, CC1101_DEVIATN, &deviatn, 1);
if (ret >= 0)
{
e = (deviatn >> 4) & 0x07;
m = deviatn & 0x07;
*ptr32 = (uint32_t)((((uint64_t)(8 + m) << e) * f_xosc) >> 17);
ret = OK;
}
}
break;
case WLIOC_SETFINEPOWER:
case WLIOC_GETFINEPOWER:
ret = -ENOSYS;
break;
case CC1101IOC_SETOPMODE:
{
enum cc1101_opmode_e new_mode = (enum cc1101_opmode_e)arg;
uint8_t pktctrl0;
uint8_t pktctrl1;
uint8_t iocfg0;
uint8_t iocfg2;
/* 1. Restore baseline settings (read from rfsettings). */
/* Clear PKT_FORMAT bits. */
pktctrl0 = dev->rfsettings->PKTCTRL0 & ~0x30;
pktctrl1 = dev->rfsettings->PKTCTRL1;
/* 2. Modify registers depending on mode. */
switch (new_mode)
{
case CC1101_OPMODE_NORMAL:
/* Default behavior: Use FIFO, keep rfsettings filtering
* rules.
*/
break;
case CC1101_OPMODE_PROMISCUOUS:
/* Promiscuous mode: Still use FIFO (PKT_FORMAT=0).
* Disable address check (ADR_CHK=00), enable append status
* (APPEND_STATUS=1). Disable CRC autoflush
* (CRC_AUTOFLUSH=0).
*/
pktctrl1 = (pktctrl1 & ~0x0b) | 0x04;
break;
case CC1101_OPMODE_SYNC_SERIAL:
/* Synchronous serial: PKT_FORMAT=1.
* Configure GDO pins to output clock and data.
*/
pktctrl0 |= 0x10;
/* GDO0 outputs synchronous clock. */
iocfg0 = CC1101_GDO_SSCLK;
/* GDO2 outputs synchronous data. */
iocfg2 = CC1101_GDO_SSDO;
cc1101_setgdo(dev, CC1101_PIN_GDO0, iocfg0);
cc1101_setgdo(dev, CC1101_PIN_GDO2, iocfg2);
break;
case CC1101_OPMODE_ASYNC_SERIAL:
/* Asynchronous serial: PKT_FORMAT=3. */
pktctrl0 |= 0x30;
/* GDO2 outputs asynchronous data. */
iocfg2 = CC1101_GDO_ASDO;
cc1101_setgdo(dev, CC1101_PIN_GDO2, iocfg2);
break;
default:
ret = -EINVAL;
goto ioctl_out;
}
/* 3. Pre-load configuration to registers. */
if (cc1101_access(dev, CC1101_PKTCTRL0, &pktctrl0, -1) >= 0 &&
cc1101_access(dev, CC1101_PKTCTRL1, &pktctrl1, -1) >= 0)
{
dev->opmode = new_mode;
ret = OK;
}
else
{
ret = -EIO;
}
ioctl_out:
break;
}
case CC1101IOC_GETOPMODE:
{
FAR *(enum cc1101_opmode_e *)arg = dev->opmode;
ret = OK;
break;
}
default:
ret = -ENOTTY;
break;
}
nxmutex_unlock(&dev->devlock);
return ret;
}