TEKTELIC Communications Comfort Technical Reference Manual

Hide thumbs Also See for Comfort:
Table of Contents

Advertisement

Quick Links

Comfort/Vivid
Technical Reference Manual
D
T
:
OCUMENT
YPE
D
N
:
OCUMENT
UMBER
D
V
:
OCUMENT
ERSION
D
S
:
OCUMENT
TATUS
P
N
:
RODUCT
AME
P
V
& T-C
RODUCT
ARIANTS
(M
-L
):
ODULE
EVEL
FW V
:
ERSION
R
D
:
ELEASE
ATE
PROPRIETARY:
The information contained in this document is the property of TEKTELIC Communications Inc. Except as specifically authorized in
writing by TEKTELIC, the holder of this document shall keep all information contained herein confidential, and shall protect the same
in whole or in part from disclosure to all third parties.
© 2022 TEKTELIC Communications Inc., all rights reserved.
All products, names, and services are trademarks and registered trademarks of their respective companies.
Technical Reference Manual
T0006338_TRM
3.1
Released
Comfort/Vivid
T0006115 (Comfort Module) Rev D
ODES
T0006116 (Vivid Module) Rev D
3.0.12
December 5, 2022

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Comfort and is the answer not in the manual?

Questions and answers

Summary of Contents for TEKTELIC Communications Comfort

  • Page 1 ELEASE PROPRIETARY: The information contained in this document is the property of TEKTELIC Communications Inc. Except as specifically authorized in writing by TEKTELIC, the holder of this document shall keep all information contained herein confidential, and shall protect the same in whole or in part from disclosure to all third parties.
  • Page 2: Revision History

    Added register 0x11 Sync Word bit o Corrected Acceleration Event Debounce Time description o Explained limits on the Sample Periods • Minor edits (Table 2-1) Oct 16, 2019 Reza Nikjah Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 2 of 48...
  • Page 3 • Replaced CIC filter with a simple IIR filtering that only has a single recall factor parameter. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential...
  • Page 4 Nov. 7, 2022 • FW v3.0.10 document revision history. • Updated product names from Smart Room Sensor Base and PIR to Comfort and Vivid, respectively. • Reformatted document structure based on LoRaWAN information streams and ports rather than by UL/DL.
  • Page 5 Updated downlink configuration examples. • Removed invalid value limit on bits 4-5 of register 0x32. • Added a footnote about the accelerometer event- based reporting exception in the anti-bricking strategy. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 5 of 48...
  • Page 6: Table Of Contents

    Light Sensing Configuration ......................40 4.2.8 Motion Transducer Configuration ....................42 4.2.9 Response to DL Commands Configuration ..................45 4.2.10 Command and Control ........................45 References ................................48 Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 6 of 48...
  • Page 7: List Of Tables

    List of Tables Table 1-1: Comfort/Vivid Order Codes for Region Specific Variants ..............9 Table 1-2: Comfort/Vivid Information Streams ....................10 Table 2-1: UL Frame Payload Values for System Diagnostic Information ............11 Table 2-2: DL Frame Payload Format for System Diagnostic Queries ..............13 Table 3-1: UL Frame Payload Values for Transducer Data ..................
  • Page 8: Acronyms And Glossary

    RO ........... read-only R/W ........read/write Rx ........... receiver sec .......... second(s) Sensor ........Comfort/Vivid transducer ......sensing element on the Sensor (e.g. PIR or temperature transducers) TRM ........technical reference manual (this document) Tx ..........transmitter UL ........... uplink WO .........
  • Page 9: Overview

    The Comfort/Vivid are both multi-purpose LoRaWAN IoT sensors packed into a very small form factor. The Comfort and Vivid are both variants in the same sensor family, which differ in some of their sensing features. Comfort/Vivid sensors are ideal for monitoring and reporting temperature, (ambient, remote through a probe, or MCU), humidity, light, shock, and open/closed doors and windows in a home/office environment.
  • Page 10: Information Streams

    RU864 Vivid T0006116 T0008169 SMTPBRU864 1.1 Information Streams The main LoRaWAN UL and DL information streams supported by the Sensor are summarized in Table 1-2. Table 1-2: Comfort/Vivid Information Streams Stream Sent on Stream Name Data Type Direction LoRaWAN Port...
  • Page 11: System Diagnostics Stream

    • Bits 24-31: Power loss reset watchdog_reset_count: counter • Bits 16-23: Independent <value>, (unsigned/no unit) watchdog reset counter • Bits 8-15: DL command dl_reset_count: <value>, reset counter (unsigned/no unit) Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 11 of 48...
  • Page 12: Sensor Reset Diagnostics

    1. The Sensor will send an uplink containing the Sensor Reset Diagnostics in the following situations: Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 13: Downlink System Diagnostic Query Commands

    Sensor Reset Diagnostics Examples: • Determine how many times the Sensor has been reset: o DL payload: { 0x 40 } ▪ Send query code 0x40 to query the Sensor Reset Diagnostics Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential...
  • Page 14: Reported Transducer Data Stream

    0x0C 0x00 Digital impact_alarm: <value> Alarm (unsigned/no unit) inactive • 0xFF = Impact alarm active • 1 milli-��/LSB (unsigned) Acceleration 0x05 0x02 Analog impact_magnitude: <value> Magnitude (unsigned/g) Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 14 of 48...
  • Page 15 <value> • 0xFF = Bright Light State (unsigned/no unit) Voltage value, to be converted to temperature for a remote temperature probe using a conversion table or formula. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 15 of 48...
  • Page 16 0x ���� ���� ( Hall Effect State ) = 0x FF = Magnet absent “ULn” represents the UL with associated FCount (frame counter) number n (e.g., UL0 has FCount 0, UL1 has FCount 1, etc.). Applicable to sensors programmed with FW versions 3.0.12 and above. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 17 0x ���� ���� ( Digital Input State ) = 0x 00 = Connector short- ̵ c ircuited • 0x 0D 04 00 02 o 0x ���� ���� ( Motion Event Count ) = 0x 00 02 = 2 motion events Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 18: Sensor Application Configuration Stream

    UL frame. Users now have the option to select the desired response format through the configuration register detailed in Section 4.2.9. This option has been included to accommodate applications designed for previous iterations of TEKTELIC Sensors that can decode the CRC. However, it is strongly Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 19: Downlink Configuration And Control Commands

    • LoRaMAC Configuration • Periodic Tx Configuration • Hall Effect Configuration • External Connector Configuration • Accelerometer Configuration • Temperature/RH/Analog Input Threshold Configuration • Light Sensing Configuration Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 19 of 48...
  • Page 20: Loramac Configuration

    • Bits 0-7: DR for Rx2 dr_number: <value> (unsigned/no unit) Tx power number m translates to the maximum Tx power, which is a function of the LoRaWAN RF region, minus 2 × �� dB. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 21: Default Configuration

    866550000 KR920 921900000 In the LoRaMAC regions where there is no duty cycle limitation, such as US915, the “enabled duty cycle” configuration of the Sensor is ignored. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 21 of 48...
  • Page 22: Periodic Tx Configuration

    • 0 disables periodic hall effect transducer reports • Ticks between ambient light reports 0x25 Ticks per tick_per_light: <value> • 0 disables periodic ambient light Ambient Light (unsigned/no unit) reports Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 22 of 48...
  • Page 23: Table 4-6: Default Values Of Periodic Transmission Configuration Registers

    Table 4-6: Default Values of Periodic Transmission Configuration Registers Seconds per Core tick 3600 (1 hour) Ticks per Battery 1 (thus 1-hour period) Ticks per Ambient Temperature 1 (thus 1-hour period) Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 23 of 48...
  • Page 24 Since the Sensor can be configured to simultaneously disable both acceleration magnitude and vector reporting for accelerometer events (via downlink configuration register 0x32), the anti-bricking strategy can apply even if event-based accelerometer reporting is enabled. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 25: Hall Effect Configuration

    This assumes that the response format is set to the default method (i.e., invalid-write response format). If the CRC method is selected, the Sensor will respond with the 4-byte CRC in response to the configuration command as per normal. Comfort/Vivid TRM T0006338_TRM Version 3.1...
  • Page 26: Application Example

    Table 4-8: Default Values of Hall Effect Configuration Registers Mode Rising and falling edges enabled Threshold 1 (one) Report Options State and count reported Input pulse frequency must be less than 5 Hz. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 26 of 48...
  • Page 27: External Connector Configuration

    The Sensor features an external connector that allows users to connect an analog or digital external sensing probe. Only the Comfort model is equipped with an external connector. This connector can be configured as either a digital input (having only two values or states of “open” and “closed”), or analog input. The input mode (digital or analog) is determined by bit 7 of register 0x2D (see Table 4-9).
  • Page 28: Table 4-9: External Connector Configuration Registers

    1: Report Total Digital Input count • Bits 2-3, 5-7: Ignored • Counter value (1/LSB) 0x5A Reset Total external_connector_reset_count: <value> • Acceptable values: 0, 1, …, (WO) Count (unsigned/no unit) 4,294,967,295 Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 28 of 48...
  • Page 29 Bit 0 (Digital Input state) controls whether the transmission contains the current Digital Input state of the switch (i.e., 0xFF for open or 0x00 for closed). Bit 1 (Digital Input count) controls whether the transmission Input pulse frequency must be less than 3 Hz. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 30: Table 4-10: Default Values Of External Connector Configuration Registers

    DL payload: { 0x AD 02 } ▪ Register 0x2D with write bit set to true ▪ “Rising edge” disabled, “Falling edge” enabled • Read current value of Count Threshold: o DL payload: { 0x 2E } Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential...
  • Page 31: Accelerometer Configuration

    Acceleration events are reported with the acceleration magnitude, acceleration vector, or both. Here “impact” generally refers to a Sensor motion event (i.e., not necessarily an impact to the Sensor). Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 32: Table 4-11: Accelerometer Configuration Registers

    If the impact alarm event threshold is enabled (register 0x34, bit 0), an impact alarm is always raised (reported) when the impact alarm event threshold (register 0x30) is exceeded, and is cleared after an impact alarm event grace period (register 0x36) elapses without any impact alarm events (see Section 4.2.5.7). Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 33 Note that if a threshold configured in register 0x30 or register 0x31 is equal to or greater than the configured measurement full scale (2 g, 4 g, 8 g, 16 g), then the corresponding event (impact alarm or acceleration event) will never be triggered. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 34 Event Debounce Time, after an acceleration event is registered. This is to prevent a single acceleration event from being transmitted as multiple events. The minimum debounce time is 1 (one) sec. A value 0 (zero) is invalid and ignored. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 35: Table 4-12: Typical Current Draws At 3.0 V For Different Accelerometer Sample Rates

    This feature is to allow customers to filter out short impact events, while still allowing longer impact events to be reported. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 36: Temperature/Rh/Analog Input Threshold Configuration

    • Ambient RH: Measured by the Temperature/RH transducer • MCU Temperature: Measured by the MCU (with lower accuracy compared to the Ambient Temperature) • Analog Input Voltage: When the External Connector is in the Analog Input mode (Comfort model only). Comfort/Vivid TRM T0006338_TRM Version 3.1...
  • Page 37: Table 4-14: Temperature/Rh/Analog Input Threshold Configuration Registers

    Note that the threshold window here is defined as the open interval “(Low Threshold, High Threshold)”, not e.g. the closed interval “[Low Threshold, High Threshold]”; i.e. even if the transducer value is equal to Low Threshold or High Threshold, the Sensor is considered to have left the threshold window. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 38 • High threshold ≤ Low threshold: Invalid low: <value> (unsigned/V) and ignored • Bit 0: 0/1 = Thresholds disabled/enabled 0x4A Analog Input analog_input_threshold_ena • Bits 1-7: Ignored Thresholds Enabled bled: <value> (unsigned/no unit) Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 38 of 48...
  • Page 39: Table 4-15: Default Values Of Threshold Configuration Registers

    Ambient Temperature Threshold: High 30°C Ambient Temperature Threshold: Low 15°C Ambient Temperature Thresholds Enabled Disabled Ambient RH Threshold: High Ambient RH Threshold: Low Ambient RH Thresholds Enabled Disabled Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 39 of 48...
  • Page 40: Light Sensing Configuration

    4.2.7 Light Sensing Configuration The light transducer on the Comfort/Vivid allows for the detection of the presence or absence of light based on the built-in light sensing transducer. The sensing element light pipe is visible on the top surface of the Sensor’s enclosure.
  • Page 41: Sample Period

    63 to the brightest threshold. When first enabled, the Sensor begins in the “dark” state. Bit 7 of the Threshold is used to enable or disable the threshold-based reporting. If the threshold-based reporting is enabled, the Sensor transmits whenever the threshold is crossed (i.e. when the current and Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 42: Motion Transducer Configuration

    Note: The PIR transducer is designed to detect motion so if a room is occupied but the occupants are not moving, the sensor may report “No Motion” after the Grace Period (see Section 4.2.8.1) expires. Table 4-18 shows a list of motion transducer configuration registers. All the registers have R/W access. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 43: Table 4-18: Motion Transducer Configuration Registers

    4.2.8.1 Grace Period The Grace Period determines how long the Sensor waits before the previously reported PIR motion event is considered clear. For example, a Grace Period of 5 (five) min results in the sensor transmitting “Motion Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.
  • Page 44: Table 4-19: Default Values Of Motion Transducer Configuration Registers

    4.2.8.6 Default Configuration Table 4-19 shows the default values for the motion transducer configuration registers. Table 4-19: Default Values of Motion Transducer Configuration Registers Grace Period 300 sec (5 min) Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 44 of 48...
  • Page 45: Table 4-24: Default Value Of Response To Dl Commands Configuration Register

    4.2.9 Response to DL Commands Configuration The Comfort and Vivid include the ability for the user to select the format of UL responses to DL commands. Details on the response formats can be found in Section 4.1. Table 4-20 shows the response to DL commands register.
  • Page 46 Registers to Factory Configs • Any other value: Invalid and Defaults ignored After sending the reset-to-factory-defaults command, the Sensor is automatically reset with corresponding default configuration values. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential Page 46 of 48...
  • Page 47: Table 4-26: Loramac Regions And Region Numbers [1]

    • Reboot Device o DL payload: { 0x F0 00 01 } • Get FW version, and reset App Config to factory defaults o DL payload: { 0x 71 F2 0A} Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc. Confidential...
  • Page 48: References

    References [1] LoRa Alliance, "LoRaWAN Regional Parameters," ver 1.0.2, Rev B, Feb 2017. [2] LoRa Alliance, "LoRaWAN Specification," ver. 1.0.2, Jul 2016. [3] TEKTELIC Communications Inc., "Smart Room Sensor User Guide," ver 1.5, Jan 2020. Comfort/Vivid TRM T0006338_TRM Version 3.1 TEKTELIC Communications Inc.

This manual is also suitable for:

VividT0006118

Table of Contents