pyVSSSReferee 1.0.0

Creates a network socket to communicate with the VSSS League referee

pyVSSSReferee

Easily create a network socket between the VSSS League's referee and your VSSS software.

Requirements

• protobuf==3.6.1

Installation

1. Clone this repository

git clone https://github.com/project-neon/pyVSSSReferee

2. Open directory

cd pyVSSSReferee

3. Install dependencies

pip install -r requirements.txt

4. Finally, install the package

python3 setup.py install

A Simple Example

1. In a test folder, save the code below as config.json

{
    "network" : {
        "multicast_ip": "224.0.0.1",
        "referee_ip": "224.5.23.2",
        "host_ip": "localhost",
        "blue_port": 30011,
        "yellow_port": 30012,
        "vision_port": 10002,
        "command_port": 20011,
        "referee_port": 10003,
        "replacer_port": 10004
    },
    "match" : {
        "num_robots": 3,
        "team_color": "blue"
    }
}

2. In the same folder, save the code below as test.py and run it while the referee is running

import pyVSSSReferee

from pyVSSSReferee.RefereeComm import RefereeComm

r = RefereeComm(config_file = "config.json")
r.start()
while (True):
    print(r.get_last_foul())

Important Methods

Some important methods are:

Method	Description
get_last_foul	Returns last foul in the format: {'foul': 'Foul_name', 'quadrant': 'Quadrant_number', 'color': 'Team_color', 'can_play': 'boolean_value'}
can_play	Returns True if current game foul is GAME_ON, returns False otherwise
get_status	Returns game's current status message sent by the referee
get_color	Returns color of the team that will kick in the penalty or goal kick. BLUE is default.
get_quadrant	Returns the quandrant in which the free ball will occur.
get_foul	Returns current foul.
send_replacement	Receives team color and list of x and y coordinates, angle and ids of robots and sends to the Referee. Team color must be in uppercase, either 'BLUE' or 'YELLOW'.