1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 This file is a part of BeOS USB SCSI interface module project.
5 Copyright (c) 2003-2004 by Siarzhuk Zharski <imker@gmx.li>
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms of the GNU General Public License as published by the
9 * Free Software Foundation; either version 2, or (at your option) any
10 * later version.
11 *
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * General Public License for more details. 
16 *
17 * You should have received a copy of the GNU General Public License along
18 * with this program; if not, write to the Free Software Foundation, Inc.,
19 * 675 Mass Ave, Cambridge, MA 02139, USA.
21 $Source: /cvsroot/sis4be/usb_scsi/freecom/ReadMe.freecom.html,v $
22 $Author: zharik $
23 $Revision: 1.2 $
24 $Date: 2005/04/09 22:19:58 $
29  <title>FREECOM extension module for BeOS USB mass storage support</title>
31<body bgcolor="#f0f0e0">
32<h1>FREECOM extension module for
33    <font color="#000066">B</font><font color="#cc0000">e</font>OS
34     USB mass storage support</h1>
35<div align="right">
36<address><a href="mailto:imker@gmx.li">by Siarzhuk Zharski</a></address>
38<p>This FREECOM extension module (<strong>The Extension</strong>) is kind of the helper for
39BeOS USB Storage Module (<strong>The Module</strong>) that is designed to support
40external CD/DVD drives connected with FREECOM USB 1.1 Cable. 
41This software is for BeOS/Dano/Zeta operating systems.
43<p><font color="#cc0000"><b>Note that</b></font> this manual contains only FREECOM extension specific information. For general USB
44Storage Module questions look into the corresponding manual. 
47<h1><a name="Contents"></a>Table of Contents</h1>
49  <li><a href="#1._Installation_and_using_">Installation and using </a></li>
50  <li><a href="#2._Troubleshooting">Troubleshooting</a></li>
51  <li><a href="#3.5.Writing_a_problem_report">Writing a problem report</a></li>
52  <li><a href="#6.Contact_information">Contact and support information</a></li>
53  <li><a href="#5.Credits">Credits</a></li>
54  <li><a href="#4._Versions_History_">The History</a></li>
57<h1><a name="1._Installation_and_using_"></a>1. Installation and using</h1>
59  <li>Contents of distribution archive:
60<pre>    ReadMe.freecom.html      &lt;--- file you are reading now
61    <a href="install.sh">install.sh</a>       &lt;--- installation script
62    <a href="uninstall.sh">uninstall.sh</a>     &lt;--- uninstallation script
63    freecom              &lt;--- The Extension binary
64    <a href="device_info.sample">device_info.sample</a>  &lt;--- device description sample
66  </li>
67  <li>Run <a href="install.sh"><strong>/install.sh</strong></a> to install The Extension on your system.
68This script do the following:</li>
69  <ul>
70    <li>copies The Extension binary to 
71          <strong>/boot/home/config/add-ons/kernel/generic/usb_scsi_extensions/</strong>
72              directory</li>
73  </ul>
74  <ul>
75    <li>add device definition into  
76          <strong>/boot/home/config/settings/kernel/drivers/usb_scsi</strong>
77              file</li>
78    <li>ask you to edit settings file. Note that you have to check vendor and product ids for
79    your FREECOM device and edit device settings correspondently! It is not required to reboot your PC after installing
80The Extension and changing it's definitions.</li>
81  </ul>
82  <li>Plug in your FREECOM CD/DVD drive into USB slot, load a media into it and
83try to open Tracker's "Mount" menu some times. In case if all goes OK -
84you'll see your CD/DVD volume available for mounting. You can of course use your CD/DVD burning
85software with this drive.</li>
86  <li>[optional] To uninstall The Module from your system - run <a href="uninstall.sh"><strong>uninstall.sh</strong></a>
87from distribution archive or delete files mentioned in
88clause 3 of this section manually.</li>
90<a href="#Contents">Table
91of Contents</a>
92<h1><a name="2._Troubleshooting"></a>2. Troubleshooting</h1>
94  <li><strong>Is my external USB CD/DVD device supported?</strong>
95    <ul>
96      <li>Only "old" FREECOM USB 1.1 cable connected drives are supported. Obtain your device
97      vendor and product ids as described in ReadMe.html for
98      BeOS USB storage Module, edit the device description in settings file correspondently and try
99      to work with it. Be sure that your FREECOM device is really non-standard and has 255 as class in
100      usb device description. Vendor id for FREECOM is 0x07ab.
101      </li>
102    </ul>
103  </li>
104  <li><strong>Cannot mount my CD/DVDs</strong>.
105    <ul>
106      <li>Please check the following:
107        <ul>
108          <li>the binary file <strong>/boot/home/config/add-ons/kernel/generic/usb_scsi_extensions/freecom</strong>
109exists on your system;
110          </li>
111          <li>the settings file <strong>/boot/home/config/settings/kernel/drivers/usb_scsi</strong>
112exists on your system and contains description for your FREECOM device;</li>
113          <li>check that device description correspond to your real device information;
114          </li>
115        </ul>
116      </li>
117    </ul>
118  </li>
119  <li><strong>My external USB HDD in FREECOM case doesn't work</strong>
120    <ul>
121      <li>Only ATAPI devices are supported. ATA protocol doesn't uses SCSI-like commands.</li>
122    </ul>
123  </li>
124  <li><strong>Mmmm... another question</strong>...
125    <ul>
126      <li>Please refer to Troubleshooting section of ReadMe.html for BeOS USB Storage Support Module and
127      <a href="#6.Contact_information">contact the developer</a> if you still have a problem.
128      </li>
129    </ul>
130  </li>
132<a href="#Contents">Table of Contents</a>
133<h1><a name="3.5.Writing_a_problem_report"></a>3. Writing a problem report</h1>
134Refer to corresponding section of ReadMe.html file for BeOS USB Storage Support Module.
135<a href="#Contents">Table of Contents</a>
136<h1><a name="6.Contact_information"></a>4.Contact and support information</h1>
137The Extension is a part of BeOS USB Support Module project that is hosted on <a href="http://www.sourceforge.net">SourceForge</a> 
138and uses some it's powerful development services. There are some ways to inform
139developer about problems or put feature requests for next version
141  <li>Use <a href="http://sourceforge.net/tracker/?group_id=56631&atid=481262">Bug
142Tracker</a> to put problem reports.</li>
143  <li>Use <a href="http://sourceforge.net/forum/forum.php?forum_id=380480">Forum</a>
144to ask simple support question, discuss any problems.
145  <li>Use <a
146 href="http://lists.sourceforge.net/lists/listinfo/sis4be-usb_scsi">Mailing-list</a>
147to be informed with latest news, ask questions
149  <li>Also you can contact me personally by <a href="mailto:imker@gmx.li">e-mail</a>.</li>
151<a href="#Contents">Table of Contents</a>
152<h1><a name="5.Credits"></a>5.Credits</h1>
153<p>I want to say my "Thanks" to:</p>
154<p><strong>brave testers...</strong></p>
155<a href="#Contents">Table of Contents</a>
156<h1><a name="4._Versions_History_"></a>6. The History</h1>
157<p><table width="100%" border="1">
158  <tbody>
159    <tr>
160      <td><b>Date:</b> </td>
161      <td><b>Version:</b> </td>
162      <td><b>What's new:</b> </td>
163    </tr>
164    <tr>
165      <td> ?? ??April 2005</td>
166      <td>0.1.0-alpha-1 </td>
167      <td>first public release. </td>
168    </tr>
169  </tbody>
172<a href="#Contents">Table
173of Contents</a>
174<center>&lt; End of document &gt;</center>