Homepage

Software
- JWindowsScheduler
- EPGScheduler
- Locosys GT-31/BGT-31 Tools
- Wintec 201 Tools
- Wintec 201 Fileformat
- WebCheck
Programmierung
- Python Codeschnipsel
Fremdsoftware
- Java System Toolkit

Portierungen

Fotografie

Fotos

Kontakt

Wintec Tools

The Wintec tools for the Wintec WBT-201 (G-Rays II) GPS mouse and the Wintec WSG-1000 (G-Trender) GPS receiver are a replacement for the main tasks of the Windows Time Machine X application, which is delivered with the devices.

If you can't run windows applications or prefer commandline tools over GUI applications, the Wintec Tools will be useful for you.

If you need more information about the format of the Wintec files, I maintain some documentation on the Wintec 201 Fileformat page.

The Wintec Tools are GPL licensed open source (freeware) written in Python.

Included tools

overview.py
Create static html file with information about TK files.
readlog.py
Read gps tracklogs from Wintec WBT-201 or WSG-1000 and write them into a .tk1 file.
tk1split.py
Split .tk1 files into .tk2 and/or .tk3 files.
tk1totk1.py
Read tk1 file, recalculate the footer data and create a tk1 file with a generic name.
tkinfo.py
Display TK file information and optionally set user comment string and/or timezone for .tk2/.tk3 files.
tktogpx.py
Convert gps tracklogs from Wintec TK files into a single GPS eXchange file.
tktohtml.py
Convert gps tracklogs from Wintec TK files into xml files and make them viewable with Google Maps and/or Microsoft Virtual Earth html file.
tktonmea.py
Convert gps tracklogs from Wintec TK files into a single NMEA-0183 file.

Download

The first link contains the Wintec tools as standalone executables for Windows. The zip file must be extracted into a directory, which should be added to the path environment variable to be able to run the programs from any location. This distribution doesn't need Python to be installed on the PC!

The second link contains the python scripts, which can be used on any operating system with Python 2.5 or later installed.

Windows standalone executables of Wintec Tools version 2.1 (zip file)
Wintec Tools version 2.1 (zip file)

Requirements

Please note: These requirements are not needed for the Windows standalone executables!
  1. Python 2.5 or later
  2. pytz World Timezone Definitions for Python
  3. USPP 1.0, the Universal Serial Port Python Library
  4. Python for Windows Extensions is required on Windows by USPP

Usage

Note: The -o option to specify the output filename is optional and should be used for special needs only. Without this option the tools create and use generic filenames based on the date and time of first point of the containted track.

overview.py

Create static html file with information about TK files.

Usage: overview.py [-d directory]
-d: Process tk files in directory.

readlog.py

Read gps tracklogs from Wintec WBT-201 or WSG-1000 and write them into a .tk1 file.

Usage: readlog.py [-v] [-p password] [-d outputdir] [-o filename] [--delete] <serial port>
-v: Print debug info.
-p: Wintec WBT-201 password (4 digits).
-d: Use output directory.
-o: Use output filename.
--delete: Delete log from device after successful read.

tk1split.py

Split .tk1 files into .tk2 and/or .tk3 files.

Usage: tk1split.py [-2] [-3] [-d directory] [--d2 directory] [--d3 directory] [-c "user comment"] [-t +hh:mm|--autotz] <tk1 files>
-2: Create .tk2 files.
-3: Create .tk3 files.
-d: Use output directory for tk2 and tk3 files.
--d2: Use output directory for tk2 files.
--d3: Use output directory for tk3 files.
-c: User comment string to store in the .tk2/tk3 header.
-t: Use timezone for local time (offset to UTC).
--autotz: Determine timezone from first trackpoint.

tk1totk1.py

Read tk1 file, recalculate the footer data and create a tk1 file with a generic name.

Usage: tk1totk1.py [-d directory] [-o filename] [--delete] <tk1 file>
-d: Use output directory.
-o: Use output filename.
--delete: Delete source file after successful processing.

tkinfo.py

Display TK file information and optionally set user comment string and/or timezone for .tk2/.tk3 files.

Usage: tkinfo.py [-c "user comment"] [-t +hh:mm|--autotz] <tk files>
-c: User comment string to store in the .tk2/tk3 header.
-t: .tk2/.tk3: Set timezone for local time (offset to UTC). .tk1: Ignored.
--autotz: .tk2/.tk3: Determine timezone from first trackpoint. .tk1: Ignored.

tktogpx.py

Convert gps tracklogs from Wintec TK files into a single GPS eXchange file.

Usage: tktogpx.py [-d outputdir] [-o filename] [-t +hh:mm|--autotz] <tk files>
-d: Use output directory.
-o: Use output filename.
-t: .tk1     : Use timezone for local time (offset to UTC).
    .tk2/.tk3: Use timezone stored in tk-file.
--autotz: .tk1     : Determine timezone from first trackpoint.
          .tk2/.tk3: Use timezone stored in tk-file.

Note: The time in .gpx files is defined as UTC. If you use the -t or --autotz
option, the time is converted to the timezone, but still marked as UTC.
The used timezone is added to the <desc> tag.

tktohtml.py

Convert gps tracklogs from Wintec TK files into xml files and make them viewable
with Google Maps and/or Microsoft Virtual Earth html file.

Usage: tktohtml.py [-g] [-v] [-d directory] [-o filename] [-t +hh:mm|--autotz] <tk files>
-g: Create Google Maps html file.
-v: Create Microsoft Virtual Earth html file.
-d: Use output directory.
-o: Use output filename.
-t: .tk1: Use timezone for local time (offset to UTC). .tk2/.tk3: Ignored.
--autotz: .tk1: Determine timezone from first trackpoint. .tk2/.tk3: Ignored.

tktonmea.py

Convert gps tracklogs from Wintec TK files into a single NMEA-0183 file.

Usage: tktonmea.py [-d outputdir] [-o filename] <tk files>
-d: Use output directory.
-o: Use output filename.

Known Issues

The Time Machine X 2.7.0 doesn't set the log version to 2.0 for WGS-1000 logs containing temperature and air pressure values. Use tk1totk1 to create a fixed TK1 file or use readlog instead of TMX to read the log from GPS device.

Computed values like track length, speed, direction might differ from the values in files created by Time Machine X 2.7.0. For most values the difference should be rather small, but the direction is more than 10 degrees off, because Time Machine X 2.7.0 computes wrong values. This issue is fixed in Time Machine X 2.7.1.
Generally the values computed by Wintec tools should be more accurate than the values of Time Machine X, as they use the very precise Vincenty formula with the WGS-84 ellipsoidal earth model.

Changelog

Version 2.1

  • readlog: The WGS-1000 sometimes returns the wrong block. Retry if the returned data block is not the requested one.
  • readlog: Wrapped logbuffer handling was broken.
  • readlog: The WSG-1000 doesn't pad the checksum with a trailing zero.
  • tktogpx: Recognize options -t and --autotz.

Version 2.0

  • Local timezone can be automatically determined by location and date/time of first trackpoint.
  • Windows executables available (running without separate Python installation).
  • Wintec WSG-1000 support added to readlog.
  • Support log format 2.0 of WSG-1000 (temperature and air pressure).
  • .tk2 and .tk3 support added including user comments.
  • NMEA output format added.
  • Google Maps output added.
  • GPX/NMEA/Google Maps/Virtual Earth format is Time Machine X 2.7.1 compatible.
  • Support for 64-bit operating systems.

Version 1.0

  • Initial release.

Links






User Contributed Notesadd a note
No Comments yet for this page
add a note


Back to my homepage


Author: <webmaster@SteffenSiebert.de> Last Update: 2009/04/21 21:31:49
URL: http://www.SteffenSiebert.de/soft/python/wintec_tools.html