1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/drivers/fxos8700/include/fxos8700_params.h
Marian Buschsieweke efbf6efdd3
drivers/fxos8700: Add missing doc and fix doccheck
This commits add documentation to the FXOS8700 params and adds generic
exclude patters to the doc check, so that when boards provide custom
FXOS8700 params they do not need to document them again. The reasoning
is that the documentation in the central place is sufficient.

In addition, a generic exclude patter is added to match FXOS8700_REG_*,
as the register names are relatively self-explaining and an
implementation detail of the driver that doesn't need public
documentation.
2023-01-05 14:25:20 +01:00

104 lines
2.3 KiB
C

/*
* Copyright (C) 2018 UC Berkeley
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup drivers_fxos8700
*
* @{
* @file
* @brief Default configuration for FXOS8700 devices
*
* @author Hyung-Sin Kim <hs.kim@cs.berkeley.edu>
*/
#ifndef FXOS8700_PARAMS_H
#define FXOS8700_PARAMS_H
#include "board.h"
#include "fxos8700.h"
#include "saul_reg.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @name Default configuration parameters for the FXOS8700 driver
* @{
*/
#ifndef FXOS8700_PARAM_I2C
/**
* @brief The I2C bus the FXOS8700 is connected to
*/
#define FXOS8700_PARAM_I2C I2C_DEV(0)
#endif
#ifndef FXOS8700_PARAM_ADDR
/**
* @brief The I2C address of the FXOS8700
*
* The valid address range is 0x1E - 0x1F depending on the configuration of the
* address pins SA0 and SA1.
*/
#define FXOS8700_PARAM_ADDR 0x1E
#endif
#ifndef FXOS8700_PARAM_ACC_RANGE
/**
* @brief The accelerator full-scale range to configure the FXOS8700 with
*/
#define FXOS8700_PARAM_ACC_RANGE FXOS8700_REG_XYZ_DATA_CFG_FS__8G
#endif
#ifndef FXOS8700_PARAM_RENEW_INTERVAL
/**
* @brief The interval for cache renewal to configure the driver with
*/
#define FXOS8700_PARAM_RENEW_INTERVAL 1000000ul
#endif
#ifndef FXOS8700_PARAMS
/**
* @brief The parameters to initialize the FXOS8700 driver with
*/
#define FXOS8700_PARAMS { .i2c = FXOS8700_PARAM_I2C, \
.addr = FXOS8700_PARAM_ADDR, \
.acc_range = FXOS8700_PARAM_ACC_RANGE, \
.renew_interval = FXOS8700_PARAM_RENEW_INTERVAL }
#endif
#ifndef FXOS8700_SAUL_INFO
/**
* @brief The SAUL info to register the FXOS8700 driver instances with
*/
#define FXOS8700_SAUL_INFO { .name = "fxos8700" }
#endif
/**@}*/
/**
* @brief FXOS8700 configuration
*/
static const fxos8700_params_t fxos8700_params[] =
{
FXOS8700_PARAMS
};
/**
* @brief Additional meta information to keep in the SAUL registry
*/
static const saul_reg_info_t fxos8700_saul_info[] =
{
FXOS8700_SAUL_INFO
};
#ifdef __cplusplus
}
#endif
#endif /* FXOS8700_PARAMS_H */
/** @} */