RN-BT-DATA-UG
Bluetooth Data Module Command
Reference & Advanced Information
User’s Guide
MODULES:
RN24
RN25
RN41
RN42
RN41XV
RN42XV
SERIAL ADAPTERS:
RN220XP
RN240
RN270
RN274
© 2013 Roving Networks. All rights reserved.
RN-BT-DATA-UG Version 1.0r 3/26/13
Copyright © 2013 Roving Networks. All rights reserved. Apple Inc.,
iPhone, iPad, iTunes, Made for iPhone are registered trademarks of Apple
Computer.
Roving Networks reserves the right to make corrections, modifications,
and other changes to its products, documentation and services at any
time. Customers should obtain the latest relevant information before plac-
ing orders and should verify that such information is current and com-
plete.
Roving Networks assumes no liability for applications assistance or cus-
tomer’s product design. Customers are responsible for their products and
applications that use Roving Networks components. To minimize cus-
tomer product risks, customers should provide adequate design and oper-
ating safeguards.
Roving Networks, Inc.
102 Cooper Court
Los Gatos, CA 95032
+1 (408) 395-5300
www.rovingnetworks.com
Roving Networks products are not authorized for use in safety-critical
applications (such as life support) where a failure of the Roving Networks
product would reasonably be expected to cause severe personal injury or
death, unless officers of the parties have executed an agreement specifi-
cally governing such use.
www.rovingnetworks.com
Version 1.0r 3/26/13
Advanced Information
page 2
RN-BT-DATA-UG
Table of Contents
Chapter 1. Introduction
1.1 Overview ........................................................................................................ 5
1.2 Evaluation Boards & Reference Designs ....................................................... 5
1.3 Command Mode vs. Data Mode ..................................................................... 6
1.4 Operating Modes .......................................................................................... 10
1.5 Using Dipswitches & GPIO Pins for Configuration ....................................... 11
1.6 Making a Bluetooth Connection ................................................................... 12
Chapter 2. Command Reference
2.1 Command Syntax ......................................................................................... 19
2.2 SET Commands ........................................................................................... 19
2.3 GET Commands ........................................................................................... 31
2.4 Change & Action Commands ....................................................................... 32
2.5 GPIO Commands ......................................................................................... 37
Chapter 3. Advanced Topics
3.1 Power Management ..................................................................................... 41
3.2 Configuration Timer Settings ........................................................................ 44
3.3 Interfacing to a Microprocessor .................................................................... 45
3.4 HCI Mode ..................................................................................................... 45
3.5 Profile Settings & Features ........................................................................... 46
3.6 Using GPIO Pins as Modem Control Signals ............................................... 47
3.7 Design Concerns .......................................................................................... 47
3.8 Serial Adapter Configuration ........................................................................ 52
3.9 Null Modem & Flow Control Jumpers ........................................................... 53
3.10 Dipswitch Settings ...................................................................................... 54
Chapter 4. Applications
4.1 Instant Cable Replacement .......................................................................... 57
Chapter 5. HID Profile
5.1 Overview ...................................................................................................... 59
5.2 HID Firmware Overview ............................................................................... 60
5.3 HID Reports .................................................................................................. 62
5.4 HID References ............................................................................................ 68
Appendix A. Factory Defaults
Appendix B. Command Quick Reference Guide
Appendix C. Firmware Revision History
C.1 Version 6.15 (3/26/2013) ............................................................................. 75
C.2 Version 6.12 (Limited Release) ................................................................... 75
C.3 Version 6.11 ................................................................................................. 75
www.rovingnetworks.com
Version 1.0r 3/26/13
page 3
RN-BT-DATA-UG
C.4 Version 6.10 ................................................................................................. 75
C.5 Version 4.77 (8/10/2009) ............................................................................. 76
C.6 Version 4.74 (3/7/2009) ............................................................................... 76
Appendix D. Document Information
RN-BT-DATA-UG
Chapter 1. Introduction
1.1
OVERVIEW
This document contains the software command reference and advanced configuration
settings for Roving Networks Bluetooth
data
modules. The document is applicable to
all Bluetooth data modules modules (such as the RN41 and RN42), and USB dongles.
Commands and settings that are specific to a single product or product family are iden-
tified as such in the document.
You configure Roving Networks Bluetooth devices over the Bluetooth link or over the
module’s UART using a simple ASCII command language. Set commands configure
the module and get commands echo the current configuration. Configuration settings
modified with set commands do not take effect until the module has been rebooted,
even though the get command may show otherwise.
This document assumes that you have a working knowledge of Bluetooth operation
and communications. To configure the Roving Networks modules you need a Blue-
tooth-enabled PC (either built-in or using a USB Bluetooth dongle). You can only con-
figure one module at a time. Once configured, module settings are saved (independent
of power down) until they are explicitly changed or the factory defaults are restored.
NOTICE TO CUSTOMERS
The commands and applications described in this document apply to Roving Networks
Bluetooth
data modules,
e.g., RN41 and RN42. For Bluetooth audio module configuration
information (e.g., RN52), refer to the
Bluetooth Audio Module Command Reference User’s
Guide.
1.2
EVALUATION BOARDS & REFERENCE DESIGNS
Roving Networks provides a variety of boards, kits, and reference designs that you can
use for evaluation and prototyping.
The RN-41-EK and RN-42-EK evaluation boards are field-ready, Bluetooth SIG quali-
fied prototyping platforms for the RN41 and RN42 modules, respectively. The boards
have the flexibility to connect directly to PCs via a standard USB interface (via the FTDI
chipset) or to embedded processors through the TTL UART interface. The status LEDs,
dipswitches, and signal headers enable demonstrations and proofs of concept.
The Bluetooth HID reference design is implemented in the RN42HID-I/RM module. The
Bluetooth HID profile is typically used in applications such as keyboards, mice, and
game controllers. To demonstrate the basic capability of the Bluetooth HID profile, Rov-
ing Networks has developed a Bluetooth reference design implemented in the
RN42HID-I/RM module. The reference design operates in three modes:
•
Presenter mode—Used
for presentation software such as Microsoft Powerpoint
•
Music mode—Music
controller for products such as the iPod, iPhone, and iPad
•
Custom mode—You
can configure each button to send a sequence of up to 4
keys
www.rovingnetworks.com
Version 1.0r 3/26/13
Advanced Information
page 5