1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<!-- 3 4 This file is a part of BeOS USB SCSI interface module project. 5 Copyright (c) 2003-2004 by Siarzhuk Zharski <imker@gmx.li> 6 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 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 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. 20 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 $ 25 26--> 27<html> 28<head> 29 <title>FREECOM extension module for BeOS USB mass storage support</title> 30</head> 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> 37</div> 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. 42</p> 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. 45</p> 46 47<h1><a name="Contents"></a>Table of Contents</h1> 48<ul> 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> 55</ul> 56 57<h1><a name="1._Installation_and_using_"></a>1. Installation and using</h1> 58<ol> 59 <li>Contents of distribution archive: 60<pre> ReadMe.freecom.html <--- file you are reading now 61 <a href="install.sh">install.sh</a> <--- installation script 62 <a href="uninstall.sh">uninstall.sh</a> <--- uninstallation script 63 freecom <--- The Extension binary 64 <a href="device_info.sample">device_info.sample</a> <--- device description sample 65</pre> 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> 89</ol> 90<a href="#Contents">Table 91of Contents</a> 92<h1><a name="2._Troubleshooting"></a>2. Troubleshooting</h1> 93<ol> 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> 131</ol> 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 140<ol> 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 148etc.</li> 149 <li>Also you can contact me personally by <a href="mailto:imker@gmx.li">e-mail</a>.</li> 150</ol> 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> 170</table> 171</p> 172<a href="#Contents">Table 173of Contents</a> 174<center>< End of document ></center> 175</body> 176</html> 177