2017.05.04 The AViDA group now has a blog. Any new news item will from now on go to the blog instead of here.


Software Configuration and Description: Magic Leap

The Magic Leap can be utilized with game engines, such as Unity and Unreal, and also directly through the SDK using C or C++. Magic Leap provides a lot of information on their development web pages. Some additionl information is provided here as well.

In order to run custom software on the Magic Leap 1, that software needs to be installed on the device. Alternatively, you can use Magic Leap's Zero Iteration, for example, within Unity. To communicate with the Magic Leap 1, a USB connection can be used, for example, by using a USB-A to USB-C cable. The Magic Leap 1 will prompt to ask for permission before any communication can take place.

You can also communicate with the Magic Leap 1 over a WiFi connection. For this to work, you will have to know the device's IP address and the service needs to be activated on the Magic Leap 1. In order to set up the device, Magic Leap's software "The Lab" provides a command line interface that can also be used for a variety of other communication and configuration with the device. In order to access the command line interface, start The Lab software and activate the sidebar on the left. The command line interface is accessible from the icon at the very bottom of the sidebar. To activate WiFi communication, you can use the following two commands. The full list of commands available for the Magic Leap Device Bridge (mldb) interface is available here.

  • mldb wifi status: this will print out the IP address (among other information)
  • mldb tcpip -p 5555: this will start the TCP server on the Magic Leap 1 at port 5555

More detailed information is available from Magic Leap directly. It is important to note, that the device needs to be connect via USB in order for those commands to be issued. The devices in the teaching lab should already be configured properly for you. You can also check the IP address on the Magic Leap 1 directly by selecting the WiFi icon and the information icon for the active WiFi network.

A preconfigured virtual machines running Windows 7 or Windows 10 are ready for you to useon the Linux computers in the teaching lab that can be used to develop software for the Magic Leap 1. You can start those by issuing the command "windows" or "windows -10", repsectively. Most of the necessary software is already installed for those virtual machines. Any changes you make to those configurations will not be permanent, i.e. will be lost on reboot. If you need a permanent version, you can copy the image to a local device, such as a USB drive, and then start the virtual machine with "windows -i <path-to-image>"

In order to deploy software on the Magic Leap 1, all software needs to be certified. The required certificates are available from Magic Leap. A generic certificate is already available in the Dcuments folder. To get started more quickly, Magic Leap made a basic template and a toolkit available for Unity to assist with the software development. This toolkit can be found here. Further, this package provides additional useful items. A description for some of the features available within this package can be found in this PDF. There is also a troubleshooter to make tracking down issues a little easier.