---
title: "Configure Sensor Settings on Nodegrid Device"
slug: "configure-sensor-settings-on-nodegrid-device-4"
updated: 2024-05-03T11:58:45Z
published: 2024-05-03T11:58:45Z
canonical: "docs.zpesystems.com/configure-sensor-settings-on-nodegrid-device-4"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zpesystems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Sensor Settings on Nodegrid Device

To perform these procedures, log into the Nodegrid Device.

## Access sub-tab

1. Go to *Managed Devices :: Devices :: DustParticle :: Access*. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679661055156.png)
2. As needed (many of these are optional):
  1. Select **usb_sensor** from the drop-down list for the sensor type.
  2. Enter **Description**.
  3. Enter **Address Location**.
  4. Enter **Coordinates (Lat,Lon**).
  5. Select **Automatically map connected devices to Virtual Machine**. On expanded dialog, enter **Virtual Machine Name**. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679661085882.png)
  6. Click **Icon** (on pop-up, select the preferred icon).
  7. On **Mode** drop-down, select one (**Enabled**, **On-demand**, **Disabled**, **Discovered**).
  8. Select **Show Text Information** checkbox.
3. Click **Save**.

## Management sub-tab

1. Go to *Managed Devices :: Devices :: DustParticle :: Management*. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679661889105.png)
2. In the *Monitoring* menu, select **USB Sensor** checkbox (expands dialog).
  1. On **Template** drop-down, accept default: **usb_sensor**.
  2. Enter **Interval (s)** (default: 120).
3. In the *Scripts* menu (if scripts are available): ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662271086.png)
  1. On **Run on Session Start** drop-down, select a script.
  2. On **Run on Session Stop** drop-down, select a script.
  3. On **Run on Device UP** drop-down, select a script.
  4. On **Run on Device Down** drop-down, select a script.
4. In *Channel Configuration* menu: (assign values as preferred) Each of the four PM#.# concentration fields use these fields (*PM1.0 concentration*, *PM2.5 concentration*, *PM4.0 concentration*, *PM10 concentration*).  ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662139765.png)
  1. In *PM#.# concentration* menu:  
In **PM#.# concentration Channel Unit** drop-down, accept default: **ug/m3**.  
In **PM#.# concentration High Critical Threshold**, enter **30**.  
In **PM#.# concentration High Warning Threshold**, enter **25**.  
In **PM#.# concentration Low Warning Threshold**, enter **7**.  
In **PM#.# concentration Low Critical Threshold**, enter **4**.
5. Click **Save**.

## Custom Fields sub-tab

1. Go to *Managed Devices :: Devices :: DustParticle :: Custom Fields*. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662320458.png)
2. To create a custom field, click **Add** (display’s dialog). ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662346883.png)
  1. Enter **Field Name**.
  2. Enter **Field Value**.
3. Click **Save**.

## Commands sub-tab

1. Go to *Managed Devices :: Devices :: DustParticle :: Commands*. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662373011.png)
2. To create a custom command, click **Add**.
3. In **Command** drop-down select one (**Web**, **Custom Commands**).
  1. Select **Web** (displays dialog). ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662393702.png)Select **Enabled** checkbox.  
Enter **WEB URL**.
  2. Select **Custom Commands** (displays dialog). ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662443356.png)Select **Enabled** checkbox.  
In **Script** drop-down, select one. Select **Enabled** checkbox. Enter **Command Label**.
4. (Repeat as needed)
5. Click **Save**.

## Sensor Channels sub-tab

The table displays configured sensor channels.

1. Go to *Managed Devices :: Devices :: DustParticle :: Sensor Channels*. ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662485411.png)
2. Click on **DustParticle_cn0**channel (displays dialog). ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662508481.png)
  1. Edit **Name** (as needed).
  2. On **Mode** drop-down, accept default: **analog input**.
  3. On **Unit** drop-down, accept default: **ug/m3**.
3. Click on **DustParticle_cn1** channel (displays dialog). ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662532672.png)
  1. Edit **Name** (as needed).
  2. On **Mode** drop-down, accept default: **analog input**.
  3. On **Unit** drop-down, accept default: **ug/m3**.
4. Click on **DustParticle_cn2** channel (displays dialog). ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662577471.png)
  1. Edit **Name** (as needed).
  2. On **Mode** drop-down, accept default: **analog input**.
  3. On **Unit** drop-down, accept default: **ug/m3**.
5. Click on **DustParticle_cn3**channel (displays dialog). ![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1679662624792.png)
  1. Edit **Name** (as needed).
  2. On **Mode** drop-down, accept default: **analog input**.
  3. On **Unit** drop-down, accept default: **ug/m3**.
6. Click **Save**.

## DST-U01 Particle USB Sensor Port Behavior

The DST-U01 Particle USB sensor does not get automatically detected when connected to the USB port. You need to set up the USB port in the Managed Devices page as a **usb_sensor** type before connecting the sensor. Once this initial setup is done, the sensor will be detected as a **usb_sensor**. If the port has the default name **usbSX-Y**, it will be changed to the sensor name, for example, *DustParticle*. When you disconnect the device, the port will be deactivated and the USB device name will be reverted to default **usbSX-Y** from *DustParticle*. However, the device port type will still be recognized as **usb_sensor**. If you want to use the port as a **usb_serial**, configure it to its default setting.

**CLI Command Example**

Configuration command to update the USB device name.

```none
[admin@nodegrid /]# cd /settings/devices 
[admin@nodegrid devices]# rename DustParticle
[admin@nodegrid {devices}]# set new_name=usbS0-1
[admin@nodegrid {devices}]# commit
```