Low-Level Communication

Owned by Ricardo Rufino
Last updated: Sept 28, 2014
Blink sample using opendevice-connection-stream (the the low-level Java Library).

 

In this example we will demonstrate how to communicate with a device (such as Arduino) using the Java low-level API to control an LED using the USB port.

 

We are not using the OpenDevice Specifications, so let’s start to simplification. It can be used to connect to any serial device (eg fax modem using AT commands) without necessarily it has the OpenDevice firmware. But all features of data conversion and protocol is in your hand (little more difficult).

Add "opendevice-connection-stream" dependency to pom.xml (see this, and change the artifactId)

Hardware

For this sample you need only a PC and Arduino (or compatible like one of EnergiaIDE).

 

Set up the Arduino

If you have already used Arduino before this then you can skip this step. This will setup the Arduino development environment on your computer which will allow you to upload code to your Arduino. Go to the Arduino website and choose your platform (Windows, Mac, or Linux) and follow their guide to installing the IDE.

Sources

Java Side
import br.com.criativasoft.opendevice.connection.DeviceConnection;
import br.com.criativasoft.opendevice.connection.StreamConnectionFactory;
import br.com.criativasoft.opendevice.connection.message.Message;

public class Blink {
   public static DeviceConnection connection;
   public static void main(String[] args) throws Exception {

      connection = StreamConnectionFactory.createUsb("/dev/ttyACM0"); // OBS.1
      connection.connect();

      while(true){
			connection.send(SimpleMessage.ON);
			Thread.sleep(500);
			connection.send(SimpleMessage.OFF);
			Thread.sleep(500);
      }

   }
}

OBS.1 Change USB Port.

Options

  • Mac OS X: /dev/tty.usbserial-A9007UX1

  • Raspberry Pi / Ubuntu: /dev/ttyACM0

  • Linux: /dev/ttyUSB0

  • Windows: COM3

  • Use: UsbConnection.listAvailablePortNames(); to list available ports

 

 

Arduino Side (or similar platform)
#define LED 13

void setup(){
  Serial.begin(9600);
  pinMode(LED, OUTPUT);
}

void loop(){

  if (Serial.available() > 0) {

    int value = Serial.read();  // read value
    Serial.print("READ:");
    Serial.println(value);

    if(value == HIGH || value == LOW ){
      digitalWrite(LED,value);
    }

  }
}

Other options of the library

StreamConnectionFactory.createBluetooth("20:13:01:24:01:93"); 

StreamConnectionFactory.createTcp("http://192.168.0.101:8282"); 


// You can customize the default message format or the way it is read.
// The default implementation expects a line terminator (println).
connection.setStreamReader(new FixedStreamReader(5));

These examples are for understanding how the communication process occurs at the lowest level. The API OpenDevice provide a number of features that facilitate further integration.

Troubleshooting

 

See more tutorials