tools/llvm: Do not build with symbols
[minix3.git] / minix / drivers / sensors / bmp085 / README.txt
blob5d06460572d04b120a1c965af3499c0e7adebe62
1 BMP085 Driver (Pressure and Temperature Sensor)
2 ===============================================
4 Overview
5 --------
7 This is the driver for the pressure and temperature sensor commonly found on
8 the WeatherCape expansion board for the BeagleBone.
10 Interface
11 ---------
13 This driver implements the character device interface. It supports reading
14 through /dev/bmp085b{1,3}s77. When read from, it returns a string containing
15 a data label, a colon, and the sensor value.
17 Example output of `cat /dev/bmp085b3s77`:
19 TEMPERATURE     : 23.1
20 PRESSURE        : 69964
22 Temperature is expressed in Celsius (a.k.a. centigrade). The resolution is
23 0.1C.
25 Pressure is expressed in Pascals. Valid values are 30000 to 110000.
26 The resolution is 3 Pa.
28 Limitations
29 -----------
31 The measurement resolution is configurable in the chip, but this driver just
32 uses standard mode. It could probably be implemented with an ioctl() or by
33 passing an argument via the service command, but it doesn't seem too useful at
34 this time. See the data sheet for the trade-offs between conversion time,
35 power consumption, and resolution.
37 While only the BMP085 is supported at present, the BMP085's predecessor,
38 SMD500, should be easy to support in this driver with some small changes
39 to the calculations and coefficients.
41 As with the SHT21's temperature sensor, the BMP085's temperature sensor
42 appears to be heated a couple of degrees by the BeagleBone. After power-on,
43 the readings rise slightly and then level off a few degrees above room
44 temperature.
46 Testing the Code
47 ----------------
49 The driver should have been started by a script in /etc/rc.capes/ If not,
50 this is how you start up an instance:
52 cd /dev && MAKEDEV bmp085b3s77
53 /bin/service up /service/bmp085 -label bmp085.3.77 -dev /dev/bmp085b3s77 \
54         -args 'bus=3 address=0x77'
56 Getting the sensor value:
58 cat /dev/bmp085b3s77
60 Killing an instance:
62 /bin/service down bmp085.3.77