+
+[[S_HowFindDeviceName]]
+How to find the Device Name
+---------------------------
+
+When you connect your divecomputer by using an USB connector, most of the
+time, the default of '/dev/ttyUSB0' should work. But if you have other
+Serial to USB devices, this can be different because '/dev/ttyUSB0' is
+already in use.
+
+One of the ways to find out what your dive name is:
+
+ - Disconnect your usb cable of your dive computer
+ - Open a terminal
+ - Type the command: 'dmesg' and press enter
+ - Plug in your usb cable of your divecomputer
+ - Type the command: 'dmesg' and press enter
+
+Within your terminal you should see a message similair to this one:
+
+ usb 2-1.1: new full speed USB device number 14 using ehci_hcd
+ usbcore: registered new interface driver usbserial
+ USB Serial support registered for generic
+ usbcore: registered new interface driver usbserial_generic
+ usbserial: USB Serial Driver core
+ USB Serial support registered for FTDI USB Serial Device
+ ftdi_sio 2-1.1:1.0: FTDI USB Serial Device converter detected
+ usb 2-1.1: Detected FT232BM
+ usb 2-1.1: Number of endpoints 2
+ usb 2-1.1: Endpoint 1 MaxPacketSize 64
+ usb 2-1.1: Endpoint 2 MaxPacketSize 64
+ usb 2-1.1: Setting MaxPacketSize 64
+ usb 2-1.1: FTDI USB Serial Device converter now attached to ttyUSB3
+ usbcore: registered new interface driver ftdi_sio
+ ftdi_sio: v1.6.0:USB FTDI Serial Converters Driver
+
+You see that in the third line from the bottom, the usb adapter is
+detected and is connected to 'ttyUSB3'. Now you use this information in
+the import settings as '/dev/ttyUSB3'. Your divecomputer interface is
+connected and you should be able to import your dives.
+
+[[S_ImportingDivesJDivelog]]
+Importing dives from JDivelog
+-----------------------------
+
+Maybe you have been using JDivelog and you have a lot of dives logged in
+this program. You don't have to type all information by hand into
+Subsurface, because you can import your divelogs from JDivelog.
+
+JDivelog stores its information into files with the extension of .jlb.
+These .jlb contain all the information that has been stored, except your
+images in xml format.
+
+By using the menu 'File - Import' you get the popup, like described in
+<<S_ImportNewDives, chapter 4>>, Importing new dives. Within this
+popup there is the option to import existing files which are already
+on your computer. To import your JDivelog file(s) do the following:
+
+ - Open 'File - Import' on the menu
+ - Use the file locator under XML file name
+ - Browse your directories to the location where your *.jlb file is
+ - Select your existing *.jlb file and click 'open'
+ - Click the OK button in the popup
+
+After a few moments, you see your existing logs in Subsurface. Now you can
+edit your dives like explained in <<S_EditDiveInfo, chapter 6>>.
+
+Information that is imported from JDivelog into the location field:
+
+ - Extended dive location information
+
+Information that is merged into the location or notes field:
+
+ - Used amount of weight
+ - Used type of suit
+ - Used type of gloves
+ - Type of dive
+ - Dive activity
+
+Alternatively, you can start subsurface with the --import command line
+which will have the same effect:
+
+ subsurface MyDives.xml --import JDivelogDives.jlb
+
+will open your divelog (assuming that's called MyDives.xml) and then
+import the dives from JdivelogDives.jlb. You can now save the combined
+divelog back as MyDives.xml.
+
+Subsurface will similarly import xml exports from DivingLog as well as
+Suunto DiveManager.
+
+When importing dives subsurface tries to detect multiple records for
+the same dive and merges the information as best as it can. So as long
+as there are no time zone issues (or other reasons that would cause the
+beginning time of the dives to be substantially different) subsurface
+will not create duplicate entries.
+
+[[S_ImportingDivesSuunto]]
+Importing dives from Suunto Divemanager 3.*
+-------------------------------------------
+
+Before you can start importing dives from Suunto Divemanager, you first
+have to export the dives you want to import. Subsurface does not import
+directly from the Suunto Divemanager log files. The following procedures
+unpacking instructions for Linux and Windows.
+
+Export from Suunto Divemanager
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ - Start Suunto Divemanager and login with the name containing the logs
+ - Do not start the import wizard to import dives from your computer.
+ - In the navigation tree on the left side of the program-window, select your dives.
+ - Within the list of dives, select the dives you would like to import later:
+ * To select certain dives: hold ctrl and point & click the dive
+ * To select all dives: Select the first dive, hold down shift and select the last dive
+ - With the dives marked, use the program menu 'File - Export'
+ - The export popup will show
+ - Within this popup, there is one field called Export Path.
+ * Click the button browse next to the field Export Path
+ ** A file-manager like window pops up
+ ** Navigate to the directory where you want to store the Divelog.SDE file
+ ** Optional change the name of the file you want to save
+ ** Click 'Save'
+ * You are back in the Export popup. Press the button 'Export'
+ - Your dives are now exported to the file Divelogs.SDE.
+
+Unpacking the Divelogs.SDE on Windows
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Renaming your file to a .zip:
+
+ - Use the filemanager (explorer) and navigate to your Divelogs.SDE file
+ - Right click on the Divelogs.SDE file and choose 'Rename'
+ * Change the name into Divelogs.SDE.zip
+ * Press enter when done. A warning popup shows:
+
+ The file could be unusable when changing the extension. Are you sure:
+ Press OK.
+
+ * Your filemanager will show now the filename Divelogs.SDE.zip
+
+When you double click your Divelogs.SDE.zip file, your preferred archiving
+tool will start and show you the list of xml files that are in the zip
+archive. Select all the xml files and extract them to a place where you
+can find them later in the process.
+
+Unpacking the Divelogs.SDE on Linux
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The assumption is that you have exported your Divelogs.SDE on a Windows
+system. You have to transfer the file to a location where you can read it
+from within your Linux environment. You can use file-transfer, shared
+storage or an USB storage device to do this.
+The example uses an USB storage:
+
+ - Insert your USB storage into your Windows computer
+ - Use the filemanager (explorer) to navigate to the location where your Divelogs.SDE file is located
+ - Copy the file to your USB storage:
+ * Select the file by 1 click
+ * Press Ctrl+c
+ * Navigate to your USB Storage
+ * Press Ctrl+v
+ - Disconnect your USB storage by right clicking your USB storage in the explorer and choose Eject
+ - Insert your USB storage into your Linux computer
+ - Use your favourite filemanager to navigate to your USB storage
+ - Copy the file to /tmp by:
+ * Right click on the file
+ * select copy
+ * navigate to /tmp
+ * press Ctrl+v or use the menu 'Edit - Paste'
+ - The file is now transfered to /tmp
+
+Now the file is in /tmp, we can extract the xml files from it. You can do
+this by hand, or use the example script in <<AppendixB,Appendix B>>.
+
+To extract the xml files, we need to open a terminal and use the following
+commands:
+
+ cd /tmp
+ mkdir suunto
+ cd suunto
+ unzip ../Divelogs.SDE
+
+Your divelogs have now been extracted from the Divelogs.SDE file and you
+can import them with the command:
+
+ subsurface *.xml
+
+And with the menu 'File - Save' you can save your dives into the
+Subsurface format.
+
+[[S_Menu]]
+The menu and sub-menus
+----------------------
+
+Within Subsurface, there are several menu and sub-menu options. All of
+those will be described here with their function.
+
+The file menu
+~~~~~~~~~~~~~
+
+The file menu is used for the following menu options:
+
+ - Open:: Open your saved Subsurface xml file(s)
+ - Save:: Save your current divelogs or changes you made to your divelogs
+ - Print:: Print your current divelog profiles and information about the dive
+ - Import:: Import your dives from your divecomputer, JDivelogs or Suunto Divemanager
+ - Preferences:: Set your preferences as described in <<S_SettingUpPreferences,chapter 10>>
+ - Quit:: Quit the program
+
+The Log menu
+~~~~~~~~~~~~
+
+Within the Log menu, there are only 2 sub-items:
+
+ - Renumber:: This option provides you with a popup. Within this
+ popup you can choose what the first number of your dives should be
+ for this set of dives.
+ - View:: This is a submenu containing:
+ * List:: Show only the list of dives you have made
+ * Profile:: Show only the dive profile of the selected dive
+ * Info:: Show only the 3 tab information screen
+ * Three:: Show the 'default' 3 screen setup
+
+The Filter menu
+~~~~~~~~~~~~~~~
+
+This menu gives you the choice to enable or disable Events for the
+selected divelog(s). At this time, you can enable or disable ascent.
+When you enable ascent for your dives, within the dive profile, a yellow
+marker with exclamation sign (!) will show on the points where you have
+ascented.
+
+The Help menu
+~~~~~~~~~~~~~
+
+The Help menu shows only the About, which contains the version and author
+information and License button.
+
+
+[[AppendixA]]
+Appendix A: Supported Dive Computers
+------------------------------------
+
+The use of libdivecomputer provides the support for divecomputers. Within
+the list of computers in the 'File - import' menu, you will see a listing
+of divecomputers. This list is covering a compatible set. Please check
+your users manual to check if your computer will be supported.
+
+ Supported divecomputers::
+
+ Atomics::
+ Cobalt
+
+ Cressi::
+ Edi
+
+ Mares::
+ Icon HD
+ Nemo
+ Puck
+ Air
+
+ Oceanic::
+ Veo250
+ VT Pro
+
+ OSTC::
+ DR5
+ 2N
+
+ Reefnet::
+ Sensus
+ Sensus Pro
+ Sensus Ultra
+
+ Suunto::
+ Cobra
+ 2
+ 3
+ D3
+ D9
+ D4
+ D4i
+ D6
+ D6i
+ D9tx
+ Eon
+ Gekko
+ HelO2
+ Mosquito
+ Solution
+ Alpha
+ Nitrox/Vario
+ Stinger
+ Vyper
+ 2
+ Air
+ Vytec
+ DS
+ Zoop
+
+ Uwatec::
+ Aladin
+ Memo Mouse
+ Smart
+
+ Zeagle::
+ N2iTiON 3
+
+* OSTC computers are listed in the pull-down menu as OSTC. All 3 types are supported.
+
+
+[[AppendixB]]
+Appendix B: Suunto Export Unpacking Script
+------------------------------------------
+
+ #!/bin/bash
+ #
+ # Small basic example script to unpack Suunto Export files
+ # for the use with Subsurface
+ #
+
+ echo -n "Enter the directory where you stored your Suunto Divemanager export file: "
+ read SuuntoExportDir
+
+ echo -n "Enter the name of your Suunto Divemanager export file: "
+ read SuuntoExportFile
+
+ echo "You have entered: $SuuntoExportDir/$SuuntoExportFile"
+
+ cd $SuuntoExportDir
+
+ if [ -e ./$SuuntoExportFile ]; then
+ mkdir SuuntoXML
+ cd SuuntoXML
+ unzip ../$SuuntoExportFile
+ subsurface *.xml
+ else
+ echo "Nothing found! Try again!"
+ fi
projects / ext / subsurface.git / blobdiff