Changes for page Lego On-Line Testing System (KLOTS)

Last modified by Richard Kreissig on 2023/09/14 10:54

From version < 23.1 >

edited by ybe
on 2012/07/23 13:47

To version < 6.1 >

edited by ybe
on 2012/04/23 12:27

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Objects (1 modified, 0 added, 0 removed)
- Confluence.Code.ConfluencePageClass[0]

Details

Page properties

Content

@@ -1,13 +1,16 @@
++{{warning}}
++This page is not migrated yet. Try the [[old wiki>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler||shape="rect"]] until someone fills me with content.
++{{/warning}}
++
  {{panel title="Project Overview" borderStyle="dashed"}}
  Responsible:
--* [[Christian Motika>>url:http://www.informatik.uni-kiel.de/rtsys/kontakt/cmot/||shape="rect"]]
  * Yvan Benekov
  {{/panel}}
  = KLOTS - KIELER Lego On-line Testing System[[url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/wiki/Projects/KLOTS#KLOTS-KIELERLegoOn-lineTestingSystem||title="Link to this section" shape="rect" class="anchor"]] =
--[[image:attach:klots_logo.png]]
++
  ==== Topics ====
@@ -23,13 +23,13 @@
  For more information about the leJOS NXJ project and especially the leJOS tutorial and NXT Programming API please visit the [[leJOS NXJ website>>url:http://lejos.sourceforge.net/||shape="rect" class="ext-link"]].
--**Note that KLOTS currently uses leJOS NXJ v0.8.5, not the brand new v0.9.0.** You can download the v0.8.5 API from (% class="confluence-link" %) (% class="confluence-link confluence-link" %)[[here>>attach:leJOS_v0.8.5_API.zip]](% class="confluence-link" %) (% class="confluence-link noprint confluence-link" %)[[image:attach:download.png]][[attach:leJOS_v0.8.5_API.zip]](% class="noprint confluence-link" %) (%%).
++**Note that KLOTS currently uses leJOS NXJ v0.8.5, not the brand new v0.9.0.** You can download the v0.8.5 API from here [[url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/leJOS_v0.8.5_API.zip||title="Attachment 'leJOS_v0.8.5_API.zip' in Projects/KLOTS" shape="rect" class="attachment"]](% class="noprint" %)[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/chrome/common/download.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/leJOS_v0.8.5_API.zip||title="Download" shape="rect" class="trac-rawlink"]](%%).
  ----
  == Getting Started ==
--The KLOTS is part of the KIELER Rich Client Application (RCA) which can be found in the [[Downloads>>url:http://www.informatik.uni-kiel.de/rtsys/kieler/downloads/||shape="rect"]]. It is a standalone application containing all KLOTS features.
++The KLOTS is part of the KIELER Rich Client Application (RCA) which can be found in the [[Downloads>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/wiki/Downloads||shape="rect" class="wiki"]]. It is a standalone application containing all KLOTS features.
  The required Eclipse plug-ins can also be downloaded from the KIELER update page. To get the full functionality of the KLOTS several plug-ins are required:
@@ -36,8 +36,6 @@
  * de.cau.cs.kieler.core
  * de.cau.cs.kieler.core.kivi
  * de.cau.cs.kieler.core.model
--* de.cau.cs.kieler.core.model.gmf
--* de.cau.cs.kieler.core.model.xtext
  * de.cau.cs.kieler.core.ui
  * de.cau.cs.kieler.klots
  * de.cau.cs.kieler.sim.kiem
@@ -44,9 +44,6 @@
  * de.cau.cs.kieler.sim.kiem.config
  * de.cau.cs.kieler.sim.kiem.ui
  * de.cau.cs.kieler.sim.table
--* de.cau.cs.kieler.sim.signals
--* de.cau.cs.kieler.sim.syncsignalreset
--* de.cau.cs.kieler.sj
  * net.sf.antcontrib.cpptasks
  * org.apache.bcel
  * org.bluecove
@@ -56,7 +56,7 @@
  * org.lejos.jtools
  * org.lejos.pccomms
  * org.lejos.pctools
--* If you want to be able to import KLOTS example programs using the KIELER Example Management (KEX), you will also need:\\
++* If you want to be able to import KLOTS example programs using the KIELER Example Management (KEX), you will also need:
  ** de.cau.cs.kieler.core.kgraph
  ** de.cau.cs.kieler.kex
  ** de.cau.cs.kieler.kex.ui
@@ -63,12 +63,11 @@
  ** de.cau.cs.kieler.kiml
  ** de.cau.cs.kieler.kiml.service
  ** de.cau.cs.kieler.kiml.ui
--** de.cau.cs.kieler.klots.examples
  * **be sure to click on the "Add Required Plug-ins" button**
  Then you should be able to start KIELER and select the //KLOTS perspective// (Window->Open Perspective->Other...->KLOTS).
--(% class="confluence-link" %)[[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/perspective.png]]
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/perspective.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/perspective.png||shape="rect"]]
  ----
@@ -98,23 +98,20 @@
  If you are running KLOTS from a non-root user, you will need to ensure that you have read and write access for the NXT USB device in ///dev/bus/usb//. If you can identify the device in ///dev/bus/usb//, you can do this by:
--{{code language="bash"}}
--sudo chmod a+w /dev/bus/usb/xxx/yyy
--{{/code}}
++{{{sudo chmod a+w /dev/bus/usb/xxx/yyy
++}}}
  However, the //yyy// number will count up each time the NXT is disconnected and reconnected. A better solution is to use **udev rules**. How to do this may vary with different Linux systems. To use //udev rules//, set up a file such as ///etc/udev/rules.d/70-lego.rules// and populate it with the following lines:
--{{code language="bash"}}
--# Lego NXT
--BUS=="usb", SYSFS{idVendor}=="03eb", GROUP="a Linux user group", MODE="0660"
--BUS=="usb", SYSFS{idVendor}=="0694", GROUP="a Linux user group", MODE="0660"
--{{/code}}
++{{{# Lego NXT
++BUS=="usb", SYSFS{idVendor}=="03eb", GROUP="a Linux user group", MODE="0660"
++BUS=="usb", SYSFS{idVendor}=="0694", GROUP="a Linux user group", MODE="0660"
++}}}
  You should replace the //a Linux user group// entry with the user group to witch your Linux user account belongs. The two vendors are LEGO and Atmel (for the Sam-Ba driver used in firmware update mode). You may need to reload the rules or restart //udev//. On some Linux systems, the command to reload the rules is:
--{{code language="bash"}}
--sudo udevadm control --reload-rules
--{{/code}}
++{{{sudo udevadm control --reload-rules.
++}}}
  === (optional) Bluetooth set-up on Linux systems ===
@@ -127,8 +127,8 @@
  In order to be able to download and execute Embedded Java programs, the leJOS NXJ firmware should be installed on your NXT brick. KLOTS provides an easy firmware flash feature. To install the leJOS NXJ firmware connect the NXT with the computer via USB and turn it on. Then select //Window->Preferences->KIELER->Lego execution->Firmware flash// and follow the instructions. You do not need to set the NXT brick in firmware-update mode, although doing so may help in case you are getting errors during the flash procedure. The whole process should not take more than a minute and after that the new firmware is permanently saved on the NXT's flash memory, so that the original Lego firmware is fully removed. If you want to remove the leJOS NXJ firmware and switch back to the original Lego firmware, you have to flash it on the NXT brick. More information on how to do so can be found on the [[Lego Mindstorms website>>url:http://mindstorms.lego.com/en-us/support/default.aspx||shape="rect" class="ext-link"]].
--(% class="confluence-link" %)[[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/preferences_firmware_flash1.png]](%%)
--(% class="confluence-link" %)[[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/preferences_firmware_flash2.png]][[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/preferences_firmware_flash3.png]]
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/preferences_firmware_flash1.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/preferences_firmware_flash1.png||shape="rect"]]
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/preferences_firmware_flash2.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/preferences_firmware_flash2.png||shape="rect"]][[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/preferences_firmware_flash3.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/preferences_firmware_flash3.png||shape="rect"]]
  ----
@@ -136,7 +136,7 @@
  Next you must specify how KLOTS shall communicate with the NXT brick. There are two possible options: communication via USB or communication via Bluetooth. Select //Window->Preferences->KIELER->Lego execution// and choose your favored connection type. In addition you can specify the brick's hardware address or friendly name. To save you all the manual selections, you can simply click on the //Search for NXTs// button and then choose your NXT from the list of found bricks. Note that for establishing Bluetooth connection, your NXT and computer should be already paired. The pairing procedure may vary with different operating systems and Bluetooth stacks. However you should always initiate it from the computer, not from the NXT brick. The default NXT PIN for the Bluetooth connection is set to **1234**.
--(% class="confluence-link" %)[[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/preferences_connection1.png]][[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/preferences_connection2.png]]
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/preferences_connection1.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/preferences_connection1.png||shape="rect"]][[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/preferences_connection2.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/preferences_connection2.png||shape="rect"]]
  ----
@@ -144,7 +144,7 @@
  In order to be able to write your first program, you should create a new Embedded Java project. To do so, select //File->New->Project...->KIELER->Embedded Java Project//. Then specify the new project's name and click on //Finish//. The project will be then automatically created and appears in the //Project Explorer View// on the right site.
--(% class="confluence-link" %)[[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_project.png]]
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_project.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/new_embedded_java_project.png||shape="rect"]]
  ----
@@ -152,34 +152,17 @@
  You are now ready to create a new Embedded Java file. Click on the project and package in witch you wish to create the new file and select //New->Other...->KIELER->Embedded Java File//. Type in a name for the new file and click on //Finish//. Note that the file name should not exceed 20 characters including the file extension.
--(% class="confluence-link" %)[[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_file.png]]
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_file.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/new_embedded_java_file.png||shape="rect"]]
  ----
  == Introducing the KLOTS Editor ==
--{{section}}
--{{column width="90%"}}
--When the KLOTS perspective is activated, Embedded Java files //(.java)// will be automatically associated with the //KLOTS Editor//. To open an Embedded Java file simply double-click on it. The KLOTS Editor offers the full functionality of the //standard Eclipse Java Editor// as well as means to build, download and execute Embedded Java programs on the NXT brick. The easiest way to check if a file is displayed in the KLOTS Editor is to look at the editor's toolbar. There should be four new buttons.
--{{/column}}
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/buttons_all.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/buttons_all.png||shape="rect"]]When the KLOTS perspective is activated, Embedded Java files //(.java)// will be automatically associated with the //KLOTS Editor//. To open an Embedded Java file simply double-click on it. The KLOTS Editor offers the full functionality of the //standard Eclipse Java Editor// as well as means to build, download and execute Embedded Java programs on the NXT brick. The easiest way to check if a file is displayed in the KLOTS Editor is to look at the editor's toolbar. There should be four new buttons.
--{{column width="10%"}}
--[[image:attach:buttons_all.png]]
--{{/column}}
--{{/section}}
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/buttons_build.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/buttons_build.png||shape="rect"]]You can now write your code in the corresponding section and click on the **Build Embedded Java Program** button. Your program will then be build and linked with the leJOS NXJ library. An executable file named //<your_program's_name>.nxj// should appear in the project's //bin// folder.
++ Sometimes, while running your program on the NXT brick, you may get a "blue screen", i.e. the brick plays an error tune and a message like
--{{section}}
--{{column width="90%"}}
--You can now write your code in the corresponding section and click on the **Build Embedded Java Program** button. Your program will then be build and linked with the leJOS NXJ library. An executable file named //<your_program's_name>.nxj// should appear in the project's //bin// folder.
--{{/column}}
--
--{{column width="10%"}}
--[[image:attach:buttons_build.png]]
--{{/column}}
--{{/section}}
--
--Sometimes, while running your program on the NXT brick, you may get a "blue screen", i.e. the brick plays an error tune and a message like
--
  |(((
  Java Exception:
  )))
@@ -195,45 +195,22 @@
  appears on the display. This indicates that an uncaught Java //Runtime Exception//, e.g. (% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %)//NullPointerException//(% style="color: rgb(0,0,0);" %),(%%) occurred somewhere in your program. The error message indicates the kind of the exception and the method where it was thrown. This information is produced by the program build procedure and you can see it by clicking on the //Details// button. It can be very helpful for debugging your programs.
--(% class="confluence-link" %)[[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/build_program_output.png]]
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/build_program_output.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/build_program_output.png||shape="rect"]]
++\\
--{{section}}
--{{column width="90%"}}
--By clicking on the **Download Embedded Java Program to NXT** button the executable file will be downloaded to your NXT brick. The file will then appear in the //Files// submenu on the brick. Note that for the downloading process the NXT should be turned on and connected to the computer via USB. (You can also download programs via Bluetooth.)
--{{/column}}
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/buttons_download.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/buttons_download.png||shape="rect"]]By clicking on the **Download Embedded Java Program to NXT** button the executable file will be downloaded to your NXT brick. The file will then appear in the //Files// submenu on the brick. Note that for the downloading process the NXT should be turned on and connected to the computer via USB. (You can also download programs via Bluetooth.)
--{{column width="10%"}}
--[[image:attach:buttons_download.png]]
--{{/column}}
--{{/section}}
--
--{{section}}
--{{column width="90%"}}
--To run the program on your NXT brick, in case the program uses the //remote print// option and you want to enable remote printing, you should click on the **Run Embedded Java Program on NXT** button. The program will then be started on the NXT and you should specify **on the brick** whether or not you want to enable remote printing and the protocol for the connection with the computer (USB or Bluetooth). Then you should make the corresponding selection in KLOTS.
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/buttons_run.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/buttons_run.png||shape="rect"]]To run the program on your NXT brick, in case the program uses the //remote print// option and you want to enable remote printing, you should click on the **Run Embedded Java Program on NXT** button. The program will then be started on the NXT and you should specify **on the brick** whether or not you want to enable remote printing and the protocol for the connection with the computer (USB or Bluetooth). Then you should make the corresponding selection in KLOTS.
  **Remember to do the connection selection always on the NXT site first, since doing otherwise can trigger connection abort!**
--{{/column}}
--{{column width="10%"}}
--[[image:attach:buttons_run.png]]
--{{/column}}
--{{/section}}
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/buttons_console.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/buttons_console.png||shape="rect"]]The remote prints will be then displayed on the //KLOTS Console// on the right site of the KLOTS Perspective. You can temporary disable the remote printing by clicking on the **Disable Console** button. You can then enable remote printing at any time by simply clicking on that button again.
--{{section}}
--{{column width="90%"}}
--The remote prints will be then displayed on the //KLOTS Console// on the right site of the KLOTS Perspective. You can temporary disable the remote printing by clicking on the **Disable Console** button. You can then enable remote printing at any time by simply clicking on that button again.
--{{/column}}
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_console1.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_console1.png||shape="rect"]][[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_console2.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_console2.png||shape="rect"]]
--{{column width="10%"}}
--[[image:attach:buttons_console.png]]
--{{/column}}
--{{/section}}
--
--(% class="confluence-link" %)[[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_console1.png]][[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_console2.png]]
--
  If you are not using remote printing, or do not want to enable communication with a computer, you can also start a program by choosing it from the //Files// submenu on the NXT brick.
  === An Embedded Java sample program ===
--(% class="confluence-link" %)[[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_editor1.png]][[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_editor2.png]]
++[[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_editor1.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_editor1.png||shape="rect"]][[~[~[image:url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/raw-attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_editor2.png~]~]>>url:http://trac.rtsys.informatik.uni-kiel.de/trac/kieler/attachment/wiki/Projects/KLOTS/new_embedded_java_file_example_editor2.png||shape="rect"]]
  ----

Confluence.Code.ConfluencePageClass[0]

Id

@@ -1,1 +1,1 @@
--8650835
++885139

URL

@@ -1,1 +1,1 @@
--https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/8650835/Lego On-Line Testing System (KLOTS)
++https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/885139/Lego On-Line Testing System (KLOTS)

Changes for page Lego On-Line Testing System (KLOTS)

Summary

Details

Navigation

Quick Links