SCUBA Tools DiveCalc & DiveLogger for PalmOS VERSION 1.6 5-20-2004 by Ed Negari email: scubatools@narced.com PalmOS: http://scubatools.narced.com Zaurus: http://divecalc.narced.com Please see the COPYRIGHT and DISCLAIMER sections below! CONTENTS 1. Description 2. Installation 3. Usage 4. Copyright & Registration/Licensing 5. Disclaimer 1. DESCRIPTION -------------- I wrote SCUBA Tools for my Senior Project during my last 2 semesters at NJIT (New Jersey Institute of Technology). There are certainly better logging programs out on the 'Net than DiveLogger (search palmgear.com, freewarepalm.com, etc.) but I haven't found any programs that automate Dive Table calculations (although I'm sure they probably exist). DiveCalc is a Palm program that automates dive table calculations with a simple and familiar form-type interface. It was originally based on the NAUI Dive Tables, and now includes US Navy tables. More information on dive tables and scuba diving in general can be found at http://www.naui.com, and Google. Be **SURE** to read the DISCLAIMER section at the bottom of this README. DiveLogger is designed to let a diver record all details of his or her dive in their Palm. It has fields for details found in most logbooks, and the "diveDB" files it creates are automatically backed up during a HotSync. Please note that the "DiveMaster Signature" field under the "DiveOp" tab is currently non-functional. NOTE -- To access items in the main pull-down menu, you need to click on the pull-down silkscreen button (under "Home") first, and then click on the menu tab. This seems to be a slight bug with CControls that I haven't figured out how to fix yet. Send any ideas to the above email address! 2. INSTALLATION --------------- IMPORTANT!!! IMPORTANT!!! IMPORTANT!!! IMPORTANT!!! Delete previous versions of DiveCalc before installing 1.6! Weird things may happen otherwise! To install DiveCalc and/or DiveLogger, simply use the "Install Tool" that comes with the Palm Desktop software. The .zip file for Version 1.6 includes both the standalone and applet versions. In Windows, you can simply open the standalone or applet folder, double-click on the .prc file(s), and then HotSync. In Linux, do something like: "pilot-xfer -i DiveLogger-1.1-applet.prc DiveCalc-1.6-applet.prc" The source code for both programs can be found in the "source" folder found in this .zip archive. Note that if you want to compile DiveLogger, you need to compile "DiveList.c", not "DiveLogger.c". This is because DiveList.c handles the index and includes/calls DiveLogger.c - not vice-versa. (I wrote DiveLogger.c first and got it working, then wrote DiveList.c to display a list of saved dives and never renamed DiveLogger.) 3. USAGE -------- Both programs work like typical PalmOS-apps. Just tap their icons to start them up. DiveCalc creates a Palm database file (.pdb) to store your preference of Dive Table and of Feet or Meters, and the remaining databases store the values contained in the Dive Tables. They are created first time they are needed (usually the first time DiveCalc is run). You may notice a message "Creating DB..." in the top right corner as DiveCalc is "Calculating..." These databases get deleted automatically when DiveCalc is deleted. They can also be deleted automatically upon exiting DiveCalc by checking the box under the "Preferences" button. (Hint: get a program like "File Man" to see all of the files installed on your Palm.) There are 4 database files to store each of the Dive Tables. Why? The main structure of NAUI and US Navy dive tables are generally the same - only the layout is different. The first 2 are for "Table 1 - End of Dive Letter Group" and "Table 2 - Surface Interval Time (SIT) Table". The last 2 database files are for "Table 3 - Repetitive Dive Timetable" because this table includes 2 values in each cell. I created 2 separate tables to simplify the programming of the table-lookups. DiveLogger creates .pdb files only when dives are saved. These files are called "diveDBn" where n = the number of the dive. These files are saved in the Palm backup folder during HotSync. (An example path of where you can find these files would be "C:\Palm\JoeDiver\backup\diveDB3.pdb" .) DiveLogger's diveDB*.pdb files also get automatically deleted when DiveLogger is deleted. KEEP PRINTED BACKUPS! I pretty much wrote DiveLogger to "complete" the SCUBA Tools project, so as not to only have a Dive Calculator. As I've said before, you can probably find better logging software elsewhere. 4. COPYRIGHT & REGISTRATION/LICENSING ------------------------------------- This software is freeware. If you like it, great - use it, enjoy it, give it to your friends. This software is also open source and is copyrighted by me. Do whatever you want with it, just don't tell people you wrote it or make money off of it without giving me credit (money is nice too! ;-) . There is no "registration" for this software, but if you like it and intend to use it, send an email to scubatools@narced.com with some info about how/where you found SCUBA Tools, where in the world you live, and how you plan to use the software (I've gotten a few emails from actual NAUI instructors...). I also welcome all suggestions for new features for DiveCalc (I don't plan to continue working on DiveLogger). ---------------------------------- Copyright (C) 2001 Ed Negari This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. ---------------------------------- See the whole license at http://www.gnu.org/copyleft/gpl.html 5. DISCLAIMER ------------- SCUBA Diving is a potentially dangerous sport and safety should be taken VERY SERIOUSLY. The DiveCalc program is distributed for entertainment ("fun") purposes and is intended to only be an aid to a Diver who is already trained in the use of Dive Tables. The user is expected to double- and triple-check the output of DiveCalc against REAL DIVE TABLES to ensure accuracy. The program is accurate to the best of my knowledge, but there are probably bugs in it. I cannot be held responsible or liable in any way for what may happen to anyone else from using this program! Should there be an incident because of a bug in the program, incorrect usage, or misunderstanding, I am only liable for the amount that the user spent on the program - which is ZERO DOLLARS ($0.00), because this program is FREE. This software has NO WARRANTY! Please note the following (excerpted from http://www.gnu.org/copyleft/gpl.html) : ----- NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. ----- Basically, by using this software (DiveCalc and DiveLogger) in any way, you agree that I can't be held responsible or liable for anything that may happen as a result of its use.