| Access Server: User's and Developer's Guide | ||
|---|---|---|
| <<< Previous | Next >>> | |
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
| Variable | Description |
|---|---|
| BLUETOOTH BDADDR bdaddr | Our 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 value | You can set the class-of-device value with this command. |
| BLUETOOTH LAP value | You 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 value | You 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 bdaddr | With this command, you can manually delete the linkkey for bdaddr. |
| BLUETOOTH PAIREXPIRE seconds | With 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:port | This 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 L2CAP | This command adds an L2CAP listener for the psm. |
| BLUETOOTH LISTEN channel | This 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 AUTH | Do not require any PPP authentication on incoming connections. |
| PPP AUTH username password | Require specified username:password on incoming PPP connections. |
| PPP CHANNEL channel | Our 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 seconds | Timeout to wait for the Windows RAS handshake. |
| PPP IP ipaddr/mask | This 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 cmd | Run the CALL command, and rerun it when the call is disconnected. Example: SET CONTROL AUTOEXEC CALL bdaddr PAN-NAP PAN-NAP |
| CONTROL PASSWORD | Do 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 seconds | If 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 timeticks | With 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 filename | If 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 value | Set MSC for link_id to value. See ETSI TS 101 369 (GSM 07.10) for more information. |
| link_id ACTIVE | With 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 MASTER | With this command, you can switch the role to master. |
| link_id SLAVE | With this command, you can switch the role to slave. |
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
|
| <<< Previous | Home | Next >>> |
| QUIT | Up | SAVE |