Device Configuration Commands

How to configure Haltian ENTRYWAY — Service API commands and GraphQL examples

Overview

Haltian ENTRYWAY 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	—
`SetPeopleCountingOrientation`	Set entry/exit counting direction	`peopleCountingOrientation`
`GetPeopleCountingOrientation`	Read current direction	—

SetReportAndMeasurementInterval

Configures how frequently the sensor reports data and how often it takes measurements.

Parameters:

Parameter	Type	Range	Default	Description
`reportInterval`	Integer	60–86400	3600	How often the sensor sends a report to the cloud (seconds)
`measurementInterval`	Integer	30–86400	30	How often the sensor checks for movement (seconds)

Set 5-minute reporting with 30-second measurement:

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

Replace these example values

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

GetReportAndMeasurementInterval

Reads the current reporting and measurement intervals from the device.

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

SetPeopleCountingOrientation

Sets the entry/exit counting direction. Use this if counts appear inverted after installation — no need to physically rotate the sensor.

Parameters:

Parameter	Type	Values	Default	Description
`peopleCountingOrientation`	Integer	0, 1	0	`0` = normal (factory default), `1` = reversed (swap entry/exit)

Reverse counting direction:

mutation {
  setPeopleCountingOrientation(
    input: {
      vendorSerial: "XXCN01TSC20205507"
      peopleCountingOrientation: 1
    }
  ) {
    success
  }
}

Replace these example values

XXCN01TSC20205507 — your device vendor serial number
1 — counting direction (0 = normal, 1 = reversed)

GetPeopleCountingOrientation

Reads the current counting direction.

query {
  getPeopleCountingOrientation(
    vendorSerial: "XXCN01TSC20205507"
  ) {
    peopleCountingOrientation
  }
}

Quick Configuration Recipes

High-Frequency Monitoring

10-minute reporting with 30-second measurement for busy entrances:

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

Low-Power Long Interval

1-hour reporting for low-traffic areas (maximizes battery life):

mutation {
  setReportAndMeasurementInterval(
    input: {
      vendorSerial: "XXCN01TSC20205507"
      reportInterval: 3600
      measurementInterval: 30
    }
  ) {
    success
  }
}

Fix Inverted Counts

If entry and exit counts are swapped after installation:

mutation {
  setPeopleCountingOrientation(
    input: {
      vendorSerial: "XXCN01TSC20205507"
      peopleCountingOrientation: 1
    }
  ) {
    success
  }
}