TEKTELIC Communications Kona Product manual

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 10th Street NE
Calgary, AB, Canada T2E 8X2
Phone: [phone]
TEKTELIC COMMUNICATIONS INC.
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.

Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0
TEKTELIC Communications Inc. Confidential Page 2 of 34
Revision History
Version
Date
Editor
Comments
0.1
Dec 11, 2017
D. Smith
First release.
0.2
Dec 22, 2017
D. Smith
Included 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 and including Rev
C.

Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0
TEKTELIC Communications Inc. Confidential Page 3 of 34
Table of Contents
List of Tables ................................................................................................................................... 4
List of Figures .................................................................................................................................. 5
Acronyms and Glossary................................................................................................................... 6
1Overview.................................................................................................................................. 8
2UL Data Format...................................................................................................................... 10
2.1 Example UL Payloads...................................................................................................... 11
3DL Command Format............................................................................................................. 12
3.1 Read and Write Access................................................................................................... 12
3.2 LoRaWAN Commissioning.............................................................................................. 13
3.3 LoRaWAN MAC Configuration........................................................................................ 14
3.3.1 LoRa Config Examples ............................................................................................. 14
3.4Sensor 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 Configuration........................................................................................... 31
3.5 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 4 of 34
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.............................. 16
Table 3-5: Digital Input Transducer Type for Different Home Sensor Models ............................ 17
Table 3-6: Digital Input Configuration Registers.......................................................................... 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-13: Default Values of Light Transducer Configuration Registers.................................... 27
Table 3-14: Motion Transducer Configuration Registers............................................................. 28
Table 3-15: Default Values of Motion Transducer Configuration Registers................................ 29
Table 3-16: Moisture Transducer Configuration Registers.......................................................... 31
Table 3-17: Default Values of Moisture Transducer Configuration Registers ............................. 32
Table 3-18: Sensor Command & Control Register ....................................................................... 33

Kona 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

Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0
TEKTELIC Communications Inc. Confidential Page 6 of 34
Acronyms and Glossary
ABP ............................. activation by personalization
ADR............................. adaptive data rate
Command Field .......... The read/write selection bit and register address combination.
CRC ............................. cyclic redundancy check
DL ............................... downlink
DR............................... data rate
EU ............................... European Union
Flash memory............. Non-volatile memory located on the Home Sensor, which contains
application and configuration settings.
𝑔................................. gravity (unit of acceleration ≈9.8 m/s2)
Home Sensor.............. Any one of 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
MAC............................ medium access control
MCU ........................... microcontroller unit
MSB ............................ most significant bit
NA............................... North America
NS ............................... network server
OTA............................. over-the-air
OTAA .......................... OTA activation
PIR .............................. passive infrared
Reg ............................. Register
RFU............................. reserved for future use
RH............................... relative humidity
RMS ............................ root mean square
RO............................... read-only
R/W ............................ read/write
Rx................................ receiver
Sensor......................... =Home Sensor

Kona Home Sensor TRM T0005370_TRM Version 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

Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0
TEKTELIC Communications Inc. Confidential Page 8 of 34
1Overview
This TRM describes the user accessible configuration settings (pseudo registers) supported by
the Home Sensor. This document is intended for a technical audience, such as application
developers, with an understanding of the 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.
Additional sensing features such as leak and motion detection, as well as counting pulses from
an external device are also supported with the appropriate Home Sensor model. Table 2-1
presents the currently available Kona All-in-One Home Sensor models and RF Regions.
Table 2-1: Kona All-in-One Home Sensor Module Models
Product Code
Description
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 Connector
EU 863-870MHz ISM Band
The default configuration on the Home Sensor is:
•Report Temperature and RH every 1 (one) hour.
•Report Battery Voltage every 24 (twenty-four) hours.
•Report actuation of the digital input element every one 1 (one) actuation.
There are two information streams that need to be supported by applications:
•Data from the Sensor (UL Data) contains readings from the various on-board
transducers.
•Data from the Server (DL Data) contains configuration commands that can be used to
change the Sensor’s behavior.
In the following sections, the UL (departing from the Sensor) and DL (destined to the Sensor)
payload formats are explained. Refer to the Kona Home Sensor Uplink and Downlink Payload
Formation spreadsheet [2] for a thorough tool to build any UL or DL payload by varying

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.

Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0
TEKTELIC Communications Inc. Confidential Page 10 of 34
2UL Data Format
Each data field from the Sensor is encoded in a frame format shown in Figure 2-1.
Data Channel (1 byte)
Data Type (1 byte)
Data (N bytes)
Figure 2-1: The frame format in an UL payload.
A Sensor message payload can include multiple transducer data frames. The ordering of frames
is not guaranteed (they can be in any order). A single payload may include data from any given
transducer. The Home Sensor payload frame values are shown in Table 2-1. Transducer data in
the UL are sent through LoRaWAN Port 10.
Table 2-1: Home Sensor Payload Frame Values
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
0.5% / LSB
Impact Magnitude
0x05
0x02
2
Analog
1 milli-𝑔/ LSB (signed)
Break-in
0x06
0x00
1
Digital
0x00: No break-in
0xFF: Break-in event
Accelerometer Data
0x07
0x71
6
Accelerometer
2-byte X, 2-byte Y, 2-
byte Z (1 milli-𝑔/ LSB,
signed)
Input Count
0x08
0x04
2
Counter
Number (MSB first)
Moisture
0x09
0x00
1
Digital
0x00: Dry
0xFF: Wet
Motion Detected
(PIR)
0x0A
0x00
1
Digital
0x00: No motion
0xFF: Motion detected
MCU Temperature
0x0B
0x67
2
Temperature
0.1°C / LSB (signed)

Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0
TEKTELIC Communications Inc. Confidential Page 11 of 34
Impact Alarm
0x0C
0x00
1
Digital
0x00: No impact alarm
0xFF: Impact alarm
Motion Event Count
0x0D
0x04
2
Counter
Number (MSB first)
2.1 Example UL Payloads
In the following example payloads, the data channel ID and data type ID are boldfaced:
•0x 03 67 00 0A 04 68 28
o0x 𝟎𝟑 𝟔𝟕 (Temperature)=(0x 00 0A)× 0.1°C = 1°C
o0x 𝟎𝟒 𝟔𝟖 (RH) = (0x 28) × 0.5% =20%
•0x 04 68 14 01 00 FF 08 04 00 05
o0x 𝟎𝟒 𝟔𝟖 (RH) = (0x 14) × 0.5% =10%
o0x 𝟎𝟏 𝟎𝟎 (Input)= 0x FF = High
o0x 𝟎𝟖 𝟎𝟒 (Input Count)= 0x 00 05 = 5 switch triggers
•0x 04 68 2A 03 67 FF FF 00 FF 01 2C
o0x 𝟎𝟒 𝟔𝟖 (RH) = (0x 2A) × 0.5% =21%
o0x 𝟎𝟑 𝟔𝟕 (Temperature)=(0x FF FF)× 0.1°C = −0.1°C
o0x 𝟎𝟎 𝐅𝐅 (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
o0x 𝟎𝟐 𝟎𝟎 (Light Detected)= 0x FF = Bright
o0x 𝟎𝟕 𝟕𝟏 (Accelerometer Data)=[Xaxis: (0x 00 3A)× 0.01𝑔, Yaxis: (0x 00 07)×
0.01𝑔, Zaxis: (0x 00 53)× 0.01𝑔]= [Xaxis: 0.58𝑔, Yaxis: 0.07𝑔, Zaxis: 0.83𝑔]
o0x 𝟎𝟏 𝟎𝟎 (Input)= 0x FF = High
•0x 0D 04 00 02 06 00 FF
o0x 𝟎𝐃 𝟎𝟒 (Motion Event Count)= 0x 00 02 = 2 motion events
o0x 𝟎𝟔 𝟎𝟎 (Breakin)= 0x FF =break-in detected

Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0
TEKTELIC Communications Inc. Confidential Page 12 of 34
3DL Command Format
All DL messages follow the same format. Each configuration option has a 1-byte “register”
address that is used to access various configuration parameters. These addresses are bound
between 0x00 and 0x7F.
A single DL message can contain multiple command blocks, with a mix of read and write
commands. Each block is formatted as shown in Figure 3-1.
Command Field (1 byte)
Data (N bytes): Only used for WRITE commands
R



/ W (Bit 7)
Address (Bits 6–0)
Figure 3-1: Format of a DL message.
All configuration commands (i.e. in the DL), as well as all responses to those commands (i.e. in
the UL), are sent through LoRaWAN Port 100.
3.1 Read and Write Access
Bit 7 of the Command 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 command from a register and a write
command to the same register, the write command is executed first.
Examples:
In the following examples, the Command Field is boldfaced:
•Read Registers 0x00, 0x01, and 0x02:
oDL command: { 0x 00 01 02 }
•Read Register 0x05 and Write value 0x8000 to Register 0x10:
oDL command: { 0x 05 90 80 00 }
When a write command is sent to the Sensor, the Sensor will immediately respond with a
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. Confidential Page 13 of 34
3.2 LoRaWAN Commissioning
LoRaWAN Commissioning values can be read back from the Sensor using DL commands. These
registers are RO. See LoRaWAN 1.0.3 specification [1] for description of values. Table 3-1 shows
a list of these registers.
Table 3-1: LoRaWAN Commissioning 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: 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
TEKTELIC Communications Inc. Confidential Page 14 of 34
3.3 LoRaWAN MAC Configuration
LoRaWAN MAC options can be configured using the LoRaWAN DL. These configuration options
change the default MAC configuration that the Sensor loads on start-up. They can also change
certain run-time parameters. Table 3-2 shows the MAC configuration registers.
Table 3-2: LoRaWAN MAC Configuration Registers
Address
Access
Value
Size
[bytes]
Description
0x10
R/W
Join Mode
2
Bit 15: 0=ABP, 1=OTAA
0x11
R/W
Disable/Enable ADR
Disable/Enable Duty
Cycle
Private/Public Networks
Unconfirmed/Confirmed
UL
2
Bit 0: 0=unconfirmed UL, 1=confirmed UL
Bit 1: 0=private networks, 1=public
networks
Bit 2: 0=disable duty cycle, 1=enable duty
cycle
Bit 3: 0=disable ADR, 1=enable ADR
0x12
R/W
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 these values only changes them in the Sensor device. Options for the Sensor in
the NS also need to be changed in order to not strand a Sensor. Modifying configuration
parameters in the NS is outside the scope of this document.
3.3.1 LoRa Config Examples
In the following example payloads, the Command Field is boldfaced:
•Switch Device to ABP Mode:
oDL payload: { 0x 90 00 00 }
•Set ADR On, No Duty Cycle, Public Network, and Confirmed UL Payloads:
oDL payload: { 0x 91 00 0B }
•Set default DR number to 15, default Tx Power number to 15, Rx2 DL channel number to
4, and Rx2 DR number to 2:
oDL payload: { 0x 92 0F 0F 93 04 02 }

Kona Home Sensor TRM T0005370_TRM Version Rev-C 1.0
TEKTELIC Communications Inc. Confidential Page 15 of 34
3.4 Sensor Application Configuration
Note: Care must be taken to avoid stranding the Sensor during reconfiguration. If all Sensor
transducers are disabled, the Sensor cannot be reconfigured.
3.4.1 Periodic Tx Configuration
All periodic transducer reporting is synchronized around ‘ticks’. A tick is simply a user
configurable time-base that is used to schedule transducer measurements. For each transducer,
the number of elapsed ticks before transmitting can be defined.
Note: Certain transducer types, such as accelerometer and light, need to be enabled for
periodic reporting. Details are available in each transducer’s respective section. Table 3-3 shows
a list of registers used to configure the Sensor’s periodic transmissions.
Table 3-3: Periodic Transmission Configuration 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
Ticks per RH Tx
2
Ticks between Humidity reports. A value of 0
disables periodic Humidity reports.
0x24
R/W
Ticks per Digital
Input Tx
2
Ticks between Digital Input reports. A value of
0 disables periodic Digital Input reports.
0x25
R/W
Ticks per Light Tx
2
Ticks between Light reports. A value of 0
disables periodic Light reports.
0x26
R/W
Ticks per
Accelerometer Tx
2
Ticks between Accelerometer reports. A value
of 0 disables periodic Accelerometer reports.
0x27
R/W
Ticks per MCU
Temp Tx
2
Ticks between MCU Temp reports. A value of
0 disables periodic MCU Temp reports.
0x28
R/W
Ticks per PIR Tx
2
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 16 of 34
3.4.1.1 Seconds per Tick
All periodic Tx events are scheduled in ticks. This allows for transducer reads to be
synchronized, reducing the total number of ULs required to transmit Sensor data. The minimum
seconds per tick is 30 seconds. Values from 1 to 29 are clipped to 30 seconds. If the Seconds per
Tick is set to 0 (zero), all periodic reporting is disabled.
3.4.1.2 Ticks per <Transducer>
This register sets the reporting period for a transducer in terms of ticks. Once the configured
number of ticks has expired, the Home Sensor polls the specified transducer and reports the
data in an UL message. A setting of 0 (zero) disables periodic reporting for the specified
transducer.
3.4.1.3 Default Configuration
Table 3-4 shows the default values for the periodic transmission configuration registers.
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 disabled for the PIR function to operate properly
(i.e. the Temperature and RH ticks should be set to 0). This limitation is only applicable to Home
Sensor modules before Rev D.
3.4.1.4 Example DL Messages
In the following example payloads, the Command Field is boldfaced:
•Disable all periodic events:
oDL payload: { 0x A0 00 00 00 00 }
▪Reg 20 with the write bit set to true
▪Seconds per Tick set to 0 (zero)―i.e. disable periodic transmissions
•Read current value of Seconds per Tick:
oDL payload: { 0x 20 }
▪Reg 20 with the write bit set to false
•Report Temperature every tick and RH every two ticks:
oDL 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. Confidential Page 17 of 34
▪RH Ticks set to 2 (two)
3.4.2 Digital Input Configuration
The Digital Input transducer type varies between different Home Sensor models. The type used
in each model is listed in Table 3-5.
Table 3-5: Digital Input Transducer Type for Different Home Sensor Models
Home Sensor Model
Digital Input Transducer Type
Base
Magnetic Reed Switch
External Connector
2-Wire External Connector
PIR
Magnetic Reed Switch
In fact, as Table 3-5 shows, the External Connector and Magnetic Reed Switch are mutually
exclusive, i.e. not both exist in the same module, such that the Digital Input is either the
External Connector or the Magnetic 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
Value to Transmit
1
Bit 0: Input State
Bit 1: Counter Value
Other bits are ignored.
3.4.2.1 Mode
The Digital Input is edge-triggered and can be set to trigger to rising-edge trigger (Low or Closed
to High or Open), falling-edge triggered (High or Open to Closed or Low) or both. An attempt to
set the 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. Confidential Page 18 of 34
•Pulse counting from a water meter would use a single edge trigger, depending on the
resting state of the connected device (positive pulse would use rising edge, negative
pulse would use falling edge).
3.4.2.2 Count Threshold
The Count Threshold determines when the Sensor transmits after seeing an event on the Digital
Input. A value of 0 (zero) disables the event driven transmission, while a value of 1 (one) or
greater triggers an event-based transmission after the configured number of events has
occurred.
Application Example:
•If a sensor is intended to pulse count from a high-volume water meter, it may be
configured to disable event-based transmission in favor of getting hourly reports from
the sensor.
•If a sensor is intended to monitor room utilization 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 triggered since the last transmission, while the value of
‘Input State’ causes a transmission of the current input state of the switch (i.e. Open or Closed).
3.4.2.4 Default Configuration
Table 3-7 shows the default values for the Digital Input configuration registers.
Table 3-7: Default Values of Digital Input Configuration Registers
Mode
Rising and Falling Edge Enabled
Threshold
1 (one)
Value to Tx
State and Count Enabled
3.4.2.5 Example DL Messages
In the following example payloads, the Command Field is boldfaced:
•Have Digital Input be triggered only on rising edges:
oDL 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. Confidential Page 19 of 34
•Read current value of Count Threshold:
oDL payload: { 0x 2B }
▪Reg 2B with write bit set to false
•Transmit the Digital Input ‘state’ as soon as the Digital Input is tripped 10 times:
oDL 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:
oDL 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. Confidential Page 20 of 34
3.4.3 Accelerometer Configuration
The Accelerometer transducer offers two thresholds for event-based break-in and impact
detection. It can also be polled periodically for applications where the Sensor orientation may
be of interest. Table 3-8 shows a list of Accelerometer configuration registers.
Table 3-8: Accelerometer Configuration Registers
Address
Access
Value
Size
[bytes]
Description
0x30
R/W
Break-In Threshold
2
10 milli-𝑔/ LSB
0x31
R/W
Impact Threshold
2
10 milli-𝑔/ LSB
0x32
R/W
Value 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 Hz
•7: 400 Hz
A value of 0 (zero) is ignored.
Bits 7–3 are ignored.
3.4.3.1 Break-In Threshold
This parameter is the 𝑔-threshold used for break-in detection. As soon as the 𝑔-threshold is
tripped, a timer with a timeout is started. 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.