{"id":10634,"date":"2015-12-28T15:05:31","date_gmt":"2015-12-28T21:05:31","guid":{"rendered":"http:\/\/www.multitech.net\/developer\/?page_id=10634"},"modified":"2018-04-18T11:38:19","modified_gmt":"2018-04-18T16:38:19","slug":"survey-data-file","status":"publish","type":"page","link":"https:\/\/www.multitech.net\/developer\/software\/dot-box-and-evb-software\/survey-data-file\/","title":{"rendered":"Survey Data File"},"content":{"rendered":"

Survey Single<\/strong><\/a> and Survey Sweep<\/strong><\/a> modes record the results of each operation to a Survey Data File in the\u00a0device’s non-volatile memory. The Survey Data File has a simple, human readable format. Each line contains the results of a single survey as a comma separated list. This could be an individual survey or a survey in a sweep. The format of the first item in the list\u00a0determines if the line contains the results of a single survey or a survey in a sweep.<\/p>\n

In order to view the data file, you must first go into Configuration Mode<\/strong>\u00a0<\/a>\u00a0then\u00a0issue AT+GSDF.<\/strong><\/p>\n

Fields<\/strong><\/p>\n

Each line has the fields listed below:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ID<\/strong><\/td>\nIdentifies the line as a single survey or part of a sweep and contains the corresponding index<\/td>\n<\/tr>\n
Status<\/strong><\/td>\nSpecifies if the survey was a success or failure<\/td>\n<\/tr>\n
Lock<\/strong><\/td>\nGPS lock (# of satellites)<\/td>\n<\/tr>\n
Lat<\/strong><\/td>\nGPS latitude<\/td>\n<\/tr>\n
Long<\/strong><\/td>\nGPS longitude<\/td>\n<\/tr>\n
Alt<\/strong><\/td>\nGPS altitude<\/td>\n<\/tr>\n
Time<\/strong><\/td>\nGPS timestamp (UTC format)<\/td>\n<\/tr>\n
Gateways<\/strong><\/td>\nHow many gateways heard the link check request<\/td>\n<\/tr>\n
Margin<\/strong><\/td>\nSignal margin above the demodulation floor (in dBm)<\/td>\n<\/tr>\n
RSSIdown<\/strong><\/td>\nDownlink signal strength (RSSI)<\/td>\n<\/tr>\n
SNRdown<\/strong><\/td>\nDownlink signal-to-noise ratio (SNR)<\/td>\n<\/tr>\n
DataRate<\/strong><\/td>\nTX datarate used<\/td>\n<\/tr>\n
Power<\/strong><\/td>\nTX power used<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Each line in the Survey Data File has fields in the following order. Fields are not labeled to save space.
\nA field can be empty if its data item is not available or not applicable.<\/p>\n

ID, Status, Lock, Lat, Long, Alt, Time, Gateways, Margin, RSSIdown, SNRdown, DataRate, Power<\/p>\n

Field Formats<\/strong><\/p>\n

Each field in a line of the Survey Data File is formatted as\u00a0shown below:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ID<\/strong><\/td>\nLxx for Survey Single and Sxx for Survey Sweep (max 6 characters)<\/td>\n<\/tr>\n
Status<\/strong><\/td>\nS for success, F for failure (1 character)<\/td>\n<\/tr>\n
Lock<\/strong><\/td>\nnumber of GPS satellites (max 2 characters)<\/td>\n<\/tr>\n
Lat<\/strong><\/td>\ndegrees minutes seconds E\/W (max 15 characters)<\/td>\n<\/tr>\n
Long<\/strong><\/td>\ndegrees minutes seconds N\/S (max 15 characters)<\/td>\n<\/tr>\n
Alt<\/strong><\/td>\naltitude (max 6 characters)<\/td>\n<\/tr>\n
Time<\/strong><\/td>\nhours:minutes:seconds month\/day\/year (19 characters)<\/td>\n<\/tr>\n
Gateways<\/strong><\/td>\ngateways (max 2 characters)<\/td>\n<\/tr>\n
Margin<\/strong><\/td>\nmargin (max 2 characters)<\/td>\n<\/tr>\n
RSSIdown<\/strong><\/td>\nrssi (max 3 characters)<\/td>\n<\/tr>\n
SNRdown<\/strong><\/td>\nsnr (max 5 characters)<\/td>\n<\/tr>\n
DataRate<\/strong><\/td>\ndatarate (2 characters)<\/td>\n<\/tr>\n
Power\u00a0<\/strong><\/td>\npower (max 2 characters)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The RSSIdown field does not include the “-” sign in the Survey Data File because its value is always negative.<\/p>\n

The maximum size of one line in the Survey Data File is:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ID<\/strong><\/td>\n6<\/td>\n<\/tr>\n
Status<\/strong><\/td>\n1<\/td>\n<\/tr>\n
Lock<\/strong><\/td>\n2<\/td>\n<\/tr>\n
Lat<\/strong><\/td>\n15<\/td>\n<\/tr>\n
Long<\/strong><\/td>\n15<\/td>\n<\/tr>\n
Alt<\/strong><\/td>\n6<\/td>\n<\/tr>\n
Time<\/strong><\/td>\n19<\/td>\n<\/tr>\n
Gateways<\/strong><\/td>\n2<\/td>\n<\/tr>\n
Margin<\/strong><\/td>\n2<\/td>\n<\/tr>\n
RSSIdown<\/strong><\/td>\n3<\/td>\n<\/tr>\n
SNRdown<\/strong><\/td>\n4<\/td>\n<\/tr>\n
DataRate<\/strong><\/td>\n2<\/td>\n<\/tr>\n
Power<\/strong><\/td>\n2<\/td>\n<\/tr>\n
Commas<\/strong><\/td>\n12 (12 commas to separate 13 items)<\/td>\n<\/tr>\n
+ Newline<\/strong><\/td>\n1<\/td>\n<\/tr>\n
————<\/td>\n——————————————-<\/td>\n<\/tr>\n
Total<\/strong><\/td>\n92 bytes<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The\u00a0device’s non-volatile memory should be capable of storing over 20,000 full lines of survey data before the
\nmemory runs out of space. This result was found using the strategy described below.<\/p>\n

Start with 2 MB of space
\n2 * 1024 * 1024 = 2,097,152 bytes
\nSubtract 10% for filesystem overhead and LoRa configuration
\n2,097,152 * 0.9 = 1,887,436.8 bytes
\nDivide by number of characters per line
\n1,887,436.8 \/ 92 = 20,515.6 lines<\/p>\n

Examples<\/strong><\/p>\n

The following is an example of a successful Survey Single without GPS lock in the Survey Data File.<\/p>\n

L21,S,0,,,,,1,11,82,8.2,9,20<\/p>\n

The following is an example of a successful Survey Single with GPS lock in the Survey Data File.<\/p>\n

L23,S,10,45 5 58.542 N,93 11 46.980 W,239,21:44:16 12\/14\/2015,1,12,46,8.5,9,20<\/p>\n

The following is an example of a failed Survey Single without GPS lock in the Survey Data File.<\/p>\n

L11,F,0,,,,,,,,,7,11<\/p>\n

The following is an example of a failed Survey Single with GPS lock in the Survey Data File.<\/p>\n

L22,F,10,45 5 58.542 N,93 11 46.980 W,239,21:44:11 12\/14\/2015,,,,,9,20<\/p>\n

The following is an example of a Survey Sweep in the Survey Data File. Note that the 1st, 8th, and 9th lines are
\nfailed surveys which still contain GPS data. The 10th line was a successful survey without a GPS lock.<\/p>\n

S1,F,11,45 5 59.994 N,93 11 31.542 W,29,19:47:57 12\/11\/2015,,,,,7,2
\nS1,S,11,45 5 59.994 N,93 11 31.542 W,29,19:48:01 12\/11\/2015,2,8,20,7.2,7,8
\nS1,S,11,45 5 59.994 N,93 11 31.542 W,29,19:48:05 12\/11\/2015,1,10,20,7.2,7,14
\nS1,S,11,45 5 59.994 N,93 11 31.542 W,29,19:48:09 12\/11\/2015,1,9,22,7.0,7,20
\nS1,S,11,45 5 59.994 N,93 11 31.542 W,29,19:48:13 12\/11\/2015,2,11,25,7.2,8,2
\nS1,S,11,45 5 59.994 N,93 11 31.542 W,29,19:48:17 12\/11\/2015,2,9,26,7.7,8,8
\nS1,S,11,45 5 59.994 N,93 11 31.542 W,29,19:48:21 12\/11\/2015,1,11,24,3.0,8,14
\nS1,F,11,45 5 59.994 N,93 11 31.542 W,29,19:48:26 12\/11\/2015,,,,,8,20
\nS1,F,11,45 5 59.994 N,93 11 31.542 W,29,19:48:39 12\/11\/2015,,,,,9,2
\nS1,S,0,,,,,2,11,27,7.7,9,8
\nS1,S,11,45 5 59.268 N,93 11 37.602 W,29,19:48:47 12\/11\/2015,2,13,26,7.2,9,14
\nS1,S,11,45 5 59.178 N,93 11 38.490 W,103,19:48:51 12\/11\/2015,1,11,28,8.5,9,20
\nS1,S,11,45 5 59.022 N,93 11 39.930 W,103,19:48:55 12\/11\/2015,2,9,27,7.0,10,2
\nS1,S,11,45 5 59.022 N,93 11 40.038 W,139,19:49:00 12\/11\/2015,2,9,27,7.2,10,8
\nS1,S,11,45 5 59.022 N,93 11 40.080 W,139,19:49:04 12\/11\/2015,2,9,27,7.7,10,14
\nS1,S,11,45 5 59.022 N,93 11 40.116 W,139,19:49:08 12\/11\/2015,1,8,27,8.2,10,20<\/p>\n","protected":false},"excerpt":{"rendered":"

Survey Single and Survey Sweep modes record the results of each operation to a Survey Data File in the\u00a0device’s non-volatile memory. The Survey Data File has a simple, human readable format. Each line contains the results of a single survey as a comma separated list. This could be an individual survey or a survey in […]<\/p>\n","protected":false},"author":1478,"featured_media":0,"parent":10894,"menu_order":9,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"footnotes":""},"class_list":["post-10634","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/pages\/10634","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/users\/1478"}],"replies":[{"embeddable":true,"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/comments?post=10634"}],"version-history":[{"count":27,"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/pages\/10634\/revisions"}],"predecessor-version":[{"id":23162,"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/pages\/10634\/revisions\/23162"}],"up":[{"embeddable":true,"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/pages\/10894"}],"wp:attachment":[{"href":"https:\/\/www.multitech.net\/developer\/wp-json\/wp\/v2\/media?parent=10634"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}