srf08.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2013 Zakaria Kasmi <zkasmi@inf.fu-berlin.de>
3  *
4  * This file is subject to the terms and conditions of the GNU Lesser General
5  * Public License v2.1. See the file LICENSE in the top level directory for more
6  * details.
7  */
8 
9 #pragma once
10 
30 #include <stdint.h>
31 #include "periph/i2c.h"
32 
33 #ifdef __cplusplus
34 extern "C" {
35 #endif
36 
38 #define SRF08_COMMAND_REG 0x0
39 
41 #define SRF08_GAIN_REG 0x1
42 
44 #define SRF08_RANGE_REG 0x2
45 
47 #define SRF08_RANGE_HIGH_BYTE 0x2
48 
50 #define SRF08_RANGE_LOW_BYTE 0x3
51 
53 #define SRF08_MAX_REGISTER_NUMBER 35
54 
56 #define SRF08_MAX_ECHO_NUMBER 17
57 
59 #define SRF08_MAX_RANGE_6M 0x8C
60 
62 #define SRF08_MAX_GAIN 0x1F
63 
67 typedef struct {
69  uint8_t addr;
71 
75 typedef struct {
77 } srf08_t;
78 
82 typedef enum {
83  SRF08_MODE_INCH = 0x50,
84  SRF08_MODE_CM = 0x51,
90 
102 int srf08_init(srf08_t *dev, const srf08_params_t *params);
103 
116 int srf08_set_max_range(const srf08_t *dev, uint8_t max_range);
117 
133 int srf08_set_max_gain(const srf08_t *dev, uint8_t max_gain);
134 
158  uint16_t *range_array,
159  int num_echos,
160  srf08_mode_t ranging_mode);
161 
162 #ifdef __cplusplus
163 }
164 #endif
165 
uint_fast8_t i2c_t
Default i2c_t type definition.
Definition: i2c.h:144
int srf08_get_distances(const srf08_t *dev, uint16_t *range_array, int num_echos, srf08_mode_t ranging_mode)
Get all distances measured from the SRF08 ultrasonic sensor.
int srf08_set_max_range(const srf08_t *dev, uint8_t max_range)
Set the maximum range of the SRF08.
int srf08_init(srf08_t *dev, const srf08_params_t *params)
Initialize the SRF08 ultrasonic sensor.
int srf08_set_max_gain(const srf08_t *dev, uint8_t max_gain)
Set the maximum of the analog stages.
srf08_mode_t
Possible measurement modes for the SRF08 sensor.
Definition: srf08.h:82
@ SRF08_ANN_MODE_INCH
synchronous measurement in inch
Definition: srf08.h:86
@ SRF08_MODE_INCH
result in inches
Definition: srf08.h:83
@ SRF08_MODE_MICRO_SEC
result in centimeters
Definition: srf08.h:85
@ SRF08_ANN_MODE_MICRO_SEC
synchronous measurement in us
Definition: srf08.h:88
@ SRF08_MODE_CM
result in centimeters
Definition: srf08.h:84
@ SRF08_ANN_MODE_CM
synchronous measurement in cm
Definition: srf08.h:87
Low-level I2C peripheral driver interface definition.
Device initialization parameters.
Definition: srf08.h:67
i2c_t i2c
I2C device the sensor is connected to.
Definition: srf08.h:68
uint8_t addr
I2C bus address of the sensor.
Definition: srf08.h:69
Device descriptor for SRF08 sensors.
Definition: srf08.h:75
srf08_params_t params
Initialization parameters.
Definition: srf08.h:76