[PATCH] Add some troubleshooting to user manual

Miika Turkia miika.turkia at gmail.com
Fri Jun 28 22:40:52 PDT 2013

On Sat, Jun 29, 2013 at 8:18 AM, Jef Driesen <jefdriesen at telenet.be> wrote:

> On 29-06-13 06:45, Miika Turkia wrote:
>> +       ERROR: Device or resource busy (16) [in serial_posix.c:107
>> (serial_open)]
>> +       ERROR: Failed to open the serial port. [in oceanic_atom2.c:377
>> (oceanic_atom2_device_open)]
> I would drop the second line from the manual. It's basically the same
> error repeated at the backend level.


 +**Getting debug logs**
> +
> +Getting debug logs or full memory dump of the dive computer might be
> +needed to solve the issue. This can be don with libdivecomputer's
> +universal application (you can compile it yourself or download from
> +http://www.libdivecomputer.org/builds/linux/universal[libdivecomputer's
> +web page]).
Should the manual point directly to the linux binary? There are binaries
for Windows and Mac OS X too. Maybe point to the builds directory, and let
people pick the OS themselves?


 Debug log can be
> +obtained with the following command (change the DC name and model
> +appropriately):
> +
> +       ./universal -l output.log -d output.xml -n "Oceanic Geo 2.0" -v
> /dev/ttyUSB0
> +
> +This will produce an *output.log* that you should send to mailto:
> subsurface at hohndel.org[our mailing list].
> +
> +A full memory dump can be obtained similarly:
> +
> +       ./universal -l output.log -m output.bin -n "Oceanic Geo 2.0" -v
> /dev/ttyUSB0

I think it would be a good idea to add that you can obtain the list of
> supported models (and a short help) by executing the tool without any
> arguments.


Good points, a new patch is on its way. (I was wondering if I should add
you (Jef) as the debug log receiver, but thought that you read our mailing
list and it should not be necessary.)

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.hohndel.org/pipermail/subsurface/attachments/20130629/bc60ddd4/attachment.html>

More information about the subsurface mailing list