Microduino Bluetooth (BLE) USER GUIDE.

Transcription

1 Microduino Bluetooth (BLE) USER GUIDE

2 Content Features... 2 Specification... 2 Document... 3 Main Components...3 Andriod APP...3 Development... 3 Serial Port Communication Requirements...3 Use PC to Debug...4 Use USBTTL and Core to Download and Debug...4 Communicate with Android Device...5 Communicate with IOS Device...6 Communicate with MAC Device Extension Use AT to view or change the parameter of BT Pin Description Application Program Download Serial Port Debug Shield BT4.0 by CoreUSB Have serial debugging of BT module by uart1 of Core Intercommunication between Two Microduino-BT Modules Microduino BT Serial port Transmits Data to IOS Device A simple test of Microduino-Shield BT FQA

3 Microduino-BT is a BLE serial transparent transmission module based on CC2541 chip. It is custom-made for U-shaped 27PIN standard interface of Microduino. Features Adopt Microduino UPIN27 standard interface, working by stacking with other Microduino modules; Adopt TI CC2541 chip with low consumption; Support ibecons mode; Multiple ways to restore factory settings; o Use "AT+ RENEW\r\n" instruction to restore; o Test pin DEF to GND and then power on the module. The LED light blinks after LED 1 keeps on for three seconds and meantime, loose DEF and factory reset succeeds, you can see the LED light blinks every one second. Capable of data power-off preservation function; Support AT instruction and flexible to change serial baud rate, device name, code matching as well as other parameters according to various needs; Small, cheap, stackable and open source; Open source hardware circuit design and Arduino compatible programming development environment; Uniform Microduino interface standard and rich external modules, flexible to connect with other Microduino modules and sensors; 2.54 pin pitch interface makes it easy to be integrated to pegboard. Specification Way of Communication: Serial port transmission and the default serial port is D4(RX), D5(TX); Power Supply: +3.3VDC 50mA; Bluetooth Protocol: Bluetooth Specification V4.0 BLE; Service Support: Central & Peripheral UUID FFE0,FFE1; Frequency: 2.4GHz ISM band; Way of Modulation: GFSK(Gaussian Frequency Shift Keying); Transmit Power: 4dBm; Flexibility: -84dBm at 0.1% BER; Transmission Rate: o Asynchronous: 6 kbps; o Synchronous: 6 kbps; Status Indicator: o Before connection: 2

4 Host machine indicator keeps on for 100ms every second when not recording slave machine address; Host machine indicator keeps on for 900ms every second when recording slave machine address; Slave machine indicator keeps on for one second every two seconds. o After connection: o The indicator of both the host and the slave machine keeps on for 100ms every five seconds. During the transmission, each data package should include less than 120 bytes. The higher the baud rate is, the longer transmission interval is. There exists loss rate during Bluetooth data transmission. So users should be ready for retransmission or data check. ibeacon has been integrated. Set by AT instruction "AT+MODE2\r\n" can be achieved only under slave machine. o Work mode: 0(transmission), 1(Direct drive) and 2(iBeacon); o ibeacon can be tested by Locate ibeacons offered on App Store. Document Eagle PCB File: Microduino-BT Shield.zip Main Components CC2541_datasheet: CC2541.pdf Andriod APP APP Installation package: BT_APP.zip APP Source: If you want to develop your own app referring to the android code in Github, you need pay attention that the UUID must be same with the UUID of Microduino-BT. Development Serial Port Communication Requirements Default serial configuration is: o Baud rate: 9600 o No check 3

5 o Data bit 8 o Stop bit 1 For Arduino IDE serial monitor: o Set to: "\r\n", "9600baud" For other serial debugging software: o Baud rate 9600 o No check o Data bit 8 o Stop bit Use PC to Debug Debug by serial port: o Do not stack Microduino-USBTTL directly and cross connect RX(D4) and TX(D5) of Microduino-USBTTL and Microduino-BT. Use USBTTL and Core to Download and Debug If it keeps using the default jumper (RX0, TX1): Unplug the Microduino Shield BT4.0 during downloading the program; If you want to change the jumper cables to meet your requirement, you need to cut the connection between two intermediate of the pad and RX0/TX1, and then connect them to D2, D3 (or D9, D10). If it needs to change the jumper, you can change the serial connection of Microduino Shield BT4.0 and Microduino Core from "TX-RX0, RX-TX1" to: TX-D2, RX-D3 (For Core+'s Serial1) TX-D9, RX-D10 (you can adopt SoftwareSerial libray to solve the problem) Program 1. //Use SoftwareSerial to use other soft serial ports. 2. #include <SoftwareSerial.h> 3. SoftwareSerial myserial(4, 5); #define my_serial myserial //Use soft serial ports 4 and //#define my_serial Serial1 7. String msg = ""; //To define a string void setup() 10. { 11. // Initialize the Bluetooth communication baud rate. 12. my_serial.begin(9600); 13. // Initialize the serial communication baud rate monitor. 14. Serial.begin(9600); 4

6 15. } 16. void loop() 17. { 18. //Every time receive a signal, feedback to the other end of the communicat ion. 19. if (my_serial.available() > 0) //If there are signals being transferred i nto the serial port. 20. { 21. msg = my_serial.readstringuntil('\n'); //Get all the contents before the newline character. 22. Serial.println(msg); //The serial monitor displays the string received in the MSG. 23. my_serial.println("^_^ Hello,Microduino!"); //Send data to the other en d of Bluetooth communication. 24. } 25. } Communicate with Android Device Only mobile phones with 4.3 and above system can communicate with Microduino-BT; Download Android communication software, and install it to the mobile phone; File:MSerial.zip Step 1: Download programs to Microduino; Step 2: Begin to set Android device. Open the bluetooth of the Android deice, open the App, and open the serial port monitor at the computer IDE; 5

7 Step 3: Click on the SCAN button at the top right corner of the App, which is used to search bluetooth access point around, and after clicking on the button, it will display surrounding bluetooth devices. Click the corresponding Microduino bluetooth number. After entering the interface, waiting about 2-3 seconds. When it changes into "Serial ready" on the top right corner of the screen, the mobile phone has been connected to the Bluetooth. The mobile sends English characters to Microduino, and the serial port monitor receives them. At the same time the mobile phone has received "^_^ Hello, Microduino!" that is sent by Microduino, which has proved the bidirectional communication function of Bluetooth. Communicate with IOS Device Above iphone 4s, ipod touch 5, ipad 3, and ipad mini; 6

8 Go to App Store to download LightBlue: Step 1: Download the program to Microduino: Step 2: Install "lightblue". Open the software, and set the IOS device. Open the bluetooth of the IOS device. And open the serial port monitor on computer IDE. 7

9 Step 3: Open LightBlue: The interface that you have entered is bluetooth device searching interface. Find the bluetooth device of Microduino from the list under "Peripherals Nearby", and click it to connect it with the mobile phone; After connecting, you will enter the interface as following: 8

10 Step 4: Choose and click Characteristic6, and look at the format of the code at the top right corner of the screen, and the default is Hex 16 binary code. If you want it displays the string, please click on the button where the Hex is and choose UTF-8 code format. Then click "Listen for notifications" to make the mobile phone into listening state. Step 6: Click "Write new value", and the text editing interface will come out. 9

11 Custom input a string of English and digital, and observe the result that the mobile and serial port display. You can see from the picture that the serials have received the "12345" that the mobile phone sent, and the mobile also has received the "Bluetooth respond" that the Bluetooth returned. It proves that the Bluetooth two-way communication is smooth. 10

12 Communicate with MAC Device Mac Bluetooth can't connect with BT search directly, so you need to use Light Blue to develop and download. Connect the Microduino-Core and BT module to the computer, and download the same code. Open the Arduino serial port monitor, then open Light Blue, and you will the Microduino device has been identified. Click Microduino to connect with the Bluetooth. After the connection, the serial port monitor will print out Connected. At the same time, the Bluetooth indicator light will slightly twinkle (the frequency is mare faster, and the lightness is lower). Choose as the following picture, and then send messages to BT module, such as mcookie. 11

13 You will see the serial port monitor prints Microduino. Extension Use AT to view or change the parameter of BT AT command configuration/control document: Microduino-BLE.pdf (zh_cn) Program 1. //Use SoftwareSerial to use other soft serial ports. 2. //#include <SoftwareSerial.h> 3. //SoftwareSerial myserial(4, 5); // RX, TX //#define my_serial myserial 6. #define my_serial Serial1 //Define serial ports CoreUSB and BT void setup() 9. { 10. Serial.begin(9600);//Serial communication baud rate monitor 11. my_serial.begin(9600);//bt communication baud rate. 12. } void loop() 15. { 16. if (Serial.available())//Monitor the data of the serial port monitor. 17. my_serial.write(serial.read());//write data into BT. 18. if (my_serial.available())//monitor the data of BT serial port. 19. Serial.write(my_Serial.read());//Print the data in the serial port monit or. 20. } 12

14 Program download o Stack the mcookie-bt and mcookie-coreusb togethe. Insert the USB cable into the jack of mcookie-coreusb, and connect the other end to the USB port of the computer; o Start Arduino IED, and copy the program to IDE; o Choose Microduino CoreUSB at tools -> Board, and choose the corresponding serial port number at tools -> Serial; o Click on the compile ( ) at the top left corner of the IDE co compile the program. After finishing profiling, click the download (->) button to write the program to the board; Open the serial port monitor, and set it as: "\r\n", "9600baud". Input the specified commands in the serial port monitor, and you can see the result returned. And the reference document can change the parameter of BT. Use software serial port communication program: 13

15 1. //Use SoftwareSerial to use other soft serial ports. 2. #include <SoftwareSerial.h> 3. SoftwareSerial myserial(4, 5);//According to the serial port selected, selec t the corresponding port numbers (2, 3) or (4, 5) #define my_serial myserial String msg = ""; void setup() 10. { 11. //Initialize the Bluetooth communication baud rate. 12. my_serial.begin(9600); 13. // Initialize the serial communication baud rate monitor. 14. Serial.begin(9600); 15. } 16. void loop() 17. { 18. //Every receiving the signal, feedback to the other end of the communicati on 19. if (my_serial.available() > 0) //If there are data transferred into the s erial ports. 20. { 21. msg = my_serial.readstringuntil('\n'); //Get all the contents before the newline character. 22. Serial.println(msg); //The serial monitor displays the string received in the MSG. 23. my_serial.println("bluetooth respond"); //Send data to the other end of the bluetooth communication. 24. } 25. } Pin Description 14

16 Application Program Download Program test: File:BLE debug uart1.zip,file:ble LightBlue time.zip Serial Port Debug Shield BT4.0 by CoreUSB Hardware: Microduino CoreUSB and Microduino BT; Software: Arduino IDE (version 1.0 or higher) and Microduino test program (Arduino end); o Other conditions: Users can change the jumpers back of the module and change the serial port to RX0(D0) and TX1(D1);(Because CoreUSB can use USB to simulate 0(Serial), and RX0 and TX1 is the (Serial 1) of CoreUSB); Start Arduino IDE, open Microduino test program and choose Microduino- CoreUSB as the board and download directly; Check if the serial communication is OK or not: o Send "AT"(with \r\n behind) after opening the serial monitor and if the return is "OK", it means the configuration is successful. Have serial debugging of BT module by uart1 of Core+ Hardware: Microduino USBTTL, Microduino Core+ and Microduino BT; 15

17 Software: Arduino IDE (version 1.0 and higher) as well as Microduino test program (Arduino end); Other conditions: Users can change the jumpers back of the module and change the serial port to D2 and D3; Start Arduino IDE, open Microduino test program and choose board Microduino Core+( and download; Check the status of the serial communication: o Send "AT"(with \r\n behind) after opening the serial monitor and if the return is "OK", it means the configuration is successful. Intercommunication between Two Microduino-BT Modules Step 1: Two BT modules match the connection. o Please refer to: Connection Method for New Version Step 2: o The default is the soft serial port (D4, D5). Here we introduce the connection method of the default serial port. If you want to change jumpers, you need to change program of the serial port correspondingly. Note: Baud rate should be below If using serial1 (D2, D3): o If using Core to debug, please change SoftwareSerial myserial(4, 5) to SoftwareSerial myserial(2, 3) ; o If using Core+ to debug, please change program myserial to Serial1. (D2, D3) corresponds to Serial 1 of Core+ 1. #include <SoftwareSerial.h> 2. SoftwareSerial myserial(4, 5); // RX, TX void setup() 5. { 6. // Open serial communications and wait for port to open: 7. Serial.begin(9600); 8. // set the data rate for the SoftwareSerial port 9. myserial.begin(9600); 10. } void loop() // run over and over 13. { 14. if(serial.available()) 15. { 16. myserial.write(serial.read()); 17. } 18. if(myserial.available()) 19. { 20. Serial.write(mySerial.read()); 21. } 22. } Download the Program to the core board and you can send data through serial port input. 16

18 Note: After connection, AT instruction doesn t work. 17

19 Microduino BT Serial port Transmits Data to IOS Device Note: If you use Android device to debug, you need to make sure the system should be version 4.3 or higher so that Microduino-BT can be detected. A simple test of Microduino-Shield BT4.0 A simple test of Microduino-Shield BT4.0 颜火山 (Technical Blog in Chinese) FQA The module can't make pair with win7? o Please check its version in win 7, which only support BLE 4.0 version and the default password is How to reset the module? o You can adopt power-on reset or send AT instruction "AT+RESTART\r\n" through the serial port. It can't make pair with iphone or Android phones? o This issue is mostly caused by the version of the BT. This module only supports BT4.0 protocol. o For Andriod OS: 4.3 and higher o For IOS: iphone 4s and higher, ipod Touch 5 and higher, ipad 3 and higher,ipad mini and higher. 18