TEKTELIC Communications Kona Technical Reference Manual Download Page 1

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. 
7657 10

th

 Street NE 

Calgary, AB, Canada  T2E 8X2 
Phone: (403) 338-6900 

TEKTELIC

 

C

OMMUNICATIONS 

I

NC

.

 

 

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:

 

T0004893

, T0004885

, T0004886

, T0004895

T0004896

, T0004897

 

†Not applicable to 

module revisions above Rev C. 

 

 

Summary of Contents for Kona

Page 1: ...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 ...

Page 2: ...ded details of for each configuration 0 3 Apr 06 2018 D Smith Added missing uplink info 0 4 Jul 6 2018 R Nikjah Expanded on payload examples Made some editorial fixes modifications This version is in compliant with Rev B of Home Sensor PCBA Rev C 1 0 Aug 23 2018 R Nikjah Added some explanations and clarifications This version of the document is now only applicable to Kona Home Sensor modules up to...

Page 3: ...e Access 12 3 2 LoRaWAN Commissioning 13 3 3 LoRaWAN MAC Configuration 14 3 3 1 LoRa Config Examples 14 3 4 Sensor Application Configuration 15 3 4 1 Periodic Tx Configuration 15 3 4 2 Digital Input Configuration 17 3 4 3 Accelerometer Configuration 20 3 4 4 Temperature RH Threshold Configuration 23 3 4 5 Light Sensing Configuration 26 3 4 6 Motion Transducer Configuration 28 3 4 7 Moisture Config...

Page 4: ...s 17 Table 3 7 Default Values of Digital Input Configuration Registers 18 Table 3 8 Accelerometer Configuration Registers 20 Table 3 9 Default Values of Accelerometer Configuration Registers 21 Table 3 10 Temperature RH Threshold Configuration Registers 23 Table 3 11 Default Values of Temperature RH Threshold Configuration Registers 25 Table 3 12 Light Transducer Configuration Registers 26 Table 3...

Page 5: ...na Home Sensor TRM T0005370_TRM Version Rev C 1 0 TEKTELIC Communications Inc Confidential Page 5 of 34 List of Figures Figure 2 1 The frame format in an UL payload 10 Figure 3 1 Format of a DL message 12 ...

Page 6: ...the Kona All In One Home Sensor Module types ID identity IoT Internet of things LoRa a patented long range IoT technology acquired by Semtech LoRaMAC LoRaWAN MAC LoRaWAN LoRa wide area network a network protocol based on LoRa LoRaWAN Commissioning The unique device identifiers and encryption keys used for LoRaWAN communication see LoRaWAN Specification 1 for more details LSB least significant bit ...

Page 7: ...sion Rev C 1 0 TEKTELIC Communications Inc Confidential Page 7 of 34 Temp temperature transducer The sensing element attached to the Home Sensor e g PIR transducer humidity transducer TRM technical reference manual Tx transmitter UL uplink ...

Page 8: ... RF Region T0004893 Rev C Home Sensor Module NA Base US 902 928MHz ISM Band T0004885 Rev C Home Sensor Module NA PIR US 902 928MHz ISM Band T0004886 Rev C Home Sensor Module NA External Connector US 902 928MHz ISM Band T0004895 Rev C Home Sensor Module EU Base EU 863 870MHz ISM Band T0004896 Rev C Home Sensor Module EU PIR EU 863 870MHz ISM Band T0004897 Rev C Home Sensor Module EU External Connec...

Page 9: ...Kona Home Sensor TRM T0005370_TRM Version Rev C 1 0 TEKTELIC Communications Inc Confidential Page 9 of 34 parameter values toggling read write actions and enabling disabling different fields as desired ...

Page 10: ...alues Type Information Data Channel ID Data Type ID Data Size bytes Data Type Data Format Battery Voltage 0x00 0xFF 2 Analog 10 mV LSB signed Input 0x01 0x00 1 Digital 0x00 Low Connector short circuited or magnet present 0xFF High Connector open circuited or magnet absent Light Detected 0x02 0x00 1 Digital 0x00 Dark 0xFF Bright Temperature 0x03 0x67 2 Temperature 0 1 C LSB signed RH 0x04 0x68 1 RH...

Page 11: ...1 00 FF 08 04 00 05 o 0x 𝟎𝟒 𝟔𝟖 RH 0x 14 0 5 10 o 0x 𝟎𝟏 𝟎𝟎 Input 0x FF High o 0x 𝟎𝟖 𝟎𝟒 Input Count 0x 00 05 5 switch triggers 0x 04 68 2A 03 67 FF FF 00 FF 01 2C o 0x 𝟎𝟒 𝟔𝟖 RH 0x 2A 0 5 21 o 0x 𝟎𝟑 𝟔𝟕 Temperature 0x FF FF 0 1 C 0 1 C o 0x 𝟎𝟎 𝐅𝐅 Battery Voltage 0x 01 2C 0 01 V 3 00 V 0x 02 00 FF 07 71 00 3A 00 07 00 53 01 00 FF o 0x 𝟎𝟐 𝟎𝟎 Light Detected 0x FF Bright o 0x 𝟎𝟕 𝟕𝟏 Accelerometer Data X ax...

Page 12: ...mmand Field determines whether a read or write action is being performed To write to a register the R W Access bit must be set to 1 one All read commands are one byte long Data following a read access command will be interpreted as a new command block To read a register the R W Access bit must be set to 0 zero Read commands are processed last For example in a single DL message if there is a read c...

Page 13: ... Registers Address Access Value Size bytes Description Format 0x00 RO DevEUI 8 DevEUI of Device MSB First 0x01 RO AppEUI 8 AppEUI of Device MSB First 0x02 RO AppKey 16 AppKey of Device MSB First 0x03 RO DevAddr 4 4 Byte DevAddr MSB First 0x04 RO NwkSKey 16 16 Byte NwkSKey MSB First 0x05 RO AppSKey 16 16 Byte AppSKey MSB First Note 1 Commissioning values need to be kept secure at all times Note 2 R...

Page 14: ... Default DR number Default Tx Power number 2 Bits 3 0 default Tx power number see LoRaWAN Regional Specification 3 Bits 11 8 default DR number see LoRaWAN Regional Specification 3 0x13 R W Rx2 window channel number Rx2 window DR number 2 Bits 3 0 DR number in Rx2 window Bits 11 8 Channel number in Rx2 window 0x19 R W Net ID MSB 2 MSBs of Net ID 0x1A R W Net ID LSB 2 LSBs of Net ID Note Modifying t...

Page 15: ...iguration Registers Address Access Value Size bytes Description 0x20 R W Seconds per tick 4 Sets the tick for periodic events A value of 0 disables all periodic transmissions 0x21 R W Ticks per Battery Tx 2 Ticks between Battery reports A value of 0 disables periodic battery reports 0x22 R W Ticks per Temperature Tx 2 Ticks between Temp reports A value of 0 disables periodic Temp reports 0x23 R W ...

Page 16: ...ers Table 3 4 Default Values of Periodic Transmission Configuration Registers Seconds per tick 3600 seconds 1 hour Ticks per Battery 24 ticks 24 hours Ticks per Temperature 1 tick 1 hour Ticks per RH 1 tick 1 hour Ticks per other transducers 0 ticks periodic Tx disabled Temperature and RH are only compatible with Home Sensor Base and External Connector models In Home Sensor PIR they should be disa...

Page 17: ... Reed Switch depending on the module type Table 3 6 shows a list of Digital Input configuration registers Table 3 6 Digital Input Configuration Registers Address Access Value Size bytes Description 0x2A R W Mode 1 Bit 0 Rising Edge Enable Bit 1 Falling Edge Enable Other bits are ignored 0x2B R W Count Threshold 2 of Triggers for event transmission A value of 0 disables event transmission 0x2C R W ...

Page 18: ...ion it may be configured to only transmit after 100 events logged in the room This may be useful for alerting cleaning staff that room requires attention 3 4 2 3 Value to Tx The Value to Tx determines what information is transmitted whenever an event or periodic digital transmission is required If the value is Counter Value the transmission contains the number of times the Digital Input was trigge...

Page 19: ...put state as soon as the Digital Input is tripped 10 times o DL payload 0x AB 00 0A AC 01 Reg 2B and Reg 2C with their write bits set to true Count Threshold set to 10 ten Value to Tx set to Input State Disable the Digital Input event driven transmission but periodically report the number of times the Digital Input is triggered o DL payload 0x AB 00 00 AC 02 Count Threshold set to 0 zero Value to ...

Page 20: ...to Transmit 1 Bit 0 Alarm On Off Bit 1 Magnitude Bit 2 Full Precision Other bits are ignored 0x33 R W Impact Debounce Time 2 Seconds to wait before reporting impacts again 0x34 R W Mode 1 Bit 0 Break In Threshold On Off Bit 1 Impact Threshold On Off Bit 7 Power On Off Other bits are ignored 0x35 R W Sample Rate 1 Bits 2 0 Values supported by transducer 1 1 Hz 2 10 Hz 3 25 Hz 4 50 Hz 5 100 Hz 6 200...

Page 21: ...s The minimum debounce time is 1 one second 3 4 3 5 Mode The accelerator can be powered on off to tune power usage battery life for end user application Additionally Impact and Break In thresholds can be enabled disabled Disabling a threshold prevents the Sensor from generating the applicable accelerometer event 3 4 3 6 Sample Rate The Accelerometer is an always on transducer when powered and samp...

Page 22: ...A Reg 31 and Reg 33 with their write bits set to true Impact Threshold set to 2000 milli 𝑔 and Impact Debounce Time set to 10 seconds Set Sample Rate and read it back o DL payload 0x B5 06 35 Reg 35 with write bit set to true Reg 35 with write bit set to false Sample rate set to 200 Hz and then read back Power on the transducer with Impact Threshold enabled but Break In Threshold disabled and set ...

Page 23: ...porting Table 3 10 shows a list of configuration registers for the Temperature RH Threshold setting Table 3 10 Temperature RH Threshold Configuration Registers Address Access Value Size bytes Description 0x39 R W Temp Humid Sample Period Idle 4 Sample period of external Temperature RH transducer Idle state seconds 0x3A R W Temp Humid Sample Period Active 4 Sample period of external Temperature RH ...

Page 24: ...alue is outside the threshold window 3 4 4 3 Temperature MCU Temperature Threshold Temperature thresholds are stored in a single 2 byte register with the upper byte storing the high temperature threshold and the lower byte storing the low temperature threshold with a 1 C per bit precision Each temperature threshold is stored transmitted as a 1 byte 2 s complement number The high temperature thresh...

Page 25: ...ds Enabled Off MCU Temp Sample Period Idle 300 seconds MCU Temp Sample Period Active 60 seconds MCU Temperature Threshold Low 20 C MCU Temperature Threshold High 25 C MCU Temperature Thresholds Enabled Off 3 4 4 7 Example DL Messages In the following example payloads the Command Field is boldfaced Set Temperature Thresholds o DL payload 0x BB 19 F1 Reg 3B with write bit set to true High threshold ...

Page 26: ...reshold from 1 to 64 darker to brighter The Light transducer is held turned off to preserve energy Whenever light data is needed it gets turned on by the MCU 3 4 5 1 Sample Period The light sensing sample period determines how often the light sensing transducer is powered on and checked for the presence of light Shorter sample periods result in an improved detection time but result in additional b...

Page 27: ... Sensor becomes light de sensitized However if the Light Threshold is not touched the Sensor operates expectedly with the default value given in Table 3 13 which basically means that the slightest amount of light triggers the Sensor for a bright status Otherwise i e only for absolute darkness the status is dark Table 3 13 Default Values of Light Transducer Configuration Registers Sample Period 0 d...

Page 28: ...re RH and Light Sensing operations i e the corresponding transducers should be kept disabled for proper PIR operation The Home Sensor runs a simple state machine for reporting whether or not motion is detected To conserve battery usage the Home Sensor only reports motion when it is first detected and when motion has not been detected for a configurable Grace Period Note The PIR transducer is desig...

Page 29: ...old Period The Threshold Period is the amount of time that motion events will be accumulated for Threshold detection For example a Threshold Period of 10 ten seconds accumulates motion detection events over a 10 ten second period from the time of first detection If the Threshold is exceeded before the time expires the sensor reports Motion Detected otherwise it does not report Values less than 5 f...

Page 30: ...such that motion is detected only if two events occur within 10 seconds Also motion detection is cleared if there are no events for 10 minutes o Threshold set to 2 Threshold Period set to 10 seconds and Grace Period set to 10 minutes o DL payload 0x D0 02 58 D1 00 02 D2 00 0A Read the Grace Period and set the transducer such that the Sensor reports both State and Event Count in periodic transmissi...

Page 31: ...measurement 0x5B R W Threshold 1 Moisture detection threshold 0x5C R W Enable Disable 1 Moisture sensing enabled disabled Only Bit 0 is considered Other bits are ignored 0x5D W Calibrate Baseline 1 Command to calibrate the transducer as dry 3 4 7 1 Sample Period The Moisture transducer is activated periodically to determine if water is present A smaller sample period results in a faster response f...

Page 32: ...ces the transducer to re calibrate the dry baseline to the current value regardless of its actual state wet or dry It is recommended that this command is run when a Home Sensor is first deployed or relocated to ensure that the baseline is correctly set for the material under the Home Sensor Note The moisture detector is automatically recalibrated for a new dryness baseline whenever the transducer ...

Page 33: ...ss Access Name Size Bytes Description Format 0x70 W Flash Write Command 2 Bit 0 Restart Sensor Bit 13 Write App Config Bit 14 Write LoRa Config Assert Bit Field 0 de asserted 1 asserted Note The Command Control Register is always executed after the full DL configuration message has been decoded The reset command should always be sent as an unconfirmed DL message Failure to do so may cause your NS ...

Page 34: ...ns Inc Confidential Page 34 of 34 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 ...

Reviews: