JCL Boarding

What does this application do?

This application has been developed to configure the JCL-Host and its sensors remotely and visually, therefore it is no longer necessary to configure each device separately and locally.

How do I run it?

To use the application first you need to start a JCL cluster with default configurations. The JCL Boarding application is located in the folder "jcl_binaries". To start it you just need execute the file boarding.bat (windows) or boarding.sh (linux).

How do I use it?

With the cluster already started, you can open the application.


Figure 1: Main view


In the Board IP field you can select any JCL-Host that is registered in the cluster since the JCL boarding starts a discover every time you click in the combo box. Once a JCL-Host is selected, it is necessary to enter the name of this JCL-Host in the Device Name field. This name must be unique in the cluster, representing the deviceID field of the config.properties detailed in the JCL installation guide. You also need to select the JCL-Host model, e.g., a Java PC, a Java single-board computer (Raspberry, Galileo and others), an Android device or an Arduino.


Figure 2: Selecting a JCL-Host


If the desired JCL-Host is a PC, laptop or any high-end device without sensors and actuators, after filling in the previous fields, new fields will appear and they represent all JCL config.properties, thus for a better understanding its necessary to read the installation guide. In summary, the JCL Boarding enables modify the config.properties fields visually and according to the user demands. Once you have filled in the fields you want, just click on SEND button and JCL will replace the old configurations with new ones.
JCL-Host will restart automatically with the new configurations. Note that, we have tested for Windows, Linux, Android and the Arduino platforms. 


Figure 3: Configuring a Java or Android JCL-Host 


If the selected JCL-Host is an Android, the same initial procedure must be performed. Select the IP Board, Device Name, and the JCL-Host Model. After that a new selection field will be displayed, where it it is possible to select any existing sensor in an Android Device, so it is worth mentioning that the selected sensor may not exist in your Device, so it is necessary to check in the JCL apk which sensors your Device has.

Figure 4: Selecting a sensor from an Android Device.


Once one of the sensors is selected you just add it, so JCL Boarding enables multiple sensor configurations.


Figure 5: Button to add a configuration of a sensor belonging to an Android Device.


To remove a sensor already configured, just click in the remove button.


Figure 6: Button to remove a configuration from a sensor belonging to an Android Device.


To remove all the sensors already configured, just click in the third button named remove all.


Figure 7: Button to remove all sensor settings belonging to an Android Device.


During each sensor configuration its necessary additional settings, so a tab panel with several configuration fields is displayed. For each sensor you need to configure its delay time in millisenconds (Ex. 2000 represents 2 seconds), which means the frequency the sensor will perfom sensing. Furthermore, you need to configure the amount of data stored in the cluster in number of sensing registers, so 5000 represents 5000 registers stored before removing the old ones. After all configurantions, just click in Save button.


Figure 8: Configuring a sensor for an Android Device.


You need to configure all Tab panels for all sensors and apply these settings all at once. After setting up all the chosen sensors just click in SEND to configure the Android remotelly. As explained previously, the JCL-Host will automatically restart with the new configurations. 


Figure 9: List with the sensor settings of an Android Device.


If the selected JCL-Host is  a single-board PC or an Arduino with sensors, the same initial procedure to configure the device must be performed, so you must select the IP Board, Device Name, and the JCL-Host Model. After that, a field for selecting the type of sensor will be displayed. You must select if the sensor is analog or digital. After selecting the sensor type, you must select the PIN that the sensor is connected to the card.


Figure 10: Selecting the type of a sensor, and the PIN corresponding to that sensor


After doing this you can add a sensor configuration to a list (first button next to the PIN selection), remove a configuration from a sensor already added to the list (second button next to the PIN selection), or remove all settings of sensors in the list (third button next to the PIN selection).
Once the add a configuration button is pressed, a tab with several configuration fields is displayed. Just fill them and click Save that the settings will be added in a list of settings, which is just below the Save button.


Figure 11: Configuring a JCL Host Sensor.


Through this list you can configure several sensors, and apply these settings all at once. After configuring all the chosen sensors, just click on SEND that the settings will be applied to the chosen JCL-Host sensors. 


Figure 12: List with sensor configurations of a JCL-Host.


Questions or comments, where can I go?

Questions about the API or about the codes of this application? See our Programming Guide and Installation Guide.

If you have any questions, please contact the JCL team.