Crowtail- Blutooth Low Energy Module

Description¶

Crowtail- Blutooth Low Energy Module HM-13 is an easy to use module compatible with the existing Crowtail Base Shield, and designed for transparent wireless serial connection setup. The serial port Bluetooth module is fully qualified BT Version V4.0 EDR + BLE dual mode with complete 2.4GHz radio transceiver and baseband. It has the smallest footprint of 13.8mm x 18mm. Hope it will simplify your overall design/development cycle.

Model: CT0018BLE

Features¶

• BT Version: Bluetooth Specification V4.0 BLE
• Working frequency:2.4GHz ISM band
• UART send and receive max bytes is 512.
• Other device to module in SPP mode: 90 Bytes per packet.
• Other device to module in BLE mode: 20 Bytes per packet.
• Two data transmission mode, balance mode and high speed mode.
• RF Power: -23dbm, -6dbm, 0dbm, 6dbm.
• Asynchronous Speed: 3K Bytes
• Synchronous Speed: 3K Bytes
• Service: Slave SPP, Peripheral BLE, UUID FFE0,FFE1
• Long range: SPP 30 meters, BLE 60 meters.
• Power: SPP 13.5mA, BLE 9.5mA.
• Working temperature:–5 ~ +65 Centigrade
• Dimensions(mm):40.0(L)x20.0(W)x6.8(H)

Usage¶

Connecting Bluetooth to PC through USB-UART converter¶

The Bluetooth provides a serial port with standard Crowtail socket, most USB-UART converter is able to use. In here we use a USBSerial adapter to connect Bluetooth and PC.

Connecting Bluetooth to Arduino¶

Since Arduino Uno have no Crowtail socket, we use Crowtail-_Base_Shield to instead. As an example, D2 and D3 are used as software UART, so plug the Crowtail cable into "U2" socket

Software Instruction¶

Conventions¶

• In EDR mode, only slave can be configured while either master or slave can be in BLE mode.

• Factory default setting:

  • EDR Name HMSoft, Slave role, PinCode 1234
  • BLE Name HMSoft, Slave role, PinCode 000000
  • Baud: 115200, N, 8, 1;

  • AT Command format:

  • Uppercase AT command format. string format, without any other symbol. (e.g. \r or \n).

  • Any incorrect command would be no response.

AT Commands¶

1. Test Command

If module is not connected to remote device will receive: “OK” If module has an error, will receive: “ER” If Module has connected, module will disconnected from remote device, if “AT + NOTI” is setup to 1, will receive information string
2. Query module EDR address

3. Query module BLE address

4. Query/Set Authentication mode

AT+AUTH0: allow made an insecure connection. AT+AUTH1: every connection must with authentication.
5. Query/Set A to B mode

This command must work with AT+MODE0 command. When A device (SPP mode) connect to the module and B device (BLE mode) is also connect to the module, The data string from A device send to the module will send to B device. The data string from B device send to the module is also send to the A device.
6. Query/Set baud rate

7. Clear bond information

BLE mode not supports it yet.
8. Clear Last Connected EDR Device Address

9. Clear Last Connected BLE Device Address

10. Query/Set Module DUAL Work Mode

AT+DUAL0: allow two connections at same time (SPP and BLE). AT+DUAL1: Only allow one connection at same time (SPP or BLE)
11. Query/Set hardware flow control switch

12. Query/Set module data transmission speed mode

In balance mode, we balanced SPP and BLE with a steady speed. In high speed mode, we don’t control speed, so SPP mode will got high speed. In high speed mode, module lost RESETB pin function, but you still could use “AT+RESET” command to reset module.
13. System Help Information

14. Query/Set module loaded notify

When “AT+INIT1” is setup, after module loaded, module will output “OK+INIT” string through UART.
15. Query/Set Module Work Mode

AT+MODE0: Only transfer data when connection establishment. AT+MODE1: Transfer data and response AT commands.
16. Query/Set Notify information

After AT+NOTI1, module will send connect or disconnect string through UART when module state is change: OK+CONE ======== EDR connect OK+LSTE ========= EDR disconnect OK+CONB========= BLE connect OK+LSTB ========= BLE disconnect OK+LSTA ========= except disconnect, module will reset after 500 ms.
17. Query/Set notify mode

This command must work with “AT+NOTI1”, if this switch is open, when the module connect to disconnect, the prompt string will include the remote address.
18. Query/Set Module EDR name

19. Query/Set Module BLE name

20. Query/Set PIO1 output status (System LED)e

21. Query/Set PIO output status

22. Query/Set EDR Pin Code

23. Query/Set BLE Pin Code

24. Query/Set UART parity bit

25. Restore all setup value to factory setup

26. Restart module

27. Query BLE RSSI value

This command must use after “AT+MODE1” is setup. This command is only used by remote Bluetooth device. 28. Query EDR RSSI value

29. Query Last Connected EDR Device Address

30. Query Last Connected BLE Device Address

31. Query/Set Master and Slaver Role

This command will take effect after module next power on or reset. 32. Query/Set EDR work mode

33. Query/Set UART stop bit

34. Query Software Version

Configure the Bluetooth module with Serial under Windows¶

This section shows how to configure Bluetooth with PC, some basic methods of setting could be learn. Set up hardware connection refer to “Hardware Installation” section. You will find the blue LED on the module flashes illustrate no connection is set up.
Open a serial terminal and set Baud Rate:115200, Databits: 8, Stopbits: 1 and No Flow Control. Send “AT” to Bluetooth with the serial terminal and “OK” will be return if all goes well. The Bluetooth only respond AT commands when no connection was set up, or all commands were seen as string and sent out. You can distinguish the status through LED indicates.

Then some useful configurations could be sent. Here’s are some samples of commands and response.
1. Test serial connection, send “AT”, will return “OK”.
2. Restore factory settings, send “AT+RENEW”, return “OK+RENEW”.
3. Reset baud rate of serial port, send “AT+BAUD2”, return “OK+Set:2”.
4. Enable authentication, send “AT+AUTH1”, return “OK+Set:1”.
5. Reset the Bluetooth, send “AT+RESET”, return ”OK+RESET”.
6. Query firmware version, send “AT+VERS?”, return “OK+Get:HMSoftV217”.
7. Query MAC of EDR, send “AT+ADDE?”, return “OK+Get:000E0E002074”.
8. Query MAC of BLE, send “AT+ADDB?”, return “OK+Get:000E0B002074”.
9. Set the name of EDR, send “AT+NAMEHM-13-EDR”, return “OK+Set:HM-13-EDR”.
10. Set the name of BLE, send “AT+NAMEHM-13-BLE”, return “OK+Set:HM-13-BLE”.
11. Set the password of EDR, send “AT+PINE123451”, return “OK+Set:123451”.
12. Set the password of BLE, send “AT+PINB123451”, return “OK+Set:123451”.
13. Enable discovery and connectable, send “AT+SCAN0”, return “OK+Set:0”.
14. Enable notify information of connection, send “AT+NOTI1”, return “OK+Set:1”.
15. Notify information include address, send “AT+NOTP1”, return “OK+Set:1”.
16. Enable user key, send “AT+PIO01”, return “OK+Set:1”.
17. Set to Central mode, send “AT+ROLB1”, return “AT+ROLB1”.
Or Set to Peripheral mode, send “AT+ROLB0”, return “AT+ROLB0”.

Data transmission between Two Arduinos¶

1.Prepare a pair of Bluetooth, and Arduino or other platform to control them. Here we use two Arduino Uno.
2.Set up the connection as mentioned in section “Hardware Installation”.
3.The program of Central and Peripheral use the same code, the only difference is the micro define at the beginning of the program. To assign the Bluetooth to Central role, Just need to modify the text to “#define MASTER 1”, or “#define MASTER 0” if Peripheral role was assigned.
4.The initialisation program flow please refer to the following flow chart. First of all we need to distinguish the presetting baud rate of the Bluetooth. After this, send commands to restore factory settings, and change baud rate from 115200 to 9600 since software serial will not working well at high baud rate. Then other parameters were configured to the Bluetooth with Reset command in the final.

After the initialisation, the Central and Peripheral will do different things, the Central will send message to Peripheral interval and print what received from Peripheral while the Peripheral only responds the Central.
5.Click here to download the test code and open HM-13_SW.ino with Arduino IDE, compile and download to Arduino Uno. Remember to configure the Bluetooth to different role by modify the macro at the beginning.
6.After downloading program, open two serial terminal windows, the LEDs on Bluetooth will flash, several seconds later, they stop to flash and keep on, this indicates that they connected to each other. According to the program is written, the Central sends message to the Peripheral continually and get feedback every time.

Resource¶

• Blutooth Low Energy Module Program
• Blutooth Low Energy Module eagle files
• HM-13 reference