Dynamax SAPIP-LTE User manual

Table of Contents
Secon 1 Connect to SapIP-LTE through TeraTerm……………….……………...……………………………..….…….....2
Secon 2 Verify SapIP Status……….………………………………………………………...……………………………..….…….....3
Secon 3 Verify LTE Status..………………………………………………………………...……………………………..….…….....4
Secon 4 Verify Log & LTE communicaon…………………………..……………...……………………………..….…….....5
Appendix: SAPIP-Cell-LTE Message Explanaons………………………………...……………………………..…......6-10
SAPIP-LTE Quick Start Guide

Secon 1 — Connect to SapIP-LTE through TeraTerm
 Connect antenna to SapIP and lay antenna
vercally next to a window.
 Power on SapIP-LTE then connect it to PC
using provided black USB cable.
 When looking down from top of the enclo-
sure, le window will show a yellow LED
blinking. The sequence is short-short-long-
long-short-short, then repeat one more me.
The blinking sequence happens every 30 sec-
onds under normal operaon.
 Right window will show a red LED blinking.
This is Digi LTE module LED which blinks four
mes a second.
 Run TeraTerm program from PC then select
associated COM port, click “OK”.
 Go to “Setup—Restore Setup” and navigate
to “C:\Program Files (x86)\teraterm” folder
and select “SapIP-TeraTerm.ini” le, click
“OPEN”. The TeraTerm window will resize.
 If you don’t have the le available, download
it here.

Secon 2 — Verify SapIP Status
 Type *** to enter USB command mode.
 There is a list of USB commands available and can be downloaded from here.
 Type “STAT” to check baery status, date/me, baery level, and logging status.
 Type “MVER” to verify LTE version number, the latest version is 535
 Type “SERNO” to verify LTE address, this is a 8-digit number that has to match with SapIP address on
agrisensors.net.
 Type “AVRS” to verify heater voltage. Refer to downloaded document to change heater seng.
 Type “INTER” to verify logging interval. Default interval is 15 (15 minutes). Refer to downloaded docu-
ment to change logging interval.
 Type “ADC” to verify channel seng and labels. Refer to downloaded document to change channel con-
guraon. This has to be done via TeraTerm.

Secon 3 — Verify LTE Status
 Reboot SapIP by typing in “rboot”.
 During the reboot, pay close aenon to the
following messages:
 Version
 Signal strength — ATDB
 Date/me
 There is a list of LTE commands available and
can be downloaded from here.
 To verify signal strength without reboong
SapIP, do the following:
 Type *** to enter USB mode
 Type +++ and hit “ENTER” to access
LTE mode
 “$” disappears and followed with a
“OK”
 Type capital “S” then monitor the re-
sponse, S character will be immedi-
ately followed by +++
 When done, wait for LTE mode to
me out and “$” sign re-appears
 Type “EXIT” to disconnect from SapIP

Secon 4 — Verify Log and LTE Communicaon
 Refer to USB Command List downloaded earlier.
 Change logging interval to Test Normal (Type “INTER TN”), “TEST” and “Test Fast TF” mode are not avail-
able for LTE units
 Change heater voltage to minimum required voltage for the sensor used. For example, if dynagage, set
heater to 3.5V (Type “AVRS 3500”).
 Connect sensor to SapIP then reboot SapIP. Wait for the reboot process to complete (about 60-90 sec-
onds).
 Enter USB command mode then start logging (Type “START”).
 Monitor transmission on TeraTerm while verifying data on agrisensors.net (Test Normal logging interval
produces a new data every 100 seconds, it takes about 15 minutes for new data to be uploaded to agris-
ensors.net website).
 While waing for the new data, verify remote commands on agrisensors.net SapIP control panel page.
Monitor SapIP response through TeraTerm.
 Status
 Repeat Last Reading
 Show Device Cong
 Update Date/Time
 Send SMS to Device (or send a single leer from cellphone to the listed SapIP number)
 SapIP-LTE doesn’t wake up on demand. By sending 2 consecuve remote commands, SapIP-LTE will en-
ter debug mode and stay awake for 20 minutes. During “No Sleep” period, SapIP-LTE will response to
any remote command immediately.
 When new data is ready and uploaded to website, verify it on agrisensors.net under “Sensor Report”.
 Stop logging by issuing remote “STOP LOGGER” command or typing “STOP” in TeraTerm.
 SapIP-LTE is now ready to be deployed to the eld.

Appendix: SAPIP-Cell-LTE Message Explanations
CPU RESET, V535 (LTE NOSLEEP)
CPU (central processor unit) Power-on message with the firmware version number (535) and options (LTE
NOSLEEP). Possible options are
LTE - 4G LTE network
NOSLEEP - Digi module never goes to sleep
Wait for power up…
The CPU is waiting for the LTE module to acknowledge that it has powered up. A response is sent only if the
module was previously powered down or reset.
No response
No response was seen from the module after the maximum wait time (which may vary).
CTS HI OR OPEN
The Clear-To-Send line is high (not asserted) and so the LTE module is present and working or the mod-
ule is removed from the board.
Wake up…
The CPU is waking up the LTE module
SLEEP_RQ LO
The CPU is commanding the LTE module to wake up
CTS LO (OK)
The Clear-To-Send line is asserted which means the module is present and working
Wait 2 min for LTE connect…
The CPU is waiting up to 2 minutes for status == 2 (cell tower connect)
Got M status = 2
The cell connection is good
Got M status = 14
The LTE data network is good
+++
The CPU is commanding the LTE module into AT (transparent) mode for some commands
OK
The CPU received an OK response

ATSM1
The CPU is commanding sleep mode 1 (pin sleep).
ATD51
The CPU is commanding D5=1 (associate light controlled by I/O line 5)
ATAP1
The CPU is commanding API mode
ATWR
The CPU want the module to write the new settings
ATAC
The CPU wants to write all registers to non-volatile memory.
ATCN
The CPU wants to end command mode (AT or transparent mode).
Scanning flash… DEF ATSM=0 DEF ATOS=50 ATOW=4000
Flash memory setup
ATDB
The CPU requests a signal strength reading in dB
Signal: -93dBm
A sample signal strength response
Ready
The CPU is finished setting up the LTE module
ATAP4
The CPU is requesting mini-Pascal mode for getting the date and time from the cell network
>>> import utime as time; time.localtime()
Pascal command to get date and time
(2019, 4, 15, 15, 24, 0, 0, 105)
Sample date/time repsonse
ATAP1
The CPU wants to go back to AT mode
updated Date Time
Update Date and Time is completed
NO SLEEP
Here the LTE module would ordinarily go to sleep but it is being kept awake for this version of the firm-
ware

4 min delay
The next call to CheckForCommands to poll the web server will happen in 4 minutes
LTE send...
The CPU has called the LTESend function to send data through the LTE network
GET /ServiceInterface.asmx/GetCommands?ID=ZZ00890015 HTTP/1.1
The HTTP (hyper text transfer protocol) request. The address of the SAPIP (serial number) is 890015 in
this example.
Host: 72.52.168.29:75
The Host address and port settings (fixed in firmware)
Got: {"Commands":[{"ID":"147782","Command":"GET_RECORD:268"},...}]}
Sample Json (java script) command data string.
Got: {"Commands":[]}
Sample empty command string (no commands in the buffer)
SENDING STATUS
The CPU is sending a status message to the web server
PUT /service/putRciResponse/rci147782.XML HTTP/1.1
HTTP command to send data
Content-Type: application/xml Content-
Length: 387
Content settings for type and length
<rci_reply version="1.1"><do_command target="async_sapip_rci"><get_records name="...
Status string sent for unit 8900015
Completed
The HTTP request is done (no error)
Meas Start
The CPU has started a measurement cycle
Last Meas
After this upcoming measurement cycle, the averages will be taken and the data will be recorded to FLASH
memory and sent to the webserver

Skipping CFC
Due to an upcoming measurement cycle (in <90 seconds), the CPU is skipping the call to CheckForCommands
CheckforCommands...
The CPU is about to check the web server for new commands
00567,04/15/2019,15:30,12.2,+0.2206,+0.2222,+0.2225,+0.0083,+0.2229,+0.2228,+0.2229,+0.0087,00.0470,000
00,+30.3,5.07,0000,0000.0,T,F,KKKKKKKKKUK
Sample data record (number 567) to be sent for this unit with date, time, analog and digital readings
SENDING DATA
The CPU has initiated the SendData function
PUT /service/putData/TEST/sapDataGSM.XML HTTP/1.1
HTTP PUT request for SAPIP data
<idigi_data><sample><name>ZZ00890015.pComplete</name><value> ... </value></sample></idigi_data>
Sample data record ... encased within a Json string
Got M status = 15
the LTE network is disconnected
Got M status = 3
the cell tower is disconnected
Buffer overrun
the CPU was expcting a short message (like SMS) but got a long one (like a delayed data request). The
CPU has prevented the data from writing past the end of the buffer
RST LO
The CPU is resetting the LTE module
RST HI
The CPU has completed resetting the LTE module
FAST SAMPLE, NO SLEEP
The CPU will not put the LTE module to sleep becasue of the short measurement interval

WEB DEBUG NO SLEEP, secs left = 1800
The CPU is keeping the LTE module awake because the webserver sent an SMS for a diagnostic com-
mand. After "secs left" gets to zero, the module may go back to sleep
SLEEP_RQ HI
The CPU is putting the module to sleep
LTEwakeup
The CPU is going to wake up the LTE module
GOT SMS:
The network sent an SMS wake-up and the CPU will call CheckForCommands
no modem
The CPU thinks the modem chip was removed so it’s going to skip any network operations