mag3110.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2014 PHYTEC Messtechnik GmbH
3  * 2017 HAW Hamburg
4  *
5  * This file is subject to the terms and conditions of the GNU Lesser
6  * General Public License v2.1. See the file LICENSE in the top level
7  * directory for more details.
8  */
9 
10 #pragma once
11 
37 #include <stdint.h>
38 #include <stdbool.h>
39 #include "periph/i2c.h"
40 
41 #ifdef __cplusplus
42 extern "C"
43 {
44 #endif
45 
49 enum {
54 };
55 
67 #ifndef CONFIG_MAG3110_I2C_ADDRESS
68 #define CONFIG_MAG3110_I2C_ADDRESS 0x0E
69 #endif
76 #define MAG3110_DROS_8000_16 0
77 #define MAG3110_DROS_4000_32 1
78 #define MAG3110_DROS_2000_64 2
79 #define MAG3110_DROS_1000_128 3
80 #define MAG3110_DROS_4000_16 4
81 #define MAG3110_DROS_2000_32 5
82 #define MAG3110_DROS_1000_64 6
83 #define MAG3110_DROS_0500_128 7
84 #define MAG3110_DROS_2000_16 8
85 #define MAG3110_DROS_1000_32 9
86 #define MAG3110_DROS_0500_64 10
87 #define MAG3110_DROS_0250_128 11
88 #define MAG3110_DROS_1000_16 12
89 #define MAG3110_DROS_0500_32 13
90 #define MAG3110_DROS_0250_64 14
91 #define MAG3110_DROS_0125_128 15
92 #define MAG3110_DROS_0500_16 16
93 #define MAG3110_DROS_0250_32 17
94 #define MAG3110_DROS_0125_64 18
95 #define MAG3110_DROS_0063_128 19
96 #define MAG3110_DROS_0250_16 20
97 #define MAG3110_DROS_0125_32 21
98 #define MAG3110_DROS_0063_64 22
99 #define MAG3110_DROS_0031_128 23
100 #define MAG3110_DROS_0125_16 24
101 #define MAG3110_DROS_0063_32 25
102 #define MAG3110_DROS_0031_64 26
103 #define MAG3110_DROS_0016_128 27
104 #define MAG3110_DROS_0063_16 28
105 #define MAG3110_DROS_0031_32 29
106 #define MAG3110_DROS_0016_64 30
107 #define MAG3110_DROS_0008_128 31
108 #define MAG3110_DROS_DEFAULT MAG3110_DROS_0125_128
114 typedef struct {
116  uint8_t addr;
117  uint8_t type;
118  uint8_t dros;
119  int16_t offset[3];
121 
125 typedef struct {
127 } mag3110_t;
128 
132 typedef struct {
133  int16_t x;
134  int16_t y;
135  int16_t z;
137 
149 int mag3110_init(mag3110_t *dev, const mag3110_params_t *params);
150 
164 int mag3110_set_user_offset(const mag3110_t *dev, int16_t x, int16_t y, int16_t z);
165 
175 
185 
195 int mag3110_is_ready(const mag3110_t *dev);
196 
209 int mag3110_read(const mag3110_t *dev, mag3110_data_t *data);
210 
220 int mag3110_read_dtemp(const mag3110_t *dev, int8_t *dtemp);
221 
222 #ifdef __cplusplus
223 }
224 #endif
225 
int mag3110_init(mag3110_t *dev, const mag3110_params_t *params)
Initialise the MAG3110 magnetometer driver.
int mag3110_is_ready(const mag3110_t *dev)
Check for new set of measurement data.
int mag3110_read(const mag3110_t *dev, mag3110_data_t *data)
Read magnetometer's data.
int mag3110_set_active(const mag3110_t *dev)
Set active mode, this enables periodic measurements.
int mag3110_set_standby(const mag3110_t *dev)
Set standby mode.
int mag3110_read_dtemp(const mag3110_t *dev, int8_t *dtemp)
Read die temperature.
int mag3110_set_user_offset(const mag3110_t *dev, int16_t x, int16_t y, int16_t z)
Set user offset correction.
@ MAG3110_ERROR_DEV
Device MAG3110 not found.
Definition: mag3110.h:52
@ MAG3110_ERROR_CNF
Device configuration failed.
Definition: mag3110.h:53
@ MAG3110_ERROR_I2C
I2C communication failed.
Definition: mag3110.h:51
@ MAG3110_OK
all good
Definition: mag3110.h:50
uint_fast8_t i2c_t
Default i2c_t type definition.
Definition: i2c.h:144
Low-level I2C peripheral driver interface definition.
Data type for the result data.
Definition: mag3110.h:132
int16_t x
acceleration in X direction
Definition: mag3110.h:133
int16_t y
acceleration in Y direction
Definition: mag3110.h:134
int16_t z
acceleration in Z direction
Definition: mag3110.h:135
Configuration parameters.
Definition: mag3110.h:114
uint8_t dros
sampling rate to use
Definition: mag3110.h:118
uint8_t addr
I2C bus address of the device.
Definition: mag3110.h:116
i2c_t i2c
I2C bus the device is connected to.
Definition: mag3110.h:115
uint8_t type
device type
Definition: mag3110.h:117
Device descriptor for MAG3110 magnetometer.
Definition: mag3110.h:125
mag3110_params_t params
device configuration parameters
Definition: mag3110.h:126