Programming with Mundo

In this assignment you will learn how to use the MundoCore communication middleware and how to write and simulate a small context-aware application.

1. Installing and Configuring MundoCore

• Get MundoCore from here: /fs-0/5/aitenbic/pub/mundocore-java-0.9.9-1.zip
• Unpack the ZIP-File.
• Edit the file config/build.properties and set the variable mcroot to the directory where you have unpacked MundoCore. Also set the variable mcc such that it points to the Linux-Version of the precompiler, i.e. mcc-linux.

• Change to the directory samples/chat/simple.
• Run ant to compile it.
• You can run the program now with ./run.sh.

Start two instances of the chat program and check that they communicate with each other. The program can be exited by entering only . on a line.

2. Installing WorldView

• Get WorldView from here: /fs-0/5/aitenbic/pub/worldview-0.9.7.zip
• Create a new directory worldview and unpack the ZIP-File into it.
• You can run WorldView with: java -jar worldview.jar.

Now create a map with three rooms, add a Ubisense controller, and three tags:

• Draw three rectangles to mark the rooms. Name them room1...room3.
• Add a Ubisense Controller to the map. Set the channelName-Property to ubisense.
• Add three Ubisense Tags to the map and set their name and tagName properties.
• Save the map.

Now you can simulate the Ubisense system with one instance of WorldView and monitor it with another one.

• Start a second instance of WorldView and load the map you have just saved.
• Open the Ubisense Client in both instances and check Receive in one client and Simulate in the other client.
• When you now move around tags in one WorldView, the changes should be propagated to the other WorldView.

3. Receiving Ubisense Messages

In this exercise you will learn how to receive messages using the publish/subscribe system. Write a small console program that receives and prints Ubisense messages, sent by WorldView. To create a new project in Eclipse, perform the following steps:

• Create a new Java Project.
• Make sure that you select: Create separate source and output folders.
• In the Libraries tab, select Add External JARs. Now add lib/mundocore.jar. Then expand the new entry, select Source Attachment, click Edit, and select sources.zip from the MundoCore distribution.
• Copy the file node.conf.xml from the WorldView directory to the project directory.

Complete the following program, compile, and run it:

public class UbisenseTest extends DefaultApplication implements IReceiver
{
  @Override
  public void init()
  {
    super.init();
    session.subscribe("lan", "ubisense", this);
  }
  public void received(Message msg, MessageContext ctx) // IReceiver
  {
    TypedMap m = msg.getMap("main", "passive").getMap("object");
    System.out.println(m);
  }
  public static void main(String args[])
  {
    start(new UbisenseTest());
  }
}

When you now simulate the Ubisense system with WorldView, your program should print coordinates to the console.

Next, extend this program with formatted output. Use the method getString of TypedMap to obtain the tag name. Use getMap to obtain the nested map p and then read the coordinates x and y from it with getDouble.

4. Controlling a Lamp

In this exercise you will learn how to make Remote Method Calls (RMCs) to services using MundoCore. Write a small console program that reads input from the console and controls a lamp, simulated by WorldView. When you type 0 on the console, the lamp should be turned off, and when you type 1 on the console, then the lamp should be turned on.

Create a new project:

• Create a new Java Project.
• Make sure that you select: Create separate source and output folders.
• In the Source tab, select Create new source folder and name it prep.
• In the Libraries tab, select Add External JARs. Now add lib/mundocore.jar. Then expand the new entry, select Source Attachment, click Edit, and select sources.zip from the MundoCore distribution.
• Copy the file node.conf.xml from the WorldView directory to the project directory.
• Copy the ant buildfile /fs-0/5/aitenbic/pub/build.xml to the project directory.

Add the following import statement to your program. The @mcImport tag will instruct the precompiler (mcc) to generate the lamp interface and client stub from the WSDL interface description of the Lamp-Service:

//@mcImport
import org.mundo.bas.ILamp;
import org.mundo.bas.DoILamp;

Now run the ant buildfile by selecting Run As > Ant Build. ILamp and DoILamp should appear in the subdirectory prep.

In the init method, create a distributed object and connect it:

doLamp = new DoILamp(); 
Signal.connect(doLamp, session.publish("lan", channelName));

You can now use the setState method to switch the lamp on or off. Hint: You can look at the source code of the chat example program to see how to read input from the console.

Next, model a lamp in WorldView and test your application:

• Add a Lamp (under Building Automation) to your map and change its channel name property to (e.g.) lamp1.
• You should now be able to switch the lamp on and off with your application.

5. Context-Aware Lightswitch

In WorldView, put a lamp into each of your three rooms. Write a program that controls these lamps. If at least one tag is located inside a room, then automatically turn the corresponding light on. If a room is empty, then turn the light off.

Note: In this step you can hardcode the coordinates of the rooms in your program.

6. Context-Aware Lightswitch 2.0

Extend your program to use the World Model Store Service to obtain the coordinates of rooms.

• Similar to before, use the precompiler to import org.mundo.service.wmstore.WMStoreService
• Use the channel wmstore to access the World Model Store Service.

Starting the WMStore service:

• Unpack /fs-0/5/aitenbic/pub/wmstore.tar.gz to your home directory.
• Run java -jar wmstore-app.jar
• You can now use the command File > Upload in WorldView to store the current map in WMStore.

Call select("MapRect") on WMStoreService to obtain all rectangles in the map.