Demo

In order to have a better understanding of how the installation and running are performed, we have provided a demo. Please have a look at the following video:

Approach 1: Using Applications

Approach 2: Using Scripts

The setup is based on the Server/Client approach:

• The Game Manager & the Robot Controlling Code are placed in different files by a Client/Server scenario and the connection is based on ports that make it suitable for competition.
• Since this approach uses ports to communicate, and several ports might be left open by the previously ran programs, it is advised to run the clear application or clear.sh script before each run.

 

• macOS
  • Using macOS Applications
    • macOS Installation
    • World setup
    • Run Python
    • Run C/C++
    • Run Scratch
    • update
  • Using Scripts
    • macOS Installation
    • World setup
    • Run Python
    • Run C/C++
    • Run Scratch
    • update

macOS

In order to make the setup process easier, some applications and scripts are created. You can choose using applications or scripts .The Applications will be run by duoble clicking on them and you can find the current running application list on the mac’s top menu.

You can close these applications using a ‘close’ icon near them.

Using Application

Installation

Download the installer Application .

• Double click on the “installer_v4” application and the server will be installed on the Desktop directory (You will receive a dialog pop up at the end of the installation process).
• In case you face any error use installer_full Application and Double click on “installer_full_v4”.

World setup

• Double click on the “simulator_v4” application (It can be found in “simplus_vrep/easy_setup/mac” directory)
• In case the simulator is already open and you want to rerun your code you can just press the play button/start simulation button from CopelliaSim top menu bar and play button of the game manager instead of the previous step. It should be mentioned that you still need to do the instruction of the next section to run your code.

Run Python

The teams should use the client to control the robot and the server is responsible for other things prepared by the technical committee.

Remember to Stop the CoppeliaSim Simulator (by the CoppeliaSim Stop bottom) & Play again (by the CoppeliaSim Start bottom) before starting a new Run.

1. Double click on the "run2_client1" application
2. Double click on the "run2_server" application
(They can be found in "simplus_vrep/easy_setup/mac" directory)

Run C/C++

This video tutorial covers the full process of install and run the server. If you are using mac or Ubuntu please skip the Cygwin installation process and take a look at Installation section. Also, It should be mention that after running the compilation script in ubuntu or mac, the player.dll will be replaced with player.dylib in mac and player.so in ubuntu.

Install C/C++ compiler

• Apple’s XCode tools package already contains g++.

Compilation

The compilation process can be done using the provided script files which could be found in the easy_setup folder depending on your current OS.

Double click on the "compile_cpp" application
(They can be found in "simplus_vrep/easy_setup/mac" directory)

Run

The C/C++ client can be ran using the provided scripts which could be found in the easy_setup folder depending on your current OS.

1. Double click on the "run2_client_cpp" application
2. Double click on the "run2_server" application
(They can be found in "simplus_vrep/easy_setup/mac" directory)

Update

In case you want to update your simplus_vrep repository:

• Double click on the “update_v4” application (It can be found in “simplus_vrep/easy_setup/mac” directory)

Using Scripts

Installation

Download the installer Scripts.

• 1. Put the file where ever you want the simplus package be installed in.
• 2. Open the terminal and write “sh “, drag and drop the “installer_v4.sh” file to terminal then press enter
• The installation path should not include any ” “, if there were any, the simplus vrep will be installed in the path shown at the end of the installation (you can easily cut the “simplus_vrep” folder and place it wherever you want after the installation is finished).
• In case you face any error use  installer_full_v4.sh and repeat step 3.

World setup

• Open the terminal and write “sh “, drag and drop the “simulator_v4.sh” file to terminal then press enter (It can be found in “simplus_vrep/easy_setup/mac” directory)

• In case the simulator is already open and you want to rerun your code you can just press the play button/start simulation button from CopelliaSim top menu bar and play button of the game manager instead of the previous step. It should be mentioned that you still need to do the instruction of the next section to run your code.

Run Python

There is two methods to communicate with the robot:

The teams should use the client to control the robot and the server is responsible for other things prepared by the technical committee.

Remember to Stop the CoppelliaSim Simulator (by the CoppelliaSim Stop bottom) & Play again (by the CoppelliaSim Start bottom) before starting a new Run.

1. Open the terminal and write "sh ", drag and drop the "run2_client.sh" file to terminal then press enter
2. Open the terminal and write "sh ", drag and drop the "run2_server.sh" file to terminal then press enter
(They can be found in `simplus_vrep/easy_setup/mac` directory)

Run C/C++

This video tutorial covers the full process of install and run the server. If you are using mac or Ubuntu please skip the Cygwin installation process and take a look at Installation section. Also, It should be mention that after running the compilation script in ubuntu or mac, the player.dll will be replaced with player.dylib in mac and player.so in ubuntu.

Install C/C++ compiler

Apple’s XCode tools package already contains g++.

Compilation

The compilation process can be done using the provided script files which could be found in the easy_setup folder depending on your current OS.

Open the terminal and write "sh ", drag and drop the "compile_cpp.sh" file to terminal then press enter
  (It can be found in "simplus_vrep/easy_setup/mac" directory)

Run

The C/C++ client can be ran using the provided scripts which could be found in the easy_setup folder depending on your current OS.

 Approach2
 1. Open the terminal and write "sh ", drag and drop the "run2_client_cpp.sh" file to terminal then press enter 
 2. Open the terminal and write "sh ", drag and drop the "run2_server.sh" file to terminal then press enter (They can be found in `simplus_vrep/easy_setup/mac` directory) 

Run Scratch

Based on your desired operating system go through  Run step above and  skip the client part (since the client would be the Scratch program), then follow the below steps:

1. Go to https://scratchx.org/?url=https://Robocup-simplus.github.io/simplus.js#scratch (wait till the extension loads)
2. Simplus blocks are located in the “More Blocks” tab and you can drag and drop them to the right scene
3. In order to use the sample project, from the top menu click on File then load project and select the simplus_scratch.sbx file from simplus_vrep/client/scratch

Update

In case you want to update your simplus_vrep repository:

• Open the terminal and write “sh “, drag and drop the “update_v4.sh” file to the terminal then press enter (It can be found in “simplus_vrep/easy_setup/mac” directory)