SET

Name

SET -- Change parameters

Synopsis

SET [variable [value] ]

Description

The SET command allows you to alter various Bluetooth and iWRAP parameters. The supported variables are listed in Table 6-1. Issuing a SET command without parameters will list current settings.

Table 6-1. Supported Parameters for iWRAP SET Command

VariableDescription
BLUETOOTH BDADDR bdaddrOur bdaddr. This is a read-only value.
BLUETOOTH NAME friendly_name

Set your friendly name. Others can request this name with the NAME command. There are following meta characters you can use:

$S: Hardware serial number, all ten digits

$s: Hardware serial number, last three digits

$P: Server port

$p: Server port, last digit

$H: FQDN

$h: hostname

$$: $

The default value is $S_$p.

BLUETOOTH READABLE mode

If enabled, some SDP result codes will have literal values instead of numeric values.

0: No (always use numeric values)

1: Yes (literal values)

BLUETOOTH CLASS valueSet class-of-device value.
BLUETOOTH LAP valueSet IAC LAP value. Default: 9e8b33
BLUETOOTH ROLE role {policy {timeout}}

Set master/slave role switch preference, optionally also link policy and link supervision timeout. Possible values for "role" are:

0: allow calling, don't request when answering

1: allow calling, request when answering

2: don't allow calling, request when answering

The default link policy is 000f and the default link supervision timeout is 7d00. See Bluetooth Specification for more information on these.

BLUETOOTH ENCRYPT value

Whether or not to use Bluetooth encryption. To actually have Bluetooth encryption enabled, the connection has to be authenticated.

0: No

1: Yes

BLUETOOTH LAP valueSet IAC LAP value. Default: 9e8b33
BLUETOOTH PAGEMODE mode {page_timeout {page_repetition_mode {scan_activity_interval scan_activity_window {inquiry_activity_interval inquiry_activity_window}}}}

Pagemode controls whether or not other devices can find and call you. There are four different modes:

0: No inquiry, no paging

1: Inquiry, no paging

2: No inquiry, paging

3: Inquiry and paging

Page timeout is in hex and the default value is 2000. Default page repetition mode is 2 (R2). Default scan activity is interval 0800 and window 0012 (R1). Default inquiry activity is interval 0800 and window 0012 (R1).

See Bluetooth Specification for more information on these.

BLUETOOTH AUTOHIDE physical logical

Automatically hide baseband (set pagemode to 0) if there are more than physical ACL links or logical connections. Value 0 means "don't care".

Default values: 7 0

BLUETOOTH AUTH * {authflags}Remove default PIN code. If you are making an outgoing connection and the remote asks for PIN, "1234" will be sent.
BLUETOOTH AUTH * pin {authflags}Set default PIN code.
BLUETOOTH AUTH bdaddr {authflags}Remove PIN code for bdaddr.
BLUETOOTH AUTH bdaddr pin {authflags}

Set PIN code for bdaddr.

Authflags are:

--NEWPAIR Only if we do not have linkkey yet

--REQUEST Request this pin from remote, do not reply with this one

--REPLY Reply with this pin to remote requests

--CALL Only if making outgoing call

--ANSWER Only when answering to incoming call

--RFCOMM Call type is RFCOMM (includes FORK/PPP/...)

--BNEP Call type is BNEP

--L2CAP Call type is L2CAP

Default authflags are all but --NEWPAIR enabled.

There are three special pins:

- Reject without asking pin.

-- Reject on the connection open, do not check for call types.

+ Accept without asking pin.

BLUETOOTH PAIR bdaddr linkkey

Manually set linkkey for bdaddr.

Note: SET BLUETOOTH AUTH must also be set for some value to enable encrypted connections with previously stored link keys.

BLUETOOTH PAIR bdaddrManually delete linkkey for bdaddr.
BLUETOOTH PAIREXPIRE secondsSet expiration time, in seconds, for pairing information.
BLUETOOTH LISTEN channel cmd {mem {delay}}

Add fork-listener for the channel. When there is an incoming RFCOMM connection to the channel iWRAP server will handle the connection by itself by forking "cmd". At least "mem" kilobytes of free memory must be available, or the connection will be rejected. After forking iWRAP server will wait "delay" timerticks (50ms) before transmitting any data.

The client application should modify both the stdout and stdin pipes and set NOECHO, 8BIT and all other necessary modes in the very beginning. The purpose of the "delay" parameter is to give the application enough time to do this.

BLUETOOTH LISTEN channel host:portAdd forward-listener for the channel. When there is an incoming RFCOMM connection to the channel iWRAP server will forward it to host:port using raw TCP/IP socket.
BLUETOOTH LISTEN psm L2CAPAdd L2CAP-listener for the psm.
BLUETOOTH LISTEN channelRemove fork/forward/L2CAP-listener for the channel/psm.
BLUETOOTH LINK mode params

Modify slaves powermode according to "mode". "params" are optional and mode-dependent. Possible values for "mode" are 0, 1, 2, 3, 4:

0: Active.

Params: None.

1: Park: Round-robin.

Params: max_beacon min_beacon sleep_after_unpark sleep_after_round

Defaults: 254 160 5 30

Sleeps are specified by timerticks (50ms).

2: Park: Idle.

Params: max_beacon min_beacon max_active

Defaults: 512 384 6

max_active is the maximum number of active slaves.

3: Sniff: All.

Params: max_interval min_interval attempt timeout

Defaults: 640 426 1 8

4: Sniff: Idle.

Params: idle_timeout max_interval min_interval attempt timeout

Defaults: 400 640 426 1 32

idle_timeout is in timerticks (50ms).

See Bluetooth Specification for more information on params.

BLUETOOTH QOS service_type token_rate peak_bandwidth latency delay_variation

Set default QoS values for new connection. Parameters are in hex. See Bluetooth Specification for more information on params.

Defaults: 01 00000000 00000000 000061a8 ffffffff

L2CAP TIMEOUT flushto linkto

Define FlushTimeout and LinkTimeout for L2CAP connections. See Bluetooth Specification for more information on params.

Defaults: 65535 40000

PPP AUTHDon't require any PPP authentication on incoming connections.
PPP AUTH username passwordRequire specified username:password on incoming PPP connections.
PPP CHANNEL channelOur PPP (LAN Access Profile) channel. This channel will be handled internally by the iWRAP server. If you change this, remember to modify the SDP record as well. Use zero value to disable the LAN Access Profile.
PPP DEFAULTROUTE value

This setting controls whether or not the iWRAP server should modify the defaultroute setting. There are four different modes:

0: Don't alter defaultroute

1: Set defaultroute according to outgoing PPP

2: Set defaultroute according to incoming PPP

3: Set defaultroute according to all PPP calls

PPP WINHANDSHAKE secondsTimeout to wait for the Windows RAS handshake.
PPP IP ipaddr/maskSet network IP range for PPP clients.
PAN ENABLE bitmap

Controls incoming PAN connections. Bitmap:

1: Allow incoming PAN-PANU connection.

2: Allow incoming PAN-GN connection.

4: Allow incoming PAN-NAP connection.

8: Enable zeroconf for incoming PAN-PANU connections.

16: Enable zeroconf for outgoing PAN-PANU connections.

For most cases value "6" (the default) is recommended.

CONTROL AUTOEXEC cmdRun CALL command, and rerun it when call is disconnected. Example: SET CONTROL AUTOEXEC CALL bdaddr PAN-NAP PAN-NAP
CONTROL PASSWORD Don't require password from iWRAP clients
CONTROL PASSWORD pass {--LOCAL}

Enable password. iWRAP clients must send this password before giving any other command. The password is case sensitive.

With optional --LOCAL parameter clients coming from localhost are accepted without password.

CONTROL PING secondsIf enabled (seconds > 0), the iWRAP server will send a PING reply to all iWRAP clients. You have to reply to it with PONG or the connection will be closed.
CONTROL AUTOSAVE what filenameAutomatically save settings to file when they change. See SAVE command for possible what-values.
link_id MSC valueSet MSC for link_id to value. See ETSI TS 101 369 (GSM 07.10) for more information.
link_id ACTIVESet powermode for link_id to active.
link_id PARK params

Set powermode for link_id park. Required "params" are:

avg_beacon or

max_beacon min_beacon

See Bluetooth Specification for more information on params.

link_id HOLD params

Set link's powermode to hold. Required "params" are:

avg

max min

See Bluetooth Specification for more information on params.

link_id SNIFF params

Set powermode for link_id to sniff. Required "params" are:

avg_interval or

max_interval min_interval or

max_interval min_interval attempt or

max_interval min_interval attempt timeout

Default attempt is 1, default timeout is 8.

See Bluetooth Specification for more information on params.

link_id QOS service_type token_rate peak_bandwidth latency delay_variation

Set link's QoS values. Parameters are in hex.

See Bluetooth Specification for more information on params.

link_id MASTERSwitch role to master.
link_id SLAVESwitch role to slave.

Reply

When there are parameters, there is no reply.

Example


          READY.
          SET BLUETOOTH NAME Buffy
          SET BLUETOOTH PAGEMODE 3
          SET BLUETOOTH READABLE 1
          SET BLUETOOTH CLASS 020300
          SET BLUETOOTH ROLE 0
          SET BLUETOOTH ENCRYPT 0
          SET BLUETOOTH PAGEMODE 3
          SET BLUETOOTH AUTH * 1234
          SET BLUETOOTH AUTH 00:07:80:80:bf:01 4242
          SET BLUETOOTH AUTH *
          SET BLUETOOTH PAIREXPIRE 600
          SET BLUETOOTH LISTEN 1 /bin/login 200
          SET BLUETOOTH LISTEN 2 "my/own/command with parameters" 100 5
          SET BLUETOOTH LISTEN 3
          SET PPP DEFAULTROUTE 0
          SET PPP AUTH buffy willow
          SET PPP AUTH
          SET PPP CHANNEL 4
          SET PPP WINHANDSHAKE 10
          SET PPP IP 192.168.166.0/24
          SET 0 MSC 8d
          SET CONTROL PING 60
          PING
          PONG
          SET CONTROL PASSWORD
          SET CONTROL PASSWORD buffy
          <client reconnects>
          READY.
          SET
          ERROR PASSWORD NEEDED.
          <client reconnects>
          READY.
          buffy
          SET
          SET BLUETOOTH BDADDR 00:07:80:80:bf:01
          SET BLUETOOTH NAME Buffy
          SET PPP AUTH
          SET CONTROL PASSWORD buffy
          SET