2 * AT86RF230/RF231 driver
4 * Copyright (C) 2009-2012 Siemens AG
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2
8 * as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
16 * Dmitry Eremin-Solenikov <dbaryshkov@gmail.com>
17 * Alexander Smirnov <alex.bluesman.smirnov@gmail.com>
18 * Alexander Aring <aar@pengutronix.de>
20 #include <linux/kernel.h>
21 #include <linux/module.h>
22 #include <linux/hrtimer.h>
23 #include <linux/jiffies.h>
24 #include <linux/interrupt.h>
25 #include <linux/irq.h>
26 #include <linux/gpio.h>
27 #include <linux/delay.h>
28 #include <linux/spi/spi.h>
29 #include <linux/spi/at86rf230.h>
30 #include <linux/regmap.h>
31 #include <linux/skbuff.h>
32 #include <linux/of_gpio.h>
33 #include <linux/ieee802154.h>
35 #include <net/mac802154.h>
36 #include <net/cfg802154.h>
38 #include "at86rf230.h"
40 struct at86rf230_local;
41 /* at86rf2xx chip depend data.
42 * All timings are in us.
44 struct at86rf2xx_chip_data {
56 int (*set_channel)(struct at86rf230_local *, u8, u8);
57 int (*set_txpower)(struct at86rf230_local *, s32);
60 #define AT86RF2XX_MAX_BUF (127 + 3)
61 /* tx retries to access the TX_ON state
62 * if it's above then force change will be started.
64 * We assume the max_frame_retries (7) value of 802.15.4 here.
66 #define AT86RF2XX_MAX_TX_RETRIES 7
67 /* We use the recommended 5 minutes timeout to recalibrate */
68 #define AT86RF2XX_CAL_LOOP_TIMEOUT (5 * 60 * HZ)
70 struct at86rf230_state_change {
71 struct at86rf230_local *lp;
75 struct spi_message msg;
76 struct spi_transfer trx;
77 u8 buf[AT86RF2XX_MAX_BUF];
79 void (*complete)(void *context);
86 struct at86rf230_local {
87 struct spi_device *spi;
89 struct ieee802154_hw *hw;
90 struct at86rf2xx_chip_data *data;
91 struct regmap *regmap;
95 struct completion state_complete;
96 struct at86rf230_state_change state;
98 struct at86rf230_state_change irq;
100 unsigned long cal_timeout;
104 struct sk_buff *tx_skb;
105 struct at86rf230_state_change tx;
108 #define AT86RF2XX_NUMREGS 0x3F
111 at86rf230_async_state_change(struct at86rf230_local *lp,
112 struct at86rf230_state_change *ctx,
113 const u8 state, void (*complete)(void *context),
114 const bool irq_enable);
117 at86rf230_sleep(struct at86rf230_local *lp)
119 if (gpio_is_valid(lp->slp_tr)) {
120 gpio_set_value(lp->slp_tr, 1);
121 usleep_range(lp->data->t_off_to_sleep,
122 lp->data->t_off_to_sleep + 10);
128 at86rf230_awake(struct at86rf230_local *lp)
130 if (gpio_is_valid(lp->slp_tr)) {
131 gpio_set_value(lp->slp_tr, 0);
132 usleep_range(lp->data->t_sleep_to_off,
133 lp->data->t_sleep_to_off + 100);
139 __at86rf230_write(struct at86rf230_local *lp,
140 unsigned int addr, unsigned int data)
142 bool sleep = lp->sleep;
145 /* awake for register setting if sleep */
149 ret = regmap_write(lp->regmap, addr, data);
151 /* sleep again if was sleeping */
159 __at86rf230_read(struct at86rf230_local *lp,
160 unsigned int addr, unsigned int *data)
162 bool sleep = lp->sleep;
165 /* awake for register setting if sleep */
169 ret = regmap_read(lp->regmap, addr, data);
171 /* sleep again if was sleeping */
179 at86rf230_read_subreg(struct at86rf230_local *lp,
180 unsigned int addr, unsigned int mask,
181 unsigned int shift, unsigned int *data)
185 rc = __at86rf230_read(lp, addr, data);
187 *data = (*data & mask) >> shift;
193 at86rf230_write_subreg(struct at86rf230_local *lp,
194 unsigned int addr, unsigned int mask,
195 unsigned int shift, unsigned int data)
197 bool sleep = lp->sleep;
200 /* awake for register setting if sleep */
204 ret = regmap_update_bits(lp->regmap, addr, mask, data << shift);
206 /* sleep again if was sleeping */
214 at86rf230_slp_tr_rising_edge(struct at86rf230_local *lp)
216 gpio_set_value(lp->slp_tr, 1);
218 gpio_set_value(lp->slp_tr, 0);
222 at86rf230_reg_writeable(struct device *dev, unsigned int reg)
229 case RG_PHY_ED_LEVEL:
245 case RG_SHORT_ADDR_0:
246 case RG_SHORT_ADDR_1:
268 at86rf230_reg_readable(struct device *dev, unsigned int reg)
272 /* all writeable are also readable */
273 rc = at86rf230_reg_writeable(dev, reg);
293 at86rf230_reg_volatile(struct device *dev, unsigned int reg)
295 /* can be changed during runtime */
300 case RG_PHY_ED_LEVEL:
312 at86rf230_reg_precious(struct device *dev, unsigned int reg)
314 /* don't clear irq line on read */
323 static const struct regmap_config at86rf230_regmap_spi_config = {
326 .write_flag_mask = CMD_REG | CMD_WRITE,
327 .read_flag_mask = CMD_REG,
328 .cache_type = REGCACHE_RBTREE,
329 .max_register = AT86RF2XX_NUMREGS,
330 .writeable_reg = at86rf230_reg_writeable,
331 .readable_reg = at86rf230_reg_readable,
332 .volatile_reg = at86rf230_reg_volatile,
333 .precious_reg = at86rf230_reg_precious,
337 at86rf230_async_error_recover(void *context)
339 struct at86rf230_state_change *ctx = context;
340 struct at86rf230_local *lp = ctx->lp;
343 at86rf230_async_state_change(lp, ctx, STATE_RX_AACK_ON, NULL, false);
344 ieee802154_wake_queue(lp->hw);
348 at86rf230_async_error(struct at86rf230_local *lp,
349 struct at86rf230_state_change *ctx, int rc)
351 dev_err(&lp->spi->dev, "spi_async error %d\n", rc);
353 at86rf230_async_state_change(lp, ctx, STATE_FORCE_TRX_OFF,
354 at86rf230_async_error_recover, false);
357 /* Generic function to get some register value in async mode */
359 at86rf230_async_read_reg(struct at86rf230_local *lp, const u8 reg,
360 struct at86rf230_state_change *ctx,
361 void (*complete)(void *context),
362 const bool irq_enable)
366 u8 *tx_buf = ctx->buf;
368 tx_buf[0] = (reg & CMD_REG_MASK) | CMD_REG;
369 ctx->msg.complete = complete;
370 ctx->irq_enable = irq_enable;
371 rc = spi_async(lp->spi, &ctx->msg);
374 enable_irq(ctx->irq);
376 at86rf230_async_error(lp, ctx, rc);
380 static inline u8 at86rf230_state_to_force(u8 state)
382 if (state == STATE_TX_ON)
383 return STATE_FORCE_TX_ON;
385 return STATE_FORCE_TRX_OFF;
389 at86rf230_async_state_assert(void *context)
391 struct at86rf230_state_change *ctx = context;
392 struct at86rf230_local *lp = ctx->lp;
393 const u8 *buf = ctx->buf;
394 const u8 trx_state = buf[1] & TRX_STATE_MASK;
396 /* Assert state change */
397 if (trx_state != ctx->to_state) {
398 /* Special handling if transceiver state is in
399 * STATE_BUSY_RX_AACK and a SHR was detected.
401 if (trx_state == STATE_BUSY_RX_AACK) {
402 /* Undocumented race condition. If we send a state
403 * change to STATE_RX_AACK_ON the transceiver could
404 * change his state automatically to STATE_BUSY_RX_AACK
405 * if a SHR was detected. This is not an error, but we
408 if (ctx->to_state == STATE_RX_AACK_ON)
411 /* If we change to STATE_TX_ON without forcing and
412 * transceiver state is STATE_BUSY_RX_AACK, we wait
413 * 'tFrame + tPAck' receiving time. In this time the
414 * PDU should be received. If the transceiver is still
415 * in STATE_BUSY_RX_AACK, we run a force state change
416 * to STATE_TX_ON. This is a timeout handling, if the
417 * transceiver stucks in STATE_BUSY_RX_AACK.
419 * Additional we do several retries to try to get into
420 * TX_ON state without forcing. If the retries are
421 * higher or equal than AT86RF2XX_MAX_TX_RETRIES we
422 * will do a force change.
424 if (ctx->to_state == STATE_TX_ON ||
425 ctx->to_state == STATE_TRX_OFF) {
426 u8 state = ctx->to_state;
428 if (lp->tx_retry >= AT86RF2XX_MAX_TX_RETRIES)
429 state = at86rf230_state_to_force(state);
432 at86rf230_async_state_change(lp, ctx, state,
439 dev_warn(&lp->spi->dev, "unexcept state change from 0x%02x to 0x%02x. Actual state: 0x%02x\n",
440 ctx->from_state, ctx->to_state, trx_state);
445 ctx->complete(context);
448 static enum hrtimer_restart at86rf230_async_state_timer(struct hrtimer *timer)
450 struct at86rf230_state_change *ctx =
451 container_of(timer, struct at86rf230_state_change, timer);
452 struct at86rf230_local *lp = ctx->lp;
454 at86rf230_async_read_reg(lp, RG_TRX_STATUS, ctx,
455 at86rf230_async_state_assert,
458 return HRTIMER_NORESTART;
461 /* Do state change timing delay. */
463 at86rf230_async_state_delay(void *context)
465 struct at86rf230_state_change *ctx = context;
466 struct at86rf230_local *lp = ctx->lp;
467 struct at86rf2xx_chip_data *c = lp->data;
471 /* The force state changes are will show as normal states in the
472 * state status subregister. We change the to_state to the
473 * corresponding one and remember if it was a force change, this
474 * differs if we do a state change from STATE_BUSY_RX_AACK.
476 switch (ctx->to_state) {
477 case STATE_FORCE_TX_ON:
478 ctx->to_state = STATE_TX_ON;
481 case STATE_FORCE_TRX_OFF:
482 ctx->to_state = STATE_TRX_OFF;
489 switch (ctx->from_state) {
491 switch (ctx->to_state) {
492 case STATE_RX_AACK_ON:
493 tim = ktime_set(0, c->t_off_to_aack * NSEC_PER_USEC);
494 /* state change from TRX_OFF to RX_AACK_ON to do a
495 * calibration, we need to reset the timeout for the
498 lp->cal_timeout = jiffies + AT86RF2XX_CAL_LOOP_TIMEOUT;
500 case STATE_TX_ARET_ON:
502 tim = ktime_set(0, c->t_off_to_tx_on * NSEC_PER_USEC);
503 /* state change from TRX_OFF to TX_ON or ARET_ON to do
504 * a calibration, we need to reset the timeout for the
507 lp->cal_timeout = jiffies + AT86RF2XX_CAL_LOOP_TIMEOUT;
513 case STATE_BUSY_RX_AACK:
514 switch (ctx->to_state) {
517 /* Wait for worst case receiving time if we
518 * didn't make a force change from BUSY_RX_AACK
519 * to TX_ON or TRX_OFF.
522 tim = ktime_set(0, (c->t_frame + c->t_p_ack) *
531 /* Default value, means RESET state */
533 switch (ctx->to_state) {
535 tim = ktime_set(0, c->t_reset_to_off * NSEC_PER_USEC);
545 /* Default delay is 1us in the most cases */
547 at86rf230_async_state_timer(&ctx->timer);
551 hrtimer_start(&ctx->timer, tim, HRTIMER_MODE_REL);
555 at86rf230_async_state_change_start(void *context)
557 struct at86rf230_state_change *ctx = context;
558 struct at86rf230_local *lp = ctx->lp;
560 const u8 trx_state = buf[1] & TRX_STATE_MASK;
563 /* Check for "possible" STATE_TRANSITION_IN_PROGRESS */
564 if (trx_state == STATE_TRANSITION_IN_PROGRESS) {
566 at86rf230_async_read_reg(lp, RG_TRX_STATUS, ctx,
567 at86rf230_async_state_change_start,
572 /* Check if we already are in the state which we change in */
573 if (trx_state == ctx->to_state) {
575 ctx->complete(context);
579 /* Set current state to the context of state change */
580 ctx->from_state = trx_state;
582 /* Going into the next step for a state change which do a timing
585 buf[0] = (RG_TRX_STATE & CMD_REG_MASK) | CMD_REG | CMD_WRITE;
586 buf[1] = ctx->to_state;
587 ctx->msg.complete = at86rf230_async_state_delay;
588 rc = spi_async(lp->spi, &ctx->msg);
591 enable_irq(ctx->irq);
593 at86rf230_async_error(lp, ctx, rc);
598 at86rf230_async_state_change(struct at86rf230_local *lp,
599 struct at86rf230_state_change *ctx,
600 const u8 state, void (*complete)(void *context),
601 const bool irq_enable)
603 /* Initialization for the state change context */
604 ctx->to_state = state;
605 ctx->complete = complete;
606 ctx->irq_enable = irq_enable;
607 at86rf230_async_read_reg(lp, RG_TRX_STATUS, ctx,
608 at86rf230_async_state_change_start,
613 at86rf230_sync_state_change_complete(void *context)
615 struct at86rf230_state_change *ctx = context;
616 struct at86rf230_local *lp = ctx->lp;
618 complete(&lp->state_complete);
621 /* This function do a sync framework above the async state change.
622 * Some callbacks of the IEEE 802.15.4 driver interface need to be
623 * handled synchronously.
626 at86rf230_sync_state_change(struct at86rf230_local *lp, unsigned int state)
630 at86rf230_async_state_change(lp, &lp->state, state,
631 at86rf230_sync_state_change_complete,
634 rc = wait_for_completion_timeout(&lp->state_complete,
635 msecs_to_jiffies(100));
637 at86rf230_async_error(lp, &lp->state, -ETIMEDOUT);
645 at86rf230_tx_complete(void *context)
647 struct at86rf230_state_change *ctx = context;
648 struct at86rf230_local *lp = ctx->lp;
650 enable_irq(ctx->irq);
652 ieee802154_xmit_complete(lp->hw, lp->tx_skb, false);
656 at86rf230_tx_on(void *context)
658 struct at86rf230_state_change *ctx = context;
659 struct at86rf230_local *lp = ctx->lp;
661 at86rf230_async_state_change(lp, ctx, STATE_RX_AACK_ON,
662 at86rf230_tx_complete, true);
666 at86rf230_tx_trac_check(void *context)
668 struct at86rf230_state_change *ctx = context;
669 struct at86rf230_local *lp = ctx->lp;
671 at86rf230_async_state_change(lp, &lp->irq, STATE_TX_ON,
672 at86rf230_tx_on, true);
676 at86rf230_rx_read_frame_complete(void *context)
678 struct at86rf230_state_change *ctx = context;
679 struct at86rf230_local *lp = ctx->lp;
680 u8 rx_local_buf[AT86RF2XX_MAX_BUF];
681 const u8 *buf = ctx->buf;
686 if (!ieee802154_is_valid_psdu_len(len)) {
687 dev_vdbg(&lp->spi->dev, "corrupted frame received\n");
688 len = IEEE802154_MTU;
692 memcpy(rx_local_buf, buf + 2, len);
694 enable_irq(ctx->irq);
696 skb = dev_alloc_skb(IEEE802154_MTU);
698 dev_vdbg(&lp->spi->dev, "failed to allocate sk_buff\n");
702 memcpy(skb_put(skb, len), rx_local_buf, len);
703 ieee802154_rx_irqsafe(lp->hw, skb, lqi);
707 at86rf230_rx_read_frame(void *context)
709 struct at86rf230_state_change *ctx = context;
710 struct at86rf230_local *lp = ctx->lp;
715 ctx->trx.len = AT86RF2XX_MAX_BUF;
716 ctx->msg.complete = at86rf230_rx_read_frame_complete;
717 rc = spi_async(lp->spi, &ctx->msg);
720 enable_irq(ctx->irq);
721 at86rf230_async_error(lp, ctx, rc);
726 at86rf230_rx_trac_check(void *context)
728 /* Possible check on trac status here. This could be useful to make
729 * some stats why receive is failed. Not used at the moment, but it's
730 * maybe timing relevant. Datasheet doesn't say anything about this.
731 * The programming guide say do it so.
734 at86rf230_rx_read_frame(context);
738 at86rf230_irq_trx_end(struct at86rf230_local *lp)
742 at86rf230_async_read_reg(lp, RG_TRX_STATE, &lp->irq,
743 at86rf230_tx_trac_check, true);
745 at86rf230_async_read_reg(lp, RG_TRX_STATE, &lp->irq,
746 at86rf230_rx_trac_check, true);
751 at86rf230_irq_status(void *context)
753 struct at86rf230_state_change *ctx = context;
754 struct at86rf230_local *lp = ctx->lp;
755 const u8 *buf = ctx->buf;
756 const u8 irq = buf[1];
758 if (irq & IRQ_TRX_END) {
759 at86rf230_irq_trx_end(lp);
761 enable_irq(ctx->irq);
762 dev_err(&lp->spi->dev, "not supported irq %02x received\n",
767 static irqreturn_t at86rf230_isr(int irq, void *data)
769 struct at86rf230_local *lp = data;
770 struct at86rf230_state_change *ctx = &lp->irq;
774 disable_irq_nosync(irq);
776 buf[0] = (RG_IRQ_STATUS & CMD_REG_MASK) | CMD_REG;
777 ctx->msg.complete = at86rf230_irq_status;
778 rc = spi_async(lp->spi, &ctx->msg);
781 at86rf230_async_error(lp, ctx, rc);
789 at86rf230_write_frame_complete(void *context)
791 struct at86rf230_state_change *ctx = context;
792 struct at86rf230_local *lp = ctx->lp;
798 if (gpio_is_valid(lp->slp_tr)) {
799 at86rf230_slp_tr_rising_edge(lp);
801 buf[0] = (RG_TRX_STATE & CMD_REG_MASK) | CMD_REG | CMD_WRITE;
802 buf[1] = STATE_BUSY_TX;
803 ctx->msg.complete = NULL;
804 rc = spi_async(lp->spi, &ctx->msg);
806 at86rf230_async_error(lp, ctx, rc);
811 at86rf230_write_frame(void *context)
813 struct at86rf230_state_change *ctx = context;
814 struct at86rf230_local *lp = ctx->lp;
815 struct sk_buff *skb = lp->tx_skb;
821 buf[0] = CMD_FB | CMD_WRITE;
822 buf[1] = skb->len + 2;
823 memcpy(buf + 2, skb->data, skb->len);
824 ctx->trx.len = skb->len + 2;
825 ctx->msg.complete = at86rf230_write_frame_complete;
826 rc = spi_async(lp->spi, &ctx->msg);
829 at86rf230_async_error(lp, ctx, rc);
834 at86rf230_xmit_tx_on(void *context)
836 struct at86rf230_state_change *ctx = context;
837 struct at86rf230_local *lp = ctx->lp;
839 at86rf230_async_state_change(lp, ctx, STATE_TX_ARET_ON,
840 at86rf230_write_frame, false);
844 at86rf230_xmit_start(void *context)
846 struct at86rf230_state_change *ctx = context;
847 struct at86rf230_local *lp = ctx->lp;
849 /* check if we change from off state */
850 if (lp->is_tx_from_off) {
851 lp->is_tx_from_off = false;
852 at86rf230_async_state_change(lp, ctx, STATE_TX_ARET_ON,
853 at86rf230_write_frame,
856 at86rf230_async_state_change(lp, ctx, STATE_TX_ON,
857 at86rf230_xmit_tx_on,
863 at86rf230_xmit(struct ieee802154_hw *hw, struct sk_buff *skb)
865 struct at86rf230_local *lp = hw->priv;
866 struct at86rf230_state_change *ctx = &lp->tx;
871 /* After 5 minutes in PLL and the same frequency we run again the
872 * calibration loops which is recommended by at86rf2xx datasheets.
874 * The calibration is initiate by a state change from TRX_OFF
875 * to TX_ON, the lp->cal_timeout should be reinit by state_delay
876 * function then to start in the next 5 minutes.
878 if (time_is_before_jiffies(lp->cal_timeout)) {
879 lp->is_tx_from_off = true;
880 at86rf230_async_state_change(lp, ctx, STATE_TRX_OFF,
881 at86rf230_xmit_start, false);
883 at86rf230_xmit_start(ctx);
890 at86rf230_ed(struct ieee802154_hw *hw, u8 *level)
898 at86rf230_start(struct ieee802154_hw *hw)
900 struct at86rf230_local *lp = hw->priv;
903 enable_irq(lp->spi->irq);
905 return at86rf230_sync_state_change(lp, STATE_RX_AACK_ON);
909 at86rf230_stop(struct ieee802154_hw *hw)
911 struct at86rf230_local *lp = hw->priv;
914 at86rf230_sync_state_change(lp, STATE_FORCE_TRX_OFF);
916 disable_irq(lp->spi->irq);
918 /* It's recommended to set random new csma_seeds before sleep state.
919 * Makes only sense in the stop callback, not doing this inside of
920 * at86rf230_sleep, this is also used when we don't transmit afterwards
921 * when calling start callback again.
923 get_random_bytes(csma_seed, ARRAY_SIZE(csma_seed));
924 at86rf230_write_subreg(lp, SR_CSMA_SEED_0, csma_seed[0]);
925 at86rf230_write_subreg(lp, SR_CSMA_SEED_1, csma_seed[1]);
931 at86rf23x_set_channel(struct at86rf230_local *lp, u8 page, u8 channel)
933 return at86rf230_write_subreg(lp, SR_CHANNEL, channel);
936 #define AT86RF2XX_MAX_ED_LEVELS 0xF
937 static const s32 at86rf23x_ed_levels[AT86RF2XX_MAX_ED_LEVELS + 1] = {
938 -9100, -8900, -8700, -8500, -8300, -8100, -7900, -7700, -7500, -7300,
939 -7100, -6900, -6700, -6500, -6300, -6100,
942 static const s32 at86rf212_ed_levels_100[AT86RF2XX_MAX_ED_LEVELS + 1] = {
943 -10000, -9800, -9600, -9400, -9200, -9000, -8800, -8600, -8400, -8200,
944 -8000, -7800, -7600, -7400, -7200, -7000,
947 static const s32 at86rf212_ed_levels_98[AT86RF2XX_MAX_ED_LEVELS + 1] = {
948 -9800, -9600, -9400, -9200, -9000, -8800, -8600, -8400, -8200, -8000,
949 -7800, -7600, -7400, -7200, -7000, -6800,
953 at86rf212_update_cca_ed_level(struct at86rf230_local *lp, int rssi_base_val)
955 unsigned int cca_ed_thres;
958 rc = at86rf230_read_subreg(lp, SR_CCA_ED_THRES, &cca_ed_thres);
962 switch (rssi_base_val) {
964 lp->hw->phy->supported.cca_ed_levels = at86rf212_ed_levels_98;
965 lp->hw->phy->supported.cca_ed_levels_size = ARRAY_SIZE(at86rf212_ed_levels_98);
966 lp->hw->phy->cca_ed_level = at86rf212_ed_levels_98[cca_ed_thres];
969 lp->hw->phy->supported.cca_ed_levels = at86rf212_ed_levels_100;
970 lp->hw->phy->supported.cca_ed_levels_size = ARRAY_SIZE(at86rf212_ed_levels_100);
971 lp->hw->phy->cca_ed_level = at86rf212_ed_levels_100[cca_ed_thres];
981 at86rf212_set_channel(struct at86rf230_local *lp, u8 page, u8 channel)
986 rc = at86rf230_write_subreg(lp, SR_SUB_MODE, 0);
988 rc = at86rf230_write_subreg(lp, SR_SUB_MODE, 1);
993 rc = at86rf230_write_subreg(lp, SR_BPSK_QPSK, 0);
994 lp->data->rssi_base_val = -100;
996 rc = at86rf230_write_subreg(lp, SR_BPSK_QPSK, 1);
997 lp->data->rssi_base_val = -98;
1002 rc = at86rf212_update_cca_ed_level(lp, lp->data->rssi_base_val);
1006 /* This sets the symbol_duration according frequency on the 212.
1007 * TODO move this handling while set channel and page in cfg802154.
1008 * We can do that, this timings are according 802.15.4 standard.
1009 * If we do that in cfg802154, this is a more generic calculation.
1011 * This should also protected from ifs_timer. Means cancel timer and
1012 * init with a new value. For now, this is okay.
1016 /* SUB:0 and BPSK:0 -> BPSK-20 */
1017 lp->hw->phy->symbol_duration = 50;
1019 /* SUB:1 and BPSK:0 -> BPSK-40 */
1020 lp->hw->phy->symbol_duration = 25;
1024 /* SUB:0 and BPSK:1 -> OQPSK-100/200/400 */
1025 lp->hw->phy->symbol_duration = 40;
1027 /* SUB:1 and BPSK:1 -> OQPSK-250/500/1000 */
1028 lp->hw->phy->symbol_duration = 16;
1031 lp->hw->phy->lifs_period = IEEE802154_LIFS_PERIOD *
1032 lp->hw->phy->symbol_duration;
1033 lp->hw->phy->sifs_period = IEEE802154_SIFS_PERIOD *
1034 lp->hw->phy->symbol_duration;
1036 return at86rf230_write_subreg(lp, SR_CHANNEL, channel);
1040 at86rf230_channel(struct ieee802154_hw *hw, u8 page, u8 channel)
1042 struct at86rf230_local *lp = hw->priv;
1045 rc = lp->data->set_channel(lp, page, channel);
1047 usleep_range(lp->data->t_channel_switch,
1048 lp->data->t_channel_switch + 10);
1050 lp->cal_timeout = jiffies + AT86RF2XX_CAL_LOOP_TIMEOUT;
1055 at86rf230_set_hw_addr_filt(struct ieee802154_hw *hw,
1056 struct ieee802154_hw_addr_filt *filt,
1057 unsigned long changed)
1059 struct at86rf230_local *lp = hw->priv;
1061 if (changed & IEEE802154_AFILT_SADDR_CHANGED) {
1062 u16 addr = le16_to_cpu(filt->short_addr);
1064 dev_vdbg(&lp->spi->dev,
1065 "at86rf230_set_hw_addr_filt called for saddr\n");
1066 __at86rf230_write(lp, RG_SHORT_ADDR_0, addr);
1067 __at86rf230_write(lp, RG_SHORT_ADDR_1, addr >> 8);
1070 if (changed & IEEE802154_AFILT_PANID_CHANGED) {
1071 u16 pan = le16_to_cpu(filt->pan_id);
1073 dev_vdbg(&lp->spi->dev,
1074 "at86rf230_set_hw_addr_filt called for pan id\n");
1075 __at86rf230_write(lp, RG_PAN_ID_0, pan);
1076 __at86rf230_write(lp, RG_PAN_ID_1, pan >> 8);
1079 if (changed & IEEE802154_AFILT_IEEEADDR_CHANGED) {
1082 memcpy(addr, &filt->ieee_addr, 8);
1083 dev_vdbg(&lp->spi->dev,
1084 "at86rf230_set_hw_addr_filt called for IEEE addr\n");
1085 for (i = 0; i < 8; i++)
1086 __at86rf230_write(lp, RG_IEEE_ADDR_0 + i, addr[i]);
1089 if (changed & IEEE802154_AFILT_PANC_CHANGED) {
1090 dev_vdbg(&lp->spi->dev,
1091 "at86rf230_set_hw_addr_filt called for panc change\n");
1092 if (filt->pan_coord)
1093 at86rf230_write_subreg(lp, SR_AACK_I_AM_COORD, 1);
1095 at86rf230_write_subreg(lp, SR_AACK_I_AM_COORD, 0);
1101 #define AT86RF23X_MAX_TX_POWERS 0xF
1102 static const s32 at86rf233_powers[AT86RF23X_MAX_TX_POWERS + 1] = {
1103 400, 370, 340, 300, 250, 200, 100, 0, -100, -200, -300, -400, -600,
1107 static const s32 at86rf231_powers[AT86RF23X_MAX_TX_POWERS + 1] = {
1108 300, 280, 230, 180, 130, 70, 0, -100, -200, -300, -400, -500, -700,
1112 #define AT86RF212_MAX_TX_POWERS 0x1F
1113 static const s32 at86rf212_powers[AT86RF212_MAX_TX_POWERS + 1] = {
1114 500, 400, 300, 200, 100, 0, -100, -200, -300, -400, -500, -600, -700,
1115 -800, -900, -1000, -1100, -1200, -1300, -1400, -1500, -1600, -1700,
1116 -1800, -1900, -2000, -2100, -2200, -2300, -2400, -2500, -2600,
1120 at86rf23x_set_txpower(struct at86rf230_local *lp, s32 mbm)
1124 for (i = 0; i < lp->hw->phy->supported.tx_powers_size; i++) {
1125 if (lp->hw->phy->supported.tx_powers[i] == mbm)
1126 return at86rf230_write_subreg(lp, SR_TX_PWR_23X, i);
1133 at86rf212_set_txpower(struct at86rf230_local *lp, s32 mbm)
1137 for (i = 0; i < lp->hw->phy->supported.tx_powers_size; i++) {
1138 if (lp->hw->phy->supported.tx_powers[i] == mbm)
1139 return at86rf230_write_subreg(lp, SR_TX_PWR_212, i);
1146 at86rf230_set_txpower(struct ieee802154_hw *hw, s32 mbm)
1148 struct at86rf230_local *lp = hw->priv;
1150 return lp->data->set_txpower(lp, mbm);
1154 at86rf230_set_lbt(struct ieee802154_hw *hw, bool on)
1156 struct at86rf230_local *lp = hw->priv;
1158 return at86rf230_write_subreg(lp, SR_CSMA_LBT_MODE, on);
1162 at86rf230_set_cca_mode(struct ieee802154_hw *hw,
1163 const struct wpan_phy_cca *cca)
1165 struct at86rf230_local *lp = hw->priv;
1168 /* mapping 802.15.4 to driver spec */
1169 switch (cca->mode) {
1170 case NL802154_CCA_ENERGY:
1173 case NL802154_CCA_CARRIER:
1176 case NL802154_CCA_ENERGY_CARRIER:
1178 case NL802154_CCA_OPT_ENERGY_CARRIER_AND:
1181 case NL802154_CCA_OPT_ENERGY_CARRIER_OR:
1192 return at86rf230_write_subreg(lp, SR_CCA_MODE, val);
1197 at86rf230_set_cca_ed_level(struct ieee802154_hw *hw, s32 mbm)
1199 struct at86rf230_local *lp = hw->priv;
1202 for (i = 0; i < hw->phy->supported.cca_ed_levels_size; i++) {
1203 if (hw->phy->supported.cca_ed_levels[i] == mbm)
1204 return at86rf230_write_subreg(lp, SR_CCA_ED_THRES, i);
1211 at86rf230_set_csma_params(struct ieee802154_hw *hw, u8 min_be, u8 max_be,
1214 struct at86rf230_local *lp = hw->priv;
1217 rc = at86rf230_write_subreg(lp, SR_MIN_BE, min_be);
1221 rc = at86rf230_write_subreg(lp, SR_MAX_BE, max_be);
1225 return at86rf230_write_subreg(lp, SR_MAX_CSMA_RETRIES, retries);
1229 at86rf230_set_frame_retries(struct ieee802154_hw *hw, s8 retries)
1231 struct at86rf230_local *lp = hw->priv;
1233 return at86rf230_write_subreg(lp, SR_MAX_FRAME_RETRIES, retries);
1237 at86rf230_set_promiscuous_mode(struct ieee802154_hw *hw, const bool on)
1239 struct at86rf230_local *lp = hw->priv;
1243 rc = at86rf230_write_subreg(lp, SR_AACK_DIS_ACK, 1);
1247 rc = at86rf230_write_subreg(lp, SR_AACK_PROM_MODE, 1);
1251 rc = at86rf230_write_subreg(lp, SR_AACK_PROM_MODE, 0);
1255 rc = at86rf230_write_subreg(lp, SR_AACK_DIS_ACK, 0);
1263 static const struct ieee802154_ops at86rf230_ops = {
1264 .owner = THIS_MODULE,
1265 .xmit_async = at86rf230_xmit,
1267 .set_channel = at86rf230_channel,
1268 .start = at86rf230_start,
1269 .stop = at86rf230_stop,
1270 .set_hw_addr_filt = at86rf230_set_hw_addr_filt,
1271 .set_txpower = at86rf230_set_txpower,
1272 .set_lbt = at86rf230_set_lbt,
1273 .set_cca_mode = at86rf230_set_cca_mode,
1274 .set_cca_ed_level = at86rf230_set_cca_ed_level,
1275 .set_csma_params = at86rf230_set_csma_params,
1276 .set_frame_retries = at86rf230_set_frame_retries,
1277 .set_promiscuous_mode = at86rf230_set_promiscuous_mode,
1280 static struct at86rf2xx_chip_data at86rf233_data = {
1281 .t_sleep_cycle = 330,
1282 .t_channel_switch = 11,
1283 .t_reset_to_off = 26,
1284 .t_off_to_aack = 80,
1285 .t_off_to_tx_on = 80,
1286 .t_off_to_sleep = 35,
1287 .t_sleep_to_off = 210,
1290 .rssi_base_val = -91,
1291 .set_channel = at86rf23x_set_channel,
1292 .set_txpower = at86rf23x_set_txpower,
1295 static struct at86rf2xx_chip_data at86rf231_data = {
1296 .t_sleep_cycle = 330,
1297 .t_channel_switch = 24,
1298 .t_reset_to_off = 37,
1299 .t_off_to_aack = 110,
1300 .t_off_to_tx_on = 110,
1301 .t_off_to_sleep = 35,
1302 .t_sleep_to_off = 380,
1305 .rssi_base_val = -91,
1306 .set_channel = at86rf23x_set_channel,
1307 .set_txpower = at86rf23x_set_txpower,
1310 static struct at86rf2xx_chip_data at86rf212_data = {
1311 .t_sleep_cycle = 330,
1312 .t_channel_switch = 11,
1313 .t_reset_to_off = 26,
1314 .t_off_to_aack = 200,
1315 .t_off_to_tx_on = 200,
1316 .t_off_to_sleep = 35,
1317 .t_sleep_to_off = 380,
1320 .rssi_base_val = -100,
1321 .set_channel = at86rf212_set_channel,
1322 .set_txpower = at86rf212_set_txpower,
1325 static int at86rf230_hw_init(struct at86rf230_local *lp, u8 xtal_trim)
1327 int rc, irq_type, irq_pol = IRQ_ACTIVE_HIGH;
1331 rc = at86rf230_sync_state_change(lp, STATE_FORCE_TRX_OFF);
1335 irq_type = irq_get_trigger_type(lp->spi->irq);
1336 if (irq_type == IRQ_TYPE_EDGE_RISING ||
1337 irq_type == IRQ_TYPE_EDGE_FALLING)
1338 dev_warn(&lp->spi->dev,
1339 "Using edge triggered irq's are not recommended!\n");
1340 if (irq_type == IRQ_TYPE_EDGE_FALLING ||
1341 irq_type == IRQ_TYPE_LEVEL_LOW)
1342 irq_pol = IRQ_ACTIVE_LOW;
1344 rc = at86rf230_write_subreg(lp, SR_IRQ_POLARITY, irq_pol);
1348 rc = at86rf230_write_subreg(lp, SR_RX_SAFE_MODE, 1);
1352 rc = at86rf230_write_subreg(lp, SR_IRQ_MASK, IRQ_TRX_END);
1356 /* reset values differs in at86rf231 and at86rf233 */
1357 rc = at86rf230_write_subreg(lp, SR_IRQ_MASK_MODE, 0);
1361 get_random_bytes(csma_seed, ARRAY_SIZE(csma_seed));
1362 rc = at86rf230_write_subreg(lp, SR_CSMA_SEED_0, csma_seed[0]);
1365 rc = at86rf230_write_subreg(lp, SR_CSMA_SEED_1, csma_seed[1]);
1369 /* CLKM changes are applied immediately */
1370 rc = at86rf230_write_subreg(lp, SR_CLKM_SHA_SEL, 0x00);
1375 rc = at86rf230_write_subreg(lp, SR_CLKM_CTRL, 0x00);
1378 /* Wait the next SLEEP cycle */
1379 usleep_range(lp->data->t_sleep_cycle,
1380 lp->data->t_sleep_cycle + 100);
1382 /* xtal_trim value is calculated by:
1383 * CL = 0.5 * (CX + CTRIM + CPAR)
1386 * CL = capacitor of used crystal
1387 * CX = connected capacitors at xtal pins
1388 * CPAR = in all at86rf2xx datasheets this is a constant value 3 pF,
1389 * but this is different on each board setup. You need to fine
1390 * tuning this value via CTRIM.
1391 * CTRIM = variable capacitor setting. Resolution is 0.3 pF range is
1395 * atben transceiver:
1399 * CPAR = 3 pF (We assume the magic constant from datasheet)
1402 * (12+0.9+3)/2 = 7.95 which is nearly at 8 pF
1406 * openlabs transceiver:
1410 * CPAR = 3 pF (We assume the magic constant from datasheet)
1413 * (22+4.5+3)/2 = 14.75 which is the nearest value to 16 pF
1417 rc = at86rf230_write_subreg(lp, SR_XTAL_TRIM, xtal_trim);
1421 rc = at86rf230_read_subreg(lp, SR_DVDD_OK, &dvdd);
1425 dev_err(&lp->spi->dev, "DVDD error\n");
1429 /* Force setting slotted operation bit to 0. Sometimes the atben
1430 * sets this bit and I don't know why. We set this always force
1431 * to zero while probing.
1433 return at86rf230_write_subreg(lp, SR_SLOTTED_OPERATION, 0);
1437 at86rf230_get_pdata(struct spi_device *spi, int *rstn, int *slp_tr,
1440 struct at86rf230_platform_data *pdata = spi->dev.platform_data;
1443 if (!IS_ENABLED(CONFIG_OF) || !spi->dev.of_node) {
1447 *rstn = pdata->rstn;
1448 *slp_tr = pdata->slp_tr;
1449 *xtal_trim = pdata->xtal_trim;
1453 *rstn = of_get_named_gpio(spi->dev.of_node, "reset-gpio", 0);
1454 *slp_tr = of_get_named_gpio(spi->dev.of_node, "sleep-gpio", 0);
1455 ret = of_property_read_u8(spi->dev.of_node, "xtal-trim", xtal_trim);
1456 if (ret < 0 && ret != -EINVAL)
1463 at86rf230_detect_device(struct at86rf230_local *lp)
1465 unsigned int part, version, val;
1470 rc = __at86rf230_read(lp, RG_MAN_ID_0, &val);
1475 rc = __at86rf230_read(lp, RG_MAN_ID_1, &val);
1478 man_id |= (val << 8);
1480 rc = __at86rf230_read(lp, RG_PART_NUM, &part);
1484 rc = __at86rf230_read(lp, RG_VERSION_NUM, &version);
1488 if (man_id != 0x001f) {
1489 dev_err(&lp->spi->dev, "Non-Atmel dev found (MAN_ID %02x %02x)\n",
1490 man_id >> 8, man_id & 0xFF);
1494 lp->hw->flags = IEEE802154_HW_TX_OMIT_CKSUM |
1495 IEEE802154_HW_CSMA_PARAMS |
1496 IEEE802154_HW_FRAME_RETRIES | IEEE802154_HW_AFILT |
1497 IEEE802154_HW_PROMISCUOUS;
1499 lp->hw->phy->flags = WPAN_PHY_FLAG_TXPOWER |
1500 WPAN_PHY_FLAG_CCA_ED_LEVEL |
1501 WPAN_PHY_FLAG_CCA_MODE;
1503 lp->hw->phy->supported.cca_modes = BIT(NL802154_CCA_ENERGY) |
1504 BIT(NL802154_CCA_CARRIER) | BIT(NL802154_CCA_ENERGY_CARRIER);
1505 lp->hw->phy->supported.cca_opts = BIT(NL802154_CCA_OPT_ENERGY_CARRIER_AND) |
1506 BIT(NL802154_CCA_OPT_ENERGY_CARRIER_OR);
1508 lp->hw->phy->supported.cca_ed_levels = at86rf23x_ed_levels;
1509 lp->hw->phy->supported.cca_ed_levels_size = ARRAY_SIZE(at86rf23x_ed_levels);
1511 lp->hw->phy->cca.mode = NL802154_CCA_ENERGY;
1520 lp->data = &at86rf231_data;
1521 lp->hw->phy->supported.channels[0] = 0x7FFF800;
1522 lp->hw->phy->current_channel = 11;
1523 lp->hw->phy->symbol_duration = 16;
1524 lp->hw->phy->supported.tx_powers = at86rf231_powers;
1525 lp->hw->phy->supported.tx_powers_size = ARRAY_SIZE(at86rf231_powers);
1529 lp->data = &at86rf212_data;
1530 lp->hw->flags |= IEEE802154_HW_LBT;
1531 lp->hw->phy->supported.channels[0] = 0x00007FF;
1532 lp->hw->phy->supported.channels[2] = 0x00007FF;
1533 lp->hw->phy->current_channel = 5;
1534 lp->hw->phy->symbol_duration = 25;
1535 lp->hw->phy->supported.lbt = NL802154_SUPPORTED_BOOL_BOTH;
1536 lp->hw->phy->supported.tx_powers = at86rf212_powers;
1537 lp->hw->phy->supported.tx_powers_size = ARRAY_SIZE(at86rf212_powers);
1538 lp->hw->phy->supported.cca_ed_levels = at86rf212_ed_levels_100;
1539 lp->hw->phy->supported.cca_ed_levels_size = ARRAY_SIZE(at86rf212_ed_levels_100);
1543 lp->data = &at86rf233_data;
1544 lp->hw->phy->supported.channels[0] = 0x7FFF800;
1545 lp->hw->phy->current_channel = 13;
1546 lp->hw->phy->symbol_duration = 16;
1547 lp->hw->phy->supported.tx_powers = at86rf233_powers;
1548 lp->hw->phy->supported.tx_powers_size = ARRAY_SIZE(at86rf233_powers);
1556 lp->hw->phy->cca_ed_level = lp->hw->phy->supported.cca_ed_levels[7];
1557 lp->hw->phy->transmit_power = lp->hw->phy->supported.tx_powers[0];
1560 dev_info(&lp->spi->dev, "Detected %s chip version %d\n", chip, version);
1566 at86rf230_setup_spi_messages(struct at86rf230_local *lp)
1569 lp->state.irq = lp->spi->irq;
1570 spi_message_init(&lp->state.msg);
1571 lp->state.msg.context = &lp->state;
1572 lp->state.trx.len = 2;
1573 lp->state.trx.tx_buf = lp->state.buf;
1574 lp->state.trx.rx_buf = lp->state.buf;
1575 spi_message_add_tail(&lp->state.trx, &lp->state.msg);
1576 hrtimer_init(&lp->state.timer, CLOCK_MONOTONIC, HRTIMER_MODE_REL);
1577 lp->state.timer.function = at86rf230_async_state_timer;
1580 lp->irq.irq = lp->spi->irq;
1581 spi_message_init(&lp->irq.msg);
1582 lp->irq.msg.context = &lp->irq;
1583 lp->irq.trx.len = 2;
1584 lp->irq.trx.tx_buf = lp->irq.buf;
1585 lp->irq.trx.rx_buf = lp->irq.buf;
1586 spi_message_add_tail(&lp->irq.trx, &lp->irq.msg);
1587 hrtimer_init(&lp->irq.timer, CLOCK_MONOTONIC, HRTIMER_MODE_REL);
1588 lp->irq.timer.function = at86rf230_async_state_timer;
1591 lp->tx.irq = lp->spi->irq;
1592 spi_message_init(&lp->tx.msg);
1593 lp->tx.msg.context = &lp->tx;
1595 lp->tx.trx.tx_buf = lp->tx.buf;
1596 lp->tx.trx.rx_buf = lp->tx.buf;
1597 spi_message_add_tail(&lp->tx.trx, &lp->tx.msg);
1598 hrtimer_init(&lp->tx.timer, CLOCK_MONOTONIC, HRTIMER_MODE_REL);
1599 lp->tx.timer.function = at86rf230_async_state_timer;
1602 static int at86rf230_probe(struct spi_device *spi)
1604 struct ieee802154_hw *hw;
1605 struct at86rf230_local *lp;
1606 unsigned int status;
1607 int rc, irq_type, rstn, slp_tr;
1611 dev_err(&spi->dev, "no IRQ specified\n");
1615 rc = at86rf230_get_pdata(spi, &rstn, &slp_tr, &xtal_trim);
1617 dev_err(&spi->dev, "failed to parse platform_data: %d\n", rc);
1621 if (gpio_is_valid(rstn)) {
1622 rc = devm_gpio_request_one(&spi->dev, rstn,
1623 GPIOF_OUT_INIT_HIGH, "rstn");
1628 if (gpio_is_valid(slp_tr)) {
1629 rc = devm_gpio_request_one(&spi->dev, slp_tr,
1630 GPIOF_OUT_INIT_LOW, "slp_tr");
1636 if (gpio_is_valid(rstn)) {
1638 gpio_set_value(rstn, 0);
1640 gpio_set_value(rstn, 1);
1641 usleep_range(120, 240);
1644 hw = ieee802154_alloc_hw(sizeof(*lp), &at86rf230_ops);
1651 lp->slp_tr = slp_tr;
1652 hw->parent = &spi->dev;
1653 ieee802154_random_extended_addr(&hw->phy->perm_extended_addr);
1655 lp->regmap = devm_regmap_init_spi(spi, &at86rf230_regmap_spi_config);
1656 if (IS_ERR(lp->regmap)) {
1657 rc = PTR_ERR(lp->regmap);
1658 dev_err(&spi->dev, "Failed to allocate register map: %d\n",
1663 at86rf230_setup_spi_messages(lp);
1665 rc = at86rf230_detect_device(lp);
1669 init_completion(&lp->state_complete);
1671 spi_set_drvdata(spi, lp);
1673 rc = at86rf230_hw_init(lp, xtal_trim);
1677 /* Read irq status register to reset irq line */
1678 rc = at86rf230_read_subreg(lp, RG_IRQ_STATUS, 0xff, 0, &status);
1682 irq_type = irq_get_trigger_type(spi->irq);
1684 irq_type = IRQF_TRIGGER_HIGH;
1686 rc = devm_request_irq(&spi->dev, spi->irq, at86rf230_isr,
1687 IRQF_SHARED | irq_type, dev_name(&spi->dev), lp);
1691 /* disable_irq by default and wait for starting hardware */
1692 disable_irq(spi->irq);
1694 /* going into sleep by default */
1695 at86rf230_sleep(lp);
1697 rc = ieee802154_register_hw(lp->hw);
1704 ieee802154_free_hw(lp->hw);
1709 static int at86rf230_remove(struct spi_device *spi)
1711 struct at86rf230_local *lp = spi_get_drvdata(spi);
1713 /* mask all at86rf230 irq's */
1714 at86rf230_write_subreg(lp, SR_IRQ_MASK, 0);
1715 ieee802154_unregister_hw(lp->hw);
1716 ieee802154_free_hw(lp->hw);
1717 dev_dbg(&spi->dev, "unregistered at86rf230\n");
1722 static const struct of_device_id at86rf230_of_match[] = {
1723 { .compatible = "atmel,at86rf230", },
1724 { .compatible = "atmel,at86rf231", },
1725 { .compatible = "atmel,at86rf233", },
1726 { .compatible = "atmel,at86rf212", },
1729 MODULE_DEVICE_TABLE(of, at86rf230_of_match);
1731 static const struct spi_device_id at86rf230_device_id[] = {
1732 { .name = "at86rf230", },
1733 { .name = "at86rf231", },
1734 { .name = "at86rf233", },
1735 { .name = "at86rf212", },
1738 MODULE_DEVICE_TABLE(spi, at86rf230_device_id);
1740 static struct spi_driver at86rf230_driver = {
1741 .id_table = at86rf230_device_id,
1743 .of_match_table = of_match_ptr(at86rf230_of_match),
1744 .name = "at86rf230",
1745 .owner = THIS_MODULE,
1747 .probe = at86rf230_probe,
1748 .remove = at86rf230_remove,
1751 module_spi_driver(at86rf230_driver);
1753 MODULE_DESCRIPTION("AT86RF230 Transceiver Driver");
1754 MODULE_LICENSE("GPL v2");