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 7-1. Issuing a SET command without parameters lists the current settings.

Table 7-1. Supported Parameters for iWRAP SET Command

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

You can set your Bluetooth friendly name with this command. Others can request this name with the NAME command. You can use the following meta characters:

$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 valueYou can set the class-of-device value with this command.
BLUETOOTH LAP valueYou can set the IAC LAP value with this command. The default value is 9e8b33
BLUETOOTH ROLE role {policy {timeout}}

You can set the master/slave role switch preference with this command. Optionally, you can also set the link policy and link supervision timeout. The possible values for "role" are:

0: allow calling, do not request when answering

1: allow calling, request when answering

2: do not 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 parameters.

BLUETOOTH ENCRYPT value

This command defines whether to use Bluetooth encryption. To actually enable Bluetooth encryption, the connection must be authenticated.

0: No

1: Yes

BLUETOOTH LAP valueYou can set the IAC LAP value with this command. The default value is 9e8b33
BLUETOOTH PAGEMODE mode {page_timeout {page_repetition_mode {scan_activity_interval scan_activity_window {inquiry_activity_interval inquiry_activity_window}}}}

Pagemode defines whether 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

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

See the Bluetooth Specification for more information on these parameters.

BLUETOOTH AUTOHIDE physical logical

This command automatically hides the baseband (sets pagemode to 0) if there are more physical ACL links or logical connections than defined. Value 0 means "don't care".

Default values: 7 0

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

This command sets the 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 to remote requests with this PIN

--CALL Only if making an outgoing call

--ANSWER Only when answering to an incoming call

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

--BNEP Call type is BNEP

--L2CAP Call type is L2CAP

Default authflags are all enabled, except for --NEWPAIR.

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

With this command, you can manually set the linkkey for bdaddr.

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

BLUETOOTH PAIR bdaddrWith this command, you can manually delete the linkkey for bdaddr.
BLUETOOTH PAIREXPIRE secondsWith this command, you can set the expiration time, in seconds, for pairing information.
BLUETOOTH LISTEN channel cmd {mem {delay}}

This command adds a fork-listener for the channel. When there is an incoming RFCOMM connection to the channel, the iWRAP server handles 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, the iWRAP server waits for "delay" timerticks (50ms) before transmitting any data.

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

BLUETOOTH LISTEN channel host:portThis command adds a forward-listener for the channel. When there is an incoming RFCOMM connection to the channel, the iWRAP server will forward it to host:port by using a raw TCP/IP socket.
BLUETOOTH LISTEN psm L2CAPThis command adds an L2CAP listener for the psm.
BLUETOOTH LISTEN channelThis command removes a fork/forward/L2CAP listener from the channel/psm.
BLUETOOTH LINK mode params

With this command, you can modify the slave's powermode according to the "mode". "params" are optional and mode-dependent. The possible values for "mode" are:

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

This command sets default QoS values for a new connection. The parameters are in hex. See Bluetooth Specification for more information on params.

Defaults: 01 00000000 00000000 000061a8 ffffffff

L2CAP TIMEOUT flushto linkto

With this command, you can define the FlushTimeout and LinkTimeout for L2CAP connections. See Bluetooth Specification for more information on params.

Defaults: 65535 40000

PPP AUTHDo not 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. The iWRAP server handles this channel internally. 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 the iWRAP server should modify the defaultroute setting. There are four different modes:

0: Do no alter defaultroute

1: Set defaultroute according to the outgoing PPP

2: Set defaultroute according to the incoming PPP

3: Set defaultroute according to all PPP calls

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

This command controls incoming PAN connections. Bitmap:

1: Allow incoming PAN-PANU connections.

2: Allow incoming PAN-GN connections.

4: Allow incoming PAN-NAP connections.

8: Enable zeroconf for incoming PAN-PANU connections.

16: Enable zeroconf for outgoing PAN-PANU connections.

The default value "6" is recommended for most cases.

CONTROL AUTOEXEC cmdRun the CALL command, and rerun it when the call is disconnected. Example: SET CONTROL AUTOEXEC CALL bdaddr PAN-NAP PAN-NAP
CONTROL PASSWORDDo not require a 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 an optional --LOCAL parameter, clients connecting from localhost are accepted without a password.

CONTROL PING secondsIf this setting is enabled (seconds > 0), the iWRAP server sends a PING reply to all iWRAP clients. You have to reply to it with PONG or the connection will be closed.
CONTROL WRITETIMEOUT timeticksWith this command, you can set in timeticks (1/20s) how long iWRAP tries to write to the datasocket if it's blocked before giving up and closing the connections.
CONTROL AUTOSAVE what filenameIf this setting is enabled, the system automatically saves settings to a file when they change. See the 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 ACTIVEWith this command, you can set the powermode for a link_id to active.
link_id PARK params

With this command, you can set the 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

With this command, you can set the link's powermode to hold. Required "params" are:

avg

max min

See Bluetooth Specification for more information on params.

link_id SNIFF params

With this command, you can set the powermode for a 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

The default attempt is 1, the default timeout is 8.

See Bluetooth Specification for more information on params.

link_id QOS service_type token_rate peak_bandwidth latency delay_variation

With this command, you can set the link's QoS values. The parameters are in hex.

See Bluetooth Specification for more information on params.

link_id MASTERWith this command, you can switch the role to master.
link_id SLAVEWith this command, you can switch the 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