---
description: 读取超声波传感器距离
---

# readUltrasonicDistance(id)

### 参数

| 参数名 | 类型            | 描述              |
| --- | ------------- | --------------- |
| id  | unsigned char | 要控制的ID号，范围0\~10 |

### 返回

| 参数名    | 类型  | 描述                 |
| ------ | --- | ------------------ |
| number | int | 返回超声波距离，范围0\~400cm |

### 例子

用uKitExplore v2板子每隔400ms打印一次1号超声波传感器的数值.

```c
#include "uKitExplore2.h"
void setup() {    
    Initialization();
}

void loop() {    
    Serial.println(readUltrasonicDistance(1));    
    delay(400);
}
```

用uKitExplore v2板子控制1号超声波传感器，当距离小于5时，亮红灯，大于5时亮绿灯

```c
#include "uKitExplore2.h"
volatile int item;

void setup() {    
    Initialization();     
    item = 0;
}
void loop() {    
    item=readUltrasonicDistance(1));    
    if(item>0 && item<5){        
        setRgbledColor(255,0,0);        
        delay(300);      
    }    
    else{        
        setRgbledColor(0,255,0);        
        delay(300);          
    }
}
```
