

       ************************************ Road Dog V2c By Art *************************************
       ******************** For Sony Playstation Portable (Firmware Version 1.50) *******************

Hi Guys,
Road Dog is a WiFi connection sniffer that will allow users to easily locate hotspots while driving,
without becoming distracted. The main difference between this, and similar programs for the PSP is
the implementation of sound and speech. This allows you to hear indications through your car stereo,
or through earphones while out on the street so you can leave the PSP in your pocket.


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


The Road Dog 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 conservation 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."

In addition to the above agreement, grant of Lisence to use the Road Dog program, also requires
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 do so.

DISCLAIMER:

Road Dog is not designed to allow theft of bandwidth or internet services, or to facillitate hacking of
private networks. Usage in this way is probably illegal, and the user engages in such activity at their
own risk. I disclaim responsibility for any such use. Lecture over!


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


To Install the Road Dog program, copy the program folders to the PSP/GAME or PSP GAME150 folder of your PSP.
Now you should be able to launch the program from the Game menu. Road Dog is tested with a 3.03 SE firmware
PSP unit, but may work with other 1.50 kernal firmwares as well. It will not work with the PSP slim & lite.


       ************************* Road Dog Network Profile Auto Update Feature ************************


The profile auto update feature updates a PSP network profile for later use in the PSP Browser or other
PSP networking program that uses one of the preset networking profiles.

The profile must be prepared manualy. To do this, Navigate in your XMB menu to:
Settings, Network Settings, Infrastructure Mode, click on Infrastructure Mode,
and create a new connection profile by pressing [New Connection].
Now select Enter Manually, then enter any SSID (or none at all),
Select None for the WLAN Security Setting, Easy Address Settings.
The Name for this profile must be "Road Dog" (no inverted commas and case sensitive).
Save this connection profile, and it's ready to be auto updated by Road Dog.

If your PSP has had more connection profiles that have been deleted,
your registry may skip the connection profile ID numbers of the deleted connections.
This will currently crash Road Dog.
Restoring your PSP registry with (Restore Default Settings) in your XMB menu will fix this issue.
Continue to set up the Road Dog connection profile first,
and it will not be a problem if you delete any connections that were created after it.

Now your connection is set up, start the program and see network details on the screen as always.
Now when you press the CROSS button, the next unsecured network that is detected with at least
30% signal quality will be written to the Road Dog PSP network connection profile..

Road Dog will auto exit when this happens so you can go straight into the PSP Internet Browser,
and try the connection. You can also check the new SSID was written in your Network Settings.

The program will display an error message if some part of your network configuration was not done properly.
A list of all possible Road Dog Network Configuration errors follows:

BAD NETWORK CONFIG [E1] : auth_proto
BAD NETWORK CONFIG [E2] : how_to_set_ip
BAD NETWORK CONFIG [E3] : dns_flag
BAD NETWORK CONFIG [E4] : ip_address
BAD NETWORK CONFIG [E5] : netmask
BAD NETWORK CONFIG [E6] : default_route
BAD NETWORK CONFIG [E7] : primary_dns
BAD NETWORK CONFIG [E8] : secondary_dns
BAD NETWORK CONFIG [E9] : wpa_key_type
BAD NETWORK CONFIG [EA] : http_proxy_flag
BAD NETWORK CONFIG [EB] : auth_8021x_type


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


Road Dog was partly written in a tent in the bush! Particularly routines that search and check network profiles
with Skylark's PSP registry tools. The program has also been partly written using a laptop, and solar power!
A long way from being the program to be written entirely on solar power, but hey, I broke a solar controller
on the main trip to write a planned feature of this program, it was hot, and I didn't get much done,
but the photo in the beginning intro background was shot on the way there!

Check out the Road Dog Page on my website: http://www.freewebs.com/defxev/RoadDog.htm

See an early Road Dog version tested on YouTube here:
http://au.youtube.com/watch?v=9YQ0b7LwhGc

See one of the first graphing versions tested here:
http://au.youtube.com/watch?v=VVtLgRZfIyk

See the early Network Profile Auto Updater here:
http://au.youtube.com/watch?v=R0S6tRmo1cc

Now cough up those 32 Mb Memory Sticks! Contact me if you have any low capacity Memory Sticks to donate :)


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


*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.
I have particular need for low capacity Memory Sticks, even a 32 Mb one can be used for programming.
Contact me on the PSPU, Austech, or X-Flash forums.
Cheers, Art.
http://www.freewebs.com/defxev/
http://www.austech.info/forums/
(www.austech.info)


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


VERSION HISTORY:

V2c (29/12/07):
- Added configuration file parser by A_Noob. Now some options are user configurable.
- Fixed Space Invader Hit Sound problem. Works properly now.

V2b (28/12/07):
- Removed network profile error checking as a quick fix for 3.71 M33 firmware users.
- Added Space Invader hit sound for saving network profile, when the smiley face appears.

V2 (22/12/07):
- Large size graph is set by default since six connections still fit on the screen.
- Made a correction so that all the PSP's LEDs function normaly once the program is exit.
- Added implementation of registry tools ported by Skylark to update a PSP network profile ready for browser.
- Added a small animated graphic indicator for when there has been no activity for a few minutes.

V1e (16/12/07):
- Rrogram exit will now reset the PSP if it was launched from within iRShell (rather than freezing).
- All LEDs are now turned off by the program.
- Implementation of signal graph that logs to the screen. You see the last 3 mins, 50 secs of activity.
- Basic familiar name search feature.

V1d (14/12/07):
- Fixed program exit so the HOME button is responsive. Program now also exits properly within iRshell.
- Signal strength is only spoken when it changes.  It won't keep repeating the same value.
- Added check for WLAN switch. error message is displayed, and program exit if WLAN is off, or fails.
- Auto screen brightness control implementation.
- PSP is clocked at 133/133/1, unless run from iRshell, in which case the clock speed isn't changed.

V1c (14/12/07):
- Added basic sound implementation for indication of unsecured wifi hotspots.
- Limited the size of network names that can be printed to the screen, so they don't overrun to other fields.

V1b (13/12/07):
- Demonstration Preliminary version using GU texture font shows connection info, and has multicoloured display.
- Program can be exited with HOME button.

V1 (12/12/07):
- Preliminary version using Intrafont library gave me graphics issues, so I chose to use another GU texture font.


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

