-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
151 lines (108 loc) · 4.78 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
============
INTRODUCTION
============
The RoboCup Soccer Simulator Server (rcssserver) is a research and educational
tool for mutli-agent systems and artificial intelligence. It allows 11
simulated autonomous robotic players to play soccer (football).
===========
QUICK START
===========
From the rcssserver directory execute:
`./configure'
`make'
This will built the neccesary binaries to get you up and running.
`rcssserver/src/rcssserver' is the binary for the simulator server.
The simulator server manages the actual simulation and comunicates with client
programs that control the simulated robots. To be able to run, the
binary needs to find shared libraries which created when you build
rcssserver. This means you must either intall the server (make
install) or run it from `rcssserver/src'.
A sample client can be found at `rcssserver/src/rcssclient'.
To see what is actually happening in the simulator, you will need to
start a simulator monitor, which needs to be installed seperately
(rcssmointor, rcssmonitor_classic or any other third party monitor).
To playback games that that you have recorded or downloaded, you will need to
start the log player such as rcsslogplayer, which must also be
downloaded separately.
===========
CONFIGURING
===========
Before you can build The RoboCup Soccer Simulator Server you will need to run
the `configure' script located in the root of the distribution directory.
The default configuration will set up to install the server components in
the following location:
/usr/local/bin for the executables
You may need administrator privilages to install the server into the default
location. This locations can be modified by using configure's `--prefix=DIR'
and related options. See `configure --help' for more details.
The server has serveral features that can be enabled or disabled at
configure time by using the `--enable-FEATURE[=ARG]' or `--disable-FEATURE'
parameters to `configure'. `--disable-FEATURE' is equivlant to
`--enable-FEATURE=no' and `--enable-FEATURE' is equivlant to
`--enable-FEATURE=yes'. The only valid values for `ARG' are `yes' and `no'.
`--enable-fast_scanner=yes' will enablle the building a fast but (very) large
scanner for the coach language. You will need to have `lex' or `flex'
installed and you will need to manually remove the `coach_lang_tok.cc' file
in the `rcssserver/src' directory. This is disabled by default.
I found the actual speed of the parser show only minimal improvent when using
this option on my system, but this may not be so on your system. All I can
suggest is to test it on your system and decide for yourself if the speed
increase justifies the increase in size of the executable.
`--enable-rcssclient=yes' will enable the building of rcssclient, a sample
client program. This is enabled by default.
`--enable-debug=yes' will enable the building of the modules with debugging
information. This is disabled by default.
========
BUILDING
========
Once you have successully configured the server, simply run `make' to build
the sources.
==========
INSTALLING
==========
When you have completed building the server, it's components can be installed
into their default locations or the locations specified during configuring by
running `make install'. Depending on where you are installing the
server, you may need special permissions.
============
UNINSTALLING
============
The server can also be easily removed by entering the distribution
directory and running `make uninstall'. This will remove all the files that
where installed, but not any directories that were created during the
installation process.
================
USING THE SERVER
================
To start only the server either type
`./rcssserver'
from the directory containing the executable or
`rcssserver'
if you installed the executables in your PATH. rcssserver will look in your
home directory for the configuration files:
`~/.rcssserver/server.conf'
`~/.rcssserver/palyer.conf'
`~/.rcssserver-landmark.xml' (optional)
If these files do not exist they will be created and populated with default
values.
To start the sample client, type
`./rcssclient'
or
`rcssclient'
as above. Then type `(init sample)'. This will connect the sample client to
the server. You can then type in client command to move the client around the
field. You will also need a monitor to be able to see whats happening on
the field.
If you installed the server and the monitor successfully, you can use
the 'rcsoccersim' script. To start the simulator(server and monitor)
either type:
`rcsoccersim`
==============
Making Contact
==============
For bug reports, feature requests and latest updates, please goto
http://sourceforge.net/projects/sserver/
or email bugs to
The RoboCup Soccer Server Maintainance Group