ThingsLog LPMDL-110X Installation instructions

Command line guide
Low power mobile data logger
ThingsLog LPMDL-110X Data logger
©iTransformers Labs Ltd
11 Magnaurska shkola str., fl. 3, office 315 (Hightech Business Park, BIC IZOT),
1784, Sofia, Bulgaria
Phone [phone]• Email: [email protected]

Table of Contents
Access to CLI console port......................................................................................................... 4
Base service mode .................................................................................................................... 4
Enter in Base service mode.................................................................................................... 4
Store configuration ................................................................................................................. 5
Load configuration.................................................................................................................. 5
Get device number................................................................................................................. 5
Get firmware version .............................................................................................................. 5
Get date ................................................................................................................................. 6
Set date.................................................................................................................................. 6
Get current initial config.......................................................................................................... 6
Description of configuration parameters.............................................................................. 6
Set initial config...................................................................................................................... 8
Setting up network identifiers..................................................................................................... 9
Setting and troubleshooting 2G/GPRS service mode options................................................. 9
Set collecting server address and port................................................................................ 9
Get collecting server address and port...............................................................................10
Set APN ................................................................................................................................10
Set 2G network attachment timeout.......................................................................................10
Get 2G network attachment timeout...................................................................................11
Setting up LoRa/LoRaWAN service mode options.................................................................11
Set the logger to use ABP or OTAA...................................................................................11
Get the logger to use ABP or OTAA...................................................................................11
Set the logger to send only the last full counter..................................................................11
Get the logger configuration to send only the last full counter................................................12
Set configuration application..................................................................................................12
Get collecting config application ............................................................................................12
Set Collecting application...................................................................................................13
Get collecting app collect...................................................................................................13
Setting up NB-IoT service mode options................................................................................14
Set collecting server address and port...............................................................................14
Get collecting server address and port...............................................................................14
Set APN ................................................................................................................................14

Get APN ............................................................................................................................15
Set NB-IoT network bands.................................................................................................15
Get NB-IoT network bands.................................................................................................15
Set NB-IoT network attachment timeout.............................................................................16
Get NB-IoT network attachment timeout ............................................................................16
Set MQTT parameters .......................................................................................................16
GET MQTT parameters .....................................................................................................17
Setup analog sensor settling time..........................................................................................17
Example output.........................................................................................................................18
Successful configuration and data transmission....................................................................20

Access to CLI console port
To access the command line interface you have to connect with an USBtoTTL cable to the
logger console (UART) port.
To access the console port you have to connect to the 3 pins to the right of the input ports (in
blue).
Figure 1 UART & service mode pins in LPMDL-110X
To put the device into service mode you need to press the button (red circle).
Console pins are left to right TXD RXD GND. If you are using ThingsLog console cable
•Black is GND
•Green is RXD
•White is TXD
Note: RX on the cable must be connected to TX on the board and RX on the cable must be
connected with TX on the board.
Base service mode
There are different commands that can be used to configure the GPRS device when it is in
service mode. In order to do this configuration it is necessary to put device in service mode
using the service button.
Enter in Base service mode
1. Connect to the debug UART port using baud rate 57600
2. Press the service button
3. Verify that the following message appear in UART console: "service # ". This indicates
that the device is in the base service mode
Example
service #

Store configuration
1. Verify you are in base service mode - the prompt is "service # "
2. Execute "store" command to save the configurations
3. Verify "service # " prompt appear
Example:
service # store
service #
Load configuration
1. Verify you are in base service mode - the prompt is "service # "
2. Execute load command to load the configurations
3. Verify "service # " prompt appear
Example:
service # load
service #
Get device number
1. Verify you are in base service mode - the prompt is "service # "
2. Execute number command to get the device number
3. Verify "number=00000001" hex device number appear
Example:
service # number
number=00000001
service #
Get firmware version
1. Verify you are in base service mode - the prompt is "service # "
2. Execute version command to get the firmware version
3. Verify "version=<some_version>" appear
Example:
service # version
version=0x0604bbc1
service #

Get date
1. Verify you are in base service mode - the prompt is "service # "
2. Execute date command to get the current date
3. Verify "date=<some_date>" appear
Example:
service # date
date=2017-04-01 12:40:00
service #
Set date
1. Verify you are in base service mode - the prompt is "service # "
2. Execute set_d command to set the device number
3. Verify "date=" prompt appear
4. Enter the new date in format YYYY-MM-dd HH:mm:ss
5. Verify "done" appear
Example:
service # set_d
Date=2017-04-01 12:40:00
Done
service #
Get current initial config
1. Verify you are in base service mode - the prompt is "service # "
2. Get current config by executing configure.
Example:
*** Config ***
2018-09-03 12:03:04
-----------
digits1=8
digits2=8
count_init1=1
count_init2=1
record_period=0
every=1
counts_threshold=300
sensors=01: CNT1
-----------
Description of configuration parameters
Name
Default
Value
Possible values
Description
digits1
8
•Min value: 1
•Max value: 9
Total number of
countable digits on the

display of the meter for
the first pulse input
digits2
8
•Min value: 1
•Max value: 9
Total number of
countable digits on the
display of the meter for
the second pulse input
count_init1
1
Max value depends on the digits1
value
The value of the meter
display of the first pulse
input
count_init2
1
Max value depends on the digits1
value
The value of the meter
display of the second
pulse input
record_period
0
•0 –MINUTES
•1 –HOURS
The value of the record
period 0 mean minutes
every
1
•Min value: 1
•Max value: 127
The value in record
period (1 - every 1 minute
counts_threshold
300
•Min value: 1
•Max value: 256
How many counters to
keep in memory
sensors
01
Mask of 12 bits
0000000000000000
•0 bit –Pulse sensor 1
•1 bit –Pulse sensor 2
•2 bit –analog sensor 1
•3 bit –analog sensor 2
•4 bit –On/Off sensor 1
•5 bit –On/Off sensor 2
•6 bit on/off output 1
•7 bit on/off output 2
•8 bit analog 3
•9 bit analog 4
•10 bit SEN5 –i2c sensor 1
•11 bit SEN6 –i2c sensor 2
•12 bit SEN7 –i2c sensor 3
•13 bit SEN8 –i2c sensor 4
•14 bit –future use
•16 bit –future use
For example if you want to enable
first pulse input, first analog and i2c
sensor 1 and 2 that would resolve in:
0000 1100 0000 0101
Counting right to left (big endian
stype):
0101 –first pulse and first analog
0000 –no on/offs are enabled
1100 –first 2 i2c are enabled
0000 -nothing else is enabled
Which input is active, 01
means the first pulse
input

So you have to set in set sensors:
0xC05
Hexadecimal number equal to the
binary above!!!
Set initial config
1. Verify you are in base service mode - the prompt is "service # "
2. Execute set_conf and enter the configuration menu
service # set_conf
config # help
commands:
help
set_count_init1
set_count_init2
set_digits1
set_digits2
set_rec_period
set_every
set_counts_threshold
set_sensors
save
exit
3. Set inputs reading frequency. Execute set_every
config # set_every
set_every= 3
4. Enable sensor input port
config # set_sensors
sensors= 1
5. Set counts threshold (the number of counters to be gathered prior transmission attempt).
Execute set_counts_threshold If the transmission is successful all counters will be
deleted from memory. If transmission fails counters will be kept in memory and will be
re-transmitted on next attempt. If memory got full the oldest counters will be deleted first.
config # set_counts_threshold
counts_threshold= 100
6. Set counter value. Has to be set all meaningful digits up to the magnet pointer. Execute
set_count_init1 for the first input and set_count_init2 for the second.
config # set_count_init1

count_init1= 123
config # set_count_init2
count_init2= 234
7. Save and apply the configuration.
Execute save
config # save
Save config
Applying config
Config Counters
rec_conf, size=102, rec_size=2, buff_size=206
Alarm enabled
service #
Setting up network identifiers
The logger could have different modem options: 2G, LoRa or NB-IoT.
Setting and troubleshooting 2G/GPRS service mode options
Set collecting server address and port
GSM data loggers are using by default TCP communication on port 4444.
1. Verify you are in gprs_service mode - the prompt is "gprs_service # "
2. Execute command set_addr_port
3. Verify "address=" prompt appear
4. Enter the new server address and press enter
5. Verify "port=" prompt appear
6. Enter the new server port and press enter
7. Execute resolveIp to set DNS name resolution 8 Verify that resolveIp= appears. Set it
1 to resolve address by DNS or 0 to disable resolving (address should be an IP
address).
8. Verify "done" appear
Example:
service # extension
gprs_service # set_addr_port
address=10.10.10.10
port=4444
resolve_ip=1
done
gprs_service #

Get collecting server address and port
1. Verify you are in gprs_service mode - the prompt is "gprs_service # "
2. Execute command get_addr_port
3. Verify "address=<some_ip>" appear
4. Verify "port=<some_port>" appear
Example:
service # extension
gprs_service # get_addr_port
address=10.10.10.10
port=4444
done
gprs_service #
Set APN
1. Execute command set_apn
2. Verify "apn=" prompt appears
3. Enter the new APN and press enter
4. Verify "done" appear
Example:
service # extension
gprs_service # set_apn
apn=some.operator.apn
done
gprs_service #
•Get APN
1. Execute command get_apn
2. Verify "apn=some.operator.apn" appear
Example:
service # extension
gprs_service # get_apn
apn=some.operator.apn
done
gprs_service #
Set 2G network attachment timeout
Network attachment delay is the time for which the logger will wait to be recognized and paged
by the mobile network.
1. Navigate to extension mode