qma6100p.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2026 Baptiste Le Duc <baptiste.leduc@etik.com>
 * SPDX-FileCopyrightText: 2026 Léandre Le Duc <leandre.leduc38@gmail.com>
 * SPDX-License-Identifier: LGPL-2.1-only
 */
 
#pragma once

 
#include <stdbool.h>
#include <stdint.h>
 
#include "periph/gpio.h"
#include "periph/i2c.h"
 
#ifdef __cplusplus
extern "C" {
#endif

enum {
    QMA6100P_OK = 0,           
    QMA6100P_DATA_READY = 1,   
    QMA6100P_NO_NEW_DATA = 2,  
    QMA6100P_NOI2C = -1,       
    QMA6100P_NODEV = -2,       
    QMA6100P_INVALID_ARG = -3, 
    QMA6100P_GPIO_ERROR = -4,  
    QMA6100P_TIMEOUT = -5,     
};

typedef enum {
    QMA6100P_RANGE_2G = 0x01,  
    QMA6100P_RANGE_4G = 0x02,  
    QMA6100P_RANGE_8G = 0x04,  
    QMA6100P_RANGE_16G = 0x08, 
    QMA6100P_RANGE_32G = 0x0F, 
} qma6100p_range_t;

typedef enum {
    QMA6100P_ODR_100HZ = 0x00,  
    QMA6100P_ODR_200HZ = 0x01,  
    QMA6100P_ODR_400HZ = 0x02,  
    QMA6100P_ODR_800HZ = 0x03,  
    QMA6100P_ODR_1600HZ = 0x04, 
    QMA6100P_ODR_50HZ = 0x05,   
    QMA6100P_ODR_25HZ = 0x06,   
    QMA6100P_ODR_12HZ5 = 0x07,  
} qma6100p_odr_t;

typedef enum {
    QMA6100P_PM_MCLK_51K2 = 4, 
    QMA6100P_PM_MCLK_25K6 = 5, 
    QMA6100P_PM_MCLK_12K8 = 6, 
    QMA6100P_PM_MCLK_6K4 = 7,  
} qma6100p_mclk_t;

typedef void (*qma6100p_int_cb_t)(void *);

typedef enum {
    QMA6100P_INTPIN_PUSH_PULL = 0,  
    QMA6100P_INTPIN_OPEN_DRAIN = 1, 
} qma6100p_int_pin_mode_t;

typedef enum {
    QMA6100P_INTPIN_ACTIVE_LOW = 0,  
    QMA6100P_INTPIN_ACTIVE_HIGH = 1, 
} qma6100p_int_active_level_t;

typedef enum {
    QMA6100P_INT_CFG_SHADOW_EN = 0,
    QMA6100P_INT_CFG_SHADOW_DIS = 1,
} qma6100p_int_shadow_t;

typedef enum {
    QMA6100P_INT1 = 1, 
    QMA6100P_INT2 = 2, 
} qma6100p_int_pin_num_t;

typedef struct {
    i2c_t i2c;    
    uint8_t addr; 
    gpio_t int1_pin;
    gpio_t int2_pin;
    qma6100p_odr_t rate;                    
    qma6100p_range_t range;                 
    qma6100p_mclk_t mclk;                   
    qma6100p_int_shadow_t interrupt_shadow; 
} qma6100p_params_t;

typedef struct {
    qma6100p_params_t params; 
} qma6100p_t;

typedef struct {
    int16_t x; 
    int16_t y; 
    int16_t z; 
} qma6100p_raw_data_t;

typedef struct {
    int32_t x; 
    int32_t y; 
    int32_t z; 
} qma6100p_data_t;

int qma6100p_init(qma6100p_t *dev, const qma6100p_params_t *params);

int qma6100p_set_low_power(qma6100p_t *dev);

int qma6100p_set_active_mode(qma6100p_t *dev);

int qma6100p_read_raw(const qma6100p_t *dev, qma6100p_raw_data_t *data);

int qma6100p_read(const qma6100p_t *dev, qma6100p_data_t *data);

int qma6100p_set_data_ready_int(qma6100p_t *dev, qma6100p_int_pin_num_t line,
                                qma6100p_int_cb_t cb, void *arg);
 
#ifdef __cplusplus
}
#endif