Doumentation

Article Index
Doumentation
Supported GPS devices
The TMW-1000 logger
     - Appearance and led display
     - Getting started with the logger
     - TMW-1000 driver download and installation (Windows)
     - TMW-1000 application download (Mac OS X)
     - Instructions for Linux users
Uploading files to our site
Browsing the map, routes and races
Map options and modes
All Pages

Introduction

This brief section is designed to help you get started with our service and with the tracemyworld logger. In particular, you will learn how to download data from the logger in order to upload your routes to the website.
Please note that the tracemyworld online application can also be used with other GPS devices capable of exporting data to gpx, hst, tcx or fit formats.


Supported GPS devices

The tracemyworld web application supports every GPS data recorder able to export data in GPX, TCX, FIT or HST data formats.

Therefore you may effectively use any major available gps-sport device (Garmin, Polar, etc..) or any other gps device that can produce these kind of logs.

Note that you can also use your smartphone, just look for "tracemyworld" in iTunes or Android Market !

Should you need a cheap device please have a look at our online shop.


See in the next section how you can upload your data on the tracemyworld website and start using the application!


The TMW-1000 logger

TraceMyWorld is proud to present the TMW-1000, featuring an all-in-one, small, robust and cost-effective portable GPS logging solution.
Due to its key features, it's ideal to carry everywhere, especially when doing sport and outdoor activities.

Details

  1. 125'000 waypoints
  2. MTK chipset
  3. 66 channels
  4. weights 50g
  5. 32 hours of logging
  6. 73 x 45 x 18 mm

Appearance

  1. Power Jack (mini USB type)
  2. Mode switch (power off / logging mode)
  3. Internal antenna
  4. GPS status led (orange)
  5. Battery status led (red / green)
  6. Log mode led

Led display

  • Battery status led
    • If it's red and blinking, the battery is too low
    • If it's green, the battery is charging
    • If the light is off, the battery is fully charged
  • GPS status led
    • If it's fixed orange, the device is acquiring satellites
    • If it's orange and quickly blinking, the GPS position is fixed
  • Log mode led
    • If it's blue and blinking, the device is logging

 


Getting started with the logger

Using the TMW-1000 GPS logger is straightforward, you just have to follow these simple steps:

Step 1) Charging the battery.

 

For the 1st time you use the TMW-1000, please charge battery until it is full (no LED light display). Charging time is about 3~4 hours.

To do so, just take the power cable and connect it to the power jack (mini USB type). This will begin to charge the battery.
The LED that represents the battery is the right-most battery icon (shown in below).

If the LED is red, that means battery power is critically low. Charge immediately.
If the LED is green, that means battery is charging now.
If the no LED light display, that means battery is fully charged.
When you plug into the mini USB cable to charge your unit, you can see the green LED turning on.

Step 2) Turn on the power switch.

 

From now on, the GPS logger is active.
It’s better to turn off the device when you don’t use it, or the serial flash's life can’t last long !!!

Logger off
Logger on

 

 

Step 3) Have Fun!

 

Record your sport performance, or simply your vacations, or your child movements and so on, with the logger.

Step 4) Connect to the Computer and start the application.

 

Before downloading the GPS log from the logger, you have to follow the installation process best suited for your current operating system.
The following instructions are for for Windows operating systems, but we also support Mac OS X and Linux, so please read the appropriate section if you use these oses.
Once you've installed the correct driver and/or application, you can download the GPS data from the logger whenever you want.

Start the software, click on "read from device", select the track and save to a file. You may even want to configure the program or set various options, as you can see from the pictures below.

 

 


TMW-1000 driver download and installation for Windows


Important (Windows 7 in particular): Choose not to get the latest drivers from Windows Update BEFORE Tracemyworld's driver installation, following these steps:

1) Go to "Control Panel" -> "Hardware and Sounds" -> "Devices and Printers"

2) Right-click on your PC icon and open the "Device Installation Settings menu"

3) Select "No, let me choose what to do" and "Never install driver software from Windows Update"

(at the end of the installation you can set this option back to your preferred settings)

In order to use the logger, you have to install the TraceMyWorld GPS Utilities, which basically are a device driver and a particular application. Don't worry, they are not harmful, but they are needed to let your computer see and communicate with the device.
Here is how the installation look like.


Here is the complete package: 
(supported OSes: Windows XP/Vista/7)

Troubleshooting for Windows 7 users

In order to let the driver work under Windows 7, please go to the "Control panel", "System", "Device manager", then right-click on the question mark icon of the GPS receiver and select the "Update driver software" option. A popup window will appear, please select "Browse my computer for driver software", and choose the path (use the "Browse..." button) of the currently installed drivers: "C:\program file (x86)\Tracemyworld GPS Util\TSI_Driver". Click on "include subfolders", confirm and you're done!


TMW-1000 application download for Mac OS X

Using the TMW-1000 logger under Mac OS X is absolutely simple with our little dashboard widget.
If you're not used to the Dashboard, it's a particular environment in which you can arrange and run very small web application, called 'Widgets'.
To access the Dashboard, just click the dashboard icon on your dock, or the dashboard key on your keyboard, or press "Fn" and "F12" together.

The widget will look like the picture on the right.
If the logger wasn't connected to the system, or just turned off when the widget was started, just click on "Search device" to force device detection.

You may want to configure or check some parameters of the application; if you click the small "i" on the top-right of the widget, the following configuration panel will appear.

As you can see, you can choose the device port (the widget should pick up the right port for you) and the directory in which files will be downloaded (if you change this path, please make sure that this directory really exists!).

When you are ready to download the log, press the "Download log" button. Please note that if you want to also clean up the logger memory after the download, you have to check the "Erase memory" option.
When finished, you will find the gpx in the chosen directory, with the "tmwlog" filename prefix.


Here is the widget package:  

Click the download button and wait for the system to ask you if you want to install the software, then accept the widget by clicking the "Keep" button.
The widget is now installed and can be accessed anytime by activating the dashboard (with the icon on the dock, or the dashboard key on your keyboard, or by pressing "fn"+"F12").

Instructions for Linux users

Using the TMW-1000 under linux requires a fairly recent kernel or a patch to a kernel module.
We'll assume you have a recent one, since patching the module and recompiling may be quite difficult for unexperienced users.

  1. First of all, plug the device in, switch it on and wait for about 15 seconds. Then, check whether you have a device called: /dev/ttyACM0.
    You can do this by simply issuing this command: ls /dev/ttyACM0
    The output should not contain the response: "No such file or directory". If everything is ok, skip the following instructions and jump to the next step.
    If the device doesn't exist, try manually loading the required module, with the command (issued as root or with sudo): modprobe cdc-acm
    The device should now be listed under /dev.
    Still no luck? Try with a different number, for example: ls /dev/ttyACM1
    If you don't have the device at this point, maybe your kernel is too old. You should update it following your distribution directions and try again.
  2. Check if your linux user account has enough permissions to access the logger.
    The command: ls -al /dev/ttyACM0
    shows the device group owner; for instance:
    crw-rw---- 1 root dialout 166, 0 5 gen 02:46 /dev/ttyACM0
    means that the device belongs to the "dialout" group with write permissions.
    In this case, you should add your linux account to the "dialout" group, with the command: adduser youruser dialout
    If the output of the "ls -al /dev/ttyACM0" command is somehow different, and similar to:
    crw------- 1 root root 166, 0 etc...etc...
    you should change the device file group or make it accessible by executing:
    chmod 666 /dev/ttyACM0
  3. Install gpsbabel. This can be done in a number of different ways, depending on your linux variant.
    On debian systems (such as ubuntu), simply run: aptitude install gpsbabel (or apt-get install gpsbabel).
    If you have a SuSe, you can find gpsbabel under YaST.
    If you are totally lost because you can't install gpsbabel, you may want to visit their website:
          http://www.gpsbabel.org.
  4. Once the logger has been found by your kernel and gpsbabel is installed, just type:
    gpsbabel -t -w -i mtk,erase -f /dev/ttyACM0 -o gpx -F mylog.gpx

    The former command downloads the content of the logger into a file called "mylog.gpx", erasing the memory in the process. If you don't want to clear the memory of the logger, simply omit the ",erase" part:
    gpsbabel -t -w -i mtk -f /dev/ttyACM0 -o gpx -F mylog.gpx

    The gpx file can now be uploaded on the tracemyworld website!


Uploading files to our site

Once you have obtained your gpx (.hst, .tcx and .fit are also accepted) from the Tracemyworld logger, or from any other gps device, you can use it with our web application.

To fully use our web services, you must be registered to the TraceMyWorld portal. The registration is absolutely free, so that you can enjoy the potential of the application.

Once registered and logged-in, you can start the application and perform the desired tasks.


For instance, upload the file you got from the GPS logger and effectively see and replay the performance.
Click on the upload tab, select the file and press "upload".

You will be prompted with a simple panel showing the sub-paths found in your GPS log.
For each path you can set different options, as well as their name, description, and so on, by clicking the details button. And don't forget to set the route type!
Paths can be joined together, or removed if desired.
When you're satisfied with your selections, you can proceed by saving all the available routes, or only the ones you're interested in.


At this point, you're ready to use and enjoy the TraceMyWorld application!

 

 


Browsing the map, routes and races

Tracemyworld offers a lot of ways to navigate through the map and search routes or races.

If you want to go to a particular place by providing its address, click on "Go to address..." in the right menu, or right-click on the map and select the "Go to address..." option, as shown below.


If you're in "Overview mode", you can zoom-in a particular region by simply clicking on the map. You can also access the zoom controls in the bottom toolbar or in the top-left corner of the map.


To search for a route or race, you can:

  • Use the pre-defined filters as shown below. If you click on the "+" button, an advanced search panel will appear
  • Find the region you're interested in on the map and click on the icon in the middle. The number of routes in that particular geographical region is shown inside the circle.
    Click the "Load the routes in this area" button to list the desired routes in the table on the left
  • To show a preview of the routes listed in the table, click "Map options" and select the "Routes preview" option. Hit "Apply" and you'll find them on the map


Map options and modes

Using Tracemyworld is quite simple, but you have to understand a few things first, for instance the statuses of the map and the options you can turn on and off.

The most important switch is the one labeled with "1" in the figure below: it controls what the map is going to display.

  • Grid Overview: this mode draws a sort of "grid" on the map, effectively splitting the world in square "regions", so that you can see how many routes or races there are in a particular area. If you zoom in or out, regions become narrower or wider.
    In this mode you can change a few options from the "Map options" menu (the one labeled "2" in the above picture).

    • The "Region mode" option shows every region that has at least a route/race in it
    • "Follow mouse" only displays the region that's actually under the mouse cursor
    • "Routes preview" is quite different, because it shows on the map the preview of all the routes currently listed in the table on the left. From the same table you can select which routes you want to see by clicking on the checkboxes
  • Edit mode (or map mode): in this mode you may edit the currently loaded route (if you have enough permissions), or create a new one by drawing waypoints.
    This mode is enforced when you load routes or races.
    When you are in edit mode and you have enough permissions to change a route, the switch labeled with "3" above controls whether you want the map to be editable.
    • When it's red, you can't edit waypoints
    • If it's green, you can change the path, add or remove waypoints or POIs and so on
    • By clicking on the icon when it's green, it turns orange, temporarily disabling the edit mode. This is usually used to prevent accidental changes to a route