Copilot Release Notes ===================== Greg Hewgill (greg@hewgill.com) Copilot Home Page: http://www.hewgill.com/pilot/copilot/index.html ------------------------------------------------------------------------------ Known problems in the current release ------------------------------------------------------------------------------ - The Pilot sound is only accurately emulated under Windows NT. - The alarm functions are not completely emulated. - Problems with the PalmPilot 1 MB ROM, see below. ------------------------------------------------------------------------------ 6/10/97 Version 1.0 beta 9 ------------------------------------------------------------------------------ - This release now supports the 1 MB PalmPilot ROM (either Personal or Professional versions). However, it only just "works", there are some known problems: - Some kind of timing problem prevents the pen "up" action from taking effect right away. Clicks on things like application selections will take longer to happen than you might expect. - The debugger is broken with anything other than the original English Pilot 1.0 ROM file. I have disabled the Debugger selection on the menu because of this (you can still make the debugger activate itself with any one of the many questionable coding practices listed below involving memory). The reason it's broken is it relies on absolute patch addresses to hook actions like application loading. Of course these addresses have changed. - Fixed a problem with certain .prc files sans symbols crashing the debugger. - Will now complain if the user attempts to load an application while the emulator is turned off. - Added a switch to enable and disable Copilot sounds. This option is initially OFF under Windows 95 because 95 does not properly support the Win32 Beep() API function used by Copilot to generate a tone at a specific frequency and duration. - Copilot will now break into the debugger on the following memory errors: - Any word or long read or write on an odd address. - Any size write to Storage RAM when it is write protected. - Any size write to ROM (0x10c00000-0x10cfffff). - Any size read or write to an address outside the range: 0x00000000-0x0000ffff, 0x10000000-(top of RAM), 0x10c00000-0x10cfffff Exception: word access in the range 0x10000000-0x10ffffff are permitted (PalmOS probes memory to find out how much is installed). When the debugger is activated due to one of these traps, you may choose to continue execution and the emulator will ignore the trap. ------------------------------------------------------------------------------ 10/27/96 Version 1.0 beta 8 ------------------------------------------------------------------------------ The method used to load applications into Copilot is now much more robust. Certain PRC files used to crash Copilot, and others were too large to load using the old method. The new method loads these PRC files with no problem. The default mask in the Load App dialog now includes *.pdb for loading Pilot database files. ------------------------------------------------------------------------------ 10/20/96 Version 1.0 beta 7a ------------------------------------------------------------------------------ Oops, in changing the SndDoCmd API emulation, I had accidentally disabled the sound completely. Fixed now. Also fixed some notes in the Copilot source guide. ------------------------------------------------------------------------------ 10/20/96 Version 1.0 beta 7 ------------------------------------------------------------------------------ Copilot now has an icon! Thanks to Alan Chavis for his contribution. Thanks also to the rest of you out there who sent me icons - if I ever get tired of this one there are lots of other good ones to choose from. :) The source code for Copilot is now available on the Copilot Home Page for people who are interested in porting Copilot to other platforms. Wes Cherry's AlarmHack now runs properly and doesn't crash Copilot. Copilot now emulates the SndDoCmd API function only if the cmd parameter is 1. It used to emulate it in all cases without regard for the cmd parameter. ------------------------------------------------------------------------------ 10/6/96 Version 1.0 beta 6 ------------------------------------------------------------------------------ Loading applications into Copilot is now much easier! There is a new menu selection that will allow you to easily load applications into Copilot without going through a full HotSync operation. See section 2.4 "Loading Applications" in copilot.htm for more information. ------------------------------------------------------------------------------ 9/29/96 Version 1.0 beta 5 ------------------------------------------------------------------------------ Fixed three bugs in this release: - HotSync under Windows 95 was not working. Fixed. - Copilot on a 256 color display looked really bad because the palette was not being set up properly. Fixed. - Under Windows 95, using the Zoom 2x display option resulted in a black Pilot display area. Fixed. ------------------------------------------------------------------------------ 9/23/96 Version 1.0 beta 4 ------------------------------------------------------------------------------ Copilot now emulates the HotSync button on the Pilot cradle, it is accessed through the right click menu. The right click menu is also available using the F10 key. This will allow people who have two serial ports and a serial mouse to use Copilot - it was a catch-22 before because you needed the mouse to start HotSync, but the mouse was taking a comm port you needed! This will have to do until I can write a software-only QuickSync for loading apps. You will notice that the debugger has changed significantly, Darrin Massena has been hard at work improving the debugger. The debugger.hlp file is a text file that explains the commands. Commands with a * beside them have not been implemented yet. This is still a work in progress, so things may not seem exactly right all the time. ------------------------------------------------------------------------------ 9/22/96 Version 1.0 beta 3 ------------------------------------------------------------------------------ Copilot now includes a GetRom program that will help in transferring the Pilot ROM from your Pilot to your PC. For instructions on how to use GetRom, see "How To Get a Pilot.ROM file" in copilot.htm. NOTICE: Use of the GetRom program may place you in violation of your license agreement with US Robotics. Please read page 123 of your Pilot handbook ("Software License Agreement") before running GetRom. The debugger will now automatically start when the CPU encounters a breakpoint instruction (opcode 0x4AFC). ------------------------------------------------------------------------------ 9/17/96 Version 1.0 beta 2 (documentation update only) ------------------------------------------------------------------------------ Some people were having trouble using PilotHack to transfer the ROM file to their PC. The problem was that if you followed my directions to turn off all the HotSyncing features, the ROMDump.PRC file was never transferred! I have corrected the documentation to give you the right instructions. In a nutshell, don't turn off the "System" HotSync action, leave it as "Pilot overwrites Desktop" (the default). ------------------------------------------------------------------------------ 9/16/96 Version 1.0 beta 2 ------------------------------------------------------------------------------ I forgot to include the makerom.exe program used to stitch together the individual PRC files generated by PilotHack's rom dump feature. This program has no error checking, so if the required files (romdump.0 through romdump.31) are not present it will cause an exception error. You can now choose the RAM size in the Properties page. Note that if you had a pilot.ram file from the previous version, you will need to rename it to pilot2048.ram in order to keep using it. Or, you can just ignore it and a new ram file will be created automatically. There is now a cpsample.zip file available on the Copilot Home Page. This contains a pilot1024.ram file with all the applications I could find loaded into it already. This will help if you don't have a proper null modem cable to hook up Copilot for HotSync. Be sure to unzip this file with WinZip or other 32-bit unzip to preserve the long file name. ------------------------------------------------------------------------------ 9/15/96 Version 1.0 beta 1 ------------------------------------------------------------------------------ This is the first beta test version of Copilot. If you have any comments on the program or documentation, please let me know at the email address at the top of this file. Note: In order to HotSync your ROM file with PilotHack, be sure you have version 1.01 of PilotHack. Version 1.0 contains a bug that causes problems with the 'x' command.