Skip to content

Latest commit

 

History

History
131 lines (84 loc) · 6.11 KB

connect_javadevice.md

File metadata and controls

131 lines (84 loc) · 6.11 KB
Raw

Integrating a Java - based Device with the Bosch IoT Suite using Vorto

This tutorial explains how to integrate a device with the Bosch IoT Suite using Java and Maven. Your device should already be created as a thing from an Information Model at this point.
We will use this Distance Sensor VIM.

Prerequisites


Steps

  1. Setup your device
  2. Download the generated integration script
  3. Configure the scripts with the information of your created thing
  4. Reading the sensor data
  5. Start sending data

Download the generated integration script

1. On the Vorto Repository page of your Information Model (we will use this Distance Sensor), click on the Bosch IoT Suite generator. This will trigger a pop up to appear with the available generators.

2. We want to integrate a device using Java. Click the Source Code button to download the generated Java project.

3. Unzip the downloaded file and import it in your Eclipse IDE as a Maven project.

4. In order to guarantee secure transmission of your data, the integration uses SSL. We therefore need a certificate.
Right click and save the iothub.crt file and place it at <project>/src/main/resources/iothub.crt.


Configure the scripts with the information of your created thing

5. To configure the endpoint in the generated source code, modify this section in the DistanceSensorApp.java class.

private static final String TENANT_ID = "ADD TENANT ID HERE";

private static final String DEVICE_ID = "ADD DEVICE ID HERE";

private static final String AUTH_ID = "ADD AUTH ID HERE";

private static final String DITTO_TOPIC = "ADD DITTO TOPIC HERE, e.g. com.mycompany/1234";

private static final String DEVICE_PASSWORD = "ADD DEVICE PASSWORD HERE";

6. We will use the request response we got upon creating a thing with the postman script. Since it holds exactly the information we need, we can copy and paste the different ids from the response.


Reading the sensor data

7. After configuring our connection credentials, the last step is to implement the data retrieval from the sensor. The generators create a section in the according class, in our case the DistanceSensorApp.java file.
By default, random values will be sent for the values the sensor sends.

private static Distance readDistance() {
		Distance distance = new Distance();
		//Status properties
		distance.setSensorValue(Math.round(new java.util.Random().nextFloat()*(float)100));
		distance.setSensorUnits("");
  ...

8. Use the pre-defined method private static Distance readDistance() to implement reading in the data from the Distance sensor.
You can simply replace the values passed to the set... methods with the data read from the sensor.


Start sending data

9. Run and verify incoming sensor data by right-clicking on the DistanceSensorApp.java and choosing Run As and select Java Application.

Note that the running application prints out the logs to the IDE console.

Your get an error message?

getaddr - Double check your connection.

If you started the script and you get an getaddr error, this means that the address resolution could not take place. This can have several reasons.
However, it's most likely that you either are not connected to the internet or a proxy is blocking the sending of sensor data.

Unfortunately, for now you can't set any proxy. Please switch to a network without Proxy.


Connection to MQTT broker failed: 4 - Double check your configuration

If you see the sensor a log message with the error value of 4, this means that the connection was refused due to some bad user name or password. However, this can relate to any of the fields in the configuration tab.

Therefore you have to go in and double check every field of the configuration section for an additional space or some character that does not belong there.

Please note that if you have followed the other tutorials, this error is definitely due to a fault in entering the credentials correctly.

10. We can now verify that there is data incoming by either using

  • the Vorto Dashboard that simply displays your data in different UI widgets.
  • or the SwaggerUI which doesn't require anything to be installed and allows a quick insight into whether your data is updating.
Once you can see your data updating, you have successfully connected your Distance Sensor to the Bosch IoT Suite using Java!

What's next ?

In case you're having difficulties or facing any issues, feel free to create a new question on StackOverflow and we'll answer it as soon as possible!
Please make sure to use eclipse-vorto as one of the tags.