driver_adxl345.h

Go to the documentation of this file.

 
#ifndef DRIVER_ADXL345_H
#define DRIVER_ADXL345_H
 
#include <stdint.h>
#include <stdio.h>
#include <string.h>
 
#ifdef __cplusplus
extern "C"{
#endif
 
typedef enum
{
    ADXL345_INTERFACE_IIC = 0x00,        
    ADXL345_INTERFACE_SPI = 0x01,        
} adxl345_interface_t;
 
typedef enum
{
    ADXL345_ADDRESS_ALT_0 = 0xA6,        
    ADXL345_ADDRESS_ALT_1 = 0x3A,        
} adxl345_address_t;
 
typedef enum
{
    ADXL345_BOOL_FALSE = 0x00,        
    ADXL345_BOOL_TRUE  = 0x01,        
} adxl345_bool_t;
 
typedef enum
{
    ADXL345_COUPLED_DC = 0x00,        
    ADXL345_COUPLED_AC = 0x01,        
} adxl345_coupled_t;
 
typedef enum
{
    ADXL345_ACTION_X   = 0x06,        
    ADXL345_ACTION_Y   = 0x05,        
    ADXL345_ACTION_Z   = 0x04,        
    ADXL345_INACTION_X = 0x02,        
    ADXL345_INACTION_Y = 0x01,        
    ADXL345_INACTION_Z = 0x00,        
} adxl345_action_inaction_t;
 
typedef enum
{
    ADXL345_TAP_AXIS_X = 0x02,        
    ADXL345_TAP_AXIS_Y = 0x01,        
    ADXL345_TAP_AXIS_Z = 0x00,        
} adxl345_tap_axis_t;
 
typedef enum
{
    ADXL345_ACTION_TAP_STATUS_ACT_X  = (1 << 6),        
    ADXL345_ACTION_TAP_STATUS_ACT_Y  = (1 << 5),        
    ADXL345_ACTION_TAP_STATUS_ACT_Z  = (1 << 4),        
    ADXL345_ACTION_TAP_STATUS_ASLEEP = (1 << 3),        
    ADXL345_ACTION_TAP_STATUS_TAP_X  = (1 << 2),        
    ADXL345_ACTION_TAP_STATUS_TAP_Y  = (1 << 1),        
    ADXL345_ACTION_TAP_STATUS_TAP_Z  = (1 << 0),        
} adxl345_action_tap_status_t;
 
typedef enum
{
    ADXL345_RATE_0P1            = 0x00,        
    ADXL345_RATE_0P2            = 0x01,        
    ADXL345_RATE_0P39           = 0x02,        
    ADXL345_RATE_0P78           = 0x03,        
    ADXL345_RATE_1P56           = 0x04,        
    ADXL345_RATE_3P13           = 0x05,        
    ADXL345_RATE_6P25           = 0x06,        
    ADXL345_RATE_12P5           = 0x07,        
    ADXL345_RATE_25             = 0x08,        
    ADXL345_RATE_50             = 0x09,        
    ADXL345_RATE_100            = 0x0A,        
    ADXL345_RATE_200            = 0x0B,        
    ADXL345_RATE_400            = 0x0C,        
    ADXL345_RATE_800            = 0x0D,        
    ADXL345_RATE_1600           = 0x0E,        
    ADXL345_RATE_3200           = 0x0F,        
    ADXL345_LOW_POWER_RATE_12P5 = 0x17,        
    ADXL345_LOW_POWER_RATE_25   = 0x18,        
    ADXL345_LOW_POWER_RATE_50   = 0x19,        
    ADXL345_LOW_POWER_RATE_100  = 0x1A,        
    ADXL345_LOW_POWER_RATE_200  = 0x1B,        
    ADXL345_LOW_POWER_RATE_400  = 0x1C,        
} adxl345_rate_t;
 
typedef enum
{
    ADXL345_SPI_WIRE_4 = 0x00,        
    ADXL345_SPI_WIRE_3 = 0x01,        
} adxl345_spi_wire_t;
 
typedef enum
{
    ADXL345_JUSTIFY_RIGHT = 0x00,        
    ADXL345_JUSTIFY_LEFT  = 0x01,        
} adxl345_justify_t;
 
typedef enum
{
    ADXL345_RANGE_2G  = 0x00,        
    ADXL345_RANGE_4G  = 0x01,        
    ADXL345_RANGE_8G  = 0x02,        
    ADXL345_RANGE_16G = 0x03,        
} adxl345_range_t;
 
typedef enum
{
    ADXL345_SLEEP_FREQUENCY_8HZ = 0x00,        
    ADXL345_SLEEP_FREQUENCY_4HZ = 0x01,        
    ADXL345_SLEEP_FREQUENCY_2HZ = 0x02,        
    ADXL345_SLEEP_FREQUENCY_1HZ = 0x03,        
} adxl345_sleep_frequency_t;
 
typedef enum
{
    ADXL345_MODE_BYPASS  = 0x00,        
    ADXL345_MODE_FIFO    = 0x01,        
    ADXL345_MODE_STREAM  = 0x02,        
    ADXL345_MODE_TRIGGER = 0x03,        
} adxl345_mode_t;
 
typedef enum
{
    ADXL345_TRIGGER_NOT_OCCURRED = 0x00,        
    ADXL345_TRIGGER_OCCURRED     = 0x01,        
} adxl345_trigger_status_t;
 
typedef enum
{
    ADXL345_INTERRUPT_DATA_READY = 0x07,        
    ADXL345_INTERRUPT_SINGLE_TAP = 0x06,        
    ADXL345_INTERRUPT_DOUBLE_TAP = 0x05,        
    ADXL345_INTERRUPT_ACTIVITY   = 0x04,        
    ADXL345_INTERRUPT_INACTIVITY = 0x03,        
    ADXL345_INTERRUPT_FREE_FALL  = 0x02,        
    ADXL345_INTERRUPT_WATERMARK  = 0x01,        
    ADXL345_INTERRUPT_OVERRUN    = 0x00,        
} adxl345_interrupt_t;
 
typedef enum
{
    ADXL345_INTERRUPT_PIN1 = 0x00,        
    ADXL345_INTERRUPT_PIN2 = 0x01,        
} adxl345_interrupt_pin_t;
 
typedef enum
{
    ADXL345_INTERRUPT_ACTIVE_LEVEL_HIGH = 0x00,        
    ADXL345_INTERRUPT_ACTIVE_LEVEL_LOW  = 0x01,        
} adxl345_interrupt_active_level_t;
 
typedef struct adxl345_handle_s
{
    uint8_t iic_addr;                                                                   
    uint8_t (*iic_init)(void);                                                          
    uint8_t (*iic_deinit)(void);                                                        
    uint8_t (*iic_read)(uint8_t addr, uint8_t reg, uint8_t *buf, uint16_t len);         
    uint8_t (*iic_write)(uint8_t addr, uint8_t reg, uint8_t *buf, uint16_t len);        
    uint8_t (*spi_init)(void);                                                          
    uint8_t (*spi_deinit)(void);                                                        
    uint8_t (*spi_read)(uint8_t reg, uint8_t *buf, uint16_t len);                       
    uint8_t (*spi_write)(uint8_t reg, uint8_t *buf, uint16_t len);                      
    void (*receive_callback)(uint8_t type);                                             
    void (*delay_ms)(uint32_t ms);                                                      
    void (*debug_print)(const char *const fmt, ...);                                    
    uint8_t inited;                                                                     
    uint8_t iic_spi;                                                                    
} adxl345_handle_t;
 
typedef struct adxl345_info_s
{
    char chip_name[32];                
    char manufacturer_name[32];        
    char interface[8];                 
    float supply_voltage_min_v;        
    float supply_voltage_max_v;        
    float max_current_ma;              
    float temperature_min;             
    float temperature_max;             
    uint32_t driver_version;           
} adxl345_info_t;
 
#define DRIVER_ADXL345_LINK_INIT(HANDLE, STRUCTURE)         memset(HANDLE, 0, sizeof(STRUCTURE))
 
#define DRIVER_ADXL345_LINK_IIC_INIT(HANDLE, FUC)          (HANDLE)->iic_init = FUC
 
#define DRIVER_ADXL345_LINK_IIC_DEINIT(HANDLE, FUC)        (HANDLE)->iic_deinit = FUC
 
#define DRIVER_ADXL345_LINK_IIC_READ(HANDLE, FUC)          (HANDLE)->iic_read = FUC
 
#define DRIVER_ADXL345_LINK_IIC_WRITE(HANDLE, FUC)         (HANDLE)->iic_write = FUC
 
#define DRIVER_ADXL345_LINK_SPI_INIT(HANDLE, FUC)          (HANDLE)->spi_init = FUC
 
#define DRIVER_ADXL345_LINK_SPI_DEINIT(HANDLE, FUC)        (HANDLE)->spi_deinit = FUC
 
#define DRIVER_ADXL345_LINK_SPI_READ(HANDLE, FUC)          (HANDLE)->spi_read = FUC
 
#define DRIVER_ADXL345_LINK_SPI_WRITE(HANDLE, FUC)         (HANDLE)->spi_write = FUC
 
#define DRIVER_ADXL345_LINK_DELAY_MS(HANDLE, FUC)          (HANDLE)->delay_ms = FUC
 
#define DRIVER_ADXL345_LINK_DEBUG_PRINT(HANDLE, FUC)       (HANDLE)->debug_print = FUC
 
#define DRIVER_ADXL345_LINK_RECEIVE_CALLBACK(HANDLE, FUC)  (HANDLE)->receive_callback = FUC
 
uint8_t adxl345_info(adxl345_info_t *info);
 
uint8_t adxl345_init(adxl345_handle_t *handle);
 
uint8_t adxl345_deinit(adxl345_handle_t *handle);
 
uint8_t adxl345_set_interface(adxl345_handle_t *handle, adxl345_interface_t interface);
 
uint8_t adxl345_get_interface(adxl345_handle_t *handle, adxl345_interface_t *interface);
 
uint8_t adxl345_set_addr_pin(adxl345_handle_t *handle, adxl345_address_t addr_pin);
 
uint8_t adxl345_get_addr_pin(adxl345_handle_t *handle, adxl345_address_t *addr_pin);
 
uint8_t adxl345_read(adxl345_handle_t *handle, int16_t (*raw)[3], float (*g)[3], uint16_t *len);
 
uint8_t adxl345_irq_handler(adxl345_handle_t *handle);
 
uint8_t adxl345_set_tap_threshold(adxl345_handle_t *handle, uint8_t threshold);
 
uint8_t adxl345_get_tap_threshold(adxl345_handle_t *handle, uint8_t *threshold);
 
uint8_t adxl345_tap_threshold_convert_to_register(adxl345_handle_t *handle, float g, uint8_t *reg);
 
uint8_t adxl345_tap_threshold_convert_to_data(adxl345_handle_t *handle, uint8_t reg, float *g);
 
uint8_t adxl345_set_offset(adxl345_handle_t *handle, int8_t x, int8_t y, int8_t z);
 
uint8_t adxl345_get_offset(adxl345_handle_t *handle, int8_t *x, int8_t *y, int8_t *z);
 
uint8_t adxl345_offset_convert_to_register(adxl345_handle_t *handle, float g, int8_t *reg);
 
uint8_t adxl345_offset_convert_to_data(adxl345_handle_t *handle, int8_t reg, float *g);
 
uint8_t adxl345_set_duration(adxl345_handle_t *handle, uint8_t t);
 
uint8_t adxl345_get_duration(adxl345_handle_t *handle, uint8_t *t);
 
uint8_t adxl345_duration_convert_to_register(adxl345_handle_t *handle, uint32_t us, uint8_t *reg);
 
uint8_t adxl345_duration_convert_to_data(adxl345_handle_t *handle, uint8_t reg, uint32_t *us);
 
uint8_t adxl345_set_latent(adxl345_handle_t *handle, uint8_t t);
 
uint8_t adxl345_get_latent(adxl345_handle_t *handle, uint8_t *t);
 
uint8_t adxl345_latent_convert_to_register(adxl345_handle_t *handle, float ms, uint8_t *reg);
 
uint8_t adxl345_latent_convert_to_data(adxl345_handle_t *handle, uint8_t reg, float *ms);
 
uint8_t adxl345_set_window(adxl345_handle_t *handle, uint8_t t);
 
uint8_t adxl345_get_window(adxl345_handle_t *handle, uint8_t *t);
 
uint8_t adxl345_window_convert_to_register(adxl345_handle_t *handle, float ms, uint8_t *reg);
 
uint8_t adxl345_window_convert_to_data(adxl345_handle_t *handle, uint8_t reg, float *ms);
 
uint8_t adxl345_set_action_threshold(adxl345_handle_t *handle, uint8_t threshold);
 
uint8_t adxl345_get_action_threshold(adxl345_handle_t *handle, uint8_t *threshold);
 
uint8_t adxl345_action_threshold_convert_to_register(adxl345_handle_t *handle, float g, uint8_t *reg);
 
uint8_t adxl345_action_threshold_convert_to_data(adxl345_handle_t *handle, uint8_t reg, float *g);
 
uint8_t adxl345_set_inaction_threshold(adxl345_handle_t *handle, uint8_t threshold);
 
uint8_t adxl345_get_inaction_threshold(adxl345_handle_t *handle, uint8_t *threshold);
 
uint8_t adxl345_inaction_threshold_convert_to_register(adxl345_handle_t *handle, float g, uint8_t *reg);
 
uint8_t adxl345_inaction_threshold_convert_to_data(adxl345_handle_t *handle, uint8_t reg, float *g);
 
uint8_t adxl345_set_inaction_time(adxl345_handle_t *handle, uint8_t t);
 
uint8_t adxl345_get_inaction_time(adxl345_handle_t *handle, uint8_t *t);
 
uint8_t adxl345_inaction_time_convert_to_register(adxl345_handle_t *handle, uint8_t s, uint8_t *reg);
 
uint8_t adxl345_inaction_time_convert_to_data(adxl345_handle_t *handle, uint8_t reg, uint8_t *s);
 
uint8_t adxl345_set_action_inaction(adxl345_handle_t *handle, adxl345_action_inaction_t type, adxl345_bool_t enable);
 
uint8_t adxl345_get_action_inaction(adxl345_handle_t *handle, adxl345_action_inaction_t type, adxl345_bool_t *enable);
 
uint8_t adxl345_set_action_coupled(adxl345_handle_t *handle, adxl345_coupled_t coupled);
 
uint8_t adxl345_get_action_coupled(adxl345_handle_t *handle, adxl345_coupled_t *coupled);
 
uint8_t adxl345_set_inaction_coupled(adxl345_handle_t *handle, adxl345_coupled_t coupled);
 
uint8_t adxl345_get_inaction_coupled(adxl345_handle_t *handle, adxl345_coupled_t *coupled);
 
uint8_t adxl345_set_free_fall_threshold(adxl345_handle_t *handle, uint8_t threshold);
 
uint8_t adxl345_get_free_fall_threshold(adxl345_handle_t *handle, uint8_t *threshold);
 
uint8_t adxl345_free_fall_threshold_convert_to_register(adxl345_handle_t *handle, float g, uint8_t *reg);
 
uint8_t adxl345_free_fall_threshold_convert_to_data(adxl345_handle_t *handle, uint8_t reg, float *g);
 
uint8_t adxl345_set_free_fall_time(adxl345_handle_t *handle, uint8_t t);
 
uint8_t adxl345_get_free_fall_time(adxl345_handle_t *handle, uint8_t *t);
 
uint8_t adxl345_free_fall_time_convert_to_register(adxl345_handle_t *handle, uint16_t ms, uint8_t *reg);
 
uint8_t adxl345_free_fall_time_convert_to_data(adxl345_handle_t *handle, uint8_t reg, uint16_t *ms);
 
uint8_t adxl345_set_tap_axis(adxl345_handle_t *handle, adxl345_tap_axis_t axis, adxl345_bool_t enable);
 
uint8_t adxl345_get_tap_axis(adxl345_handle_t *handle, adxl345_tap_axis_t axis, adxl345_bool_t *enable);
 
uint8_t adxl345_set_tap_suppress(adxl345_handle_t *handle, adxl345_bool_t enable);
 
uint8_t adxl345_get_tap_suppress(adxl345_handle_t *handle, adxl345_bool_t *enable);
 
uint8_t adxl345_get_tap_status(adxl345_handle_t *handle, uint8_t *status);
 
uint8_t adxl345_set_rate(adxl345_handle_t *handle, adxl345_rate_t rate);
 
uint8_t adxl345_get_rate(adxl345_handle_t *handle, adxl345_rate_t *rate);
 
uint8_t adxl345_set_self_test(adxl345_handle_t *handle, adxl345_bool_t enable);
 
uint8_t adxl345_get_self_test(adxl345_handle_t *handle, adxl345_bool_t *enable);
 
uint8_t adxl345_set_spi_wire(adxl345_handle_t *handle, adxl345_spi_wire_t wire);
 
uint8_t adxl345_get_spi_wire(adxl345_handle_t *handle, adxl345_spi_wire_t *wire);
 
uint8_t adxl345_set_full_resolution(adxl345_handle_t *handle, adxl345_bool_t enable);
 
uint8_t adxl345_get_full_resolution(adxl345_handle_t *handle, adxl345_bool_t *enable);
 
uint8_t adxl345_set_justify(adxl345_handle_t *handle, adxl345_justify_t enable);
 
uint8_t adxl345_get_justify(adxl345_handle_t *handle, adxl345_justify_t *enable);
 
uint8_t adxl345_set_range(adxl345_handle_t *handle, adxl345_range_t range);
 
uint8_t adxl345_get_range(adxl345_handle_t *handle, adxl345_range_t *range);
 
uint8_t adxl345_set_mode(adxl345_handle_t *handle, adxl345_mode_t mode);
 
uint8_t adxl345_get_mode(adxl345_handle_t *handle, adxl345_mode_t *mode);
 
uint8_t adxl345_set_trigger_pin(adxl345_handle_t *handle, adxl345_interrupt_pin_t pin);
 
uint8_t adxl345_get_trigger_pin(adxl345_handle_t *handle, adxl345_interrupt_pin_t *pin);
 
uint8_t adxl345_get_trigger_status(adxl345_handle_t *handle, adxl345_trigger_status_t *status);
 
uint8_t adxl345_set_link_activity_inactivity(adxl345_handle_t *handle, adxl345_bool_t enable);
 
uint8_t adxl345_get_link_activity_inactivity(adxl345_handle_t *handle, adxl345_bool_t *enable);
 
uint8_t adxl345_set_auto_sleep(adxl345_handle_t *handle, adxl345_bool_t enable);
 
uint8_t adxl345_get_auto_sleep(adxl345_handle_t *handle, adxl345_bool_t *enable);
 
uint8_t adxl345_set_measure(adxl345_handle_t *handle, adxl345_bool_t enable);
 
uint8_t adxl345_get_measure(adxl345_handle_t *handle, adxl345_bool_t *enable);
 
uint8_t adxl345_set_sleep(adxl345_handle_t *handle, adxl345_bool_t enable);
 
uint8_t adxl345_get_sleep(adxl345_handle_t *handle, adxl345_bool_t *enable);
 
uint8_t adxl345_set_sleep_frequency(adxl345_handle_t *handle, adxl345_sleep_frequency_t sleep_frequency);
 
uint8_t adxl345_set_sleep_frequency(adxl345_handle_t *handle, adxl345_sleep_frequency_t sleep_frequency);
 
uint8_t adxl345_get_sleep_frequency(adxl345_handle_t *handle, adxl345_sleep_frequency_t *sleep_frequency);
 
uint8_t adxl345_set_interrupt(adxl345_handle_t *handle, adxl345_interrupt_t type, adxl345_bool_t enable);
 
uint8_t adxl345_get_interrupt(adxl345_handle_t *handle, adxl345_interrupt_t type, adxl345_bool_t *enable);
 
uint8_t adxl345_get_interrupt_source(adxl345_handle_t *handle, uint8_t *source);
 
uint8_t adxl345_set_interrupt_map(adxl345_handle_t *handle, adxl345_interrupt_t type, adxl345_interrupt_pin_t pin);
 
uint8_t adxl345_get_interrupt_map(adxl345_handle_t *handle, adxl345_interrupt_t type, adxl345_interrupt_pin_t *pin);
 
uint8_t adxl345_set_interrupt_active_level(adxl345_handle_t *handle, adxl345_interrupt_active_level_t active_level);
 
uint8_t adxl345_get_interrupt_active_level(adxl345_handle_t *handle, adxl345_interrupt_active_level_t *active_level);
 
uint8_t adxl345_set_watermark(adxl345_handle_t *handle, uint8_t level);
 
uint8_t adxl345_get_watermark(adxl345_handle_t *handle, uint8_t *level);
 
uint8_t adxl345_get_watermark_level(adxl345_handle_t *handle, uint8_t *level);
 
uint8_t adxl345_set_reg(adxl345_handle_t *handle, uint8_t reg, uint8_t *buf, uint16_t len);
 
uint8_t adxl345_get_reg(adxl345_handle_t *handle, uint8_t reg, uint8_t *buf, uint16_t len);
 
#ifdef __cplusplus
}
#endif
 
#endif