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.
Scroll to the bottom of the page, and use the link located in the LML SOFTWARE DOWNLOAD section to download the latest release.
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.
The first thing you'll see is the Port Setting screen.
The follow is an annotated image of what you'll see.
For the purposes of this tutorial, let's say that we have one phone plugged in.
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.
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).
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:
|
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.
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.
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.
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) |
When ready, click OK to save your tests. You'll begin seeing your tests listed in the left-hand Channels pane.
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.
Of interest, especially given the test you just set up, are the application layer tests, which can be found under Common > Measurement.
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.
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).
We also notice in the navigation pane that Qualcomm Chip is bolded and in black font. We can click to access information.
For example, we can click Serving Cell, which brings up information on the channel being used by the phone.
Start and End Your Test
Whenever you're ready, you can start your test by clicking the Start Measurement icon in your toolbar.
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.
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.
At any point, you can manually stop the calls.
You'll be asked to confirm that you want to stop the measurement -- if you do, click Yes to proceed.
Related Articles
How to use the multi session mapping tool in LML
This is a video tutorial covering the same topic as the article What is the multi session mapping tool The multi session mapping tool is a feature of Link Master Logging (LML) which lets you combine data from any number of log files into a single map ...UL MIMO analysis in LML and LMA
As the lifecycle of 5G marches onwards, UL MIMO will continue to show up in locations around the country, necessitating more and more testing. To facilitate this testing, there are a variety of ways to analyze UL MIMO using both Link Master Logging ...How to use gestures in LML
This is a video version of the content of this article. This article covers how to use the gestures tool in Link Master Logging (LML), including what gestures are how we create gesture scripts how we use gestures during tests Gesture Basics Gestures ...iPerf3 Server Configuration Details
To use iPerf in Link Master Logging (LML), you need to set up a compatible server. The first step of this process is to install iperf3. If you are using ubuntu, install iperf3 using the command sudo apt install iperf3 To install manually, Download ...How to setup and analyze SMS tests
This is a video tutorial covering the same topic as the article How to setup SMS test Open Link Master Logging (LML) and connect the devices you want to test. Make sure that the devices you want to text each other are on adjacent channels (Ch1->Ch2, ...