Configure an Ultrasonic Sensor (viam-micro-server)
Configure an ultrasonic
sensor to integrate the HC-S204 ultrasonic distance sensor into your machine:
Navigate to the CONFIGURE tab of your machine’s page in the Viam app.
Click the + icon next to your machine part in the left-hand menu and select Component.
Select the sensor
type, then select the ultrasonic
model.
Enter a name or use the suggested name for your sensor and click Create.
Edit and fill in the attributes as applicable to your sensor, according to the table below.
Although "board"
is marked as required in viam-server
, it is not required for viam-micro-server
usage.
{
"trigger_pin": "<pin-number>",
"echo_interrupt_pin": "<pin-number>"
}
{
"trigger_pin": "15",
"echo_interrupt_pin": "18"
}
{
"components": [
{
"name": "<your-ultrasonic-sensor-name>",
"model": "ultrasonic",
"type": "sensor",
"namespace": "rdk",
"attributes": {
"trigger_pin": "<pin-number>",
"echo_interrupt_pin": "<pin-number>"
},
"depends_on": []
}
]
}
{
"components": [
{
"name": "my-ultrasonic-sensor",
"model": "ultrasonic",
"type": "sensor",
"namespace": "rdk",
"attributes": {
"trigger_pin": "15",
"echo_interrupt_pin": "18"
},
"depends_on": []
}
]
}
The following attributes are available for ultrasonic
sensors:
Attribute | Type | Required? | Description |
---|---|---|---|
trigger_pin | string | Required | The GPIO number of the board’s GPIO pin that you have wired to the trigger pin of your ultrasonic sensor. |
echo_interrupt_pin | string | Required | The GPIO number of the board’s GPIO pin that you have wired to the echo pin of your ultrasonic sensor. Please note that unlike the RDK ultrasonic sensor, you must not use a named pin associated with a digital interrupt configured on your board: it will not (currently) work. |
timeout_ms | int | Optional | Time to wait in milliseconds before initiating a timeout when requesting readings from your ultrasonic sensor. Default: 50 Max: 100 |
Test the sensor
After you configure your sensor, navigate to the CONTROL tab and select the Sensors dropdown panel. If you have multiple sensors configured, your sensor will be listed here among others. To access detailed readings from your sensor, click on the Get Readings button.
![The sensor component in the control tab](/components/sensor/sensor-control-tab.png)
Have questions, or want to meet other people working on robots? Join our Community Discord.
If you notice any issues with the documentation, feel free to file an issue or edit this file.
Was this page helpful?
Glad to hear it! If you have any other feedback please let us know:
We're sorry about that. To help us improve, please tell us what we can do better:
Thank you!