{"id":718,"date":"2015-05-07T16:45:53","date_gmt":"2015-05-07T23:45:53","guid":{"rendered":"http:\/\/appinventor.pevest.com\/?p=718"},"modified":"2015-05-07T16:45:53","modified_gmt":"2015-05-07T23:45:53","slug":"how-to-connect-app-inventor-apps-to-arduino-using-bluetooth-wireless","status":"publish","type":"post","link":"https:\/\/coldstreams.com\/appinventor\/2015\/05\/07\/how-to-connect-app-inventor-apps-to-arduino-using-bluetooth-wireless\/","title":{"rendered":"How to connect App Inventor apps to Arduino using Bluetooth wireless"},"content":{"rendered":"

How to Connect App Inventor apps to Arduino Using Bluetooth<\/h2>\n

Bluetooth is a low power, short range wireless technology built in to many phones, tablets and other devices.<\/p>\n

MIT App Inventor 2 supports a set of Bluetooth communication functions that may be used to send data between smart phones and tablets (see previous tutorials: Part 1<\/a>, Part 2<\/a>)<\/p>\n

This capability may be extended so that App Inventor apps can communicate with Arduino-based devices and other embedded systems.<\/p>\n

This tutorial describes how to interface App Inventor apps running on Android to Arduino devices, via the Bluetooth wireless link.<\/em><\/span><\/p>\n

What is Bluetooth?<\/strong><\/h2>\n

Bluetooth is an industry standard for low power, short range wireless communications between devices such as personal computers, printers, smart phones, tablets, wireless headphones, wireless stereo speakers, sensor systems (like in security alarms) and other applications.<\/p>\n

To learn more about Bluetooth technology (and why it has a funny name!), please read our first tutorial on Bluetooth<\/a>.<\/p>\n

What is Arduino?<\/strong><\/h2>\n

Arduino is an open hardware, open software platform for building small electronic devices. The Arduino board is a “microcontroller” – that is, a complete – albeit small, inexpensive and with limited function – computer. Arduino is a popular choice for do-it-yourself projects and is well established in the “Maker” community of DIY project builders. (Side note: I will be at the San Francisco Maker Faire on Saturday, May 16th, 2015).<\/p>\n

This is not a tutorial about Arduino boards, software or electronics<\/span><\/em> and presumes the reader is familiar with Arduino development<\/em><\/span>.<\/span> <\/strong>To learn more about Arduino (and you should learn more about it!) start at the Arduino web site<\/a>.<\/p>\n

This tutorial assumes you have the Arduino software development environment installed on your computer and are familiar with Arduino development.<\/em><\/p>\n

HARDWARE: Setting Up Arduino for Bluetooth Wireless Communications<\/strong><\/h2>\n

There are several versions of the Arduino board; I used the Uno<\/em> version but others should work just fine.<\/p>\n

The Arduino board does not contain Bluetooth hardware – to implement Bluetooth requires using a third-party Bluetooth module. I use the JY-MCU Bluetooth module . IMPORTANT – not all Bluetooth modules will work with App Inventor!\u00a0 While new versions of Android support all versions of Bluetooth, App Inventor (at the time of this writing) supports “classic” Bluetooth only. In particular, App Inventor does not support the newer Bluetooth LE (Low Energy) version, at least it does not support the Bluetooth LE module that I have.<\/strong><\/p>\n

I can confirm that the JY-MCU Bluetooth module works but the Bluetooth LE modules I have do not work with App Inventor.\u00a0 My phone can see the Bluetooth LE device but the App Inventor source code cannot communicate with the LE devices.<\/p>\n

Where to buy the JY-MCU Module online: Amazon (Prime)<\/a>, Amazon (non-Prime)<\/a><\/p>\n

The module is also available from other vendors.<\/p>\n

Photo shows my Arduino UNO board, at left, a prototyping breadboard with a status LED set up, and the JY-MCU Bluetooth module, just above the breadboard.<\/p>\n

\"DSC_1266\"<\/a>Click through to\u00a0 see how the Arduino and Bluetooth module are setup, and get the Arduino source code and the App Inventor source code!<\/em><\/p>\n

<\/p>\n

To learn how to set up this hardware, please refer to this external tutorial from roboTosh<\/a> on setting up the JY-MCU Bluetooth module with your Arduino board. Be sure to use the sample Arduino source code on that web page to test your hardware set up and verify that everything is working.<\/p>\n

The hardware configuration sets up power and interface to the JY-MCU module, and configures a single LED as a status indicator when the code is running.<\/p>\n

In the test case (on that page), you’ll program the Arduino using the USB-serial link, and then run the Arduino Serial Monitor to type commands to the Arduino board. Type ‘H’ to turn on the status LED light, and then type ‘L’ (actually anything other than H) to turn the light off.<\/p>\n

ARDUINO SOFTWARE: Arduino Source Code for Bluetooth Communications<\/strong><\/h2>\n

Once the Arduino and JY-MCU hardware are set up,\u00a0 install the software on the Arduino board.<\/p>\n

You may download the following source code as both a text file (.txt) and as an Arduino .ino project file (see end of this post for download links).<\/p>\n

A description of what this Arduino code does and how it works follows the code listing. If you are not familiar with Arduino source code, it is similar to the C++ programming language.<\/p>\n

\/*\nBTArduino sketch By Edward Mitchell http:\/\/appinventor.pevest.com\nDescription:\nUses the JY-MCU Bluetooth module to enable an Arduino board to communicate over Bluetooth\nwireless to an Android app written in MIT App Inventor 2, running on an Android device.\n\nBuy the JY-MCU module here\n(Amazon Prime) http:\/\/www.amazon.com\/gp\/product\/B0093XAV4U\/ref=as_li_tl?ie=UTF8&camp=1789&creative=390957&creativeASIN=B0093XAV4U&linkCode=as2&tag=commonsensevi-20&linkId=4L5VQJW7JJKBGCMU\n(Amazon non Prime option) http:\/\/www.amazon.com\/gp\/product\/B009DZQ4MG\/ref=as_li_tl?ie=UTF8&camp=1789&creative=390957&creativeASIN=B009DZQ4MG&linkCode=as2&tag=commonsensevi-20&linkId=S6VEEZVTF4GBGYWC\n\nCredit:\nThis Arduino code based very loosely on the original Arduino code for the JY-MCU Bluetooth module tutorial at\nhttp:\/\/robotosh.blogspot.com\/2012\/07\/arduino-jy-mcu-bluetooth.html\n\nA tutorial for using this code with App Inventor 2, is available at the appinventor.pevest.com\nweb site. Please refer to the tutorial for information and source code for the Android side of this sketch.\n\nNote - this sample code is intended only to show how the basic Bluetooth communications link may\nbe set up, and illustrates just one possible way of sending commands from the Android device\nto the Arduino phone. The purpose of this code is as an introduction\/tutorial and is not meant\nto be used for any particular purpose. No warranties.\n*\/\n\n\/\/ Constant Definitions\n#define LEDPIN 8 \/\/ Pin on Arduino board to which status LED is connected\n#define READ_RATE 100 \/\/ How often the serial link is read, in milliseconds\n#define FLASH_RATE 100 \/\/ The on\/off period in milliseconds, for the LED Flash status feedback\n\n\/\/ Declarations\nbyte cmd; \/\/ Stores the next byte of incoming data, which is a \"command\" to do something\nbyte param; \/\/ Stores the 2nd byte, which is the command parameter\n\n\/\/ Initialization\nvoid setup() {\n\npinMode(LEDPIN, OUTPUT); \/\/ pin 48 (on-board LED) as OUTPUT\ndigitalWrite(LEDPIN, LOW);\nSerial.begin(9600); \/\/ start serial communication at 9600bps\n}\n\n\/\/ Arduino Execution Loop\nvoid loop() {\n\nif ( Serial.available() ) \/\/ if data is available to read\n{\ncmd = Serial.read(); \/\/ read it and store it in 'cmd'\n\/\/ Data format is byte 1 = command, byte 2 = parameter\n};\n\nswitch ( cmd ) {\ncase 1:\n\/\/ First byte contains a generic \"command\" byte. We arbitrarily defined '1' as the command to then check the 2nd parameter byte\n\/\/ User can additional commands by adding case 2, 3, 4, etc\n{\n\/\/ read the parameter byte\nparam = Serial.read();\nswitch (param)\n{\ncase 1:\n\/\/ Android device requests the Arduino to send some data back to Android\nflashLED(1);\nif (Serial)\n{\n\/\/ Send back 2 bytes with a value of 1, 2\nSerial.write(1);\nSerial.write(2);\n};\nbreak;\ncase 2:\n\/\/ Turn on status LED\nflashLED(2);\ndigitalWrite(LEDPIN, HIGH );\nbreak;\ncase 3:\n\/\/ Turn off status LED\nflashLED(3);\ndigitalWrite(LEDPIN, LOW);\nbreak;\ncase 4:\n\/\/ Demonstrate flashing the LED 4 times\nflashLED(4);\nbreak;\ncase 5:\n\/\/ Demonstrate flashing the LED 5 times\n\/\/ Could add code here to control a servo via PWM outputs\nflashLED(5);\nbreak;\ndefault: break; \/\/ do nothing\n} \/\/ switch (param)\n} \/\/ switch (cmd) case 1\ndefault: break; \/\/ do nothing\n} \/\/ switch (cmd)\n\ndelay(READ_RATE); \/\/ wait 100ms for next reading\n}\n\n\/\/ Support routine\nvoid flashLED (int n) {\n\/\/ Flash the LED n times, to provide an on board status indicator\nfor (int i=1; i<=n; i++) {\ndigitalWrite (LEDPIN, HIGH);\ndelay (FLASH_RATE);\ndigitalWrite (LEDPIN, LOW);\ndelay(FLASH_RATE);\n};\nreturn;\n}\n<\/pre>\n
Description of the Arduino Code<\/strong><\/p>\n
This description assumes you are familiar with Arduino projects.<\/p>\n
The basic operation configures a Serial<\/em> port to communicate with the JY-MCU module. Data is\u00a0 received or transmitted between the JY-MCU module using the Serial<\/em> interface.<\/p>\n
This project defines a very simple protocol for communicating between the Arduino and the App Inventor app running on an Android device.<\/p>\n
The protocol is merely a 2-byte sequence. The first byte contains a value that we interpret as a “command”, and the second byte contains a parameter value for the command. When the code reads incoming data from the JY-MCU module, the first byte is stored in a variable named cmd<\/em> and the second byte is stored in a variable named param<\/em>.<\/p>\n
The initialization code, in setup<\/em>() sets the Serial<\/em> data rate to 9600 bps as this is the default data rate on the JY-MCU module. The module may be configured to use different (and faster) data rates but for this tutorial, the data rate is left at the default value of 9600 bps.<\/p>\n
The loop<\/em>() section of the Arduino code reads an incoming cmd<\/em> byte value, and then uses a switch<\/em> statement to select from among a set of possible values. This tutorial implements only a command value of 1; you can add additional values to define additional commands. For a command of 1, the 2nd byte is then read as the parameter value. (One could define a command value of say, 2, and then define that the next several bytes contains a text string, for example.)<\/p>\n
Depending on the parameter value (2, 3, 4, etc) a different function may be performed. As defined here, a value of 2 turns on the status LED; a value of 3 turns off the status LED.<\/p>\n
A parameter value of 1 tells the Arduino to send 2 bytes of data back to the App Inventor app, via the Bluetooth connection. This could be modified to send back other types of data (2 byte or 4 byte numbers or text strings).<\/p>\n
Additionally, the LED flashes the value of the parameter byte. For example, if a parameter value of 4 is received, the LED flashes 4 times, to provide visible feedback.<\/p>\n
You can modify this code to implement new functions on the Arduino that are controlled remotely from the App Inventor app. For example, you could define that a parameter value of 4 means to set pin 9 of the Arduino HIGH and a parameter value of 5 means to set pin 9 to LOW. You could also use this to pass control information to operate a PWM interfaced servo or motor.<\/p>\n
Finally, flashLED<\/em>() is a simple function to flash the LED the number of times indicated by its argument.<\/p>\n
APP INVENTOR 2 SOFTWARE for Bluetooth<\/strong><\/h2>\n
The “Bluetooth Client for Arduino” is based on the similar client code introduced in the part 1 and 2 tutorials on Bluetooth. The app provides a simple interface to connect to the Bluetooth device, to disconnect from the device, to send a numeric value (such as 1, 2, 3, etc) and to display link status and data received from the Arduino.<\/p>\n
The blocks code for this app may be downloaded at the link provided at the end of this tutorial.<\/p>\n
\u00a0The Designer View<\/strong><\/p>\n
The user interface has 3 buttons: Connect to device, Disconnect device and Send Numeric.<\/p>\n
Labels<\/em> are used to display status and received data.<\/p>\n
The User Interface, as seen in the MIT App Inventor Designer:<\/p>\n
\"BTClient_ArduinoDesigner\"<\/a>The App Inventor App In Operation<\/strong><\/p>\n
FIRST! “Pair” Your Bluetooth Devices!
\n<\/strong><\/em><\/p>\n
Prior to running the App, you must go into the Android Settings | Bluetooth options and “pair” the JY-MCU Bluetooth module with your Android phone. With the Arduino and JY-MCU powered up, you should see a device named “HC-06”. Please see the section titled Setting Up A Bluetooth Connection<\/strong> in Part 1: Basic Bluetooth communications using App Inventor<\/a>. You may need to enter a pairing code of “1234” to set up the HC-6 device. (See\u00a0 the roboTosh<\/a> link for details on that.)<\/p>\n
Once the app is running, you should see that the link is Disconnected.<\/p>\n
\"Screenshot_2015-05-07-15-34-30\"<\/a>Select Connect to device.<\/p>\n
The app displays a list of potential Bluetooth devices. Select the HC-06 device from the list. There will be a pause for a second or two as the connection is established.<\/p>\n
\"Screenshot_2015-05-05-17-48-39\"<\/a><\/p>\n
If you see the following error message when you attempt to connect, it means your Arduino\/Bluetooth module is probably not powered up or is too far away:<\/p>\n
\"Screenshot_2015-05-07-15-39-26\"<\/a><\/p>\n
Once the link is set up, the Link status will display “Client connected”:<\/p>\n
\"Screenshot_2015-05-07-15-34-47\"<\/a><\/p>\n
Enter a numeric value of 2 and press Send Numeric – the status LED should turn on. To turn it off, enter a value of 3 and press Send Numeric – the status LED should turn off. Note that the LED will also flash a number of times equal to the numeric value sent.<\/p>\n
\"Screenshot_2015-05-07-15-35-02\"<\/a><\/p>\n
To demonstrate sending data from the Arduino device to the App Inventor app, enter a numeric value of 1 and press Send Numeric. A moment later you should see that the Data received status displays “1,2”:<\/p>\n
\"Screenshot_2015-05-07-15-35-24\"<\/a><\/p>\n
\u00a0The Blocks Code<\/h2>\n
The original Bluetooth client code (see the original Parts 1 and 2) has been simplified to do only what is needed for the Arduino link.<\/p>\n
The Send Numeric click event handler sends the numeric value across the Bluetooth link. For simplicity, only positive numbers are permitted (the absolute<\/em> value function converts negative values to positive values), and since a byte may only represent values between 0 and 255, anything larger is set to 255.<\/p>\n
The command byte value of 1 is sent, followed by the numeric value:<\/p>\n
\"BTArduino_SendNumeric\"<\/a>Data is received inside the Click Timer event. The two incoming bytes are read and displayed on the screen:<\/p>\n
\"BTArduino_TimerEvent\"<\/a>Key Features Shown<\/h2>\n