> ## Documentation Index
> Fetch the complete documentation index at: https://qualcomm-3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started with location

Before you begin:

* See [Qualcomm Linux Flash Guide](https://dragonwingdocs.qualcomm.com/Key-Documents/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.

<Frame caption="Qualcomm Linux Location workflow">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-3/media/Qualcomm%20Linux%20Location%20workflow.png" alt="Qualcomm Linux Location workflow.png" />
</Frame>

## **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`.
   ```text theme={null}
   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.
   ```text theme={null}
   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](https://dragonwingdocs.qualcomm.com/Key-Documents/Flash-Guide/how-to-sign-in-with-ssh) to enable SSH.
2. Connect to the device.
   ```text theme={null}
   ssh root@<device_IP_address>
   ```
   For example:
   ```text theme={null}
   ssh root@10.92.168.185
   ```
3. Enter the following password to connect to SSH.
   ```text theme={null}
   oelinux123
   ```

## **Next steps**

* [Learn about Location APIs](https://docs.qualcomm.com/doc/80-80023-25/topic/location-apis.html#location-apis)
* [Run location test API application](https://docs.qualcomm.com/doc/80-80023-25/topic/run-location-api-test-application.html#run-location-api-test-app)
* [Request location sessions](https://docs.qualcomm.com/doc/80-80023-25/topic/request-location-sessions.html#request-location-sessions)
* [Troubleshoot location issues](https://docs.qualcomm.com/doc/80-80023-25/topic/troubleshoot-location-issues.html#troubleshoot-location-issues)

<br />