transceiver.h

Go to the documentation of this file.

/* Copyright (c) 2007 Axel Wachtler
   All rights reserved.

   Redistribution and use in source and binary forms, with or without
   modification, are permitted provided that the following conditions
   are met:

   * Redistributions of source code must retain the above copyright
     notice, this list of conditions and the following disclaimer.
   * 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.
   * Neither the name of the authors nor the names of its contributors
     may be used to endorse or promote products derived from this software
     without specific prior written permission.

   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
   AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
   LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
   CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
   SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
   CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
   POSSIBILITY OF SUCH DAMAGE. */

/* $Id: transceiver_8h_source.html,v 1.1.1.4 2013/04/09 21:12:16 awachtler Exp $ */
#ifndef TRANSCEIVER_H
#define TRANSCEIVER_H

/* === Includes ============================================================== */
#include "board.h"

#if RADIO_TYPE == RADIO_AT86RF230 || defined(DOXYGEN)
# include "at86rf230a.h"
#elif RADIO_TYPE == RADIO_AT86RF230B
# include "at86rf230b.h"
#elif RADIO_TYPE == RADIO_AT86RF231
# include "at86rf231.h"
#elif RADIO_TYPE == RADIO_AT86RF212
# include "at86rf212.h"
#elif RADIO_TYPE == RADIO_AT86RF232
# include "at86rf232.h"
#elif RADIO_TYPE == RADIO_AT86RF233
# include "at86rf233.h"
#elif RADIO_TYPE == RADIO_ATMEGA128RFA1_A ||\
      RADIO_TYPE == RADIO_ATMEGA128RFA1_B ||\
      RADIO_TYPE == RADIO_ATMEGA128RFA1_C ||\
      RADIO_TYPE == RADIO_ATMEGA128RFA1_D
# include "atmega_rfa1.h"
#else
# error "RADIO_TYPE is not defined or wrong"
#endif
#include <stdbool.h>

/* === Externals ============================================================= */

/* === Types ================================================================= */

#if defined(DOXYGEN)

    /* this types are defined in at86rfXXX.{h,txt} in order
       to provide a radio abstraction */

    typedef uint8_t trx_ramaddr_t;

    typedef uint8_t trx_regval_t;

    typedef uint8_t trx_regaddr_t;

#endif

typedef void (*trx_irq_handler_t)(uint8_t cause);

typedef enum
{
   CFG_FLASH,
   CFG_EEPROM,
   CFG_NONE
} trx_cfg_t;

/* === Macros ================================================================ */
/* error codes */
#define TRX_OK        (0)

#define TRX_INIT_FAIL (1)

#define TRX_PLL_FAIL  (2)

#define INVALID_PART_NUM (2)  
#define INVALID_REV_NUM  (1)  
/* Data Rate macros, generated by python Tools/cmdhash.py  `cat rates.txt` */
#define BPSK20 (0x52)
#define BPSK20_STR "BPSK20"
#define BPSK40 (0x92)
#define BPSK40_STR "BPSK40"
#define OQPSK100 (0x90)
#define OQPSK100_STR "OQPSK100"
#define OQPSK200 (0x93)
#define OQPSK200_STR "OQPSK200"
#define OQPSK250 (0x33)
#define OQPSK250_STR "OQPSK250"
#define OQPSK400 (0x95)
#define OQPSK400_STR "OQPSK400"
#define OQPSK500 (0x94)
#define OQPSK500_STR "OQPSK500"
#define OQPSK1000 (0x34)
#define OQPSK1000_STR "OQPSK1000"
#define OQPSK2000 (0x54)
#define OQPSK2000_STR "OQPSK2000"

#define RATE_NONE (0xFF)

#ifndef MAX_FRAME_SIZE
# define MAX_FRAME_SIZE (127)
#endif

/* channel handling */
#define TRX_NEXT_CHANNEL(x) ((channel_t)(x+1) > TRX_MAX_CHANNEL ? TRX_MAX_CHANNEL : x+1)
#define TRX_PREV_CHANNEL(x) ((channel_t)(x-1) < TRX_MIN_CHANNEL ? TRX_MIN_CHANNEL : x-1)
#define TRX_NEXT_CHANNEL_WRAP(x) ((channel_t)(x+1) > TRX_MAX_CHANNEL ? TRX_MIN_CHANNEL : x+1 )
#define TRX_PREV_CHANNEL_WRAP(x) ((channel_t)(x-1) < TRX_MIN_CHANNEL ? TRX_MAX_CHANNEL : x-1 )


#if defined (SR_MASK_AMI) || defined(DOXYGEN)

# define TRX_IRQ_AMI_EI() trx_bit_write(SR_MASK_AMI, 1);

# define TRX_IRQ_AMI_DI() trx_bit_write(SR_MASK_AMI, 0);
#endif

#if defined (SR_MASK_BAT_LOW) || defined(DOXYGEN)

# define TRX_IRQ_BAT_LOW_EI() trx_bit_write(SR_MASK_BAT_LOW, 1);

# define TRX_IRQ_BAT_LOW_DI() trx_bit_write(SR_MASK_BAT_LOW, 0);
#endif

#if defined (SR_MASK_CCA_ED_READY) || defined(DOXYGEN)

# define TRX_IRQ_CCA_ED_READY_EI() trx_bit_write(SR_MASK_CCA_ED_READY, 1);

# define TRX_IRQ_CCA_ED_READY_DI() trx_bit_write(SR_MASK_CCA_ED_READY, 0);
#endif

#if defined (SR_MASK_PLL_UNLOCK) || defined(DOXYGEN)

# define TRX_IRQ_PLL_UNLOCK_EI() trx_bit_write(SR_MASK_PLL_UNLOCK, 1);

# define TRX_IRQ_PLL_UNLOCK_DI() trx_bit_write(SR_MASK_PLL_UNLOCK, 0);
#endif

#if defined (SR_MASK_RX_START) || defined(DOXYGEN)

# define TRX_IRQ_RX_START_EI() trx_bit_write(SR_MASK_RX_START, 1);

# define TRX_IRQ_RX_START_DI() trx_bit_write(SR_MASK_RX_START, 0);
#endif

#if defined (SR_MASK_TRX_IRQ_END) || defined(DOXYGEN)

# define TRX_IRQ_TRX_IRQ_END_EI() trx_bit_write(SR_MASK_TRX_IRQ_END, 1);

# define TRX_IRQ_TRX_IRQ_END_DI() trx_bit_write(SR_MASK_TRX_IRQ_END, 0);
#endif

#if defined (SR_MASK_TRX_IRQ_START) || defined(DOXYGEN)

# define TRX_IRQ_TRX_IRQ_START_EI() trx_bit_write(SR_MASK_TRX_IRQ_START, 1);

# define TRX_IRQ_TRX_IRQ_START_DI() trx_bit_write(SR_MASK_TRX_IRQ_START, 0);
#endif

#if defined (SR_MASK_UR) || defined(DOXYGEN)

# define TRX_IRQ_UR_EI() trx_bit_write(SR_MASK_UR, 1);

# define TRX_IRQ_UR_DI() trx_bit_write(SR_MASK_UR, 0);
#endif

/* === Prototypes ============================================================ */
#ifdef __cplusplus
extern "C" {
#endif

#if !defined(TRX_IF_RFA1)

void trx_io_init (uint8_t spirate);
#else  /* RFA1 */
#define trx_io_init(dummy) do { /* dummy macro */ } while (0)
#endif


void trx_set_irq_handler(trx_irq_handler_t irqhandler);

void trx_reg_write(trx_regaddr_t addr, trx_regval_t val);

uint8_t trx_reg_read(trx_regaddr_t addr);



trx_regval_t trx_bit_read(trx_regaddr_t addr, trx_regval_t mask, uint8_t pos);


void trx_bit_write(trx_regaddr_t addr, trx_regval_t mask, uint8_t pos, trx_regval_t value);

void trx_frame_write(uint8_t length, uint8_t *data);

uint8_t trx_frame_read(uint8_t *data, uint8_t datasz, uint8_t *lqi);


uint8_t trx_frame_read_crc(uint8_t *data, uint8_t datasz, bool *crc_ok);


uint8_t trx_frame_read_data_crc(uint8_t *data, uint8_t datasz, uint8_t *lqi, bool *crc_ok);

uint8_t trx_frame_get_length(void);

void trx_sram_write(trx_ramaddr_t addr, uint8_t length, uint8_t *data);

void trx_sram_read(trx_ramaddr_t addr, uint8_t length, uint8_t *data);

void trx_parms_get(trx_param_t *p);

uint8_t trx_parms_set(trx_param_t *p);

uint8_t trx_set_datarate(uint8_t rate_type);

uint8_t trx_get_datarate(void);

uint8_t trx_get_number_datarates(void);

void * trx_get_datarate_str_p(uint8_t idx);

void * trx_decode_datarate_p(uint8_t rhash);

uint8_t trx_get_datarate_str(uint8_t idx, char * rstr, uint8_t nlen);

uint8_t trx_decode_datarate(uint8_t rhash, char * rstr, uint8_t nlen);

/*=== Inline Functions ================================================*/
/*
 * This are functions that are usually called once in an application,
 * so we decalre it inline here
 */

static inline uint8_t trx_init(void)
{
uint8_t val;

    /* reset transceiver */
    TRX_RESET_LOW();
    TRX_SLPTR_LOW();
    DELAY_US(TRX_RESET_TIME_US);
    TRX_RESET_HIGH();

    /* set TRX_OFF (for the case we come from P_ON) */
    trx_reg_write(RG_TRX_STATE, CMD_TRX_OFF);
    DELAY_US(TRX_INIT_TIME_US);
    val = trx_reg_read(RG_TRX_STATUS);
    return (val != TRX_OFF) ? TRX_OK : TRX_INIT_FAIL;
}


static inline uint8_t trx_check_pll_lock(void)
{
uint8_t val, cnt = 255;

    trx_reg_write(RG_TRX_STATE, CMD_FORCE_TRX_OFF);
    trx_reg_write(RG_IRQ_MASK, TRX_IRQ_PLL_LOCK);
    trx_reg_write(RG_TRX_STATE, CMD_PLL_ON);
    cnt = 255;
    do
    {
        DELAY_US(TRX_PLL_LOCK_TIME_US);
        val = trx_reg_read(RG_IRQ_STATUS);
        if (val & TRX_IRQ_PLL_LOCK)
        {
            break;
        }
    }
    while(--cnt);

    /* clear pending IRQs*/
    trx_reg_write(RG_TRX_STATE, CMD_FORCE_TRX_OFF);
    trx_reg_read(RG_IRQ_STATUS);
    return (cnt > 0) ? TRX_OK : TRX_PLL_FAIL;
}


static inline int trx_identify(void)
{
    int ret = 0;

    if(RADIO_PART_NUM != trx_reg_read(RG_PART_NUM))
    {
        ret |= INVALID_PART_NUM;
    }

    if(RADIO_VERSION_NUM != trx_reg_read(RG_VERSION_NUM))
    {
        ret |= INVALID_REV_NUM;
    }
    return ret;
}

static inline void trx_set_panid(uint16_t panid)
{
    trx_reg_write(RG_PAN_ID_0,(panid&0xff));
    trx_reg_write(RG_PAN_ID_1,(panid>>8));
}

static inline void trx_set_shortaddr(uint16_t shortaddr)
{
    trx_reg_write(RG_SHORT_ADDR_0,(shortaddr&0xff));
    trx_reg_write(RG_SHORT_ADDR_1,(shortaddr>>8));
}

static inline void trx_set_longaddr(uint64_t longaddr)
{
    trx_reg_write(RG_IEEE_ADDR_0, (uint8_t)(longaddr>>0) );
    trx_reg_write(RG_IEEE_ADDR_1, (uint8_t)(longaddr>>8) );
    trx_reg_write(RG_IEEE_ADDR_2, (uint8_t)(longaddr>>16));
    trx_reg_write(RG_IEEE_ADDR_3, (uint8_t)(longaddr>>24));
    trx_reg_write(RG_IEEE_ADDR_4, (uint8_t)(longaddr>>32));
    trx_reg_write(RG_IEEE_ADDR_5, (uint8_t)(longaddr>>40));
    trx_reg_write(RG_IEEE_ADDR_6, (uint8_t)(longaddr>>48));
    trx_reg_write(RG_IEEE_ADDR_7, (uint8_t)(longaddr>>56));
}

/* todo add and test a fucntion for setting the ext address */

#ifdef __cplusplus
} /* extern "C" */
#endif

#endif /* TRANSCEIVER_H */