Project

General

Profile

Revision 891

Moved comments to headers. That was painful.

View differences:

rangefinder.h
38 38
#define _RANGEFINDER_H_
39 39

  
40 40
/**
41
 * @addtogroup rangefinder
41
 * @defgroup rangefinder Rangefinder
42
 * @brief Functions for using the IR rangefinders
43
 * 
44
 * Functions for using the IR rangefinders.
45
 *
42 46
 * @{
43 47
 **/
44 48

  
49

  
45 50
/** @brief IR Rangefinder 1 **/
46 51
#define IR1 6
47 52
/** @brief IR Rangefinder 2 **/
......
53 58
/** @brief IR Rangefinder 5 **/
54 59
#define IR5 2
55 60

  
56
/** @brief Initialize the rangefinders **/
61
/**
62
 * @brief Initialize the rangefinders
63
 *
64
 * Initializes the rangefinders. This must be called before
65
 * range_read_distance.
66
 *
67
 * @see range_read_distance
68
 **/
57 69
void range_init(void);
58
/** @brief Read the distance from a rangefinder **/
70
/**
71
 * @brief Read the distance from a rangefinder
72
 *
73
 * Reads the distance measured by one of the rangefinders.
74
 * This distance is in arbitrary units.
75
 *
76
 * @param range_id the rangefinder to use. This should be one
77
 * of the constants IR1 - IR5.
78
 *
79
 * @return the distance measured by the rangefinder
80
 *
81
 * @see range_init
82
 **/
59 83
int range_read_distance(int range_id);
60 84

  
61 85
/** @} **/ //end addtogroup

Also available in: Unified diff