Device Configuration Commands

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

Overview

Thingsee ENVIRONMENT 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, tuning guidance, and configuration scenarios, see Configuration.

Identifying Your Device

The exact command names depend on your device model. Check the serial number prefix on your device:

Serial prefixModelCommands used
TSEN01Thingsee ENVIRONMENTSetReportInterval, SetDeviceConfiguration
TSEN04Thingsee ENVIRONMENTSetReportAndMeasurementInterval, individual mode commands

Available Commands

CommandTSEN01TSEN04Purpose
SetReportInterval✓—Set reporting frequency
GetReportInterval✓—Read current report interval
SetReportAndMeasurementInterval—✓Set reporting and measurement frequencies
GetReportAndMeasurementInterval—✓Read current intervals
SetDeviceConfiguration✓—Configure all sensor modes at once
GetDeviceConfiguration✓—Read current sensor configuration
SetAccelerometerMode—✓Configure accelerometer behavior
GetAccelerometerMode—✓Read current accelerometer mode
SetMagnetoSwitchMode—✓Configure hall sensor behavior
GetMagnetoSwitchMode—✓Read current hall sensor mode
SetWeatherMode—✓Enable/disable weather sensors
GetWeatherMode—✓Read current weather mode
ActivateDeepSleepMode—Rugged onlyPut device into deep sleep

Reporting Intervals

Controls how often the sensor takes measurements and sends data to the cloud.

TSEN01 Devices

ParameterTypeRangeDefaultDescription
reportIntervalInteger60–8640060Reporting interval in seconds
mutation {
  setReportInterval(
    input: {
      vendorSerial: "TSEN01-xxxxxxxx"
      reportInterval: 300
    }
  ) {
    success
  }
}

query {
  getReportInterval(
    vendorSerial: "TSEN01-xxxxxxxx"
  ) {
    reportInterval
  }
}

TSEN04 Devices

ParameterTypeRangeDefaultDescription
reportIntervalInteger600–864003600Cloud reporting interval in seconds
measurementIntervalInteger10–86400300Sensor sampling interval in seconds

The measurement interval controls how often the sensor takes readings; the report interval controls how often it sends data to the cloud.

mutation {
  setReportAndMeasurementInterval(
    input: {
      vendorSerial: "TSEN04-xxxxxxxx"
      reportInterval: 3600
      measurementInterval: 300
    }
  ) {
    success
  }
}

query {
  getReportAndMeasurementInterval(
    vendorSerial: "TSEN04-xxxxxxxx"
  ) {
    reportInterval
    measurementInterval
  }
}

Accelerometer Mode

Controls accelerometer behavior — orientation reporting or machine vibration monitoring.

Accelerometer modes:

ValueModeDescription
-1DisabledAccelerometer off (TSEN01 only)
0Disabled / OrientationOff on TSEN04, orientation on TSEN01
1Orientation / Machine monitoringOrientation on TSEN04, machine monitoring on TSEN01
2Machine monitoringReports vibration histogram

TSEN01 Devices

On TSEN01, the accelerometer mode is set together with other sensor modes via SetDeviceConfiguration. See All Sensor Modes (TSEN01) for the full command.

ValueModeDescription
-1DisabledAccelerometer off
0OrientationReports 3D orientation
1Machine monitoringReports vibration histogram
2Event-based machine monitoringReports only when activity is detected

TSEN04 Devices

ValueModeDescription
0DisabledAccelerometer off
1OrientationReports 3D orientation
2Machine monitoringReports vibration histogram
mutation {
  setAccelerometerMode(
    input: {
      vendorSerial: "TSEN04-xxxxxxxx"
      accelerometerMode: 2
    }
  ) {
    success
  }
}

query {
  getAccelerometerMode(
    vendorSerial: "TSEN04-xxxxxxxx"
  ) {
    accelerometerMode
  }
}

Magneto Switch (Hall Sensor)

Controls the magnetic/hall sensor used for door and window open/close detection.

TSEN01 Devices

On TSEN01, the hall mode is set together with other sensor modes via SetDeviceConfiguration. See All Sensor Modes (TSEN01) for the full command.

ValueModeDescription
-1DisabledHall sensor reporting off
0IntervalReport at every report interval
1Change onlyReport only on state changes

TSEN04 Devices

ValueModeDescription
0DisabledHall sensor reporting off
1EnabledReport magnetic/hall information at report interval rate
mutation {
  setMagnetoSwitchMode(
    input: {
      vendorSerial: "TSEN04-xxxxxxxx"
      hallMode: 1
    }
  ) {
    success
  }
}

query {
  getMagnetoSwitchMode(
    vendorSerial: "TSEN04-xxxxxxxx"
  ) {
    hallMode
  }
}

Weather Mode

Enables or disables weather sensors (temperature, humidity, pressure, light).

TSEN01 Devices

On TSEN01, the weather mode is set together with other sensor modes via SetDeviceConfiguration. See All Sensor Modes (TSEN01) for the full command.

ValueModeDescription
-1DisabledWeather sensors off
0EnabledReport temperature, humidity, pressure, light

TSEN04 Devices

ValueModeDescription
0DisabledWeather sensors off
1EnabledReport temperature, humidity, pressure, light
mutation {
  setWeatherMode(
    input: {
      vendorSerial: "TSEN04-xxxxxxxx"
      weatherMode: 1
    }
  ) {
    success
  }
}

query {
  getWeatherMode(
    vendorSerial: "TSEN04-xxxxxxxx"
  ) {
    weatherMode
  }
}

All Sensor Modes (TSEN01)

On TSEN01 devices, all sensor modes are configured with a single command. You must specify all three parameters together.

Parameters:

ParameterTypeValuesDefaultDescription
accelerometerModeInteger-1, 0, 1, 20Accelerometer behavior
hallModeInteger-1, 0, 10Magneto switch reporting mode
weatherModeInteger-1, 00Weather sensor enable/disable
mutation {
  setDeviceConfiguration(
    input: {
      vendorSerial: "TSEN01-xxxxxxxx"
      accelerometerMode: 0
      hallMode: 1
      weatherMode: 0
    }
  ) {
    success
  }
}

query {
  getDeviceConfiguration(
    vendorSerial: "TSEN01-xxxxxxxx"
  ) {
    accelerometerMode
    hallMode
    weatherMode
  }
}

Deep Sleep Mode (Rugged only)

Puts the device into deep sleep mode. In deep sleep, the device stops all measurements and radio communication to preserve battery. Only available on Thingsee ENVIRONMENT Rugged devices.

Parameters:

ParameterTypeValuesDefaultDescription
deepSleepModeInteger0, 110 = disable deep sleep, 1 = enable deep sleep
mutation {
  activateDeepSleepMode(
    input: {
      vendorSerial: "TSEN04R-xxxxxxxx"
      deepSleepMode: 1
    }
  ) {
    success
  }
}

Quick Configuration Recipes

Climate Monitoring

Standard environmental monitoring — weather sensors enabled, other sensors off.

TSEN01:

mutation {
  setReportInterval(
    input: {
      vendorSerial: "TSEN01-xxxxxxxx"
      reportInterval: 300
    }
  ) {
    success
  }
}

mutation {
  setDeviceConfiguration(
    input: {
      vendorSerial: "TSEN01-xxxxxxxx"
      accelerometerMode: -1
      hallMode: -1
      weatherMode: 0
    }
  ) {
    success
  }
}

TSEN04:

mutation {
  setReportAndMeasurementInterval(
    input: {
      vendorSerial: "TSEN04-xxxxxxxx"
      reportInterval: 3600
      measurementInterval: 300
    }
  ) {
    success
  }
}

mutation {
  setWeatherMode(
    input: {
      vendorSerial: "TSEN04-xxxxxxxx"
      weatherMode: 1
    }
  ) {
    success
  }
}

Door/Window Monitoring

Report magneto switch state changes with weather reporting:

TSEN01:

mutation {
  setDeviceConfiguration(
    input: {
      vendorSerial: "TSEN01-xxxxxxxx"
      accelerometerMode: -1
      hallMode: 1
      weatherMode: 0
    }
  ) {
    success
  }
}

TSEN04:

mutation {
  setMagnetoSwitchMode(
    input: {
      vendorSerial: "TSEN04-xxxxxxxx"
      hallMode: 1
    }
  ) {
    success
  }
}

mutation {
  setWeatherMode(
    input: {
      vendorSerial: "TSEN04-xxxxxxxx"
      weatherMode: 1
    }
  ) {
    success
  }
}

Machine Usage Tracking

Monitor equipment vibration patterns:

TSEN01:

mutation {
  setDeviceConfiguration(
    input: {
      vendorSerial: "TSEN01-xxxxxxxx"
      accelerometerMode: 1
      hallMode: -1
      weatherMode: -1
    }
  ) {
    success
  }
}

TSEN04:

mutation {
  setReportAndMeasurementInterval(
    input: {
      vendorSerial: "TSEN04-xxxxxxxx"
      reportInterval: 3600
      measurementInterval: 60
    }
  ) {
    success
  }
}

mutation {
  setAccelerometerMode(
    input: {
      vendorSerial: "TSEN04-xxxxxxxx"
      accelerometerMode: 2
    }
  ) {
    success
  }
}