Configure a Sensirion-SHT3x-DIS Sensor

Configure a sensirion-sht3xd sensor to integrate a Sensirion SHT3x-DIS temperature and humidity 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 sensirion-sht3xd model. Enter a name or use the suggested name for your sensor and click Create.

Creation of a sensirion-sht3xd sensor in the Viam app config builder.

Fill in the attributes as applicable to your sensor, according to the table below.

{
  "components": [
    {
      "name": "<your-sensirion-sht3xd-sensor-name>",
      "model": "sensirion-sht3xd",
      "type": "sensor",
      "namespace": "rdk",
      "attributes": {
        "i2c_bus": "<your-i2c-bus-index-on-board>",
        "i2c_address": "<your-i2c-address>"
      },
      "depends_on": []
    }
  ]
}

The following attributes are available for sensirion-sht3xd sensors:

AttributeTypeRequired?Description
i2c_busstringRequiredThe index of the I2C bus on the board that the sensor is wired to.
i2c_addressstringOptionalThe I2C device address of the sensor.
Default: 0x44

Test the sensor

After you configure your sensor, open the sensor’s TEST panel on the CONFIGURE or CONTROL tabs. To access detailed readings from your sensor, click on the Get Readings button.

The sensor component in the test panel

Troubleshooting

If your sensor is not working as expected, follow these steps:

  1. Check your machine logs on the LOGS tab to check for errors.
  2. Review this sensor model’s documentation to ensure you have configured all required attributes.
  3. Check that any wires are securely attached to the correct pins, if appropriate.
  4. Click on the TEST panel on the CONFIGURE or CONTROL tab and test if you can use the sensor there.

If none of these steps work, reach out to us on the Community Discord and we will be happy to help.

Next steps

Check out the sensor API or check out one of these guides:

Sensor API

Commands for getting sensor readings.

Collect sensor data

Gather sensor data, sync it to the cloud, and view it in the Viam app.

Configure a machine

Create a machine in a few steps using Viam's modular system of components and services without writing much or any code.

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.