hal/nrf24le1/hal_w2.h

Go to the documentation of this file.

/* Copyright (c) 2009 Nordic Semiconductor. All Rights Reserved.
 *
 * The information contained herein is confidential property of Nordic 
 * Semiconductor ASA.Terms and conditions of usage are described in detail 
 * in NORDIC SEMICONDUCTOR STANDARD SOFTWARE LICENSE AGREEMENT. 
 *
 * Licensees are granted free, non-transferable use of the information. NO
 * WARRENTY of ANY KIND is provided. This heading must NOT be removed from
 * the file.
 *              
 * $LastChangedRevision: 2713 $
 */

#ifndef HAL_W2_H__
#define HAL_W2_H__

#include <stdint.h>
#include <stdbool.h>
#include "nrf24le1.h"

#define W2CON0_FLAG_X_STOP      0x20
#define W2CON0_FLAG_X_START     0x10

#define W2CON1_FLAG_NACK        0x02
#define W2CON1_FLAG_DATA_READY  0x01

#define HAL_W2_ISSUE_START_COND (W2CON0 |= W2CON0_FLAG_X_START)
#define HAL_W2_ISSUE_STOP_COND (W2CON0 |= W2CON0_FLAG_X_STOP)
#define HAL_W2_WAIT_FOR_INTERRUPT {while(!SPIF); SPIF = 0; }
#define HAL_W2_WRITE(a) W2DAT = (a)
#define HAL_W2_READ() W2DAT

#if defined(NRF24LE1_48)
  #define W2_PIN_SDA P13
  #define W2_PIN_SCL P12
  #define HAL_W2_CLEAR_SDA_SCL (P1 &= 0xF3)
  #define HAL_W2_OVERRIDE_SDA_SCL(a, b) P1DIR = (P1DIR & 0xF3) | (a << 3) | (b << 2)  
#elif defined(NRF24LE1_32)
  #define W2_PIN_SDA P05
  #define W2_PIN_SCL P04
  #define HAL_W2_CLEAR_SDA_SCL (P0 &= 0xCF)
  #define HAL_W2_OVERRIDE_SDA_SCL(a, b) P0DIR = (P0DIR & 0xCF) | (a << 5) | (b << 4)
#elif defined(NRF24LE1_24)
  #define W2_PIN_SDA P06
  #define W2_PIN_SCL P05
  #define HAL_W2_CLEAR_SDA_SCL (P0 &= 0x9F)
  #define HAL_W2_OVERRIDE_SDA_SCL(a, b) P0DIR = (P0DIR & 0x9F) | (a << 6) | (b << 5)
#else
#warning "LE1 package type not defined! Add project wide definition depending on the LE1 package variant you are using. Valid options are NRF24LE1_48, NRF24LE1_32 and NRF24LE1_24."
#define W2_SOFT_RESET_NOT_AVAILABLE
#endif

typedef enum {
  HAL_W2_IDLE   = 0x00,       
  HAL_W2_100KHZ = 0x01,       
  HAL_W2_400KHZ = 0x02        
} hal_w2_clk_freq_t;                

typedef enum {
  HAL_W2_MASTER,              
  HAL_W2_SLAVE                
} hal_w2_op_mode_t;                 

typedef enum {
  HAL_W2_STOP_COND = 0x08,    
  HAL_W2_ADRESS_MATCH = 0x04, 
  HAL_W2_DATA_READY = 0x01    
} hal_w2_irq_source_t;

typedef enum {
  HAL_W2_DIR_WRITE,              
  HAL_W2_DIR_READ                
} hal_w2_direction_t;                 


/* Slave specific function prototypes */

void hal_w2_respond_to_gen_adr(bool resp_gen);

void hal_w2_alter_clock(bool alt_clk);

void hal_w2_irq_stop_cond_enable(bool stop_cond);

void hal_w2_irq_adr_match_enable(bool addr_match);

void hal_w2_set_slave_address(uint8_t address);


void hal_w2_set_clk_freq(hal_w2_clk_freq_t freq);

void hal_w2_set_op_mode(hal_w2_op_mode_t mode);

void hal_w2_enable(bool en);

void hal_w2_all_irq_enable(bool irq);

void hal_w2_configure_master(hal_w2_clk_freq_t mode);

bool hal_w2_init_transfer(uint8_t address, hal_w2_direction_t direction);

bool hal_w2_write(uint8_t address, const uint8_t *data_ptr, uint8_t data_len);
bool hal_w2_read(uint8_t address, uint8_t *buffer, uint8_t buffer_size);

#endif // HAL_W2_H__