Changeset 730

Timestamp:

07/20/09 19:55:48 (4 years ago)

Author:

atorf

Message:

Cleaned up demos:

• Added toolbox installation version check
• Removed old demos
• Improved / added comments / minor details
• Renamed to correct names

Location:

trunk/demos

Files:

• . (modified) (1 prop)
• Example_1_PlayTone.m (modified) (2 diffs)
• Example_2_ReadSoundSensor.m (modified) (2 diffs)
• Example_3_DriveAroundTable.m (deleted)
• Example_3_DriveAroundTable_MotorClass.m (moved) (moved from trunk/demos/Example_4_DriveAroundTable_MotorClass.m) (4 diffs)
• Example_4_NextGenerationUltrasound.m (moved) (moved from trunk/demos/Example_6_NextGenerationUltrasound.m) (3 diffs)
• Example_5_DriveUntilWall.m (deleted)
• Example_7_ShinyRadar.m (deleted)

trunk/demos/Example_1_PlayTone.m

@@ -1 +1 @@
 %% Example 1: Play Tone and Get Battery Level
 % Example to play a specific tone with the NXT Brick and retrieve the current battery level: 
+
+% Signature
+%   Author: Linus Atorf, Alexander Behrens
+%   Date: 2009/07/17
+%   License: BSD
+%   RWTH - Mindstorms NXT Toolbox: http://www.mindstorms.rwth-aachen.de
+
+% verify that the RWTH - Mindstorms NXT toolbox is installed.
+if verLessThan('RWTHMindstormsNXT', '2.00');
+    error('This program requires the RWTH - Mindstorms NXT Toolbox version 2.00 or greater. Go to http://www.mindstorms.rwth-aachen.de and follow the installation instructions!');
+end%if
+
 
 % Close previous handles (if existing)
@@ -12 +24 @@
 %  - Device drivers (Fantom on Windows, libusb on Linux) have to be already installed for USB to work.
 %  - For using Bluetooth a previous configuration file has to be generated COM_MakeBTConfigFile)
+%  - This call will not try to open a Bluetooth connection...
 handle = COM_OpenNXT();
+% at this place we could call COM_SetDefaultNXT(handle);
 
 % Play tone with frequency 800Hz and duration of 500ms. 

trunk/demos/Example_2_ReadSoundSensor.m

@@ -1 +1 @@
 %% Example 2: Read Sound Sensor
 % Example to read the sound sensor value in db:
+
+% Signature
+%   Author: Linus Atorf, Alexander Behrens
+%   Date: 2009/07/17
+%   License: BSD
+%   RWTH - Mindstorms NXT Toolbox: http://www.mindstorms.rwth-aachen.de
+
+% verify that the RWTH - Mindstorms NXT toolbox is installed.
+if verLessThan('RWTHMindstormsNXT', '2.00');
+    error('This program requires the RWTH - Mindstorms NXT Toolbox version 2.00 or greater. Go to http://www.mindstorms.rwth-aachen.de and follow the installation instructions!');
+end%if
+
 
 % Close previous handles (if existing)
@@ -9 +21 @@
 
 % Open new NXT Bluetooth connection according to the previous generated configuration file.
+% Please note that a USB connection will be used if one is present. If no
+% USB device is found, the Bluetooth configuration file will be used.
 handle = COM_OpenNXT('bluetooth.ini');
 

trunk/demos/Example_3_DriveAroundTable_MotorClass.m

@@ -1 @@
-%% Example 7: Drive Around Table (Motor Class)
-% This example equals demo 3, but uses the motor class and an advanced motor control.
+%% Example 3: Drive Around Table (Motor Class)
+% Let's a robot (e.g. Tribot or CATTbot) to drive a square on the floor
 %
-% Note: For using the advanced motor control the MotorControl program has to be downloaded onto your
-% NXT. The MotorControl program is located at /tools/MotorControl.
+% Signature
+%   Author: Linus Atorf, Alexander Behrens
+%   Date: 2009/07/17
+%   License: BSD
+%   RWTH - Mindstorms NXT Toolbox: http://www.mindstorms.rwth-aachen.de
+
+% verify that the RWTH - Mindstorms NXT toolbox is installed.
+if verLessThan('RWTHMindstormsNXT', '3.00');
+    error('This program requires the RWTH - Mindstorms NXT Toolbox version 3.00 or greater. Go to http://www.mindstorms.rwth-aachen.de and follow the installation instructions!');
+end%if
 
 
@@ -14 +22 @@
 %% Constants and so on
 TableLength      = 1000;     % in degrees of motor rotations :-)
-QuarterTurnTicks = 217;      % in motor degrees, how much is a 90° turn of the bot?
+QuarterTurnTicks = 219;      % in motor degrees, how much is a 90° turn of the bot?
 Ports = [MOTOR_B; MOTOR_C];  % motorports for left and right wheel
-DrivingSpeed     = 50;
-TurningSpeed     = 30;
+DrivingSpeed     = 60;
+TurningSpeed     = 40;
 
 
@@ -34 +42 @@
 mStraight.Power             = DrivingSpeed;
 mStraight.TachoLimit        = TableLength;
-mStraight.BrakeAtTachoLimit = true;
+mStraight.ActionAtTachoLimit = 'Brake';
 
 
 mTurn1                      = NXTMotor(Ports(2)); % ports swapped because it's nicer
-mTurn1.SpeedRegulation      = true;  
+mTurn1.SpeedRegulation      = false;  % we could use it if we wanted
 mTurn1.Power                = TurningSpeed;
 mTurn1.TachoLimit           = QuarterTurnTicks;
-mTurn1.BrakeAtTachoLimit    = true;
+mStraight.ActionAtTachoLimit = 'Brake';
 
 
@@ -81 +89 @@
 
 
-
 % Hey! End of a hard day's work
 % Just to show good style, we close down our motors again:

trunk/demos/Example_4_NextGenerationUltrasound.m

@@ -1 @@
-%% Example 5: Next Generation Ultrasound
+%% Example 4: Next Generation Ultrasound
 % This script demonstrates the results of the ultrasound "snapshot mode"!
 % Interpretation of the results however is difficult.
@@ -6 +6 @@
 % SENSOR_2), and see what's happening. The script will exit after 200
 % measurements...
+%
+% Signature
+%   Author: Linus Atorf, Alexander Behrens
+%   Date: 2009/07/17
+%   License: BSD
+%   RWTH - Mindstorms NXT Toolbox: http://www.mindstorms.rwth-aachen.de
+
+% verify that the RWTH - Mindstorms NXT toolbox is installed.
+if verLessThan('RWTHMindstormsNXT', '2.00');
+    error('This program requires the RWTH - Mindstorms NXT Toolbox version 3.00 or greater. Go to http://www.mindstorms.rwth-aachen.de and follow the installation instructions!');
+end%if
 
 
@@ -11 +22 @@
 % Close previous handles (if existing)
 COM_CloseNXT all
+
 
 %% Set up Matlab