Quelle ca8210.c
Sprache: C
/* * http : //www.cascoda.com/products/ca-821x/ * Copyright ( c ) 2016 , Cascoda , Ltd . * All rights reserved . * * This code is dual - licensed under both GPLv2 and 3 - clause BSD . What follows is * the license notice for both respectively . * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * This program is free software ; you can redistribute it and / or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation ; either version 2 * of the License , or ( at your option ) any later version . * * This program is distributed in the hope that it will be useful , * but WITHOUT ANY WARRANTY ; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE . See the * GNU General Public License for more details . * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Redistribution and use in source and binary forms , with or without * modification , are permitted provided that the following conditions are met : * * 1 . Redistributions of source code must retain the above copyright notice , * this list of conditions and the following disclaimer . * * 2 . Redistributions in binary form must reproduce the above copyright notice , * this list of conditions and the following disclaimer in the documentation * and / or other materials provided with the distribution . * * 3 . Neither the name of the copyright holder nor the names of its contributors * may be used to endorse or promote products derived from this software without * specific prior written permission . * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS " AS IS " * AND ANY EXPRESS OR IMPLIED WARRANTIES , INCLUDING , BUT NOT LIMITED TO , THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED . IN NO EVENT SHALL THE COPYRIGHT HOLDERS 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 . #include <linux/cdev.h>#include <linux/clk-provider.h>#include <linux/debugfs.h>#include <linux/delay.h>#include <linux/gpio/consumer.h>#include <linux/ieee802154.h>#include <linux/io.h>#include <linux/kfifo.h>#include <linux/of.h>#include <linux/module.h>#include <linux/mutex.h>#include <linux/poll.h>#include <linux/skbuff.h>#include <linux/slab.h>#include <linux/spi/spi.h>#include <linux/spinlock.h>#include <linux/string.h>#include <linux/workqueue.h>#include <linux/interrupt.h>#include <net/ieee802154_netdev.h>#include <net/mac802154.h>#define DRIVER_NAME "ca8210" /* external clock frequencies */ #define ONE_MHZ 1000000 #define TWO_MHZ (2 * ONE_MHZ)#define FOUR_MHZ (4 * ONE_MHZ)#define EIGHT_MHZ (8 * ONE_MHZ)#define SIXTEEN_MHZ (16 * ONE_MHZ)/* spi constants */ #define CA8210_SPI_BUF_SIZE 256 #define CA8210_SYNC_TIMEOUT 1000 /* Timeout for synchronous commands [ms] */ /* test interface constants */ #define CA8210_TEST_INT_FILE_NAME "ca8210_test" #define CA8210_TEST_INT_FIFO_SIZE 256 /* HWME attribute IDs */ #define HWME_EDTHRESHOLD (0 x04)#define HWME_EDVALUE (0 x06)#define HWME_SYSCLKOUT (0 x0F)#define HWME_LQILIMIT (0 x11)/* TDME attribute IDs */ #define TDME_CHANNEL (0 x00)#define TDME_ATM_CONFIG (0 x06)#define MAX_HWME_ATTRIBUTE_SIZE 16 #define MAX_TDME_ATTRIBUTE_SIZE 2 /* PHY/MAC PIB Attribute Enumerations */ #define PHY_CURRENT_CHANNEL (0 x00)#define PHY_TRANSMIT_POWER (0 x02)#define PHY_CCA_MODE (0 x03)#define MAC_ASSOCIATION_PERMIT (0 x41)#define MAC_AUTO_REQUEST (0 x42)#define MAC_BATT_LIFE_EXT (0 x43)#define MAC_BATT_LIFE_EXT_PERIODS (0 x44)#define MAC_BEACON_PAYLOAD (0 x45)#define MAC_BEACON_PAYLOAD_LENGTH (0 x46)#define MAC_BEACON_ORDER (0 x47)#define MAC_GTS_PERMIT (0 x4d)#define MAC_MAX_CSMA_BACKOFFS (0 x4e)#define MAC_MIN_BE (0 x4f)#define MAC_PAN_ID (0 x50)#define MAC_PROMISCUOUS_MODE (0 x51)#define MAC_RX_ON_WHEN_IDLE (0 x52)#define MAC_SHORT_ADDRESS (0 x53)#define MAC_SUPERFRAME_ORDER (0 x54)#define MAC_ASSOCIATED_PAN_COORD (0 x56)#define MAC_MAX_BE (0 x57)#define MAC_MAX_FRAME_RETRIES (0 x59)#define MAC_RESPONSE_WAIT_TIME (0 x5A)#define MAC_SECURITY_ENABLED (0 x5D)#define MAC_AUTO_REQUEST_SECURITY_LEVEL (0 x78)#define MAC_AUTO_REQUEST_KEY_ID_MODE (0 x79)#define NS_IEEE_ADDRESS (0 xFF) /* Non-standard IEEE address */ /* MAC Address Mode Definitions */ #define MAC_MODE_NO_ADDR (0 x00)#define MAC_MODE_SHORT_ADDR (0 x02)#define MAC_MODE_LONG_ADDR (0 x03)/* MAC constants */ #define MAX_BEACON_OVERHEAD (75 )#define MAX_BEACON_PAYLOAD_LENGTH (IEEE802154_MTU - MAX_BEACON_OVERHEAD)#define MAX_ATTRIBUTE_SIZE (122 )#define MAX_DATA_SIZE (114 )#define CA8210_VALID_CHANNELS (0 x07FFF800)/* MAC workarounds for V1.1 and MPW silicon (V0.x) */ #define CA8210_MAC_WORKAROUNDS (0 )#define CA8210_MAC_MPW (0 )/* memory manipulation macros */ #define LS_BYTE(x) ((u8)((x) & 0 xFF))#define MS_BYTE(x) ((u8)(((x) >> 8 ) & 0 xFF))/* message ID codes in SPI commands */ /* downstream */ #define MCPS_DATA_REQUEST (0 x00)#define MLME_ASSOCIATE_REQUEST (0 x02)#define MLME_ASSOCIATE_RESPONSE (0 x03)#define MLME_DISASSOCIATE_REQUEST (0 x04)#define MLME_GET_REQUEST (0 x05)#define MLME_ORPHAN_RESPONSE (0 x06)#define MLME_RESET_REQUEST (0 x07)#define MLME_RX_ENABLE_REQUEST (0 x08)#define MLME_SCAN_REQUEST (0 x09)#define MLME_SET_REQUEST (0 x0A)#define MLME_START_REQUEST (0 x0B)#define MLME_POLL_REQUEST (0 x0D)#define HWME_SET_REQUEST (0 x0E)#define HWME_GET_REQUEST (0 x0F)#define TDME_SETSFR_REQUEST (0 x11)#define TDME_GETSFR_REQUEST (0 x12)#define TDME_SET_REQUEST (0 x14)/* upstream */ #define MCPS_DATA_INDICATION (0 x00)#define MCPS_DATA_CONFIRM (0 x01)#define MLME_RESET_CONFIRM (0 x0A)#define MLME_SET_CONFIRM (0 x0E)#define MLME_START_CONFIRM (0 x0F)#define HWME_SET_CONFIRM (0 x12)#define HWME_GET_CONFIRM (0 x13)#define HWME_WAKEUP_INDICATION (0 x15)#define TDME_SETSFR_CONFIRM (0 x17)/* SPI command IDs */ /* bit indicating a confirm or indication from slave to master */ #define SPI_S2M (0 x20)/* bit indicating a synchronous message */ #define SPI_SYN (0 x40)/* SPI command definitions */ #define SPI_IDLE (0 xFF)#define SPI_NACK (0 xF0)#define SPI_MCPS_DATA_REQUEST (MCPS_DATA_REQUEST)#define SPI_MCPS_DATA_INDICATION (MCPS_DATA_INDICATION + SPI_S2M)#define SPI_MCPS_DATA_CONFIRM (MCPS_DATA_CONFIRM + SPI_S2M)#define SPI_MLME_ASSOCIATE_REQUEST (MLME_ASSOCIATE_REQUEST)#define SPI_MLME_RESET_REQUEST (MLME_RESET_REQUEST + SPI_SYN)#define SPI_MLME_SET_REQUEST (MLME_SET_REQUEST + SPI_SYN)#define SPI_MLME_START_REQUEST (MLME_START_REQUEST + SPI_SYN)#define SPI_MLME_RESET_CONFIRM (MLME_RESET_CONFIRM + SPI_S2M + SPI_SYN)#define SPI_MLME_SET_CONFIRM (MLME_SET_CONFIRM + SPI_S2M + SPI_SYN)#define SPI_MLME_START_CONFIRM (MLME_START_CONFIRM + SPI_S2M + SPI_SYN)#define SPI_HWME_SET_REQUEST (HWME_SET_REQUEST + SPI_SYN)#define SPI_HWME_GET_REQUEST (HWME_GET_REQUEST + SPI_SYN)#define SPI_HWME_SET_CONFIRM (HWME_SET_CONFIRM + SPI_S2M + SPI_SYN)#define SPI_HWME_GET_CONFIRM (HWME_GET_CONFIRM + SPI_S2M + SPI_SYN)#define SPI_HWME_WAKEUP_INDICATION (HWME_WAKEUP_INDICATION + SPI_S2M)#define SPI_TDME_SETSFR_REQUEST (TDME_SETSFR_REQUEST + SPI_SYN)#define SPI_TDME_SET_REQUEST (TDME_SET_REQUEST + SPI_SYN)#define SPI_TDME_SETSFR_CONFIRM (TDME_SETSFR_CONFIRM + SPI_S2M + SPI_SYN)/* TDME SFR addresses */ /* Page 0 */ #define CA8210_SFR_PACFG (0 xB1)#define CA8210_SFR_MACCON (0 xD8)#define CA8210_SFR_PACFGIB (0 xFE)/* Page 1 */ #define CA8210_SFR_LOTXCAL (0 xBF)#define CA8210_SFR_PTHRH (0 xD1)#define CA8210_SFR_PRECFG (0 xD3)#define CA8210_SFR_LNAGX40 (0 xE1)#define CA8210_SFR_LNAGX41 (0 xE2)#define CA8210_SFR_LNAGX42 (0 xE3)#define CA8210_SFR_LNAGX43 (0 xE4)#define CA8210_SFR_LNAGX44 (0 xE5)#define CA8210_SFR_LNAGX45 (0 xE6)#define CA8210_SFR_LNAGX46 (0 xE7)#define CA8210_SFR_LNAGX47 (0 xE9)#define PACFGIB_DEFAULT_CURRENT (0 x3F)#define PTHRH_DEFAULT_THRESHOLD (0 x5A)#define LNAGX40_DEFAULT_GAIN (0 x29) /* 10dB */ #define LNAGX41_DEFAULT_GAIN (0 x54) /* 21dB */ #define LNAGX42_DEFAULT_GAIN (0 x6C) /* 27dB */ #define LNAGX43_DEFAULT_GAIN (0 x7A) /* 30dB */ #define LNAGX44_DEFAULT_GAIN (0 x84) /* 33dB */ #define LNAGX45_DEFAULT_GAIN (0 x8B) /* 34dB */ #define LNAGX46_DEFAULT_GAIN (0 x92) /* 36dB */ #define LNAGX47_DEFAULT_GAIN (0 x96) /* 37dB */ #define CA8210_IOCTL_HARD_RESET (0 x00)/* Structs/Enums */ /** * struct cas_control - spi transfer structure * @ msg : spi_message for each exchange * @ transfer : spi_transfer for each exchange * @ tx_buf : source array for transmission * @ tx_in_buf : array storing bytes received during transmission * @ priv : pointer to private data * * This structure stores all the necessary data passed around during a single * spi exchange . struct cas_control {struct spi_message msg;struct spi_transfer transfer;struct ca8210_priv *priv;/** * struct ca8210_test - ca8210 test interface structure * @ ca8210_dfs_spi_int : pointer to the entry in the debug fs for this device * @ up_fifo : fifo for upstream messages * @ readq : read wait queue * * This structure stores all the data pertaining to the debug interface struct ca8210_test {struct dentry *ca8210_dfs_spi_int;struct kfifo up_fifo;/** * struct ca8210_priv - ca8210 private data structure * @ spi : pointer to the ca8210 spi device object * @ hw : pointer to the ca8210 ieee802154_hw object * @ hw_registered : true if hw has been registered with ieee802154 * @ lock : spinlock protecting the private data area * @ mlme_workqueue : workqueue for triggering MLME Reset * @ irq_workqueue : workqueue for irq processing * @ tx_skb : current socket buffer to transmit * @ nextmsduhandle : msdu handle to pass to the 15 . 4 MAC layer for the * next transmission * @ clk : external clock provided by the ca8210 * @ last_dsn : sequence number of last data packet received , for * resend detection * @ test : test interface data section for this instance * @ async_tx_pending : true if an asynchronous transmission was started and * is not complete * @ sync_command_response : pointer to buffer to fill with sync response * @ ca8210_is_awake : nonzero if ca8210 is initialised , ready for comms * @ sync_down : counts number of downstream synchronous commands * @ sync_up : counts number of upstream synchronous commands * @ spi_transfer_complete : completion object for a single spi_transfer * @ sync_exchange_complete : completion object for a complete synchronous API * exchange * @ promiscuous : whether the ca8210 is in promiscuous mode or not * @ retries : records how many times the current pending spi * transfer has been retried struct ca8210_priv {struct spi_device *spi;struct ieee802154_hw *hw;bool hw_registered;struct workqueue_struct *mlme_workqueue;struct workqueue_struct *irq_workqueue;struct sk_buff *tx_skb;struct clk *clk;int last_dsn;struct ca8210_test test;bool async_tx_pending;struct completion ca8210_is_awake;int sync_down, sync_up;struct completion spi_transfer_complete, sync_exchange_complete;bool promiscuous;int retries;/** * struct work_priv_container - link between a work object and the relevant * device ' s private data * @ work : work object being executed * @ priv : device ' s private data section * struct work_priv_container {struct work_struct work;struct ca8210_priv *priv;/** * struct ca8210_platform_data - ca8210 platform data structure * @ extclockenable : true if the external clock is to be enabled * @ extclockfreq : frequency of the external clock * @ extclockgpio : ca8210 output gpio of the external clock * @ reset_gpio : ca8210 reset GPIO descriptor * @ irq_gpio : ca8210 interrupt GPIO descriptor * @ irq_id : identifier for the ca8210 irq * struct ca8210_platform_data {bool extclockenable;unsigned int extclockfreq;unsigned int extclockgpio;struct gpio_desc *reset_gpio;struct gpio_desc *irq_gpio;int irq_id;/** * struct fulladdr - full MAC addressing information structure * @ mode : address mode ( none , short , extended ) * @ pan_id : 16 - bit LE pan id * @ address : LE address , variable length as specified by mode * struct fulladdr {2 ];8 ];/** * union macaddr : generic MAC address container * @ short_address : 16 - bit short address * @ ieee_address : 64 - bit extended address as LE byte array * union macaddr {8 ];/** * struct secspec : security specification for SAP commands * @ security_level : 0 - 7 , controls level of authentication & encryption * @ key_id_mode : 0 - 3 , specifies how to obtain key * @ key_source : extended key retrieval data * @ key_index : single - byte key identifier * struct secspec {8 ];/* downlink functions parameter set definitions */ struct mcps_data_request_pset {struct fulladdr dst;struct mlme_set_request_pset {struct hwme_set_request_pset {struct hwme_get_request_pset {struct tdme_setsfr_request_pset {/* uplink functions parameter set definitions */ struct hwme_set_confirm_pset {struct hwme_get_confirm_pset {struct tdme_setsfr_confirm_pset {struct mac_message {union {struct mcps_data_request_pset data_req;struct mlme_set_request_pset set_req;struct hwme_set_request_pset hwme_set_req;struct hwme_get_request_pset hwme_get_req;struct tdme_setsfr_request_pset tdme_set_sfr_req;struct hwme_set_confirm_pset hwme_set_cnf;struct hwme_get_confirm_pset hwme_get_cnf;struct tdme_setsfr_confirm_pset tdme_set_sfr_cnf;148 ];union pa_cfg_sfr {struct {3 ;/* reserved */ : 1; 3 ;1 ;struct preamble_cfg_sfr {3 ;3 ;2 ;static int (*cascoda_api_upstream)(const u8 *buf,void *device_ref/** * link_to_linux_err ( ) - Translates an 802 . 15 . 4 return code into the closest * linux error * @ link_status : 802 . 15 . 4 status code * * Return : 0 or Linux error code static int link_to_linux_err(int link_status)if (link_status < 0 ) {/* status is already a Linux code */ return link_status;switch (link_status) {case IEEE802154_SUCCESS:case IEEE802154_REALIGNMENT:return 0 ;case IEEE802154_IMPROPER_KEY_TYPE:return -EKEYREJECTED;case IEEE802154_IMPROPER_SECURITY_LEVEL:case IEEE802154_UNSUPPORTED_LEGACY:case IEEE802154_DENIED:return -EACCES;case IEEE802154_BEACON_LOST:case IEEE802154_NO_ACK:case IEEE802154_NO_BEACON:return -ENETUNREACH;case IEEE802154_CHANNEL_ACCESS_FAILURE:case IEEE802154_TX_ACTIVE:case IEEE802154_SCAN_IN_PROGRESS:return -EBUSY;case IEEE802154_DISABLE_TRX_FAILURE:case IEEE802154_OUT_OF_CAP:return -EAGAIN;case IEEE802154_FRAME_TOO_LONG:return -EMSGSIZE;case IEEE802154_INVALID_GTS:case IEEE802154_PAST_TIME:return -EBADSLT;case IEEE802154_INVALID_HANDLE:return -EBADMSG;case IEEE802154_INVALID_PARAMETER:case IEEE802154_UNSUPPORTED_ATTRIBUTE:case IEEE802154_ON_TIME_TOO_LONG:case IEEE802154_INVALID_INDEX:return -EINVAL;case IEEE802154_NO_DATA:return -ENODATA;case IEEE802154_NO_SHORT_ADDRESS:return -EFAULT;case IEEE802154_PAN_ID_CONFLICT:return -EADDRINUSE;case IEEE802154_TRANSACTION_EXPIRED:return -ETIME;case IEEE802154_TRANSACTION_OVERFLOW:return -ENOBUFS;case IEEE802154_UNAVAILABLE_KEY:return -ENOKEY;case IEEE802154_INVALID_ADDRESS:return -ENXIO;case IEEE802154_TRACKING_OFF:case IEEE802154_SUPERFRAME_OVERLAP:return -EREMOTEIO;case IEEE802154_LIMIT_REACHED:return -EDQUOT;case IEEE802154_READ_ONLY:return -EROFS;default :return -EPROTO;/** * ca8210_test_int_driver_write ( ) - Writes a message to the test interface to be * read by the userspace * @ buf : Buffer containing upstream message * @ len : length of message to write * @ spi : SPI device of message originator * * Return : 0 or linux error code static int ca8210_test_int_driver_write(const u8 *buf,void *spistruct ca8210_priv *priv = spi_get_drvdata(spi);struct ca8210_test *test = &priv->test;char *fifo_buffer;int i;"test_interface: Buffering upstream message:\n" for (i = 0 ; i < len; i++)"%#03x\n" , buf[i]);if (!fifo_buffer)return -ENOMEM;4 );return 0 ;/* SPI Operation */ static int ca8210_net_rx(struct ieee802154_hw *hw,static u8 mlme_reset_request_sync(void *device_refstatic int ca8210_spi_transfer(struct spi_device *spi,const u8 *buf,/** * ca8210_reset_send ( ) - Hard resets the ca8210 for a given time * @ spi : Pointer to target ca8210 spi device * @ ms : Milliseconds to hold the reset line low for static void ca8210_reset_send(struct spi_device *spi, unsigned int ms)struct device *dev = &spi->dev;struct ca8210_platform_data *pdata = dev_get_platdata(dev);struct ca8210_priv *priv = spi_get_drvdata(spi);long status;1 );0 );false ;/* Wait until wakeup indication seen */ if (status == 0 ) {"Fatal: No wakeup from ca8210 after reset!\n" "Reset the device\n" );/** * ca8210_mlme_reset_worker ( ) - Resets the MLME , Called when the MAC OVERFLOW * condition happens . * @ work : Pointer to work being executed static void ca8210_mlme_reset_worker(struct work_struct *work)struct work_priv_container *wpc = container_of(struct work_priv_container,struct ca8210_priv *priv = wpc->priv;0 , priv->spi);/** * ca8210_rx_done ( ) - Calls various message dispatches responding to a received * command * @ cas_ctl : Pointer to the cas_control object for the relevant spi transfer * * Presents a received SAP command from the ca8210 to the Cascoda EVBME , test * interface and network driver . static void ca8210_rx_done(struct cas_control *cas_ctl)unsigned int len;struct work_priv_container *mlme_reset_wpc;struct ca8210_priv *priv = cas_ctl->priv;1 ] + 2 ;if (len > CA8210_SPI_BUF_SIZE) {"Received packet len (%u) erroneously long\n" ,goto finish;if (buf[0 ] & SPI_SYN) {if (priv->sync_command_response) {else {if (cascoda_api_upstream)else {if (cascoda_api_upstream)if (buf[0 ] == SPI_MCPS_DATA_CONFIRM) {if (buf[3 ] == IEEE802154_TRANSACTION_OVERFLOW) {"Waiting for transaction overflow to stabilise...\n" );2000 );"Resetting MAC...\n" );sizeof (*mlme_reset_wpc),if (!mlme_reset_wpc)goto finish;else if (buf[0 ] == SPI_HWME_WAKEUP_INDICATION) {"Wakeup indication received, reason:\n" switch (buf[2 ]) {case 0 :"Transceiver woken up from Power Up / System Reset\n" break ;case 1 :"Watchdog Timer Time-Out\n" break ;case 2 :"Transceiver woken up from Power-Off by Sleep Timer Time-Out\n" );break ;case 3 :"Transceiver woken up from Power-Off by GPIO Activity\n" break ;case 4 :"Transceiver woken up from Standby by Sleep Timer Time-Out\n" break ;case 5 :"Transceiver woken up from Standby by GPIO Activity\n" break ;case 6 :"Sleep-Timer Time-Out in Active Mode\n" break ;default :"Wakeup reason unknown\n" );break ;static void ca8210_remove(struct spi_device *spi_device);/** * ca8210_spi_transfer_complete ( ) - Called when a single spi transfer has * completed * @ context : Pointer to the cas_control object for the finished transfer static void ca8210_spi_transfer_complete(void *context)struct cas_control *cas_ctl = context;struct ca8210_priv *priv = cas_ctl->priv;bool duplex_rx = false ;int i;if (0 ] == SPI_NACK ||0 ] == SPI_IDLE &&1 ] == SPI_NACK)/* ca8210 is busy */ "ca8210 was busy during attempted write\n" );if (cas_ctl->tx_buf[0 ] == SPI_IDLE) {"IRQ servicing NACKd, dropping transfer\n" return ;if (priv->retries > 3 ) {"too many retries!\n" );return ;"retried spi write\n" );return ;else if (0 ] != SPI_IDLE &&0 ] != SPI_NACKtrue ;if (duplex_rx) {"READ CMD DURING TX\n" );for (i = 0 ; i < cas_ctl->tx_in_buf[1 ] + 2 ; i++)"%#03x\n" ,0 ;/** * ca8210_spi_transfer ( ) - Initiate duplex spi transfer with ca8210 * @ spi : Pointer to spi device for transfer * @ buf : Octet array to send * @ len : length of the buffer being sent * * Return : 0 or linux error code static int ca8210_spi_transfer(struct spi_device *spi,const u8 *buf,int i, status = 0 ;struct ca8210_priv *priv;struct cas_control *cas_ctl;if (!spi) {"NULL spi device passed to %s\n" , __func__);return -ENODEV;"%s called\n" , __func__);sizeof (*cas_ctl), GFP_ATOMIC);if (!cas_ctl)return -ENOMEM;for (i = 0 ; i < len; i++)"%#03x\n" , cas_ctl->tx_buf[i]);1 ; /* 1 MOSI line */ 1 ; /* 1 MISO line */ 0 ; /* Use device setting */ 0 ; /* Use device setting */ 0 ;0 ;sizeof (struct mac_message);if (status < 0 ) {"status %d from spi_sync in write\n" ,return status;/** * ca8210_spi_exchange ( ) - Exchange API / SAP commands with the radio * @ buf : Octet array of command being sent downstream * @ len : length of buf * @ response : buffer for storing synchronous response * @ device_ref : spi_device pointer for ca8210 * * Effectively calls ca8210_spi_transfer to write buf [ ] to the spi , then for * synchronous commands waits for the corresponding response to be read from * the spi before returning . The response is written to the response parameter . * * Return : 0 or linux error code static int ca8210_spi_exchange(const u8 *buf,void *device_refint status = 0 ;struct spi_device *spi = device_ref;struct ca8210_priv *priv = spi->dev.driver_data;long wait_remaining;if ((buf[0 ] & SPI_SYN) && response) { /* if sync wait for confirm */ do {if (status) {"spi write failed, returned %d\n" ,if (status == -EBUSY)continue ;if (((buf[0 ] & SPI_SYN) && response))goto cleanup;1000 )if (wait_remaining == -ERESTARTSYS) {else if (wait_remaining == 0 ) {"SPI downstream transfer timed out!\n" goto cleanup;while (status < 0 );if (!((buf[0 ] & SPI_SYN) && response))goto cleanup;if (wait_remaining == -ERESTARTSYS) {else if (wait_remaining == 0 ) {"Synchronous confirm timeout\n" return status;/** * ca8210_interrupt_handler ( ) - Called when an irq is received from the ca8210 * @ irq : Id of the irq being handled * @ dev_id : Pointer passed by the system , pointing to the ca8210 ' s private data * * This function is called when the irq line from the ca8210 is asserted , * signifying that the ca8210 has a message to send upstream to us . Starts the * asynchronous spi read . * * Return : irq return code static irqreturn_t ca8210_interrupt_handler(int irq, void *dev_id)struct ca8210_priv *priv = dev_id;int status;"irq: Interrupt occurred\n" );do {0 );if (status && (status != -EBUSY)) {"spi read failed, returned %d\n" ,while (status == -EBUSY);return IRQ_HANDLED;static int (*cascoda_api_downstream)(const u8 *buf,void *device_ref/* Cascoda API / 15.4 SAP Primitives */ /** * tdme_setsfr_request_sync ( ) - TDME_SETSFR_request / confirm according to API * @ sfr_page : SFR Page * @ sfr_address : SFR Address * @ sfr_value : SFR Value * @ device_ref : Nondescript pointer to target device * * Return : 802 . 15 . 4 status code of TDME - SETSFR . confirm static u8 tdme_setsfr_request_sync(void *device_refint ret;struct mac_message command, response;struct spi_device *spi = device_ref;3 ;2 ,if (ret) {"cascoda_api_downstream returned %d" , ret);return IEEE802154_SYSTEM_ERROR;if (response.command_id != SPI_TDME_SETSFR_CONFIRM) {"sync response to SPI_TDME_SETSFR_REQUEST was not SPI_TDME_SETSFR_CONFIRM, it was %d\n" ,return IEEE802154_SYSTEM_ERROR;return response.pdata.tdme_set_sfr_cnf.status;/** * tdme_chipinit ( ) - TDME Chip Register Default Initialisation Macro * @ device_ref : Nondescript pointer to target device * * Return : 802 . 15 . 4 status code of API calls static u8 tdme_chipinit(void *device_ref)struct spi_device *spi = device_ref;struct preamble_cfg_sfr pre_cfg_value = {3 ,3 ,1 ,/* LNA Gain Settings */ 1 , (sfr_address = CA8210_SFR_LNAGX40),if (status)goto finish;1 , (sfr_address = CA8210_SFR_LNAGX41),if (status)goto finish;1 , (sfr_address = CA8210_SFR_LNAGX42),if (status)goto finish;1 , (sfr_address = CA8210_SFR_LNAGX43),if (status)goto finish;1 , (sfr_address = CA8210_SFR_LNAGX44),if (status)goto finish;1 , (sfr_address = CA8210_SFR_LNAGX45),if (status)goto finish;1 , (sfr_address = CA8210_SFR_LNAGX46),if (status)goto finish;1 , (sfr_address = CA8210_SFR_LNAGX47),if (status)goto finish;/* Preamble Timing Config */ 1 , (sfr_address = CA8210_SFR_PRECFG),if (status)goto finish;/* Preamble Threshold High */ 1 , (sfr_address = CA8210_SFR_PTHRH),if (status)goto finish;/* Tx Output Power 8 dBm */ 0 , (sfr_address = CA8210_SFR_PACFGIB),if (status)goto finish;if (status != IEEE802154_SUCCESS) {"failed to set sfr at %#03x, status = %#03x\n" ,return status;/** * tdme_channelinit ( ) - TDME Channel Register Default Initialisation Macro ( Tx ) * @ channel : 802 . 15 . 4 channel to initialise chip for * @ device_ref : Nondescript pointer to target device * * Return : 802 . 15 . 4 status code of API calls static u8 tdme_channelinit(u8 channel, void *device_ref)/* Transceiver front-end local oscillator tx two-point calibration * value . Tuned for the hardware . if (channel >= 25 )0 xA7;else if (channel >= 23 )0 xA8;else if (channel >= 22 )0 xA9;else if (channel >= 20 )0 xAA;else if (channel >= 17 )0 xAB;else if (channel >= 16 )0 xAC;else if (channel >= 14 )0 xAD;else if (channel >= 12 )0 xAE;else 0 xAF;return tdme_setsfr_request_sync(1 ,/* LO Tx Cal */ /** * tdme_checkpibattribute ( ) - Checks Attribute Values that are not checked in * MAC * @ pib_attribute : Attribute Number * @ pib_attribute_length : Attribute length * @ pib_attribute_value : Pointer to Attribute Value * * Return : 802 . 15 . 4 status code of checks static u8 tdme_checkpibattribute(const void *pib_attribute_valueswitch (pib_attribute) {/* PHY */ case PHY_TRANSMIT_POWER:if (value > 0 x3F)break ;case PHY_CCA_MODE:if (value > 0 x03)break ;/* MAC */ case MAC_BATT_LIFE_EXT_PERIODS:if (value < 6 || value > 41 )break ;case MAC_BEACON_PAYLOAD:if (pib_attribute_length > MAX_BEACON_PAYLOAD_LENGTH)break ;case MAC_BEACON_PAYLOAD_LENGTH:if (value > MAX_BEACON_PAYLOAD_LENGTH)break ;case MAC_BEACON_ORDER:if (value > 15 )break ;case MAC_MAX_BE:if (value < 3 || value > 8 )break ;case MAC_MAX_CSMA_BACKOFFS:if (value > 5 )break ;case MAC_MAX_FRAME_RETRIES:if (value > 7 )break ;case MAC_MIN_BE:if (value > 8 )break ;case MAC_RESPONSE_WAIT_TIME:if (value < 2 || value > 64 )break ;case MAC_SUPERFRAME_ORDER:if (value > 15 )break ;/* boolean */ case MAC_ASSOCIATED_PAN_COORD:case MAC_ASSOCIATION_PERMIT:case MAC_AUTO_REQUEST:case MAC_BATT_LIFE_EXT:case MAC_GTS_PERMIT:case MAC_PROMISCUOUS_MODE:case MAC_RX_ON_WHEN_IDLE:case MAC_SECURITY_ENABLED:if (value > 1 )break ;/* MAC SEC */ case MAC_AUTO_REQUEST_SECURITY_LEVEL:if (value > 7 )break ;case MAC_AUTO_REQUEST_KEY_ID_MODE:if (value > 3 )break ;default :break ;return status;/** * tdme_settxpower ( ) - Sets the tx power for MLME_SET phyTransmitPower * @ txp : Transmit Power * @ device_ref : Nondescript pointer to target device * * Normalised to 802 . 15 . 4 Definition ( 6 - bit , signed ) : * Bit 7 - 6 : not used * Bit 5 - 0 : tx power ( - 32 - + 31 dB ) * * Return : 802 . 15 . 4 status code of api calls static u8 tdme_settxpower(u8 txp, void *device_ref)union pa_cfg_sfr pa_cfg_val;/* extend from 6 to 8 bit */ 0 x3F & txp;if (txp_ext & 0 x20)0 xC0;if (CA8210_MAC_MPW) {if (txp_val > 0 ) {/* 8 dBm: ptrim = 5, itrim = +3 => +4 dBm */ 3 ;5 ;1 ;else {/* 0 dBm: ptrim = 7, itrim = +3 => -6 dBm */ 3 ;7 ;0 ;/* write PACFG */ 0 ,else {/* Look-Up Table for Setting Current and Frequency Trim values * for desired Output Power if (txp_val > 8 ) {0 x3F;else if (txp_val == 8 ) {0 x32;else if (txp_val == 7 ) {0 x22;else if (txp_val == 6 ) {0 x18;else if (txp_val == 5 ) {0 x10;else if (txp_val == 4 ) {0 x0C;else if (txp_val == 3 ) {0 x08;else if (txp_val == 2 ) {0 x05;else if (txp_val == 1 ) {0 x03;else if (txp_val == 0 ) {0 x01;else { /* < 0 */ 0 x00;/* write PACFGIB */ 0 ,return status;/** * mcps_data_request ( ) - mcps_data_request ( Send Data ) according to API Spec * @ src_addr_mode : Source Addressing Mode * @ dst_address_mode : Destination Addressing Mode * @ dst_pan_id : Destination PAN ID * @ dst_addr : Pointer to Destination Address * @ msdu_length : length of Data * @ msdu : Pointer to Data * @ msdu_handle : Handle of Data * @ tx_options : Tx Options Bit Field * @ security : Pointer to Security Structure or NULL * @ device_ref : Nondescript pointer to target device * * Return : 802 . 15 . 4 status code of action static u8 mcps_data_request(union macaddr *dst_addr,struct secspec *security,void *device_refstruct secspec *psec;struct mac_message command;if (dst_address_mode != MAC_MODE_NO_ADDR) {if (dst_address_mode == MAC_MODE_SHORT_ADDR) {0 ] = LS_BYTE(1 ] = MS_BYTE(else { /* MAC_MODE_LONG_ADDR*/ 8 struct secspec *)(command.pdata.data_req.msdu + msdu_length);sizeof (struct mcps_data_request_pset) -if (!security || security->security_level == 0 ) {0 ;1 ;else {sizeof (struct secspec);if (ca8210_spi_transfer(device_ref, &command.command_id,2 ))return IEEE802154_SYSTEM_ERROR;return IEEE802154_SUCCESS;/** * mlme_reset_request_sync ( ) - MLME_RESET_request / confirm according to API Spec * @ set_default_pib : Set defaults in PIB * @ device_ref : Nondescript pointer to target device * * Return : 802 . 15 . 4 status code of MLME - RESET . confirm static u8 mlme_reset_request_sync(void *device_refstruct mac_message command, response;struct spi_device *spi = device_ref;1 ;if (cascoda_api_downstream(2 ,"cascoda_api_downstream failed\n" );return IEEE802154_SYSTEM_ERROR;if (response.command_id != SPI_MLME_RESET_CONFIRM)return IEEE802154_SYSTEM_ERROR;/* reset COORD Bit for Channel Filtering as Coordinator */ if (CA8210_MAC_WORKAROUNDS && set_default_pib && !status) {0 ,0 ,return status;/** * mlme_set_request_sync ( ) - MLME_SET_request / confirm according to API Spec * @ pib_attribute : Attribute Number * @ pib_attribute_index : Index within Attribute if an Array * @ pib_attribute_length : Attribute length * @ pib_attribute_value : Pointer to Attribute Value * @ device_ref : Nondescript pointer to target device * * Return : 802 . 15 . 4 status code of MLME - SET . confirm static u8 mlme_set_request_sync(const void *pib_attribute_value,void *device_refstruct mac_message command, response;/* pre-check the validity of pib_attribute values that are not checked * in MAC if (tdme_checkpibattribute(return IEEE802154_INVALID_PARAMETER;if (pib_attribute == PHY_CURRENT_CHANNEL) {if (status)return status;if (pib_attribute == PHY_TRANSMIT_POWER) {return tdme_settxpower(sizeof (struct mlme_set_request_pset) -if (cascoda_api_downstream(2 ,return IEEE802154_SYSTEM_ERROR;if (response.command_id != SPI_MLME_SET_CONFIRM)return IEEE802154_SYSTEM_ERROR;return response.pdata.status;/** * hwme_set_request_sync ( ) - HWME_SET_request / confirm according to API Spec * @ hw_attribute : Attribute Number * @ hw_attribute_length : Attribute length * @ hw_attribute_value : Pointer to Attribute Value * @ device_ref : Nondescript pointer to target device * * Return : 802 . 15 . 4 status code of HWME - SET . confirm static u8 hwme_set_request_sync(void *device_refstruct mac_message command, response;2 + hw_attribute_length;if (cascoda_api_downstream(2 ,return IEEE802154_SYSTEM_ERROR;if (response.command_id != SPI_HWME_SET_CONFIRM)return IEEE802154_SYSTEM_ERROR;return response.pdata.hwme_set_cnf.status;/** * hwme_get_request_sync ( ) - HWME_GET_request / confirm according to API Spec * @ hw_attribute : Attribute Number * @ hw_attribute_length : Attribute length * @ hw_attribute_value : Pointer to Attribute Value * @ device_ref : Nondescript pointer to target device * * Return : 802 . 15 . 4 status code of HWME - GET . confirm static u8 hwme_get_request_sync(void *device_refstruct mac_message command, response;1 ;if (cascoda_api_downstream(2 ,return IEEE802154_SYSTEM_ERROR;if (response.command_id != SPI_HWME_GET_CONFIRM)return IEEE802154_SYSTEM_ERROR;if (response.pdata.hwme_get_cnf.status == IEEE802154_SUCCESS) {return response.pdata.hwme_get_cnf.status;/* Network driver operation */ /** * ca8210_async_xmit_complete ( ) - Called to announce that an asynchronous * transmission has finished * @ hw : ieee802154_hw of ca8210 that has finished exchange * @ msduhandle : Identifier of transmission that has completed * @ status : Returned 802 . 15 . 4 status code of the transmission * * Return : 0 or linux error code static int ca8210_async_xmit_complete(struct ieee802154_hw *hw,struct ca8210_priv *priv = hw->priv;if (priv->nextmsduhandle != msduhandle) {"Unexpected msdu_handle on data confirm, Expected %d, got %d\n" ,return -EIO;false ;if (status) {"Link transmission unsuccessful, status = %d\n" ,if (status != IEEE802154_TRANSACTION_OVERFLOW) {return 0 ;true );return 0 ;/** * ca8210_skb_rx ( ) - Contructs a properly framed socket buffer from a received * MCPS_DATA_indication * @ hw : ieee802154_hw that MCPS_DATA_indication was received by * @ len : length of MCPS_DATA_indication * @ data_ind : Octet array of MCPS_DATA_indication * * Called by the spi driver whenever a SAP command is received , this function * will ascertain whether the command is of interest to the network driver and * take necessary action . * * Return : 0 or linux error code static int ca8210_skb_rx(struct ieee802154_hw *hw,struct ieee802154_hdr hdr;int msdulen;int hlen;23 ];struct sk_buff *skb;struct ca8210_priv *priv = hw->priv;/* Allocate mtu size buffer for every rx packet */ sizeof (hdr));if (!skb)return -ENOMEM;sizeof (hdr));22 ]; /* msdu_length */ if (msdulen > IEEE802154_MTU) {"received erroneously large msdu length!\n" return -EMSGSIZE;"skb buffer length = %d\n" , msdulen);if (priv->promiscuous)goto copy_payload;/* Populate hdr */ 29 + msdulen];"security level: %#03x\n" , hdr.sec.level);if (hdr.sec.level > 0 ) {30 + msdulen];31 + msdulen], 8 );39 + msdulen];0 ];"srcAddrMode: %#03x\n" , hdr.source.mode);1 ]));"srcPanId: %#06x\n" , hdr.source.pan_id);3 ], 8 );11 ];"dstAddrMode: %#03x\n" , hdr.dest.mode);12 ]));"dstPanId: %#06x\n" , hdr.dest.pan_id);14 ], 8 );/* Fill in FC implicitly */ 1 ; /* Data frame */ if (hdr.sec.level)1 ;else 0 ;if (data_ind[1 ] != data_ind[12 ] || data_ind[2 ] != data_ind[13 ])1 ;else 0 ;/* Add hdr to front of buffer */ if (hlen < 0 ) {"failed to push mac hdr onto skb!\n" );return hlen;/* Add <msdulen> bytes of space to the back of the buffer */ /* Copy msdu to skb */ 29 ], msdulen);return 0 ;/** * ca8210_net_rx ( ) - Acts upon received SAP commands relevant to the network * driver * @ hw : ieee802154_hw that command was received by * @ command : Octet array of received command * @ len : length of the received command * * Called by the spi driver whenever a SAP command is received , this function * will ascertain whether the command is of interest to the network driver and * take necessary action . * * Return : 0 or linux error code static int ca8210_net_rx(struct ieee802154_hw *hw, u8 *command, size_t len)struct ca8210_priv *priv = hw->priv;unsigned long flags;"%s: CmdID = %d\n" , __func__, command[0 ]);if (command[0 ] == SPI_MCPS_DATA_INDICATION) {/* Received data */ if (command[26 ] == priv->last_dsn) {"DSN %d resend received, ignoring...\n" ,26 ]return 0 ;26 ];return ca8210_skb_rx(hw, len - 2 , command + 2 );else if (command[0 ] == SPI_MCPS_DATA_CONFIRM) {3 ];if (priv->async_tx_pending) {return ca8210_async_xmit_complete(2 ],return 0 ;/** * ca8210_skb_tx ( ) - Transmits a given socket buffer using the ca8210 * @ skb : Socket buffer to transmit * @ msduhandle : Data identifier to pass to the 802 . 15 . 4 MAC * @ priv : Pointer to private data section of target ca8210 * * Return : 0 or linux error code static int ca8210_skb_tx(struct sk_buff *skb,struct ca8210_priv *privstruct ieee802154_hdr header = { };struct secspec secspec;int mac_len, status;"%s called\n" , __func__);/* Get addressing info from skb - ieee802154 layer creates a full * packet if (mac_len < 0 )return mac_len;if (secspec.key_id_mode == 2 )4 );else if (secspec.key_id_mode == 3 )8 );/* Pass to Cascoda API */ union macaddr *)&header.dest.extended_addr,return link_to_linux_err(status);/** * ca8210_start ( ) - Starts the network driver * @ hw : ieee802154_hw of ca8210 being started * * Return : 0 or linux error code static int ca8210_start(struct ieee802154_hw *hw)int status;0 ;struct ca8210_priv *priv = hw->priv;1 ;/* Turn receiver on when idle for now just to test rx */ 1 ;0 ,1 ,if (status) {"Setting rx_on_when_idle failed, status = %d\n" ,return link_to_linux_err(status);1 ,if (status) {"Setting lqilimit failed, status = %d\n" ,return link_to_linux_err(status);return 0 ;/** * ca8210_stop ( ) - Stops the network driver * @ hw : ieee802154_hw of ca8210 being stopped * * Return : 0 or linux error code static void ca8210_stop(struct ieee802154_hw *hw)/** * ca8210_xmit_async ( ) - Asynchronously transmits a given socket buffer using * the ca8210 * @ hw : ieee802154_hw of ca8210 to transmit from * @ skb : Socket buffer to transmit * * Return : 0 or linux error code static int ca8210_xmit_async(struct ieee802154_hw *hw, struct sk_buff *skb)struct ca8210_priv *priv = hw->priv;int status;"calling %s\n" , __func__);true ;return status;/** * ca8210_get_ed ( ) - Returns the measured energy on the current channel at this * instant in time * @ hw : ieee802154_hw of target ca8210 * @ level : Measured Energy Detect level * * Return : 0 or linux error code static int ca8210_get_ed(struct ieee802154_hw *hw, u8 *level)struct ca8210_priv *priv = hw->priv;return link_to_linux_err(/** * ca8210_set_channel ( ) - Sets the current operating 802 . 15 . 4 channel of the * ca8210 * @ hw : ieee802154_hw of target ca8210 * @ page : Channel page to set * @ channel : Channel number to set * * Return : 0 or linux error code static int ca8210_set_channel(struct ieee802154_hw *hw,struct ca8210_priv *priv = hw->priv;0 ,1 ,if (status) {"error setting channel, MLME-SET.confirm status = %d\n" ,return link_to_linux_err(status);/** * ca8210_set_hw_addr_filt ( ) - Sets the address filtering parameters of the * ca8210 * @ hw : ieee802154_hw of target ca8210 * @ filt : Filtering parameters * @ changed : Bitmap representing which parameters to change * * Effectively just sets the actual addressing information identifying this node * as all filtering is performed by the ca8210 as detailed in the IEEE 802 . 15 . 4 * 2006 specification . * * Return : 0 or linux error code static int ca8210_set_hw_addr_filt(struct ieee802154_hw *hw,struct ieee802154_hw_addr_filt *filt,unsigned long changed0 ;struct ca8210_priv *priv = hw->priv;if (changed & IEEE802154_AFILT_PANID_CHANGED) {0 ,2 ,if (status) {"error setting pan id, MLME-SET.confirm status = %d" ,return link_to_linux_err(status);if (changed & IEEE802154_AFILT_SADDR_CHANGED) {0 ,2 ,if (status) {"error setting short address, MLME-SET.confirm status = %d" ,return link_to_linux_err(status);if (changed & IEEE802154_AFILT_IEEEADDR_CHANGED) {0 ,8 ,if (status) {"error setting ieee address, MLME-SET.confirm status = %d" ,return link_to_linux_err(status);/* TODO: Should use MLME_START to set coord bit? */ return 0 ;/** * ca8210_set_tx_power ( ) - Sets the transmit power of the ca8210 * @ hw : ieee802154_hw of target ca8210 * @ mbm : Transmit power in mBm ( dBm * 100 ) * * Return : 0 or linux error code static int ca8210_set_tx_power(struct ieee802154_hw *hw, s32 mbm)struct ca8210_priv *priv = hw->priv;100 ;return link_to_linux_err(0 , 1 , &mbm, priv->spi)/** * ca8210_set_cca_mode ( ) - Sets the clear channel assessment mode of the ca8210 * @ hw : ieee802154_hw of target ca8210 * @ cca : CCA mode to set * * Return : 0 or linux error code static int ca8210_set_cca_mode(struct ieee802154_hw *hw,const struct wpan_phy_cca *ccastruct ca8210_priv *priv = hw->priv;3 ;if (cca_mode == 3 && cca->opt == NL802154_CCA_OPT_ENERGY_CARRIER_OR) {/* cca_mode 0 == CS OR ED, 3 == CS AND ED */ 0 ;0 ,1 ,if (status) {"error setting cca mode, MLME-SET.confirm status = %d" ,return link_to_linux_err(status);/** * ca8210_set_cca_ed_level ( ) - Sets the CCA ED level of the ca8210 * @ hw : ieee802154_hw of target ca8210 * @ level : ED level to set ( in mbm ) * * Sets the minimum threshold of measured energy above which the ca8210 will * back off and retry a transmission . * * Return : 0 or linux error code static int ca8210_set_cca_ed_level(struct ieee802154_hw *hw, s32 level)100 ) * 2 + 256 ;struct ca8210_priv *priv = hw->priv;1 ,if (status) {"error setting ed threshold, HWME-SET.confirm status = %d" ,return link_to_linux_err(status);/** * ca8210_set_csma_params ( ) - Sets the CSMA parameters of the ca8210 * @ hw : ieee802154_hw of target ca8210 * @ min_be : Minimum backoff exponent when backing off a transmission * @ max_be : Maximum backoff exponent when backing off a transmission * @ retries : Number of times to retry after backing off * * Return : 0 or linux error code static int ca8210_set_csma_params(struct ieee802154_hw *hw,struct ca8210_priv *priv = hw->priv;0 , 1 , &min_be, priv->spi);if (status) {"error setting min be, MLME-SET.confirm status = %d" ,return link_to_linux_err(status);0 , 1 , &max_be, priv->spi);if (status) {"error setting max be, MLME-SET.confirm status = %d" ,return link_to_linux_err(status);0 ,1 ,if (status) {"error setting max csma backoffs, MLME-SET.confirm status = %d" ,return link_to_linux_err(status);/** * ca8210_set_frame_retries ( ) - Sets the maximum frame retries of the ca8210 * @ hw : ieee802154_hw of target ca8210 * @ retries : Number of retries * * Sets the number of times to retry a transmission if no acknowledgment was * received from the other end when one was requested . * * Return : 0 or linux error code static int ca8210_set_frame_retries(struct ieee802154_hw *hw, s8 retries)struct ca8210_priv *priv = hw->priv;0 ,1 ,if (status) {"error setting frame retries, MLME-SET.confirm status = %d" ,return link_to_linux_err(status);static int ca8210_set_promiscuous_mode(struct ieee802154_hw *hw, const bool on)struct ca8210_priv *priv = hw->priv;0 ,1 ,const void *)&on,if (status) {"error setting promiscuous mode, MLME-SET.confirm status = %d" ,else {return link_to_linux_err(status);static const struct ieee802154_ops ca8210_phy_ops = {/* Test/EVBME Interface */ /** * ca8210_test_int_open ( ) - Opens the test interface to the userspace * @ inodp : inode representation of file interface * @ filp : file interface * * Return : 0 or linux error code static int ca8210_test_int_open(struct inode *inodp, struct file *filp)struct ca8210_priv *priv = inodp->i_private;return 0 ;/** * ca8210_test_check_upstream ( ) - Checks a command received from the upstream * testing interface for required action * @ buf : Buffer containing command to check * @ device_ref : Nondescript pointer to target device * * Return : 0 or linux error code static int ca8210_test_check_upstream(u8 *buf, void *device_ref)int ret;if (buf[0 ] == SPI_MLME_SET_REQUEST) {2 ], buf[4 ], buf + 5 );if (ret) {0 ] = SPI_MLME_SET_CONFIRM;1 ] = 3 ;2 ] = IEEE802154_INVALID_PARAMETER;3 ] = buf[2 ];4 ] = buf[3 ];if (cascoda_api_upstream)5 , device_ref);return ret;if (buf[0 ] == SPI_MLME_ASSOCIATE_REQUEST) {return tdme_channelinit(buf[2 ], device_ref);else if (buf[0 ] == SPI_MLME_START_REQUEST) {return tdme_channelinit(buf[4 ], device_ref);else if (0 ] == SPI_MLME_SET_REQUEST) &&2 ] == PHY_CURRENT_CHANNEL)return tdme_channelinit(buf[5 ], device_ref);else if (0 ] == SPI_TDME_SET_REQUEST) &&2 ] == TDME_CHANNEL)return tdme_channelinit(buf[4 ], device_ref);else if (0 ] == SPI_MLME_RESET_REQUEST) &&2 ] == 1 )/* reset COORD Bit for Channel Filtering as Coordinator */ return tdme_setsfr_request_sync(0 ,0 ,return 0 ;/* End of EVBMECheckSerialCommand() */ /** * ca8210_test_int_user_write ( ) - Called by a process in userspace to send a * message to the ca8210 drivers * @ filp : file interface * @ in_buf : Buffer containing message to write * @ len : length of message * @ off : file offset * * Return : 0 or linux error code static ssize_t ca8210_test_int_user_write(struct file *filp,const char __user *in_buf,int ret;struct ca8210_priv *priv = filp->private_data;6 );if (len > CA8210_SPI_BUF_SIZE || len < 2 ) {"userspace requested erroneous write length (%zu)\n" ,return -EBADE;if (ret) {"%d bytes could not be copied from userspace\n" ,return -EIO;if (len != command[1 ] + 2 ) {"write len does not match packet length field\n" return -EBADE;if (ret == 0 ) {1 ] + 2 ,if (ret < 0 ) {/* effectively 0 bytes were written successfully */ "spi exchange failed\n" return ret;if (command[0 ] & SPI_SYN)return len;/** * ca8210_test_int_user_read ( ) - Called by a process in userspace to read a * message from the ca8210 drivers * @ filp : file interface * @ buf : Buffer to write message to * @ len : length of message to read ( ignored ) * @ offp : file offset * * If the O_NONBLOCK flag was set when opening the file then this function will * not block , i . e . it will return if the fifo is empty . Otherwise the function * will block , i . e . wait until new data arrives . * * Return : number of bytes read static ssize_t ca8210_test_int_user_read(struct file *filp,char __user *buf,int i, cmdlen;struct ca8210_priv *priv = filp->private_data;unsigned char *fifo_buffer;unsigned long bytes_not_copied;if (filp->f_flags & O_NONBLOCK) {/* Non-blocking mode */ if (kfifo_is_empty(&priv->test.up_fifo))return 0 ;else {/* Blocking mode */ if (kfifo_out(&priv->test.up_fifo, &fifo_buffer, 4 ) != 4 ) {"test_interface: Wrong number of elements popped from upstream fifo\n" return 0 ;1 ];2 ;if (bytes_not_copied > 0 ) {"%lu bytes could not be copied to user space!\n" ,"test_interface: Cmd len = %d\n" , cmdlen);"test_interface: Read\n" );for (i = 0 ; i < cmdlen + 2 ; i++)"%#03x\n" , fifo_buffer[i]);return cmdlen + 2 ;/** * ca8210_test_int_ioctl ( ) - Called by a process in userspace to enact an * arbitrary action * @ filp : file interface * @ ioctl_num : which action to enact * @ ioctl_param : arbitrary parameter for the action * * Return : status static long ca8210_test_int_ioctl(struct file *filp,unsigned int ioctl_num,unsigned long ioctl_paramstruct ca8210_priv *priv = filp->private_data;switch (ioctl_num) {case CA8210_IOCTL_HARD_RESET:break ;default :break ;return 0 ;/** * ca8210_test_int_poll ( ) - Called by a process in userspace to determine which * actions are currently possible for the file * @ filp : file interface * @ ptable : poll table * * Return : set of poll return flags static __poll_t ca8210_test_int_poll(struct file *filp,struct poll_table_struct *ptable0 ;struct ca8210_priv *priv = filp->private_data;if (!kfifo_is_empty(&priv->test.up_fifo))if (wait_event_interruptible(return EPOLLERR;return return_flags;static const struct file_operations test_int_fops = {/* Init/Deinit */ /** * ca8210_get_platform_data ( ) - Populate a ca8210_platform_data object * @ spi_device : Pointer to ca8210 spi device object to get data for * @ pdata : Pointer to ca8210_platform_data object to populate * * Return : 0 or linux error code static int ca8210_get_platform_data(struct spi_device *spi_device,struct ca8210_platform_data *pdataint ret = 0 ;if (!spi_device->dev.of_node)return -EINVAL;"extclock-enable" if (pdata->extclockenable) {"extclock-freq" ,if (ret < 0 )return ret;"extclock-gpio" ,return ret;/** * ca8210_config_extern_clk ( ) - Configure the external clock provided by the * ca8210 * @ pdata : Pointer to ca8210_platform_data containing clock parameters * @ spi : Pointer to target ca8210 spi device * @ on : True to turn the clock on , false to turn off * * The external clock is configured with a frequency and output pin taken from * the platform data . * * Return : 0 or linux error code static int ca8210_config_extern_clk(struct ca8210_platform_data *pdata,struct spi_device *spi,bool on2 ];if (on) {"Switching external clock on\n" );switch (pdata->extclockfreq) {case SIXTEEN_MHZ:0 ] = 1 ;break ;case EIGHT_MHZ:0 ] = 2 ;break ;case FOUR_MHZ:0 ] = 3 ;break ;case TWO_MHZ:0 ] = 4 ;break ;case ONE_MHZ:0 ] = 5 ;break ;default :"Invalid extclock-freq\n" );return -EINVAL;1 ] = pdata->extclockgpio;else {"Switching external clock off\n" );0 ] = 0 ; /* off */ 1 ] = 0 ;return link_to_linux_err(2 , clkparam, spi)/** * ca8210_register_ext_clock ( ) - Register ca8210 ' s external clock with kernel * @ spi : Pointer to target ca8210 spi device * * Return : 0 or linux error code static int ca8210_register_ext_clock(struct spi_device *spi)struct device *dev = &spi->dev;struct ca8210_platform_data *pdata = dev_get_platdata(dev);struct device_node *np = spi->dev.of_node;struct ca8210_priv *priv = spi_get_drvdata(spi);if (!np)return -EFAULT;0 ,if (IS_ERR(priv->clk)) {"Failed to register external clk\n" );return PTR_ERR(priv->clk);return of_clk_add_provider(np, of_clk_src_simple_get, priv->clk);/** * ca8210_unregister_ext_clock ( ) - Unregister ca8210 ' s external clock with * kernel * @ spi : Pointer to target ca8210 spi device static void ca8210_unregister_ext_clock(struct spi_device *spi)struct ca8210_priv *priv = spi_get_drvdata(spi);if (IS_ERR_OR_NULL(priv->clk))return ;"External clock unregistered\n" );/** * ca8210_reset_init ( ) - Initialise the reset input to the ca8210 * @ spi : Pointer to target ca8210 spi device * * Return : 0 or linux error code static int ca8210_reset_init(struct spi_device *spi)struct device *dev = &spi->dev;struct ca8210_platform_data *pdata = dev_get_platdata(dev);"reset" , GPIOD_OUT_LOW);if (IS_ERR(pdata->reset_gpio)) {"Reset GPIO did not set to output mode\n" );return PTR_ERR(pdata->reset_gpio);return 0 ;/** * ca8210_interrupt_init ( ) - Initialise the irq output from the ca8210 * @ spi : Pointer to target ca8210 spi device * * Return : 0 or linux error code static int ca8210_interrupt_init(struct spi_device *spi)struct device *dev = &spi->dev;struct ca8210_platform_data *pdata = dev_get_platdata(dev);int ret;"irq" , GPIOD_IN);if (IS_ERR(pdata->irq_gpio)) {"Could not retrieve IRQ GPIO\n" );return PTR_ERR(pdata->irq_gpio);if (pdata->irq_id < 0 ) {"Could not get irq for IRQ GPIO\n" );return pdata->irq_id;"ca8210-irq" ,if (ret)"request_irq %d failed\n" , pdata->irq_id);return ret;/** * ca8210_dev_com_init ( ) - Initialise the spi communication component * @ priv : Pointer to private data structure * * Return : 0 or linux error code static int ca8210_dev_com_init(struct ca8210_priv *priv)"MLME work queue" , 0 );if (!priv->mlme_workqueue) {"alloc of mlme_workqueue failed!\n" );return -ENOMEM;"ca8210 irq worker" , 0 );if (!priv->irq_workqueue) {"alloc of irq_workqueue failed!\n" );return -ENOMEM;return 0 ;/** * ca8210_dev_com_clear ( ) - Deinitialise the spi communication component * @ priv : Pointer to private data structure static void ca8210_dev_com_clear(struct ca8210_priv *priv)#define CA8210_MAX_TX_POWERS (9 )static const s32 ca8210_tx_powers[CA8210_MAX_TX_POWERS] = {800 , 700 , 600 , 500 , 400 , 300 , 200 , 100 , 0 #define CA8210_MAX_ED_LEVELS (21 )static const s32 ca8210_ed_levels[CA8210_MAX_ED_LEVELS] = {10300 , -10250 , -10200 , -10150 , -10100 , -10050 , -10000 , -9950 , -9900 ,9850 , -9800 , -9750 , -9700 , -9650 , -9600 , -9550 , -9500 , -9450 , -9400 ,9350 , -9300 /** * ca8210_hw_setup ( ) - Populate the ieee802154_hw phy attributes with the * ca8210 ' s defaults * @ ca8210_hw : Pointer to ieee802154_hw to populate static void ca8210_hw_setup(struct ieee802154_hw *ca8210_hw)/* Support channels 11-26 */ 0 ] = CA8210_VALID_CHANNELS;18 ;0 ;800 ;9800 ;16 ;40 * ca8210_hw->phy->symbol_duration;12 * ca8210_hw->phy->symbol_duration;/** * ca8210_test_interface_init ( ) - Initialise the test file interface * @ priv : Pointer to private data structure * * Provided as an alternative to the standard linux network interface , the test * interface exposes a file in the filesystem ( ca8210_test ) that allows * 802 . 15 . 4 SAP Commands and Cascoda EVBME commands to be sent directly to * the stack . * * Return : 0 or linux error code static int ca8210_test_interface_init(struct ca8210_priv *priv)struct ca8210_test *test = &priv->test;char node_name[32 ];sizeof (node_name),"ca8210@%d_%d" ,0 )0600 , /* S_IRUSR | S_IWUSR */ "ca8210" , NULL, node_name);return kfifo_alloc(/** * ca8210_test_interface_clear ( ) - Deinitialise the test file interface * @ priv : Pointer to private data structure static void ca8210_test_interface_clear(struct ca8210_priv *priv)struct ca8210_test *test = &priv->test;"Test interface removed\n" );/** * ca8210_remove ( ) - Shut down a ca8210 upon being disconnected * @ spi_device : Pointer to spi device data structure * * Return : 0 or linux error code static void ca8210_remove(struct spi_device *spi_device)struct ca8210_priv *priv;struct ca8210_platform_data *pdata;"Removing ca8210\n" );if (pdata) {if (pdata->extclockenable) {0 );/* get spi_device private data */ if (priv) {"sync_down = %d, sync_up = %d\n" ,if (priv->hw) {if (priv->hw_registered)"Unregistered & freed ieee802154_hw.\n" if (IS_ENABLED(CONFIG_IEEE802154_CA8210_DEBUGFS))/** * ca8210_probe ( ) - Set up a connected ca8210 upon being detected by the system * @ spi_device : Pointer to spi device data structure * * Return : 0 or linux error code static int ca8210_probe(struct spi_device *spi_device)struct ca8210_priv *priv;struct ieee802154_hw *hw;struct ca8210_platform_data *pdata;int ret;"Inserting ca8210\n" );/* allocate ieee802154_hw and private data */ sizeof (struct ca8210_priv), &ca8210_phy_ops);if (!hw) {"ieee802154_alloc_hw failed\n" );goto error;false ;false ;0 ;0 ;false ;0 ;if (IS_ENABLED(CONFIG_IEEE802154_CA8210_DEBUGFS)) {if (ret) {"ca8210_test_interface_init failed\n" );goto error;else {sizeof (*pdata), GFP_KERNEL);if (!pdata) {goto error;if (ret) {"ca8210_get_platform_data failed\n" );goto error;if (ret) {"ca8210_dev_com_init failed\n" );goto error;if (ret) {"ca8210_reset_init failed\n" );goto error;if (ret) {"ca8210_interrupt_init failed\n" );goto error;100 );1 );if (ret) {"tdme_chipinit failed\n" );goto error;if (pdata->extclockenable) {1 );if (ret) {"ca8210_config_extern_clk failed\n" goto error;if (ret) {"ca8210_register_ext_clock failed\n" goto error;if (ret) {"ieee802154_register_hw failed\n" );goto error;true ;return 0 ;100 ); /* wait for pending spi transfers to complete */ return link_to_linux_err(ret);static const struct of_device_id ca8210_of_ids[] = {"cascoda,ca8210" , },static struct spi_driver ca8210_spi_driver = {"Harry Morris <h.morris@cascoda.com>" );"CA-8210 SoftMAC driver" );"Dual BSD/GPL" );"1.0" );
Messung V0.5 in Prozent C=96 H=94 G=94
¤ Dauer der Verarbeitung: 0.126 Sekunden
(vorverarbeitet am 2026-09-28)
¤ *© Formatika GbR, Deutschland
2026-10-10
Neuigkeiten Aktuelles Motto des Tages Open Source Software
Jenseits des Üblichen ....
Besucherstatistik
Statistik #Sources=1126864 #Domains=1897691
