Návody a inštalácie

Z RoboCupTP wiki

Prejsť na: navigácia, hľadanie

Nachádzajú sa tu návody na inštaláciu a rozbehanie SimSparku, importovanie zdrojových kódov do IDE a na všetky základné kroky.

Návod na používanie wiki: Stručný návod na prácu s wiki

Obsah

SimSpark

odkaz na Analýzu fyzikálneho modelu

Inštalácia na Windows

Windows 7 x64

Testované na verziách: • MS Visual C++ 2008 Redistributable Package (x86) - 11/29/2007

• simspark – 0.2.2

• rcsserver3d – 0.6.5

• Ruby – 1.9.3-p125


Dostupné na stránkach: • MS Visual C++2008 Redistributable Package (x86): http://www.microsoft.com/en-us/download/details.aspx?id=29

• simspark: http://sourceforge.net/projects/simspark/files/simspark/

• rcssserver3d: http://sourceforge.net/projects/simspark/files/rcssserver3d/

• Ruby - http://rubyinstaller.org/downloads/


Postup 1. Stiahnuť a nainštalovať exe súbory na systémový disk (inak to nepôjde) C:/Program Files (x86)/ v tomto poradí:

       1.	MS Visual C++ 2008 Redistributable Package (x86) (nepovinné)
       2.	simspark
       3.	rcsserver3d
       4.	Ruby

2. Otvoriť adresár, kde je nainštalovaný rcssserver3d (C:\Program Files\rcssserver3d 0.6.5\bin) a includovať cestu do tohto priečinka do systémovej premennej Path (Start->Ovládací panel->Používateľské kontá->Premenné prostredia).

3. Spustiť server spustením rcssserver3d.cmd.

4. Spustiť monitor spustením rcssmonitor3d.cmd. Po tomto kroku by sa malo zobraziť okno s ihriskom.

5. Spustiť agenta na ihrisko spustením rcssagent3d.cmd. Po tomto kroku by sa mal v rohu ihriska objaviť hráč s názvom NaoRobot. Tento krok slúži len ako test, že všetko funguje správne.

Pozn.: Kroky číslo 3 a 4 je možné nahradiť spustením súboru rcsoccersim3d.cmd, ktorý vykoná spustenie servera a monitora.

Postup je rovnaký ako v tomto videu, rozdiel je len v odlišných verziách: http://www.youtube.com/watch?v=_gDrGoPQ35k

Oficiálny návod: http://simspark.sourceforge.net/wiki/index.php/Installation_on_Windows

Windows 7 x86

Testované na verziách:

• MS Visual C++ 2008 Redistributable Package (x86) - 11/29/2007

• simspark – 0.2.2

• rcsserver3d – 0.6.5

• Ruby – 1.9.3-p286

Dostupné na stránkach:

• MS Visual C++2008 Redistributable Package (x86): http://www.microsoft.com/en-us/download/details.aspx?id=29

• simspark: http://sourceforge.net/projects/simspark/files/simspark/

• rcssserver3d: http://sourceforge.net/projects/simspark/files/rcssserver3d/

• Ruby - http://rubyinstaller.org/downloads/

Postup

1. Stiahnuť a nainštalovať exe súbory v tomto poradí:

       1.	MS Visual C++ 2008 Redistributable Package (x86) (nie vždy povinné)
       2.	simspark
       3.	rcsserver3d
       4.	Ruby

2. Otvoriť adresár, kde je nainštalovaný rcssserver3d (C:\Program Files\rcssserver3d 0.6.5\bin).

3. Spustiť server spustením rcssserver3d.cmd.

4. Spustiť monitor spustením rcssmonitor3d.cmd. Po tomto kroku by sa malo zobraziť okno s ihriskom.

5. Spustiť agenta na ihrisko spustením rcssagent3d.cmd. Po tomto kroku by sa mal v rohu ihriska objaviť hráč s názvom NaoRobot. Tento krok slúži len ako test, že všetko funguje správne.

Pozn.: Kroky číslo 3 a 4 je možné nahradiť spustením súboru rcsoccersim3d.cmd, ktorý vykoná spustenie servera a monitora.

Postup je rovnaký ako v tomto videu, rozdiel je len v odlišných verziách:

http://www.youtube.com/watch?v=_gDrGoPQ35k

Oficiálny návod:

http://simspark.sourceforge.net/wiki/index.php/Installation_on_Windows

Windows XP x86

1. Stiahnutie MS Visual C++2008 Redistributable Package (x86)
1.1. Ísť na stránku:
http://www.microsoft.com/downloads/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf&displaylang=en
alebo http://www.microsoft.com/en-us/download/details.aspx?id=29
Otvorí sa stránka Microsoft Download Center s nápisom MS Visual C++2008 Redistributable Package (x86) a možnosťou stiahnutia „Download“.
1.2. Kliknúť na „Download“ a tým stiahnuť súbor „vcredist_x86.exe“.
1.3. Spustiť súbor a nainštalovať MS Visual C++2008 Redistributable Package (x86). Inštaláciu postačí vykonať štýlom klikania „Next“ a nakoniec „Finish“.

2. Stiahnutie a nainštalovanie Simspark 0.2.2
2.1. Ísť na stránku http://sourceforge.net/projects/simspark/files/simspark/0.2.2/
2.2. Kliknúť na „simspark-0.2.2-win32.exe“.
2.3. Počkať 5 sekúnd a potom stiahnuť súbor „simspark-0.2.2-win32.exe“.
2.4. Spustiť súbor „simspark-0.2.2-win32.exe“.
2.5. Kliknúť: Next, I Agree, Next, Install, Finish. Ak by inštalácia padla alebo sa ukončila skôr než sa zobrazí obrazovka s tlačidlom „Finish“, je nutné inštaláciu zopakovať.

3. Stiahnutie a nainštalovanie RoboCup servera 0.6.5
3.1. Ísť na stránku http://sourceforge.net/projects/simspark/files/rcssserver3d/0.6.5/
3.2. Kliknúť na „rcssserver3d-0.6.5-win32.exe“.
3.3. Počkať 5 sekúnd a potom stiahnuť súbor „rcssserver3d-0.6.5-win32.exe“.
3.4. Spustiť súbor „rcssserver3d-0.6.5-win32.exe“.
3.5. Kliknúť: Next, I Agree, Next, Install, Finish. Ak by inštalácia padla alebo sa ukončila skôr než sa zobrazí obrazovka s tlačidlom „Finish“, je nutné inštaláciu zopakovať.

4. Stiahnutie a nainštalovanie Ruby 1.9.1
Pokiaľ už máte nainštalované Ruby tejto verzie, tak nie je nutný tento krok. Pokiaľ máte nainštalované Ruby inej verzie, nie je zaručené že celý tento postup bude fungovať (treba skúsiť, možno to fungovať bude).
4.1. Ísť na stránku http://rubyinstaller.org/downloads/archives
4.2. Kliknúť na „Ruby 1.9.1-p378“.
4.3. Stiahnuť súbor „rubyinstaller-1.9.1-p378.exe“.
4.4. Spustiť súbor „rubyinstaller-1.9.1-p378.exe“.
4.5. Kliknúť: Next, I accept the license, Next, zaškrtnúť „Add Ruby executables to your PATH“, Install, Finish. Ak by inštalácia padla alebo sa ukončila skôr než sa zobrazí obrazovka s tlačidlom „Finish“, je nutné inštaláciu zopakovať.

5. Reštart systému Windows.
Na prejavenie zmien spôsobených inštaláciami je nutné systém Windows reštartnúť.

6. Upravenie „cmd“ súborov v RoboCup serveri
6.1. Otvoriť v textovom editore (napríklad Notepad++) všetky súbory s príponou „cmd“, ktoré sa predvolene nachádzajú v priečinku „C:\Program Files\rcssserver3d 0.6.5\bin“ alebo tam, kam ste RoboCup server nainštalovali. Sú to súbory: rcsoccersim3d.cmd, rcssagent3d.cmd, rcssmonitor3d.cmd, rcssserver3d.cmd.
6.2. Do každého súboru pridať 2 riadky, ktoré pri predvolených cestách vyzerajú takto:

SET SPARK_DIR=C:\Program Files\simspark
SET RCSSSERVER3D_DIR=C:\Program Files\rcssserver3d 0.6.5

6.3. Uložiť zmeny v súboroch.

7. Overenie funkčnosti inštalácií spustením predvoleného hráča
7.1. Ísť do priečinka „C:\Program Files\rcssserver3d 0.6.5\bin“.
7.2. Pre spustenie RoboCup servera je potrebné spustiť súbor „rcssserver3d.cmd“. Po spustení sa objaví konzolové okno s výpismi.
7.3. Pre spustenie RoboCup monitora je potrebné spustiť súbor „rcssmonitor3d.cmd“. Po spustení sa objaví konzolové okno s výpismi a zároveň okno RoboCup monitora. RoboCup monitor a jeho okno slúži na zobrazenie futbalového ihriska a všetkého, čo sa na ňom viditeľne deje.
7.4. Pre spustenie predvoleného hráča je potrebné spustiť súbor „rcssagent3d.cmd“. Po spustení sa objaví konzolové okno s výpismi a zároveň sa v okne RoboCup monitora na ihrisku objaví hráč. Pre nájdenie, či a kde sa hráč v monitore nachádza, je potrebné použiť šípky na klávesnici. Mal by sa nachádzať na ľavej strane ihriska ďalej od kamery.

8. Čo ďalej?
Spustenie hráča, ktorý je vyvíjaný našou fakultou, je popísané v časti „Pustenie agenta“.

9. Užitočné zdroje
9.1. http://simspark.sourceforge.net/wiki/index.php/Installation_on_Windows – oficiálny návod inštalácie simspark na Windows
9.2. http://www.youtube.com/watch?v=_gDrGoPQ35k – video návod
9.3. http://team15-12.ucebne.fiit.stuba.sk/ - stránka tímu A55 Kickers

Inštalácia na Linux

Inštalácia je možná viacerými spôsobmi. V návodoch nájdete postupy pre najrýchlejší typ inštalácie a na najbezpečnejšiu (kompilácia)

LINUX rýchla inštalácia (bez kmpilácie)

Pred inštaláciou updatujte celý OS a pustite príkaz

sudo apt-get update

Inštalácia servera a simsparku (vždy najnovších verzií) na Kubuntu/Ubuntu 11 x64. Rýchlu inštaláciu spustíte príkazmi:

sudo apt-add-repository ppa:gnurubuntu/rubuntu
sudo apt-get update
sudo apt-get install rcssserver3d

Testovacím agentom si overíte pripojiteľnosť k serveru. Keď vyjde nová verzia simsparku, update verzie prevediete príkazom:

sudo apt-get update && sudo apt-get install rcssserver3d

LINUX - kompilácia

Pred inštaláciou potrebujete nainštalovať niekoľko rozšírení OS. Pred inštaláciou rozšírení určite pustite:

sudo apt-get update 

a updatujte aj celý OS! Aj počas inštalácie updatujte OS keď sa Vám hocijaký update ukáže!

Povolte "multiverse" a "universe" v termináli:

  • System Settings -> Software Sources ->Ubuntu Softvare

Povolte logovanie terminálu:

  • Terminal -> Edit -> Profile Preferences -> Title and Command -> Run command as a login shell

Potrebné ozšírenia:

Optional:

  • wxWidgets Library
  • FMOD Sound Library
  • Latex (pdflatex): to generate developers manual
  • Doxygen: to generate API documentation

Po inštalácií všetkých rozšírení si stiahnite najnovšiu verziu SimSpark-ku. Odporúčam sourceforge: http://sourceforge.net/projects/simspark/files/

Balík rozbalte a navigujte sa na miesto v termináli. Vytvorte tam priečinok build:

mkdir build 

a prejdite do priečinku

cd build

pustite:

cmake .. 
make
make install

Stiahnite si najnovsiu verziu rcssserver3d. Odporúčam sourceforge: http://sourceforge.net/projects/sserver/files/

Balík rozbalte a navigujte sa na miesto v termináli. Pustite:

./configure
make
make install

Inštalácia na Mac OSX

Importovanie zdrojových kódov

Netbeans

Eclipse

Pustenie agenta

Pustenie agenta z command line

Pustenie agenta z IDE

NetBeans

1. Importovať zdrojaky Jima a RoboCupLibrary do prostredia

2. V projekte Jim v súbore script/config/settings.rb nastaviť VERSION_0_6_X na verziu podľa nainštalovaného servera

3. Nájsť balíček sk.fiit.jim.init

4. Rozbaliť balíček a nájsť triedu Main.java

5. Spustiť rcssserver3d a rcssmonitor3d

6. Spustiť triedu Main.java (kliknut pravym tlacidlom mysi a zvolit moznost run file)

7. Pri vypísaní chyby java.io.FileNotFoundException: .\fixtures\test_log.txt (Prístup je odmietnutý) postupovať takto:

       a.	V projekte Jim nájsť priečinok fixture a všetkým zložkám v ňom vo vlastnostiach odškrtnúť políčko Only read 

8. Po objavení sa agenta v ihrisku stlačiť na klávesnici písmeno b. Agent začne vykonávať pohyb v závislosti od zvoleného plánovača.

Eclipse

1. Importovať projekty Jim, RoboCupLibrary, TestFramework

2. V projekte Jim a v súbore scripts/config/settings.rb v riadku Communication.instance.server_ip potrebujeme zmeniť IP adresu podľa toho, kde beží simulačný server, na ktorý sa ideme pripojiť (napr: Communication.instance.server_ip = "localhost")

3. V tom istom súbore settings.rb je potrebné zmeniť VERSION_0_6_X (kde X treba nahradiť v závislosti od toho, na ktorom serveri akej verzie sa vykonávajú simulácie), napr: EnvironmentModel.version = EnvironmentModel::Version::VERSION_0_6_5

4. Spustiť rcssserver3d a rcssmonitor3d

5. Spustiť triedu Main.java, ktorá sa nachádza v projekte Jim a v balíčku sk.fiit.jim.init (kliknúť pravým tlačidlom myši a zvoliť možnosť Run As – Java Application)

6. Po objavení sa agenta v ihrisku stlačiť na klávesnici písmeno b. Agent začne vykonávať pohyb v závislosti od zvoleného plánovača.

Pustenie agenta z TestFrameworku

odkaz na importovanie zdrojákov odkaz na opis funkcie TF

Pustenie agenta z Editoru pohybov

odkaz na opis fincionality Editora Pohybov odkaz na vytvorenie low-skill pohybu v Editore P.

Vytvorenie low-skill pohybu

Vytvorenie pohybu XML

odkaz na struktútu XML - bude v Úvod do stavu RoboCup na FIIT/Pohyby - hra agenta/Nízkoúrovňové pohyby"

Vytvorenie pohybu v Editore pohybov

odkaz na opis funkcionality Editora P. - bude v Úvod do stavu RoboCup na FIIT/Editor pohybov" odkaz na pustenie agenta z Editoru pohybov - nachádza sa na tejto strane

Vytvorenie vysokoúrovňového pohybu

Všetko k vytvoreniu High Skill pohybu sa dozviete na HighSkill pohyby.

Vytvorenie a používanie plánovača

odkaz na popis plánovača - bude v Úvod do stavu RoboCup na FIIT/Pohyby - hra agenta/Plánovač"

Simulácia pohybov

Simulácia low-skill

1x aj opakovane odkazy na plánovač aj high skill

Simulácia high-skill

odkaz na plánovač

TestFramework

Test Framework slúži na získanie spätnej väzby od hráča. Hlavným zámerom je zostrojiť robotického futbalového trénera, ktorý by dokázal učiť hráčov novým taktikám a pohybom automaticky. Zatiaľ je vypracovaný len vo fáze pozorovateľa hráčov.

Vytvorenie testCase

Modelovanie situácie je možné pomocou testcase. Podrobný návod na vytvorenie testcase nájdete na Test Case.

Pustenie testCase

V grafickom rozhraní testovacieho frameworku sa ľahko zorientujete podľa GUI: Testovací framework. Je tam aj popis ako spustiť test case. V prípade, že niečo nefunguje skontrolujte či máte build-nutý celý projekt, či daný high skill je v priečinku, v ktorom má byť a či existujú low skill pohyby potrebné na vykonanie high skill pohybu.

Anotácie

odkaz na funcionalitu Anotácií - bude v Úvod do stavu RoboCup na FIIT/Anotácie" ďalej neviem, čo by tu mohl byť

Osobné nástroje