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 video.

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.sh before each run.

• Ubuntu 16.04
  • Installation
  • World setup
  • Run Python
  • Run C/C++
  • Run Scratch
  • update

Ubuntu 16.04

Installation

1. Download Installer
2. Put the file where ever you want the simplus package to be installed.
3. Go to the interested folder, right-click and open the terminal then write:
   •  sudo sh installer_v4.sh
4. Please press Y or Enter whenever the script asked.

World setup

Go to the simplus_vrep/easy_setup/ubuntu_16 directory, right-click and open the terminal then write

•  sudo sh simulator_v4.sh

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. Go to the simplus_vrep/easy_setup/ubuntu_16 directory, right-click and open the terminal then write

       sudo sh run2_client.sh

1. Go to the simplus_vrep/easy_setup/ubuntu_16 directory, right-click and open the terminal then write

       sudo sh run2_server.sh`

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

In order to use the C/C++ API, you only need to have a g++ compiler. Open the terminal and copy-paste the following commands

sudo apt-get update

sudo apt-get install 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.

• Go to the simplus_vrep/easy_setup/ubuntu_16 directory, right-click and open the terminal then write

       sudo sh compile_cpp.sh

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. Go to the simplus_vrep/easy_setup/ubuntu_16 directory, right-click and open the terminal then write

       sudo sh run2_client_cpp.sh

1. Go to the simplus_vrep/easy_setup/ubuntu_16 directory, right-click and open the terminal then write

       sudo sh run2_server.sh`

Setup for 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: Go to the simplus_vrep/easy_setup/ubuntu_16 directory, right-click and open the terminal then write

       sudo sh update_v4.sh