Able Systems BT001 Bluetooth Module User Manual BlueRS BD Manual v1 06
Able Systems Limited Bluetooth Module BlueRS BD Manual v1 06
UserMan
1.06/Nov 2004 BlueRS+BD Manual BlueRS+BD Bluetooth Serial Adapter Firmware User Manual Version Date 1.06 Nov 2004 © Stollmann Entwicklungs- und Vertriebs-GmbH BlueRS+BD Manual 1.06/Nov 2004 Exclusion of Liability The present manual by Stollmann Entwicklungs- und Vertriebs-GmbH (hereinafter referred to as Stollmann) reflects the present state of the art of the products described therein. We have endeavored to give a description that is as complete and clear as possible in order to make work with our products as easy as possible for you. All the same, the manual may contain technical inaccuracies and typing errors. As a result of the rapid advance in the art, we must also reserve the right to incorporate technical alterations and developments without separate advance notice. That is why Stollmann does not give any warranty for the contents of the manual and for its continuing applicability. Nor is Stollmann liable for any loss of information or any incorrect use of information that might result from consultation of the manual. Particularly, Stollmann is not liable for damage, nor indirect damage (including damage caused by financial loss, delays affecting business transactions or interruptions of business and similar consequences), arising from the use or improper use of this manual, not even in the case where it was pointed out to Stollmann or an agent of Stollmann that such damage might be sustained. This does not, of course, affect our legal liability for damages based on any intent or gross negligence. With respect to the data given in this manual, Stollmann does not warrant the nonexistence of industrial property rights (trademarks, patents, utility models, etc.). Nor are trade names, brand names, company names and product names in general use but are subject to the relevant trademark, patent, utility model and registered design rights. The information must neither in whole nor even in part be copied, translated, reproduced or in any other way transferred to or stored on any electronic medium or other machine. The purchase and use of software are governed by the General Conditions of Delivery and Payment as well as the Terms of License of Stollmann. If any of the provisions is a registered liability or on use are or become ineffective for statutory reasons, this will not affect the other provisions. Trademark of Stollmann Entwicklungs- und Vertriebs-GmbH. 1.06/Nov 2004 BlueRS+BD Manual Table of contents Introduction ..................................................................................................... 4 1.1 Product description ......................................................................................... 4 Operation Modes of BlueRS+BD Software ..................................................... 4 Using BlueRS+BD Software ........................................................................... 5 3.1 Automatic connection establishment............................................................... 6 3.2 AT command set for BlueRS+BD ................................................................... 7 3.2.1 Bluetooth specific AT commands ........................................................... 14 3.2.2 AT command S register set .................................................................... 19 3.2.3 AT result codes ...................................................................................... 19 3.3 Table for coding Bluetooth services .............................................................. 20 BlueRS+BD Configurator command set ....................................................... 21 4.1 Configuring BlueRS+BD after power on........................................................ 21 4.2 Configuring BlueRS+BD with AT commands ................................................ 22 4.3 Remote configuration using the BlueRS+BD Configurator commands ......... 22 4.4 List of BlueRS+BD Configurator commands ................................................. 23 Diagnostic and error messages .................................................................... 39 5.1 Error messages from AT command set ........................................................ 39 5.2 Bluetooth error codes.................................................................................... 39 Regulatory Information.................................................................................. 42 6.1 Copyright and Trademark Notices ................................................................ 42 History........................................................................................................... 43 BlueRS+BD Manual 1.06/Nov 2004 1 Introduction We are very pleased to see that you have bought a Stollmann product and would like to express our appreciation. This documentation is valid for BlueRS+BD Bluetooth Serial Port Profile Software, version V1.1.025 or later. 1.1 Product description BlueRS+BD is a Bluetooth Serial Port Profile Software for use with Zeevo ZV 4002 and ZV 4301 chip and implements the following functions: • Connect devices with a serial port to any Bluetooth link. It gives access to other devices situated in the same Bluetooth area (piconet). • Data transmission with rates from 300 up to 230400 baud. • The connected serial device can drive BlueRS+BD software by using asynchronous AT commands automatic connection setup accept incoming Bluetooth links. • Configuration of the BlueRS+BD software can be performed via the serial interface (local configuration) or via the Bluetooth link (remote configuration). The following profiles are supported: • One serial profile channel for transparent data communication via the Bluetooth link. • A second serial profile channel for management access from another Bluetooth device using a Bluetooth link. 2 Operation Modes of BlueRS+BD Software The BlueRS+BD software supports two different modes: • Running on a Bluetooth module with a Stollmann Bluetooth address enables full functionality. • Running on a Bluetooth module with a Bluetooth address other than a Stollmann Bluetooth address the duration of the Bluetooth links is limited to about 20 minutes. Afterwards the connection is terminated automatically. To get Stollmann Bluetooth addresses for your product please contact Stollmann. 1.06/Nov 2004 BlueRS+BD Manual 3 Using BlueRS+BD Software Before using the BlueRS+BD the address of a Bluetooth partner device has to be selected - if not predefined within the hardware - that shall be the communication partner in the Bluetooth link. Compatible devices can be scanned using the configuration command "binq". The found devices are listed in "binqlist". One Bluetooth device from that list has to be selected. If you are using an automatic connecting mode the Bluetooth address has to be entered and stored using the configuration command "brad" (see BlueRS+BD Configurator activation on page 21). In addition to the selected Bluetooth address a PIN may be setup, if a restricted mode connection has to be setup (command "bpin" and "bsecout"/"bsecin"). This PIN has to be identical to the PIN used in the remote Bluetooth device. You can select different operation modes for the BlueRS+BD. These operating modes are used to control Bluetooth links and to configure the BlueRS+BD software. Supported operating modes for Bluetooth link control: • Automatic connecting after Power up. • Automatic connecting controlled by control line DTR. • Automatic connecting on activity on the serial input. • Automatic accepting of incoming connections. • Connection control using the asynchronous mode for devices that need the AT command set. You can configure BlueRS+BD software in the following ways: • By using BlueRS+BD Configuration commands entered by a locally connected PC. • By using the AT command set entered by a locally connected PC. • By using BlueRS+BD Configuration commands entered via the Bluetooth link (remote configuration). BlueRS+BD Manual 1.06/Nov 2004 3.1 Automatic connection establishment Automatic connection establishment is available in the following modes: • An automatic connection will be initiated when control line DTR is on. • An automatic connection will be initiated when a character is received on the serial port. • An automatic connection will be initiated independent of any status line – automatically after power up and initialization. • No connection establishment initiated by this module. Bluetooth connection requests from other Bluetooth devices will be automatically accepted (if compatible). To enable automatic call you have to set the BlueRS+BD Configuration parameter "cmds" to 6, 7, 8 or 12 (see below). cmds function Automatic connection establishment when DTR is ON Automatic connection establishment on any character received on serial port Automatic connection establishment independent of any status line 12 No connection establishment initiated by this module An established connection will be indicated by a status line (default: DCD). See also configuration commands "cdcd" and "cdtr". If a connection cannot be established successfully, an automatic retry will be started. The duration of trying to establish the connection and the pause for next retry can be configured. The Bluetooth devices to be accessed are taken from the parameter "brad", “brad2” and “brad3”, they have to be set up to the Bluetooth device addresses of the remote Bluetooth devices. Additionally the server channel has to be set up if not fitting to the default (1), with the parameter brsch or using the address extension syntax for the address. cato n call abort of a not successful call after n seconds. n = {3..255}, default: 15 seconds. capa n Hint: call pause for n seconds before next call attempt. n = {0..255}, default: 3 seconds. The configuration command "idle" can be used, to automatically disconnect after a predefined time without data transmission. 1.06/Nov 2004 BlueRS+BD Manual 3.2 AT command set for BlueRS+BD All parameters can be changed by using an extended AT command set described in this chapter. Please check if the factory setting will fit with your environment. The factory setting is described (highlighted) in the parameter list below. If you require a configuration different from the factory default setting, please perform the following steps: • • • • • Plug the hardware to a COM-Port of a PC. Power up the hardware. Start a terminal emulation on the PC; please verify that the baudrate setting of the terminal emulation fits the value configured within BlueRS+BD. Set up the parameter within BlueRS+BD from the terminal emulation and save the parameter using the AT command set. Example: To change the access mode on incoming connections to "bond unknown" please enter the following commands: AT**BSECIN=1<↵> (perform authentication on connection setup) AT&W<↵> (store the new configuration) Leave your terminal emulation and start your application program. With the exception of the command A/ (Repeat command) all commands begin with the prefix AT and are terminated with <↵> ("Return"). Corrections within a command line are done with. A command line has a maximum length of 80 characters. The command line is automatically cancelled by longer input. Blanks are ignored; the command line input is not case sensitive. The parameter settings of BlueRS+BD obtained when using the AT commands can be permanently stored (AT&W) and are not lost by resetting or by leaving the AT command mode. To enter the AT command mode during an active data connection you must use the following sequence ("Escape sequence"): At least 1 sec pause <+><+><+> 1 sec pause. The interval between each two plus signs must not exceed 1 sec. The escape sequence is transmitted transparently to the remote device. All commands and parameters marked as [deprecated] should not be used as on new implementations they might no longer be supported. BlueRS+BD Manual 1.06/Nov 2004 Supported commands: A/ Repeat last command line This command repeats the commands of the last entered command line. Note: No prefix AT is required. A/ Accept incoming call Using this command you can accept an incoming call, if automatic call acceptance is not set (Register S0 = 0). An incoming call is always displayed by the message “RING“ or the code “2“, also if automatic call acceptance is selected. Must be the last command in an AT command line. CONF Enter BlueRS+BD Configurator Enters directly into the BlueRS+BD Configurator, the configuration prompt "#" will be displayed. Leave the BlueRS+BD Configurator with the command "quit" (or “exit” or “go”). ATCONF &C DCD control This command selects the behavior of the DCD control line from the BlueRS+BD. AT&C BlueRS+BD control line DCD is always ON AT&C1 DCD ON indicates Bluetooth connection is established (default) AT&C2 DCD line follows DTR AT&C4 DCD follows remote DCD 1.06/Nov 2004 BlueRS+BD Manual Initiate Bluetooth link This command addresses a Bluetooth device directly through its address or name. If a connection to a Bluetooth device requiring the restricted mode the PIN has to be set up using command AT**BPIN. ATD [,cn]|dx,sx,uy brad: called Bluetooth remote device address (12 digits) cn: Server channel for the requested service on remote device dx: references called Bluetooth remote device number in binqlist (d01...d16) sx: reference to remote device service number in binqlist uy: with y=UUID of a service, if the remote device presents more than one service with the same UUID the last one is selected (for a list of valid UUIDs see chapter 3.3 "Table for coding Bluetooth services") This command must be the last command in an AT command line. Any character input while the BlueRS+BD is dialling will cancel the dialling procedure. Examples: ATD 0080371443AB Connect to Bluetooth device 0080371443AB ATD d1 Connect to 1st Bluetooth device in binqlist (server channel number defined in brsch) ATD d3,u1101 Connect to Bluetooth device to service with UUID1101 (serial port) of device d3 The characters W, >, P, T, ',' , ';', /, R, ^, !, L, @, (, ), '-', ' ' (lower and upper case) are ignored within an dialstring. Note: The remote Bluetooth device has to be determined before issuing this link request. This can be done in the following ways: - Get it manually by reading from the sticker of the remote Bluetooth device. - Inquire the address and services by using the commands AT**BINQ=1 and AT**BINQLIST - Give BlueRS+BD about 10 seconds after reset to initialize before issuing the first command. BlueRS+BD Manual &D 1.06/Nov 2004 DTR control This command selects the behavior of BlueRS+BD, when the DTE control line DTR changes from ON to OFF. AT&D DTE control line DTR setting is ignored AT&D2 DTE control line DTR is evaluated: dropping the DTR line by the DTE will disconnect an existing Bluetooth link. An incoming call will be accepted only with DTR active. AT&D4 DTE control line DTR is partly evaluated: - dropping the DTR line by the DTE will disconnect an existing Bluetooth link (default). - An incoming call will be accepted independent of DTR status. Local echo This command selects the local echo in command mode. ATE No local echo ATE1 Local echo on in command phase (default) &F Load factory defaults Factory default will be loaded. (For storing in non volatile memory please use the command AT&W). AT&F setup all parameter concerning data port. AT&F1 setup all parameter including Bluetooth specifics and passwords. Disconnect This command disconnects existing Bluetooth connection, after issuing the escape sequence (see page 7). ATH 1.06/Nov 2004 BlueRS+BD Manual Display version information Displays different information about version number and settings: ATI Returns the "Modem"-type; name of the hardware adapter ATI1 Returns "0" ATI2 Returns "OK" ATI3 Returns version string: "V1.xyz" ATI4 Returns manufacturers name: "Stollmann E+V GmbH" ATI5 Returns "OK" ATI6 Returns copyright string: "(c) Copyright Stollmann GmbH" ATI7 Returns "OK" ATI8 Returns "ERROR" ATI9 Returns "OK" (Plug&Play ID-Request not supported) ATI77 Returns Bootloader version string ATI99 Returns software creation date &K Flow control This command selects the flow control behavior of the BlueRS+BD while in data communication phase. AT&K No local flow control between the DTE and BlueRS+BD is used AT&K3 Local flow control is set to hardware handshake RTS/CTS (default) Return to online state If BlueRS+BD is in command mode after issuing an escape sequence out of an existing connection, ATO brings BlueRS+BD back to data phase. It must be the last command in AT command line. ATO Suppress results With this command result codes or messages can be suppressed. ATQ Returns status - codes after command input (default) ATQ1 No result codes are returned &R CTS control This command selects the behavior of the CTS control line of the hardware controlled by BlueRS+BD. AT&R Control line CTS is following all changes of RTS AT&R1 CTS is always ON (default) BlueRS+BD Manual 1.06/Nov 2004 Display and set internal S register ATSnn? ATSnn=xxx &S Show actual values (decimal) of selected register nn Set selected register nn to the decimal value xxx. See S register definitions on page 19. DSR control This command selects the behavior of the DSR control line of the hardware controlled by BlueRS+BD. AT&S Control line DSR is always ON (default) AT&S1 DSR ON indicates Bluetooth link is established Result format ATV ATV1 &V Display configuration AT&V AT&V1 Displays the actual configuration of AT command setting Displays the actual configuration of extended AT command setting Extended result codes ATW ATW1 &W Result is presented as numbers (followed by <↵>) Result is presented as text (default) Result is presented without extended result codes. Result is presented with extended result codes, Result messages include error causes. Store active configuration The active configuration will be stored in non volatile memory. AT&W Load stored settings The active configuration will be reset to the stored configuration. Must be the last command in an AT command line. ATZ 1.06/Nov 2004 **DBITS BlueRS+BD Manual Number of data bits x asynchronous chars (7,8) Number of data bits x for asynchronous character (7, default: 8). AT**DBITS=x **PRTY Set parity of asynchronous characters This command selects the parity for asynchronous characters. 0: no parity; 1: even parity; 2: odd parity AT**PRTY=0 No parity (default) AT**PRTY=1 Odd parity AT**PRTY=2 Even parity BlueRS+BD Manual 1.06/Nov 2004 3.2.1 Bluetooth specific AT commands **BINQ [mode] Search Bluetooth devices With this request the automatic search and service of all discoverable Bluetooth devices will be initiated. As a result the creation of the list binqlist will be initiated. The list can be read out using the command at**binqlist. If the inquiry has not been terminated while issuing the command at**binqlist, the BlueRS+BD will return "inquiry active". The entries contain the Bluetooth device addresses, the Bluetooth device names and available services (profiles). The creation of this list may take up to 20 seconds due to the reaction time of the accessible Bluetooth devices; a maximum of 16 Bluetooth devices can be listed. When issuing the command "at**binq 1" the command terminates with “OK” when the search process is finished. During the search process BlueRS+BD reports the device and service information. Note: The performance of the command is influenced by the parameters BINQND and BINQSD. Example: **BINQLIST at**binq Response: request Bluetooth devices with name and service OK Show inquired Bluetooth devices With this request the list of found Bluetooth devices will be returned, the entries show the Bluetooth device address and the Bluetooth device name requested by the command at**binq. For every Bluetooth device in addition the available services (profiles) will be shown (for a list of valid services see chapter 3.3 "Table for coding Bluetooth services"). These entries can be accessed by the selector d1...dn to address the Bluetooth device and the selectors s1...sn to address the Bluetooth devices service channel. A maximum of 16 Bluetooth devices will be displayed. 1.06/Nov 2004 Example: BlueRS+BD Manual at**binqlist Responses: d01: s01: s02: d02: s01: ... OK or inquiry active if the search initiated by at**binq OK is still active list empty if no Bluetooth device found OK or bradr cod brname service server channel bsname **BINQDEL ,[sy] found Bluetooth remote device address (12 digits) class of device found Bluetooth remote device name coding of service type used channel number for service type used service name for service type Delete remote device or service To delete a remote device or service from the binqlist within BlueRS+BD, issue the command "AT**BINQDEL". Example: at**binqdel d1 Response: at**binqdel d1,s2 Response: **BINQSERV | delete device d1 OK delete service s2 of device d1 OK Discover services of device Performs a service discovery on a single device. brad: dx: Bluetooth remote device address (12 digits) References Bluetooth remote device number in binqlist (d01...d16) The commands needs a Bluetooth device address or a device selector dx from the binqlist as a parameter. The information gathered is responded immediately and inserted into the binqlist. BlueRS+BD Manual Example: 1.06/Nov 2004 at**binqserv d03 get service information for device d03 Response: d03: s01: s02: OK **BINQND Request device name during device search If the parameter BINQND is set to 1, a name request is performed on each inquired device during execution of the BINQ command. If the parameter is set to 0 name are not requested. default: 1 – names are requested from remote device Example: at**binqnd 1 Response: **BINQSD OK Discover services during device search If the parameter BINQSD is set to 1, a service discovery is performed on each inquired device during execution of the BINQ command. If the parameter is set to 0 services are not discovered. default: 0 – do not discover services Example: at**binqsd 1 Response: **BDINQ OK Inquire Bluetooth devices [deprecated] With this request the automatic scan of all discoverable Bluetooth devices will be initiated. As a result the creation of the list bdlist will be initiated. The list can be read out using the command at**bdlist. If the Inquiry-scan has not been terminated while issuing the command at**bdlist, BlueRS+BD will return "inquiry active". The entries contain the Bluetooth device address, the Bluetooth device names and available services (profiles). The creation of this list may take up to 20 seconds due to the reaction time of the accessible Bluetooth devices; a maximum of 16 Bluetooth devices can be listed. When issuing the command "at**bdinq 1" the inquiry scan will only request the Bluetooth addresses, name and service inquiry will not be performed. Example: at**bdinq Response: at**bdinq 1 request Bluetooth devices with name and service OK request Bluetooth device addresses only 1.06/Nov 2004 BlueRS+BD Manual Response: **BDLIST OK Show inquired Bluetooth devices [deprecated] With this request the list of found Bluetooth devices will be returned, the entries show the Bluetooth device address and the Bluetooth device name requested by the command at**bdinq. For every Bluetooth device in addition the available services (profiles) will be shown. These entries can be accessed by the selector d1...dn to address the Bluetooth device and the selectors s1...sn to address the Bluetooth devices service channel. Example: at**bdlist Responses: d1: , s1: , , s2: , , d2: , s1: , , ... OK or inquiry active if the search initiated by at**bdinq OK is still active or list empty OK bradr brname service server channel bsname if no Bluetooth device found found Bluetooth remote device address (12 digits) found Bluetooth remote device name coding of service type used channel number for service type used service name for service type Additional Bluetooth specific commands can be found in chapter 4.4 List of BlueRS+BD Configurator commands. ** Execute configuration command Executes one configuration command, for definition of commands see page 23. AT** More than one configuration command have to be separated by a ";". AT**cmd1;**cmd2 BlueRS+BD Manual 1.06/Nov 2004 1.06/Nov 2004 BlueRS+BD Manual 3.2.2 AT command S register set S0 0: No automatic call acceptance, acceptance of an incoming call is controlled by the data terminal (command ATA after RING) 1: Immediate call acceptance by the terminal adapter (default) 2..n: Call acceptance through the terminal adapter after n "RING" messages. S2 Escape Character (default = 43h) S3 Carriage Return Character (default = 13) S4 Line Feed Character (default = 10) S5 Backspace Character (default = 08) S7 Wait time for Carrier (sec) (default = 30 sec) S9 Enable PNP functionality for Windows95 (default=1, enabled) S91 0: default 1: all unknown AT commands will be answered with OK. 2: Windows 2000 compatibility: some AT commands will be answered with OK, unknown AT commands will be answered with OK. 3.2.3 AT result codes Result codes (numerical and verbose): Code Text Meaning OK Command completed CONNECT Connection established RING Indicates an incoming call (Link request received) NO CARRIER No synchronization (berr = BT error cause) ERROR Illegal command or error that can not be indicated otherwise NO DIALTONE No access to Bluetooth? network (berr = BT error) BUSY < berr > Number engaged (berr = BT error cause) NO ANSWER < berr > No connection; addressed Bluetooth device can not be reached (berr = BT error cause) = Address of the remote device the display of the remote device address must be enabled with the command ATW1. Error cause display: < berr > = Bluetooth release (error) cause, hexadecimal Example: NO CARRIER <0104> In AT command mode, error cause display (does not belong to the AT command standard) can be turned on by issuing the command ATW1 . The shown error BlueRS+BD Manual 1.06/Nov 2004 causes use the coding defined by the Bluetooth definition (see page 39). 3.3 Table for coding Bluetooth services List of Bluetooth services (profiles/UUIDs): Code 1101 Text SerialPort 1102 1103 LANAccessUsingPPP DialupNetworking 1104 1105 1106 1107 1108 1109 1100 1111 1112 1113 1114 IrMCSync OBEXObjectPush OBEXFileTransfer IrMCSyncCommand Headset Cordless Telephony Intercom Fax HeadsetAudioGateway WAP WAP_CLIENT Meaning Serial port, serial data link without any restriction Lan Access with PPP protocol Dial Up Networking to establish switched connections to the ISDN or PSTN OBEX Object Push OBEX Filetransfer Headset access via Bluetooth Fax Headset Gateway for audio signals 1.06/Nov 2004 BlueRS+BD Manual 4 BlueRS+BD Configurator command set The BlueRS+BD settings for the serial and Bluetooth interfaces are called configuration. Hardware driven by BlueRS+BD is delivered with a set of pre-set values. In the following section it will be shown how, by using the configuration commands, you can examine the configuration of BlueRS+BD and, if necessary, change it. The values can be stored in non volatile memory; this means they will remain unchanged even if the power supply is disconnected. You can configure BlueRS+BD in the following ways: • By using BlueRS+BD Configurator commands entered by a locally connected PC. • By using the AT command set entered by a locally connected PC. • By using BlueRS+BD Configurator commands entered via the Bluetooth link (remote configuration). BlueRS+BD Configurator can be entered in the following ways: • By using a special command from the asynchronous dialup command interface (AT: “ATCONF”). • Remote via a Bluetooth connection from another Bluetooth device. • By the escape sequence in power up phase if enabled (rsttim>10, rstmsg=1). 4.1 Configuring BlueRS+BD after power on • • • • • • • Connect the hardware to PC's COM port. Start a terminal emulation program (i.e. Hyper-Terminal) with the following settings: 9600 Baud, 8 databits, No Parity (8N1) Power up the hardware Wait until the message to enter the config sequence is displayed: "+++ Press , , , to enter [Hardware Name]Configurator +++" Type in within 2 seconds after the message appears: , to call up the BlueRS+BD Configurator. The BlueRS+BD Configurator acknowledges by giving a welcome string and a “#“ as the prompt character. You can now work with the BlueRS+BD Configurator by using the configuration commands (see page 23). Set up the parameters for BlueRS+BD from your terminal program and store them. Example: To set the baudrate to 9600 baud, please enter the following commands: br=4<↵> (set baudrate to 9600 baud) save<↵> (store the new configuration) quit<↵> (leave the BlueRS+Configurator and activate the new BlueRS+BD Manual • 1.06/Nov 2004 value settings) Hint: The active set of parameters can be displayed on screen by the BlueRS+BD Configurator command "show<↵>". Leave the terminal program and start your application. Now you can use BlueRS+BD with the new set of parameters by running the needed PC application. 4.2 Configuring BlueRS+BD with AT commands To execute one BlueRS+Configuration command cmd out of the AT command mode you have to issue the command: “at**cmd” . To call up the BlueRS+BD Configurator, use the command “atconf”. You can leave the BlueRS+BD Configurator by issuing the command “quit” (or „exit“ or „go“). 4.3 Remote configuration using the BlueRS+BD Configurator commands The BlueRS+BD software to be configured is referred here as “remote BlueRS+BD”. The BlueRS+BD performing the configuration is referred to as “local BlueRS+BD”. Please make sure that the remote Bluetooth device to be configured is powered up. • • • • • • Connect the PC's com-port to the DTE interface of the local Bluetooth device. Power up the local device. Start a terminal emulation program (i.e. HyperTerminal) Configure the local BlueRS+BD with the special service channel 30 (brsch=30). Set up a Bluetooth-Link to the remote Bluetooth device to be configured by using the command: ATD <↵>. The called BlueRS+BD Configurator acknowledges by requesting the remote password. Please enter the correct password (default: no password, just return). Now you can work with the BlueRS+Configurator by using the BlueRS+Configurator commands (see page 21). Configure the parameters for the remote BlueRS+BD from within your terminal program and store them (if wanted). (See page 23). Hint: • The active set of parameters can be displayed on screen by the BlueRS+BD Configurator command "show<↵>". If necessary the remote BlueRS+BD can be reset using the command "reset<↵>". Hang up the Bluetooth connection by leaving the BlueRS+BD Configurator using the command quit. 1.06/Nov 2004 BlueRS+BD Manual Leave your terminal program. After the next reset the changes will be active. • Restore the local BlueRS+BD's channel to the desired value, default to 1 (brsch=1). Now the configured remote BlueRS+BD with the new set of parameters can be used by running the needed PC application. 4.4 List of BlueRS+BD Configurator commands The BlueRS+Configurator commands typed in must have the correct syntax and be complete, including all blanks. Configurator commands are case insensitive. The bolded values are factory defaults. The usage is: [?] [=parameter] Example to set the baudrate to 9600 baud: br=4 Example to show the selected baudrate: br Example to show all selectable baudrates: ?br Most important BlueRS+BD Configurator commands: show show the parameters usually used showall show all changeable parameters quit leave BlueRS+BD Configurator help show all available commands defa 1 setup factory default parameter set save store parameter non volatile BlueRS+BD Manual at.sx 1.06/Nov 2004 AT command parameter set AT command set only: Handle AT specific settings. Show and change AT S registers by entering the new value. at.s0 show setting of S0-Register at.s0=1 set Register S0 to 1 bacctab Show bonding information [deprecated] To show the bonding information (setup due to a successful restricted connection) within BlueRS+BD you have to issue the command "AT**BACCTAB". The BlueRS+BD stores up to 4 bonds. If all 4 entries are used a new bond will overwrite the oldest one. Example: at**bacctab Response: bclass 1: used: YES BD: 00803714ECA4 name: 2: used: YES BD: 008025000105 name: 3: used: NO 4: used: NO OK Set Bluetooth class of device Allows the manipulation of the Bluetooth Class of Devices/Service The default setting is 1F00 = no services class, unspecified device class bcrypt Switch encryption on or off Enable or disable the encryption of the information transferred via Bluetooth. Please note the Bluetooth connection must be authenticated (see parameter BSECOUT,BSECIN) to allow encryption. Possible values are: 0: encryption switched off 1: encryption enabled Example: at**bcrypt 1 Response: OK 1.06/Nov 2004 BlueRS+BD Manual bdel Delete pairing information [deprecated] To delete the pairing information (setup due to a successful restricted connection) within BlueRS+BD you have to issue the command "AT**BDEL 1" . The paired Bluetooth device can be read out by the command "AT**BACCTAB". Example: bpin at**bdel 1 Response: OK Bluetooth device PIN (Passkey) Set the PIN for establishing a connection in the restricted mode by the command "AT**BPIN= , ". This PIN is always checked if - BlueRS+BD is set to restricted mode - BlueRS+BD is not set to restricted mode, but the partner Bluetooth device is set to restricted mode. The PIN has a maximum length of 16 alphanumeric characters, factory default: 0000. Note: You should prefer to use a passkey composed from decimal digits. You can not ensure that a remote device with limited user interface capabilities supports alpha characters. To reset the PIN to factory default please use the command AT&F1 (all parameters will be set to factory default). Example: at**bpin=0000,1234 set PIN to 1234 (old PIN was 0000) Note: After a pairing has taken place (PIN successful exchanged) Bluetooth links can be established between these paired devices independent of the setting of the restricted mode and the PIN! BlueRS+BD Manual bnd [, ] 1.06/Nov 2004 Bond with a Bluetooth device This command initiates a bonding process with a remote Bluetooth device. may either be the device address of the remote device or the devices selector dxx from the binqlist. The optional parameter is the passkey used to generate the bond. If is omitted the passkey configured with the **bpin command is used. If the bonding succeeded BlueRS+BD responds “SUCCESS” otherwise “FAIL” Example: at**bnd=010203040506,1234 bndlist bond with device with address 010203040506 and use 1234 as passkey Show bonded device list To show information about the devices bonded with BlueRS+BD you have to issue the command AT**BNDLIST”. Example: at**bndlist Response: bnddel b01: ... OK Delete bonding information To delete the bonding information held within BlueRS+BD you have to issue the command “AT**BNDDEL ”. The bonded Bluetooth devices can be read out by the command “AT**BNDLIST”. “AT**BNDDEL all” deletes all bonded devices. Example: at**bnddel b1 Response: OK 1.06/Nov 2004 BlueRS+BD Manual bnds Set the storage mode for bonds If the parameter BNDS is set to 1, bonding information (link keys) are stored permanently in the NVRAM of the hardware driven by BlueRS+BD. If the parameter is set to 0 bonds persist for the duration of the authenticated connection. Example: at**bnds 1 Response: bpsm OK Set scanning capability This parameter controls the visibility and the ability to be connected and the reaction to paging and/or inquiry requests. If set to 0 all paging/inquiry requests from other Bluetooth devices will be ignored and the RF receive part of the hardware driven by BlueRS+BD will be disabled. Possible values are: 0 : Page scan and inquiry scan are disabled (hardware is not connectable and not discoverable) 1 : Inquiry scan is enabled (hardware is discoverable, but not connectable) 2 : Page scan is enabled (hardware is connectable, but not discoverable) 3 : Page scan and inquiry scan are enabled (hardware is connectable and discoverable, default) Example: bpsrm at**bpsm=2 enable page scan, but do not answer on inquiry requests Set the page scan repetition mode This parameter allows the modification of the page scan repetition mode of the Bluetooth hardware. Possible values according to the Bluetooth baseband specification are: 0 : R0 - continuous scan 1 : R1 - 1,28 sec’s interval 11,25 ms window (default) 2 : R2 - 2,56 sec’s interval 11,25 ms window Continuous scan decreases the connect time down to about 200 ms: R0: about 200 ms R1: about 2,2 sec R2: about 3,5 sec BlueRS+BD Manual 1.06/Nov 2004 The BPSRM should be set to the same value for the scanning and the paging device. Example: at**bpsrm=0 set page scan repetition mode to R0 – continuous. Note: Setting the page scan repetition mode to continuous scan significantly increases hardware power consumption. bsecin Authorization mode for incoming connections The BSECIN parameter configures the authorization behavior of the Bluetooth hardware on incoming connections. mode name bondable bond unknown bond always bonded only rebond always do not connect bsecout behavior accept bond request from remote device no active authentication (default) perform authentication on connection setup, if not bonded with remote device perform a bonding always perform a bonding accept only connections from bonded devices, authenticate the link authorization accept only connections from bonded devices, always perform a bonding Authorization mode for outgoing connections The BSECOUT parameter configures BlueRS+BD for outgoing connections. mode name bondable bond unknown bond always bonded only rebond always do not connect the authorization behavior of behavior accept bond request from remote device no active authentication (default) perform authentication on connection setup, if not bonded with remote device perform a bonding always perform a bonding accept only connections from bonded devices, authenticate the link authorization accept only connections from bonded devices, always perform a bonding 1.06/Nov 2004 BlueRS+BD Manual boad Bluetooth own device address With this command you can read out the own Bluetooth device address. This value can not be changed. Example: bname AT**BOAD Bluetooth own device name This command defines the device name. bname is shown on a remote Bluetooth terminal device during a service discovery sequence It is a string constant according to V.250. Example: bofcon at**bname at**bname= show own device name set own device name to rs+name Set fast connection mode With this parameter the fast connection mode for outgoing calls can be switched on and off. The Bluetooth hardware uses a different page mode to establish the Bluetooth connection to the remote device and decreases the timeout for a unsuccessful paging. Note: The remote device must be configured to use page scan mode R0 (parameter bpsrm) to achieve the full speed advantage. Example: bosch at**bofcon=1 enable the fast connection mode. Set own server channel number Set up server channel number of the serial service supplied by the local device. The channel number is used for incoming connections only. Note: The server channel 30 is reserved for the remote configuration access, do not use it for the serial port service. BlueRS+BD Manual 1.06/Nov 2004 bosrv Own service (profile) UUID Defines the service the Bluetooth hardware announces to the world. “bosrv” influences the type that is shown on a remote Bluetooth terminal device during a service discovery sequence. The value must be entered as a hex number. default:0x1101 Example: serial port at**bosrv brad, brad2,brad3 set own service to DialUp networking Bluetooth remote device address With this parameter you can setup up to 3 Bluetooth addresses of remote Bluetooth devices, that should be connected using an automatic link setup. BlueRS+BD will try to connect the device with address “brad” first, if that fails because the device is busy or unreachable it tries to connect the device “brad2” afterwards “brad3”. Then the sequence starts again with “brad” The address can be any dial string as specified for the command ATD. The address can be deleted using the command brad -. Example: brad=0080371443AB brbd Displays connected device address This command displays the device address of the connected Bluetooth device. This value can not be changed. Example: at**brbd brname show connected device address Displays connected device name This command displays the device name of the connected Bluetooth device. This value can not be changed. Example: at**brname show connected device name 1.06/Nov 2004 BlueRS+BD Manual brsch Set remote Bluetooth server channel Set up server channel of the remote Bluetooth module, to which the Bluetooth link shall be established. The own server channel number can be changed with parameter bosch. Remote management between BlueRS+BDs is achieved using the server channel 30. default:1 Example: bsname at**brsch=1 Bluetooth service name Defines the service name of the Bluetooth hardware. “bsname” is shown on a remote Bluetooth terminal device during a service discovery sequence. default:[Product Name]/serial port Example: brestr at**bsname at**bsname= set own service name to rs+srvname Set restricted mode [deprecated] Control the security behavior of the Bluetooth hardware. When set to 1 the bonding information from the list of bonded devices or the passkey stored with parameter bpin will be used for authentication. When set to 2 connections are allowed with bonded devices only. The passkey will not be used to authenticate the remote device. The PINs of two Bluetooth devices have to set to the same value, if one of these devices allows only restricted connections. If a restricted connection has been established one time between two Bluetooth devices these devices know each other and are called as "bonded" (see command "AT**BACCTAB" for information about the bonded Bluetooth devices). After a bonding has taken place Bluetooth links can be established between these bonded devices independent of the setting of the restricted mode! To delete the bonding information within BlueRS+BD you have to issue the command "AT**BDEL". BlueRS+BD Manual pwd 1.06/Nov 2004 Set power down mode Setting this parameter to 1 allows the Bluetooth hardware to enter power down state. This leads to reduced power consumption if no Bluetooth link is established. The power down state is entered automatically (after approx. 1-2 seconds) if a Bluetooth link is disconnected and the line DTR is set to low. Rising DTR will signal the Bluetooth hardware to leave power down, all functions will be available. Please note, that in power down state the AT command handler is not available. Possible values are: 0 : power down not allowed (default) 1 : power down state will be achieved automatically Example: br at**pwd=1 enable power down mode Baudrate asynchronous Selection of the asynchronous baudrate for the DTE interface 1: 2: 3: 4: 5: 6: 7: 8: 9: 20: 21: 26: cato 1200 bits/s 2400 bit/s 4800 bit/s 9600 bit/s 19200 bit/s 38400 bit/s 57600 bit/s 115200 bit/s (default) 230400 bit/s 300 bit/s 600 bits/s 10400 bits/s Call timeout to abort Time to abort a call if not successful connected after n seconds. n = {3..255}, default: 15 seconds. 1.06/Nov 2004 capa BlueRS+BD Manual Call pause Automatic call: Set a call pause for n seconds before next call attempt. n = 0 : no call retry, default: 3 seconds. ccts CTS control CTS control 0 : CTS follows local RTS 1 : CTS always ON (default) 2 : CTS follows local DTR 3 : CTS follows remote CTS line status cdcd DCD control DCD control 0 : DCD always ON 1 : DCD indicates a Bluetooth connection (default) 2 : follows local DTR 4 : follows remote DCD cdsr DSR control DSR control 0 : DSR always ON (default) 1 : DSR indicates a Bluetooth connection 4 : DSR follows remote DSR line status BlueRS+BD Manual cdtr 1.06/Nov 2004 DTR control Usage of DTR to control a Bluetooth connection 0 : No control: Incoming calls will be accepted independent of DTR status; DTR drop does not disconnect an active connection. 2 : DTR off disconnects Incoming calls will be accepted only when DTR is ON; DTR drop disconnects an active connection. 4 : DTR ignore and DTR drop disconnects (default) Incoming calls will be accepted independent of DTR status; DTR drop disconnects an active connection. 7 : Reset device DTR drop initiates a software reset. cmds Command set Command set for connection control 0: AT command set (default) 6: Automatic connection establishment when DTR is ON. 7: Automatic connection establishment when char is received. 8: Automatic connection establishment independent of any status line. 12: No connection establishment initiated by this module. Note: For details see the appropriate chapters. cri RI control RI control 0 : RI is set with an incoming Bluetooth link request (default) 1 : RI follows remote RI line status defa Default settings Sets up factory default parameter setting. defa 0: setup all parameter concerning data port defa 1: setup all parameter to factory defaults including Bluetooth parameter. 1.06/Nov 2004 dbits BlueRS+BD Manual Asynchronous databits Number of data bits asynchronous chars flc (default: 8) 7,8 Flow control Flow control to DTE 0 : No flow control 3 : Hardware flow control RTS/CTS (default) 6 : RTS to remote RI flash Load new firmware This commands loads new firmware into the Bluetooth hardware. The actual firmware will be overwritten. The firmware will be stored into the used part of the flash memory. While uploading the following checks will be performed: - File transfer protocol is XMODEM1K - An overall firmware checksum is used. - The firmware type written in the module header of the firmware must be compatible to the hardware- and allowed firmware type (stored inside the Bootloader). This command is available only via the local serial port. idle Idle data timeout Timer to disconnect the Bluetooth link after inactivity on the serial line (sec). 0: inactive (default) 1..n: delay time to disconnect in seconds (1..255). load Load stored parameter setting All parameters stored in non volatile RAM will be loaded. prty Asynchronous parity Parity of asynchronous character (default: no parity) 0 : No parity; 1 : Odd parity; 2 : Even parity BlueRS+BD Manual quit, exit, go 1.06/Nov 2004 Activate parameter changes Activates the actual parameter settings and leave the BlueRS+BD Configurator (without storing the parameter in non volatile memory ). rbaccl Remote config port access level Defines the accessibility and visibility of the Bluetooth remote configuration port. The following values are applicable: 0 config port is not accessible nor visible 1 config port is accessible but not visible 2 config port is accessible and visible rbsname Remote config port service name Defines the service name of the Bluetooth remote configuration port. “rbsname” is shown on a remote Bluetooth terminal device during a service discovery sequence. default:config port Example: rpwd at**rbsname at**rbsname= set own device name to rs+config Remote port config password Sets password for remote configuration to nn (1..32 chars) AT**RPWD=nn Default: empty, just press return key. 1.06/Nov 2004 rpc BlueRS+BD Manual Remote port config control Bluetooth provides the feature to control serial port parameters like baudrate, parity etc. from the remote side. To distinguish if a device is the Master regarding RPC (settings are provided by the DTE) and which one is the Slave (gets its settings via the Bluetooth link) the parameter RPC is used. RPC uses a single numeric parameter value, the default is 0 = Master mode. Any value different from 0 places the Bluetooth hardware in slave mode. To facilitate a finer setting each bit of the RPC value has a control function for one port setting. If the bit is set the settings follows the remote setting (slave mode) and the corresponding local parameter is used as initial value and as setting in command mode (no Bluetooth link active). bit reset function baudrate number of data bits number of stop bits parity type flow control corresp. parameter br dbits sbits prty flc Reset Bluetooth hardware Resets the whole functionality by a forced hardware reset (like Power off / on). Refer also to parameter rsttim. rsttim Startup timer Startup delay timer after reset. Within this period the configuration can be entered after reset. 1 .. 255 : reset phase in 100 milliseconds, default: 40 (4 seconds) save Store parameter changes Stores the actual set of parameters in non volatile memory. sbits Number of stop bits Number of stop bits of asynchronous character 1 : One stopbit (default); 2 : two stopbit BlueRS+BD Manual show 1.06/Nov 2004 Show parameters Displays the actual set of parameters showall Show all parameters Displays the all accessible parameters txfwd Timer for data forwarding If no character is entered within the defined period, the received data will be transmitted to the Bluetooth link. 0: minimum delay time (appr. 10 ms, default) 1..n: delay time in 50 ms ticks. Note: Valid for AT command set only. ver Show version string Displays detailed information about the software and hardware version. verb Show version string of Bootloader Displays detailed information about the software version of the Bootloader. ? More information for one command Displays the allowed values for one selected command 1.06/Nov 2004 BlueRS+BD Manual 5 Diagnostic and error messages 5.1 Error messages from AT command set When the extended result messages are selected using the command ATW1, Bluetooth error codes are displayed in addition to the standard AT result messages. Bluetooth error codes are always coded as . The meaning can be taken from the following tables Bluetooth error codes (see page 39). 5.2 Bluetooth error codes Note: error codes marked with (i) are internal errors. Error cause hexadecimal Meaning 0x0000 0x0001 0x0002 0x0003 0x0004 no error, no explanation driver and application version mismatch application id provided is not correct unknown message code in message not enough resources to complete request (out of descriptor etc) at least one parameter of the message is wrong no adapter plugged in too much outstanding messages in downstream direction driver is busy, repeat request later Error in message transport system (driver not correct installed?) (i) HCI_ERR_UNKNOWN_COMMAND (i) HCI_ERR_NOCONNECTION Bluetooth adapter crashed Remote Bluetooth device not found (wrong address?, out of range?) Authentication error (wrong pin code supplied?) (i) HCI_ERR_KEY_MISSING (i) HCI_ERR_MEMORY_FULL lost connection to remote Bluetooth device (out of range) max no of connections exceeded max no of voice connections exceeded (i) HCI_ERR_ACL_CONN_ALREADY_EXISTS (i) HCI_ERR_COMMAND_DISALLOWED connection attempt by remote side rejected 0x0005 0x0006 0x0007 0x0008 0x0009 0x0101 0x0102 0x0103 0x0104/260 0x0105 0x0106 0x0107 0x0108/264 0x0109 0x010a 0x010b 0x010c 0x010d Translation to AT result codes BlueRS+BD Manual 0x010e 0x010f 0x0110 0x0111 0x0112 0x0113 0x0114 0x0115 0x0116 0x0117 0x0118 0x0119 0x011a 0x011b 0x011c 0x011d 0x011e 0x011f 0x0120 0x0121 0x0122 0x0123 0x0124 0x0164 0x0165 0x0166 0x0201 0x0202 0x0203 0x0204 0x02ee 0x0301 0x0302 0x0303 0x0304 0x0305 0x0306 0x0364 0x0365 0x0366 0x0367 0x0464 0x0465 connection attempt by remote side rejected connection attempt by remote side rejected connection attempt by remote side timed out (i) HCI_ERR_UNSUPPORTED_PARAM_VALUE (i) HCI_ERR_INVALID_HCI_PARAMETER_VALUE connection terminated by remote side connection terminated by remote side connection terminated by remote side connection terminated by local side (i) HCI_ERR_REPEATED_ATTEMPTS authentication rejected by remote side incompatible remote Bluetooth adapter unspecified error (i) HCI_ERR_UNSUPPORTED_LMP_PARAMETER_VAL master slave role switch not allowed connect lost to remote Bluetooth adapter (link manager) (i) (HCI_ERR_LMP_ERROR_TRANSACTION_COLLISION (i) HCI_ERR_LMP_PDU_NOT_ALLOWED attempt to enable encryption failed information: unit key used (i) quality of service not supported. (i) HCI_ERR_INSTANT_PASSED (i) unit key not supported (i) HCI_ERR_ILLEGAL_HANDLE initialization of adapter failed (timeout) initialization of adapter failed (synchronization) (i) connection went to state pending protocol not supported by remote side connection refused due to security conditions out of resources remote side timed out version of remote SDP entity not compatible invalid service record handle invalid request syntax invalid size of pdu continuation state is invalid not enough resources to complete operation client received unhandled SDP opcode No answer from server(timeout) specified service not found Syntax Error in Response from server Connection setup was rejected by remote side (DM), i.e. the Pin exchange has failed in restricted mode Connection timed out (no response) 1.06/Nov 2004 1.06/Nov 2004 0x0466 0x0467 BlueRS+BD Manual Non Supported Command received (incompatible remote side) Illegal parameter Note: error codes marked with (i) are internal errors. BlueRS+BD Manual 1.06/Nov 2004 6 Regulatory Information 6.1 Copyright and Trademark Notices Products and brand names may be the trademarks or registered trademarks of their respective owners. BLUETOOTH is a trademark owned by Bluetooth SIG, Inc, U.S.A and licensed to Stollmann Entwicklung und Vertrieb GmbH. 1.06/Nov 2004 BlueRS+BD Manual 7 History Ver Date 1.06 11/03/2004 by Changes since last Version lv removed sections related to specific hardware End users may not be provided with the module installation instructions. OEM integrators mus inform the end users with the following statements. RF Exposure statement: The antenna shown in this filing must not be co-located or operated in conjunction with any other antenna or transmitter. End users may not be provided with the module installation instructions. OEM integrators and end users must be provided with transmitter operating conditions for satisfying RF exposure compliance. For portable applications OEM integrators need no SAR evaluation. The max radiated sourcebased time-averaged output of 0.0016 W is below the low threshold of 24mW for d < 2.5 cm. Statement according to FCC part 15.21: Modifications not expressly approved by this company could void the user's authority to operate the equipment. Statement according to FCC part 15.105: NOTE: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures: . Reorient or relocate the receiving antenna. . Increase the separation between the equipment and receiver. . Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. . Consult the dealer or an experienced radio/TV technician for help. Statement according to FCC part 15.19: This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. The EUT is labled with its own FCC ID number . If the module is inside of an end product, the label will not be visible. In this case the end product will be labled exterior with the FCC ID: TGZBT001.
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.5 Linearized : No Page Count : 44 XMP Toolkit : XMP toolkit 2.9.1-13, framework 1.6 About : uuid:e91f1cc2-efce-4fda-97d1-d2576309bad6 Producer : Acrobat Distiller 6.0 (Windows) Create Date : 2004:11:04 18:17:02+01:00 Creator Tool : PScript5.dll Version 5.2 Modify Date : 2006:01:26 14:44:06+01:00 Metadata Date : 2006:01:26 14:44:06+01:00 Document ID : uuid:e9093196-bcf5-4a53-b4e6-a69949d28d67 Format : application/pdf Title : Microsoft Word - BlueRS+BD_Manual_v1_06.doc Creator : jw Author : jwEXIF Metadata provided by EXIF.tools