diff options
author | Willem Ferguson <willemferguson@zoology.up.ac.za> | 2014-11-16 15:54:30 +0200 |
---|---|---|
committer | Dirk Hohndel <dirk@hohndel.org> | 2014-11-16 17:18:18 +0000 |
commit | 7967d2bec1f90f230800ada64c7fe69b3f2009cd (patch) | |
tree | f83e6029e48b52f902775b6cda45748070e90695 | |
parent | d84f76ae1457e913a8c3316d670e30cc44d51b0f (diff) | |
download | subsurface-7967d2bec1f90f230800ada64c7fe69b3f2009cd.tar.gz |
User manual: Using CCR equipment with Subsurface.
This is a first stab at some text detailing the import
and handling of CCR dives within Subsurface. Three figures
added.
Signed-off-by: willem ferguson <willemferguson@zoology.up.ac.za>Kind
regards,
willem
From da16229327331731794b356b8e8504a4cd160634 Mon Sep 17 00:00:00 2001
From: willem ferguson <willemferguson@zoology.up.ac.za>
Date: Sun, 16 Nov 2014 15:50:44 +0200
Subject: [PATCH] Update user manual with CCR instructions
This is a first stab at some text detailing the import
and handling of CCR dives within Subsurface. Three figures
added.
Signed-off-by: willem ferguson <willemferguson@zoology.up.ac.za>
Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
-rw-r--r-- | Documentation/images/APD.jpg | bin | 0 -> 35173 bytes | |||
-rw-r--r-- | Documentation/images/APDComputer.jpg | bin | 0 -> 8740 bytes | |||
-rw-r--r-- | Documentation/images/MkVI.jpeg | bin | 0 -> 5063 bytes | |||
-rw-r--r-- | Documentation/user-manual.txt | 105 |
4 files changed, 104 insertions, 1 deletions
diff --git a/Documentation/images/APD.jpg b/Documentation/images/APD.jpg Binary files differnew file mode 100644 index 000000000..52a5a2e8e --- /dev/null +++ b/Documentation/images/APD.jpg diff --git a/Documentation/images/APDComputer.jpg b/Documentation/images/APDComputer.jpg Binary files differnew file mode 100644 index 000000000..705db269e --- /dev/null +++ b/Documentation/images/APDComputer.jpg diff --git a/Documentation/images/MkVI.jpeg b/Documentation/images/MkVI.jpeg Binary files differnew file mode 100644 index 000000000..8740eba76 --- /dev/null +++ b/Documentation/images/MkVI.jpeg diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index f89ee02ab..d9a1c1140 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -963,14 +963,69 @@ available, as in dialogue *B*, above. Currently these are: - XML-formatted dive logs (Divinglog 5.0, MacDive and several other dive log systems) - UDDF-formatted dive logs (e.g. Kenozoooid) - UDCF-formatted dive logs + - Poseidon CCR logs - JDiveLog - Suunto Dive Manager (DM3 and DM4) - - CSV (text-based and spreadsheet-based) dive logs. + - CSV (text-based and spreadsheet-based) dive logs, including APD CCR logs Selecting the appropriate file in the file list of the dialogue opens the imported dive log in the _Subsurface_ *Dive List*. Some other formats, not accessible through the Import dialogue are also supported, as explained below. +==== Importing dive logs from closed circuit rebreather (CCR) systems + +[icon="images/APD.jpg"] +[NOTE] +Closed system rebreathers use avanced technology to recirculate +gas that has been breathed while doing two things to maintain a +breathable oxygen concentration: +a) remove carbon dioxide from the gas that has been exhaled +b) regulate the oxygen concentration to remain within safe diving limits. +Currently, within _Subsurface_, the Poseidon MkVI Discovery is the best +supported CCR dive computer. The CCR interface of _Subsurface_ is currently experimental +and under active development. In contrast to a conventional open circuit +dive computer, a CCR system computer does not allow the download of a log +containg multiple dives. Rather, each dive is stored independently. This +means that _Subsurface_ cannot download a dive log directly from a CCR +dive computer, but that it imports CCR dive logs in the same way that it +imports dive log data from other databases. + +===== Import a CCR dive + +See the section dealing with xref:S_ImportingAlienDiveLogs[Importing dive information from other +digital sources]. From the main menu of _Subsurface_, select _Import->Import +log files_ to bring up the xref:Unified_import[universal import dialogue]. As +explained in the previous section, the bottom right +hand of the import dialogue contains a dropdown list of appropriate devices +that currently includes an option for MkVI files. Having selected the appropriate CCR format and +the directory where the original dive logs have been stored from the CCR dive +computer, one can select a particular dive log file (in the case of the MkVI +it is a file with a .txt extension). After selecting the appropriate dive log, +activate the _Open_ button at the bottom right hand of the universal import dialogue. + +===== Displayed information for a dive + +_Partial pressures of gases_: The graph of oxygen partial pressure shows the +information from the oxygen sensors of the CCR equipment. In the case of the +Poseidon MKVI, the mean value of the two oxygen sensors are shown. In the case +of the APD equipment, the mean of the three oxygen sensors are shown. If one +sensor shows a very different oxygen PO2 reading compared to the others, the +divergent sensor is ingnored. For CCR dives the graph for oxygen partial pressure +should be fairly flat, reflecting the setpoint settings during the dive. +Partial pressures for nitrogen (and helium, +if applicable) are shown in the usual way as for other dives. + +_Cylinder pressures_: CCR dive computers like the Poseidon MkVI record the +pressures of the oxygen and diluent cylinders. The pressure of the oxygen cylinder +is shown on the dive profile. In addition, start and end pressures for both oxygen +and diluent cylinders are shown in the _Equipment Tab_. + +_Equipment-specific information_: Equipment-specific information gathered by +_Subsurface_ is shown in the _Extra data_ tab. This may include setup information +or metadata about the dive. + +More equipment-specific information for downloading CCR dive logs can be found in xref:S_PoseidonMkVI[Appendix B]. + ==== Importing from Mares Dive Organiser V2.1 Since Mares utilise proprietary Windows software not compatible with @@ -2901,6 +2956,54 @@ this, but it is reported to be solved sometimes by one of these steps: * switch to different Bluetooth drivers for the same hardware * switch off WiFi while using Bluetooth +[[S_PoseidonMkVI]] +=== Importing dive logs from the Poseidon MkVI Discovery + +[icon="images/MkVI.jpeg"] +[NOTE] +Download of dive logs from the MkVI is performed using a custom communications +adapter and the _Poseidon PC Configuration Software_, obtained when purchasing +the MKVI equipment. The latter is a Windows application allowing configuration +of equipment and storage of dive logs. Communication between dive computer and +desktop computer utilises the IrDA infra-red protocol. Only data for one dive +can be downloaded at a time, comprising three files: + +- Setup configuration for the dive and key dive parameters (file with a .txt +extension) +- Dive log details (file with a .csv extension) +- Redbook format dive log (file with .cvsr extension). This is a compressed +version of the dive log using a propriatary format. + +_Subsurface_ accesses the .txt and the .csv files to obtain dive log information. + + +=== Importing dive logs from the APD Inspiration CCR + +[icon="images/APDComputer.jpg"] +[NOTE] +The dive logs of an APD Inspiration or similar CCR dive computer are downloaded using +a communications adapter and _AP Communicator_, obtained when +purchasing the equipment. The dive logs can be viewed using the _AP Log Viewer_, +within Windows or Mac/OS. However, APD logs can be viewed and managed from within +_Subsurface_ (together with dives using many other types of dive computer). The +APD inspiration dive logs are imported into _Subsurface_ as follows: + +- Open a dive within the _AP Log Viewer_. +- Select the tab at the top of the screen, entitled "_Data_". +- If the raw dive log data show on the screen, click on "_Copy to Clipboard_". +- Open a text editor, e.g. Notepad (Windows), TextWrangler (Mac). +- Copy the contents of the clipboard into the text editor and save the text file +with a filename extension of .CSV +- Within _Subsurface_, select _Import->Import log files_ to open the xref:Unified_import[universal import dialogue]. +- In the dropdown list towards the bottom right of the dialogue, select "_CSV files_". +- On the list of file names select the .CSV file that has been created above. An import +dialogue opens. +- In the dropdown list on the middle right labeled '_Pre-configured imports_", +select _APD Log Viewer_. +- Ensure the other settings for the ADP dive log are appropriate, then select _OK_. + +The APD dive log will appear within _Subsurface_. + == APPENDIX C: Exporting Dive log information from external dive log software. |