|
|
# Using OpenTCS
|
|
|
## Table of Contents
|
|
|
* [Add the communication adapter to the Kernel](https://git.fhict.nl/I312980/move-it/wikis/usage/opentcs#add-the-communication-adapter-to-the-kernel)
|
|
|
* [Design your warehouse](https://git.fhict.nl/I312980/move-it/wikis/usage/opentcs#design-your-warehouse)
|
|
|
* [The Kernel](https://git.fhict.nl/I312980/move-it/wikis/usage/opentcs#the-kernel)
|
|
|
|
|
|
## Add the communication adapter to the Kernel
|
|
|
To be able to use our communication adapter you have to compile (clean and build) the communication adapter in preferably Netbeans (more information [here](https://git.fhict.nl/I312980/move-it/wikis/installation/installation#set-up-netbeans).
|
|
|
Now go to the target folder of the communication adapter and copy the `.jar` to `openTCS-Kernel/lib/openTCS-extensions`. Do not forget to copy the `json-simple-1.1.1.jar` to the same folder (you can download it [here](https://code.google.com/archive/p/json-simple/downloads)). You can do this by locating the `.jar` file in Netbeans and copy pasting the file in `openTCS-Kernel/lib/openTCS-extensions`.
|
|
|
Now go to the target folder of the communication adapter and copy the `.jar` to `openTCS-Kernel/lib/openTCS-extensions`. Do not forget to copy the `json-simple-1.1.1.jar` to the same folder. You can download it [here](https://code.google.com/archive/p/json-simple/downloads) or you can do this by locating the `.jar` file in NetBeans and copy pasting the file in `openTCS-Kernel/lib/openTCS-extensions`.
|
|
|
Next time you start the Kernel you will find a new adapter called `move-it` which represents our communication adapter.
|
|
|
|
|
|
## Design your warehouse
|
|
|
Start the Plantoverview and load the datamodel we have included in our project [move-it-communication-adapter/MoveIT.xml](https://git.fhict.nl/I312980/move-it/blob/master/move-it-communication-adapter/MoveIT.xml). For each vehicle you have, you have to add two key value pairs in the miscellaneous property of the vehicle:
|
|
|
* host: The IP-address of the robot you want to connect to
|
|
|
* port: The port to connect to
|
|
|
Besides that you have to make sure that every point has an x and y value so the robot knows the location where it needs to drive to (in real life).
|
|
|
Note that at this moment the robot is only able to process the following operations:
|
|
|
* NOP
|
|
|
* Load cargo
|
|
|
* Unload cargo
|
|
|
* Charge:100
|
|
|
* Charge:50
|
|
|
* Drill
|
|
|
* Cut
|
|
|
For a detailed explanation about how you need to design you warehouse, you can have a look [here](https://git.fhict.nl/I312980/move-it/tree/master/configurations/opentcs-map).
|
|
|
|
|
|
## The Kernel
|
|
|
After you are done with developing your warehouse, you have to persist it into the kernel. If you have not saved your model yet, do so now. Next up you have to open the Kernel and then you have to switch back to the Plantoverview. In the Plantoverview you click on File - Persist model in the kernel. Now your warehouse is running in the kernel, so go to the kernel window.
|
|
|
In the kernel window you are able to connect each vehicle using an adapter to the kernel. Select `move-it`, make sure that the robot is running or our [DummyBot](https://git.fhict.nl/I312980/move-it/wikis/usage/dummybot) and click enable.
|
|
|
After you are done with the development of your warehouse, you have to persist it into the kernel. If you have not saved your model yet, do so now. Next up you have to open the Kernel and then you have to switch back to the Plantoverview. In the Plantoverview you click on File - Persist model in the kernel. Now your warehouse is running in the kernel, so go to the kernel window.
|
|
|
In the kernel window you are able to connect each vehicle using an adapter to the kernel. Select `move-it`, make sure that the robot is running or our use the [DummyBot](https://git.fhict.nl/I312980/move-it/tree/master/move-it-dummybot) and click enable.
|
|
|
|
|
|
## Operate the warehouse
|
|
|
Now switch back to the Plantoverview and click File - Load current kernel model.
|
... | ... | |