# File Transfer Protocol

Source: [https://docs.qualcomm.com/doc/80-70017-13/topic/bluez-ftp.html](https://docs.qualcomm.com/doc/80-70017-13/topic/bluez-ftp.html)

FTP defines the requirements to exchange files between two Bluetooth
        devices.

To perform Bluetooth FTP functions, you must first complete the steps in the following
            procedure.

## Set up device for Bluetooth FTP functions

**Prerequisites**

- Enable SSH to access your host device. For instructions, see [Log in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#use-ssh).
- Ensure that the DUT and the remote device support the BlueZ stack. One device
                    acts as a server and another device acts as a client.
Note: To test or verify FTP
                        server functions, a test application is not required. FTP functions are
                        performed through the client connection.
- Pair the DUT and the remote device. For instructions, see [Pair with a remote Bluetooth device](https://docs.qualcomm.com/doc/80-70017-13/topic/bluez-perform-bluetooth-gap-functions.html#bluez-perform-bluetooth-gap-functions__section_h4c_1bs_lcc_navyanka_08-21-24-1205-46-507).
- Place the DUT and the remote device in the Bluetooth vicinity.

**Procedure**

1. Run the SSH in command prompt using the following command: 

        ssh root@<device_IP_address>Copy to clipboard

    **Example**

If the IP address of the device is `10.92.160.222`, run
                            the following command:

        ssh root@10.92.160.222Copy to clipboard
2. Connect to the SSH by entering the following password: 

        oelinux123Copy to clipboard
3. Open the Bluetooth test application by running the following command: 

        obexctlCopy to clipboard

                     To view OBEX functions, run the following command:

        helpCopy to clipboard

    This
                            command provides the main menu of obexctl.

    **Sample output**

sh-5.1# obexctl
        [NEW] Client /org/bluez/obex
        [obex]# help
        Menu main:
        Available commands:
        -------------------
        connect <dev> [uuid] [channel]                    Connect session
        disconnect [session]                              Disconnect session
        list                                              List available sessions
        show [session]                                    Session information
        select <session>                                  Select default session
        info <object>                                     Object information
        cancel <transfer>                                 Cancel transfer
        suspend <transfer>                                Suspend transfer
        resume <transfer>                                 Resume transfer
        send <file>                                       Send file
        pull <file>                                       Pull Vobject & stores in file
        cd <path>                                         Change current folder
        ls <options>                                      List current folder
        cp <source file> <destination file>               Copy source file to destination file
        mv <source file> <destination file>               Move source file to destination file
        rm <file>                                         Delete file
        mkdir <folder>                                    Create folder
        version                                           Display version
        quit                                              Quit program
        exit                                              Quit program
        help                                              Display help about this program
        export                                            Print environment variables
        [obex]#Copy to clipboard
4. Connect to the remote device by running the following command from the
                            `obexctl` menu:

        connect <bt_address> <profile_name>Copy to clipboard

    **Parameters**

    - `<bt_address>` is the Bluetooth address of the remote
                            device.
    - `<profile_name>` is `ftp`.

    **Example**

To connect to a remote device with `<bt_address>`
                        `E8:48:B8:C8:20:00`, run the following command:

        connect E8:48:B8:C8:20:00 ftpCopy to clipboard

    **Sample output**

[E8:48:B8:C8:20:00]# connect E8:48:B8:C8:20:00 ftp
        Attempting to connect to E8:48:B8:C8:20:00
        [NEW] Session /org/bluez/obex/client/session7
        [NEW] FileTransfer /org/bluez/obex/client/session7
        Connection successfulCopy to clipboard

    To perform FTP client functions, see [Perform Bluetooth FTP client functions](https://docs.qualcomm.com/doc/80-70017-13/topic/bluez-perform-bluetooth-ftp-server-and-client-functions.html).

- **[Perform Bluetooth FTP client functions](https://docs.qualcomm.com/doc/80-70017-13/topic/bluez-perform-bluetooth-ftp-server-and-client-functions.html)**  

You can verify Bluetooth FTP client functionality using the commands provided in the         main menu of obexctl.

**Parent Topic:** [Verify functionality of BlueZ stack](https://docs.qualcomm.com/doc/80-70017-13/topic/verify-bluetooth-functionality-of-bluez-stack.html)

Last Published: Dec 26, 2024

[Previous Topic
Perform Bluetooth OPP client functions](https://docs.qualcomm.com/bundle/publicresource/80-70017-13/topics/bluez-perform-bluetooth-opp-client-functions.md) [Next Topic
Perform Bluetooth FTP client functions](https://docs.qualcomm.com/bundle/publicresource/80-70017-13/topics/bluez-perform-bluetooth-ftp-server-and-client-functions.md)