Showing posts with label Basic. Show all posts
Showing posts with label Basic. Show all posts

Monday, September 1, 2014

Basic: HC-06 Bluetooth Module


Hi. It has been a while since my last post. I was busy with the Eid preparation, getting my driving license, babysitting, etc. Finally I have some free time to write a short post about a Bluetooth module, HC-06. As always, this module is purchased from GI Electronic which you may view here. It's considerably cheap and easy to use.

Living in advance technology era, I believe all of you have at least heard about Bluetooth technology before. Contrary to some belief, this module is actually very simple to use; programming-wise speaking. The only drawback is that you'll need to attach 2 resistors (1kΩ and 2kΩ) on the module's RX pin. This is because the module is working at 3.3V. We'll see this later. The module will allow you to perform simple serial communication from/to your computer, smartphone, tablet, etc. There's just a lot of things that you can do with it due to its flexibility. In fact, I'm currently working on reviving my brother's RC car using this module. Now, I can control the RC car using my smartphone and my computer. Now, let's get down to business.

Connection

I actually use 2kΩ for R1, but I think 2.2kΩ should also works just fine. Make sure the connection is correct. Triple-check it!


You can actually use the hardware RX (0) and TX (1) pins on Arduino (like diagram above), but I use the pin 2 and 3 instead because pin 0 and 1 will be used for serial monitor. Using pins other than hardware RX and TX pins requires us to use SoftwareSerial library instead. If you are using the hardware RX and TX pin, simply write Serial.begin (baud rate);
How to connect to the device, then? In the following examples, I'm going to connect to the module using my computer and my Android phone. I simply search for the available device and connect to it. The default password is: 1234.
To connect and send/receive messages from/to Android phone, go to Play Store and search for Bluetooth Terminal. There should be a bunch of them. I've tried using "ArduDroid" and "ArduinoRC". Both works just fine.
If you want to change the device's name, password, and others, refer to the product's guideline.

Programming
If you are used to writing programs to display messages in the Serial Monitor, this would be a walk in the park. The coding is almost similar. If you're using the hardware RX and TX pin, the coding should be exactly the same, but you wouldn't be able to use the Serial Monitor.
btmodule.read () will return whatever the Bluetooth module is receiving from the connected device.
btmodule.write ("message") will send the message to the connected device.
Simple, isn't it?

#include <SoftwareSerial.h>

SoftwareSerial btModule(2, 3);

void setup() {
  Serial.begin(19200);
  btModule.begin(9600);
}

void loop() {
  if(btModule.available()) {
    Serial.write(btModule.read());
  }
  
  if(Serial.available()) {
    btModule.write(Serial.read());
  }
}

Using the code above, you may send and receive messages from computer to an Android phone or other bluetooth devices with Arduino as the middleman. What you need to do is, install a bluetooth terminal on your smartphone and connect to the bluetooth module, not the computer's bluetooth device. I use ArduDroid. You may find more information about it here. The LED on the bluetooth module should stop blinking after connected to a device. While the Arduino still connected to the computer, open the Serial Monitor. Type something and press "Enter". The message should be sent to the device connected to it. You can also try to type something and press "Send Data" in the ArduDroid application and you receive a line with symbols, numbers, and finally your message. We'll discuss what those numbers mean later. But now you should understand how easy it is to do it, right?

Alright. Now, let's discuss a little bit about ArduDroid. The message that you receive is in form of *number|number|number|message# when sending message and *number|number|number# when pressing the Digital Write and changing the value for Analog Write. It is actually like this. * marks the beginning of the message. # marks the end of it. | separates the values of message code, pin number and value, respectively. To simplify the usage of it, I wrote a rather simple library which you may download here.

After extracting it to the Arduino's library folder, run the following code:

 
#include <SoftwareSerial.h>
#include <ArduDroid.h>

ArduDroid btModule(6, 7);

void setup() {
  Serial.begin(19200);
  Serial.println("Starting...");
}

void loop() {
  if(btModule.available()) {
    if(btModule.getMessageCode() == 12) {
      Serial.print("Message Received: ");
      Serial.println(btModule.getMessage());
    }
    else {
      Serial.print("Setting value of pin ");
      Serial.print(btModule.getPinNum());
      Serial.print(" to ");
      Serial.println(btModule.getValue());
      btModule.executeCommand();
    }
  }
  
  if(Serial.available()) {
    char message[50] = "";
    int i = 0;
    
    while(Serial.available()) {
      message[i++] = (char) Serial.read();
    }
    
    btModule.sendMessage(message);
    Serial.print("Sent Message: ");
    Serial.println(message);
  }
}

The code above will allow 2-ways communication between your Android phone to the Arduino. I guess the code is quite self-explanatory. Still, if you have any question, do comment below.
I hope this tutorial may help you develop more interesting things and increase you creativity and functionality of your project. Until next time, good bye.

Saturday, July 5, 2014

Basic: HMC5883L (Digital Compass)

Hi, everyone. I am actually waiting for the time for breakfast. I'm writing this post to take my mind off the meal. So, this time, it's about a digital compass; HMC5883L which I bought from GI Electronic.


When I first played around with it, it was quite complicated, but soon enough, I manage to understand most of the important part of it. I wrote a library to make it even simpler to use, which can be found here or here.

Introduction

This module is actually a digital compass, which probably means that you've understand what it should do. It is a compass, which measures the magnetic strength around it in 3 axis; X, Y and Z. This module is using I2C communication. It is a famous type of communication and I really like it as it basically uses only 2 wires, SDA and SCL, and multiple devices could be connected on the same pin at the same time.

Connection

In the following diagram, notice that the pins listed aren't really accurate as the sketch is using a product by Adafruit, not the one sold by GI Electronic. The pins are equivalent as:

VIN = VCC
GND = GND
3vo = -
SDA = SDA
SCL = SCL
RDY = DRDY




Code

The following code simply prints the output or the degree based on X and Y axis.

#include <HMC5883L.h>
#include <Wire.h>

HMC5883L compass;

void setup(){
  Serial.begin(19200);
  compass.init();
}

void loop(){
  if(compass.available()) {
    Serial.println(compass.getHeading());
  }

  delay(100);
}

Important Note

By observing the serial monitor, turn the digital compass until the value move closer to 0 or 360. When you manage to get that value, you are actually finding the magnetic north. However, relying on the magnetic north alone is unwise especially when it comes to navigational use. At long distance, 1 degree difference could end up quite far. Be sure to deduct or add the declination angle according to where you are situated at to get the true north.

Look for your declination angle here: http://magnetic-declination.com/

About the library


Constructor (HMC5883L)
  • Prototype:
    • HMC5883L::HMC5883L(int address = 30);
  • Description:
    • Create the HMC5883L object and set the address of the module.
  • Arguments:
    • address: The address of the module with default value of 30 or 0x1E.
  • Returns:
    • None
  • Usage:
    • Outside any function. (Global)


init
  • Prototype:
    • void HMC5883L::init();
  • Description:
    • Begin the data transmission and selecting the continuous measurement mode.
  • Arguments:
    • None
  • Returns:
    • Void
  • Usage:
    • Inside setup() function.

available

  • Prototype:
    • bool HMC5883L::available();
  • Description:
    • Check if the data is available.
  • Arguments:
    • None
  • Returns:
    • true: if data is available.
    • false: if data is not available.
  • Usage:
    • Inside if block.

getHeading

  • Prototype:
    • double HMC5883L::getHeading();
  • Description:
    • Get the angle from North calculated between X and Y axis.
  • Arguments:
    • None
  • Returns:
    • Angle calculated between X and Y axis.
  • Usage:
    • Inside if block after ensuring data availability.

getAngleXY

  • Prototype:
    • double HMC5883L::getAngleXY();
  • Description:
    • Get the angle from North calculated between X and Y axis.
  • Arguments:
    • None
  • Returns:
    • Angle calculated between X and Y axis.
  • Usage:
    • Inside if block after ensuring data availability.

getAngleYZ

  • Prototype:
    • double HMC5883L::getAngleYZ();
  • Description:
    • Get the angle from North calculated between Y and Z axis.
  • Arguments:
    • None
  • Returns:
    • Angle calculated between Y and Z axis.
  • Usage:
    • Inside if block after ensuring data availability.

getAngleXZ

  • Prototype:
    • double HMC5883L::getAngleXZ();
  • Description:
    • Get the angle from North calculated between X and Z axis.
  • Arguments:
    • None
  • Returns:
    • Angle calculated between X and Z axis.
  • Usage:
    • Inside if block after ensuring data availability.


Friday, June 27, 2014

Basic: Getting Started [Arduino]



Well, actually, I don't have time for this kind of post. There's a lot of information in getting started with Arduino already. I'm more excited to get on the real stuff. Here's one of the getting started stuff, brought to you straight from the official website.

Make sure you install the Arduino IDE. You can download the installer here.

But, of cause, there's no use of installing the software if you do not have any Arduino board. You can buy original Arduino board from Cytron Technologies. Yes, there are a lot of boards. Need some guides to buy the best board for you? Here's a good one. Usually, beginners will go for Arduino Uno as it is easy to play around with, and not so expensive.

Better yet, just buy a starter kit as they comes with many extra components that you can play with. It is a good thing to buy the original one because if your board had some problem, you can send them back to the factory. They may replace it if your board is beyond repair; that's from what I heard, at least. You should be careful with counterfeit ones. Some says that they are not as durable as the original one and may cause you some problems in the long run. How to identify them? Here's how.

Now that you have installed the software and bought the board, let's bring them together. You might run into some troubles when connecting your Arduino board for the first time. This page might help.

After you've settled all those problems, we can finally test the board.
Follow the following instructions:

1. Go to File > Examples > 01.Basics > Blink

2. Go to Tools > Board > (Choose your board)

3. Go to Tools > Port > (Choose your COM port)

4. Press Upload button or Ctrl+U for shortcut.

5. Wait until the progress bar at the bottom right corner fully loaded and disappear. Look at your board. Notice that there's an LED labeled as L blinking. If you see it blinking, congratulation! You've successfully uploaded your first sketch. Oh, yes. We call your code as sketch.

Now that we've set up the stage, let's work on the show, then. There'll be a lot of fun stuff coming up. Be sure to come around soon. Till then, good bye.