Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ericksimoes/ultrasonic
Minimalist library for Ultrasonic Module HC-SR04, PING))) and Seeed SEN136B5B to Arduino
https://github.com/ericksimoes/ultrasonic
arduino arduino-library hacktoberfest hc-sr04 minimalist-library ping sen136b5b sensor ultrasonic ultrasound
Last synced: 3 months ago
JSON representation
Minimalist library for Ultrasonic Module HC-SR04, PING))) and Seeed SEN136B5B to Arduino
- Host: GitHub
- URL: https://github.com/ericksimoes/ultrasonic
- Owner: ErickSimoes
- License: mit
- Created: 2014-04-03T03:21:01.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2022-04-24T13:42:37.000Z (over 2 years ago)
- Last Synced: 2023-11-07T19:49:10.590Z (about 1 year ago)
- Topics: arduino, arduino-library, hacktoberfest, hc-sr04, minimalist-library, ping, sen136b5b, sensor, ultrasonic, ultrasound
- Language: C++
- Homepage:
- Size: 154 KB
- Stars: 120
- Watchers: 10
- Forks: 63
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://opensource.org/)
[](https://github.com/ErickSimoes/Ultrasonic/blob/master/LICENSE)
[](https://github.com/ErickSimoes/Ultrasonic/releases/latest)
[](https://github.com/ErickSimoes/Ultrasonic/actions/workflows/check-arduino.yml)
🇬🇧 **English** | 🇧🇷 [Português Brasileiro](./README_pt-br.md)
Ultrasonic
===========
_Minimalist library for ultrasound module to Arduino_
### Compatible with **HC-SR04**, **Ping)))** and **Seeed SEN136B5B** (_from Seeed Studio_)
Work with **ultrasonic modules** is fairly simple, but can be even more practical if you abstract the control of some features. This library aims to resource efficiency and to simplify access to data.
Where necessary use the ultrasonic module **HC-SR04** (one of the most common on the market), **Ping)))** and/or **Seeed SEN136B5B** (_from Seeed Studio_), there are hundreds of libraries that purport to provide the most diverse roles for the user, however, the vast majority of the time, we just need to find out the distance and is that's what does this library.
This library is minimalist, reduces code execution, validation and unnecessary use of global variables, prioritizing smaller data types.
You can run the library examples on the Wokwi Arduino simulator. Wokwi is a free Arduino simulator which runs on the browser. Here are two examples presenting the features of the Ultrasonic library
Example 1 - [Ultrasonic distance measurement using 4 pin and 3 pin sensor versions ](https://wokwi.com/arduino/projects/296099969420493322)
Example 2 - [Reading distance in both centimeters and inches](https://wokwi.com/arduino/projects/312346565007114818)
Wiring:
---------------
It is very easy to connect an ultrasound module to the Arduino. For example, if you are using **HC-SR04**, connect the `trigger` and `echo` pin module on pin `12` and `13` of the Arduino, respectively. As in the picture:
If you are using a module with three pins (like **Ping)))** or **Seeed SEN136B5B**), you can conect the `sig` pin module on pin `13` of the Arduino.
> You can use the [Fritzing](http://fritzing.org/home/)(_.fzz_) files inside [extras](https://github.com/ErickSimoes/Ultrasonic/tree/master/extras) to draw your prototypes.
How to use:
---------------
The idea is to provide a simpler environment possible. To do this, simply follow the steps:
1. **Installing**
First you need to import the library so that the IDE recognizes it. The simplest way is importing through the IDE itself:
- Click in ```Sketch > Include Library > Manage Libraries...```;
- In the search field type: ```ultrasonic```;
- In the list, look for ```Ultrasonic by Erick Simões```;
- Click on ```Install```.
> Alternatively, you can download the library [here](https://github.com/ErickSimoes/Ultrasonic/archive/master.zip) and import the ```.zip``` file into the IDE (see how to import a library [here](https://www.arduino.cc/en/Guide/Libraries#toc4)).
2. **Importing on code**
To import the library to your code, just write at the beginning of the code ```#include ``` or, in the Arduino IDE, click in ```Sketch > Include Library > Ultrasonic``` (_will have the same result_).
3. **Starting** (the most exciting part)
Now is simply create a variable of type Ultrasonic passing as parameters two values representing, respectively, the Trig (emitter) and Echo (receiver) pins. Like this:
```c++
Ultrasonic ultrasonic(12, 13);
```
If you are using a module with three pins (like **Ping)))** or **Seeed SEN136B5B**), pass as a parameter only the signal pin. Like this:
```c++
Ultrasonic ultrasonic(13);
```
4. **Discovering the distance**
Having initialized a variable, you can run hers from the method that returns the distance read by module Ultrasonic: ```read()```:
```c++
ultrasonic.read();
```
5. **Only this?**
Yes. That's it. By default, the value returned from the function ```read()``` is the distance in centimeters. See full sample code [here](/examples/UltrasonicSimple/UltrasonicSimple.ino).
6. **Seriously?**
You can still do a little more determining the unit of measurement that will be returned (centimeters (`CM`) or inches (`INC`)).
```c++
ultrasonic.read() // distance in CM
ultrasonic.read(CM) // distance in CM
ultrasonic.read(INC) // distance in INC
```
You can also use more than one ultrasound module:
```c++
Ultrasonic ultrasound1(12, 13);
Ultrasonic ultrasound2(10, 11);
Ultrasonic ultrasound3(5);
```
7. **Timeouts**
If there is no object in range, the library will lock-up as it waits for the return pulse. You can change how long to wait by setting a timeout (in microseconds) in the constructor:
```c++
Ultrasonic ultrasonic(12, 13, 40000UL);
```
Or during runtime:
```c++
ultrasonic.setTimeout(40000UL);
```
> The default value is `20000UL` (_Unsigned Long_).
Using a 40ms timeout should give you a maximum range of approximately 6.8m. You may need to adjust this parameter.
#### See the examples [here](https://github.com/ErickSimoes/Ultrasonic/tree/master/examples).
License
----
Ultrasonic by [Erick Simões](http://ericksimoes.com.br/ "Erick Simões") is licensed under a MIT License.
Based on the work of Carl John Nobile available [here](http://wiki.tetrasys-design.net/HCSR04Ultrasonic).
Feel free to contact the author on Twitter: [@AloErickSimoes](https://twitter.com/AloErickSimoes)
See [LICENSE](https://github.com/ErickSimoes/Ultrasonic/blob/master/LICENSE) for details.