Print Friendly, PDF & Email

Prerequisites

In order to test Accuware Dragonfly you need:

  • An Android device with these specifics (you can check the specifics of your device on this site):
    • Android 5.0 or above.
    • Quad-core CPU.
    • 1.5 GB of RAM.
    • 65 MB of internal storage available.
    • Internet connection (WiFi or cellular data).
  • The Accuware Activation email (with the credentials to login into the Accuware dashboard and into the Dragonfly App).
  • A printer (to print the visual markers).

Step 1 – Floor plan and visual markers

1.1 – Upload a floor plan


Upload a floor plan inside the Accuware dashboard

You need a detailed and properly scaled uploaded inside the Accuware dashboard. The floor plan becomes the reference system of Dragonfly and it is needed to:

  1. accurately position the visual markers. In fact, the locations computed by the Dragonfly App are based on the relative distances between the visual markers created inside the Accuware dashboard and detected in real-time by the Android device on which is running the Dragonfly App.
  2. visualize remotely inside the Accuware dashboard the location of the device on which is running the Dragonfly App.

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. Select the level of interest by using the top-down menu on the top-right corner.
  3. Use the buttons in the top-left corner to select Floor plan.
  4. 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).
  5. Press Save to save the marker. Once saved, a green icon oriented according the settings chosen will be shown on the map.
  6. Select the marker you have just saved and press Print QR to print it.
  7. 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.

Notes about the visual markers: to maximize the accuracy please ensure the following conditions are met:

  • The environment has good light exposure, so that the visual marker can be easy to distinguished.
  • There is no back-light while looking at a visual markers.
  • The visual markers is not obfuscated by any object, completely or partially.
  • The visual marker surface is plan, not curvy or wavy.
  • The visual marker is big enough to be detected from a distance.

Step 2 – Test Dragonfly

2.1 – Install and setup the Dragonfly App

  1. Ensure that your device is connected to a WiFi or cellular data connection.
  2. Contact us using this form to get the Dragonfly App.
  3. Install the Dragonfly App on your Android device.
  4. Open the App and enter the credentials and the Site ID received with the Accuware Activation email.
  5. Allow the Camera usage (more info about why this permissions are needed can be found here).
  6. Approve the download of additional system files necessary for the Dragonfly App, and wait for it to complete. This may take several minutes.
  7. Turn your device into landscape mode.

2.2 – Map 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. When saving a large area’s map the size of the binary file can be tens of MB.
  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!).

Be aware that at present 2 maps can NOT be merged into one map.

2.3 – Track remotely a device running the Dragonfly App

You can track remotely the location of a device that is running the Dragonfly App 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 (or your App compiled with the Dragonfly SDK). For each Android device listed you will be able to find the following information:
    • Name – the optional name automatically assigned by the Dragonfly App or assigned manually using the Edit button under the Action column.
    • Desc – the optional description automatically assigned by the Dragonfly App or assigned manually using the Edit button under the Action column.
    • Mac – the device unique ID generated by the Dragonfly App. The pseudo MAC address contains a total of 12 characters beginning with a “D”.
    • Level ID – the level on which the device is located.
    • Position – the last location computed by the Accuware server. It is possible to center the map to the location of the device by clicking on the Go To Location button (the blue icon near the coordinates).
    • Altitude – the altitude of the device with respect to the location of the marked (altitude 0).
    • Battery – the battery level detected.
    • 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.

2.4 – Advanced settings

Press the Settings icon on the top left side. Here you can configure:

  • Enable monitoring (ON by default): allows to track remotely your device inside the section Dragonfly > Map of the Accuware dashboard as explained in this page.
  • Historical tracking (ON by default): this option allows the logging of the location over time. The locations can be shown inside the Dragonfly> History area of the Accuware dashboard as explained in this page.
  • Historical tracking update period: this is the frequency at which the locations are sent from the Dragonfly App to the server.
  • Display HUD (ON by default): display additional debug info on the left side of the screen.
  • Sound notifications (ON by default): play sounds when the system status changes.
  • Localization only (OFF by default): 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 this option.

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