树莓派控制HC-SR04超声波模块测距

一.超声波的工作原理：


二.编程实现：
#include <wiringPi.h>
#include <stdio.h>
#include <sys/time.h>
#define Trig 4
#define Echo 5

void ultraInit(void)
{
pinMode(Echo, INPUT); //设置端口为输入
pinMode(Trig, OUTPUT); //设置端口为输出
}

float disMeasure(void)
{
struct timeval tv1; //timeval是time.h中的预定义结构体 其中包含两个一个是秒，一个是微秒
/*
struct timeval
{
time_t tv_sec; //Seconds.
suseconds_t tv_usec; //Microseconds.
};
*/

struct timeval tv2;
long start, stop;
float dis;

digitalWrite(Trig, LOW);
delayMicroseconds(2);

digitalWrite(Trig, HIGH);
delayMicroseconds(10);      //发出超声波脉冲
digitalWrite(Trig, LOW);

while(!(digitalRead(Echo) == 1));
gettimeofday(&tv1, NULL);           //获取当前时间 开始接收到返回信号的时候

while(!(digitalRead(Echo) == 0));
gettimeofday(&tv2, NULL);           //获取当前时间  最后接收到返回信号的时候
/*
int gettimeofday(struct timeval *tv, struct timezone *tz);
The functions gettimeofday() and settimeofday() can get and set the time as well as a timezone.
The use of the timezone structure is obsolete; the tz argument should normally be specified as NULL.
*/
start = tv1.tv_sec * 1000000 + tv1.tv_usec;   //微秒级的时间
stop  = tv2.tv_sec * 1000000 + tv2.tv_usec;

dis = (float)(stop - start) / 1000000 * 34000 / 2;  //计算时间差求出距离

return dis;

}

int main(void)
{
float dis;

if(wiringPiSetup() == -1){ //如果初始化失败，就输出错误信息 程序初始化时务必进行
    printf("setup wiringPi failed !");
    return 1;
}

ultraInit();

while(1){
    dis = disMeasure();
    printf("distance = %0.2f cm\n",dis);
    delay(1000);
}

return 0;

}

1.sys/time.h

360搜索链接：https://baike.so.com/doc/1233815-1304991.html

2.wiringPi.h

wiringPi是一个很棒的树莓派IO控制库，使用C语言开发，提供了丰富的接口：GPIO控制，中断，多线程，等等。

wiringPi.h详解：https://www.cnblogs.com/lulipro/p/5992172.html

3.wiringPiSetup(void)

在使用wiringPi.h库时，在执行任何操作前都必须初始化树莓派，否则程序便无法正常运行。当初始化操作未完成时，函数返回值为-1

其他的树莓派初始化函数还有wiringPiSetupGpio(void)，此函数使用方法与wiringPiSetup(void)类似，当函数无法正常运行时返回值也是-1.不同的地方在于，wiringPiSetup(void)初始化树莓派引脚时使用的是wiringPi 引脚编号表。引脚的编号为 0~16;wiringPiSetupGpio(void)初始化树莓派引脚时使用的是BCM GPIO 引脚编号表。

其他两种函数还有wiringPiSetupPhys(void)和wiringPiSetupSys (void) ，因为不常用，所以在此处不做介绍。

4.void pinMode(uint8 pin, WiringPinMode mode)

这个函数是用来确定引脚的功能的，如果在使用某个引脚之前没有确定这个引脚的功能或者引脚设置模式不正确，就会出现一些不可捉摸的错误。

这个函数有两个参数，第一个参数pin是一个正整数，用来指定引脚的编号（0-16），第二个参数是用来指定引脚的IO模式，可用的参数有INPUT , OUTPUT , OUTPUT_OPEN_DRAIN , INPUT_ANALOG , INPUT_PULLUP , INPUT_PULLDOWN , INPUT_FLOATING , PWMPWM_OPEN_DRAIN

每个参数的具体意义请移步：https://book.2cto.com/201311/36087.html

5.timeval

在代码中已经告诉了我们整个结构体的来历和定义下的架构，这里不做详解，有兴趣的童鞋请移步https://blog.csdn.net/king16304/article/details/52273834

6.digitalWrite(uint8 pin, uint8 value)

这又是一个在wiringPi.h中已经定义好的函数，它的作用是对一个已近配置为输出模式（OUTPUT或者OUTPUT_OPEN_DRAIN）的 引脚 输出指定的电平信号，其中pin是一个正整数，用来指定一个已经初始化过的引脚，value可以是数字或者参数，数字表示下：1代表高电平，0代表低电平;参数表示下：LOW代表低电平，HIGH代表高电平。

7.delayMicroseconds (unsigned int howLong)

将线程暂停指定的微秒数（1000微妙=1毫秒=0.001s），因为Linux是多线程的，所以实际暂停的秒数可能比设置的更多一些

8.digitalRead (int pin)

读取一个引脚的电平值（LOW / HIGH）,并且返回。其中pin是引脚的编号，该引脚的初始化类型必须为INPUT等输入类型。返回值也可以是1 / 0（当输入信号电压在0～1.16 V时该函数返回0，当输入信号在1.83～3.3 V时返回1。如果输入电压在1.16～1.83 V之间不确定会返回0还是1。）

9.gettimeofday(struct timeval *, struct timezone *);

则个函数返回的是1970年0:00:00到现在经过的秒数，函数的正常传入时需要用到两个参数。第一个已经介绍过了，第二个因为在这里没有用处，所以暂且不表，传入参数时用NULL即可，这里关于这个问题还有一个小故事：timeval中的tv_sec是time_t类型的，即long的类型。在32位下为4个字节，能够表示的最大正整数是2147483647，而这个表示的时间最大能到2038-01-19 03:14:07，超过了之后就变为-2147483648，这就是linux2038年的问题。而64位系统下的time_t类型即long类型长度为8个字节，可以用到几千亿年，这么长的时间完全不用担心溢出的问题。

10.根据返回的秒数计算出微秒数

start = tv1.tv_sec * 1000000 + tv1.tv_usec;

stop = tv2.tv_sec * 1000000 + tv2.tv_usec;

我们知道 timeval结构体中含有两个变量，tv_sec表示的是秒数，1秒=1000000微妙，第二个参数tv_usec表示的就是微秒数，所以通过这两个式子我们就求出了开始和结束时的微秒数，然后做差即可得到超声波传递所使用的时间

11.根据时间计算距离

(stop - start) / 1000000 * 34000 / 2

因为stop和start原本表示的微妙，所以做差之后处1000000换算回是多少秒。因为声音在物质中的传播受到物质材质的影响，这里我们暂且不考虑介质的种类，默认为声音是在空气中传播，所以取声音的速度为340m/s=34000cm/s，因为超声波测距的误差较小的范围200-300cm，所以我们这里计算速度时用cm表示。