From 4fd3d75e7a3df932fa59cdf0e70d01dc8b234024 Mon Sep 17 00:00:00 2001 From: gamgine Date: Thu, 7 Dec 2017 10:36:33 +0100 Subject: [PATCH] v1.0.0 --- HC_SR04.jpg | Bin 0 -> 63858 bytes README.md | 40 +++++++++++++++++++++++++++- _config.yml | 1 + examples/HCSR04/HCSR04.ino | 9 +++++++ examples/HCSR04/HC_SR04_cabling.jpg | Bin 0 -> 42786 bytes keywords.txt | 19 +++++++++++++ library.properties | 9 +++++++ src/HCSR04.cpp | 24 +++++++++++++++++ src/HCSR04.h | 12 +++++++++ 9 files changed, 113 insertions(+), 1 deletion(-) create mode 100644 HC_SR04.jpg create mode 100644 _config.yml create mode 100644 examples/HCSR04/HCSR04.ino create mode 100644 examples/HCSR04/HC_SR04_cabling.jpg create mode 100644 keywords.txt create mode 100644 library.properties create mode 100644 src/HCSR04.cpp create mode 100644 src/HCSR04.h diff --git a/HC_SR04.jpg b/HC_SR04.jpg new file mode 100644 index 0000000000000000000000000000000000000000..27f7b974c225ad8aa7fdb8ef3adbc0caadfe5946 GIT binary patch literal 63858 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 YKAxU + +HCSR04 hc(2,3);//initialisation class HCSR04 (trig pin , echo pin) + +void setup() +{ Serial.begin(9600); } + +void loop() +{ Serial.println( hc.dist() ); } //return current distance (cm) in serial +``` + +Download +-------- +The last version of the Library is available on the github +[HCSR04 Page](https://github.com/gamegine/HCSR04-ultrasonic-sensor-lib/releases) + + +Install +------- +The library can be installed using the [standard Arduino library install procedure](http://arduino.cc/en/Guide/Libraries) + +[License](https://github.com/gamegine/HCSR04-ultrasonic-sensor-lib/blob/master/LICENSE) +------- +[MIT License](https://github.com/gamegine/HCSR04-ultrasonic-sensor-lib/blob/master/LICENSE) diff --git a/_config.yml b/_config.yml new file mode 100644 index 0000000..c741881 --- /dev/null +++ b/_config.yml @@ -0,0 +1 @@ +theme: jekyll-theme-slate \ No newline at end of file diff --git a/examples/HCSR04/HCSR04.ino b/examples/HCSR04/HCSR04.ino new file mode 100644 index 0000000..97d3cfb --- /dev/null +++ b/examples/HCSR04/HCSR04.ino @@ -0,0 +1,9 @@ +#include + +HCSR04 hc(5,6);//initialisation class HCSR04 (trig pin , echo pin) + +void setup() +{ Serial.begin(9600); } + +void loop() +{ Serial.println( hc.dist() ); }//return curent distance in serial \ No newline at end of file diff --git a/examples/HCSR04/HC_SR04_cabling.jpg b/examples/HCSR04/HC_SR04_cabling.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d375e3b617887e4cb429e7ae277e232e796bcec6 GIT binary patch literal 42786 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 log~u>out = out; + this->echo = echo; + pinMode(this->out, OUTPUT); + pinMode(this->echo, INPUT); +} +HCSR04::~HCSR04() +{ + ~this->out; + ~this->echo; +} +///////////////////////////////////////////////////dist +float HCSR04::dist() const +{ + digitalWrite(this->out, LOW); + delayMicroseconds(2); + digitalWrite(this->out, HIGH); + delayMicroseconds(10); + digitalWrite(this->out, LOW); + return pulseIn(this->echo, HIGH) / 58.0; +} \ No newline at end of file diff --git a/src/HCSR04.h b/src/HCSR04.h new file mode 100644 index 0000000..3920018 --- /dev/null +++ b/src/HCSR04.h @@ -0,0 +1,12 @@ +#include +class HCSR04 +{ + public: + HCSR04(int out,int echo); //initialisation class HCSR04 (trig pin , echo pin) + ~HCSR04(); //destructor + float dist() const; //return curent distance of element 0 + + private: + int out; //out pin + int echo; //echo pin list +};