Adeunis RF LoRaWAN TEMP User manual

adeunis ®
283 rue Louis Néel - Parc Technologique Pré Roux
38920 CROLLES - France
Tel. : [phone] - Fax : [phone]
www.adeunis.com [email protected]
LoRaWAN TEMP
Ready-To-Use Temperature Device
Guide utilisateur / User Guide
Version 2.0.0
Ce Guide utilisateur s’applique à partir des versions logicielles suivantes :
This User Guide applies from the following rmware versions:
Version RTU : V01.04.00
Version APP : V01.03.03
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
43 of 82
FR
PRODUCTS AND REGULATORY INFORMATION
Document Information
Title LoRaWAN TEMP - User Guide
Sub-title /
Document type User Guide
Version 2.0.0
This document applies to the following products :
Nom Référence Version firmware
LoRaWAN TEMP 868 ARF8180BA RTU version: V01.04.00
APP version:V01.03.03
DISCLAIMER
This document and the use of any information contained therein, is subject to the acceptance of the adeunis®
terms and conditions. They can be downloaded from www.adeunis.com.
adeunis® makes no warranties based on the accuracy or completeness of the contents of this document and
reserves the right to make changes to specifi cations and product descriptions at any time without notice.
adeunis® reserves all rights to this document and the information contained herein. Reproduction, use or disclo-
sure to third parties without express permission is strictly prohibited. Copyright © 2016, adeunis®.
adeunis® is a registered trademark in the EU and other countries.
TECHNICAL SUPPORT
Website
Our website contains a lot of useful information: information on modules and wireless modems, user guides, and
confi guration software and technical documents which can be accessed 24 hours a day.
E-mail
If you have technical problems or cannot fi nd the required information in the provided documents, contact our
Technical Support by e-mail. Use our dedicated e-mail address ([email protected]) rather than any personal e-mail
address of our staff . This ensures that your request will be processed as soon as possible.
Helpful Information when Contacting Technical Support
When contacting Technical Support, please have the following information ready:
• Product type
• Firmware version (for example V1.0)
• A clear description of your question or the problem
• A short description of the application
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
44 of 82
FR
EU Declaration of Conformity
WE
adeunis
283 rue LOUIS NEEL
38920 Crolles, France
04.76.92.01.62
www.adeunis.com
Declare that the DoC is issued under our sole responsibility and belongs to the following product:
Apparatus model/Product: TEMP LoRaWAN
Type: ARF8180AA, ARF8180BA
Object of the declaration:
The object of the declaration described above is in conformity with the relevant Union harmonisation
legislation:
Directive 2014/53/UE (RED)
The following harmonised standards and technical specifications have been applied:
Title: Date of standard/specification
EN 300 220-2 V3.1.1 2017/02
EN 301 489-1 V2.1.1 2016/11
EN 301 489-3 V2.1.0 2016/09
EN 62368-1 2014
EN 62311 2008
Otober, 5th,2017 Monnet Emmanuel, Certification Manager
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
45 of 82
FR
INTRODUCTION
All rights to this manual are the exclusive property of adeunis®. All rights reserved. Copying this manual (wit-
hout written permission from the owner) via printing, copying, recording or by any other means, translating this
manual (in full or partially) into any other language, including all programming languages, using any electrical,
mechanical, magnetic or optical devices, manually or any by other methods, is prohibited.
adeunis® reserves the right to change the technical specifi cations or functions of its products, or to cease manu-
facturing any of its products, or to cease technical support for one of its products without notice in writing and
urges its customers to make sure that the information they have is valid.
adeunis® confi guration software and programs are available free of charge in a non-modifi able version. adeu-
nis® can make no guarantees, including guarantees concerning suitability and applicability for a certain type
of application. Under no circumstances can the manufacturer, or the distributor of an adeunis® program, be
held liable for any damage caused by the use of the aforesaid program. Program names, as well as all copyright
relating to programs, are the exclusive property of adeunis®. Any transfer, granting of licences to a third party,
leasing, hire, transport, copying, editing, translation, modifi cation into another programming language or reverse
engineering are prohibited without adeunis®’s prior written authorisation and consent.
Adeunis
283, rue Louis Néel
38920 Crolles
France
Téléphone [phone]
Fax [phone]
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
46 of 82
FR
ENVIRONMENTAL RECOMMENDATIONS
All superfl uous packaging materials have been eliminated. We have done everything possible to make it easy to
separate the packaging into three types of materials: cardboard (box), expanded polystyrene (fi ller material)
and polyethylene (packets, foam protective sheets). Your device is composed of materials that can be recycled
and reused if it is dismantled by a specialist company. Please observe local regulations concerning the manner in
which waste packaging material, used batteries and your obsolete equipment are disposed of.
WARNINGS
Valid for products indicated in the declaration of conformity
Read the instructions in the manual.
The safety of this product is only guaranteed when it is used in accordance with its purpose. Maintenance
should only be carried out by qualifi ed persons.
Please note: Do not install the equipment close to a heat source or in damp conditions.
Please note: When the equipment is open, do not carry out any operations other than the ones set out in this
document.
Please note: Do not open the product as there is a risk of electrical shock.
Please note: For your own safety, you must ensure that the equipment is switched off before carrying out
any work on it.
Please note: For your own safety, the power supply circuit must be SELV (Safety Extra Low Voltage) and
must be from limited power sources.
Please note: When the aerial is installed outside, it is essential to connect the cable screen to the buil-
ding’s earth. We recommend using lightning protection. The protection kit chosen must permit the coaxial cable
to be earthed (eg: coaxial lightning arrester with earthing of the cable at diff erent places on the aerial at the
base of pylons and at the entrance, or just before entering the premises).
The product must be equipped with a switching mechanism so that the power can be cut. This must be close to
the equipment. Any electrical connection of the product must be equipped with a protection device against vol-
tage spikes and short-circuits.
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
47 of 82
FR
RECOMMANDATIONS REGARDING USE
• Before using the system, check that the power supply voltage shown in the user manual corresponds to your
supply. If it doesn’t, please consult your supplier.
• Place the device against a fl at, fi rm and stable surface.
•
The device must be installed in a location that is suffi ciently ventilated so that there is no risk of internal hea-
ting and it must not be covered with objects such as newspapers, cloths, curtains, etc.
• The device’s aerial must be free and at least 10 cm away from any conducting material.
• The device must never be exposed to heat sources such as heating equipment.
• Do not place the device close to objects with naked fl ames such as lit candles, blowtorches, etc.
• The device must not be exposed to harsh chemical agents or solvents likely to damage the plastic or corrode
the metal parts.
DISPOSAL OF WASTE BY USERS IN PRIVATE HOUSEHOLDS WITHIN THE EURO-
PEAN UNION
This symbol on the product or on its packaging indicates that this product must not be disposed of with your
other household waste. Instead, it is your responsibility to dispose of your waste by taking it to a collection point
designated for the recycling of electrical and electronic appliances. Separate collection and recycling of your waste
at the time of disposal will contribute to conserving natural resources and guarantee recycling that respects the
environment and human health. For further information concerning your nearest recycling centre, please contact
your nearest local authority/town hall offi ces, your household waste collection company or the shop where you
bought the product
This symbol on the devode or its packaging means the use of a DC voltage.
Warning: If the charger is used with any other batteries or products whatsoever, there is a risk of an ex-
plosion. After use, the batteries must be disposed of at an appropriate recycling centre. They must not be thrown
away to degrade in the environment. When batteries are replaced, the device must be corectly implemented.
Warning for Switzerland : the annex 4.10 of SR 814.013 Standad must be applied for batteries.
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
48 of 82
FR
1.1. General description
1. PRODUCT PRESENTATION
NOTE IMPORTANTE : The LoRaWAN TEMP can only be started with a magnet.
Description:
• The adeunis® LoRaWAN TEMP is a ready-to-use radio device enabling temperatures to be measured and transmitted by wireless communica-
tion network.
• This product meets the needs of users who require to remotely monitor internal and external temperatures of storage rooms, meeting rooms,
cold rooms, etc.
• The use of the LoRaWAN protocol allows the user to integrate the LoRaWAN TEMP into any network that is already deployed.
• The LoRaWAN TEMP is fitted with internal and external probes.
• The product emits the data from the sensors either periodically or in an event-based way based on top or bottom thresholds.
• The configuration of the transmitter is accessible by the user via a micro-USB port, allowing in particular a choice of modes of transmission,
periodicity or triggering thresholds.
• The LoRaWAN TEMP is powered by a replaceable internal battery.
IMPORTANT NOTE 1: The LoRaWAN TEMP is delivered by default with OTAA configuration, allowing the user to declare his/her product to a
LoRaWAN operator For an ABP procedure, please contact our Sales Department with the necessary information.
Composition of the package
The product is supplied in a cardboard box containing the following items:
top casing, electronic card, casing base plate
cable gland, 3 gland seals, 2 CBLZ 2.2 x 19mm screws, 2 Fischer SX4 plugs
107
90 27
49,50
2 holes for passing
collars through
Rail-DIN unlocking
lever
4 fastening holes
Cables outlet
packing gland
Casing base
Casing base detail
Antenna
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
49 of 82
FR
1.2. Dimensions
Values in millimetres
107
90
27
49,50
107
90
27
49,50
107
90 27
49,50
1.3. Electronic board
USB port for product
configuration
RF module
LoRaWAN protocol
Internal antenna
Internal battery
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
50 of 82
FR
1.4. Technical Specifications
1.4.1 General characteristics
Parameters Value
Supply voltage Nominal 3.6V
Power supply Removable battery version: SAFT LS14500
Maximal power 90mA
Working temperature -25°C / +70°C
Dimensions: 105 x 50 x 27mm
Weight 130g
Casing IP 67
Radio standards EN 300-220, EN 301-489, EN 60950
1.4.2 Autonomy
Operating conditions: Sending periodicity Autonomy SF7 Autonomy SF12
Product shelf life before use: Maxi-
mum 1 year.
Calculations performed at a tempera-
ture of 20°C
Without super-sampling factor in the
period
140 frame/day 6.5 years 7 month
100 frame/day 7.8 years 1 year
50 frame/day 10.4 month 1.9 years
20 frame/day 13 years 4.1 years
10 frame/day 14.3 years 6.5 years
2 frame/day 15.4 years 12.2 years
The above values are estimations based on certain conditions of use and environment. They do not represent a commitment on the part of
adeunis®.
1.4.3 Sensor characteristics
Caracteristics
Internal sensor - temperature range -30°C .. +70°C
Internal sensor - Inertia by 10°C steps 90 minutes
External sensor - temperature range -55°C..+155°C
External sensor - Inertia by 10°C steps 15 minutes
External sensor - Cable length 2 meters
Resolution 0,1°C
Precision +/- 0,1°C
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
51 of 82
FR
2. PRODUCT OPERATION
2.1. Global operation
Important: adeunis® use the most significant byte first format.
The product has several operating modes:
2.1.1 PARK MODE
The product is delivered in PARK mode, it is in standby mode and its consumption is minimal.To switch the product out of the Park* Mode pass
a magnet across it for a duration higher than 6 seconds. The green LED illuminates to indicate the detection of the magnet and then flashes
quickly during the product starting phase.
The device then sends its configuration and data frames (see paragraph 4.1).
2.1.2 COMMAND MODE
This mode allows the user to configure the registers of the product.
To enter this mode, connect a cable to the micro-USB port of the product and enter the command mode by an AT command (see paragraph 3).
2.1.3 OPERATING MODE
There are two possible modes of operation:
• TEST mode:
This mode allows the user to perform tests of the product more quickly by reducing the time scales of production mode and modifying the beha-
viour of the LEDs (see paragraph 2.2.5).
• PRODUCTION mode:
This mode allows the user to operate the product in its final use. It should allow a maximum of autonomy to the product.
To switch from one mode to the other the user changes the value of a register
PARK MODE
OPERATING MODE
REPLI MODE
COMMAND MODE
Replacing the battery
Command sen-
ding by serial link
Presence of a magnet
on the product >6s
Presence of a magnet
on the product >6s
Automatic if battery
too low
PRODUCTION MODE
TEST MODE
COMMAND MODECOMMAND MODE
The return to the produc-
tion mode is done by the
ATO command or by dis-
connecting the USB cable
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
52 of 82
FR
2.1.4 REPLI mode
The product enters this very low consumption mode following the detection of a level of battery that is too low. In this mode the product wakes
up every 5 seconds to make the red LED flash twice.
The replacement of the battery (if the product is a replaceable battery version) followed by the application of the magnet takes the product out
of this mode to return it to the operating mode.
2.2. Operating modes
2.2.1 Periodic transmission
Product on stand-by
Send frame 0x43
Yes
No
Average external tempe-
rature samples
Average internal tempe-
rature samples
Internal
temperature measure-
ment and storage
External
temperature measure-
ment and storage
Transmission
period reached
?
Yes
No
The product allows the measurement and the periodic transmission of the values of the sensors according to the following diagram:
Sampling
period reached
?
The product allows you to define a super-sampling to send, not an instantaneous
value but, an averaged value at the time of the transmission period defined.
The settings associated with this mode of operation are:
• The transmission period (register 301).
• Potential user identifiers for the sensors (registers 320 and 322).
• The super-sampling factor (register 333).
A complete list of the registers can be found in paragraph 3.4.
E.g.:
Register Value
encoding
Value Result
S301 Decimal 6 Periodic mode with a period of
6x10min = 60 minutes
S320 Hexadecimal 0xD0 Identifier of the internal sensor set
to 0xD
S322 Hexadecimal 0x80 Identifier of the external sensor set
to 0x8
S333 Decimal 4
The number of samples to be
measured and stored between two
transmissions is 4
In this example:
• The product transmits every hour (6x10min=60min)
• As the super-sampling factor is 4, there will be a measurement and a storage
operation every 60/4=15 minutes
• The value sent will therefore be an average of 4 temperatures collected every 15
minutes
Caution: averaging can reduce the importance of some peaks (maximum values) if
the temperature changes quickly.
Take care also over the values of the period and the super-sampling because they
have an impact on the consumption of the product. In the extreme a 10 minute
transmission periodicity and a factor of super-sampling of 10 leads to a measure-
ment every minute.
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
53 of 82
FR
2.2.2 Transmission over threshold
The product allows the detection threshold overrun (upper and lower) for each sensor according to the following diagram:
NO
All the beginning of the process follows the same principle as in periodic transmission except that the reference period is the acquisition period
instead of the transmission period.
The product sends a frame of data at the threshold overrun and also during a return to normal.
Sampling
period
reached?
Send frame 0x43
Internal tempe-
rature measurement
and storage
Product in standby
NO NO
YES
YES
External tempe-
rature measurement
and storage
Acquisition
period
reached?
Average internal tem-
perature samples
Average external tem-
perature samples
High alert
inactive?
Value <
(High-hyste-
resis thres-
hold)
Low alert
inactive?
Value >
(Low-hyste-
resis thres-
hold)
Value >
high thres-
hold
Value > low
threshold
High alarm deactiva-
tion High alarm activation Low alarm deactivation Low alarm activation
YES YES
YES YES
YES YES
NO
NO
NO
NO
NO NO
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
54 of 82
FR
Explanation of thresholds and hysteresis:
The period of monitoring by the sensors is equal to the period of acquisition (register 332) divided by the super-sampling factor (register 333).
The settings associated with this mode of operation are:
• The transmission periodicity (zero in this usage situation) (register 301)
• Potential user identifiers for the sensors (registers 320 and 322).
• The configuration of the events (registers 321 and 323).
• The high alarm threshold for the internal sensor (register 324).
• The high alarm hysteresis for the internal sensor (register 325).
• The low alarm threshold for the internal sensor (register 326).
• The low alarm hysteresis for the internal sensor (register 327).
• The high alarm threshold for the external sensor (register 328).
• The high alarm hysteresis for the external sensor (register 329).
• The low alarm threshold for the external sensor (register 330).
• The low alarm hysteresis for the external sensor (register 331).
• The acquisition period (register 332).
• The super-sampling factor (register 333).
A complete list of the registers can be found in paragraph 3.4.
high threshold
Low threshold
High threshold - high threshold hysteresis
Low threshold + low threshold hysteresis
Sensor value
High alarm enabling High alarm disabling
Low alarm enabling Low alarm disabling
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
55 of 82
FR
E.g.:
Registre Codage de la valeur Valeur Résultat
S301 Décimal 0 Event mode
S320 Hexadécimal 0xD0 Identifier of the internal sensor set to 0xD
S322 Hexadécimal 0x80 Identifier of the external sensor set to 0x8
S321 Hexadécimal 0x03 For the internal sensor:
Detection of high and low thresholds
S323 Hexadécimal 0x02 For the external sensor:
Detection of high thresholds only
S324 Décimal 300 The value of the high threshold of the internal sensor is:
300/10=30°C
S325 Décimal 10 The value of the hysteresis of the high threshold of the internal
sensor is: 10/10=1°C
S326 Décimal 50 The value of the low threshold of the internal sensor is:
50/10=5°C
S327 Décimal 5 The value of the hysteresis of the low threshold of the internal
sensor is: 5/10=0.5°C
S328 Décimal 400 The value of the high threshold of the external sensor is:
400/10=40°C
S329 Décimal 20 The value of the hysteresis of the high threshold of the external
sensor is: 20/10=2°C
S330 Décimal -300 The value of the low threshold of the external sensor is:
-300/10=-30°C
S331 Décimal 10 The value of the hysteresis of the low threshold of the external
sensor is: 10/10=1°C
S332 Décimal 12 The acquisition period is 12 minutes
S333 Décimal 6 The number of samples to be measured and stored between two
transmissions is 6
In this example:
• The product compares the measurements every 12 minutes and transmits if necessary
• As the super-sampling factor is 6, there will be a measurement and a storage operation every 12/6=2 minutes
• The value sent will therefore be an average of 6 temperatures collected every 2 minutes
Caution: averaging can reduce the importance of some peaks (maximum values) if the temperature changes quickly.
Take care also over the values of the period and the super-sampling because they have an impact on the consumption of the product. In the
extreme an acquisition period of 1 minute and a super-sampling factor of 10 produces a measurement every 6 seconds.
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
56 of 82
FR
Product in standby
Send frame 0x30
Period
reached?
Yes
No
2.2.3 Transmission of a daily Keep Alive frame
In the event (threshold) mode only, it is possible that the product would never send data frames. So to be sure that it is working properly a Keep
Alive frame is transmitted regularly according to the following diagram:
2.2.4 TEST mode
This mode allows the user to perform tests of the product more quickly by reducing the time scales of the production mode and modifying the
behaviour of the LEDs.
It is obtained by positioning register S306 at the value 2 in the COMMAND mode. Once out of the command mode, the product returns to the
previously defined application behaviour but with the following changes:
- register S300: the periodicity of the Keep Alive is expressed in groups of twenty seconds instead of tens of minutes. Hence in test mode when
register 300 = 144, the Keep Alive is no longer sent every 144x10min=1440 minutes or 24h but every 144x20s=2880 seconds or 48 minutes.
- register S301: the periodicity of the sending of data (periodic mode) is expressed in groups of twenty seconds instead of tens of minutes.
Hence in test mode when register 301 = 1, the Keep Alive frame is no longer sent every 10min but every 20 seconds.
- register S332: the periodicity of the data acquisition (event mode) is expressed in tens of seconds instead of minutes.
Hence in test mode when register 332 = 1, the Keep Alive frame is no longer sent every minute but every 10 seconds.
-The LEDS also have a different behaviour, allowing a visual feedback to the user in the event of transmission and reception of frames (see
paragraph 2.3 for more details).
A complete list of the registers can be found in paragraph 3.4.
E.g.:
Register Coding the value Value Result
S306 Decimal 2 The product is in TEST mode
S300 Decimal 72 The Keep Alive frame is sent every: 72x20=1440s i.e. 24 minutes
S301 Decimal 6 Periodic mode with a period of 6x20 = 120s i.e. 2 minutes
S332 Decimal 10 In event mode the acquisition period is: 10x10=100 seconds
In periodic mode (register 301 different from 0), there is no Keep
Alive frame transmission.
The settings associated with this mode of operation are:
• The setting of the period of transmission of the Keep Alive frame
(once per hour to once per day) (register 300).
A complete list of the registers can be found in paragraph 3.4.
E.g.:
register Value enco-
ding
Value Result
S300 Decimal 72 The Keep Alive frame is
sent every:
72x10=720min i.e. 12h
(or twice per day)
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
57 of 82
FR
2.3. Operation of the LEDs
Mode LED red state LED green state
Transmission of frame (TEST mode only) ON during the transmission cycle
Reception of frame (TEST mode only) ON during the reception of a downlink frame
Product in Park mode OFF OFF
Magnet detection process (1 to 6 seconds) OFF ON from detection of the magnet up to a
maximum of 1 second
Product start (after detection of the magnet) OFF Rapid flashing 6 cycles, 100 ms ON / 100
ms OFF
Joining process (Lora product) During the JOIN phase: flashing: 50ms on / 1
s off
If the JOIN phase is complete (JOIN accept):
flashing: 50ms on / 50ms Off (6x)
During the JOIN phase: flashing: 50ms on /
1 s off (just after the red LED)
If JOIN phase is complete (JOIN accept):
flashing: 50ms on / 50ms off (just before the
red LED)
Switching to the Command mode Continuously lit Continuously lit
Battery level low Flashing (0.5s ON every 60s)
Product faulty (return to factory) Fixed ON
Product in production mode (TEST mode
only)
50ms ON / 50 s OFF 50ms ON / 50 s OFF (just before the red
LED)
Product in REPLI mode Flashing (100ms ON / 100ms OFF) x 2 every 5s
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
58 of 82
FR
3. DEVICE CONFIGURATION
The device can be configured using the USB connector. This connection allows you to communicate with the device via a virtual com port and to
transmit AT commands in order to modify the parameters of the device.
WARNING : the USB connection does not supply power to the product, it induces a consumption of the product as long as the one is connec-
ted. It is therefore important not to leave the product connected too long.
3.1. Connecting the device to a computer
Connect the product to the USB input of a computer. The product has a Type B micro USB connector.
During connection, the device must be recognised by the computer as a Virtual Com Port (VCP) device.
Using Windows:Verification that the device has been recognised to be functioning properly can be obtained by consulting the device manager.
You should see the USB series device with a corresponding COM port number appear during connection.
If you are not able to see a device of this type, you must install the USB driver for this device, available to download from our website:
https://www.adeunis.com/en/produit/temp/
Select:
• Driver USB-STM32_x64, if your computer is a 64 bits system
• Driver USB-STM32, if your computer is a 32 bits system
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
59 of 82
FR
3.2. Command mode
Use a COM port terminal in order to communicate with the device. We use the HERCULES COM port soft terminal available to download for free
by clicking on the following link: http://www.hw-group.com/devices/hercules/index_en.html
• With Hercules, select the “Serial” tab, then configure the serial port with the following serial parameters:
Parameters Value
Rate 115 200 bps
Parity None
Data 8
Stop Bit 1
• Select the serial port on which the device has been created with Windows (Name).
• Click on the “Open” button to open the serial port.
NOTE INFORMATION :If the com port has been opened correctly, Hercules will display the message “Serial COM3 port opened”.
Alternatively, “Serial port com opening error” will be displayed, meaning either that the com port is already open for another application, or it
does not exist.
You must send a specific frame in order to move the device to configuration mode.
Frame expressed in hexadecimals: 0x2B 0x2B 0x2B or « +++ »
For Hercules, this frame must be entered in one of the 3 lines available at the bottom.The hexadecimal format must be expressed using a “$” in
this program, which gives us the following frame: $2B$2B$2B .
Send the transition frame in command mode in order to switch the device to configuration mode by clicking on the SEND button.
After a few seconds, You must see the 2 LEDs light up permanently.
On the com port terminal, you should also have “CM” feedback for Command Mode.
Sending a character on Hercules is displayed in magenta and receiving a
character is displayed in black. If you do not see sending characters, this is
probably because ECHO is not active on this program.To activate the option
in the accessible menu, right click in the viewing window.
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
60 of 82
FR
3.3. AT commands
A command starts with 2 ASCII characters: “AT”, followed by one or more characters and data (see the list below for the syntax of AT com-
mands available on the modem).
Each command must finish with a “CR” or “CR” “LF” – both are acceptable.
(CR indicates: Carriage Return, LF indicates: Line Feed)
Once the command has been received, the modem will feedback:
<cr><lf> “Data” for ATS type playback control <n> ?, AT/S or AT/V
“O” <cr><lf>, for any other command when this has been accepted.
“E” <cr><lf>, if it refuses the command due to a syntax error, unknown command, unknown range, invalid parameter, etc.
“CM” <cr><lf>, if it accepts the input in command mode
Table of AT commands:
Command Description Reply example
+++ Input request in command mode CONNECTING... <cr><lf>
CM<cr><lf>
ATPIN <PIN> Gives access to AT commands if register S304 is different
of 0
AT/V Feeds back the version of the APPLICATIF and RTU
software
APP_8230EAA_PRG1706_V01.02.02:RTU_RTU_
WMBUS_868_PRG_1601_V00.00.03
Or
APP_8181AAA_PRG1701_
V01.00.02:RTU_8120AAB_PRG_1701_V01.00.01
AT/N Feeds back the type of network "LoRa" or "SIGFOX" or « WMBUS »
ATS<n>? Feeds back the content of the n range Sn=y where y represents the content of the n range
AT/S Edits the content of all of the user ranges in the form of
a list.
/
ATS<n>=<m> Transfers the m value to the n range «O»<cr><lf> if Ok, «E»<cr><lf> if error,
«W»<cr><lf> if coherency error
AT&W Saves the current configuration to non-volatile memory. «O»<cr><lf>, «W»<cr><lf> if coherency error
ATO Exit command mode «O»<cr><lf>, «W»<cr><lf> if coherency error
ATT63 PROVIDER Unblock the operating range «O»<cr><lf>
Example of a set of commands and corresponding responses that can be seen on the terminal:
Syntax
of the order Description Response Syntax to Next Line
+++ Input request in command mode CONNECTING...
CM
ATS221=1 Request to switch to activation OTAA mode O
ATS214=0018B200 Change APP_EUI MSB E -> This command is not validated (register no unlocked)
ATT63 PROVIDER Unblock the operating range O
ATS214=0018B200 Change APP_EUI MSB O
ATS215? Feeds back the value of the S215 range S200=44512451
AT&W Memory request for the state range O
ATO Output request in command mode O
Interpreting the previous example: the user wanted to modify the beginning of the APP_EUI after having made an unauthorised command
(answer E), and the ranges were unblocked in order to modify the range. The second part of the APP_EUI was verified and the parameters were
saved before exiting. When exiting command mode, the device will start a JOIN demand.
DISTRIBUTED BY TEXIM EUROPE

EN
LoRaWAN TEMP - Guide utilisateur / User guide version V2.0.0
61 of 82
FR
3.4. Description of the registers
On switching on the product works according to the last saved configuration (Factory Configuration if it is the first start, or if this configuration
has not been changed). Commands such as Modification TTY<n>=<M> or ATR allow you to change the content of the registers: <n> repre-
senting the number of the register and <m> the value to be assigned.This latter is either a decimal value or a hexadecimal value consistent
with the «encoding» column of the tables below.
Examples:
• ATS300=6 assigns the decimal value 6 in register 300
• ATS320=2 assigns the hexadecimal value 0x02 in register 320
It is imperative to save the parameters with the command AT&W before exiting the Command mode otherwise all changes will be lost.
IMPORTANT: The registers that are not documented (that can appear in the list following the AT/S command) in the paragraphs that follow are
reserved and must not be changed.
3.4.1 Function registers
The list of registers below allows you to change the behaviour of the product application.
Register Size
(bytes)
Description Coding Details
300 1 Transmission period of the Keep Alive
frame
Decimal Default: 144
Min/max: 1 à 255
Unit:
x 10min if S306=1
x 20s if S306=2
301 1 Transmission period of data sensors Decimal Default: 1
Min/max: 0 à 255
Unit:
x 10min if S306=1
x 20s if S306=2
The value 0 means no periodic sending, therefore event
operation
303 1 Confirmed mode activation Decimal Default : 0 (desactivated)
Values : 0 (desactivated) to 1 (activated)
304 2 PIN code Decimal Default : 0 (disabled)
Min/max : 0 to 9999
PIN code used with ATPIN command.
Value 0 disables the PIN code.
IMPORTANT: The product does not have a mechanism
to unlock the PIN code if it is activated and the code is
forgotten.
306 1 Global operation Decimal Default: 0
Allows the product to be switched into one of the
following modes:
• 0: PARK mode
• 1: Production mode
• 2: TEST mode
• 3: REPLI mode
320 1 Configuration of the internal sensor Hexadecimal Default: 0x00
Bits 0 to 3: Reserved
Bits 4 to 7: Identifier (free to use)
DISTRIBUTED BY TEXIM EUROPE