Device Configuration Commands

How to configure Thingsee AIR — Service API commands and GraphQL examples

Overview

Thingsee AIR is configured remotely through the Service API (GraphQL) — named commands with built-in validation and automatic encoding.

This page documents the available commands and provides ready-to-use examples. For detailed parameter explanations and configuration scenarios, see Configuration.

Self-hosted Wirepas gateway?

If you operate your own gateways and send raw mesh commands, see the CBOR Downlink Reference for the binary command specification.

Service API Commands

The Service API provides named configuration commands that handle CBOR encoding, delivery, and validation automatically. Use these through the Service API (GraphQL).

Available Commands

Command	Purpose	Parameters
`SetReportAndMeasurementInterval`	Set reporting and measurement frequency	`reportInterval`, `measurementInterval`
`GetReportAndMeasurementInterval`	Read current intervals	—
`ResetTVOC`	Reset TVOC sensor baseline	—

SetReportAndMeasurementInterval

Configures how frequently the sensor takes measurements and reports data to the cloud.

Parameters:

Parameter	Type	Range	Default	Description
`reportInterval`	Integer	600–86400	3600	How often the sensor sends a report to the cloud (seconds)
`measurementInterval`	Integer	10–86400	300	How often the sensor takes a measurement (seconds)

Set 5-minute reporting with 30-second measurement:

mutation {
  setReportAndMeasurementInterval(
    input: {
      vendorSerial: "TSAR01TSC20204001"
      reportInterval: 300
      measurementInterval: 30
    }
  ) {
    success
  }
}

Replace these example values

TSAR01TSC20204001 — your device vendor serial number
300 — your desired reporting interval in seconds (min 600s, max 86400s)
30 — your desired measurement interval in seconds (min 10s, max 86400s)

GetReportAndMeasurementInterval

Reads the current reporting and measurement intervals from the device.

query {
  getReportAndMeasurementInterval(
    vendorSerial: "TSAR01TSC20204001"
  ) {
    reportInterval
    measurementInterval
  }
}

ResetTVOC

Resets the TVOC sensor baseline. Use when the sensor has been exposed to high VOC levels and needs recalibration.

mutation {
  resetTVOC(
    input: {
      vendorSerial: "TSAR01TSC20204001"
    }
  ) {
    success
  }
}

Replace these example values

TSAR01TSC20204001 — your device vendor serial number

Quick Configuration Recipes

High-Frequency Air Quality Monitoring

10-minute reporting with 30-second measurement for meeting rooms:

mutation {
  setReportAndMeasurementInterval(
    input: {
      vendorSerial: "TSAR01TSC20204001"
      reportInterval: 600
      measurementInterval: 30
    }
  ) {
    success
  }
}

Low-Power Long Interval

1-hour reporting with 5-minute measurement for general areas (maximizes battery life):

mutation {
  setReportAndMeasurementInterval(
    input: {
      vendorSerial: "TSAR01TSC20204001"
      reportInterval: 3600
      measurementInterval: 300
    }
  ) {
    success
  }
}

Reset TVOC After High Exposure

If TVOC readings seem elevated after cleaning or construction:

mutation {
  resetTVOC(
    input: {
      vendorSerial: "TSAR01TSC20204001"
    }
  ) {
    success
  }
}