TEKTELIC Communications Kona Скачать руководство пользователя страница 8 | Manualshive

Страница: 8 / 34

TEKTELIC Communications Kona Скачать руководство пользователя страница 8

Kona Home Sensor TRM

T0005370_TRM

Version Rev-C 1.0

TEKTELIC Communications Inc.

Confidential

Page 8 of 34

1

Overview

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

«
...
6
7
8
9
10
...
»

Содержание Kona

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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...

Страница 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 ...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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 ...

Страница 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 ...

Страница 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 ...

Отзывы:

Нет отзывов