Laird BTM430 User Manual
  1. Manuals
  2. Brands
  3. Laird Manuals
  4. Control Unit
  5. BTM430
  6. User manual

Laird BTM430 User Manual

Data module
Hide thumbs Also See for BTM430:
Table of Contents

Advertisement

Quick Links

Download this manual
BTM430/431 DATA MODULE
User Guide
Version 5.0
Americas: +1-800-492-2320
Europe: +44-1628-858-940
Hong Kong: +852-2923-0610
wireless.support@lairdtech.com
www.lairdtech.com/bluetooth

Advertisement

Table of Contents
loading

Related Manuals for Laird BTM430

Summary of Contents for Laird BTM430

  • Page 1 BTM430/431 DATA MODULE User Guide Version 5.0 Americas: +1-800-492-2320 Europe: +44-1628-858-940 Hong Kong: +852-2923-0610 wireless.support@lairdtech.com www.lairdtech.com/bluetooth...
  • Page 2 Updated FCC Statement, new mech. drawings, general 7 Jan 2013 Jonathan Kaye editing / formatting 15 Mar 2013 Converted to Laird formatting Sue White Separated into two separate docs (Hardware 04 Feb 2014 Integration Guide and User Guide). Added a Related Sue White Documents section.

  • Page 3: Table Of Contents

    BTM430/431 ® Bluetooth AT Data Module User Guide ABLE OF ONTENTS 1 Revision History ............................2 2 Table of Contents............................ 3 1. Overview and Key Features ........................4 FEATURES AND BENEFITS ........................... 4 APPLICATIONS ............................... 4 3 AT Command Set Reference ........................5 Introduction ..............................

  • Page 4: Overview And Key Features

    A comprehensive AT command interface is included, which simplifies firmware integration. Combined with a low cost developer’s kit, this ensures that the choice of Laird Technologies Bluetooth modules guarantees the fastest route to market. FEATURES AND BENEFITS 2.1 APPLICATIONS...

  • Page 5: At Command Set Reference

    Just like telephony modems, the Laird Technologies device powers up in an unconnected state and will only respond via the serial interface. In this state the Laird Technologies device will not even respond to Bluetooth Inquiries. Then, just like controlling a modem, the host can issue AT commands which map to various Bluetooth activities.

  • Page 6: Assumptions

    AT Data Module User Guide 3.2 Assumptions The CSR (Cambridge Silicon Radio) BC04 chipset in Laird Technologies devices is memory resource limited. Therefore it is NOT proposed that there be full implementation of the AT protocol as seen in modems. The...
  • Page 7 UUID of the profile server to attach to, and if not supplied then the default UUID from S Register 101 is used. As this is a Laird Technologies device which utilises the RFCOMM layer as described in the Bluetooth specification, it necessarily implies that only profiles based on RFCOMM can be accessed.
  • Page 8 BTM430/431 ® Bluetooth AT Data Module User Guide Due to a known issue in the Bluetooth RFCOMM stack, it is not possible to make more than 65525 outgoing connections. Therefore if that number is exceeded, then the connection attempt will fail with the following response: Response: <cr,lf>CALL LIMIT...
  • Page 9 The CSR firmware build number. The Laird Technologies firmware build number. For internal use only. The Laird Technologies firmware revision. A 12 digit hexadecimal number corresponding to the Bluetooth address of the Laird Technologies device. The manufacturer of this device.
  • Page 10 BTM430/431 ® Bluetooth AT Data Module User Guide The reason why a “NO CARRIER” resulted in the most recent attempt at making an outgoing connection. Where the response values are as follows: 0 = No prior connection 1 = Connection timeout...
  • Page 11 Or <cr,lf>ERROR nn<cr,lf> ATSn=m {Set S Register} As with modems, the Laird Technologies Bluetooth module employs a concept of registers which are used to store parameters (such as escape sequence character and inquiry delay time) as listed in detail below.
  • Page 12 BTM430/431 ® Bluetooth AT Data Module User Guide Register Default Range Comment 40..5000 Escape sequence guard time in milliseconds, with a granularity of 20ms. New values are rounded down to the nearest 20ms multiple. S100 0..15 Number of RING indications before an auto disconnection is initiated.
  • Page 13 Setting to 1 will force S0 to -1 and will suppress messages arising from connections or pairing. E.g. CONNECT, NO CARRIER, RING, PAIR etc. Suppressing connection based messaged allows the Laird Technologies device to be configured in cable replacement mode. S505 2..120...
  • Page 14 BTM430/431 ® Bluetooth AT Data Module User Guide Register Default Range Comment S507 0..2 When set to 0, a connection can be dropped using ^^^ escape sequence only and the state of DSR line is ignored. When set to 1 a connection can be dropped using EITHER the ^^^ escape sequence OR the DSR handshaking line.
  • Page 15 BTM430/431 ® Bluetooth AT Data Module User Guide Register Default Range Comment In modes 5, 6, 7 when all RX activity is ignored, only the special command (capitalised) AT+BT&BISM& terminated by a <cr> will force the module temporarily back into modes 2, 3 and 4 respectively.
  • Page 16 1200,2400,4800,9600,19200,28800,38400,57600,115200. If S register 525=1, then the maximum baud rate is limited to 115200 The default is 9600 for Laird Technologies’ BTM430 / BTM431. For the Go blue Activator variant of the module this register is read only See S Register 526 for further information.
  • Page 17 S525 0..1 Apply multiplier of 8 to baud rate internally. This is set to 0 (disabled) by default for the Laird Technologies Module/RS-232 Comment Adaptor/Universal RS-232 Adaptor, and set to 1 (enabled) by default for the Laird Technologies PC Card.
  • Page 18 BTM430/431 ® Bluetooth AT Data Module User Guide Register Default Range Comment S533 0..2 If set to 1, then GPIO5 follows RI state, if set to 2 then it follows the state of DSR and if 0 it is not driven and GPIO5 is available as a user I/O.
  • Page 19 BTM430/431 ® Bluetooth AT Data Module User Guide Register Default Range Comment S543 0..1 If this is set to 1, then incoming pairing attempts will be accepted (if a pin code has been pre-entered using AT+BTK) while in the wait phase of auto connect cycle initiated by the AT+BTR command.
  • Page 20 BTM430/431 ® Bluetooth AT Data Module User Guide Register Default Range Comment S552 0x0122 0x0FFF This register specifies in each 4 bit nibble, how the DTR, DCD, RI output pins are controlled when in a Bluetooth connection Nibble 0..3 specifies the source for DTR 4..7 specifies the source for DCD...
  • Page 21 BTM430/431 ® Bluetooth AT Data Module User Guide Register Default Range Comment S555 1..7 If S Register 554 is nonzero, then after the post reset window expires, the mode will revert to the mode specified in this register. This allows, for example, the device to be discoverable and connectable on power up (mode 4 or 7) and on window timer expiry to revert to connectable only (mode 3 or 6).
  • Page 22 BTM430/431 ® Bluetooth AT Data Module User Guide Register Default Range Comment S561 0..1000 Sniff Attempt Time in units of milliseconds. 0 means disable. See section “Power Consumption and Reset” in the user guide for more details. S562 0..1000 Sniff Timeout Time in units of milliseconds. 0 means disable.
  • Page 23 BTM430/431 ® Bluetooth AT Data Module User Guide Register Default Range Comment S584 0..1 Enable/Disable eSCO When changing the unit returns ERROR 14 it implies the device is either in a connection or waiting for a connection and so the new value cannot be accepted.
  • Page 24 Read/Write to Analogue Line 1, when reading value is returned in hexadecimal. – Not available in BTM430 / BTM431 S721 Set direction of Analogue Line 0. – Not available in BTM430 / BTM431 S722 Set direction of Analogue Line 1. Not available in BTM430 /...
  • Page 25 BTM430/431 ® Bluetooth AT Data Module User Guide For recognised values of n: Response: <cr,lf>As Appropriate<cr,lf>OK<cr,lf> For unrecognised values of n: Response: <cr,lf>ERROR nn<cr,lf> ATSn=? {Read S Register – Valid Range} This will return the valid range of values for register n.
  • Page 26 Please refer to the “Power Consumption” chapter in the relevant Laird Technologies device user guide for more detailed information of power usage. The new values are NOT updated in non-volatile memory until the AT&W command is sent to the Laird Technologies device.
  • Page 27 Response: <cr,lf>ERROR nn<cr,lf> AT+BTAn {Control Audio Channel} Once a Bluetooth connection is active, and assuming the peer device is an LAIRD TECHNOLOGIES Laird Technologies device, this command is used to start/stop a SCO channel which will connect the PCM interfaces of the two peer devices. This means that if a codec is attached to the PCM pins, then 2-way audio can be established.
  • Page 28 This is an 11 bit field used as a mask to define the Major Service Class, as per Table 1.2 in “Bluetooth Assigned Numbers”. Laird Technologies devices do not map to any predefined Major Service Class or Major Device Class and so the default devclass as shipped is 001F00, which means no Major Service Class and “Unclassified” Major Device class.
  • Page 29 BTM430/431 ® Bluetooth AT Data Module User Guide AT+BTF<bd_addr> {Get Remote Friendly Name} This command gets the remote friendly name of the peer specified. Response: <cr,lf><bd_addr>,”Friendly Name” <cr,lf>OK<cr,lf> AT+BTG<bd_addr> {Enable Cautious Page Scanning ONLY} Enable page scanning and wait for a connection from device with Bluetooth address <bd_addr>. If the specified address is 000000000000 then incoming connections are accepted from any device, is as per AT+BTP without an address.
  • Page 30 BTM430/431 ® Bluetooth AT Data Module User Guide The <devclass> is an optional parameter where the value specifies either a 6 digit device class code or a 2 digit major device class. If it is not specified, then the value is taken from S register 516.
  • Page 31 BTM430/431 ® Bluetooth AT Data Module User Guide Note: Many releases of firmware will return the product name as LAIRD TECHNOLOGIES, e.g. Response: <cr,lf>12346789012,123456,"TDK SYSTEMS AT DONGLE 1" <cr,lf>12345678914,123456, "TDK SYSTEMS RS232" <cr,lf>OK<cr,lf> Note: We strongly recommend that any software implementation that uses this command should check for any of Laird Technologies, EZURIO and TDK SYSTEMS to ensure backwards and forwards compatibility.
  • Page 32 BTM430/431 ® Bluetooth AT Data Module User Guide This sets the default friendly name of this device as seen by other devices. It will be stored in non-volatile memory. Use AT+BTF to make the name visible to other devices. Use AT+BTN? To read it back. An empty string (“”) will delete the string from non-volatile memory which will force the default name to be used.
  • Page 33 This command is used to delete the peer address previously stored using AT+BTR<bd_addr>. Response: <cr,lf>OK<cr,lf> AT+BTR? {Read Outgoing Peer Address} This command is used to display the peer address stored in non-volatile memory, used to put the Laird Technologies device in pure cable replacement mode. Response: <cr,lf>12346789012 <cr,lf>OK<cr,lf>...
  • Page 34 BTM430/431 ® Bluetooth AT Data Module User Guide Response: <cr,lf>00000000000 <cr,lf>OK<cr,lf> AT+BTS=<string> {Set Service Name} This writes the name to non-volatile memory. It will be used after ATZ, power cycle or AT+BTO if it has not been issued yet. Use AT+BTS? to read it back from non-volatile memory. An empty string (“”) will delete the string from non-volatile memory which will force the default service to be used.
  • Page 35 BTM430/431 ® Bluetooth AT Data Module User Guide Response: <cr,lf>1 <cr,lf>OK<cr,lf> If the device < bd_addr > cannot be reached, or is in non-connectable mode then Response: <cr,lf>2 <cr,lf>OK<cr,lf> If the SDP database is corrupt or invalid then Response: <cr,lf>3 <cr,lf>OK<cr,lf>...

  • Page 36: Unsolicited Responses

    See audio gateway specific specification for more details. 3.4 Unsolicited Responses The ‘AT’ Protocol is a command/response type of protocol. This means that the Laird Technologies device will normally only respond to AT commands. Under special circumstances, unsolicited responses will be sent to the host. They are described in the following subsections.

  • Page 37: Incoming Connections

    3.5 Incoming Connections The Laird Technologies device can be configured using the AT+BTP or AT+BTG command so that it will scan for incoming connections from other Bluetooth devices. It can also be configured via S Register 512 to be in this mode by default on power up.

  • Page 38: Pairing And Trusted Devices

    ATH command. Laird Technologies Bluetooth modules provide a variety of ways of dropping a connection. One method is similar to the above, but instead a ^^^ character sequence is used, this is to eliminate ambiguity when a data call is in progress via a mobile phone which was established using the mobile phone’s Bluetooth AT modem.

  • Page 39: Error Responses

    The two units now have pairing information which will survive a power cycle.  3.8 Error Responses All error responses from the Laird Technologies device will be in the form <cr,lf>ERROR nn<cr,lf>, where nn will be a number in the range 00 to 99. Error...

  • Page 40: Factory Default Mode

    Laird Technologies devices are capable of operating at a very wide range of baud rates. S Registers 520 and 521 allow the baud rate to be set very easily. The baud rate clock generator in the Laird Technologies device is more versatile that that available in a standard 16550 UART commonly available in PCs.

  • Page 41: Known Issues

    If S Reg 593 is set to 1, then the last 6 hex digits of the Bluetooth address are automatically appended to the friendly name. This allows multiple devices with the same name in a neighbourhood to be differentiated. 3.11 Known Issues This chapter outlines any known issues in BTM430 / BTM31 firmware. Issue # FW Release...

  • Page 42: Disclaimers

    Laird Technologies does not assume responsibility for use of any of the circuitry described, no circuit patent licenses are implied and Laird Technologies reserves the right at any time to change without notice said circuitry and specifications.

  • Page 43: Pcm Codec Interface

    The PCM_CLK and PCM_SYNC terminals can be configured as inputs or outputs, depending on whether the module is the Master or Slave of the PCM interface. Contact a Laird Technologies FAE for further details. The Module is compatible with the Motorola SSI TM interface and interfaces directly to PCM audio devices including the following: 4.1 Compatible Codec Chips...

  • Page 44: Ftp Related At Commands

    BTM430/431 ® Bluetooth AT Data Module User Guide <filename> shall mean a string delimited by the “ character. For example, “hello.txt”  <foldername> shall mean a string delimited by the “ character.  nnn shall be a decimal number with at least one digit.
  • Page 45 NOT be empty. If the first body is NOT empty when sending a file to a Nokia 6820 phone then it seems to confuse it. Hence Laird Technologies have taken to sending out an empty ‘Body’ header by default which is also what the Windows PC based Widcomm Bluetooth stack does.
  • Page 46 BTM430/431 ® Bluetooth AT Data Module User Guide 5.3.6 DIR -RAW (Get folder listing, XML document) This ftp subcommand is used to retrieve the folder listing. In this variant the obex response packet, which is in ASCII XML format, is sent to the host verbatim.

  • Page 47: Ftp Related Subresponses

    BTM430/431 ® Bluetooth AT Data Module User Guide This ftp subcommand is used to delete the file specified. 5.3.15 DEL -nnn (Delete a file) This ftp subcommand is used to delete the file specified where the filename is specified in Unicode.
  • Page 48 For more details of these values, please refer to the irDA specification which can be freely downloaded from www.irda.org. In addition, values in the range 050 to 099 and 250 to 299 inclusive are specific to this Laird Technologies application and are defined as per the table below. Response Code (Laird Technologies Specific) ‘nnn’...

  • Page 49: Ftp Line Multiplexing Commands

    AT Data Module User Guide Server sent unexpected information in obex packet Obex connection fail, because it is unauthorized Memory allocation failure (Please contact Laird Technologies with details) Unicode File/Folder name length cannot be an odd value Command not recognized An XML parsing error occurred (while processing response to DIR command) The Bluetooth connection has unexpected been dropped.

  • Page 50: Message Sequence Charts

    BTM430/431 ® Bluetooth AT Data Module User Guide This command is used to ask the other end how many bytes of a filename or foldername it will send next. 5.5.2 > This command is used to inform the other end that it is safe to send the number of bytes belonging to a filename or foldername as indicated in the most recent # command.
  • Page 51 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.3 Usage: Folder Listing Note: If a number follows a name then that implies a file Embedded Wireless Solutions Support Laird Center: http://ews-support.lairdtech.com Americas: +1-800-492-2320 Europe: +44-1628-858-940 Hong Kong: +852 2923 0610...
  • Page 52 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.4 Usage: Folder Listing (Raw Output) Note: The raw output is ASCII text and is in XML format. 5.5.5 Usage: Create Folder (Short Folder name) Embedded Wireless Solutions Support Laird Center: http://ews-support.lairdtech.com...
  • Page 53 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.6 Usage: Create Folder (Long Folder name - UNICODE) Note: ‘nn’ is the size of folder name in bytes. The folder name is supplied in Unicode. 5.5.7 Usage: Create Folder (Unsuccessful) Embedded Wireless Solutions Support Laird Center: http://ews-support.lairdtech.com...
  • Page 54 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.8 Usage: Change Folder (Short Folder name) 5.5.9 Usage: Change Folder (Long Folder name - UNICODE) Note: ‘nn’ is the size of folder name in bytes. The folder name is supplied in Unicode.
  • Page 55 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.11 Usage: Remove Folder (Long Folder name – UNICODE) Note: ‘nn’ is the size of folder name in bytes. The folder name is supplied in unicode. Embedded Wireless Solutions Support Laird Center: http://ews-support.lairdtech.com...
  • Page 56 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.12 Usage: Delete File (Short Filename) 5.5.13 Usage: Delete File (Long Filename – UNICODE) Embedded Wireless Solutions Support Laird Center: http://ews-support.lairdtech.com Americas: +1-800-492-2320 Europe: +44-1628-858-940 Hong Kong: +852 2923 0610 www.lairdtech.com/bluetooth...
  • Page 57 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.14 Usage: Put File (Short Filename) Notes: 1. The first NN from the host shall specify a value of 1. 2. Subsequent NN values shall be less than the value returned to command MAX...
  • Page 58 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.15 Usage: Put File (Long Filename - UNICODE) Embedded Wireless Solutions Support Laird Center: http://ews-support.lairdtech.com Americas: +1-800-492-2320 Europe: +44-1628-858-940 Hong Kong: +852 2923 0610 www.lairdtech.com/bluetooth...
  • Page 59 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.16 Usage: Get File (Short Filename) Notes: 1. After each ! command, if a +NN response is not received after 2 seconds, the host can repeat that command. 2. The response to ! is “+NN” instead of just “NN” to make easier for the host to predict the command, since on completion the standard response is “200 FTP”...
  • Page 60 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.17 Usage: Get File (Empty file in server) Note: If the file size is 0, then the host shall receive “200 FTP” instead of “200 GET”. The latter is invitation to the host that data needs to be marshalled across.
  • Page 61 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.19 Usage: Get File – ABORT Embedded Wireless Solutions Support Laird Center: http://ews-support.lairdtech.com Americas: +1-800-492-2320 Europe: +44-1628-858-940 Hong Kong: +852 2923 0610 www.lairdtech.com/bluetooth...
  • Page 62 BTM430/431 ® Bluetooth AT Data Module User Guide Note: If “200 FTP” is received after submitting an ABORT command then it implies that the entire file was transferred before the abort had been received. Embedded Wireless Solutions Support Laird Center: http://ews-support.lairdtech.com...
  • Page 63 BTM430/431 ® Bluetooth AT Data Module User Guide 5.5.20 Usage: Unsuccessful FTP connection Note: Reason for connection failure could be: 1. Device is not in range 2. Device is not connectable 3. Device does not support FTP server profile. 5.5.21 Usage: ABORT a DIR request...

  • Page 64: Obex Profile Commands

     This implementation only offers the Mandatory Object Push feature. The implementation on BTM430/431 allows a host attached to the module to send and receive files and in addition to manipulate files and folders. The format used in this document for describing this protocol is a series of message sequence charts with accompanying notes as appropriate, which unambiguously convey how a host and the module shall interact to perform the task.

  • Page 65: Generic Notes And Guidance

    BTM430/431 ® Bluetooth AT Data Module User Guide 6.1 Generic Notes and Guidance In the message sequence charts the following abbreviations apply:- <crlf> shall mean a two character sequence made up of the ASCII characters 0x0D (carriage return)  and 0x0A (line feed).

  • Page 66: Obex Push Related Subresponses

    Bluetooth AT Data Module User Guide then it seems to confuse it. Hence Laird Technologies have taken to sending out an empty ‘Body’ header by default which is also what the Windows PC based Widcomm Bluetooth stack does. To cater for future devices which NEED the first ‘Body’ header to be non-empty, a new S Register 582 has been added to allow a host to have control over how the first body header is constructed.
  • Page 67 BTM430/431 ® Bluetooth AT Data Module User Guide OBEX Response Code HTTP Status Code Definition 0x00 to 0x0F None Reserved 0x10 (0x90) Continue 0x20 (0xA0) OK, Success 0x21 (0xA1) Created 0x22 (0xA2) Accepted 0x23 (0xA3) Non-Authoritative Information 0x24 (0xA4) No Content...

  • Page 68: Obex Push Line Multiplexing Commands

    For more details of these values, please refer to the irDA specification which can be freely downloaded from www.irda.org. In addition, values in the range 050 to 099 and 250 to 299 inclusive are specific to this Laird Technologies application and are defined as per the table below.

  • Page 69: Message Sequence Charts

    BTM430/431 ® Bluetooth AT Data Module User Guide 6.5.1 # This command is used to ask the other end how many bytes of a filename/ or object it will send next. 6.5.2 > This command is used to inform the other end that it is safe to send the number of bytes belonging to a filename or object as indicated in the most recent # command.
  • Page 70 BTM430/431 ® Bluetooth AT Data Module User Guide 6.5.2 Usage: OBEX Push Disconnection Embedded Wireless Solutions Support Laird Center: http://ews-support.lairdtech.com Americas: +1-800-492-2320 Europe: +44-1628-858-940 Hong Kong: +852 2923 0610 www.lairdtech.com/bluetooth...
  • Page 71 BTM430/431 ® Bluetooth AT Data Module User Guide 6.5.3 Usage: Put File (Short Filename) Notes: 1. The first NN from the host shall specify a value of 1. 2. Subsequent NN values shall be less than the value returned to command MAX...
  • Page 72 BTM430/431 ® Bluetooth AT Data Module User Guide 6.5.4 Usage: Put File (Long Filename - UNICODE) Embedded Wireless Solutions Support Laird Center: http://ews-support.lairdtech.com Americas: +1-800-492-2320 Europe: +44-1628-858-940 Hong Kong: +852 2923 0610 www.lairdtech.com/bluetooth...

  • Page 73: Related Documents

    1. Device is not in range 2. Device is not connectable 3. Device does not support OBEX Push server profile ELATED OCUMENTS The following additional BTM430/431 technical documents are also available from the Laird BTM430/431 product page under the Documentation tab: Product Brief ...
  • Page 74 Copyright © 2014 Laird Technologies, Inc. All rights reserved. The information contained in this manual and the accompanying software programs are copyrighted and all rights are reserved by Laird Technologies, Inc. Laird Technologies, Inc. reserves the right to make periodic modifications of this product without obligation to notify any person or entity of such revision.
  • Page 75 Mouser Electronics Authorized Distributor Click to View Pricing, Inventory, Delivery & Lifecycle Information: Laird Connectivity DVK-BTM431...

This manual is also suitable for:

Btm431

Table of Contents