Sensor Telemetry Trigger

Description

Sensor Telemetry Triggers enable automation based on sensor tag telemetry data such as:

• Battery Level: Low battery alerts

• Temperature: Temperature threshold monitoring

• Humidity: Humidity level monitoring

• Button Clicks: Button press events

Supported Sensors:

• Minew sensors (MSP01, etc.)

• EnOcean sensors

• Other BLE telemetry-enabled devices

Use Cases:

• Trigger HTTP requests to external systems (facility management, ticketing)

• Send alerts when conditions are met (temperature too high, battery low)

• Integrate with building automation systems

• Monitor environmental conditions

When to Use

• Customer wants to monitor environmental conditions (temperature, humidity)

• Facility needs battery level monitoring for sensors

• Organization wants to integrate with facility management systems

• Customer needs automated responses to sensor data

Dependencies & Requirements

• BLE Gateway: Compatible BLE gateway (check BLE Gateway Compatibility Matrix)

• Sensor Tags: Telemetry-enabled BLE sensors

• Sensor Registration: Sensors must be registered as Beacons

• Telemetry Data: Sensors must send telemetry data via BLE gateway

Configuration Steps

Step 1: Install and Register Sensor

1. Physical Installation: Install sensor tag at desired location

2. Register Beacon:

   • Navigate to Beacons > Add New Beacon

   • Enter sensor MAC address

   • Enter sensor name

   • Set Device Model: Select appropriate model (Minew, EnOcean, etc.)

3. Set Location:

   • Location: Select location

   • Building: Select building

   • Floor: Select floor

   • X Coordinate: Enter X coordinate

   • Y Coordinate: Enter Y coordinate

4. Save the beacon

Step 2: Configure BLE Gateway

1. Ensure BLE gateway is compatible with sensor type

2. Configure gateway to receive telemetry data

3. Verify gateway can communicate with Starling platform

Step 3: Create Sensor Telemetry Automation

1. Navigate to Workflow > Automations

2. Click "Create New Automation"

3. Configure Trigger:

   • Select trigger: "Sensor Data"

4. Configure Conditions:

   • Temperature:

     • Operator: Select (>, <, =, >=, <=)

     • Value: Enter threshold (e.g., > 30 for "greater than 30°C")

   • Humidity:

     • Operator: Select (>, <, =, >=, <=)

     • Value: Enter threshold (e.g., < 20 for "less than 20%")

   • Battery Level:

     • Operator: Select (>, <, =, >=, <=)

     • Value: Enter threshold (e.g., < 20 for "less than 20%")

   • Note: Leave condition empty if you don't want to filter by that parameter

5. Add Actions:

   • HTTP Request:

     • Enter external API URL

     • Configure request method (POST, GET, etc.)

     • Include sensor data in payload:

       • Use placeholder: [[temperature]] for temperature value

       • Use placeholder: [[humidity]] for humidity value

       • Use placeholder: [[batteryLevel]] for battery level

       • Use placeholder: [[button]] for button name (if button press)

   • Send Email/SMS:

     • Alert facility manager

     • Include sensor data in message using placeholders

   • Webhook:

     • Trigger external system

     • Include sensor data in webhook payload

6. Save the automation

Available Placeholders

When configuring actions, you can use these placeholders in messages/payloads:

• [[temperature]] - Current temperature value

• [[humidity]] - Current humidity percentage

• [[batteryLevel]] - Battery level percentage

• [[button]] - Button name (if button press event)

• [[pressType]] - Press type (single, double, long)

Troubleshooting

Issue: Sensor data not received

• Check: Sensor is registered as Beacon with correct MAC address

• Check: BLE gateway is receiving sensor data

• Check: Gateway is compatible with sensor type

• Check: Sensor is within gateway range

Issue: Automation not triggering

• Check: Conditions are configured correctly

• Check: Sensor data matches condition thresholds

• Check: Automation is enabled

• Check: Trigger is set to "Sensor Data"

Issue: Placeholders not working

• Check: Placeholder syntax is correct: [[temperature]] (double brackets)

• Check: Sensor is sending that type of data

• Check: Placeholder name matches available placeholders

Use Cases

1. Environmental Monitoring: Alert when room temperature exceeds 30°C

2. Battery Management: Notify when sensor batteries are low (< 20%)

3. Facility Maintenance: Create work orders when humidity is too low

4. Button Actions: Trigger workflows on button press (porter service, etc.)