TEKTELIC Communications Kona Technical Reference Manual

Home sensor
Hide thumbs Also See for Kona:
Table of Contents

Advertisement

TEKTELIC C
Kona Home Sensor
Technical Reference Manual
Document Type: Technical Reference Manual
Document Number: T0005370_TRM
Document Version: Rev-C 1.0
Product Name: Kona All-in-One Home Sensor
Product Codes:
†Not applicable to module revisions above Rev C.
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.
© 2018 TEKTELIC Communications Inc., all rights reserved.
All products, names, and services are trademarks and registered trademarks of their respective companies.
DISCLAIMER:
Material contained in this document is subject to change without notice. The material herein is solely for
information purposes and does not represent a commitment by TEKTELIC or its representatives. TEKTELIC has
prepared the information contained in this document solely for use by its employees, agents, and customers.
Dissemination of this information and/or concepts to other parties is prohibited without the prior written consent
of TEKTELIC. In no event will TEKTELIC be liable for any incidental or consequential damage in connection with the
furnishing, performance or use of this material.
TEKTELIC reserves the right to revise this publication in accordance with formal change control procedures defined
by TEKTELIC.
TEKTELIC Communications Inc.
th
7657 10
Street NE
Calgary, AB, Canada T2E 8X2
Phone: (403) 338-6900
OMMUNICATIONS
T0004893
, T0004885
T0004896
, T0004897
I
.
NC
, T0004886
, T0004895
,

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for TEKTELIC Communications Kona

  • Page 1 †Not applicable to module revisions above Rev C. 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 Added some explanations and clarifications. This version of the document is now only applicable to Rev-C 1.0 Aug 23, 2018 R. Nikjah Kona Home Sensor modules up to and including Rev Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 3: Table Of Contents

    3.4.6 Motion Transducer Configuration ................28 3.4.7 Moisture Configuration................... 31 Sensor Command and Control ..................33 3.5.1 Command Examples ....................33 References ............................ 34 Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc. Confidential Page 3 of 34...
  • Page 4: List Of Tables

    List of Tables Table 2-1: Kona All-in-One Home Sensor Module Models ............8 Table 2-1: Home Sensor Payload Frame Values ................10 Table 3-1: LoRaWAN Commissioning Registers ................13 Table 3-2: LoRaWAN MAC Configuration Registers ..............14 Table 3-3: Periodic Transmission Configuration Registers ............15 Table 3-4: Default Values of Periodic Transmission Configuration Registers ......
  • Page 5: List Of Figures

    List of Figures Figure 2-1: The frame format in an UL payload................10 Figure 3-1: Format of a DL message.................... 12 Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc. Confidential Page 5 of 34...
  • Page 6: Acronyms And Glossary

    Flash memory ..... Non-volatile memory located on the Home Sensor, which contains application and configuration settings. �� ......... gravity (unit of acceleration ≈ 9.8 m/s Home Sensor ....Any one of the Kona All-In-One Home Sensor Module types ID ........ identity IoT ......Internet of things LoRa ......
  • Page 7 ....The sensing element attached to the Home Sensor, e.g. PIR transducer, humidity transducer. TRM ......technical reference manual Tx ........ transmitter UL ....... uplink Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc. Confidential Page 7 of 34...
  • Page 8: Overview

    Network Server and its command interfaces. The Kona All-in-One Home Sensor is a multi-purpose LoRaWAN IoT sensor packed into a very small form factor. The Home Sensor is ideal for monitoring and reporting temperature, humidity, light, shock, and open/closed doors and windows in the home environment.
  • Page 9 Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc. Confidential Page 9 of 34...
  • Page 10: Ul Data Format

    0x00: Dry 0xFF: Wet Motion Detected 0x0A 0x00 Digital 0x00: No motion (PIR) 0xFF: Motion detected MCU Temperature 0x0B 0x67 Temperature 0.1°C / LSB (signed) Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc. Confidential Page 10 of 34...
  • Page 11: Example Ul Payloads

    0x 0D 04 00 02 06 00 FF o 0x ���� ���� ( Motion Event Count ) = 0x 00 02 = 2 motion events o 0x ���� ���� ( Break­in ) = 0x FF = break-in detected Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 12: Dl Command Format

    CRC32 of the entire DL payload as the first 4 bytes of the UL frame. Note: Undefined bits/addresses are RFU and must be set to 0 (zero) when performing any write operation. Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 13: Lorawan Commissioning

    Note 2: Registers 0x02, 0x04, and 0x05 may not be able to be read back in some regions if the DR is too low. For example, in the NA region, the maximum payload size with DR0 is 11 bytes. Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0...
  • Page 14: Lorawan Mac Configuration

    • Set default DR number to 15, default Tx Power number to 15, Rx2 DL channel number to 4, and Rx2 DR number to 2: o DL payload: { 0x 92 0F 0F 93 04 02 } Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 15: Sensor Application Configuration

    Temp Tx 0 disables periodic MCU Temp reports. 0x28 Ticks per PIR Tx Ticks between PIR reports. A value of 0 disables periodic PIR reports. Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc. Confidential Page 15 of 34...
  • Page 16: Table 3-4: Default Values Of Periodic Transmission Configuration Registers

    DL payload: { 0x A2 00 01 A3 00 02 } ▪ Reg 22 and Reg 23 with their write bits set to true ▪ Temperature Ticks set to 1 (one) Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 17: Digital Input Configuration

    Mode to 0x00 (i.e. to disable both rising and falling edges) is ignored by the Sensor. Application Examples: • Door Open/Close detection would use both rising and falling triggers to detect when the door was opened and when it was closed. Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 18: Table 3-7: Default Values Of Digital Input Configuration Registers

    • Have Digital Input be triggered only on rising edges: o DL payload: { 0x AA 01 } ▪ Reg 2A with write bit set to true ▪ “Rising Edge” enabled, “Falling Edge” disabled Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 19 Digital Input is triggered: o DL payload: { 0x AB 00 00 AC 02 } ▪ Count Threshold set to 0 (zero) ▪ Value to Tx set to ‘Counter Value’ Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 20: Accelerometer Configuration

    The timeout period is defined via Impact Debounce Time (see Section 3.4.3.4). Within the timeout period, if the ��-threshold is tripped at least 4 times, a break-in alarm is raised. Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 21: Table 3-9: Default Values Of Accelerometer Configuration Registers

    �������� milli-�� Break-In Threshold 6000 milli-�� Impact Threshold Value to Transmit Full-Precision Impact Debounce Time 2 (two) seconds Mode Break-In Threshold Disabled, Impact Threshold Disabled, Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc. Confidential Page 21 of 34...
  • Page 22 ‘Magnitude’ as the Value to Transmit: o DL payload: { 0x B4 82 B2 02 } ▪ Reg 34 and Reg 32 with their write bits set to true Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 23: Temperature/Rh Threshold Configuration

    Bit 0: 0 = Disabled, 1 = Enabled Enabled Other bits are ignored. 0x40 MCU Temp Sample Sample period of MCU temperature Period: Idle transducer: Idle state (seconds) Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc. Confidential Page 23 of 34...
  • Page 24 The <transducer> Thresholds Enabled register enables and disables the threshold reporting on the specified transducer. Thresholds and Sample Period values can be configured but are not activated unless the Thresholds Enabled bit is set. Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 25: Table 3-11: Default Values Of Temperature/Rh Threshold Configuration Registers

    ▪ Reg 3D and Reg 3E with their write bits set to true ▪ High RH thresholds set to 60% RH ▪ Low RH threshold set to 20% RH ▪ RH thresholds enabled Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 26: Light Sensing Configuration

    The Light Threshold is used to set the dark/bright transition point for the Sensor. The Home Sensor only transmits when the threshold is crossed, and when first enabled, begins in the ‘dark’ state. A threshold setting of 1 (one) corresponds to the darkest threshold. Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 27: Table 3-13: Default Values Of Light Transducer Configuration Registers

    In the following example payloads, the Command Field is boldfaced: • Set the Threshold to 32 and check the light condition every half an hour: o DL payload: { 0x C8 20 C7 00 00 07 08 } Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 28: Motion Transducer Configuration

    0x53 Mode Bit 0: Motion Event Count to Tx Bit 1: Motion State to Tx Bit 7: PIR Sensor Enabled/Disabled Other bits are ignored. Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc. Confidential Page 28 of 34...
  • Page 29: Table 3-15: Default Values Of Motion Transducer Configuration Registers

    Table 3-15: Default Values of Motion Transducer Configuration Registers Grace Period 300 seconds (5 minutes) Threshold Threshold Period 15 seconds Mode 0x81 (Event Count Enabled, State Disabled, Motion Enabled) Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc. Confidential Page 29 of 34...
  • Page 30 • Read the Grace Period, and set the transducer such that the Sensor reports both State and Event Count in periodic transmissions o DL payload: { 0x 50 D3 83 } Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 31: Moisture Configuration

    The Threshold of the Moisture transducer determines the tripping point for various conditions. Nominally, a 1/4” of water below the Home Sensor results in a shift of about 300 units from the Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 32: Table 3-17: Default Values Of Moisture Transducer Configuration Registers

    • Set the Sample Period to 64 seconds and read the Threshold o DL payload: { 0x DA 03 5B } • Force the transducer to calibrate as being dry o DL payload: { 0x DD 01 } Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 33: Sensor Command And Control

    • Write Application and LoRa Configurations to Flash o DL payload: { 0x F0 60 00 } • Reboot Device o DL payload: { 0x F0 00 01 } Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0 TEKTELIC Communications Inc.
  • Page 34: References

    References [1] LoRa Alliance, "LoRaWAN Specification," ver. 1.0.3, Mar 2018. [2] TEKTELIC Communications Inc., "Kona Home Sensor Uplink and Downlink Payload Formation," ver 0.1, Jun 2018. [3] LoRa Alliance, "LoRaWAN 1.1 Regional Parameters," ver. 1.1, rev. B, Jan 2018. Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0...

Table of Contents