LTE Link Monitor. User Guide. v _015 v0.7 /

Size: px

Start display at page:

Download "LTE Link Monitor. User Guide. v _015 v0.7 /"

Moris Randall
5 years ago
Views:

1 LTE Link Monitor User Guide v _015 v0.7 /

2 Contents Revision history iii 1 Introduction Installing LTE Link Monitor LTE Link Monitor functionality Sample code for locationapi.org Legal notices _015 v0.7 ii

3 Revision history Date Version Description December Updated LTE Link Monitor functionality on page 6 to reflect the Periodic signal quality requests option. October First release 4399_015 v0.7 iii

4 1 Introduction LTE Link Monitor is a modem client application that monitors the modem/link status and activity using AT commands. LTE Link Monitor is implemented as an app for the nrf Connect for Desktop application. Currently, the nrf9160 DK (PCA10090) is the only supported device. 4399_015 v0.7 4

5 2 Installing LTE Link Monitor LTE Link Monitor is available as an app for nrf Connect. To use LTE Link Monitor, you must first install nrf Connect version or newer. 1. Open nrf Connect. 2. Go to Add/remove apps and click Install next to the LTE Link Monitor app. You can now start the app from the Launch app screen. For easy access, you can create a desktop shortcut to LTE Link Monitor by clicking the arrow button. 4399_015 v0.7 5

6 3 LTE Link Monitor functionality LTE Link Monitor displays information about connected devices and shows, for example, the signal quality, network information, and the AT communication with the modem. The following sections describe the different parts of the user interface of LTE Link Monitor. Top bar Click the icon to open a drop-down menu that gives access to the nrf Desktop Launcher window and an About dialog where you can check the version and installation information. The device selector drop-down menu displays all supported devices. When you select a device, you can see live information about the current session in the main view. Alternatively, you can open a log file to load the log contents of a previous session. The log file contains the complete AT communication with the modem. Note that you cannot open a log file when a device connection is open. Use the Chart and Terminal buttons to switch the main view content. Main view The main view can either display the Chart view or the Terminal view. You can switch between these views using the buttons in the top bar. Chart 4399_015 v0.7 6

LTE Link Monitor functionality Figure 1: LTE Link Monitor Chart view You can hover over the events in the chart to display the list of events under the mouse cursor.

7 LTE Link Monitor functionality Figure 1: LTE Link Monitor Chart view You can hover over the events in the chart to display the list of events under the mouse cursor. To navigate the chart, drag it horizontally. You can zoom in or out using the mouse wheel or the right mouse button. Notice that the chart stops displaying the latest incoming events when you zoom or drag. Click Live Scroll under the chart to make sure incoming events are displayed. The time-based chart displays signal quality and modem events. The signal quality reported by the modem is the received signal reference power (RSRP) in dbm, displayed on the left axis. The modem events are unsolicited result codes and responses to different commands, separated into different categories displayed on the right axis. Terminal 4399_015 v0.7 7

8 LTE Link Monitor functionality Figure 2: LTE Link Monitor Terminal view The terminal displays the AT communication with the modem. Colors are used to differentiate between transmitted commands (yellow), received responses (white), and received unsolicited results (light blue). The abbreviations of control characters are also displayed in gray. They are, however, not selectable. The terminal's auto-scrolling behavior can be toggled in the Settings section of the side panel. You can enter text in the command line located directly below the terminal and then send it to the modem by pressing Enter or clicking Send. The CR LF line ending is automatically appended to the line. The ten buttons below the command line are macro buttons which can be configured by dragging and dropping text onto them. Clicking these buttons sends their stored content to the modem. Side panel The side panel displays information related to the modem, network, and mobile cell. The first line of indicators helps to visualize the connection state by displaying the indicators in different colors. Hovering over these indicators lists the possible colors and their meanings. The modem state is listed in the next section followed by the network and the packet domain group. In the network group, only the connected network is listed automatically. Click Search networks to display a complete list of available networks. Be aware that this is a long and blocking operation. If the connected cell can be resolved by the locationapi.org service, you can click Show serving station location to open a small map with the range of the serving station. 4399_015 v0.7 8

9 LTE Link Monitor functionality Settings The Settings section of the side panel offers the following options: Automatic requests: Toggles the LTE Link Monitor's internal logic which is required to gather information listed in the side panel. Note: Any information displayed in LTE Link Monitor is an interpretation of the responses from the modem. Therefore, turning off automatic requests affects the validity of the information. Periodic signal quality requests: Enable this option to send a CESQ command in a specified interval. Requires Automatic requests to be enabled. Terminal auto scroll LocationAPI token: Used for accessing the online service. The initial token belongs to a free limited account so it is recommended to create an account and change the token by following the link in the user interface. Log view The log displays info and error level messages from the application. Click Open to view the full log file. 4399_015 v0.7 9

10 4 Sample code for locationapi.org The provided code snippet demonstrates the usage of the locationapi.org service. Note: This code only handles expected successful responses. The location request can be further enhanced for better accuracy by specifying neighboring cells, for which you can directly use the response to the AT%NBRGRSRP command. const SerialPort = require('serialport'); const fetch = require('node-fetch'); const port = new SerialPort('COM8', { autoopen: false, baudrate: , databits: 8, parity: 'none', stopbits: 1, }); let mcc; let mnc; // open the port and execute an AT+COPS? request new Promise(resolve => port.open(resolve)).then(() => new Promise(resolve => { port.once('data', buf => resolve(buf.tostring())).write('at+cops?\r'); })) // pick the 3rd argument of COPS response.then(plmn => (/COPS: [0-2],[0-2],"([^"]*)"/.exec(plmn).pop())).then(mccmnc => { mcc = parseint(mccmnc.substring(0, 3), 10); mnc = parseint(mccmnc.substring(3), 10); }) // execute an AT+CEREG? request.then(() => new Promise(resolve => { port.once('data', buf => resolve(buf.tostring())).write('at+cereg?\r'); })) // pick the 3rd and 4th field from the response.then(registration => (/CEREG: \d,\d+,"([0-9a-f]{1,4})","([0-9a-f] {1,8})"/.exec(registration).slice(-2))).then(([tac, ci]) => ({ lac: parseint(tac, 16), cid: parseint(ci, 16), })) // construct the locationapi request 4399_015 v0.7 10

11 Sample code for locationapi.org.then(({ lac, cid }) => ({ token: 'pk.c748a4d4e6ce0bfd5491dcfb01ba9b10', radio: 'lte', mcc, mnc, cells: [{ lac, cid }], address: 1, })).then(body => console.log(body) body) // fetch the result.then(body => fetch(' { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body), })).then(response => response.json()).then(console.log).then(() => process.exit()); 4399_015 v0.7 11

12 Legal notices By using this documentation you agree to our terms and conditions of use. Nordic Semiconductor may change these terms and conditions at any time without notice. Liability disclaimer Nordic Semiconductor ASA reserves the right to make changes without further notice to the product to improve reliability, function, or design. Nordic Semiconductor ASA does not assume any liability arising out of the application or use of any product or circuits described herein. Nordic Semiconductor ASA does not give any representations or warranties, expressed or implied, as to the accuracy or completeness of such information and shall have no liability for the consequences of use of such information. If there are any discrepancies, ambiguities or conflicts in Nordic Semiconductor s documentation, the Product Specification prevails. Nordic Semiconductor ASA reserves the right to make corrections, enhancements, and other changes to this document without notice. Life support applications Nordic Semiconductor products are not designed for use in life support appliances, devices, or systems where malfunction of these products can reasonably be expected to result in personal injury. Nordic Semiconductor ASA customers using or selling these products for use in such applications do so at their own risk and agree to fully indemnify Nordic Semiconductor ASA for any damages resulting from such improper use or sale. RoHS and REACH statement Nordic Semiconductor products meet the requirements of Directive 2011/65/EU of the European Parliament and of the Council on the Restriction of Hazardous Substances (RoHS 2) and the requirements of the REACH regulation (EC 1907/2006) on Registration, Evaluation, Authorization and Restriction of Chemicals. The SVHC (Substances of Very High Concern) candidate list is continually being updated. Complete hazardous substance reports, material composition reports and latest version of Nordic's REACH statement can be found on our website Trademarks All trademarks, service marks, trade names, product names, and logos appearing in this documentation are the property of their respective owners. Copyright notice 2018 Nordic Semiconductor ASA. All rights are reserved. Reproduction in whole or in part is prohibited without the prior written permission of the copyright holder. 4399_015 v0.7 12

nrf Connect Bluetooth low energy

nrf Connect Bluetooth low energy User Guide v2.2 4399_003 v2.2 / 2018-06-21 Contents Revision history.................................. iii 1 nrf Connect Bluetooth low energy...................... 4 2