GitHub - BrickBot/Intellejos: An RCX Simulator for LeJOS, based on the earlier Intellego project, for learning to program in Java using the LeJOS platform.

BrickBot / Intellejos Public
Notifications You must be signed in to change notification settings
Fork 1
Star 1
An RCX Simulator for LeJOS, based on the earlier Intellego project, for learning to program in Java using the LeJOS platform.
web.archive.org/web/20070831213730/http://www.kooijmans.nu/mindstorms/getstarted.htm
GPL-2.0 license
1 star 1 fork Branches Tags Activity
Star
Notifications
Branches Tags
Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
challenge		challenge
doc		doc
intellejos		intellejos
robots		robots
simworlds		simworlds
.gitattributes		.gitattributes
.gitignore		.gitignore
CHANGELOG		CHANGELOG
Intellejos.bat		Intellejos.bat
LICENSE		LICENSE
README.htm		README.htm
build.bat		build.bat
clean.bat		clean.bat
setup.bat		setup.bat
Repository files navigation

<html xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:w="urn:schemas-microsoft-com:office:word"
xmlns="http://www.w3.org/TR/REC-html40">

<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<meta name=ProgId content=Word.Document>
<meta name=Generator content="Microsoft Word 11">
<meta name=Originator content="Microsoft Word 11">
<base target="_blank">
<link rel=File-List href="manual_files/filelist.xml">
<title>Intellejos User Manual</title>
<!--[if gte mso 9]><xml>
 <o:DocumentProperties>
  <o:Author>Tijn Kooijmans</o:Author>
  <o:LastAuthor>Tijn Kooijmans</o:LastAuthor>
  <o:Revision>2</o:Revision>
  <o:TotalTime>214</o:TotalTime>
  <o:Created>2005-02-10T13:20:00Z</o:Created>
  <o:LastSaved>2005-02-10T13:20:00Z</o:LastSaved>
  <o:Pages>1</o:Pages>
  <o:Words>523</o:Words>
  <o:Characters>2982</o:Characters>
  <o:Company>Technische Universiteit Eindhoven</o:Company>
  <o:Lines>24</o:Lines>
  <o:Paragraphs>6</o:Paragraphs>
  <o:CharactersWithSpaces>3499</o:CharactersWithSpaces>
  <o:Version>11.5606</o:Version>
 </o:DocumentProperties>
</xml><![endif]--><!--[if gte mso 9]><xml>
 <w:WordDocument>
  <w:View>MasterPages</w:View>
  <w:SpellingState>Clean</w:SpellingState>
  <w:GrammarState>Clean</w:GrammarState>
  <w:PunctuationKerning/>
  <w:ValidateAgainstSchemas/>
  <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid>
  <w:IgnoreMixedContent>false</w:IgnoreMixedContent>
  <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText>
  <w:Compatibility>
   <w:BreakWrappedTables/>
   <w:SnapToGridInCell/>
   <w:WrapTextWithPunct/>
   <w:UseAsianBreakRules/>
   <w:DontGrowAutofit/>
  </w:Compatibility>
  <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
 </w:WordDocument>
</xml><![endif]--><!--[if gte mso 9]><xml>
 <w:LatentStyles DefLockedState="false" LatentStyleCount="156">
 </w:LatentStyles>
</xml><![endif]-->
<style>
<!--
 /* Font Definitions */
 @font-face
	{font-family:Wingdings;
	panose-1:5 0 0 0 0 0 0 0 0 0;
	mso-font-charset:2;
	mso-generic-font-family:auto;
	mso-font-pitch:variable;
	mso-font-signature:0 268435456 0 0 -2147483648 0;}
@font-face
	{font-family:Tahoma;
	panose-1:2 11 6 4 3 5 4 4 2 4;
	mso-font-charset:0;
	mso-generic-font-family:swiss;
	mso-font-pitch:variable;
	mso-font-signature:1627421319 -2147483648 8 0 66047 0;}
 /* Style Definitions */
 p.MsoNormal, li.MsoNormal, div.MsoNormal
	{mso-style-parent:"";
	margin:0cm;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:12.0pt;
	font-family:"Times New Roman";
	mso-fareast-font-family:"Times New Roman";}
h1
	{mso-style-next:Normal;
	margin-top:12.0pt;
	margin-right:0cm;
	margin-bottom:3.0pt;
	margin-left:0cm;
	mso-pagination:widow-orphan;
	page-break-after:avoid;
	mso-outline-level:1;
	font-size:16.0pt;
	font-family:Arial;
	mso-font-kerning:16.0pt;}
h2
	{mso-style-next:Normal;
	margin-top:12.0pt;
	margin-right:0cm;
	margin-bottom:3.0pt;
	margin-left:0cm;
	mso-pagination:widow-orphan;
	page-break-after:avoid;
	mso-outline-level:2;
	font-size:14.0pt;
	font-family:Arial;
	font-style:italic;}
h3
	{mso-style-next:Normal;
	margin-top:12.0pt;
	margin-right:0cm;
	margin-bottom:3.0pt;
	margin-left:0cm;
	mso-pagination:widow-orphan;
	page-break-after:avoid;
	mso-outline-level:3;
	font-size:13.0pt;
	font-family:Arial;}
h4
	{mso-style-next:Normal;
	margin-top:12.0pt;
	margin-right:0cm;
	margin-bottom:3.0pt;
	margin-left:0cm;
	mso-pagination:widow-orphan;
	page-break-after:avoid;
	mso-outline-level:4;
	font-size:14.0pt;
	font-family:"Times New Roman";}
a:link, span.MsoHyperlink
	{color:blue;
	text-decoration:underline;
	text-underline:single;}
a:visited, span.MsoHyperlinkFollowed
	{color:purple;
	text-decoration:underline;
	text-underline:single;}
p.MsoDocumentMap, li.MsoDocumentMap, div.MsoDocumentMap
	{mso-style-noshow:yes;
	margin:0cm;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	background:navy;
	font-size:10.0pt;
	font-family:Tahoma;
	mso-fareast-font-family:"Times New Roman";}
span.SpellE
	{mso-style-name:"";
	mso-spl-e:yes;}
span.GramE
	{mso-style-name:"";
	mso-gram-e:yes;}
@page Section1
	{size:595.3pt 841.9pt;
	margin:72.0pt 90.0pt 72.0pt 90.0pt;
	mso-header-margin:35.4pt;
	mso-footer-margin:35.4pt;
	mso-paper-source:0;}
div.Section1
	{page:Section1;}
 /* List Definitions */
 @list l0
	{mso-list-id:303971641;
	mso-list-type:hybrid;
	mso-list-template-ids:-821107052 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l0:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:36.0pt;
	mso-level-number-position:left;
	text-indent:-18.0pt;
	font-family:Symbol;}
@list l1
	{mso-list-id:465436749;
	mso-list-type:hybrid;
	mso-list-template-ids:1734658064 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l1:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:54.0pt;
	mso-level-number-position:left;
	margin-left:54.0pt;
	text-indent:-18.0pt;
	font-family:Symbol;}
@list l2
	{mso-list-id:810172893;
	mso-list-type:hybrid;
	mso-list-template-ids:496154160 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l2:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:36.0pt;
	mso-level-number-position:left;
	text-indent:-18.0pt;
	font-family:Symbol;}
@list l3
	{mso-list-id:1000307207;
	mso-list-type:hybrid;
	mso-list-template-ids:-1602699894 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l3:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:36.0pt;
	mso-level-number-position:left;
	text-indent:-18.0pt;
	font-family:Symbol;}
@list l3:level2
	{mso-level-number-format:bullet;
	mso-level-text:o;
	mso-level-tab-stop:72.0pt;
	mso-level-number-position:left;
	text-indent:-18.0pt;
	font-family:"Courier New";}
@list l4
	{mso-list-id:1174809164;
	mso-list-type:hybrid;
	mso-list-template-ids:-1204379474 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l4:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:54.0pt;
	mso-level-number-position:left;
	margin-left:54.0pt;
	text-indent:-18.0pt;
	font-family:Symbol;}
@list l5
	{mso-list-id:1520774360;
	mso-list-type:hybrid;
	mso-list-template-ids:-2119515960 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l5:level1
	{mso-level-number-format:bullet;
	mso-level-text:\F0B7;
	mso-level-tab-stop:54.0pt;
	mso-level-number-position:left;
	margin-left:54.0pt;
	text-indent:-18.0pt;
	font-family:Symbol;}
ol
	{margin-bottom:0cm;}
ul
	{margin-bottom:0cm;}
-->
</style>
<!--[if gte mso 10]>
<style>
 /* Style Definitions */
 table.MsoNormalTable
	{mso-style-name:"Table Normal";
	mso-tstyle-rowband-size:0;
	mso-tstyle-colband-size:0;
	mso-style-noshow:yes;
	mso-style-parent:"";
	mso-padding-alt:0cm 5.4pt 0cm 5.4pt;
	mso-para-margin:0cm;
	mso-para-margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:10.0pt;
	font-family:"Times New Roman";
	mso-ansi-language:#0400;
	mso-fareast-language:#0400;
	mso-bidi-language:#0400;}
</style>
<![endif]-->
</head>

<body lang=EN-US link=blue vlink=purple style='tab-interval:36.0pt'>

<div class=Section1>

<h1><span style='font-size:24.0pt'>Intellejos<o:p></o:p></span></h1>

<h1>Background</h1>

<p class=MsoNormal>The original project website was at
<span class=SpellE>http://www.kooijmans.nu/mindstorms</span>.  While no longer accessible,
the following archived web pages are available:
<ul style='margin-top:0cm' type=disc>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>
     <a href="https://web.archive.org/web/20070915070328/http://www.kooijmans.nu/mindstorms">Main Page</a>,
     including the Robot Pizza Delivery challenge</li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>
     <a href="https://web.archive.org/web/20070831213730/http://www.kooijmans.nu/mindstorms/getstarted.htm">LeJOS and Eclipse Installation Guide</a></li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>
     <a href="https://web.archive.org/web/20070831213735/http://www.kooijmans.nu/intellejos/">Getting Started with Intellejos</a>
     (which this page largely copies)</li>
</ul>
A copy of <span class=SpellE>Intellejos</span> has also been posted to
<a href="https://github.com/tijnkooijmans/Intellejos">github.com/tijnkooijmans/Intellejos</a>;
however, an effort has been made here to clean up and curate the repository here
to make it more usable and more readily accessible for getting started.
Updates by Matthew Sheets.</p>

<h1>Introduction</h1>

<p class=MsoNormal>The Intellejos system is based on <span class=SpellE>Intellego</span>,
a basic robot simulator designed for robotics researchers. The purpose of
Intellejos is to learn programming in Java using the <span class=SpellE>LeJOS</span>
(Lego Java Operating System) platform. It offers the possibility to quickly
test certain algorithms that will be used for Lego Mindstorms, without having
to build the full robot. This manual explains how to use Intellejos and implement
your own robots and worlds. Any questions or remarks can be sent to <a
href="mailto:intellejos@kooijmans.nu">intellejos@kooijmans.nu</a>.</p>

<h1>User Manual for Windows</h1>

<h3>Required software</h3>

<ul style='margin-top:0cm' type=disc>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>It
     is necessary to have the Java Runtime Environment and Java Development Kit
     installed. Please find the latest copy at <a href="http://java.sun.com/">http://java.sun.com</a>.
     </li>
</ul>

<h3>Setting up Intellejos</h3>

<ul style='margin-top:0cm' type=disc>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>Download
     a copy of Intellejos <a
     href="http://www.kooijmans.nu/intellejos/intellejos.zip">here</a>.</li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>After
     downloading the .zip file that contains a version of Intellejos, unzip it
     to a preferred directory.</li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>Edit
     the �<span class=SpellE>setup.bat</span>� file in the root directory of
     Intellejos and change the INTELLEJOS_HOME and JAVA_HOME variables to point
     to the correct paths. </li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>Run
     the �<span class=SpellE>build.bat</span>� file to compile the software.</li>
</ul>

<h3>Running Intellejos</h3>

<ul style='margin-top:0cm' type=disc>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>After
     setting up you can start Intellejos by running the �<span class=SpellE>Intellejos.bat</span>�
     file.</li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>When
     the Intellejos window appears you can open a simulation world by choosing �pick
     simworld� in the control-menu.</li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>To
     place <span class=GramE>a robot in the simworld choose</span> �add robot�
     in the control-menu. Enter coordinates and bearing of the robot and choose
     OK. The coordinates are relative to the upper-left corner of the window in
     pixels. The robot will automatically start after loading it in the
     simworld.</li>
</ul>

<h3>Building your own <span class=SpellE>simworlds</span></h3>

<ul style='margin-top:0cm' type=disc>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>Self-made
     simworld classes can be added to the �simworld� directory of Intellejos.
     You can make your own simworld classes by extending the �<span
     class=SpellE>BasicSimWorld</span>� class. Adding objects of �<span
     class=SpellE>SimWall</span>� and �<span class=SpellE>SimPath</span>� to
     the class, as demonstrated in the enclosed examples, gives you the ability
     to fill the simworld with walls and paths.</li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>After
     programming the simworld run �<span class=SpellE>build.bat</span>� to
     compile. </li>
</ul>

<h3>Programming the robot</h3>

<ul style='margin-top:0cm' type=disc>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>Write
     a java program as you would normally do for Lego Mindstorms and place it
     in the �robots� directory. An example robot is available in this
     directory. The file with the �public static void <span class=GramE>main(</span>String[]
     <span class=SpellE>args</span>)� method can be loaded into the simulator.
     There are some differences however:</li>
 <ul style='margin-top:0cm' type=circle>
  <li class=MsoNormal style='mso-list:l3 level2 lfo3;tab-stops:list 72.0pt'>The
      <span class=SpellE>LeJOS</span> packages that you need to control the
      robot are modified and there is only a limited set of <span class=SpellE>LeJOS</span>
      classes available in the simulator. You can find the API docs in the �<span
      class=SpellE>lejos</span>\docs� directory of Intellejos. </li>
  <li class=MsoNormal style='mso-list:l3 level2 lfo3;tab-stops:list 72.0pt'>While
      you would normally import �<span class=SpellE>josx.xxxx</span>.*�, you
      need to change �<span class=SpellE>josx</span>� to �<span class=SpellE>lejos</span>�
      in the simulator. This is to prevent the simulator from using the wrong
      packages.<span style='mso-spacerun:yes'>  </span></li>
  <li class=MsoNormal style='mso-list:l3 level2 lfo3;tab-stops:list 72.0pt'>Normally
      a Lego Mindstorms robot will exit after the main method is finished. This
      however, is not the same for an Intellejos robot, which will continue
      running. </li>
 </ul>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>After
     programming your robot run �<span class=SpellE>build.bat</span>� to
     compile. </li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'>When
     loading the robot in Intellejos, the contents of the �args.txt� file in
     the �robots� directory will be given as an argument to the main method of
     the robot. </li>
</ul>

<h1>References</h1>

<ul style='margin-top:0cm' type=disc>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'><span
     class=SpellE>LeJOS</span>: <a href="http://lejos.sourceforge.net/">http://lejos.sourceforge.net</a>
     </li>
 <li class=MsoNormal style='mso-list:l3 level1 lfo3;tab-stops:list 36.0pt'><span
     class=SpellE>Intellego</span> robot emulator: <a
     href="http://homepages.inf.ed.ac.uk/s0237680/intellego/intellego.html">http://homepages.inf.ed.ac.uk/s0237680/intellego/intellego.html</a></li>
</ul>

<h1><o:p>&nbsp;</o:p></h1>

<p class=MsoNormal>© 2004 Tijn Kooijmans</p>

</div>

</body>

</html>