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. 
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. 
   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. 
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): 
   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).  
   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. 
2. To create a custom field, click Add (display’s dialog). 
   1. Enter Field Name.
   2. Enter Field Value.
3. Click Save.

Commands sub-tab

1. Go to Managed Devices :: Devices :: DustParticle :: Commands. 
2. To create a custom command, click Add.
3. In Command drop-down select one (Web, Custom Commands).
   1. Select Web (displays dialog). Select Enabled checkbox.
      Enter WEB URL.
   2. Select Custom Commands (displays dialog). 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. 
2. Click on DustParticle_cn0channel (displays dialog). 
   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). 
   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). 
   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_cn3channel (displays dialog). 
   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.

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