Quickstart: LML

Quickstart: LML

In this article, you'll learn how to get up and running with Link Master Logging (LML) in no time. We'll cover:

  • Downloading the latest version of LML
  • Launching LML and configuring your Port Settings
  • Configuring your test using Plan Settings
  • Using the LML interface
  • Starting and Stopping your test

Getting the Latest Version of LML

We recommend that you use the latest available version of LML. To get the latest version, navigate to the Wireless Metrix homepage.

home.png

Scroll to the bottom of the page, and use the link located in the LML SOFTWARE DOWNLOAD section to download the latest release.

download.png

Once the file has downloaded, you can launch the installation wizard. Follow the prompts to install LML to your computer.

Launch and Set Up LML

Once you've finished installing LML, you can launch it by double-clicking on the Link Master LML icon that appears on your desktop.

desktop.png

The first thing you'll see is the Port Setting screen.

port-setting.png

The follow is an annotated image of what you'll see.

port-setting-diagram.png

For the purposes of this tutorial, let's say that we have one phone plugged in. 

one-phone-launch-device-manager.png

Check That Your Computer Recognizes Your Device

We're going to launch the Device Manager using the Device Manager button on the bottom left of the Port Setting screen.

device-manager.png

Find Ports (COM & LPT) and click to expand this listing. We can see our phone listed. Make note of the port it's using (in this case, it's COM75, or 75).

ports.png

Each phone corresponds to one channel, and you can see that you can have up to twelve phones plugged in and using LML at once.

Configure Your Port Settings

For this quickstart, we'll use the following port settings.

Setting Value
Mobile Chip Select the option that corresponds with the chip located in your phone (typically Qualcomm(Auto))
Phone Set to General
DM Port The port your phone is using is located (you can check this by going to Device Manager).
DM Baud Rate Leave set to the default value of 115200
Streaming Mode Leave checked
Log masks Use the icon to the right of the currently-selected value to select masks. Generally, you'll want to make sure that everything has been chosen by clicking Select All at the bottom of the Logmask Set window. Click OK to save your changes.
ADB Ensure that you have ADB turned on and there's a value in the field
Use RMA If you're using RMA, make sure this is indicated in this field
Receive and Save TCP/IP payload Saves all head and payloads of TCP/IP packets to your logfile. The rule of thumb is as follows:
  • Check this option for FTP/iPerf tests
  • Uncheck for all other tests

 

Scanners/External Devices

If you're using any scanners or external devices (you can use up to 4), you can click the appropriate selection under Scanners to configure use of your device. For this tutorial, however, we won't be using any scanners.

scanners.png

GPS

It's important that you enable GPS. Simply click the checkbox in the left-hand selection bar, and you'll be presented with the GPS settings screen. For this tutorial, we'll be using the RMA app, so we'll set GPS interface to RMA. This pulls GPS from the phone itself.

gps.png

Save Your Port Settings

At this point, you're done making changes to your Port Settings. Click OK at the bottom left to save your changes.

Set Up Your Test

By saving your port settings, you'll be redirected to the primary LML interface. 

lml-primary.png

Notice that you have a toolbar at the top of the screen. This is where you'll find Plan Setting, which is the area used to tell LML what application layer test you're going to do. For today's tutorial, we'll be doing a Voice Call. You'll need to make changes to the following settings (all the others can be left using the default values):

Parameter Value
Dial number The phone number used for the calls
Service Option Indicate that you'll be using RMA to set your application layer call (this is the 105. ADB(RMA) - Voice with Dial Number option)
Call count The number of repetitions for this test
Traffic time (sec)  

plan-setting.png

When ready, click OK to save your tests. You'll begin seeing your tests listed in the left-hand Channels pane.

channels.png

Overview of the LML Interface

If you return to the primary LML screen, you'll see a series of commonly-used information in the left-hand navigation bar.

common-info.png

Of interest, especially given the test you just set up, are the application layer tests, which can be found under Common Measurement.

app-layer-tests.png

Clicking on the name of an item listed launches additional details. For example, let's say I want to see information about the Voice Call Monitor, which gets details on the progress of each call.

vcm.png

For additional information, you can look at the bottom left corner of your LML screen. In this example, the green M1 indicates that we're talking to the chip, and the green A tells you that you're talking to RMA. You'll also see the technology you're using (in this case WCDMA).

test-details.png

We also notice in the navigation pane that Qualcomm Chip is bolded and in black font. We can click to access information.

test-com.png

For example, we can click Serving Cell, which brings up information on the channel being used by the phone.

serving-cell.png

Start and End Your Test

Whenever you're ready, you can start your test by clicking the Start Measurement icon in your toolbar.

start-meas.png

You'll be asked for the location where you want your log files saved, as well as what you want these files named. You can also provide optional information, such as Operator, Network, Service, and Misc. All of this information is appended to your file name.

output.png

Click OK to proceed.

At this point, if you still have the Voice Call Monitor launched, you'll be able to see your test running. If you see Conversation blinking, it means that LML is in the middle of a call.

call-monitor-live.png

At any point, you can manually stop the calls.

stop-calls.png

You'll be asked to confirm that you want to stop the measurement -- if you do, click Yes to proceed.