1 # btservices.cif

     2 # 

     3 # Copyright (c) 2010 Accenture. All rights reserved.

     4 # This component and the accompanying materials are made available

     5 # under the terms of the "Eclipse Public License v1.0"

     6 # which accompanies this distribution, and is available

     7 # at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 # 

     9 # Initial Contributors:

    10 # Accenture - Initial contribution

    11 #

    12 

    13 ==name btservices

    14 

    15 ==short-description

    16 

    17 Discovers services available on Bluetooth enabled devices in the vicinity.

    18 

    19 ==argument enum command optional

    20 

    21 The command to execute. Defaults to C<devices>.

    22 

    23 ==enum-value devices

    24 

    25 Scan for devices.

    26 

    27 ==enum-value services

    28 

    29 Search for a service. Use C<-a> to specify a device BT address and optionally C<-u> to specify a UUID filter.

    30 

    31 ==enum-value attributes

    32 

    33 Search for an attribute. Use C<-a> to specify a device BT address and C<-r> to specify a service handle (as given by the C<services> command).

    34 

    35 ==enum-value local

    36 

    37 Display information about the local device.

    38 

    39 ==enum-value uuids

    40 

    41 Print a list of UUID strings and their values.

    42 

    43 ==enum-value status

    44 

    45 Prints out the current status of the Bluetooth radio (on or off). (Only available on S60 5th edition or later)

    46 

    47 ==enum-value enable

    48 

    49 Attempts to turn on Bluetooth. (Only available on S60 5th edition or later)

    50 

    51 ==enum-value disable

    52 

    53 Attempts to turn off Bluetooth. (Only available on S60 5th edition or later)

    54 

    55 ==option string a address

    56 

    57 The BT address to use with either the C<services> or C<attributes> commands.

    58 

    59 ==option string r record

    60 

    61 The service record handle to use with the C<attribute> command.

    62 

    63 ==option string u uuid

    64 

    65 Specify a UUID filter when searching the service records. Can be either in name or in hex format e.g. 0x0100 or L2CAP. Use the C<uuid> command to obtain a list of UUID values and names.

    66 

    67 ==option bool v verbose multiple

    68 

    69 Verbose output. Specify twice (i.e. C<-vv>) for even more detail.

    70 

    71 ==copyright

    72 

    73 Copyright (c) 2009-2010 Accenture. All rights reserved.

    74