background image

 

 

 

 

 

Manual for BL-521 5_3.doc 

© Copyright Brainboxes Limited 2004 

Page 24 of 41

 

4.3. Command Interface 

 
The  command  interface  is  a  new  addition  to  version  4  of  the  converter’s  firmware.  This  interface  has  been 
developed primarily to support programming access to the configuration settings by an application such as our own 
configuration  application, but can also offer a powerful human operated (e.g.  via HyperTerminal) command driven 
interface  in  it’s  own  right.  Additionally,  the  commands  can  be  placed  in  a  Text/script  file  and  sent  (e.g.  by 
HyperTerminal) in one go to the converter. The <scr> command is strongly recommended for use in this scenario. 
 
The command interface protocol is  quite straightforward.  Each command (see  table and  descriptions below) must 
be sent over the COM port, followed by a Carriage return. This can be done in HyperTerminal just by typing each 
command and hitting the Enter key. 
 
There are up to 3 ways each command can be used. 
 
1. On its own. This acts as a “query” command. 

e.g. 

cod<CR>   

  

Returns the current device class 

 
2. With an “=” and parameter(s). This acts as a “set” command 

e.g. cset

=9600,n,1<CR>  

 

Sets the current settings to 9600 baud, No Parity and 1 Stop Bit 
Not all commands support this function as they are query commands only 

 
3. With a “?” which acts as a “help” command 

e.g. 

svc?<CR>  

 

Returns a description of the command syntax and allowable parameters 

 
The command list summary is given below. 
 
Command 
Name 

Description 

Command 
Name 

Description 

aset 

Get all settings 

menu                Display Menu  

btset 

Get current Bluetooth settings 

padd 

Partner Address 

cnx 

Manually connect to a found device 

pair                 Pair 

cod  

Class Of Device 

parkset 

Park Settings 

cset  

Communication Settings 

part 

Partner 

delpair 

Delete the current pair 

pin 

PIN code 

delpart 

Delete the current Partner 

 

pnam 

Partner Name 

dflt  

Default settings 

prox 

Set the proximity mode 

disc 

Discoverability 

remcfg 

Remote Configuration 

enc 

Encryption 

scr       

Script Mode 

find 

Manually perform an inquiry 

sec 

Security 

help or ?  

Help 

sniffset 

Sniff Settings 

hsk 

Handshaking 

svc 

Connect Using profile other than SPP 

ladd 

Local device address 

svr 

Server or Client 

list 

List the manually-found devices 

upg 

Prepare for upgrading 

lowpwr 

Low Power Mode 

ver 

F/W app version 

lnam       

Local device name 

 

verb 

Verbose 

 
The  full  command  list  syntax  and  programming  examples  will  be  given  in  a  future  edition  of  this  manual.  In  the 
meantime,  this  information  can  be  found  using  the  help  or  ?  command  in  HyperTerminal  when  your  converter  is 
attached to an available COM port. 

Summary of Contents for BL-521

Page 1: ...imited Unit 3C Wavertree Boulevard South Wavertree Technology Park Liverpool L7 9PF UK Tel 44 0 151 220 2500 Fax 44 0 151 252 0446 Web www brainboxes com Email sales brainboxes com Product Manual RS23...

Page 2: ...18 4 2 2 Main Menu 19 4 2 3 Communications Parameters 19 4 2 4 Handshaking 20 4 2 5 Bluetooth Parameters 20 4 2 6 Display Restore and Update Current and Factory Settings 21 4 2 7 Disabling Interactiv...

Page 3: ...12 Technical Specifications 36 12 1 Storage and Operating Environment 36 12 1 1 Storage 36 12 1 2 Operational 36 12 2 Power requirements 36 12 2 1 Input Voltage Requirements 36 12 2 2 Measured curren...

Page 4: ...e only capable of connecting to one other Bluetooth device at a time The converter is user configurable to baud rates between 244 and 1 3Mbaud in steps of 244 with none odd or even parity and with 1 o...

Page 5: ...o a DCE device that would normally plug into the back of a PC If you wish to use BL 521 as a DCE device e g to plug into the back of a PC or similar you should use the included gender changer For larg...

Page 6: ...re detail later in this section View Set local COM port settings baud rate parity stop bits View Set Discoverability Security mode and PIN number View Set Pairing options including pairing to another...

Page 7: ...of the application there are four action icons These card be used to restore the local BL 521 to it s default settings save the current settings as default settings reload the current settings and ap...

Page 8: ...f the device that is connected This can be changed to any name as required as detailed further below Each Bluetooth device in the world must have a unique address Some Bluetooth devices need to know t...

Page 9: ...e new settings so it can continue to interact with the device Multiple changes to communications settings are ALL applied when the apply icon is selected NOTE It is possible for the converters to be c...

Page 10: ...lient will put the product into a state where it will attempt to connect to remote devices contained in its internal database The remote or partner device feature is explained below It is this option...

Page 11: ...For example a Bluetooth phone can be used by a BL 521 to dial out to the internet on a PC if the Connect Using feature is set to DUN partner address is the phone s Bluetooth address and the BL 521 is...

Page 12: ...f each other the controlling device it may be wise to change the name of each device so that human users can more easily identify each individual This field does not have a drop down list of options Y...

Page 13: ...will only pair with device entered in the Set Partner menu Other device must have identical PIN number Only device entered in the Set Partner Menu after pairing Secure connection between the BL 521 an...

Page 14: ...uration easier Brainboxes do not recommend that you leave RTS CTS handshaking disabled unless you are connecting the converter to a device that specifically does not use any itself This handshaking ex...

Page 15: ...specify in milliseconds the minimum possible time that should exist between server client communication slots Attempt Timeout These are used to specify the number of attempts that the client device wi...

Page 16: ...cted at the bottom of the page When the Default Settings section is opened on the right hand side of the application a new section appears in the left hand side called Current Settings which can also...

Page 17: ...documented earlier The example given below to connect to the configuration menus is performed in Windows XP using HyperTerminal a terminal application that ships with Windows If you are using a diffe...

Page 18: ...ld now be running Now hit the Enter key once This should activate the main configuration menu as shown in Main Menu below You should be able to now interact with the menus as described in the followin...

Page 19: ...he Main Menu menu displays the Communications settings menu It is from this menu that all available serial port settings can be changed The available options are detailed below The factory set communi...

Page 20: ...after changing each setting If you have changed any communications parameters and wish to continue to access the configuration menu you will need to update your terminal applications settings The eas...

Page 21: ...y not be able to use a full character set Next the user is prompted to choose a role for the device the current one is identified s chooses Server c chooses Client or Esc skips this section leaving th...

Page 22: ...y want to do unless you re sure you have the settings as you want them and are sure you can remember them as there is no way back from here Selecting option 4 from the Settings menu above allows the u...

Page 23: ...ause the menu option to abort and you will be able to continue navigating the menu in the normal fashion In some but not all instances you will see some odd characters displayed as shown above This is...

Page 24: ...Parity and 1 Stop Bit Not all commands support this function as they are query commands only 3 With a which acts as a help command e g svc CR Returns a description of the command syntax and allowable...

Page 25: ...be used Also upgrading of the BL 521 cannot be achieved using remote configuration because as soon as the BL 521 starts to upgrade the Bluetooth connection is lost and there is no longer a way of com...

Page 26: ...e onscreen instructions to install the application This will create an entry in your start menu as well as a desktop shortcut Run the application by selecting it from the Start menu The first screen i...

Page 27: ...nfiguration Utility or Hyperterminal application if you still have either open Then Click Next Point the upgrade wizard to the upgrade file you wish to use These upgrade files all have the extension d...

Page 28: ...he upgrade This may take a few minutes as the wizard will automatically make a copy of the firmware currently on the device before uploading the new version A progress bar indicates how the procedure...

Page 29: ...o the RS232 port on a computer Included is a convenient and appropriately wired gender changer that allows the converter to behave as a DCE device e g if you wish to connect it to your computer for co...

Page 30: ...it follows then that only 1 of the BL 521 pair needs any alternate configuration from that supplied It is advisable that you first configure the communications settings baud rate etc for each BL 521 s...

Page 31: ...abel NAP UAP LAP for those of you who know Press Esc to skip this section Press C to select the client option This setting is stored immediately and is not discarded upon a reboot In fact it requires...

Page 32: ...nsist of 3 Steps 1 Configuring the BL 521 s communications parameters 2 Physically connecting BL 521 to your device 3 Connecting to BL 521 from a remote device via Bluetooth and transferring data Ther...

Page 33: ...onfiguration menu to change it Click OK The Icon of your BL 521 in the main window should now change to indicate a bonded status as shown here 9 3 5 Connect to the Serial Port profile In order to actu...

Page 34: ...default and it s baud rate was changed to match that of the oscilloscope 19200 baud Connection from the USB adapter to the BL 521 was performed exactly as described in the section above Setting Hyper...

Page 35: ...oduct is using most of its processor cycles to try and find and connect to a remote device Reconfigure the product to Server mode whilst attempting to configure other options Cannot interact with the...

Page 36: ...the Voltage tolerances are given below Minimum 4 3V Maximum 6V Correct operation of the product has not actually been tested at these voltage extremes This additional Voltage information does not in a...

Page 37: ...orse case 940 kHz 1 MHz Adjacent Channel Power 0 o C TX 2405 MHz 2 fails TX 2441 MHz 1 fail TX 2477 MHz 0 fails 3 fails 3 fails 3 fails Modulation Index 0 94 1 03 channel dependent 0 8 Initial Carrier...

Page 38: ...verted F Antenna PIFA with a gain of 0 3 dBm 13 5 2 Radiation Patterns 0o 315o 270o 225o 180o 135o 90o 45o 0 dBd 30 dBd 20 dBd 10 dBd horizontal polarisation vertical polarisation 0o 315o 270o 225o 18...

Page 39: ...000 Radio Equipment and Systems RES Wideband transmission systems Technical characteristics and test conditions for data transmission equipment operating in the 2 4 GHz ISM band and using spread spect...

Page 40: ...nnectable 12 data 4 9 17 33 35 40 Device Class 6 14 Disable 6 22 Discover 33 Discoverability 6 12 Encryption 13 error 10 factory settings 4 22 31 Factory Settings 21 gender changer 17 30 HyperTerminal...

Page 41: ...ation of index Minor changes to device menu display updated 3 2 11 04 2003 Gav ETW SE DR MW OS NP J PG Section re order update tables 4 0 26 08 2003 Gav Re write for firmware 3 0 additions Addition of...

Reviews: