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

Prerequisites

  • Enable SSH to access your host device. For instructions, see Sign in using 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.
    To test or verify FTP server functions, a test application isn’t required. Perform FTP functions through the client connection.
  • Pair the DUT and the remote device. For instructions, see Pair with a remote Bluetooth device.
  • Place the DUT and the remote device in the Bluetooth vicinity.

Set up the device for Bluetooth FTP functions

  1. Run the SSH in command prompt using the following command:
    ssh root@<device_IP_address>
    
    Example If the IP address of the device is 10.92.160.222, run the following command:
    ssh root@10.92.160.222
    
  2. Connect to the SSH by entering the following password:
    oelinux123
    
  3. Open the Bluetooth test application by running the following command:
    obexctl
    
    To view OBEX functions, run the following command:
    help
    
    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]#
    
  4. Connect to the remote device by running the following command from the obexctl menu:
    connect <bt_address> <profile_name>
    
    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 ftp
    
    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 successful
    
    To perform FTP client functions, see Perform Bluetooth FTP client functions.

Next steps

Perform Bluetooth FTP client functions

You can verify Bluetooth FTP client functionality using the commands provided in the main menu of obexctl. Bluetooth FTP client functions include creating a new folder and changing the current folder to navigate the file system. You can retrieve information about the current folder, copy a file to a remote device, copy a file from a remote device, copy a file within the remote device, move files between locations and delete files when they are no longer required using the FTP client functions.