1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/tests/driver_srf02/README.md
Hauke Petersen 1a91600c24 tests/driver_srf02: mutliple improvements
- added single shot conversion command
- enhanced README
- added more verbose output
- now all outputted addresses are in decimal format
2016-03-22 17:07:04 +01:00

52 lines
2.1 KiB
Markdown

# About
This is a manual test application for the SRF02 ultrasonic ranger driver.
# Usage
First you always need to initialize the sensor using the `init` shell command
and the devices address in right-aligned, decimal format (as specified in the
reference manual), e.g.: `init 224`.
If successful (the shell will tell you...), you can sample distance data from
the device, either once (`shoot`) or continuously every second (`sample`).
This test application also allows to re-program the I2C address of SRF02
devices. For this initialize the device with its current address and then change
to the new address using the `addr` shell command (e.g. `addr 228`). After
calling the `addr` command, this application will automatically re-initialize
the device with the new address, so it is usable right away. Refer to the
datasheet for more information on usable addresses.
The following sequence shows how to re-program a device. The initial address is
`224`, the new address after the sequence is `228`:
```
2016-03-21 15:53:34,049 - INFO # > init 224
2016-03-21 15:53:34,054 - INFO # Initializing SRF02 sensor at I2C_DEV(0), address is 224
2016-03-21 15:53:34,079 - INFO # ... [Ok]
2016-03-21 15:53:34,079 - INFO #
shoot
2016-03-21 15:53:37,339 - INFO # > shoot
2016-03-21 15:53:37,411 - INFO # distance = 94 cm
addr 228
2016-03-21 15:53:41,468 - INFO # > addr 228
2016-03-21 15:53:41,472 - INFO # Set address to 228
shoot
2016-03-21 15:53:42,454 - INFO # > shoot
2016-03-21 15:53:42,527 - INFO # distance = 94 cm
init 224
2016-03-21 15:53:48,933 - INFO # > init 224
2016-03-21 15:53:48,938 - INFO # Initializing SRF02 sensor at I2C_DEV(0), address is 224
2016-03-21 15:53:48,962 - INFO # ... [Failed]
shoot
2016-03-21 15:53:50,568 - INFO # > shoot
2016-03-21 15:53:50,641 - INFO # distance = 29703 cm
init 228
2016-03-21 15:53:53,084 - INFO # > init 228
2016-03-21 15:53:53,089 - INFO # Initializing SRF02 sensor at I2C_DEV(0), address is 228
2016-03-21 15:53:53,113 - INFO # ... [Ok]
2016-03-21 15:53:53,113 - INFO #
shoot
2016-03-21 15:53:54,201 - INFO # > shoot
2016-03-21 15:53:54,274 - INFO # distance = 94 cm
```