Get started with location

Before you begin:

• See Qualcomm Linux Flash Guide for common infrastructure setup and build workflows.
• Qualcomm Linux provides a location API test application to run test scenarios for location single shot, tracking, batching, and geofencing sessions. The location_client_api_testapp is available at the /home/root directory of the device.

The following figure shows the workflow to get started with the location API test application.

​

Verify permissions of the MPSS firmware binary files

Prerequisites:

• The MPSS firmware binary files must have the correct permissions.
• The host PC used for the builds must have the correct umask setting.

To ensure that the location service is running in modem peripheral subsystem (MPSS), do the following:

1. Ensure that the host PC used for the builds has the correct umask setting. For example:
   • Correct umask setting: 0002, 0022
   • Incorrect umask setting: 0027
2. List the files available at /usr/lib/modem_pr/so.
   mount -o remount rw /
   ls -al /usr/lib/modem_pr/so/
   -rwxr-x---. 1 root root 1547348 Mar  9  2018 544_0_0.mbn
   -rwxr-x---. 1 root root 1209088 Mar  9  2018 544_0_5.mbn
   -rwxr-x---. 1 root root 1551444 Mar  9  2018 544_0_8.mbn
   -rwxr-x---. 1 root root  454580 Mar  9  2018 645_0_9.mbn
   -rwxr-x---. 1 root root  456000 Mar  9  2018 645_0_a.mbn
   -rwxr-x---. 1 root root   22148 Mar  9  2018 828_0.mbn
   -rwxr-x---. 1 root root   22148 Mar  9  2018 829_0.mbn
   -rwxr-x---. 1 root root  414132 Mar  9  2018 849_0_0.mbn
   -rwxr-x---. 1 root root  426332 Mar  9  2018 849_0_2.mbn
   -rwxr-x---. 1 root root  448224 Mar  9  2018 850_0_0.mbn
   -rwxr-x---. 1 root root   22148 Mar  9  2018 881_0.mbn
   -rwxr-x---. 1 root root   35888 Mar  9  2018 889_0_0.mbn
   -rwxr-x---. 1 root root 1164128 Mar  9  2018 901_0_0.mbn
   -rwxr-x---. 1 root root 1231824 Mar  9  2018 901_0_1.mbn
   -rwxr-x---. 1 root root 1231840 Mar  9  2018 901_0_2.mbn
   -rwxr-x---. 1 root root  837444 Mar  9  2018 931_0_0.mbn
   -rwxr-x---. 1 root root   22148 Mar  9  2018 934_0.mbn
   
3. Provide read r permissions to these files.
   chmod 644 /usr/lib/modem_pr/so/*
   ls -al /usr/lib/modem_pr/so/*
   -rw-r--r--. 1 root root 1547348 Mar  9  2018 /usr/lib/modem_pr/so/544_0_0.mbn
   -rw-r--r--. 1 root root 1209088 Mar  9  2018 /usr/lib/modem_pr/so/544_0_5.mbn
   -rw-r--r--. 1 root root 1551444 Mar  9  2018 /usr/lib/modem_pr/so/544_0_8.mbn
   -rw-r--r--. 1 root root  454580 Mar  9  2018 /usr/lib/modem_pr/so/645_0_9.mbn
   -rw-r--r--. 1 root root  456000 Mar  9  2018 /usr/lib/modem_pr/so/645_0_a.mbn
   -rw-r--r--. 1 root root   22148 Mar  9  2018 /usr/lib/modem_pr/so/828_0.mbn
   -rw-r--r--. 1 root root   22148 Mar  9  2018 /usr/lib/modem_pr/so/829_0.mbn
   -rw-r--r--. 1 root root  414132 Mar  9  2018 /usr/lib/modem_pr/so/849_0_0.mbn
   -rw-r--r--. 1 root root  426332 Mar  9  2018 /usr/lib/modem_pr/so/849_0_2.mbn
   -rw-r--r--. 1 root root  448224 Mar  9  2018 /usr/lib/modem_pr/so/850_0_0.mbn
   -rw-r--r--. 1 root root   22148 Mar  9  2018 /usr/lib/modem_pr/so/881_0.mbn
   -rw-r--r--. 1 root root   35888 Mar  9  2018 /usr/lib/modem_pr/so/889_0_0.mbn
   -rw-r--r--. 1 root root 1164128 Mar  9  2018 /usr/lib/modem_pr/so/901_0_0.mbn
   -rw-r--r--. 1 root root 1231824 Mar  9  2018 /usr/lib/modem_pr/so/901_0_1.mbn
   -rw-r--r--. 1 root root 1231840 Mar  9  2018 /usr/lib/modem_pr/so/901_0_2.mbn
   -rw-r--r--. 1 root root  837444 Mar  9  2018 /usr/lib/modem_pr/so/931_0_0.mbn
   -rw-r--r--. 1 root root   22148 Mar  9  2018 /usr/lib/modem_pr/so/934_0.mbn
   
4. Reboot the device.

​

Set up an SSH connection

To enable SSH and connect to the device, do the following:

1. Perform the steps mentioned in Sign in using SSH to enable SSH.
2. Connect to the device.
   ssh root@<device_IP_address>
   
   For example:
   ssh root@10.92.168.185
   
3. Enter the following password to connect to SSH.
   oelinux123
   

​

Next steps

• Learn about Location APIs
• Run location test API application
• Request location sessions
• Troubleshoot location issues