NimbeLink Skywire LTE NL-SW-LTE-S7 Series User manual
Skywire
®
LTE NL-SW-LTE-S7xxx
Modem Family
Sending and Receiving Data Using
Socket Dials
NimbeLink Corp
Updated: February 2020
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 1
Table of Contents
Table of Contents 2
Introduction 3
Applies to the Following Part Numbers 3
Prerequisites 4
Socket Dial 5
Overview 5
Enable Hardware Flow Control 5
Setup the Session Connection 5
Set HTTP Endpoint 6
Start the Connection 6
Read Response from Server 8
Close the Session and Delete the Session 8
Working Example: Sending to Dweet.io 9
Overview 9
Get IMEI for the Thing Name 9
Enable Hardware Flow Control 9
Setup the Session Connection 9
Set HTTP Endpoint 10
Start the Connection 10
Read Response from Server 11
Close the Session and Delete the Session 12
Working Example: Reading from Dweet.io 13
Overview 13
Enable Hardware Flow Control 13
Setup the Session Connection 13
Set HTTP Endpoint 13
Start the Connection 14
Read Response from Server 15
Close the Session and Delete the Session 15
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 2
1. Introduction
1.1 Applies to the Following Part Numbers
Orderable Device
Description
Manufacturer
Carrier
Network
Type
NL-SW-LTE-S7618RD
4G LTE CAT1
NimbeLink
Verizon
LTE
NL-SW-LTE-S7648
4G LTE CAT1
NimbeLink
AT&T/T-Mobile
LTE
NL-SW-LTE-S7588-V
4G LTE CAT4 with HSPA+
Fallback
NimbeLink
Verizon
LTE
NL-SW-LTE-S7588-V-B
4G LTE CAT4 with HSPA+
Fallback
NimbeLink
Verizon
LTE
NL-SW-UAV-S7588
4G LTE CAT4 with HSPA+
Fallback
NimbeLink
Verizon
LTE
NL-SW-LTE-S7588-T
4G LTE CAT4 with HSPA+
Fallback
NimbeLink
AT&T/T-Mobile
LTE, GSM
NL-SW-LTE-S7588-T-C
4G LTE CAT4 with HSPA+
Fallback
NimbeLink
AT&T/T-Mobile
LTE, GSM
NL-SIM-COM
3FF Commercial Temp
Range SIM Card
Verizon
LTE
NL-SWDK
Skywire Development Kit
NimbeLink
TG.30.8113
Cellular Antenna
Taoglas
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 3
1.2 Prerequisites
This document assumes you have completed the initial setup
of your modem and development kit. If you have not
completed those steps, refer to the Skywire® Development
Kit User Manual and complete the modem setup before
proceeding.
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 4
2. S OCKET D IAL
2.1 Overview
Socket dialing is useful for uploading or downloading information to or from a
website or database via HTTP or other protocols. Below is an example for
connecting to a server, uploading data, downloading data, and then
disconnecting from the server using a socket dial and HTTP.
2.2 Enable Hardware Flow Control
It is recommended that you use hardware flow control on your Skywire for Socket
Dials if you are using the UART connections. To enable it, enter the following
command:
AT&K3
and the terminal should respond with:
OK
2.3 Setup the Session Connection
Next, configure the session information. Issue the following AT command:
AT+KCNXCFG=[PDP CONTEXT NUMBER],"GPRS","[YOUR APN]"
where [PDP CONTEXT NUMBER] is your PDP context and [YOUR APN] is your
APN from above. For AT&T, the PDP context is 1 . For Verizon, the PDP context
is 3 . The APN is specific to the data plan and SIM card. The APN can be
obtained from the provider of the data plan.
The terminal should respond with:
OK
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 5
Example Session Connection setup for the NL-SW-LTE-S7588-T-x,
NL-SW-LTE-S7648:
Issue the following AT Command:
AT+KCNXCFG=1,"GPRS","c2.korem2m.com"
The terminal should respond with:
OK
Example Session Connection setup for the NL-SW-LTE-S7588-V-x,
NL-SW-LTE-S7618RD:
Issue the following AT Command:
AT+KCNXCFG=3,"GPRS","nimbelink.gw12.vzwentp"
The terminal should respond with:
OK
NOTE: Verizon devices should always use context 3 and GSM devices should
use context 1 (or the context specified by their carrier).
2.4 Set HTTP Endpoint
Next, we will setup the server we are connecting to. Issue the following
command:
AT+KTCPCFG=[PDP CONTEXT NUMBER],0,"[SERVER]",[PORT]
where [PDP CONTEXT NUMBER] is your PDP context from above,
[SERVER] is your server’s address, and [PORT] is your server port number.
The terminal should respond with:
+KTCPCFG: [x]
OK
where [x] is the connection number. Note this connection number.
2.5 Start the Connection
Now, we can start the connection. To do this, enter the following command in the
terminal program:
AT+KTCPCNX=[x]
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 6
where [x] is the connection number for above.
You will receive unsolicited codes in the following format:
+KCNX_IND: a,b,c
+KCNX_IND: d,e,f
+KTCP_IND: [x],1
where a , b , c , d , e , and f are numbers indicating the connection status, and [x] is
your connection number. Note: if you are having issues with this guide, consult
the AT Command manual for this Skywire® modem for the meaning of these
numbers.
You will need to calculate the length of the message you are going to send for the
next command. For instance, for the command:
POST index.php HTTP/1.0
the length is 23, plus 4 for the necessary carriage return/line feed/carriage
return/line feed combination for a total of 27 characters.
Issue the command:
AT+KTCPSND=1,[y]
where [y] is the length of your message. The terminal will respond with:
CONNECT
At this point, when you type in the terminal, it will not echo back. Therefore, it is
recommended that you copy and paste your HTTP request type into the terminal
program.
Enter your HTTP message, followed by carriage return/line feed/carriage
return/line feed combination (on the keyboard, CTRL-M CTRL-J CTRL-M
CTRL-J).
Finally, issue the end-of-file character sequence (EOF):
+++
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 7
The EOF file must be issued within one second, start-to-finish, with at least a one
second delay before and after the +++ .
You will receive the following response from the terminal:
NO CARRIER
+KTCP_DATA: 1,[z]
where [z] is the length of the response from the server. Note this length.
Note: depending on what you're sending, the socket may close without the EOF
sequence being needed.
2.6 Read Response from Server
To read the response from the server, issue the following command:
AT+KTCPRCV=[x],[z]
where [x] is the connection number, and [z] is the length of the response from
above. The terminal will print the HTTP Response.
2.7 Close the Session and Delete the Session
To close the session, issue the following command:
AT+KTCPCLOSE=[x],1
where [x] is the connection number. The terminal should respond with:
OK
To delete the session, issue the following command:
AT+KTCPDEL=[x]
where [x] is the connection number.
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 8
3. W ORKING E XAMPLE : S ENDING TO D WEET . IO
3.1 Overview
This section covers a working example of sending information to the cloud data
site www.dweet.io . This has been tested with the NimbeLink Verizon CAT4 LTE
Skywire.
The APN used in this example is nimblink.gw12.vzwentp .
3.2 Get IMEI for the Thing Name
For dweet.io, it is recommended that you use a unique identifier for your endpoint
(called a “thing”). One good option is the Skywire’s IMEI, which is unique to each
cellular device. To get the IMEI, issue the following command:
AT+GSN
and the terminal should respond with:
111222333444555
OK
where 111222333444555 is your unique IMEI. Note this number.
3.3 Enable Hardware Flow Control
It is recommended that you use hardware flow control on your Skywire for Socket
Dials. To enable it, enter the following command:
AT&K3
and the terminal should respond with:
OK
3.4 Setup the Session Connection
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 9
Next, configure the session information. Issue the following AT command:
AT+KCNXCFG=3,"GPRS","nimblink.gw12.vzwentp"
the terminal should respond with:
OK
3.5 Set HTTP Endpoint
Next, we will setup the server we are connecting to. Issue the following
command:
AT+KTCPCFG=3,0,"www.dweet.io",80
The terminal should respond with:
+KTCPCFG: 1
OK
3.6 Start the Connection
Now, we can start the connection. To do this, enter the following command in the
terminal program:
AT+KTCPCNX=1
You will receive unsolicited codes in the following format:
+KCNX_IND: 3,4,1
+KCNX_IND: 3,4,0
+KTCP_IND: 1,1
You will need to calculate the length of the message you are going to send for the
next command. Please see www.dweet.io for information and formatting. We will
be using a HTTP POST to send data:
POST /dweet/for/111222333444555?hello=world HTTP/1.0
where 111222333444555 is your IMEI from Section 3.3. The total length of this
message is:
52 characters long for the message above, and
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 10
4 for the carriage return/line feed/carriage return/line feed ending, for:
56 characters total.
Issue the command:
AT+KTCPSND=1,56
The terminal will respond with:
CONNECT
At this point, when you type in the terminal, it will not echo back. Therefore, it is
recommended that you copy and paste your HTTP request type into the terminal
program.
Copy your HTTP message from above into the terminal program, followed by:
CTRL-M CTRL-J CTRL-M CTRL-J
and finally the EOF sequence:
+++
You will receive the following response from the terminal:
NO CARRIER
+KTCP_DATA: 1,363
Note this length of the response ( 363 ).
3.7 Read Response from Server
To read the response from the server, issue the following command:
AT+KTCPRCV=1,363
The terminal will print the HTTP Response:
CONNECT
HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Content-Type: application/json
Content-Length: 203
Date: Mon, 24 Oct 2016 20:20:27 GMT
Connection: close
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 11
{"this":"succeeded","by":"dweeting","the":"dweet","with":{"thing":"111222
333444555","created":"2016-10-24T20:20:27.618Z","content":{"hello":"worl
d"},"transaction":"131fb5df-f0d3-4ce7-a24c-df014c483d38"}}--EOF--Pattern-
-
OK
3.8 Close the Session and Delete the Session
To close the session, issue the following command:
AT+KTCPCLOSE=1,1
The terminal should respond with:
OK
To delete the session, issue the following command:
AT+KTCPDEL=1
The terminal should respond with:
OK
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 12
4. W ORKING E XAMPLE : R EADING FROM
D WEET . IO
4.1 Overview
This section covers a working example of reading information to the cloud data
site www.dweet.io . This has been tested with the NimbeLink Verizon CAT4 LTE
Skywire.
The APN used in this example is vzwinternet . This example is reading from the
above example IMEI: 111222333444555 .
4.2 Enable Hardware Flow Control
It is recommended that you use hardware flow control on your Skywire for Socket
Dials. To enable it, enter the following command:
AT&K3
and the terminal should respond with:
OK
4.3 Setup the Session Connection
Next, configure the session information. Issue the following AT command:
AT+KCNXCFG=3,"GPRS","vzwinternet"
the terminal should respond with:
OK
4.4 Set HTTP Endpoint
Next, we will setup the server we are connecting to. Issue the following
command:
AT+KTCPCFG=3,0,"www.dweet.io",80
The terminal should respond with:
+KTCPCFG: 1
OK
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 13
4.5 Start the Connection
Now, we can start the connection. To do this, enter the following command in the
terminal program:
AT+KTCPCNX=1
You will receive unsolicited codes in the following format:
+KCNX_IND: 3,4,1
+KCNX_IND: 3,4,0
+KTCP_IND: 1,1
You will need to calculate the length of the message you are going to send for the
next command. Please see www.dweet.io for information and formatting. We will
be using a HTTP POST to send data:
GET /get/latest/dweet/for/111222333444555 HTTP/1.0
where 111222333444555 is your IMEI from Section 3.3. The total length of this
message is:
50 characters long for the message above, and
4 for the carriage return/line feed/carriage return/line feed ending, for:
54 characters total.
Issue the command:
AT+KTCPSND=1,54
The terminal will respond with:
CONNECT
At this point, when you type in the terminal, it will not echo back. Therefore, it is
recommended that you copy and paste your HTTP request type into the terminal
program.
Copy your HTTP message from above into the terminal program, followed by:
CTRL-M CTRL-J CTRL-M CTRL-J
and finally the EOF sequence:
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 14
+++
You will receive the following response from the terminal:
NO CARRIER
+KTCP_DATA: 1,313
Note this length of the response ( 313 ).
4.6 Read Response from Server
To read the response from the server, issue the following command:
AT+KTCPRCV=1,313
The terminal will print the HTTP Response:
CONNECT
HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Content-Type: application/json
Content-Length: 152
Date: Mon, 24 Oct 2016 20:31:00 GMT
Connection: close
{"this":"succeeded","by":"getting","the":"dweets","with":[{"thing":"111222
333444555","created":"2016-10-24T20:20:27.618Z","content":{"hello":"worl
d"}}]}--EOF--Pattern--
OK
4.7 Close the Session and Delete the Session
To close the session, issue the following command:
AT+KTCPCLOSE=1,1
The terminal should respond with:
OK
To delete the session, issue the following command:
AT+KTCPDEL=1
The terminal should respond with:
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 15
OK
PN 30228 rev 8 © NimbeLink Corp. 2020. All rights reserved. 16
Other manuals for Skywire LTE NL-SW-LTE-S7 Series
1
This manual suits for next models
7
Table of contents
Other NimbeLink Modem manuals
NimbeLink
NimbeLink Skywire Series User manual
NimbeLink
NimbeLink Skylink User manual
NimbeLink
NimbeLink Skywire LTE CAT1 User manual
NimbeLink
NimbeLink NL-SW-LTE-S7588 User manual
NimbeLink
NimbeLink Skywire NL-LTE-TNAG User manual
NimbeLink
NimbeLink NL-SW-LTE-QGB96 User manual
NimbeLink
NimbeLink Skywire LTE CAT4 Use and care manual
NimbeLink
NimbeLink S2C Link User manual
NimbeLink
NimbeLink Skywire LTE CAT1 User manual
NimbeLink
NimbeLink Skywire LTE NL-SW-LTE-S7 Series User manual
Popular Modem manuals by other brands
Dynalink
Dynalink RTA770 Quick setup guide
TPG
TPG Netgear Nighthawk D7800 Setup guide
Industrial Grade Modems
Industrial Grade Modems Hidex II 33T user manual
MaxStream
MaxStream Xstream-PKG-U quick start guide
Sierra Wireless
Sierra Wireless USB Modem user guide
US Robotics
US Robotics 5630b installation guide