;
;`-',
;.-.;""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""";, ,;
;`-';               AVEC V1                     /\    |\           For Sony Playstation Portable    ;`-';
;.-.;           Vector Mapping                 //\/''/''/        with Homebrew Compatible Firmware  ;.-.;
;`-';           GPS Map Viewer                //''||' ||            First Demo Release 11/08/09     ;`-';
;.-.;                                        |/   |/  |/2009!           Last Update 17/08/09        ;.-.;
;`-';                                                                                               ;`-'; ;"""'"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""'"""'


Hi Guys,
You read correctly, at last, a vector map viewer for the PSP is available!

This new program reads and displays MP (polish format) map files which are very common among the Garmin
custom mapping scene, and can make use of a GPS device connected to the PSP serial port to display your
current location on the map.


       **************************************** Disclaimer ******************************************


The AVEC program is provided for free, as it is, without warranty of any kind, either express or
implied, including, but not limited to, the implied warranties of fitness for a purpose.
Without limiting the foregoing, the author of this program makes no warranty that:

   1. the software will meet your requirements
   2. the software will be uninterrupted, or free of errors.
   3. any errors found in the program will be corrected.
   4. documentation provided with the program will be accurate, complete, or up to date.

Use of this program is at your own discretion and risk and with agreement that you are responsible for any
damages or loss of data that results from such activities.


       ********************************* Grant Of Software License **********************************


The AVEC Program is free to use, but I retain ownership of my software, and grant of license to use
it is under identical terms of GPS Trackmaker license agreement (reproduced in part with permission),
that pertain to preservation of protected ecosystems. View the entire agreement for GPS Trackmaker:
http://www.gpstm.com/downloadscontract.php

"LICENSE GRANT

The author grants a non-exclusive license to use the program, free of charge, if the user:
Does not use the program for illegal purposes;
does not practice activities that destroy or degrades the environment;
does not practice polluting activities;
does not throw trash on the ground or through the car’s windows;
when going to the beach and creeks takes his trash back until finding a trash collector;
does not practice any activities that hurts animals, like hunting, out-of-season fishing, pigeon shooting,
dog fight, etc.;
does not buy wild animals that, by law, may not be created out of their natural environment;
has ecological conscience and protects nature.
People that for any reason do not fit the conditions above, are expressly forbidden to use the program."

License to use any version of the AVEC program also require adhesion to the following terms:

When the user visits a Beach or other body of water, National Park or other protected environment,
he or she leaves no damage to live vegetation, leaves no unnatural polluting material, or litter,
and removes non-combustible material from fireplaces, or litter that may have been left by other people
if it is reasonable to store and carry it with your own rubbish.


The following notice is provided as a condition of using "NMEAP", a C NMEA sentence parser for programmers
using serial GPS devices in their applications. NMEAP can be found here: http://dmh2000.com/nmea/nmeap.shtml

Copyright (c) 2005, Daveh. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that
the following conditions are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    * The name of its contributors may not be used to endorse or promote products
      derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY DAVEH "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL <copyright holder> BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


       *************************************** Installation ******************************************


To Install the AVEC program, copy the program folder to the homebrew game folder of your PSP.
This could be the PSP/GAME150 folder for newer firmware, or PSP/GAME folder for original 1.50 firmware.

AVEC is tested with a 3.52 M33 firmware PSP unit. This is the last true 1.50 kernel hybrid firmware.
the program is known to work with other firmwares as well, but I have not personally tested these.
AVEC GPS is a 1.50 kernel mode program, and therefore, requires a 1.50 kernel compatible PSP unit.

The program should also work with original 1.50 firmware as long as the program folder is kxploited,
but again, I have not tested this for myself. AVEC clocks the PSP at 333 MHz for maximum speed.

When a map is loaded, the starting position is at the upper right most point of interest.
There will be problems if the map contains no points of interest unless you have a GPS device connected.
The map is initialy displayed at the highest preview zoom level where wire polygons are displayed.
Zooming in any closer will reveal map detail.
Wire polygons are only shown in preview zoom levels, and points of interest are only shown at high zoom.
In GPS mode, only lines are drawn. you can temporarily disable GPS mode to display points of interest.



       ****************************** Serial GPS Device Connection ***********************************


Just about any serial GPS device can be used with this program. The NMEA parser that handles GPS communication
has been tested with a Garmin 60CSx. Any serial GPS setup that works with the MapThis! PSP application should
also work with AVEC, since they use the same NMEA parser routines. The serial speed must be set to 4800 baud.


       ****************************************** Usage **********************************************


At program startup, you will see an intro screen which shows the functions of most buttons.

In addition, you can press the square button to display a magnifier wndow, and using the analogue joystick
while holding down the Cross button will let you drag the map.

Maps should not be too large, since the program drawing speed is still very slow. One city at a time should
work at a useable speed.

The Triangle button toggles the GPS mode. The PSP's green power LED will only be lit while GPS mode is active.

While in viewer mode you can use the analogue joystick to point at a street, and it's name will be displayed.
In GPS mode, the current street name at your location will be displayed if it is touching the crosshair.

The Home button exits the application.


       ******************************************* Maps **********************************************

Free Garmin compatible maps are fortunately very common on the internet. It is also very fortunate that
most of them are easily converted to Polish format for use with this program.

You can use Garmin City Navigator or Metroguide maps if you own such a Map product.
Just open a Garmin IMG file with the free version of GPS Mapedit: http://www.geopainting.com/en/
save the map file in Polish format, and you're good to go. Garmin NT products are not supported
by Mapedit, and therefore, cannot be converted to Polish format by any known means.
Polish format maps produced from Garmin map files do not need to be unlocked for use with AVEC.

There is a limitation on map size which is roughly 12 Mb, and more detailed maps will take longer to draw.
You can easily cut a part out of a map with the trim tool in Mapedit. One city at a time is recommended.

Free OSM Australian Street Maps:
http://users.tpg.com.au/users/stevez/OSM/download.html

Free Australian Topographic and Street Maps:
http://www.gpsoz.com.au/tracks4australia/

Free Worldwide maps:
http://gpsmapsearch.com/

Free US Topo Maps:
http://www.gpsfiledepot.com/maps/state/all


       ***************************************** Donations ********************************************


*Donations*
License to use this program will remain free, but I am accepting donations toward new hardware and development.
You can encourage future program and/or hardware development by sending a donation. Contact me on the PSPU,
Austech, or these other listed forums. My user name is Art on all of them, or click the donation link on any of
my project web pages.

I have valuable use for low capacity Memory Sticks for use while programming. If you like this program,
please consider donating the 32Mb Memory Stick that came with your PSP once you have upgraded,
or perhaps the low capacity Memory Stick that comes with some Sony Ericsson mobile phones.
I also have use for any broken PSP hardware or Canon digital camera hardware.

Thanks goes out to Jason & Jared, a Father & Son team from QJnet forums for being the first to donate a pair
of Memory Sticks! It's much appreciated! :) Keep up the green electronics projects! Thanks also to MjW,
Moose Island, and lifey for their kind donations of PSP Memory Sticks.
Cheers, Art.

http://forums.ps2dev.org/viewforum.php?f=14
http://forums.qj.net/f-qjnet-sony-psp-forums-48.html/
http://www.dcemu.co.uk/vbulletin/index.php
http://www.psp-programming.com/forums/
http://www.psphacking101.com/forum/index.php?c=1
http://www.freewebs.com/defxev/


       ************************************ Program History Log ***************************************

VERSION HISTORY:

AVEC V1 (18/08/09) :
- GPS support implemented through serial port.
- Implemented experimental wire polygon support.
- Implemented file browser for map file selection.
- Improved map file parser to work with maps of any location.
- Decimal degree labels now displayed on map grid.
- Implemented point and click map navigation method.
- Implemented feature to lookup names when the pointer is placed over a street or trail.
- Implemented a magnifier window that follows the cursor position around the screen.

AVEC Demo (11/08/09):
- Basic map viewer for demonstration.



       ************************************************************************************************


