Difference between revisions of "MRDS"

From RobotinoWiki
(Examples)
(Download & Installation)
 
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Introduction==
+
= Introduction =
 
{|cellspacing="20" cellpadding="10"
 
{|cellspacing="20" cellpadding="10"
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
 
|[[Image:Robotino_mrds4_icon_64.png]]
 
|[[Image:Robotino_mrds4_icon_64.png]]
|The MRDS support for Robotino is here! Follow the instructions below for information on using the package.
+
|The MRDS support for Robotino is here! Follow the instructions below for information on using the package. '''Please note that the Robotino MRDS package only works with the [[API2]] installed on Robotino.'''
 
! style="text-align:left; width:20em; background-color:#dddddd"|
 
! style="text-align:left; width:20em; background-color:#dddddd"|
 
=== Package links ===
 
=== Package links ===
 
[[downloads]]
 
[[downloads]]
 
|}
 
|}
{{#ev:youtube|_5BSEdG8Uis}}
+
<!-- {{#ev:youtube|_5BSEdG8Uis}}-->
  
== The RobotinoMRDS ZIP Package ==
+
= The RobotinoMRDS ZIP Package =
 +
== Installation ==
 +
=== Prerequisites ===
  
 +
# Please note that the Robotino MRDS package only works with the [[API2]] installed on Robotino.
 +
# Microsoft Robotics Developer Studio 4. '''MRDS requires .NET 4.0 but does not install it because this comes with Visual Studio.'''
 +
'''Please note that the RobotinoMRDS package has been tested with MRDS 4. It is therefore recommended to use MRDS 4.'''
 +
[[Image:RobotinoMRDS.png|right|thumb| Simulated Robotino in MRDS]]
 +
 +
=== Download & Installation ===
 
The RobotinoMRDS ZIP package can be downloaded from the link under the Package links section on the top right of this page. After the download please go through the following steps:
 
The RobotinoMRDS ZIP package can be downloaded from the link under the Package links section on the top right of this page. After the download please go through the following steps:
  
# Extract the contents of the ZIP package to ''Microsoft Robotics Dev Studio 4 Beta\packages'' directory.
+
# Extract the contents of the ZIP package to ''Microsoft Robotics Dev Studio 4\packages'' directory. After extraction, your directory structure should look like ''Microsoft Robotics Dev Studio 4\packages\RobotinoMRDS''.
# Fire up the MRDS 4 DSS Command Prompt and navigate to the ''Microsoft Robotics Dev Studio 4 Beta\packages\RobotinoMRDS'' directory
+
# Fire up the MRDS 4 DSS Command Prompt and navigate to the ''Microsoft Robotics Dev Studio 4\packages\RobotinoMRDS'' directory
 
# Run the script ''Setup.cmd''
 
# Run the script ''Setup.cmd''
 
# Now run the script ''BuildRobotinoMRDS.cmd''
 
# Now run the script ''BuildRobotinoMRDS.cmd''
 
# If the above mentioned steps were followed properly, then the build should complete without any errors.
 
# If the above mentioned steps were followed properly, then the build should complete without any errors.
  
=== Robotino Services ===
+
== Connecting to Robotino ==
 +
If you would like to control your Robotino using MRDS, you will need to modify the following line in ''RobotinoMRDS\Services\Robotino\Robotino.cs''
 +
 
 +
<pre>
 +
_robotino.Connect("192.168.5.5");
 +
</pre>
 +
 
 +
With the IP address your Robotino.
 +
 
 +
'''Note:''' After you make the changes, make sure you build the project once again to reflect the changes in the dll which is used by other projects within RobotinoMRDS.
 +
 
 +
== Robotino Services ==
  
 
The services which can be found in the ''RobotinoMRDS\Services'' directory are:
 
The services which can be found in the ''RobotinoMRDS\Services'' directory are:
Line 29: Line 48:
 
More services shall be supported in the future.
 
More services shall be supported in the future.
  
==== Examples ====
+
=== Examples ===
 +
 
 +
A couple of examples have been provided for a better understanding of the Robotino Services and they are located in the ''RobotinoMRDS\Examples'' directory.
 +
 
 +
The examples that have been provided are:
 +
* DriveCircle Example
 +
* [[WallFollow Example]]
 +
 
 +
== Robotino Simulation Services ==
 +
 
 +
A simulated Robotino is also available for use in the Visual Simulation Environment (VSE). The simulated services which can be found under the ''RobotinoMRDS\Simulation\Robotino'' directory are:
 +
# SimulatedRobotinoBumperArray
 +
# SimulatedRobotinoDrive
 +
# SimulatedRobotinoIRArray
  
It is highly recommended that you go through the examples provided for better understanding. These examples can be found under the ''RobotinoMRDS\Examples'' directory.
+
=== Example ===
  
A video of this example in action can be viewed below.
+
A simulation scenario example has been provided for a better understanding of the Simulated Robotino Services and it is located in the ''RobotinoMRDS\Simulation\Scenarios\WallFollow'' directory.
{{#ev:youtube|KVD_eiG4x8Q}}
 
  
=== Robotino Simulation Services ===
+
* [[WallFollow Scenario]]
  
A simulated Robotino is also available for use in the Visual Simulation Environment (VSE). The related services can be found under the ''RobotinoMRDS\Simulation\Robotino'' directory.
+
= The RobotinoMRDS sources =
  
==== Example Simulation Scenario ====
+
The ZIP package above contains pre-compiled dlls of the RobotinoAPI2. If you wish to stay on the bleeding edge, you may check out the sources from [http://svn.openrobotino.org/MRDS4/trunk/ here]. '''Please note''' the following:
  
An example simulation scenario which simulates wall-following can be found under the ''RobotinoMRDS\Simulation\Scenarios\WallFollow''.
+
The bleeding edge RobotinoMRDS sources use the environment variables '''ROBOTINOAPI2_32_DIR''' and '''ROBOTINOAPI2WRAPPER32_DIR''' to locate the required DLLs. These DLLs are built by the RobotinoAPI2 and RobotinoAPI2 Wrapper projects. Read below for more information.
  
== The RobotinoMRDS sources ==
+
== Building RobotinoAPI2 ==
 +
Please follow the information on [http://wiki.openrobotino.org/index.php?title=API2#Building_API2_from_source this] wiki page to build the RobotinoAPI2 from the sources. Please do not forget to set the '''ROBOTINOAPI2_32_DIR''' environment variable.
  
The ZIP package above contains pre-compiled dlls of the RobotinoAPI2. If you wish to stay on the bleeding edge, you may check out the sources from [http://svn.openrobotino.org/MRDS4/trunk/ here].
+
== Building RobotinoAPI2 Wrapper ==
  
=== Building RobotinoAPI2 ===
+
Please follow the information on [http://wiki.openrobotino.org/index.php?title=Dotnet this] wiki page to build the RobotinoAPI2 Wrapper from the sources. Please do not forget to set the '''ROBOTINOAPI2WRAPPER32_DIR''' environment variable.
Please follow the information on [http://wiki.openrobotino.org/index.php?title=API2 this] wiki page to build the RobotinoAPI2 from the sources. Please do not forget to set the '''ROBOTINOAPI2_32_DIR''' or '''ROBOTINOAPI2_64_DIR ''' environment variables.
 
  
=== Building RobotinoAPI2 Wrapper ===
+
= The Openrobotino Forum =
  
Please follow the information on [http://wiki.openrobotino.org/index.php?title=Dotnet this] wiki page to build the RobotinoAPI2 Wrapper from the sources. Please do not forget to set the '''ROBOTINOAPI2WRAPPER32_DIR''' or '''ROBOTINOAPI2WRAPPER64_DIR''' environment variables.
+
The [http://forum.openrobotino.org/ Openrobotino Forum] connects the developers with the users. Here you will find more support and you can also post your questions/problems/bugs etc and get a quick response.

Latest revision as of 15:19, 21 March 2012

Introduction

Robotino mrds4 icon 64.png The MRDS support for Robotino is here! Follow the instructions below for information on using the package. Please note that the Robotino MRDS package only works with the API2 installed on Robotino.

Package links

downloads

The RobotinoMRDS ZIP Package

Installation

Prerequisites

  1. Please note that the Robotino MRDS package only works with the API2 installed on Robotino.
  2. Microsoft Robotics Developer Studio 4. MRDS requires .NET 4.0 but does not install it because this comes with Visual Studio.

Please note that the RobotinoMRDS package has been tested with MRDS 4. It is therefore recommended to use MRDS 4.

Simulated Robotino in MRDS

Download & Installation

The RobotinoMRDS ZIP package can be downloaded from the link under the Package links section on the top right of this page. After the download please go through the following steps:

  1. Extract the contents of the ZIP package to Microsoft Robotics Dev Studio 4\packages directory. After extraction, your directory structure should look like Microsoft Robotics Dev Studio 4\packages\RobotinoMRDS.
  2. Fire up the MRDS 4 DSS Command Prompt and navigate to the Microsoft Robotics Dev Studio 4\packages\RobotinoMRDS directory
  3. Run the script Setup.cmd
  4. Now run the script BuildRobotinoMRDS.cmd
  5. If the above mentioned steps were followed properly, then the build should complete without any errors.

Connecting to Robotino

If you would like to control your Robotino using MRDS, you will need to modify the following line in RobotinoMRDS\Services\Robotino\Robotino.cs

_robotino.Connect("192.168.5.5");

With the IP address your Robotino.

Note: After you make the changes, make sure you build the project once again to reflect the changes in the dll which is used by other projects within RobotinoMRDS.

Robotino Services

The services which can be found in the RobotinoMRDS\Services directory are:

  1. Robotino
  2. RobotinoBumperService
  3. RobotinoDistanceSensorsService

More services shall be supported in the future.

Examples

A couple of examples have been provided for a better understanding of the Robotino Services and they are located in the RobotinoMRDS\Examples directory.

The examples that have been provided are:

Robotino Simulation Services

A simulated Robotino is also available for use in the Visual Simulation Environment (VSE). The simulated services which can be found under the RobotinoMRDS\Simulation\Robotino directory are:

  1. SimulatedRobotinoBumperArray
  2. SimulatedRobotinoDrive
  3. SimulatedRobotinoIRArray

Example

A simulation scenario example has been provided for a better understanding of the Simulated Robotino Services and it is located in the RobotinoMRDS\Simulation\Scenarios\WallFollow directory.

The RobotinoMRDS sources

The ZIP package above contains pre-compiled dlls of the RobotinoAPI2. If you wish to stay on the bleeding edge, you may check out the sources from here. Please note the following:

The bleeding edge RobotinoMRDS sources use the environment variables ROBOTINOAPI2_32_DIR and ROBOTINOAPI2WRAPPER32_DIR to locate the required DLLs. These DLLs are built by the RobotinoAPI2 and RobotinoAPI2 Wrapper projects. Read below for more information.

Building RobotinoAPI2

Please follow the information on this wiki page to build the RobotinoAPI2 from the sources. Please do not forget to set the ROBOTINOAPI2_32_DIR environment variable.

Building RobotinoAPI2 Wrapper

Please follow the information on this wiki page to build the RobotinoAPI2 Wrapper from the sources. Please do not forget to set the ROBOTINOAPI2WRAPPER32_DIR environment variable.

The Openrobotino Forum

The Openrobotino Forum connects the developers with the users. Here you will find more support and you can also post your questions/problems/bugs etc and get a quick response.