Prerequisites

In order to test Accuware Dragonfly you need:

  • An Android devic. Minimum requirements:
    • Android 5.0+.
    • Quad-core CPU, 1.5 GB of RAM (you can check the specifics of your device on this site)
    • 65 MB of internal storage available.
    • Internet connection (WiFi or cellular data).
  • The Accuware Activation email.
  • A printer.

Step 1 – Floor plan and visual markers

1.1 – Upload a floor plan

You need a detailed and scaled floor plan, and you need to upload it inside the Accuware dashboard. The floor plan becomes the reference system of Dragonfly.

To upload your floor plan:

  1. Access the Accuware dashboard at this page.
  2. Go under General > Floor Plans, and follow the instructions.
  3. Use the tools at the top of the map to better position and scale the floor plan (View, Zoom In/Zoom Out, OpacityAspect ratioRuler). DO NOT STRETCH IT, and KEEP THE PROPORTIONS.
  4. Choose the level in which you want to upload the floor plan, and (optional) assign a name and a description to the floor plan, and click on Save.

At the end of the upload process the page will display the floor plan just uploaded in the table above the map.

1.2 – Create the visual markers

  1. Inside the Accuware dashboard select Dragonfly > Marking.
  2. Use the buttons in the top-left corner to select Floorplan.
  3. Click on the floor plan to create a marker at the required location. It is mandatory to closely match the visual markers locations with the physical locations in which they will be placed. These are parameters you need to set:
    • Orientation: the orientation of the marker to the South-North axis. Use the slider’s arrow to set the orientation of your marker.
      1. If the marker lies on the floor, the orientation is the angle from the South-North direction to the direction the arrow displayed on the marker points to.
        Dragonfly - marker on floor
      2. If the marker is fixed on a wall, the orientation is the angle from the South-North direction to the direction the camera points to, if it looks orthogonal onto the marker. In this case, the arrow displayed on the marker has to point upwards.  Dragonfly - marker on wall
    • Altitude: the altitude of your marker to the floor in meters (e.g. 1.6 means 1.6 meters).
    • on Wall: this switch allows to tell if a marker is fixed on a wall (vertically fixed) or lies on the floor (horizontally fixed).
  4. Press Save to save the marker. Once saved, a green icon oriented according the settings chosen will be shown on the map.
  5. Select the marker you have just saved and press Print QR to print it.
  6. Fix (hang) the printed marker in the exact position set on the floor plan.

You must create a total of 3 visual markers at different locations around your site by repeating steps 3 to 6.

Step 2 – Test Dragonfly

2.1 – Install and setup the Dragonfly App

  1. Install the Dragonfly App from Google Play on your device by searching for “Accuware Dragonfly” or by clicking this link
  2. Allow the all the permission prompts to enable the unique ID feature for tracking and Camera permission (more info about why those permissions are needed can be found here).
  3. Approve the download of additional system files necessary for the Dragonfly App, and wait for it to complete. This may take several minutes.

2.2 – Start mapping your site

To start mapping & tracking your device in your site, you will have to point the rear camera of your device and smoothly move throughout your site, finding the 3 markers you prepared at step 1.2. After the 3rd marker is successfully detected, the Dragonfly App will show its coordinates and height of your device. The same information can be tracked in the Accuware dashboard (live and historically).

Follow these steps to start creating and using your 3D visual map:

  1. The status indication of the Dragonfly App, on the upper left corner, is NOT READY when launched. After a few seconds the status changes to IDLE: navigation is ready to be started!
  2. Press the Play button and the status will change to MAP INITIALIZATION. In this state, the camera should be moved slightly around a position while looking at a random fixed target near your first visual marker.
  3. After a short while, the status indication at the upper left corner will change to NAVIGATING and there will be small green dots on the main view: the mapping has started, and you should start mapping by pointing the camera to the first out of 3 markers. After you have detected your first marker, as indicated in the left side HUD, walk slowly but surely to the next markers, while pointing the camera to the scenery on the way towards the other markers.
  4. If the status indication will be LOST that means that the app is not able to recognize the place it is looking at. It is probably outside of the mapped area. Point your camera to a scenery that has been already mapped.
  5. When the 3rd marker is detected, the app gets a fix, and your coordinates and height are available, as indicated in the HUD. That is your location! The device can be tracked using the Accuware dashboard.
  6. It is recommended to Save the accomplished map at this stage by pressing the Save icon on the upper right corner, and optionally giving it a name and a description.
  7. Continue exploring and mapping your site. As long as the status is NAVIGATING, you are building a 3D map of your site, even without any marker in sight. You can build huge maps this way.
  8. It is recommended to Save the accomplished map from time to time and Synchronize it with the server by going to the Maps section in the Settings menu (the 3-lines icon on the upper left corner), and long pressing a certain map.

In the Maps section you can:

  1. Load a saved map to the app for use.
  2. Synchronize a saved map to or from the server via the Internet (which can take a couple of minutes depending on your Internet speed).
  3. Edit a map’s name and description.
  4. Delete the map from the server (irreversible!).
  5. Delete the map locally from the Dragonfly App (irreversible!).

Notes:

  • Two maps cannot be merged into one map.
  • When saving a large area’s map the size of the binary file can be tens of MB.
  • If you do not want to continue mapping a new area, after you got the 3rd marker fix, and only want to track your device in the area you have already mapped, enable the “Localization only” option in the Settings section.

2.3 – Track remotely your Dragonfly device

You can track remotely the location of your Android device using the Accuware dashboard following these steps:

  1. Press the Play icon of the Dragonfly App to get the NAVIGATING status by pointing the rear camera of the Android device towards a mapped scenery. If the map has been previously saved, go to Maps and Load the required map.
  2. Go to the Accuware Dashboard, select Dragonfly > Map, and view your device’s location on the floor plan.
  3. Inside the Devices section of that page you can find the list and details of all the devices that are making use of the Dragonfly App. Among those details please note especially:
    • Mac – the device unique ID generated by the Dragonfly App. The pseudo MAC address contains a total of 12 characters beginning with a “D”.
    • Last Seen – this value indicates the last time the device has been in touch with the Dragonfly server.
    • ACTION – this column contains 2 buttons:
      • Edit: this button can be used to change the name and description associated with a device.
      • Delete: this button can be used to delete a device.

Feel free to submit a support request using this form if you need assistance.