--- title: Serial Particulate Matter description: Instructions on how to integrate particulate matter (dust) sensors with Home Assistant. ha_category: - DIY ha_release: 0.26 ha_iot_class: Local Polling ha_domain: serial_pm ha_platforms: - sensor ha_integration_type: integration --- Particulate matter sensors measure the amount of very small particles in the air. Cheap LED based sensors usually use a GPIO interface that is hard to attach to computers. However, there are a lot of laser LED based sensors on the market that use a serial interface and can be connected to your Home Assistant system easily with a USB to serial converter. ## Supported Sensors At this time, the following sensors are supported: - oneair,s3 - novafitness,sds021 - novafitness,sds011 - plantower,pms1003 - plantower,pms5003 - plantower,pms7003 - plantower,pms2003 - plantower,pms3003 ## Configuration To use your PM sensor in your installation, add the following to your {% term "`configuration.yaml`" %} file: ```yaml sensor: - platform: serial_pm serial_device: /dev/tty.SLAB_USBtoUART brand: oneair,s3 ``` {% configuration %} serial_device: description: The serial port to use. On *nix systems, it can often be identified by `$ ls /dev/tty*` required: true type: string name: description: The name displayed in the frontend. required: false type: string brand: description: Manufacturer and type of the sensor. (Use a value from the supported sensors list.). required: true type: string {% endconfiguration %} ### Named Sensor Configuration Example ```yaml sensor: - platform: serial_pm serial_device: /dev/tty.SLAB_USBtoUART name: Nova brand: novafitness,sds011 ```