UMP: getting started

Revision 021013, for GPSmapper version 00452

By Snay, based on valuable input and ideas from gps_mapper, Jac<J.M>, Snake, and others.

Keywords: GPS Garmin own homebrew map load upload loadable uploadable UMP

CONTENTS

1. Introduction

2. Requirements

3. Setup

4. The simplest map

5. Maps with multiple objects of various types

 

1. INTRODUCTION

This Getting Started will enable you to make your own maps (or just simple sketches of any area) and upload them to your Garmin’s GPS receiver.

From the technical point of view, this has been possible for some time already thanks to the GPSmapper project (http://gps.chrisb.org/gps_mapper.htm). Unfortunately, the method has not been easily comprehensible due to the lack of simple and clear documentation. Some published descriptions and HOW-TOs only added to confusion by suggesting that it would be necessary to poke in the Windows Registry, install the Perl and Java environment, etc.

However, big progress has been made recently thanks to a group of enthusiasts from Poland who started an initiative under the name of UMP, the purpose of which is to enable everybody to create maps in the GPS-uploadable format and share them with others, free of charge. It is an open project supporting everybody who wants to make a map or just a quick sketch of any area, for private purposes.

In order to facilitate this, significant improvements have been made to the GPSmapper project in terms of accessibility and understandability of the documentation. Also, new program features are expected in the future.

Although I’m not involved in the GPSmapper or UMP project development, I decided to write this Getting Started which explains, in easy terms, how to make maps and upload them to a GPS receiver using only general-purpose software (such as a text editor) and the GPSmapper freeware.

 

2. REQUIREMENTS

You will need:

 

3. SETUP

This is the most difficult part, but it has to be done only once, so just go ahead and follow these steps:

1. Create the new directory C:\Program Files\GPSmapper

This directory will be referred to as the program directory.

2. In it, create the new directory C:\Program Files\GPSmapper\MyData

This directory will be referred to as the data directory.

(If you decide to use other names for the program and data directories, you will have to change accordingly the paths in two shortcuts installed in points 6 and 7).

3. Download the free software package:

(a) go to http://gps.chrisb.org/gps_mapper.htm;

(b) in the DOWNLOAD section, click INSTALLATION WITH RUNTIME (the latest version), download the zip file and unzip it to the program directory;

c) from the program directory, run SETUP.EXE; when prompted for the directory name, enter C:\Program Files\GPSmapper (or your other program directory).

4. Create the new folder GPSmapper on your Desktop (or wherever you want). This folder will be referred to as your working folder.

5. In the working folder, create a shortcut to the GPSmapper.exe program installed in the program directory.

6. Also in the working folder, create a shortcut to the cGPSmapper.exe program installed in the program directory. In the shortcut properties dialog:

a) change the starting directory to your data directory (e.g. C:\Program Files\GPSmapper\MyData);

b) edit the shortcut target by adding the string ac -p at the end, so it reads as follows (provided you have the default program directory):

"C:\Program Files\GPSmapper\cGPSmapper.exe" ac -p

7. Again in the working folder, create a shortcut to the Sendmap.exe program installed in the program directory. In the shortcut properties dialog:

a) change the starting directory to your data directory;

b) edit the shortcut target by adding the string COM1 -p at the end, so it reads as follows (provided you have the default program directory):

"C:\Program Files\GPSmapper\Sendmap.exe" COM1 -p

(if for communication with your GPS receiver you use a port other than COM1, replace COM1 with (e.g.) COM2).

Ouffff, that's it. We've done the most difficult part. Now the fun begins.

 

4. THE SIMPLEST MAP

Now you will make your first, very simple map consisting of one road and one point object (a campground) near it.

1. Create a new file (say, My1stMap.txt) in your data directory (you remember, by default this is C:\Program Files\GPSmapper\MyData) and copy to it the following lines:

[IMG ID]
ID=########
Name=$$$$$$$$
Datum=W84
TreSize=2048
RgnLimit=500
Levels=5
Level0=22
Level1=21
Level2=19
Level3=17
Level4=15
Zoom0=0
Zoom1=1
Zoom2=2
Zoom3=3
Zoom4=4
[END-IMG ID]

[RGN20]
Type=0x48
Label=$$$
Levels=1
Data0=(##.####,##.####)
[END-RGN20]

[RGN40]
Type=0x04
Label=$$$$
DirIndicator=0
Levels=1
Data0=(##.####,##.####),(##.####,##.####),(##.####,##.####)
[END-RGN40]

2. In the ID=######## line, replace ######## with a file name of your choice, e.g. ID=map00001 (your resulting map file will then be map00001.img).

3. In the Name=$$$$$$$$ line, replace $$$$$$$$ with the title of your map, to be displayed in your receiver's map menu (e.g. Name=My First Map).

4. In the [RGN20]...[END-RGN20] section, in the Label=$$$ line, replace $$$ with the label (name) of the campground object, as you want it to appear on your map (e.g. Label=Old Witch Camp).

5. In the DATA0=... line, replace each ##.#### with actual coordinates (lat, lon) of the object, in the dd.dddd format (e.g. DATA0=(52.1893,-102.0898). Use negative numbers for W and S coordinates, positive numbers for E and N (you might wish to select a place somewhere near you).

6. Repeat steps 4 and 5 for the [RGN40]...[END-RGN40] section, e.g. Label=Sycamore Road. Keep the road vertex coordinates near the campground object (say, within 0.01 degree) to see all your objects one near another on your first map. You may increase the number of vertices (coordinate pairs) if you wish.

7. Close the My1stMap.txt file, then drag and drop its icon onto the cGPSmapper program shortcut. If everything is O.K., you will see some messages scrolling on the black screen, ending with "Done! File map00001.img is written. Press SPACE to finish". The map00001.img file appears in your data directory.

8. To preview your map, double-click the GPSmapper program shortcut and open the map00001.img file (File menu> Import file > From IMG). You should see your map on the screen. Also, you will see a rectangular border around the objects which defines the map region. To have the labels visible, click on the LBL button. Use the Zoom tool ("5 km" etc.) as necessary. (BTW, the program you are using now is essentially a map editor, but for this simplified project we use it only to preview the maps.)

9. If you are satisfied with your map, upload it to your Garmin unit. Connect the receiver to the computer, switch it on, then drag and drop the resulting .IMG file icon onto the Sendmap program shortcut.

10. In the receiver, pan the map screen to the place where your objects are. If you zoom in closely enough, at certain moment the existing (base) map will be suddenly replaced with your new map! Later you will learn how to control the zoom level at which your objects are visible. You may switch your map on and off from the receiver's map menu.

Congratulations! You have your own map in your receiver!

 

5. MAPS WITH MULTIPLE OBJECTS OF VARIOUS TYPES

After you have made your first, very simple map, you've got everything necessary to make a more sophisticated and usable map. This second map will contain POIs (points of interest), more various point and linear objects, as well as area objects.

1. In the program directory find the RGNtype.txt file and create a shortcut to it in your working folder (where you have your other shortcuts). This file contains a table of available object types and their codes which determine their appearance on your map.

2. Create a new file (say, My2ndMap.txt) in your data directory and copy to it the following lines:

[IMG ID]
ID=########
Name=$$$$$$$$
Datum=W84
TreSize=2048
RgnLimit=500
Levels=5
Level0=22
Level1=21
Level2=19
Level3=17
Level4=15
Zoom0=0
Zoom1=1
Zoom2=2
Zoom3=3
Zoom4=4
[END-IMG ID]

[RGN10]
Type=####
Label=$$$
Levels=1
Data0=(##.####,##.####)
[END-RGN10]

[RGN20]
Type=####
Label=$$$
Levels=1
Data0=(##.####,##.####)
[END-RGN10]

[RGN40]
Type=####
Label=$$$$
DirIndicator=0
Levels=1
Data0=(##.####,##.####),(##.####,##.####),(##.####,##.####)
[END-RGN40]

[RGN80]
Type=####
Label=$$$$
Levels=1
Data0=(##.####,##.####),(##.####,##.####),(##.####,##.####),(##.####,##.####)
[END-RGN80]

3. Prepare the [IMG ID]...[END-IMG ID] section as explained above for the first map, e.g. ID=map00002, Name=My Second Map.

4. Duplicate the [RGN10]...[END-RGN10] section to get as many sections as you want -- each such section will correspond to one POI on your map, such as a bank or a restaurant.

5. Similarly, duplicate the [RGN20]...[END-RGN20] section -- each such section will correspond to one point object (such as a campground or marina) not being a POI.

6. Again, duplicate the [RGN40]...[END-RGN40] section -- each such section will correspond to one linear object, such as a road or stream.

7. Finally, duplicate the [RGN80]...[END-RGN80] section -- each such section will correspond to one area object (such as a lake or forest).

8. In each of the resulting sections (make perhaps in total a dozen or so of them), in the Type=#### field, replace #### with a hex number corresponding to the object type (icon) as you want it to appear on your map, e.g. Type=0x2f06 for a bank, Type=0x43 for a marina, Type=0x0a for an unpaved road, Type=0x3c for a lake.

For the list of available object types, see the RGNtype.txt file mentioned above. Observe the value in the last column (0x10, 0x20, 0x40, or 0x80). It is called RgnType. The RgnType value must correspond to the header (RGN10, RGN20, RGN240, or RGN80) of the given object section, e.g. for an RGN20 object (point), only types listed with RgnType=0x20 are allowed.

For example, in the RGNtype.txt file, the row:

Marina 0x43 67 0x20

means that the Marina object should be defined as Type=0x43 and it may be defined in the [RGN20]...[END-RGN20] section only.

9. Also in each of the resulting sections:

(a) in each Label=$$$ field, replace $$$ with a label of the object (e.g. Label=Green Eye Lake), as you did before in the first map;

(b) in each DATA0=... field, replace ##.#### with actual coordinates as before (you may decrease or increase the number of vertices for linear and area objects, within the limit of 255 coordinate pairs). Keep the objects near each other. You will see your objects only if you zoom in sufficiently close in the receiver.

10. Compile, preview, and upload your map00002.img file as you did with your first map.

 

Revision history

2002-10-05 -- first published on the sci.geo.satellite-nav and alt.satellite.gps newsgroups as a series of articles.

Rev. 021005 -- the newsgroup articles put together into one document.

Rev. 021006 -- proofreading corrections.

Rev. 021013 -- modified to reflect GPSmapper v. 00452